epub-gen3 0.1.0 → 0.2.1

package/browser.js

@@ -0,0 +1,14 @@
+/**
+ * Browser entry-point for epub-gen3.
+ *
+ * Re-exports the WASM Epub class and a ready promise that resolves once the
+ * WASM module is initialised. Import this instead of the raw wasm glue:
+ *
+ *   import { Epub, ready } from 'epub-gen3/browser'
+ *   await ready
+ *   const epub = new Epub(info, chapters)
+ */
+import init, { Epub } from './wasm/epub_gen_wasm.js'
+
+export { Epub }
+export const ready = init()

package/index.d.ts

@@ -17,6 +17,32 @@ export interface EpubInfo {
   css?: string
   /** EPUB spec version (use `3`). */
   version: number
+  /** Raw XML written to `META-INF/encryption.xml`. Pass `null` to omit. */
+  encryption?: string
+  /** Raw XML written to `META-INF/metadata.xml`. Pass `null` to omit. */
+  metadataXml?: string
+  /** Raw XML written to `META-INF/manifest.xml`. Pass `null` to omit. */
+  manifestXml?: string
+}
+/**
+ * An image embedded in the EPUB.
+ *
+ * Images are written to `OEBPS/images/<path>` and can be referenced from
+ * chapter paragraphs with raw markup, e.g.
+ * `<img src="images/diagram.png" alt="Diagram" />`.
+ */
+export interface EpubImage {
+  /** Unique manifest id (letters, digits, `-`, `_`). */
+  id: string
+  /**
+   * File name written under `OEBPS/images/`, e.g. `cover.png`.
+   * The extension determines the media-type.
+   */
+  path: string
+  /** Raw image bytes. */
+  data: Buffer
+  /** When `true`, this image is the book cover (at most one). */
+  cover: boolean
 }
 /**
  * EPUB builder.
@@ -28,11 +54,19 @@ export interface EpubInfo {
  * const epub = new Epub(info, [
  *   ['Chapter One', 'First paragraph.', 'Second paragraph.'],
  * ]);
+ * epub.setImages([
+ *   { id: 'cover-img', path: 'cover.png', data: coverBytes, cover: true },
+ * ]);
  * ```
  */
 export declare class Epub {
   /** Create a new EPUB builder. */
   constructor(info: EpubInfo, chapters: Array<Array<string>>)
+  /**
+   * Attach images to the EPUB. Pass an array of `EpubImage` objects.
+   * Flag exactly one with `cover: true` to set the book cover.
+   */
+  setImages(images: Array<EpubImage>): void
   /** Build the EPUB and write it to `<title>.epub` in the current working directory. */
   run(): void
   /**

package/index.mjs

@@ -0,0 +1,4 @@
+import { createRequire } from 'module'
+const require = createRequire(import.meta.url)
+const { Epub } = require('./index.js')
+export { Epub }

package/package.json

@@ -1,9 +1,19 @@
 {
   "name": "epub-gen3",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Generate EPUB files from Rust — Node.js native addon",
   "main": "index.js",
+  "browser": "./browser.js",
   "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "browser": "./browser.js",
+      "import": "./index.mjs",
+      "require": "./index.js"
+    },
+    "./browser": "./browser.js",
+    "./wasm/*": "./wasm/*"
+  },
   "napi": {
     "name": "epub-gen3",
     "triples": {
@@ -18,15 +28,20 @@
   "scripts": {
     "build": "napi build --platform --release",
     "build:debug": "napi build --platform",
-    "prepublish": "napi build --platform --release"
+    "build:wasm": "wasm-pack build ../wasm --target web --out-dir ../node/wasm",
+    "build:all": "napi build --platform --release && npm run build:wasm"
   },
   "devDependencies": {
-    "@napi-rs/cli": "^2.18.0"
+    "@napi-rs/cli": "^2.18.0",
+    "wasm-pack": "^0.13.1"
   },
   "files": [
     "index.js",
+    "index.mjs",
+    "browser.js",
     "index.d.ts",
-    "*.node"
+    "*.node",
+    "wasm/"
   ],
   "license": "MIT"
 }