@foxycape/core 1.1.3

package/dist/kernal/plugins/PluginCore.d.ts

@@ -0,0 +1,18 @@
+import { IDisposable } from '../IDisposable';
+import { Reader } from '../Reader';
+
+export declare abstract class PluginCore implements IDisposable {
+    readonly reader: Reader;
+    constructor(reader: Reader, options?: any);
+    abstract get name(): string;
+    abstract get title(): string;
+    abstract get description(): string;
+    abstract get version(): string;
+    abstract get supportedVersion(): string;
+    abstract get supportedExtensions(): string[];
+    abstract get supportedLanguages(): string[];
+    abstract get isUIPlugin(): boolean;
+    abstract getContainer(): HTMLElement | undefined;
+    abstract load(): Promise<void>;
+    abstract dispose(): Promise<void>;
+}

package/dist/kernal/plugins/PluginCore.mjs

@@ -0,0 +1,9 @@
+class t {
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  constructor(o, s) {
+    this.reader = o;
+  }
+}
+export {
+  t as PluginCore
+};

package/dist/kernal/plugins/PluginManager.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("./PluginRegistry.cjs");class f{constructor(e,s,n,a){this.reader=e,this.loggerFactory=s,this.services=n,this.version=a,this.loadedPlugins=[],this.enablePlugins=async o=>{for(const[r,g]of u.PluginRegistry.entries())try{const i=await this.ensurePluginClass(r);if(!i){this.logger.warn("plugin not found,pluginName:",r);continue}const l=i.prototype.supportedVersion.trim();let t=l,d=l;l.startsWith(">=")&&(t=l.split(">=")[1].trim(),d=this.version);const p=this.compareVersion(this.version,t)>=0,P=this.compareVersion(this.version,d)<=0;if(!p){this.logger.warn("plugin's minVersion is not matched,pluginName:",r,"current:",this.version,"minVersion:",t);continue}if(!P){this.logger.warn("plugin's maxVersion is not matched,pluginName:",r,"current:",this.version,"maxVersion:",d);continue}const h=this.reader.locale?.getCurrentLanguage(),c=h?.split("-")?.[0];(i.prototype.supportedExtensions[0]=="*"||i.prototype.supportedExtensions.indexOf(o)>=0)&&(i.prototype.supportedLanguages[0]=="*"||i.prototype.supportedLanguages.indexOf(h)>=0||c&&i.prototype.supportedLanguages.indexOf(c)>=0)&&await this.enablePlugin(r,g.options)}catch(i){this.logger.error("load plugin failed,pluginName:",r,"err:",i.toString())}},this.resolveUrl=async o=>{const r=await this.services.get("internalUrlBuilder");return r?await r.getAbsoluteUrl(o):o},this.compareVersion=(o,r)=>{const g=o.split(".").map(t=>parseInt(t)*1),i=r.split(".").map(t=>parseInt(t)*1),l=Math.max(g.length,i.length);for(let t=0;t<l;t++){if((g[t]||0)>(i[t]||0))return 1;if((g[t]||0)<(i[t]||0))return-1}return 0},this.logger=this.loggerFactory.getLogger(this.constructor.name)}getLoadedPlugins(){return this.loadedPlugins}async enablePlugin(e,s){let n;if(typeof e=="string"){const a=await this.ensurePluginClass(e);if(!a){this.logger.warn("no plugin name:"+e);return}const o=s??u.PluginRegistry.get(e)?.options;n=new a(this.reader,o)}else n=e;n&&n.load().then(()=>{this.loadedPlugins.push(n)},a=>{this.logger.error("load plugin failed ...",a,e,s)})}async disablePlugin(e){let s;if(typeof e=="string"?s=this.loadedPlugins.find(n=>n.name==e):s=e,s){await s.dispose();const n=this.loadedPlugins.indexOf(s);n>=0&&this.loadedPlugins.splice(n,1)}}async dispose(){if(this.loadedPlugins.length>0){for(let e=0;e<this.loadedPlugins.length;e++)await this.loadedPlugins[e].dispose();this.loadedPlugins.length=0}}async ensurePluginClass(e){const s=await u.PluginRegistry.ensurePluginClass(e,this.resolveUrl);return!s&&u.PluginRegistry.get(e)?.scriptUrl&&this.logger.warn("plugin script loaded but PluginRegistry.register was not called,pluginName:",e),s}}exports.PluginManager=f;

package/dist/kernal/plugins/PluginManager.d.ts

@@ -0,0 +1,22 @@
+import { ILoggerFactory } from '../logger/ILoggerFactory';
+import { PluginCore } from './PluginCore';
+import { Reader } from '../Reader';
+import { ServiceCollection, ServiceMap } from '../services/ServiceCollection';
+
+export declare class PluginManager {
+    private readonly reader;
+    private readonly loggerFactory;
+    private readonly services;
+    private readonly version;
+    private readonly loadedPlugins;
+    private readonly logger;
+    constructor(reader: Reader, loggerFactory: ILoggerFactory, services: ServiceCollection<ServiceMap>, version: string);
+    getLoadedPlugins(): PluginCore[];
+    enablePlugins: (extension: string) => Promise<void>;
+    enablePlugin(plugin: PluginCore | string, pluginOptions?: any): Promise<void>;
+    disablePlugin(plugin: PluginCore | string): Promise<void>;
+    dispose(): Promise<void>;
+    private ensurePluginClass;
+    private resolveUrl;
+    private compareVersion;
+}

