@foxycape/core 1.1.3

package/LICENSE

@@ -0,0 +1,30 @@
+MIT License
+
+Copyright (c) 2026 Foxycape
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+--------------------------------------------------------------------------------
+
+Third-party notice:
+
+This package vendors Mozilla PDF.js (see dist/pdfjs after build, or pdfjs/ in
+the source tree), which is licensed under the Apache License, Version 2.0.
+The full Apache-2.0 text is included alongside the vendored files
+(dist/pdfjs/LICENSE or pdfjs/LICENSE).

package/README.MD

@@ -0,0 +1,155 @@
+<div align="center">
+  <img src="docs/logo-64x64.png" alt="Foxycape Core" width="64" height="64" />
+  <h1>Foxycape Core</h1>
+</div>
+
+A browser-side multi-format reader kernel — one `Reader` API with pluggable parsers/renderers, services, and plugins for PDF, HTML, and more.
+
+[English](README.MD) | [中文](README.zh.md)
+
+## Overview
+
+Foxycape Core (`@foxycape/core`) is a browser reader runtime you embed in your own app.
+
+- **Includes**: the kernel under `kernal/` plus media implementations in `mediaTypes/html` and `mediaTypes/pdf`.
+- **Does not include**: application chrome or product-specific UI — those belong in the host.
+
+Public API barrel: `kernal/index.ts` (also `@foxycape/core` / `@foxycape/core/kernal`). Media implementations are imported by path (for example `@foxycape/core/mediaTypes/pdf/...`).
+
+## Install
+
+```bash
+npm install @foxycape/core
+```
+
+```ts
+import { Options, Reader } from '@foxycape/core'
+import { PdfRenderer } from '@foxycape/core/mediaTypes/pdf/renderer/PdfRenderer'
+```
+
+Build the package before packing or publishing:
+
+```bash
+npm run build
+```
+
+## Features
+
+### Unified open pipeline
+
+Configure with `Options`, then open a document through `Reader.open(source, container, root, openOptions?)`. For parse-only / headless flows without a DOM host, use `FileLoader`.
+
+### Pluggable media types
+
+Register format support through `MediaTypeRegistry`:
+
+```ts
+reader.mediaTypeRegistry.register(
+  ['.pdf'],
+  async (url, extension) => /* FileParser */,
+  async (owner, fileParser, el) => /* Renderer */,
+)
+```
+
+PDF and HTML parsers/renderers ship under `mediaTypes/`. Samples show the registration pattern.
+
+### Service injection
+
+`ServiceCollection` lets hosts replace cross-cutting services such as HTTP, storage, loading UI, notifier, theme, and wallpaper providers:
+
+```ts
+reader.services.add('themeProvider', () => new HostThemeProvider())
+```
+
+### Plugin system
+
+Extend interaction and behavior with `PluginCore`, register globally via `PluginRegistry`, and enable per reader instance through `PluginManager` (filtered by extension / language / version).
+
+### Lifecycle hooks and events
+
+Hook into load and render stages (`onInitialize`, `onFileParsed`, `onRenderer` / `onRenderered`, dispose hooks, and more). Subscribe to `EventNames` for page changes, progress, password prompts, theme changes, and related reader events.
+
+### Mark contracts
+
+`kernal/mark` defines `IMarker`, `Mark`, `MarkType`, and `ContentRange`. Core owns the contracts and shared geometry helpers; concrete mark engines usually live in the host.
+
+### Navigation and theme
+
+Paging, outline/nav points, reading progress, and theme/style provider interfaces keep layout and chrome concerns host-replaceable without forking the kernel.
+
+## Architecture
+
+```
+.
+├── kernal/        # Reader, FileLoader, services, plugins, mark contracts
+├── mediaTypes/    # base / html / pdf parsers and renderers
+├── samples/       # Vite demos (HTML & PDF)
+├── tests/         # Vitest
+└── pdfjs/         # Vendored PDF.js (relative imports)
+```
+
+```mermaid
+flowchart LR
+  Host[Host app] --> Options[Options]
+  Options --> Reader[Reader]
+  Reader --> Registry[MediaTypeRegistry]
+  Registry --> Parser[FileParser]
+  Registry --> Renderer[Renderer]
+  Reader --> Services[ServiceCollection]
+  Reader --> Plugins[PluginManager]
+  Reader --> Events[EventEmitter]
+```
+
+Typical host flow:
+
+1. `new Options()` → `new Reader(options)`
+2. Register media types (and optionally services / plugins / lifecycle hooks)
+3. `await reader.open(...)`
+
+## Quick start
+
+From the package root:
+
+```bash
+npm install
+npm run sample:pdf
+# or
+npm run sample:html
+```
+
+Minimal integration sketch (see `samples/pdf/main.ts` for a full example):
+
+```ts
+import { Options, Reader } from '@foxycape/core'
+// registerPdfMediaType(reader) — see samples/pdf/registerPdfMediaType.ts
+
+const options = new Options()
+options.enableHeader = false
+options.enableFooter = false
+
+const reader = new Reader(options)
+// registerPdfMediaType(reader)
+
+await reader.open(source, container, root, {
+  extension: '.pdf',
+  fileName: 'a.pdf',
+})
+```
+
+## Development
+
+| Script | Purpose |
+|--------|---------|
+| `npm run build` | Vite library build → `dist` |
+| `npm run test` | Vitest once |
+| `npm run test:watch` | Vitest watch |
+| `npm run sample:html` | HTML reader demo |
+| `npm run sample:pdf` | PDF reader demo |
+
+PDF.js is vendored under `pdfjs/` and imported via relative paths from `mediaTypes/pdf/**`. The library build copies it into `dist/pdfjs`; the published npm package ships only `dist/` (including `dist/pdfjs`), not the source `pdfjs/` folder.
+
+## License
+
+Foxycape Core is licensed under the MIT License.
+
+This package vendors [PDF.js](https://github.com/mozilla/pdf.js) (under `dist/pdfjs` after build), which is licensed under the Apache License 2.0. See `dist/pdfjs/LICENSE` in the published package (or `pdfjs/LICENSE` in the source tree).

package/README.zh.md

@@ -0,0 +1,155 @@
+<div align="center">
+  <img src="docs/logo-64x64.png" alt="Foxycape Core" width="64" height="64" />
+  <h1>Foxycape Core</h1>
+</div>
+
+浏览器端多格式阅读器内核：统一 `Reader` API，通过可插拔解析器/渲染器、服务与插件承载 PDF、HTML 等格式。
+
+[English](README.MD) | [中文](README.zh.md)
+
+## 概述
+
+Foxycape Core（`@foxycape/core`）是可嵌入自有应用的浏览器阅读器运行时。
+
+- **包含**：`kernal/` 下的内核，以及 `mediaTypes/html`、`mediaTypes/pdf` 媒体实现。
+- **不包含**：应用级 chrome 或产品专用 UI——这些由宿主自行实现。
+
+公开 API barrel：`kernal/index.ts`（也可用 `@foxycape/core` / `@foxycape/core/kernal`）。媒体实现按路径导入（例如 `@foxycape/core/mediaTypes/pdf/...`）。
+
+## 安装
+
+```bash
+npm install @foxycape/core
+```
+
+```ts
+import { Options, Reader } from '@foxycape/core'
+import { PdfRenderer } from '@foxycape/core/mediaTypes/pdf/renderer/PdfRenderer'
+```
+
+打包或发布前请先构建：
+
+```bash
+npm run build
+```
+
+## 特点
+
+### 统一打开管线
+
+用 `Options` 配置，再通过 `Reader.open(source, container, root, openOptions?)` 打开文档。无需 DOM 宿主的纯解析 / 无头场景，使用 `FileLoader`。
+
+### 可扩展媒体类型
+
+通过 `MediaTypeRegistry` 注册格式支持：
+
+```ts
+reader.mediaTypeRegistry.register(
+  ['.pdf'],
+  async (url, extension) => /* FileParser */,
+  async (owner, fileParser, el) => /* Renderer */,
+)
+```
+
+PDF 与 HTML 的解析器/渲染器位于 `mediaTypes/`。注册方式见 `samples/`。
+
+### 服务注入
+
+`ServiceCollection` 允许宿主替换横切服务，例如 HTTP、存储、加载 UI、通知、主题与壁纸提供者：
+
+```ts
+reader.services.add('themeProvider', () => new HostThemeProvider())
+```
+
+### 插件系统
+
+用 `PluginCore` 扩展交互与行为，经 `PluginRegistry` 全局注册，再由 `PluginManager` 按扩展名 / 语言 / 版本在每个 Reader 实例上启用。
+
+### 生命周期与事件
+
+可在加载与渲染阶段挂接 hooks（`onInitialize`、`onFileParsed`、`onRenderer` / `onRenderered`、dispose 系列等）。通过 `EventNames` 订阅页码变化、进度、密码请求、主题变化等阅读器事件。
+
+### 标注契约
+
+`kernal/mark` 定义 `IMarker`、`Mark`、`MarkType`、`ContentRange`。Core 提供契约与共享几何工具；具体标注引擎通常由宿主实现。
+
+### 导航与主题
+
+分页、目录/导航点、阅读进度，以及主题/样式提供者接口，让布局与 chrome 可由宿主替换，而无需分叉内核。
+
+## 架构
+
+```
+.
+├── kernal/        # Reader、FileLoader、服务、插件、标注契约
+├── mediaTypes/    # base / html / pdf 解析器与渲染器
+├── samples/       # Vite demo（HTML & PDF）
+├── tests/         # Vitest
+└── pdfjs/         # 本地 vendored PDF.js（相对路径引用）
+```
+
+```mermaid
+flowchart LR
+  Host[Host app] --> Options[Options]
+  Options --> Reader[Reader]
+  Reader --> Registry[MediaTypeRegistry]
+  Registry --> Parser[FileParser]
+  Registry --> Renderer[Renderer]
+  Reader --> Services[ServiceCollection]
+  Reader --> Plugins[PluginManager]
+  Reader --> Events[EventEmitter]
+```
+
+典型宿主流程：
+
+1. `new Options()` → `new Reader(options)`
+2. 注册媒体类型（以及可选的服务 / 插件 / 生命周期 hooks）
+3. `await reader.open(...)`
+
+## 快速开始
+
+在包根目录下：
+
+```bash
+npm install
+npm run sample:pdf
+# 或
+npm run sample:html
+```
+
+最小集成示意（完整示例见 `samples/pdf/main.ts`）：
+
+```ts
+import { Options, Reader } from '@foxycape/core'
+// registerPdfMediaType(reader) — 见 samples/pdf/registerPdfMediaType.ts
+
+const options = new Options()
+options.enableHeader = false
+options.enableFooter = false
+
+const reader = new Reader(options)
+// registerPdfMediaType(reader)
+
+await reader.open(source, container, root, {
+  extension: '.pdf',
+  fileName: 'a.pdf',
+})
+```
+
+## 开发
+
+| 脚本 | 作用 |
+|------|------|
+| `npm run build` | Vite 库构建 → `dist` |
+| `npm run test` | 运行 Vitest |
+| `npm run test:watch` | Vitest watch |
+| `npm run sample:html` | HTML 阅读器 demo |
+| `npm run sample:pdf` | PDF 阅读器 demo |
+
+PDF.js 以源码形式放在 `pdfjs/`，由 `mediaTypes/pdf/**` 通过相对路径引用。库构建会复制到 `dist/pdfjs`；发布到 npm 时只包含 `dist/`（含 `dist/pdfjs`），不包含源码树中的 `pdfjs/` 目录。
+
+## 开源协议
+
+Foxycape Core 采用 MIT 开源协议。
+
+本包内嵌了 [PDF.js](https://github.com/mozilla/pdf.js)（构建后位于 `dist/pdfjs`），其许可证为 Apache License 2.0。详见发布包中的 `dist/pdfjs/LICENSE`（源码树中为 `pdfjs/LICENSE`）。

package/dist/core.css

@@ -0,0 +1 @@
+@keyframes notyf-fadeinup{0%{opacity:0;transform:translateY(25%)}to{opacity:1;transform:translateY(0)}}@keyframes notyf-fadeinleft{0%{opacity:0;transform:translate(25%)}to{opacity:1;transform:translate(0)}}@keyframes notyf-fadeoutright{0%{opacity:1;transform:translate(0)}to{opacity:0;transform:translate(25%)}}@keyframes notyf-fadeoutdown{0%{opacity:1;transform:translateY(0)}to{opacity:0;transform:translateY(25%)}}@keyframes ripple{0%{transform:scale(0) translateY(-45%) translate(13%)}to{transform:scale(1) translateY(-45%) translate(13%)}}.notyf{position:absolute;top:0;left:0;height:100%;width:100%;color:#fff;z-index:9999;display:flex;flex-direction:column;align-items:flex-end;justify-content:flex-end;pointer-events:none;box-sizing:border-box;padding:20px}.notyf__icon--error,.notyf__icon--success{height:21px;width:21px;background:#fff;border-radius:50%;display:block;margin:0 auto;position:relative}.notyf__icon--error:after,.notyf__icon--error:before{content:"";background:currentColor;display:block;position:absolute;width:3px;border-radius:3px;left:9px;height:12px;top:5px}.notyf__icon--error:after{transform:rotate(-45deg)}.notyf__icon--error:before{transform:rotate(45deg)}.notyf__icon--success:after,.notyf__icon--success:before{content:"";background:currentColor;display:block;position:absolute;width:3px;border-radius:3px}.notyf__icon--success:after{height:6px;transform:rotate(-45deg);top:9px;left:6px}.notyf__icon--success:before{height:11px;transform:rotate(45deg);top:5px;left:10px}.notyf__toast{display:block;overflow:hidden;pointer-events:auto;animation:notyf-fadeinup .3s ease-in forwards;box-shadow:0 3px 7px #00000040;position:relative;padding:0 15px;border-radius:2px;max-width:300px;transform:translateY(25%);box-sizing:border-box;flex-shrink:0;margin-block-start:40px}.notyf__toast--disappear{transform:translateY(0);animation:notyf-fadeoutdown .3s forwards;animation-delay:.25s}.notyf__toast--disappear .notyf__message,.notyf__toast--disappear .notyf__icon{animation:notyf-fadeoutdown .3s forwards;opacity:1;transform:translateY(0)}.notyf__toast--disappear .notyf__dismiss{animation:notyf-fadeoutright .3s forwards;opacity:1;transform:translate(0)}.notyf__toast--disappear .notyf__message{animation-delay:.05s}.notyf__toast--upper{margin-block-end:20px}.notyf__toast--lower{margin-block-start:20px}.notyf__toast--dismissible .notyf__wrapper{padding-inline-end:30px}.notyf__ripple{height:400px;width:400px;position:absolute;transform-origin:bottom right;right:0;top:0;border-radius:50%;transform:scale(0) translateY(-51%) translate(13%);z-index:5;animation:ripple .4s ease-out forwards}.notyf__wrapper{display:flex;align-items:center;padding-block-start:10px;padding-block-end:10px;padding-inline-end:0px;border-radius:3px;position:relative;z-index:10}.notyf__icon{width:22px;text-align:center;font-size:1.3em;opacity:0;animation:notyf-fadeinup .3s forwards;animation-delay:.3s;margin-inline-end:13px}.notyf__dismiss{position:absolute;top:0;right:0;height:100%;width:26px;margin-inline-end:-15px;animation:notyf-fadeinleft .3s forwards;animation-delay:.35s;opacity:0}.notyf__dismiss-btn{background-color:#00000040;border:none;cursor:pointer;transition:opacity .2s ease,background-color .2s ease;outline:none;opacity:.35;height:100%;width:100%}.notyf__dismiss-btn:after,.notyf__dismiss-btn:before{content:"";background:#fff;height:12px;width:2px;border-radius:3px;position:absolute;left:calc(50% - 1px);top:calc(50% - 5px)}.notyf__dismiss-btn:after{transform:rotate(-45deg)}.notyf__dismiss-btn:before{transform:rotate(45deg)}.notyf__dismiss-btn:hover{opacity:.7;background-color:#00000026}.notyf__dismiss-btn:active{opacity:.8}.notyf__message{vertical-align:middle;position:relative;opacity:0;animation:notyf-fadeinup .3s forwards;animation-delay:.25s;line-height:1.5em}

package/dist/kernal/Constants.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="lhx-reader-",t=/[\f\n\r\t\v]+/g,a="data-initial-index",n="data-mt-initial-index",i="data-is-last-element",m="data-animation-class-name",s=-2,l="ST",r="MT";exports.AnimationClassName=m;exports.ElementInitialNumberName=a;exports.ElementMtInitialNumberName=n;exports.LastElementAttributeName=i;exports.MTTAG=r;exports.ROOT_IDX=s;exports.STTAG=l;exports.readerPrefixName=e;exports.whitespaceRegex=t;

package/dist/kernal/Constants.d.ts

@@ -0,0 +1,9 @@
+export declare const readerPrefixName = "lhx-reader-";
+export declare const whitespaceRegex: RegExp;
+export declare const ElementInitialNumberName = "data-initial-index";
+export declare const ElementMtInitialNumberName = "data-mt-initial-index";
+export declare const LastElementAttributeName = "data-is-last-element";
+export declare const AnimationClassName = "data-animation-class-name";
+export declare const ROOT_IDX = -2;
+export declare const STTAG = "ST";
+export declare const MTTAG = "MT";

package/dist/kernal/Constants.mjs

@@ -0,0 +1,12 @@
+const t = "lhx-reader-", e = /[\f\n\r\t\v]+/g, a = "data-initial-index", n = "data-mt-initial-index", i = "data-is-last-element", s = "data-animation-class-name", m = -2, l = "ST", o = "MT";
+export {
+  s as AnimationClassName,
+  a as ElementInitialNumberName,
+  n as ElementMtInitialNumberName,
+  i as LastElementAttributeName,
+  o as MTTAG,
+  m as ROOT_IDX,
+  l as STTAG,
+  t as readerPrefixName,
+  e as whitespaceRegex
+};

package/dist/kernal/ContentRange.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=e=>e.kind==="fixed",t=e=>e.kind==="reflowable",i=e=>e.kind==="media";exports.isFixedContentRange=n;exports.isMediaContentRange=i;exports.isReflowableContentRange=t;

package/dist/kernal/ContentRange.d.ts

@@ -0,0 +1,44 @@
+import { SymbolType } from './types';
+
+export type ContentRangeKind = "reflowable" | "fixed" | "media";
+export type ContentShape = "rect" | "circ" | "poly";
+export type TextOffsetRange = {
+    startTextOffset: number;
+    endTextOffset: number;
+    symbolType?: SymbolType;
+};
+export type ContentGeometry = {
+    pageNumber: number;
+    width: number;
+    height: number;
+    shape: ContentShape;
+    coords: number[];
+};
+export type ReflowableAnchor = {
+    tagName: string;
+    tagIndex: number;
+    textOffset: number;
+};
+export type MediaAnchor = {
+    time: number;
+    trackId?: string;
+};
+export type ReflowableContentRange = {
+    kind: "reflowable";
+    start: ReflowableAnchor;
+    end: ReflowableAnchor;
+    textOffset?: TextOffsetRange;
+};
+export type FixedContentRange = {
+    kind: "fixed";
+    geometries: ContentGeometry[];
+};
+export type MediaContentRange = {
+    kind: "media";
+    start: MediaAnchor;
+    end: MediaAnchor;
+};
+export type ContentRange = ReflowableContentRange | FixedContentRange | MediaContentRange;
+export declare const isFixedContentRange: (range: ContentRange) => range is FixedContentRange;
+export declare const isReflowableContentRange: (range: ContentRange) => range is ReflowableContentRange;
+export declare const isMediaContentRange: (range: ContentRange) => range is MediaContentRange;

package/dist/kernal/ContentRange.mjs

@@ -0,0 +1,6 @@
+const n = (e) => e.kind === "fixed", i = (e) => e.kind === "reflowable", t = (e) => e.kind === "media";
+export {
+  n as isFixedContentRange,
+  t as isMediaContentRange,
+  i as isReflowableContentRange
+};

package/dist/kernal/Context.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("./EventNames.cjs"),s=require("./Metadata.cjs"),n=require("./OpenOptions.cjs"),o=require("./Options.cjs"),r=require("./progress/Progress.cjs");class a{constructor(e,t){this.events=e,this.metadata=new s.Metadata,this.progress=new r.Progress(1,0),this.currentUserChangedProgress=!0,t&&Object.assign(this,t),this.openOptions||(this.openOptions=new n.OpenOptions),this.options||(this.options=new o.Options),this.openOptions.resourceId=this.id,this.openOptions.simpleId=this.simpleId}get userChangedProgress(){return this.currentUserChangedProgress}setUserChangedProgress(e,t){e&&(this.events.emit(i.EventNames.UserChangedProgress,t),t!="toc"&&(this.currentNavPointKey=void 0)),this.currentUserChangedProgress=e}getTitle(){let e=this.metadata?.title??"";return e||(e=this.metadata?.fileName??""),e}get redirectingDocUrl(){return this.currentRedirectingDocUrl}set redirectingDocUrl(e){this.currentRedirectingDocUrl=e}async dispose(){this.metadata=new s.Metadata,this.progress=new r.Progress(1,0),this.currentLocation=void 0,this.currentNavPointKey=void 0,this.currentRedirectingDocUrl=void 0,this.currentUserChangedProgress=!0}}exports.Context=a;

package/dist/kernal/Context.d.ts

@@ -0,0 +1,48 @@
+import { IEventEmitter } from './IEventEmitter';
+import { Metadata } from './Metadata';
+import { OpenOptions } from './OpenOptions';
+import { Options } from './Options';
+import { FileLocation, LocationFrom, Progress } from './progress/Progress';
+
+export type ContextInit = {
+    simpleId?: string;
+    id?: string;
+    isExternalId?: boolean;
+    metadata?: Metadata;
+    progress?: Progress;
+    currentLocation?: FileLocation;
+    currentNavPointKey?: string;
+    url?: any;
+    extension?: string;
+    openOptions?: OpenOptions;
+    options?: Options;
+    rootContainer?: HTMLElement;
+    readerContainer?: HTMLElement;
+    readerWrapper?: HTMLElement;
+};
+export declare class Context {
+    private readonly events;
+    readonly simpleId: string;
+    id: string;
+    readonly isExternalId?: boolean;
+    metadata: Metadata;
+    progress: Progress;
+    currentLocation?: FileLocation;
+    currentNavPointKey?: string;
+    readonly url: any;
+    readonly extension: string;
+    readonly openOptions: OpenOptions;
+    readonly options: Options;
+    readonly rootContainer: HTMLElement;
+    readonly readerContainer: HTMLElement;
+    readonly readerWrapper: HTMLElement;
+    private currentUserChangedProgress;
+    private currentRedirectingDocUrl;
+    constructor(events: IEventEmitter, init?: ContextInit);
+    get userChangedProgress(): boolean;
+    setUserChangedProgress(value: boolean, from?: LocationFrom): void;
+    getTitle(): string;
+    get redirectingDocUrl(): string;
+    set redirectingDocUrl(url: string);
+    dispose(): Promise<void>;
+}

package/dist/kernal/Context.mjs

@@ -0,0 +1,36 @@
+import { EventNames as i } from "./EventNames.mjs";
+import { Metadata as r } from "./Metadata.mjs";
+import { OpenOptions as o } from "./OpenOptions.mjs";
+import { Options as n } from "./Options.mjs";
+import { Progress as s } from "./progress/Progress.mjs";
+class m {
+  constructor(e, t) {
+    this.events = e, this.metadata = new r(), this.progress = new s(1, 0), this.currentUserChangedProgress = !0, t && Object.assign(this, t), this.openOptions || (this.openOptions = new o()), this.options || (this.options = new n()), this.openOptions.resourceId = this.id, this.openOptions.simpleId = this.simpleId;
+  }
+  /** Whether the user changed reading progress */
+  get userChangedProgress() {
+    return this.currentUserChangedProgress;
+  }
+  setUserChangedProgress(e, t) {
+    e && (this.events.emit(i.UserChangedProgress, t), t != "toc" && (this.currentNavPointKey = void 0)), this.currentUserChangedProgress = e;
+  }
+  getTitle() {
+    let e = this.metadata?.title ?? "";
+    return e || (e = this.metadata?.fileName ?? ""), e;
+  }
+  /**
+   * Document url currently being navigated to.
+   */
+  get redirectingDocUrl() {
+    return this.currentRedirectingDocUrl;
+  }
+  set redirectingDocUrl(e) {
+    this.currentRedirectingDocUrl = e;
+  }
+  async dispose() {
+    this.metadata = new r(), this.progress = new s(1, 0), this.currentLocation = void 0, this.currentNavPointKey = void 0, this.currentRedirectingDocUrl = void 0, this.currentUserChangedProgress = !0;
+  }
+}
+export {
+  m as Context
+};

package/dist/kernal/Debounce.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("perfect-debounce");function v(o,u){let t;return(...n)=>{const e=()=>{clearTimeout(t),o(...n)};t&&clearTimeout(t),t=setTimeout(e,u)}}function b(o,u,t=!1){if(!t){let c=0;const r=(...s)=>{const l=Date.now();l-c>=u&&(c=l,o(...s))};return r.cancel=()=>{},r}let n=0,e,i;const d=()=>{e!==void 0&&(clearTimeout(e),e=void 0),i=void 0},a=(...c)=>{const r=Date.now(),s=r-n,l=u-s;l<=0?(d(),n=r,o(...c)):(i=c,e===void 0&&(e=setTimeout(()=>{if(e=void 0,n=Date.now(),i!==void 0){const f=i;i=void 0,o(...f)}},l)))};return a.cancel=d,a}Object.defineProperty(exports,"asyncDebounce",{enumerable:!0,get:()=>m.debounce});exports.debounce=v;exports.throttle=b;

package/dist/kernal/Debounce.d.ts

@@ -0,0 +1,9 @@
+import { debounce as asyncDebounce } from 'perfect-debounce';
+
+export { asyncDebounce };
+type CallbackFunc<T extends unknown[]> = (...args: T) => void;
+export type ThrottledFunction<T extends unknown[]> = CallbackFunc<T> & {
+    cancel: () => void;
+};
+export declare function debounce<T extends unknown[]>(func: CallbackFunc<T>, wait: number): (...args: T) => void;
+export declare function throttle<T extends unknown[]>(func: CallbackFunc<T>, wait: number, trailing?: boolean): ThrottledFunction<T>;

package/dist/kernal/Debounce.mjs

@@ -0,0 +1,39 @@
+import { debounce as w } from "perfect-debounce";
+function m(o, r) {
+  let t;
+  return (...n) => {
+    const e = () => {
+      clearTimeout(t), o(...n);
+    };
+    t && clearTimeout(t), t = setTimeout(e, r);
+  };
+}
+function v(o, r, t = !1) {
+  if (!t) {
+    let c = 0;
+    const l = (...a) => {
+      const s = Date.now();
+      s - c >= r && (c = s, o(...a));
+    };
+    return l.cancel = () => {
+    }, l;
+  }
+  let n = 0, e, i;
+  const d = () => {
+    e !== void 0 && (clearTimeout(e), e = void 0), i = void 0;
+  }, u = (...c) => {
+    const l = Date.now(), a = l - n, s = r - a;
+    s <= 0 ? (d(), n = l, o(...c)) : (i = c, e === void 0 && (e = setTimeout(() => {
+      if (e = void 0, n = Date.now(), i !== void 0) {
+        const f = i;
+        i = void 0, o(...f);
+      }
+    }, s)));
+  };
+  return u.cancel = d, u;
+}
+export {
+  w as asyncDebounce,
+  m as debounce,
+  v as throttle
+};

package/dist/kernal/EventEmitter.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("events");i.EventEmitter.defaultMaxListeners=0;class r{constructor(){this.externalEvents=new Map,this.internallEvents=new Map,this.events=new i.EventEmitter}on(t,s,e=!0){return t?s?(t=this.formatEventName(t),e?this.internallEvents.has(t)?this.internallEvents.get(t).push(s):this.internallEvents.set(t,[s]):this.externalEvents.has(t)?this.externalEvents.get(t).push(s):this.externalEvents.set(t,[s]),this.events.on(t,s),this):(console.warn("listener is null"),this):(console.warn("eventName is null"),this)}once(t,s){return t?s?(t=this.formatEventName(t),this.events.once(t,s),this):(console.warn("listener is null"),this):(console.warn("eventName is null"),this)}off(t,s){return t?s?(t=this.formatEventName(t),this.removeListener(t,s),this):(console.warn("listener is null"),this):(console.warn("eventName is null"),this)}removeAllListeners(t){return t?(t=this.formatEventName(t),this.events.removeAllListeners(t),this.internallEvents.has(t)&&this.internallEvents.delete(t),this.externalEvents.has(t)&&this.externalEvents.delete(t)):(this.events.removeAllListeners(),this.internallEvents.clear(),this.externalEvents.clear()),this}removeInternalListeners(){return this.internallEvents.forEach((t,s)=>{const e=this.formatEventName(s);this.removeAllListeners(e)}),this.internallEvents.clear(),this}removeExternalListeners(){return this.externalEvents.forEach((t,s)=>{const e=this.formatEventName(s);this.removeAllListeners(e)}),this.externalEvents.clear(),this}removeListener(t,s){if(!t)return console.warn("eventName is null"),this;if(!s)return console.warn("listener is null"),this;if(t=this.formatEventName(t),this.events.removeListener(t,s),this.internallEvents.has(t)){const e=this.internallEvents.get(t),n=e.indexOf(s);n>=0&&e.splice(n,1),e.length==0&&this.internallEvents.delete(t)}if(this.externalEvents.has(t)){const e=this.externalEvents.get(t),n=e.indexOf(s);n>=0&&e.splice(n,1),e.length==0&&this.externalEvents.delete(t)}return this}emit(t,...s){return t?(t=this.formatEventName(t),this.events.emit(t,...s)):(console.warn("eventName is null"),!1)}listenerCount(t){return t?(t=this.formatEventName(t),this.events.listenerCount(t)):(console.warn("eventName is null"),0)}eventNames(){return this.events.eventNames()}formatEventName(t){return typeof t=="string"&&(t=t.toLowerCase()),t}}exports.EventEmitter=r;

package/dist/kernal/EventEmitter.d.ts

@@ -0,0 +1,19 @@
+import { IEventEmitter } from './IEventEmitter';
+
+export declare class EventEmitter implements IEventEmitter {
+    private readonly externalEvents;
+    private readonly internallEvents;
+    private readonly events;
+    constructor();
+    on(eventName: string | symbol, listener: (...args: any[]) => void, isInternal?: boolean): this;
+    once(eventName: string | symbol, listener: (...args: any[]) => void): this;
+    off(eventName: string | symbol, listener: (...args: any[]) => void): this;
+    removeAllListeners(eventName?: string | symbol): this;
+    removeInternalListeners(): this;
+    removeExternalListeners(): this;
+    removeListener(eventName: string | symbol, listener: (...args: any[]) => void): this;
+    emit(eventName: string | symbol, ...args: any[]): boolean;
+    listenerCount(eventName: string | symbol): number;
+    eventNames(): Array<string | symbol>;
+    private formatEventName;
+}