@likecoin/epub-ts 0.4.5 → 0.4.6

package/README.md

@@ -49,6 +49,30 @@ fileInput.addEventListener("change", async (event) => {
 });
 ```
 
+### Node.js (parsing only)
+
+Parse EPUB metadata, spine, navigation, and section content without a browser. Requires [`linkedom`](https://github.com/WebReflection/linkedom) as a peer dependency.
+
+```bash
+npm install linkedom
+```
+
+```typescript
+import { Book } from "@likecoin/epub-ts/node";
+import { readFileSync } from "node:fs";
+
+const data = readFileSync("book.epub");
+const arrayBuffer = data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+const book = new Book(arrayBuffer);
+await book.opened;
+
+console.log(book.packaging.metadata.title);
+console.log(book.navigation.toc.map(item => item.label));
+
+const section = book.spine.first();
+const html = await section.render(book.archive.request.bind(book.archive));
+```
+
 ## Migration from epubjs
 
 Drop-in replacement. Change your import:
@@ -102,12 +126,11 @@ Key classes:
 
 ## Supported Environments
 
-| Environment | Notes |
-|-------------|-------|
-| Modern browsers | Chrome, Firefox, Safari, Edge (requires DOM) |
-| Vite / webpack | ESM or CJS imports |
-
-> **Note**: This library requires a DOM environment. Node.js support (parsing-only, no rendering) is planned but not yet available.
+| Environment | Import | Notes |
+|-------------|--------|-------|
+| Modern browsers | `@likecoin/epub-ts` | Chrome, Firefox, Safari, Edge |
+| Vite / webpack | `@likecoin/epub-ts` | ESM or CJS |
+| Node.js 18+ | `@likecoin/epub-ts/node` | Parsing only (no rendering); requires `linkedom` peer dep |
 
 ## What's Changed from epubjs
 
@@ -118,6 +141,7 @@ Key classes:
 - Replaced `event-emitter` with inline typed emitter
 - Replaced `localforage` with native IndexedDB wrapper
 - Replaced `@xmldom/xmldom` with native DOMParser/XMLSerializer
+- Added Node.js parsing-only entry point (`@likecoin/epub-ts/node`) with `linkedom`
 - Dropped IE8–IE11 support
 
 ## Development

package/dist/annotations.d.ts

@@ -114,7 +114,11 @@ declare class Annotations {
  * @param {object} styles CSS styles to assign to annotation
  * @returns {Annotation} annotation
  */
-declare class Annotation implements IEventEmitter {
+export interface AnnotationEvents extends Record<string, any[]> {
+    "attach": [object | null | undefined];
+    "detach": [];
+}
+declare class Annotation implements IEventEmitter<AnnotationEvents> {
     type: string;
     cfiRange: string;
     data: Record<string, any>;
@@ -123,9 +127,9 @@ declare class Annotation implements IEventEmitter {
     cb: EventListener;
     className: string;
     styles: Record<string, string>;
-    on: IEventEmitter["on"];
-    off: IEventEmitter["off"];
-    emit: IEventEmitter["emit"];
+    on: IEventEmitter<AnnotationEvents>["on"];
+    off: IEventEmitter<AnnotationEvents>["off"];
+    emit: IEventEmitter<AnnotationEvents>["emit"];
     constructor({ type, cfiRange, data, sectionIndex, cb, className, styles }: {
         type: string;
         cfiRange: string;

package/dist/book.d.ts

@@ -35,6 +35,9 @@ interface BookLoadedState {
     resources: Promise<Resources>;
     displayOptions: Promise<DisplayOptions>;
 }
+export interface BookEvents extends Record<string, any[]> {
+    "openFailed": [Error];
+}
 /**
  * An Epub representation with methods for the loading, parsing and manipulation
  * of its contents.
@@ -53,7 +56,7 @@ interface BookLoadedState {
  * @example new Book("/path/to/book.epub", {})
  * @example new Book({ replacements: "blobUrl" })
  */
-declare class Book implements IEventEmitter {
+declare class Book implements IEventEmitter<BookEvents> {
     settings: BookOptions;
     opening: defer<Book>;
     opened: Promise<Book>;
@@ -65,23 +68,23 @@ declare class Book implements IEventEmitter {
     request: RequestFunction;
     spine: Spine;
     locations: Locations;
-    navigation: Navigation | undefined;
-    pageList: PageList | undefined;
-    url: Url | undefined;
+    navigation: Navigation;
+    pageList: PageList;
+    url: Url;
     path: Path | undefined;
     archived: boolean;
     archive: Archive | undefined;
     storage: Store | undefined;
-    resources: Resources | undefined;
+    resources: Resources;
     rendition: Rendition | undefined;
     container: Container | undefined;
-    packaging: Packaging | undefined;
+    packaging: Packaging;
     displayOptions: DisplayOptions | undefined;
     package: Packaging | undefined;
     cover: string;
-    on: IEventEmitter["on"];
-    off: IEventEmitter["off"];
-    emit: IEventEmitter["emit"];
+    on: IEventEmitter<BookEvents>["on"];
+    off: IEventEmitter<BookEvents>["off"];
+    emit: IEventEmitter<BookEvents>["emit"];
     constructor(url?: string | ArrayBuffer | Blob | BookOptions, options?: BookOptions);
     /**
      * Open a epub or url

package/dist/contents.d.ts

@@ -10,11 +10,22 @@ import { default as Section } from './section';
     * @param {string} cfiBase Section component of CFIs
     * @param {number} sectionIndex Index in Spine of Conntent's Section
     */
-declare class Contents implements IEventEmitter {
-    on: (type: string, fn: (...args: any[]) => void) => this;
-    off: (type: string, fn?: (...args: any[]) => void) => this;
-    emit: (type: string, ...args: unknown[]) => void;
-    __listeners: IEventEmitter["__listeners"];
+export interface ContentsEvents {
+    "expand": [];
+    "resize": [{
+        width: number;
+        height: number;
+    }];
+    "selected": [string];
+    "selectedRange": [Range];
+    "linkClicked": [string];
+    [event: string]: any[];
+}
+declare class Contents implements IEventEmitter<ContentsEvents> {
+    on: IEventEmitter<ContentsEvents>["on"];
+    off: IEventEmitter<ContentsEvents>["off"];
+    emit: IEventEmitter<ContentsEvents>["emit"];
+    __listeners: IEventEmitter<ContentsEvents>["__listeners"];
     epubcfi: EpubCFI;
     document: Document;
     documentElement: HTMLElement;