package/dist/kernal/plugins/PluginManager.mjs

@@ -0,0 +1,106 @@
+import { PluginRegistry as u } from "./PluginRegistry.mjs";
+class x {
+  constructor(e, t, n, a) {
+    this.reader = e, this.loggerFactory = t, this.services = n, this.version = a, this.loadedPlugins = [], this.enablePlugins = async (o) => {
+      for (const [r, g] of u.entries())
+        try {
+          const i = await this.ensurePluginClass(r);
+          if (!i) {
+            this.logger.warn("plugin not found,pluginName:", r);
+            continue;
+          }
+          const l = i.prototype.supportedVersion.trim();
+          let s = l, h = l;
+          l.startsWith(">=") && (s = l.split(">=")[1].trim(), h = this.version);
+          const c = this.compareVersion(this.version, s) >= 0, f = this.compareVersion(this.version, h) <= 0;
+          if (!c) {
+            this.logger.warn("plugin's minVersion is not matched,pluginName:", r, "current:", this.version, "minVersion:", s);
+            continue;
+          }
+          if (!f) {
+            this.logger.warn("plugin's maxVersion is not matched,pluginName:", r, "current:", this.version, "maxVersion:", h);
+            continue;
+          }
+          const d = this.reader.locale?.getCurrentLanguage(), p = d?.split("-")?.[0];
+          (i.prototype.supportedExtensions[0] == "*" || i.prototype.supportedExtensions.indexOf(o) >= 0) && (i.prototype.supportedLanguages[0] == "*" || i.prototype.supportedLanguages.indexOf(d) >= 0 || p && i.prototype.supportedLanguages.indexOf(p) >= 0) && await this.enablePlugin(r, g.options);
+        } catch (i) {
+          this.logger.error("load plugin failed,pluginName:", r, "err:", i.toString());
+        }
+    }, this.resolveUrl = async (o) => {
+      const r = await this.services.get("internalUrlBuilder");
+      return r ? await r.getAbsoluteUrl(o) : o;
+    }, this.compareVersion = (o, r) => {
+      const g = o.split(".").map((s) => parseInt(s) * 1), i = r.split(".").map((s) => parseInt(s) * 1), l = Math.max(g.length, i.length);
+      for (let s = 0; s < l; s++) {
+        if ((g[s] || 0) > (i[s] || 0))
+          return 1;
+        if ((g[s] || 0) < (i[s] || 0))
+          return -1;
+      }
+      return 0;
+    }, this.logger = this.loggerFactory.getLogger(this.constructor.name);
+  }
+  /**
+   * Gets currently loaded plugin instances for this reader.
+   */
+  getLoadedPlugins() {
+    return this.loadedPlugins;
+  }
+  /**
+   * Enables a single plugin for this reader.
+   * Resolves the plugin class first (loads script when needed).
+   * Plugin instance load() is not awaited, to avoid blocking the main flow.
+   * @param plugin Plugin instance or plugin name
+   * @param pluginOptions Plugin options (falls back to options from register/registerScript)
+   */
+  async enablePlugin(e, t) {
+    let n;
+    if (typeof e == "string") {
+      const a = await this.ensurePluginClass(e);
+      if (!a) {
+        this.logger.warn("no plugin name:" + e);
+        return;
+      }
+      const o = t ?? u.get(e)?.options;
+      n = new a(this.reader, o);
+    } else
+      n = e;
+    n && n.load().then(() => {
+      this.loadedPlugins.push(n);
+    }, (a) => {
+      this.logger.error("load plugin failed ...", a, e, t);
+    });
+  }
+  /**
+   * Disables a plugin for this reader.
+   * @param plugin Plugin instance or plugin name
+   */
+  async disablePlugin(e) {
+    let t;
+    if (typeof e == "string" ? t = this.loadedPlugins.find((n) => n.name == e) : t = e, t) {
+      await t.dispose();
+      const n = this.loadedPlugins.indexOf(t);
+      n >= 0 && this.loadedPlugins.splice(n, 1);
+    }
+  }
+  /**
+   * Disposes all loaded plugins for this reader.
+   */
+  async dispose() {
+    if (this.loadedPlugins.length > 0) {
+      for (let e = 0; e < this.loadedPlugins.length; e++)
+        await this.loadedPlugins[e].dispose();
+      this.loadedPlugins.length = 0;
+    }
+  }
+  /**
+   * Ensures the plugin class is available, loading the script when needed.
+   */
+  async ensurePluginClass(e) {
+    const t = await u.ensurePluginClass(e, this.resolveUrl);
+    return !t && u.get(e)?.scriptUrl && this.logger.warn("plugin script loaded but PluginRegistry.register was not called,pluginName:", e), t;
+  }
+}
+export {
+  x as PluginManager
+};

package/dist/kernal/plugins/PluginRegistry.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("../html/injector.cjs"),s=class s{static register(t,r,i){if(!t||!r)return;const e=s.sharedPlugins.get(t);s.sharedPlugins.set(t,{pluginClass:r,scriptUrl:e?.scriptUrl,options:i??e?.options})}static registerScript(t,r,i){if(!t||!r)return;const e=s.sharedPlugins.get(t);s.sharedPlugins.set(t,{pluginClass:e?.pluginClass,scriptUrl:r,options:i??e?.options})}static has(t){return s.sharedPlugins.has(t)}static get(t){return s.sharedPlugins.get(t)}static entries(){return s.sharedPlugins.entries()}static async ensurePluginClass(t,r){const i=s.sharedPlugins.get(t);if(i){if(i.pluginClass)return i.pluginClass;if(i.scriptUrl){await s.loadScript(i.scriptUrl,r);const e=s.sharedPlugins.get(t)?.pluginClass;if(e)return e}}}static async loadScript(t,r){const i=r?await r(t):t;let e=s.scriptLoads.get(i);e||(e=c.injectExternalJS(document,i,!1).catch(n=>{throw s.scriptLoads.delete(i),n}),s.scriptLoads.set(i,e)),await e}};s.sharedPlugins=new Map,s.scriptLoads=new Map;let a=s;exports.PluginRegistry=a;

