@readium/navigator 2.4.0 → 2.5.0-beta.2

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

@@ -0,0 +1,19 @@
+import { Metadata } from "@readium/shared";
+export type ScriptMode = 'ltr' | 'rtl' | 'cjk-horizontal' | 'cjk-vertical' | 'mongolian-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.
+ * - For Mongolian (mn): Traditional Mongolian script (mn-Mong) uses
+ *   writing-mode: vertical-lr. Cyrillic Mongolian (mn-Cyrl) is standard LTR.
+ *   An explicit script subtag is required; bare `mn` defaults to LTR.
+ */
+export declare function getScriptMode(metadata: Metadata): ScriptMode;

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

@@ -3,3 +3,4 @@ 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";

package/types/src/injection/epubInjectables.d.ts

@@ -1,6 +1,8 @@
 import { IInjectableRule } from "../injection/Injectable.ts";
 import { Metadata, Link } from "@readium/shared";
 /**
- * Creates injectable rules for EPUB content documents
+ * Creates injectable rules for EPUB content documents.
+ * Async so that script-specific Readium CSS stylesheets can be imported
+ * dynamically — only the variant that is actually needed is bundled.
  */
-export declare function createReadiumEpubRules(metadata: Metadata, readingOrderItems: Link[]): IInjectableRule[];
+export declare function createReadiumEpubRules(metadata: Metadata, readingOrderItems: Link[]): Promise<IInjectableRule[]>;

package/types/src/injection/webpubInjectables.d.ts

@@ -1,4 +1,4 @@
-import { IInjectableRule } from "../injection/Injectable";
+import { IInjectableRule } from "../injection/Injectable.ts";
 import { Link } from "@readium/shared";
 /**
  * Creates injectable rules for WebPub content documents