satoru-render 0.0.1

package/dist/workerd.d.ts

@@ -0,0 +1,25 @@
+import { Satoru as BaseSatoru, type RenderOptions } from "./index.js";
+export type { SatoruModule, RequiredResource, ResourceResolver, RenderOptions, } from "./index.js";
+/**
+ * Cloudflare Workers (workerd) specialized wrapper for Satoru.
+ * Handles the specific WASM instantiation requirements for the environment.
+ */
+export declare class Satoru extends BaseSatoru {
+    private constructor();
+    /**
+     * Create Satoru instance for Cloudflare Workers.
+     * @param wasm The compiled WASM module (defaults to the bundled one)
+     */
+    static create(wasm?: WebAssembly.Module): Promise<Satoru>;
+}
+/**
+ * High-level render function for Cloudflare Workers.
+ * Automatically creates and reuses a Satoru instance.
+ */
+export declare function render(options: RenderOptions & {
+    format: "png" | "webp" | "pdf";
+}): Promise<Uint8Array>;
+export declare function render(options: RenderOptions & {
+    format?: "svg";
+}): Promise<string>;
+export declare function render(options: RenderOptions): Promise<string | Uint8Array>;

package/dist/workerd.js

@@ -0,0 +1,43 @@
+// @ts-ignore
+import createSatoruModule from "../dist/satoru.js";
+import { Satoru as BaseSatoru } from "./index.js";
+// @ts-ignore
+import satoruWasm from "../dist/satoru.wasm";
+/**
+ * Cloudflare Workers (workerd) specialized wrapper for Satoru.
+ * Handles the specific WASM instantiation requirements for the environment.
+ */
+export class Satoru extends BaseSatoru {
+    // Use protected constructor from base
+    constructor(factory) {
+        super(factory);
+    }
+    /**
+     * Create Satoru instance for Cloudflare Workers.
+     * @param wasm The compiled WASM module (defaults to the bundled one)
+     */
+    static async create(wasm = satoruWasm) {
+        const factory = async (o) => createSatoruModule({
+            ...o,
+            instantiateWasm: (imports, successCallback) => {
+                // Cloudflare Workers requires using the pre-compiled WebAssembly.Module
+                WebAssembly.instantiate(wasm, imports)
+                    .then((instance) => {
+                    successCallback(instance, wasm);
+                })
+                    .catch((e) => {
+                    console.error("Satoru [workerd]: Wasm instantiation failed:", e);
+                });
+                return {}; // Return empty object as emscripten expects
+            },
+        });
+        return BaseSatoru.create(factory);
+    }
+}
+let instance = null;
+export async function render(options) {
+    if (!instance) {
+        instance = await Satoru.create();
+    }
+    return instance.render(options);
+}

package/dist/workers.d.ts

@@ -0,0 +1,29 @@
+export type { SatoruWorker } from "./child-workers.js";
+import { type RenderOptions } from "./index.js";
+export { Satoru } from "./index.js";
+export * from "./index.js";
+export * from "./log-level.js";
+/**
+ * Create a Satoru worker proxy using worker-lib.
+ * @param params Initialization parameters
+ * @param params.worker Optional: Path to the worker file, a URL, or a factory function.
+ *                      Defaults to the bundled workers.js in the same directory.
+ * @param params.maxParallel Maximum number of parallel workers
+ */
+export declare const createSatoruWorker: (params?: {
+    worker?: string | URL | (() => Worker | string | URL);
+    maxParallel?: number;
+}) => Omit<{
+    execute: <K extends "render">(name: K, ...value: Parameters<{
+        render(options: RenderOptions): Promise<string | Uint8Array<ArrayBufferLike>>;
+    }[K]>) => Promise<Awaited<ReturnType<{
+        render(options: RenderOptions): Promise<string | Uint8Array<ArrayBufferLike>>;
+    }[K]>>>;
+    waitAll: () => Promise<void>;
+    waitReady: (retryTime?: number) => Promise<void>;
+    close: () => void;
+    setLimit: (newLimit: number) => void;
+    launchWorker: () => Promise<void[]>;
+}, "execute"> & {
+    render(options: RenderOptions): Promise<string | Uint8Array<ArrayBufferLike>>;
+};