package/dist/kernal/plugins/PluginRegistry.d.ts

@@ -0,0 +1,20 @@
+import { PluginCore } from './PluginCore';
+import { Reader } from '../Reader';
+
+export type PluginConstructor = new (reader: Reader, options?: any) => PluginCore;
+export type SharedPluginEntry = {
+    pluginClass?: PluginConstructor;
+    scriptUrl?: string;
+    options?: any;
+};
+export declare class PluginRegistry {
+    private static readonly sharedPlugins;
+    private static readonly scriptLoads;
+    static register(pluginName: string, pluginClass: PluginConstructor, options?: any): void;
+    static registerScript(pluginName: string, scriptUrl: string, options?: any): void;
+    static has(pluginName: string): boolean;
+    static get(pluginName: string): SharedPluginEntry | undefined;
+    static entries(): IterableIterator<[string, SharedPluginEntry]>;
+    static ensurePluginClass(pluginName: string, resolveUrl?: (src: string) => Promise<string>): Promise<PluginConstructor | undefined>;
+    static loadScript(scriptUrl: string, resolveUrl?: (src: string) => Promise<string>): Promise<void>;
+}

package/dist/kernal/plugins/PluginRegistry.mjs

@@ -0,0 +1,92 @@
+import { injectExternalJS as c } from "../html/injector.mjs";
+const t = class t {
+  /**
+   * Registers a plugin class by name (shared across all readers).
+   * Dynamically loaded scripts can also call this after they are evaluated.
+   * @param pluginName Plugin name
+   * @param pluginClass Plugin class constructor
+   * @param options Default plugin options
+   */
+  static register(s, a, i) {
+    if (!s || !a)
+      return;
+    const r = t.sharedPlugins.get(s);
+    t.sharedPlugins.set(s, {
+      pluginClass: a,
+      scriptUrl: r?.scriptUrl,
+      options: i ?? r?.options
+    });
+  }
+  /**
+   * Registers a plugin script by name for dynamic loading (shared across all readers).
+   * The script should call PluginRegistry.register(name, PluginClass) when loaded.
+   * @param pluginName Plugin name
+   * @param scriptUrl Plugin script url
+   * @param options Default plugin options
+   */
+  static registerScript(s, a, i) {
+    if (!s || !a)
+      return;
+    const r = t.sharedPlugins.get(s);
+    t.sharedPlugins.set(s, {
+      pluginClass: r?.pluginClass,
+      scriptUrl: a,
+      options: i ?? r?.options
+    });
+  }
+  /**
+   * Whether a plugin is registered for the name.
+   * @param pluginName Plugin name
+   */
+  static has(s) {
+    return t.sharedPlugins.has(s);
+  }
+  /**
+   * Gets a shared plugin registration entry.
+   * @param pluginName Plugin name
+   */
+  static get(s) {
+    return t.sharedPlugins.get(s);
+  }
+  /**
+   * Iterates all shared plugin registrations.
+   */
+  static entries() {
+    return t.sharedPlugins.entries();
+  }
+  /**
+   * Ensures the plugin class is available, loading the script when needed.
+   * @param pluginName Plugin name
+   * @param resolveUrl Optional url resolver (e.g. internalUrlBuilder)
+   */
+  static async ensurePluginClass(s, a) {
+    const i = t.sharedPlugins.get(s);
+    if (i) {
+      if (i.pluginClass)
+        return i.pluginClass;
+      if (i.scriptUrl) {
+        await t.loadScript(i.scriptUrl, a);
+        const r = t.sharedPlugins.get(s)?.pluginClass;
+        if (r)
+          return r;
+      }
+    }
+  }
+  /**
+   * Loads a plugin script once per absolute url across all readers.
+   * @param scriptUrl Plugin script url
+   * @param resolveUrl Optional url resolver (e.g. internalUrlBuilder)
+   */
+  static async loadScript(s, a) {
+    const i = a ? await a(s) : s;
+    let r = t.scriptLoads.get(i);
+    r || (r = c(document, i, !1).catch((n) => {
+      throw t.scriptLoads.delete(i), n;
+    }), t.scriptLoads.set(i, r)), await r;
+  }
+};
+t.sharedPlugins = /* @__PURE__ */ new Map(), t.scriptLoads = /* @__PURE__ */ new Map();
+let e = t;
+export {
+  e as PluginRegistry
+};

