@readium/navigator 2.4.0-beta.9 → 2.5.0-beta.1

package/src/webpub/preferences/WebPubSettings.ts

@@ -1,9 +1,9 @@
-import { ConfigurableSettings } from "../../preferences/Configurable";
-import { ExperimentKey, TextAlignment } from "../../preferences/Types";
-import { WebPubDefaults } from "./WebPubDefaults";
-import { WebPubPreferences } from "./WebPubPreferences";
+import { ConfigurableSettings } from "../../preferences/Configurable.ts";
+import { ExperimentKey, TextAlignment } from "../../preferences/Types.ts";
+import { WebPubDefaults } from "./WebPubDefaults.ts";
+import { WebPubPreferences } from "./WebPubPreferences.ts";
 
-import { sMLWithRequest } from "../../helpers";
+import { sMLWithRequest } from "../../helpers/index.ts";
 
 export interface IWebPubSettings {
   fontFamily?: string | null,
@@ -45,61 +45,61 @@ export class WebPubSettings implements ConfigurableSettings {
   constructor(preferences: WebPubPreferences, defaults: WebPubDefaults, hasDisplayTransformability: boolean) {
     if (hasDisplayTransformability) {
       this.fontFamily = preferences.fontFamily || defaults.fontFamily || null;
-      this.fontWeight = preferences.fontWeight !== undefined 
-        ? preferences.fontWeight 
-        : defaults.fontWeight !== undefined 
-          ? defaults.fontWeight 
+      this.fontWeight = preferences.fontWeight !== undefined
+        ? preferences.fontWeight
+        : defaults.fontWeight !== undefined
+          ? defaults.fontWeight
           : null;
-      this.hyphens = typeof preferences.hyphens === "boolean" 
-        ? preferences.hyphens 
+      this.hyphens = typeof preferences.hyphens === "boolean"
+        ? preferences.hyphens
         : defaults.hyphens ?? null;
-      this.iOSPatch = preferences.iOSPatch === false 
-        ? false 
-        : preferences.iOSPatch === true 
+      this.iOSPatch = preferences.iOSPatch === false
+        ? false
+        : preferences.iOSPatch === true
           ? ((sMLWithRequest.OS.iOS || sMLWithRequest.OS.iPadOS) && sMLWithRequest.iOSRequest === "mobile")
           : defaults.iOSPatch;
-      this.iPadOSPatch = preferences.iPadOSPatch === false 
-        ? false 
-        : preferences.iPadOSPatch === true 
-          ? (sMLWithRequest.OS.iPadOS && sMLWithRequest.iOSRequest === "desktop") 
+      this.iPadOSPatch = preferences.iPadOSPatch === false
+        ? false
+        : preferences.iPadOSPatch === true
+          ? (sMLWithRequest.OS.iPadOS && sMLWithRequest.iOSRequest === "desktop")
           : defaults.iPadOSPatch;
-      this.letterSpacing = preferences.letterSpacing !== undefined 
-        ? preferences.letterSpacing 
-        : defaults.letterSpacing !== undefined 
-          ? defaults.letterSpacing 
+      this.letterSpacing = preferences.letterSpacing !== undefined
+        ? preferences.letterSpacing
+        : defaults.letterSpacing !== undefined
+          ? defaults.letterSpacing
           : null;
       this.ligatures = typeof preferences.ligatures === "boolean"
-        ? preferences.ligatures 
+        ? preferences.ligatures
         : defaults.ligatures ?? null;
-      this.lineHeight = preferences.lineHeight !== undefined 
-        ? preferences.lineHeight 
-        : defaults.lineHeight !== undefined 
-          ? defaults.lineHeight 
+      this.lineHeight = preferences.lineHeight !== undefined
+        ? preferences.lineHeight
+        : defaults.lineHeight !== undefined
+          ? defaults.lineHeight
           : null;
-      this.noRuby = typeof preferences.noRuby === "boolean" 
-        ? preferences.noRuby 
+      this.noRuby = typeof preferences.noRuby === "boolean"
+        ? preferences.noRuby
         : defaults.noRuby ?? null;
-      this.paragraphIndent = preferences.paragraphIndent !== undefined 
-        ? preferences.paragraphIndent 
-        : defaults.paragraphIndent !== undefined 
-          ? defaults.paragraphIndent 
+      this.paragraphIndent = preferences.paragraphIndent !== undefined
+        ? preferences.paragraphIndent
+        : defaults.paragraphIndent !== undefined
+          ? defaults.paragraphIndent
           : null;
-      this.paragraphSpacing = preferences.paragraphSpacing !== undefined 
-        ? preferences.paragraphSpacing 
-        : defaults.paragraphSpacing !== undefined 
-          ? defaults.paragraphSpacing 
+      this.paragraphSpacing = preferences.paragraphSpacing !== undefined
+        ? preferences.paragraphSpacing
+        : defaults.paragraphSpacing !== undefined
+          ? defaults.paragraphSpacing
           : null;
       this.textAlign = preferences.textAlign || defaults.textAlign || null;
-      this.textNormalization = typeof preferences.textNormalization === "boolean" 
-        ? preferences.textNormalization 
+      this.textNormalization = typeof preferences.textNormalization === "boolean"
+        ? preferences.textNormalization
         : defaults.textNormalization ?? null;
-      this.wordSpacing = preferences.wordSpacing !== undefined 
-        ? preferences.wordSpacing 
-        : defaults.wordSpacing !== undefined 
-          ? defaults.wordSpacing 
+      this.wordSpacing = preferences.wordSpacing !== undefined
+        ? preferences.wordSpacing
+        : defaults.wordSpacing !== undefined
+          ? defaults.wordSpacing
           : null;
     }
-    
+
     this.zoom = preferences.zoom !== undefined
       ? preferences.zoom
       : defaults.zoom !== undefined
@@ -108,4 +108,4 @@ export class WebPubSettings implements ConfigurableSettings {
 
     this.experiments = defaults.experiments || null;
   }
-}
+}

package/src/webpub/preferences/index.ts

@@ -1,4 +1,4 @@
-export * from "./WebPubDefaults";
-export * from "./WebPubPreferencesEditor";
-export * from "./WebPubPreferences";
-export * from "./WebPubSettings";
+export * from "./WebPubDefaults.ts";
+export * from "./WebPubPreferencesEditor.ts";
+export * from "./WebPubPreferences.ts";
+export * from "./WebPubSettings.ts";

package/types/src/audio/AudioNavigator.d.ts

@@ -1,8 +1,14 @@
 import { Link, Locator, Publication, Timeline, TimelineItem } from "@readium/shared";
-import { MediaNavigator, IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../Navigator";
-import { Configurable } from "../preferences";
-import { AudioPreferences, AudioSettings, AudioPreferencesEditor, IAudioPreferences, IAudioDefaults } from "./preferences";
+import { MediaNavigator, IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../Navigator.ts";
+import { Configurable } from "../preferences/Configurable.ts";
+import { AudioPreferences, AudioSettings, AudioPreferencesEditor, IAudioPreferences, IAudioDefaults } from "./preferences/index.ts";
 import { ContextMenuEvent, KeyboardEventData, SuspiciousActivityEvent } from "@readium/navigator-html-injectables";
+export interface AudioMetadata {
+    duration: number;
+    textTracks: TextTrackList;
+    readyState: number;
+    networkState: number;
+}
 export interface AudioNavigatorListeners {
     trackLoaded: (media: HTMLMediaElement) => void;
     positionChanged: (locator: Locator) => void;
@@ -11,18 +17,23 @@ export interface AudioNavigatorListeners {
     trackEnded: (locator: Locator) => void;
     play: (locator: Locator) => void;
     pause: (locator: Locator) => void;
-    metadataLoaded: (duration: number) => void;
+    metadataLoaded: (metadata: AudioMetadata) => void;
     stalled: (isStalled: boolean) => void;
     seeking: (isSeeking: boolean) => void;
     seekable: (seekable: TimeRanges) => void;
     contentProtection: (type: string, data: SuspiciousActivityEvent) => void;
     peripheral: (data: KeyboardEventData) => void;
     contextMenu: (data: ContextMenuEvent) => void;
+    remotePlaybackStateChanged: (state: RemotePlaybackState) => void;
+}
+export interface IAudioContentProtectionConfig extends IContentProtectionConfig {
+    /** Prevents the media element from being cast to remote devices via the Remote Playback API. */
+    disableRemotePlayback?: boolean;
 }
 export interface AudioNavigatorConfiguration {
     preferences: IAudioPreferences;
     defaults: IAudioDefaults;
-    contentProtection?: IContentProtectionConfig;
+    contentProtection?: IAudioContentProtectionConfig;
     keyboardPeripherals?: IKeyboardPeripheralsConfig;
 }
 export declare class AudioNavigator extends MediaNavigator implements Configurable<AudioSettings, AudioPreferences> {
@@ -43,6 +54,12 @@ export declare class AudioNavigator extends MediaNavigator implements Configurab
     private readonly _keyboardPeripheralsManager;
     private readonly _suspiciousActivityListener;
     private readonly _keyboardPeripheralListener;
+    private readonly _contentProtection;
+    /** True while a track transition is in progress; suppresses spurious mid-navigation events. */
+    private _isNavigating;
+    private _isStalled;
+    private _stalledWatchdog;
+    private _stalledCheckTime;
     constructor(publication: Publication, listeners: AudioNavigatorListeners, initialPosition?: Locator, configuration?: AudioNavigatorConfiguration);
     get settings(): AudioSettings;
     get preferencesEditor(): AudioPreferencesEditor;
@@ -69,6 +86,9 @@ export declare class AudioNavigator extends MediaNavigator implements Configurab
      */
     private waitForLoadedAndSeeked;
     private setupEventListeners;
+    private _setStalled;
+    private _startStalledWatchdog;
+    private _stopStalledWatchdog;
     private setupMediaSession;
     private updateMediaSessionMetadata;
     private startPositionPolling;
@@ -90,6 +110,15 @@ export declare class AudioNavigator extends MediaNavigator implements Configurab
     get isTrackEnd(): boolean;
     get canGoBackward(): boolean;
     get canGoForward(): boolean;
+    /**
+     * The RemotePlayback object for the primary media element.
+     * Because the element is never swapped, this reference is stable for the
+     * lifetime of the navigator — host apps can store it and call `.prompt()`,
+     * `.watchAvailability()`, etc. directly.
+     */
+    get remotePlayback(): RemotePlayback | undefined;
+    /** Wires up the optional remotePlaybackStateChanged listener. Called once after initial load. */
+    private _setupRemotePlayback;
     private destroyMediaSession;
     destroy(): void;
 }

package/types/src/audio/AudioPoolManager.d.ts

@@ -1,11 +1,12 @@
 import { Publication } from "@readium/shared";
-import { WebAudioEngine } from "./engine/WebAudioEngine";
+import { WebAudioEngine } from "./engine/WebAudioEngine.ts";
+import type { IAudioContentProtectionConfig } from "./AudioNavigator.ts";
 export declare class AudioPoolManager {
     private readonly pool;
     private _audioEngine;
     private readonly _publication;
     private readonly _supportedAudioTypes;
-    constructor(audioEngine: WebAudioEngine, publication: Publication);
+    constructor(audioEngine: WebAudioEngine, publication: Publication, contentProtection?: IAudioContentProtectionConfig);
     private detectSupportedAudioTypes;
     private pickPlayableHref;
     get audioEngine(): WebAudioEngine;
@@ -17,11 +18,13 @@ export declare class AudioPoolManager {
     /**
      * Updates the pool around the given index: ensures elements exist within
      * the LOWER_BOUNDARY and disposes those beyond the UPPER_BOUNDARY.
+     * The current track is excluded — the primary engine element represents it.
      */
     private update;
     /**
-     * Sets the current audio for playback at the given track index.
-     * The element is always sourced from the pool — never loaded ad-hoc on the engine.
+     * Sets the current audio for playback at the given track index by changing
+     * the src on the persistent primary element. This preserves the RemotePlayback
+     * session and any Web Audio graph connections across track changes.
      */
     setCurrentAudio(currentIndex: number, _direction: 'forward' | 'backward'): void;
     destroy(): void;

package/types/src/audio/engine/AudioEngine.d.ts

@@ -49,10 +49,11 @@ export interface AudioEngine {
      */
     off(event: string, callback: (data: any) => void): void;
     /**
-     * Sets the media element for playback, enabling use of preloaded elements from the pool.
-     * @param element The HTML audio element to use for playback.
+     * Changes the src of the primary media element without swapping it,
+     * preserving the RemotePlayback session and all attached event listeners.
+     * @param href The URL of the new audio resource.
      */
-    setMediaElement(element: HTMLAudioElement): void;
+    changeSrc(href: string): void;
     /**
      * Plays the current audio resource.
      */

package/types/src/audio/engine/PreservePitchWorklet.d.ts

@@ -1,15 +1,12 @@
 interface PreservePitchWorkletOptions {
     ctx: AudioContext;
-    mediaElement?: HTMLMediaElement;
     pitchFactor?: number;
     modulePath?: string;
 }
 export declare class PreservePitchWorklet {
-    mediaElement: HTMLMediaElement | null;
-    source: MediaElementAudioSourceNode | null;
     ctx: AudioContext;
     workletNode: AudioWorkletNode | null;
-    url: string | null;
+    private url;
     static createWorklet(options: PreservePitchWorkletOptions): Promise<PreservePitchWorklet>;
     constructor(ctx: AudioContext);
     updatePitchFactor(factor: number): void;

package/types/src/audio/engine/WebAudioEngine.d.ts

@@ -1,4 +1,4 @@
-import { AudioEngine, Playback } from "./AudioEngine";
+import { AudioEngine, Playback } from "./AudioEngine.ts";
 type EventCallback = (data: any) => void;
 export declare class WebAudioEngine implements AudioEngine {
     readonly playback: Playback;
@@ -7,8 +7,6 @@ export declare class WebAudioEngine implements AudioEngine {
     private sourceNode;
     private gainNode;
     private listeners;
-    private currentVolume;
-    private currentPlaybackRate;
     private isMutedValue;
     private isPlayingValue;
     private isPausedValue;
@@ -48,12 +46,6 @@ export declare class WebAudioEngine implements AudioEngine {
      * @param callback - callback function to be removed.
      */
     off(event: string, callback: EventCallback): void;
-    private deactivateWebAudio;
-    /**
-     * Sets the media element for playback.
-     * @param element The HTML audio element to use.
-     */
-    setMediaElement(element: HTMLAudioElement): void;
     private ensureAudioContextRunning;
     private getOrCreateAudioContext;
     private onTimeUpdate;
@@ -140,6 +132,20 @@ export declare class WebAudioEngine implements AudioEngine {
      */
     private activateWebAudio;
     get isWebAudioActive(): boolean;
+    /**
+     * Tears down the Web Audio graph and restores the media element to standalone
+     * playback. Safe to call even if Web Audio was never activated.
+     */
+    private tearDownWebAudio;
+    /**
+     * Changes the src of the primary media element without swapping the element.
+     * Preserves the RemotePlayback session and all attached event listeners.
+     * When the Web Audio graph is active, the new src is loaded with
+     * crossOrigin="anonymous". If the CORS request fails (server does not send
+     * the required headers), the graph is torn down and the src is reloaded
+     * without CORS so playback continues — just without pitch correction.
+     */
+    changeSrc(href: string): void;
     /**
      * Returns the HTML media element used for playback.
      */

package/types/src/audio/engine/index.d.ts

@@ -1,2 +1,2 @@
-export * from './AudioEngine';
-export * from './WebAudioEngine';
+export * from './AudioEngine.ts';
+export * from './WebAudioEngine.ts';

package/types/src/audio/index.d.ts

@@ -1,3 +1,3 @@
-export * from './engine';
-export * from './preferences';
-export * from './AudioNavigator';
+export * from './engine/index.ts';
+export * from './preferences/index.ts';
+export * from './AudioNavigator.ts';

package/types/src/audio/preferences/AudioPreferences.d.ts

@@ -1,4 +1,4 @@
-import { ConfigurablePreferences } from "../../preferences/Configurable";
+import { ConfigurablePreferences } from "../../preferences/Configurable.ts";
 export interface IAudioPreferences {
     volume?: number | null;
     playbackRate?: number | null;
@@ -10,14 +10,14 @@ export interface IAudioPreferences {
     enableMediaSession?: boolean | null;
 }
 export declare class AudioPreferences implements ConfigurablePreferences<AudioPreferences> {
-    readonly volume: number | null | undefined;
-    readonly playbackRate: number | null | undefined;
-    readonly preservePitch: boolean | null | undefined;
-    readonly skipBackwardInterval: number | null | undefined;
-    readonly skipForwardInterval: number | null | undefined;
-    readonly pollInterval: number | null | undefined;
-    readonly autoPlay: boolean | null | undefined;
-    readonly enableMediaSession: boolean | null | undefined;
+    volume: number | null | undefined;
+    playbackRate: number | null | undefined;
+    preservePitch: boolean | null | undefined;
+    skipBackwardInterval: number | null | undefined;
+    skipForwardInterval: number | null | undefined;
+    pollInterval: number | null | undefined;
+    autoPlay: boolean | null | undefined;
+    enableMediaSession: boolean | null | undefined;
     constructor(preferences?: IAudioPreferences);
     merging(other: AudioPreferences): AudioPreferences;
 }

package/types/src/audio/preferences/AudioPreferencesEditor.d.ts

@@ -1,7 +1,7 @@
-import { IPreferencesEditor } from "../../preferences/PreferencesEditor";
-import { AudioPreferences } from "./AudioPreferences";
-import { AudioSettings } from "./AudioSettings";
-import { Preference, BooleanPreference, RangePreference } from "../../preferences/Preference";
+import { IPreferencesEditor } from "../../preferences/PreferencesEditor.ts";
+import { AudioPreferences } from "./AudioPreferences.ts";
+import { AudioSettings } from "./AudioSettings.ts";
+import { Preference, BooleanPreference, RangePreference } from "../../preferences/Preference.ts";
 export declare class AudioPreferencesEditor implements IPreferencesEditor {
     preferences: AudioPreferences;
     private settings;

package/types/src/audio/preferences/AudioSettings.d.ts

@@ -1,6 +1,6 @@
-import { AudioPreferences } from "./AudioPreferences";
-import { AudioDefaults } from "./AudioDefaults";
-import { ConfigurableSettings } from "../../preferences/Configurable";
+import { AudioPreferences } from "./AudioPreferences.ts";
+import { AudioDefaults } from "./AudioDefaults.ts";
+import { ConfigurableSettings } from "../../preferences/Configurable.ts";
 export interface IAudioSettings extends ConfigurableSettings {
     volume: number;
     playbackRate: number;

package/types/src/audio/preferences/index.d.ts

@@ -1,4 +1,4 @@
-export * from './AudioPreferences';
-export * from './AudioDefaults';
-export * from './AudioSettings';
-export * from './AudioPreferencesEditor';
+export * from './AudioPreferences.ts';
+export * from './AudioDefaults.ts';
+export * from './AudioSettings.ts';
+export * from './AudioPreferencesEditor.ts';

package/types/src/audio/protection/AudioNavigatorProtector.d.ts

@@ -1,5 +1,5 @@
-import { NavigatorProtector } from "../../protection/NavigatorProtector";
-import { IContentProtectionConfig } from "../../Navigator";
+import { NavigatorProtector } from "../../protection/NavigatorProtector.ts";
+import { IContentProtectionConfig } from "../../Navigator.ts";
 export declare class AudioNavigatorProtector extends NavigatorProtector {
     private dragAndDropProtector?;
     private copyProtector?;

package/types/src/css/index.d.ts

@@ -1 +1 @@
-export * from "./Properties";
+export * from "./Properties.ts";

package/types/src/epub/EpubNavigator.d.ts

@@ -1,17 +1,16 @@
 import { Layout, Link, Locator, Publication, ReadingProgression } from "@readium/shared";
-import { Configurable, ConfigurableSettings, VisualNavigator, VisualNavigatorViewport } from "../";
-import { FramePoolManager } from "./frame/FramePoolManager";
-import { FXLFramePoolManager } from "./fxl/FXLFramePoolManager";
-import { CommsEventKey, ContextMenuEvent, KeyboardEventData } from "@readium/navigator-html-injectables";
-import { BasicTextSelection, FrameClickEvent, SuspiciousActivityEvent } from "@readium/navigator-html-injectables";
-import { FXLFrameManager } from "./fxl/FXLFrameManager";
-import { FrameManager } from "./frame/FrameManager";
-import { IEpubPreferences, EpubPreferences } from "./preferences/EpubPreferences";
-import { IEpubDefaults } from "./preferences/EpubDefaults";
-import { EpubSettings } from "./preferences";
-import { EpubPreferencesEditor } from "./preferences/EpubPreferencesEditor";
-import { IInjectablesConfig } from "../injection/Injectable";
-import { IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../Navigator";
+import { Configurable, ConfigurableSettings, VisualNavigator, VisualNavigatorViewport } from "../index.ts";
+import { FramePoolManager } from "./frame/FramePoolManager.ts";
+import { FXLFramePoolManager } from "./fxl/FXLFramePoolManager.ts";
+import { CommsEventKey, ContextMenuEvent, KeyboardEventData, BasicTextSelection, FrameClickEvent, SuspiciousActivityEvent } from "@readium/navigator-html-injectables";
+import { FXLFrameManager } from "./fxl/FXLFrameManager.ts";
+import { FrameManager } from "./frame/FrameManager.ts";
+import { IEpubPreferences, EpubPreferences } from "./preferences/EpubPreferences.ts";
+import { IEpubDefaults } from "./preferences/EpubDefaults.ts";
+import { EpubSettings } from "./preferences/index.ts";
+import { EpubPreferencesEditor } from "./preferences/EpubPreferencesEditor.ts";
+import { IInjectablesConfig } from "../injection/Injectable.ts";
+import { IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../Navigator.ts";
 export type ManagerEventKey = "zoom";
 export interface EpubNavigatorConfiguration {
     preferences: IEpubPreferences;
@@ -50,7 +49,9 @@ export declare class EpubNavigator extends VisualNavigator implements Configurab
     private _settings;
     private _css;
     private _preferencesEditor;
-    private readonly _injector;
+    private _injector;
+    private readonly _readiumRulesPromise;
+    private readonly _injectablesConfig;
     private readonly _contentProtection;
     private readonly _keyboardPeripherals;
     private readonly _navigatorProtector;

package/types/src/epub/css/Properties.d.ts

@@ -1,5 +1,5 @@
-import { ExperimentKey, TextAlignment } from "../../preferences/Types";
-import { BodyHyphens, BoxSizing, FontOpticalSizing, FontWidth, Ligatures, Properties, TypeScale, View } from "../../css/Properties";
+import { ExperimentKey, TextAlignment } from "../../preferences/Types.ts";
+import { BodyHyphens, BoxSizing, FontOpticalSizing, FontWidth, Ligatures, Properties, TypeScale, View } from "../../css/Properties.ts";
 export interface IUserProperties {
     advancedSettings?: boolean | null;
     a11yNormalize?: boolean | null;

package/types/src/epub/css/ReadiumCSS.d.ts

@@ -1,6 +1,6 @@
-import { LineLengths } from "../../helpers";
-import { EpubSettings } from "../preferences/EpubSettings";
-import { RSProperties, UserProperties } from "./Properties";
+import { LineLengths } from "../../helpers/index.ts";
+import { EpubSettings } from "../preferences/EpubSettings.ts";
+import { RSProperties, UserProperties } from "./Properties.ts";
 export interface IReadiumCSS {
     rsProperties: RSProperties;
     userProperties: UserProperties;

package/types/src/epub/css/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./Properties";
-export * from "./ReadiumCSS";
+export * from "./Properties.ts";
+export * from "./ReadiumCSS.ts";

package/types/src/epub/frame/FrameBlobBuilder.d.ts

@@ -1,5 +1,5 @@
 import { Link, Publication } from "@readium/shared";
-import { Injector } from "../../injection/Injector";
+import { Injector } from "../../injection/Injector.ts";
 export default class FrameBlobBuider {
     private readonly item;
     private readonly burl;

package/types/src/epub/frame/FrameComms.d.ts

@@ -1,5 +1,5 @@
 import { CommsCommandKey, CommsAck, CommsEventKey } from "@readium/navigator-html-injectables";
-import { ManagerEventKey } from "../EpubNavigator";
+import { ManagerEventKey } from "../EpubNavigator.ts";
 export type FrameCommsListener = (key: CommsEventKey | ManagerEventKey, value: unknown) => void;
 export declare class FrameComms {
     private readonly wnd;

package/types/src/epub/frame/FrameManager.d.ts

@@ -1,6 +1,6 @@
 import { Loader, ModuleName } from "@readium/navigator-html-injectables";
-import { FrameComms } from "./FrameComms";
-import type { IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../../Navigator";
+import { FrameComms } from "./FrameComms.ts";
+import type { IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../../Navigator.ts";
 export declare class FrameManager {
     private frame;
     private loader;
@@ -22,6 +22,7 @@ export declare class FrameManager {
     }): void;
     get iframe(): HTMLIFrameElement;
     get realSize(): DOMRect;
+    get isDestroyed(): boolean;
     get window(): Window;
     get atLeft(): boolean;
     get atRight(): boolean;

package/types/src/epub/frame/FramePoolManager.d.ts

@@ -1,8 +1,8 @@
 import { ModuleName } from "@readium/navigator-html-injectables";
 import { Locator, Publication } from "@readium/shared";
-import { FrameManager } from "./FrameManager";
-import { Injector } from "../../injection/Injector";
-import { IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../../Navigator";
+import { FrameManager } from "./FrameManager.ts";
+import { Injector } from "../../injection/Injector.ts";
+import { IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../../Navigator.ts";
 export declare class FramePoolManager {
     private readonly container;
     private readonly positions;

package/types/src/epub/frame/index.d.ts

@@ -1,4 +1,4 @@
-export * from "./FrameBlobBuilder";
-export * from "./FrameComms";
-export * from "./FrameManager";
-export * from "./FramePoolManager";
+export * from "./FrameBlobBuilder.ts";
+export * from "./FrameComms.ts";
+export * from "./FrameManager.ts";
+export * from "./FramePoolManager.ts";

package/types/src/epub/fxl/FXLFrameManager.d.ts

@@ -1,8 +1,8 @@
 import { Loader, ModuleName } from "@readium/navigator-html-injectables";
 import { Page, ReadingProgression } from "@readium/shared";
-import { FrameComms } from "../frame/FrameComms";
-import { FXLPeripherals } from "./FXLPeripherals";
-import { IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../../Navigator";
+import { FrameComms } from "../frame/FrameComms.ts";
+import { FXLPeripherals } from "./FXLPeripherals.ts";
+import { IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../../Navigator.ts";
 export declare class FXLFrameManager {
     private frame;
     private loader;

package/types/src/epub/fxl/FXLFramePoolManager.d.ts

@@ -1,10 +1,10 @@
 import { ModuleName } from "@readium/navigator-html-injectables";
 import { Locator, Publication, Page, Link } from "@readium/shared";
-import { FrameCommsListener } from "../frame";
-import { FXLFrameManager } from "./FXLFrameManager";
-import { FXLPeripherals } from "./FXLPeripherals";
-import { VisualNavigatorViewport, IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../../Navigator";
-import { Injector } from "../../injection/Injector";
+import { FrameCommsListener } from "../frame/index.ts";
+import { FXLFrameManager } from "./FXLFrameManager.ts";
+import { FXLPeripherals } from "./FXLPeripherals.ts";
+import { VisualNavigatorViewport, IContentProtectionConfig, IKeyboardPeripheralsConfig } from "../../Navigator.ts";
+import { Injector } from "../../injection/Injector.ts";
 export declare class FXLFramePoolManager {
     private readonly container;
     private readonly positions;

package/types/src/epub/fxl/FXLPeripherals.d.ts

@@ -1,5 +1,5 @@
-import { Point } from "./FXLCoordinator";
-import { FXLFramePoolManager } from "./FXLFramePoolManager";
+import { Point } from "./FXLCoordinator.ts";
+import { FXLFramePoolManager } from "./FXLFramePoolManager.ts";
 export interface PanTracker {
     startX: number;
     endX: number;

package/types/src/epub/fxl/index.d.ts

@@ -1,5 +1,5 @@
-export * from "./FXLCoordinator";
-export * from "./FXLFrameManager";
-export * from "./FXLFramePoolManager";
-export * from "./FXLPeripherals";
-export * from "./FXLSpreader";
+export * from "./FXLCoordinator.ts";
+export * from "./FXLFrameManager.ts";
+export * from "./FXLFramePoolManager.ts";
+export * from "./FXLPeripherals.ts";
+export * from "./FXLSpreader.ts";

package/types/src/epub/helpers/scriptMode.d.ts

@@ -0,0 +1,16 @@
+import { Metadata } from "@readium/shared";
+export type ScriptMode = 'ltr' | 'rtl' | 'cjk-horizontal' | 'cjk-vertical';
+/**
+ * Derives the script mode from publication metadata.
+ *
+ * Rules:
+ * - Only the first language in the array is used. A Latin book containing
+ *   some Japanese is still Latin.
+ * - For CJK (zh/ja/ko): both language AND explicit reading progression are
+ *   required. CJK vertical = explicit rtl + CJK language. CJK horizontal =
+ *   CJK language with ltr or unset progression.
+ * - For RTL (ar/fa/he): language wins. If the primary language is a RTL
+ *   script, RTL mode is applied regardless of the explicit progression
+ *   direction declared in the OPF.
+ */
+export declare function getScriptMode(metadata: Metadata): ScriptMode;

package/types/src/epub/index.d.ts

@@ -1,5 +1,6 @@
-export * from "./EpubNavigator";
-export * from "./frame";
-export * from "./fxl";
-export * from "./preferences";
-export * from "./css";
+export * from "./EpubNavigator.ts";
+export * from "./frame/index.ts";
+export * from "./fxl/index.ts";
+export * from "./preferences/index.ts";
+export * from "./css/index.ts";
+export { getScriptMode, type ScriptMode } from "./helpers/scriptMode.ts";