package/dist/workers.js

@@ -0,0 +1,46 @@
+import { createWorker, Worker } from "worker-lib";
+export { Satoru } from "./index.js";
+export * from "./index.js";
+export * from "./log-level.js";
+/**
+ * Create a Satoru worker proxy using worker-lib.
+ * @param params Initialization parameters
+ * @param params.worker Optional: Path to the worker file, a URL, or a factory function.
+ *                      Defaults to the bundled workers.js in the same directory.
+ * @param params.maxParallel Maximum number of parallel workers
+ */
+export const createSatoruWorker = (params) => {
+    const { worker, maxParallel = 4 } = params ?? {};
+    const factory = () => {
+        let w;
+        if (worker) {
+            w = typeof worker === "function" ? worker() : worker;
+        }
+        else {
+            const workerUrl = typeof window !== "undefined"
+                ? new URL("./web-workers.js", import.meta.url)
+                : new URL("./child-workers.js", import.meta.url);
+            if (typeof Worker !== "undefined") {
+                w = new Worker(workerUrl, { type: "module" });
+            }
+        }
+        if (!w)
+            throw new Error("Worker is not supported in this environment.");
+        return w;
+    };
+    const workerInstance = createWorker(factory, maxParallel);
+    const proxy = new Proxy(workerInstance, {
+        get(target, prop, receiver) {
+            if (prop === "render") {
+                return async (options) => {
+                    return await target.execute("render", options);
+                };
+            }
+            if (prop in target) {
+                return Reflect.get(target, prop, receiver);
+            }
+            return (...args) => target.execute(prop, ...args);
+        },
+    });
+    return proxy;
+};

package/package.json

@@ -0,0 +1,122 @@
+{
+  "name": "satoru-render",
+  "version": "0.0.1",
+  "description": "High-fidelity HTML/CSS to SVG/PNG/PDF converter running in WebAssembly",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "satoru-render": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc -b && rolldown -c rolldown.config.js"
+  },
+  "exports": {
+    ".": {
+      "workerd": {
+        "types": "./dist/workerd.d.ts",
+        "import": "./dist/workerd.js"
+      },
+      "deno": {
+        "types": "./dist/single.d.ts",
+        "import": "./dist/single.js"
+      },
+      "single": {
+        "types": "./dist/single.d.ts",
+        "import": "./dist/single.js"
+      },
+      "types": "./dist/single.d.ts",
+      "import": "./dist/single.js",
+      "default": "./dist/single.js"
+    },
+    "./index": {
+      "types": "./dist/index.d.ts",
+      "node": "./dist/node.js",
+      "default": "./dist/index.js"
+    },
+    "./workerd": {
+      "types": "./dist/workerd.d.ts",
+      "import": "./dist/workerd.js"
+    },
+    "./workers": {
+      "types": "./dist/workers.d.ts",
+      "import": "./dist/workers.js"
+    },
+    "./single": {
+      "types": "./dist/single.d.ts",
+      "import": "./dist/single.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    },
+    "./satoru.js": "./dist/satoru.js",
+    "./satoru.wasm": "./dist/satoru.wasm"
+  },
+  "typesVersions": {
+    "*": {
+      "workerd": [
+        "./dist/workerd.d.ts"
+      ],
+      "single": [
+        "./dist/single.d.ts"
+      ],
+      "react": [
+        "./dist/react.d.ts"
+      ],
+      "*": [
+        "./dist/single.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SoraKumo001/satoru.git",
+    "directory": "packages/satoru"
+  },
+  "author": "SoraKumo <info@croud.jp>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/SoraKumo001/satoru/issues"
+  },
+  "homepage": "https://github.com/SoraKumo001/satoru/tree/master/packages/satoru#readme",
+  "keywords": [
+    "html",
+    "css",
+    "svg",
+    "png",
+    "pdf",
+    "wasm",
+    "skia",
+    "litehtml",
+    "webassembly",
+    "cloudflare-workers"
+  ],
+  "devDependencies": {
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "rolldown": "1.0.0-rc.5",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "worker-lib": "2.2.0"
+  },
+  "peerDependencies": {
+    "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
+    "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  }
+}