package/dist/kernal/plugins/keyboard/KeyboardPageTurning.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("hotkeys-js"),d=require("perfect-debounce"),u=require("../../EventNames.cjs"),g=require("../PluginCore.cjs"),l="left,up,pageup",p="right,down,pagedown";class c extends g.PluginCore{constructor(t,s){super(t,s),this.bindedFlipPageElements=[],this.bindedDocuments=[],this.heldKeys={},this.currentPauseFlipPageOnPressKey=!1,this.documentKeydownHandlers=new Map,this.documentKeyupHandlers=new Map,this.onDocumentLoad=async e=>{await this.bindDocument(e)},this.onPressPreviousKey=(e,n)=>{if(this.pluginOptions.flipMode=="page"){if(this.heldKeys[e.keyCode]>1)return;this.currentPauseFlipPageOnPressKey||(e.preventDefault(),e.stopImmediatePropagation(),this.reader.context.setUserChangedProgress(!0,"keyboard"),this.delayGotoPreviousPage(this.reader.getRenderer()))}else this.reader.context.setUserChangedProgress(!0,"keyboard")},this.onPressNextKey=(e,n)=>{if(this.pluginOptions.flipMode=="page"){if(this.heldKeys[e.keyCode]>1)return;this.currentPauseFlipPageOnPressKey||(e.preventDefault(),e.stopImmediatePropagation(),this.reader.context.setUserChangedProgress(!0,"keyboard"),this.delayGotoNextPage(this.reader.getRenderer()))}else this.reader.context.setUserChangedProgress(!0,"keyboard")},this.delayGotoPreviousPage=d.debounce(async e=>{if(e?.pagingNavigator){await e.pagingNavigator.gotoPreviousPage({trigger:"user",triggerType:"key"});return}await e?.gotoPreviousPage?.({trigger:"user",triggerType:"key"})},64),this.delayGotoNextPage=d.debounce(async e=>{if(e?.pagingNavigator){await e.pagingNavigator.gotoNextPage({trigger:"user",triggerType:"key"});return}await e?.gotoNextPage?.({trigger:"user",triggerType:"key"})},64),this.pluginOptions={flipMode:s?.flipMode??"page",flipPagePreviousKeys:s?.flipPagePreviousKeys??l,flipPageNextKeys:s?.flipPageNextKeys??p}}get name(){return"keyboard-page-turning"}get title(){return"Keyboard Page Turning"}get description(){return"Keyboard page flip navigation"}get version(){return"1.0.0"}get supportedVersion(){return">=1.0.0"}get supportedExtensions(){return[".xml",".xhtml",".html",".epub",".mobi",".azw3",".fb2",".txt"]}get supportedLanguages(){return["*"]}get isUIPlugin(){return!1}getContainer(){}set pauseFlipPageOnPressKey(t){this.currentPauseFlipPageOnPressKey=t}get pauseFlipPageOnPressKey(){return this.currentPauseFlipPageOnPressKey}async load(){const t=this.reader.getReaderContainer();t&&(await this.bindFlipPageKeys(t.ownerDocument.documentElement),t.ownerDocument!==document&&await this.bindFlipPageKeys(document.documentElement));const s=this.reader.getRenderer()?.getLoadedDocuments?.()??this.reader.getRenderer()?.getDocuments?.()??[];for(const e of s)await this.bindDocument(e);this.reader.events.on(u.EventNames.DocumentLoad,this.onDocumentLoad)}async dispose(){this.reader.events.off(u.EventNames.DocumentLoad,this.onDocumentLoad);const t=this.pluginOptions.flipPagePreviousKeys,s=this.pluginOptions.flipPageNextKeys;this.bindedFlipPageElements.length>0&&(t&&o.unbind(t,"all",this.onPressPreviousKey),s&&o.unbind(s,"all",this.onPressNextKey));for(const e of this.bindedDocuments){const n=this.documentKeydownHandlers.get(e),i=this.documentKeyupHandlers.get(e);n&&e.removeEventListener("keydown",n,!0),i&&e.removeEventListener("keyup",i,!0)}this.documentKeydownHandlers.clear(),this.documentKeyupHandlers.clear(),this.bindedFlipPageElements=[],this.bindedDocuments=[],this.heldKeys={},this.currentPauseFlipPageOnPressKey=!1}async bindDocument(t){const s=t.getContentContainer()?.ownerDocument?.documentElement;s&&await this.bindFlipPageKeys(s)}async bindFlipPageKeys(t){if(this.bindedFlipPageElements.includes(t))return;const s=this.pluginOptions.flipPagePreviousKeys,e=this.pluginOptions.flipPageNextKeys;s&&o(s,{element:t,scope:"all"},this.onPressPreviousKey),e&&o(e,{element:t,scope:"all"},this.onPressNextKey);const n=t.ownerDocument;if(!this.bindedDocuments.includes(n)){this.bindedDocuments.push(n);const i=r=>{this.heldKeys[r.keyCode]=(this.heldKeys[r.keyCode]??0)+1},a=r=>{this.heldKeys[r.keyCode]=0};this.documentKeydownHandlers.set(n,i),this.documentKeyupHandlers.set(n,a),n.addEventListener("keydown",i,!0),n.addEventListener("keyup",a,!0)}this.bindedFlipPageElements.push(t)}}exports.KeyboardPageTurning=c;

package/dist/kernal/plugins/keyboard/KeyboardPageTurning.d.ts

@@ -0,0 +1,39 @@
+import { PluginCore } from '../PluginCore';
+import { Reader } from '../../Reader';
+import { FlipMode } from '../../types';
+
+export type KeyboardPageTurningOptions = {
+    flipPagePreviousKeys?: string;
+    flipPageNextKeys?: string;
+    flipMode?: FlipMode;
+};
+export declare class KeyboardPageTurning extends PluginCore {
+    private readonly pluginOptions;
+    private bindedFlipPageElements;
+    private bindedDocuments;
+    private heldKeys;
+    private currentPauseFlipPageOnPressKey;
+    private readonly documentKeydownHandlers;
+    private readonly documentKeyupHandlers;
+    constructor(reader: Reader, options?: KeyboardPageTurningOptions);
+    get name(): string;
+    get title(): string;
+    get description(): string;
+    get version(): string;
+    get supportedVersion(): string;
+    get supportedExtensions(): string[];
+    get supportedLanguages(): string[];
+    get isUIPlugin(): boolean;
+    getContainer(): HTMLElement | undefined;
+    set pauseFlipPageOnPressKey(value: boolean);
+    get pauseFlipPageOnPressKey(): boolean;
+    load(): Promise<void>;
+    dispose(): Promise<void>;
+    private onDocumentLoad;
+    private bindDocument;
+    private bindFlipPageKeys;
+    private onPressPreviousKey;
+    private onPressNextKey;
+    private delayGotoPreviousPage;
+    private delayGotoNextPage;
+}

package/dist/kernal/plugins/keyboard/KeyboardPageTurning.mjs

@@ -0,0 +1,134 @@
+import o from "hotkeys-js";
+import { debounce as d } from "perfect-debounce";
+import { EventNames as u } from "../../EventNames.mjs";
+import { PluginCore as g } from "../PluginCore.mjs";
+const p = "left,up,pageup", l = "right,down,pagedown";
+class f extends g {
+  constructor(t, s) {
+    super(t, s), this.bindedFlipPageElements = [], this.bindedDocuments = [], this.heldKeys = {}, this.currentPauseFlipPageOnPressKey = !1, this.documentKeydownHandlers = /* @__PURE__ */ new Map(), this.documentKeyupHandlers = /* @__PURE__ */ new Map(), this.onDocumentLoad = async (e) => {
+      await this.bindDocument(e);
+    }, this.onPressPreviousKey = (e, i) => {
+      if (this.pluginOptions.flipMode == "page") {
+        if (this.heldKeys[e.keyCode] > 1)
+          return;
+        this.currentPauseFlipPageOnPressKey || (e.preventDefault(), e.stopImmediatePropagation(), this.reader.context.setUserChangedProgress(!0, "keyboard"), this.delayGotoPreviousPage(this.reader.getRenderer()));
+      } else
+        this.reader.context.setUserChangedProgress(!0, "keyboard");
+    }, this.onPressNextKey = (e, i) => {
+      if (this.pluginOptions.flipMode == "page") {
+        if (this.heldKeys[e.keyCode] > 1)
+          return;
+        this.currentPauseFlipPageOnPressKey || (e.preventDefault(), e.stopImmediatePropagation(), this.reader.context.setUserChangedProgress(!0, "keyboard"), this.delayGotoNextPage(this.reader.getRenderer()));
+      } else
+        this.reader.context.setUserChangedProgress(!0, "keyboard");
+    }, this.delayGotoPreviousPage = d(async (e) => {
+      if (e?.pagingNavigator) {
+        await e.pagingNavigator.gotoPreviousPage({
+          trigger: "user",
+          triggerType: "key"
+        });
+        return;
+      }
+      await e?.gotoPreviousPage?.({
+        trigger: "user",
+        triggerType: "key"
+      });
+    }, 64), this.delayGotoNextPage = d(async (e) => {
+      if (e?.pagingNavigator) {
+        await e.pagingNavigator.gotoNextPage({
+          trigger: "user",
+          triggerType: "key"
+        });
+        return;
+      }
+      await e?.gotoNextPage?.({
+        trigger: "user",
+        triggerType: "key"
+      });
+    }, 64), this.pluginOptions = {
+      flipMode: s?.flipMode ?? "page",
+      flipPagePreviousKeys: s?.flipPagePreviousKeys ?? p,
+      flipPageNextKeys: s?.flipPageNextKeys ?? l
+    };
+  }
+  get name() {
+    return "keyboard-page-turning";
+  }
+  get title() {
+    return "Keyboard Page Turning";
+  }
+  get description() {
+    return "Keyboard page flip navigation";
+  }
+  get version() {
+    return "1.0.0";
+  }
+  get supportedVersion() {
+    return ">=1.0.0";
+  }
+  get supportedExtensions() {
+    return [".xml", ".xhtml", ".html", ".epub", ".mobi", ".azw3", ".fb2", ".txt"];
+  }
+  get supportedLanguages() {
+    return ["*"];
+  }
+  get isUIPlugin() {
+    return !1;
+  }
+  getContainer() {
+  }
+  set pauseFlipPageOnPressKey(t) {
+    this.currentPauseFlipPageOnPressKey = t;
+  }
+  get pauseFlipPageOnPressKey() {
+    return this.currentPauseFlipPageOnPressKey;
+  }
+  async load() {
+    const t = this.reader.getReaderContainer();
+    t && (await this.bindFlipPageKeys(t.ownerDocument.documentElement), t.ownerDocument !== document && await this.bindFlipPageKeys(document.documentElement));
+    const s = this.reader.getRenderer()?.getLoadedDocuments?.() ?? this.reader.getRenderer()?.getDocuments?.() ?? [];
+    for (const e of s)
+      await this.bindDocument(e);
+    this.reader.events.on(u.DocumentLoad, this.onDocumentLoad);
+  }
+  async dispose() {
+    this.reader.events.off(u.DocumentLoad, this.onDocumentLoad);
+    const t = this.pluginOptions.flipPagePreviousKeys, s = this.pluginOptions.flipPageNextKeys;
+    this.bindedFlipPageElements.length > 0 && (t && o.unbind(t, "all", this.onPressPreviousKey), s && o.unbind(s, "all", this.onPressNextKey));
+    for (const e of this.bindedDocuments) {
+      const i = this.documentKeydownHandlers.get(e), n = this.documentKeyupHandlers.get(e);
+      i && e.removeEventListener("keydown", i, !0), n && e.removeEventListener("keyup", n, !0);
+    }
+    this.documentKeydownHandlers.clear(), this.documentKeyupHandlers.clear(), this.bindedFlipPageElements = [], this.bindedDocuments = [], this.heldKeys = {}, this.currentPauseFlipPageOnPressKey = !1;
+  }
+  async bindDocument(t) {
+    const s = t.getContentContainer()?.ownerDocument?.documentElement;
+    s && await this.bindFlipPageKeys(s);
+  }
+  async bindFlipPageKeys(t) {
+    if (this.bindedFlipPageElements.includes(t))
+      return;
+    const s = this.pluginOptions.flipPagePreviousKeys, e = this.pluginOptions.flipPageNextKeys;
+    s && o(s, {
+      element: t,
+      scope: "all"
+    }, this.onPressPreviousKey), e && o(e, {
+      element: t,
+      scope: "all"
+    }, this.onPressNextKey);
+    const i = t.ownerDocument;
+    if (!this.bindedDocuments.includes(i)) {
+      this.bindedDocuments.push(i);
+      const n = (r) => {
+        this.heldKeys[r.keyCode] = (this.heldKeys[r.keyCode] ?? 0) + 1;
+      }, a = (r) => {
+        this.heldKeys[r.keyCode] = 0;
+      };
+      this.documentKeydownHandlers.set(i, n), this.documentKeyupHandlers.set(i, a), i.addEventListener("keydown", n, !0), i.addEventListener("keyup", a, !0);
+    }
+    this.bindedFlipPageElements.push(t);
+  }
+}
+export {
+  f as KeyboardPageTurning
+};

package/dist/kernal/plugins/mouse/WheelPageTurning.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("../../web/BrowserCapabilities.cjs"),o=require("../../EventNames.cjs"),l=require("../../html/finder.cjs"),u=require("../PluginCore.cjs");class g extends u.PluginCore{constructor(i,n){super(i,n),this.userEvents=["wheel","keydown","mousedown","touchstart"],this.falsePassiveOpts={passive:h.BrowserCapabilities.supportPassive()},this.injectedElements=new Set,this.enableWheel=!0,this.currentEnableWheel=!0,this.onDocumentLoad=e=>{this.bindDocument(e)},this.onDocumentDisposing=e=>{const t=e.getContentContainer()?.ownerDocument?.documentElement,s=e.getWrapperContainer?.(),a=[];t&&a.push(t),s&&a.push(s),a.length>0&&this.removeScrollListener(a)},this.updateShouldUpdateProgress=e=>{let r;e.type=="keydown"?r="keyboard":e.type=="wheel"?r="wheel":e.type=="mousedown"||e.type=="mousemove"?r="mouse":e.type=="touchstart"&&(r="touch"),this.reader.context?.setUserChangedProgress(!0,r)},this.handleWheel=e=>{if(e.ctrlKey)return;this.updateShouldUpdateProgress(e),this.reader.context.currentLocation&&(this.reader.context.currentLocation.precise=!1);const r=this.pluginOptions.flipMode=="page"&&this.enableWheel&&this.currentEnableWheel;e.stopImmediatePropagation();let t=0;e.deltaMode===0&&Math.abs(e.deltaX)<4&&Math.abs(e.deltaY)<4||(t=Math.abs(e.deltaX)>=Math.abs(e.deltaY)?e.deltaX:e.deltaY),r&&t!==0&&this.onWheelFlip(t,e),this.currentEnableWheel&&(this.currentEnableWheel=!1,this.wheelTimeoutId=setTimeout(()=>{this.currentEnableWheel=!0},this.pluginOptions.pageTurnInterval))},this.onWheelFlip=async(e,r)=>{const t=r.target;if(l.compareTagName(t?.tagName,"PRE")){if(Math.abs(t.clientHeight-t.scrollHeight)>10)return}else if(l.compareTagName(t?.tagName,"CODE")&&(Math.abs(t.clientHeight-t.scrollHeight)>10||t.parentElement&&Math.abs(t.parentElement.clientHeight-t.parentElement.scrollHeight)>10))return;const s=this.reader.getRenderer();if(e<0){if(s?.pagingNavigator){await s.pagingNavigator.gotoPreviousPage({trigger:"user",triggerType:"wheel"});return}await s?.gotoPreviousPage?.({trigger:"user",triggerType:"wheel"});return}if(s?.pagingNavigator){await s.pagingNavigator.gotoNextPage({trigger:"user",triggerType:"wheel"});return}await s?.gotoNextPage?.({trigger:"user",triggerType:"wheel"})},this.pluginOptions={pageTurnInterval:n?.pageTurnInterval??300,flipMode:n?.flipMode??"page"}}get name(){return"wheel-page-turning"}get title(){return"Wheel Page Turning"}get description(){return"Mouse wheel page flip navigation"}get version(){return"1.0.0"}get supportedVersion(){return">=1.0.0"}get supportedExtensions(){return[".xml",".xhtml",".html",".epub",".mobi",".azw3",".fb2",".txt"]}get supportedLanguages(){return["*"]}get isUIPlugin(){return!1}getContainer(){}toggleWheel(i){this.enableWheel=i}async load(){const i=this.reader.getReaderContainer();i&&this.addScrollListener([i]);const n=this.reader.getRenderer()?.getRendererContainer?.();n&&n!==i&&this.addScrollListener([n]);const e=this.reader.getRenderer()?.getLoadedDocuments?.()??this.reader.getRenderer()?.getDocuments?.()??[];for(const r of e)this.bindDocument(r);this.reader.events.on(o.EventNames.DocumentLoad,this.onDocumentLoad),this.reader.events.on(o.EventNames.DocumentDisposing,this.onDocumentDisposing)}async dispose(){this.reader.events.off(o.EventNames.DocumentLoad,this.onDocumentLoad),this.reader.events.off(o.EventNames.DocumentDisposing,this.onDocumentDisposing),this.wheelTimeoutId!==void 0&&(clearTimeout(this.wheelTimeoutId),this.wheelTimeoutId=void 0),this.removeScrollListener([...this.injectedElements]),this.enableWheel=!0,this.currentEnableWheel=!0}bindDocument(i){const e=i.getContentContainer()?.ownerDocument?.documentElement,r=i.getWrapperContainer?.(),t=[];e&&t.push(e),r&&r!==e&&t.push(r),t.length>0&&this.addScrollListener(t)}addScrollListener(i){i.forEach(n=>{this.injectedElements.has(n)||(this.userEvents.forEach(e=>{e=="wheel"?n.addEventListener("wheel",this.handleWheel,this.falsePassiveOpts):n.addEventListener(e,this.updateShouldUpdateProgress,this.falsePassiveOpts)}),this.injectedElements.add(n))})}removeScrollListener(i){i.forEach(n=>{this.injectedElements.has(n)&&(this.userEvents.forEach(e=>{e=="wheel"?n.removeEventListener("wheel",this.handleWheel,this.falsePassiveOpts):n.removeEventListener(e,this.updateShouldUpdateProgress,this.falsePassiveOpts)}),this.injectedElements.delete(n))})}}exports.WheelPageTurning=g;

package/dist/kernal/plugins/mouse/WheelPageTurning.d.ts

@@ -0,0 +1,38 @@
+import { Reader } from '../../Reader';
+import { PluginCore } from '../PluginCore';
+import { FlipMode } from '../../types';
+
+export type WheelPageTurningOptions = {
+    pageTurnInterval?: number;
+    flipMode?: FlipMode;
+};
+export declare class WheelPageTurning extends PluginCore {
+    private readonly pluginOptions;
+    private readonly userEvents;
+    private readonly falsePassiveOpts;
+    private readonly injectedElements;
+    private enableWheel;
+    private currentEnableWheel;
+    private wheelTimeoutId;
+    constructor(reader: Reader, options?: WheelPageTurningOptions);
+    get name(): string;
+    get title(): string;
+    get description(): string;
+    get version(): string;
+    get supportedVersion(): string;
+    get supportedExtensions(): string[];
+    get supportedLanguages(): string[];
+    get isUIPlugin(): boolean;
+    getContainer(): HTMLElement | undefined;
+    toggleWheel(enable: boolean): void;
+    load(): Promise<void>;
+    dispose(): Promise<void>;
+    private onDocumentLoad;
+    private onDocumentDisposing;
+    private bindDocument;
+    private addScrollListener;
+    private removeScrollListener;
+    private updateShouldUpdateProgress;
+    private handleWheel;
+    private onWheelFlip;
+}

package/dist/kernal/plugins/mouse/WheelPageTurning.mjs

@@ -0,0 +1,128 @@
+import { BrowserCapabilities as l } from "../../web/BrowserCapabilities.mjs";
+import { EventNames as a } from "../../EventNames.mjs";
+import { compareTagName as h } from "../../html/finder.mjs";
+import { PluginCore as u } from "../PluginCore.mjs";
+class f extends u {
+  constructor(i, r) {
+    super(i, r), this.userEvents = ["wheel", "keydown", "mousedown", "touchstart"], this.falsePassiveOpts = {
+      passive: l.supportPassive()
+    }, this.injectedElements = /* @__PURE__ */ new Set(), this.enableWheel = !0, this.currentEnableWheel = !0, this.onDocumentLoad = (e) => {
+      this.bindDocument(e);
+    }, this.onDocumentDisposing = (e) => {
+      const t = e.getContentContainer()?.ownerDocument?.documentElement, s = e.getWrapperContainer?.(), o = [];
+      t && o.push(t), s && o.push(s), o.length > 0 && this.removeScrollListener(o);
+    }, this.updateShouldUpdateProgress = (e) => {
+      let n;
+      e.type == "keydown" ? n = "keyboard" : e.type == "wheel" ? n = "wheel" : e.type == "mousedown" || e.type == "mousemove" ? n = "mouse" : e.type == "touchstart" && (n = "touch"), this.reader.context?.setUserChangedProgress(!0, n);
+    }, this.handleWheel = (e) => {
+      if (e.ctrlKey)
+        return;
+      this.updateShouldUpdateProgress(e), this.reader.context.currentLocation && (this.reader.context.currentLocation.precise = !1);
+      const n = this.pluginOptions.flipMode == "page" && this.enableWheel && this.currentEnableWheel;
+      e.stopImmediatePropagation();
+      let t = 0;
+      e.deltaMode === 0 && Math.abs(e.deltaX) < 4 && Math.abs(e.deltaY) < 4 || (t = Math.abs(e.deltaX) >= Math.abs(e.deltaY) ? e.deltaX : e.deltaY), n && t !== 0 && this.onWheelFlip(t, e), this.currentEnableWheel && (this.currentEnableWheel = !1, this.wheelTimeoutId = setTimeout(() => {
+        this.currentEnableWheel = !0;
+      }, this.pluginOptions.pageTurnInterval));
+    }, this.onWheelFlip = async (e, n) => {
+      const t = n.target;
+      if (h(t?.tagName, "PRE")) {
+        if (Math.abs(t.clientHeight - t.scrollHeight) > 10)
+          return;
+      } else if (h(t?.tagName, "CODE") && (Math.abs(t.clientHeight - t.scrollHeight) > 10 || t.parentElement && Math.abs(t.parentElement.clientHeight - t.parentElement.scrollHeight) > 10))
+        return;
+      const s = this.reader.getRenderer();
+      if (e < 0) {
+        if (s?.pagingNavigator) {
+          await s.pagingNavigator.gotoPreviousPage({
+            trigger: "user",
+            triggerType: "wheel"
+          });
+          return;
+        }
+        await s?.gotoPreviousPage?.({
+          trigger: "user",
+          triggerType: "wheel"
+        });
+        return;
+      }
+      if (s?.pagingNavigator) {
+        await s.pagingNavigator.gotoNextPage({
+          trigger: "user",
+          triggerType: "wheel"
+        });
+        return;
+      }
+      await s?.gotoNextPage?.({
+        trigger: "user",
+        triggerType: "wheel"
+      });
+    }, this.pluginOptions = {
+      pageTurnInterval: r?.pageTurnInterval ?? 300,
+      flipMode: r?.flipMode ?? "page"
+    };
+  }
+  get name() {
+    return "wheel-page-turning";
+  }
+  get title() {
+    return "Wheel Page Turning";
+  }
+  get description() {
+    return "Mouse wheel page flip navigation";
+  }
+  get version() {
+    return "1.0.0";
+  }
+  get supportedVersion() {
+    return ">=1.0.0";
+  }
+  get supportedExtensions() {
+    return [".xml", ".xhtml", ".html", ".epub", ".mobi", ".azw3", ".fb2", ".txt"];
+  }
+  get supportedLanguages() {
+    return ["*"];
+  }
+  get isUIPlugin() {
+    return !1;
+  }
+  getContainer() {
+  }
+  toggleWheel(i) {
+    this.enableWheel = i;
+  }
+  async load() {
+    const i = this.reader.getReaderContainer();
+    i && this.addScrollListener([i]);
+    const r = this.reader.getRenderer()?.getRendererContainer?.();
+    r && r !== i && this.addScrollListener([r]);
+    const e = this.reader.getRenderer()?.getLoadedDocuments?.() ?? this.reader.getRenderer()?.getDocuments?.() ?? [];
+    for (const n of e)
+      this.bindDocument(n);
+    this.reader.events.on(a.DocumentLoad, this.onDocumentLoad), this.reader.events.on(a.DocumentDisposing, this.onDocumentDisposing);
+  }
+  async dispose() {
+    this.reader.events.off(a.DocumentLoad, this.onDocumentLoad), this.reader.events.off(a.DocumentDisposing, this.onDocumentDisposing), this.wheelTimeoutId !== void 0 && (clearTimeout(this.wheelTimeoutId), this.wheelTimeoutId = void 0), this.removeScrollListener([...this.injectedElements]), this.enableWheel = !0, this.currentEnableWheel = !0;
+  }
+  bindDocument(i) {
+    const e = i.getContentContainer()?.ownerDocument?.documentElement, n = i.getWrapperContainer?.(), t = [];
+    e && t.push(e), n && n !== e && t.push(n), t.length > 0 && this.addScrollListener(t);
+  }
+  addScrollListener(i) {
+    i.forEach((r) => {
+      this.injectedElements.has(r) || (this.userEvents.forEach((e) => {
+        e == "wheel" ? r.addEventListener("wheel", this.handleWheel, this.falsePassiveOpts) : r.addEventListener(e, this.updateShouldUpdateProgress, this.falsePassiveOpts);
+      }), this.injectedElements.add(r));
+    });
+  }
+  removeScrollListener(i) {
+    i.forEach((r) => {
+      this.injectedElements.has(r) && (this.userEvents.forEach((e) => {
+        e == "wheel" ? r.removeEventListener("wheel", this.handleWheel, this.falsePassiveOpts) : r.removeEventListener(e, this.updateShouldUpdateProgress, this.falsePassiveOpts);
+      }), this.injectedElements.delete(r));
+    });
+  }
+}
+export {
+  f as WheelPageTurning
+};

package/dist/kernal/progress/IProgressTracker.cjs

@@ -0,0 +1 @@
+"use strict";

package/dist/kernal/progress/IProgressTracker.d.ts

@@ -0,0 +1,5 @@
+import { Progress } from './Progress';
+
+export interface IProgressTracker {
+    getProgress(precise?: boolean): Promise<Progress>;
+}

package/dist/kernal/progress/IProgressTracker.mjs

@@ -0,0 +1 @@
+

package/dist/kernal/progress/IReadingProgressStore.cjs

@@ -0,0 +1 @@
+"use strict";