bookcover-web 0.1.0

package/README.md

@@ -0,0 +1,92 @@
+
+# bookcover-web
+
+Generate print-ready book covers. Part of the [bookcover](https://github.com/gracious-tech/bookcover) generation system.
+
+```
+npm install bookcover-web
+```
+
+[![Example cover](../sample.svg)](../sample.pdf "View example PDF")
+
+This is a browser wrapper for the book cover generator. It compiles covers via WASM using
+[typst.ts](https://github.com/Myriad-Dreamin/typst.ts).
+
+## See the [schema reference](https://github.com/gracious-tech/bookcover/blob/main/generator/README.md) which is passed as an argument and is what actually configures the cover design.
+
+```ts
+import {init, CoverGenerator} from 'bookcover-web'
+```
+
+## `init(options): Promise<CoverGenerator>`
+
+Create a generator instance with an initialised WASM compiler and optional renderer.
+
+```ts
+interface InitOptions {
+    wasm_url: string              // URL to typst_ts_web_compiler_bg.wasm
+    renderer_wasm_url?: string    // URL to typst_ts_renderer_bg.wasm (required for SVG/PNG)
+    assets_prefix?: string        // URL prefix for generator assets (fonts, templates, frames)
+}
+```
+
+**`wasm_url` / `renderer_wasm_url`** — serve the `.wasm` files from your origin. With Vite, import them directly:
+
+```ts
+import wasm_url from '@myriaddreamin/typst-ts-web-compiler/pkg/typst_ts_web_compiler_bg.wasm?url'
+import renderer_wasm_url from '@myriaddreamin/typst-ts-renderer/pkg/typst_ts_renderer_bg.wasm?url'
+```
+
+Without a bundler, copy the files from `node_modules` into your `public/` dir and reference by path.
+
+**`assets_prefix`** — points to the `generator/assets/` directory (fonts, Typst templates, frame images). The easiest setup is a symlink from your `public/` dir:
+
+```bash
+ln -s ../node_modules/bookcover-core/assets public/generator_assets
+```
+
+Then pass `assets_prefix: '/generator_assets/'`. With Vite the symlink is served automatically at dev time and included in the production build.
+
+
+## `CoverGenerator.generate(options): Promise<GenerateResult>`
+
+```ts
+interface GenerateOptions {
+    schema: unknown               // raw schema (see above)
+    image?: Blob                  // background image
+    format?: 'pdf'|'svg'|'png'   // default: 'pdf'
+    ppi?: number                  // PNG resolution, default: 144
+    split?: boolean               // include split panels in result
+    custom_fonts?: Uint8Array[]   // raw TTF bytes for custom fonts
+}
+
+interface GenerateResult {
+    data: Uint8Array | string     // full cover (bytes for PDF/PNG, string for SVG)
+    split?: SplitResult<Uint8Array> | SplitResult<string>
+}
+```
+
+## `CoverGenerator.destroy()`
+
+Revoke blob URLs to free memory. Call when the instance is no longer needed.
+
+### Example
+
+```ts
+import {init} from 'bookcover-web'
+
+const generator = await init({
+    wasm_url: '/typst_ts_web_compiler_bg.wasm',
+    renderer_wasm_url: '/typst_ts_renderer_bg.wasm',
+    assets_prefix: '/generator_assets/',
+})
+
+const result = await generator.generate({
+    schema: {title1: 'My Book', author: 'Jane Doe', /* ... */},
+    format: 'svg',
+    split: true,
+})
+
+// result.data is the full SVG string
+// result.split.front / .back / .spine are individual panel SVGs
+```

package/dist/index.d.ts

@@ -0,0 +1,77 @@
+import type { TypstRenderer } from '@myriaddreamin/typst.ts/renderer';
+import type { OutputFormat, SplitResult } from 'bookcover-core';
+export type { CoverSchema, TitlePosition, FontConfig, OutputFormat, SplitResult, PatternDef } from 'bookcover-core';
+export type { BundledFont, CjkVariant } from 'typst-fonts';
+export { font_file_url } from 'typst-fonts/web';
+export { get_fonts, get_bundled_font } from 'typst-fonts';
+export { list_patterns, collect_fonts, collect_all_fonts, default_spine_title } from 'bookcover-core';
+export interface InitOptions {
+    wasm_url: string;
+    renderer_wasm_url?: string;
+    assets_prefix?: string;
+    fonts_prefix?: string;
+}
+export interface GenerateOptions {
+    schema: unknown;
+    image?: Blob;
+    format?: OutputFormat;
+    ppi?: number;
+    split?: boolean;
+    custom_fonts?: Uint8Array[];
+}
+export interface GenerateResult {
+    data: Uint8Array | string;
+    split?: SplitResult<Uint8Array> | SplitResult<string>;
+}
+/** Stateful cover generator — each instance owns its own compiler and renderer */
+export declare class CoverGenerator {
+    private opts;
+    private compiler;
+    private renderer;
+    private active_fonts;
+    private font_bytes;
+    private font_blob_urls;
+    private custom_font_ids;
+    private next_custom_font_id;
+    constructor(opts: InitOptions, renderer: TypstRenderer | null);
+    /** Build fetch URLs for the given font families against fonts_prefix — curated families
+     *  live at <prefix>/<family>/, Noto fallback families at <prefix>/_noto/<family>/,
+     *  mirroring the top-level fonts/ directory's own layout exactly */
+    private font_urls_for;
+    /** Fetch a font file's bytes, memoised in font_bytes (failures aren't cached, so a
+     *  later generate retries the fetch) */
+    private fetch_font;
+    /** Pre-fetch the given font families into the in-memory byte cache */
+    prefetch_fonts(families: string[]): Promise<void>;
+    /** Stable id for a custom font's byte array. The widget passes the same Uint8Array
+     *  references across generates, so object identity distinguishes fonts without hashing
+     *  their bytes (byteLength alone could collide between two different fonts). */
+    private custom_font_id;
+    /** (Re)initialise the compiler with a different font set. Bundled font bytes come from
+     *  the in-memory cache (fetched at most once per session) and everything is handed to
+     *  loadFonts() as blob URLs, keeping the network out of the reinit path. The renderer
+     *  never needs reinitialisation because it reads glyph outlines from compiled vector
+     *  data. */
+    private reinit_compiler;
+    /** Load the typst file map into the compiler's shadow filesystem */
+    private load_files;
+    /** Compile to PDF and return raw bytes */
+    private compile_pdf;
+    /** Compile to vector format, then render as SVG string covering the full canvas */
+    private compile_svg;
+    /** Compile to vector format, then render as PNG via offscreen canvas */
+    private compile_png;
+    /** Throw if the renderer was not initialised */
+    private assert_renderer;
+    /** Generate a book cover using this instance's compiler and renderer */
+    generate(options: GenerateOptions): Promise<GenerateResult>;
+    /** Revoke blob URLs and drop cached font bytes to free memory */
+    destroy(): void;
+}
+/**
+ * Create a CoverGenerator instance with an optional initialised WASM renderer.
+ * The compiler itself is created lazily by the first generate() call, once the schema's
+ * font set is known. Each instance is independent — multiple generators can run concurrently.
+ */
+export declare function init(options: InitOptions): Promise<CoverGenerator>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,kCAAkC,CAAA;AAInE,OAAO,KAAK,EAAC,YAAY,EAAE,WAAW,EAAY,MAAM,gBAAgB,CAAA;AAKxE,YAAY,EAAC,WAAW,EAAE,aAAa,EAAE,UAAU,EAC/C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAC,MAAM,gBAAgB,CAAA;AAChE,YAAY,EAAC,WAAW,EAAE,UAAU,EAAC,MAAM,aAAa,CAAA;AACxD,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAC,SAAS,EAAE,gBAAgB,EAAC,MAAM,aAAa,CAAA;AACvD,OAAO,EAAC,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,mBAAmB,EAAC,MAAM,gBAAgB,CAAA;AAInG,MAAM,WAAW,WAAW;IAExB,QAAQ,EAAC,MAAM,CAAA;IAEf,iBAAiB,CAAC,EAAC,MAAM,CAAA;IAGzB,aAAa,CAAC,EAAC,MAAM,CAAA;IAKrB,YAAY,CAAC,EAAC,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAC,OAAO,CAAA;IAEd,KAAK,CAAC,EAAC,IAAI,CAAA;IAEX,MAAM,CAAC,EAAC,YAAY,CAAA;IAEpB,GAAG,CAAC,EAAC,MAAM,CAAA;IAEX,KAAK,CAAC,EAAC,OAAO,CAAA;IAEd,YAAY,CAAC,EAAC,UAAU,EAAE,CAAA;CAC7B;AAED,MAAM,WAAW,cAAc;IAE3B,IAAI,EAAC,UAAU,GAAG,MAAM,CAAA;IAExB,KAAK,CAAC,EAAC,WAAW,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;CACvD;AAmDD,kFAAkF;AAClF,qBAAa,cAAc;IACvB,OAAO,CAAC,IAAI,CAAY;IAGxB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,QAAQ,CAAqB;IAGrC,OAAO,CAAC,YAAY,CAAK;IAGzB,OAAO,CAAC,UAAU,CAAgC;IAElD,OAAO,CAAC,cAAc,CAAc;IAEpC,OAAO,CAAC,eAAe,CAAoC;IAC3D,OAAO,CAAC,mBAAmB,CAAI;gBAEnB,IAAI,EAAC,WAAW,EAAE,QAAQ,EAAC,aAAa,GAAG,IAAI;IAK3D;;wEAEoE;IACpE,OAAO,CAAC,aAAa;IAIrB;4CACwC;YAC1B,UAAU;IAUxB,sEAAsE;IAChE,cAAc,CAAC,QAAQ,EAAC,MAAM,EAAE,GAAE,OAAO,CAAC,IAAI,CAAC;IAIrD;;oFAEgF;IAChF,OAAO,CAAC,cAAc;IAUtB;;;;gBAIY;YACE,eAAe;IAwB7B,oEAAoE;IACpE,OAAO,CAAC,UAAU;IAalB,0CAA0C;YAC5B,WAAW;IAWzB,mFAAmF;YACrE,WAAW;IA0BzB,wEAAwE;YAC1D,WAAW;IA8BzB,gDAAgD;IAChD,OAAO,CAAC,eAAe;IAQvB,wEAAwE;IAClE,QAAQ,CAAC,OAAO,EAAC,eAAe,GAAE,OAAO,CAAC,cAAc,CAAC;IAkF/D,iEAAiE;IACjE,OAAO,IAAG,IAAI;CAKjB;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAC,WAAW,GAAE,OAAO,CAAC,cAAc,CAAC,CAuBtE"}

package/dist/index.js

@@ -0,0 +1,309 @@
+// Browser cover generator — compiles typst files via WebAssembly, supports PDF/SVG/PNG output
+import { createTypstCompiler, CompileFormatEnum } from '@myriaddreamin/typst.ts/compiler';
+import { createTypstRenderer } from '@myriaddreamin/typst.ts/renderer';
+import { loadFonts } from '@myriaddreamin/typst.ts';
+import { build, cover_schema, split_svg, split_png, split_pdf, frame_image, frame_asset_path, asset_path, TYPST_DIR, TEMPLATE_FILES, collect_all_fonts } from 'bookcover-core';
+import { base_font } from 'typst-fonts';
+import { load_fonts_prefix, font_urls_for as build_font_urls, fetch_font_bytes, fonts_to_blob_urls, revoke_blob_urls } from 'typst-fonts/web';
+export { font_file_url } from 'typst-fonts/web';
+export { get_fonts, get_bundled_font } from 'typst-fonts';
+export { list_patterns, collect_fonts, collect_all_fonts, default_spine_title } from 'bookcover-core';
+const decoder = new TextDecoder();
+/** Format compilation diagnostics into a readable error */
+function throw_compile_error(diagnostics) {
+    const diag = Array.isArray(diagnostics)
+        ? diagnostics.map((d) => (typeof d === 'string' ? d : JSON.stringify(d))).join('\n')
+        : 'unknown error';
+    throw new Error(`[generator-web] Typst compilation failed:\n${diag}`);
+}
+/** Create a 2D canvas — a DOM element on the main thread, OffscreenCanvas inside a worker */
+function make_canvas(width, height) {
+    if (typeof document === 'undefined') {
+        return new OffscreenCanvas(width, height);
+    }
+    const canvas = document.createElement('canvas');
+    canvas.width = width;
+    canvas.height = height;
+    return canvas;
+}
+/** Encode a canvas' contents as PNG bytes (handles both canvas types) */
+async function canvas_png_bytes(canvas) {
+    const blob = 'convertToBlob' in canvas
+        ? await canvas.convertToBlob({ type: 'image/png' })
+        : await new Promise((resolve) => {
+            canvas.toBlob((b) => resolve(b), 'image/png');
+        });
+    return new Uint8Array(await blob.arrayBuffer());
+}
+/** Crop a region from a PNG using the Canvas API — used as PngCropFn */
+async function canvas_crop(data, x, y, w, h) {
+    const blob = new Blob([data], { type: 'image/png' });
+    const bitmap = await createImageBitmap(blob);
+    const canvas = make_canvas(w, h);
+    const ctx = canvas.getContext('2d');
+    ctx.drawImage(bitmap, x, y, w, h, 0, 0, w, h);
+    bitmap.close();
+    return canvas_png_bytes(canvas);
+}
+/** Stateful cover generator — each instance owns its own compiler and renderer */
+export class CoverGenerator {
+    opts;
+    // Created lazily on first generate() — the font set isn't known until a schema arrives,
+    // so creating one earlier would just instantiate WASM with fonts that get replaced
+    compiler;
+    renderer;
+    // Cache key of the font set the current compiler was init'd with ('' = no compiler yet)
+    active_fonts = '';
+    // Fetched font bytes keyed by URL, so a compiler reinit (any font-set change) never
+    // refetches families already seen this session
+    font_bytes = new Map();
+    // Blob URLs handed to the current compiler (bundled + custom) — revoked on reinit
+    font_blob_urls = [];
+    // Identity-based ids for custom font byte arrays (see custom_font_id)
+    custom_font_ids = new WeakMap();
+    next_custom_font_id = 1;
+    constructor(opts, renderer) {
+        this.opts = opts;
+        this.renderer = renderer;
+    }
+    /** Build fetch URLs for the given font families against fonts_prefix — curated families
+     *  live at <prefix>/<family>/, Noto fallback families at <prefix>/_noto/<family>/,
+     *  mirroring the top-level fonts/ directory's own layout exactly */
+    font_urls_for(families) {
+        return build_font_urls(this.opts.fonts_prefix ?? '/fonts/', families);
+    }
+    /** Fetch a font file's bytes, memoised in font_bytes (failures aren't cached, so a
+     *  later generate retries the fetch) */
+    async fetch_font(url) {
+        const cached = this.font_bytes.get(url);
+        if (cached) {
+            return cached;
+        }
+        const bytes = await fetch_font_bytes(url);
+        this.font_bytes.set(url, bytes);
+        return bytes;
+    }
+    /** Pre-fetch the given font families into the in-memory byte cache */
+    async prefetch_fonts(families) {
+        await Promise.all(this.font_urls_for(families).map(url => this.fetch_font(url)));
+    }
+    /** Stable id for a custom font's byte array. The widget passes the same Uint8Array
+     *  references across generates, so object identity distinguishes fonts without hashing
+     *  their bytes (byteLength alone could collide between two different fonts). */
+    custom_font_id(data) {
+        let id = this.custom_font_ids.get(data);
+        if (id === undefined) {
+            id = this.next_custom_font_id;
+            this.next_custom_font_id += 1;
+            this.custom_font_ids.set(data, id);
+        }
+        return id;
+    }
+    /** (Re)initialise the compiler with a different font set. Bundled font bytes come from
+     *  the in-memory cache (fetched at most once per session) and everything is handed to
+     *  loadFonts() as blob URLs, keeping the network out of the reinit path. The renderer
+     *  never needs reinitialisation because it reads glyph outlines from compiled vector
+     *  data. */
+    async reinit_compiler(font_urls, custom_fonts) {
+        // Fetch any fonts not yet cached, in parallel
+        const bundled_bytes = await Promise.all(font_urls.map(url => this.fetch_font(url)));
+        // Revoke the previous compiler's blob URLs to avoid memory leaks
+        revoke_blob_urls(this.font_blob_urls);
+        // One blob URL per font file (bundled + custom) for loadFonts() to read —
+        // mapShadow only adds to the virtual filesystem, not the font book
+        this.font_blob_urls = fonts_to_blob_urls([...bundled_bytes, ...(custom_fonts ?? [])]);
+        // assets:false stops typst.ts silently appending its default text fonts (NewCM,
+        // Libertinus, DejaVu... fetched from jsdelivr) — all fonts we need are passed explicitly
+        const compiler_font_opts = loadFonts(this.font_blob_urls, { assets: false });
+        const c = createTypstCompiler();
+        await c.init({
+            getModule: () => ({ module_or_path: this.opts.wasm_url }),
+            beforeBuild: [compiler_font_opts],
+        });
+        this.compiler = c;
+    }
+    /** Load the typst file map into the compiler's shadow filesystem */
+    load_files(files) {
+        this.compiler.resetShadow();
+        for (const [filename, bytes] of files) {
+            const vpath = `/${filename}`;
+            if (filename.endsWith('.typ')) {
+                this.compiler.addSource(vpath, decoder.decode(bytes));
+            }
+            else {
+                this.compiler.mapShadow(vpath, bytes);
+            }
+        }
+    }
+    /** Compile to PDF and return raw bytes */
+    async compile_pdf() {
+        const result = await this.compiler.compile({
+            mainFilePath: '/cover.typ',
+            format: CompileFormatEnum.pdf,
+        });
+        if (!result.result) {
+            throw_compile_error(result.diagnostics);
+        }
+        return result.result;
+    }
+    /** Compile to vector format, then render as SVG string covering the full canvas */
+    async compile_svg() {
+        this.assert_renderer('SVG');
+        const result = await this.compiler.compile({
+            mainFilePath: '/cover.typ',
+            format: CompileFormatEnum.vector,
+        });
+        if (!result.result) {
+            throw_compile_error(result.diagnostics);
+        }
+        const svg = await this.renderer.renderSvg({
+            artifactContent: result.result,
+            format: 'vector',
+            data_selection: { js: false, css: true, body: true, defs: true },
+        });
+        // Patch unitless width/height to add `pt` suffix (Typst SVG output uses pt) so
+        // browsers render at 96 CSS px per inch, matching the split SVGs from split_svg()
+        return svg.replace(/<svg([^>]*)>/, (_match, attrs) => {
+            const patched = attrs
+                .replace(/width="([\d.]+)"/, 'width="$1pt"')
+                .replace(/height="([\d.]+)"/, 'height="$1pt"');
+            return `<svg${patched}>`;
+        });
+    }
+    /** Compile to vector format, then render as PNG via offscreen canvas */
+    async compile_png(ppi) {
+        this.assert_renderer('PNG');
+        const result = await this.compiler.compile({
+            mainFilePath: '/cover.typ',
+            format: CompileFormatEnum.vector,
+        });
+        if (!result.result) {
+            throw_compile_error(result.diagnostics);
+        }
+        // Render to a canvas at the desired PPI (typst uses 72pt/inch)
+        const scale = ppi / 72;
+        const canvas = document.createElement('canvas');
+        await this.renderer.renderCanvas({
+            artifactContent: result.result,
+            format: 'vector',
+            canvas,
+            pageOffset: 0,
+            pixelPerPt: scale,
+            backgroundColor: '#ffffff',
+        });
+        // Extract PNG from canvas
+        const blob = await new Promise((resolve) => {
+            canvas.toBlob((b) => resolve(b), 'image/png');
+        });
+        return new Uint8Array(await blob.arrayBuffer());
+    }
+    /** Throw if the renderer was not initialised */
+    assert_renderer(format) {
+        if (!this.renderer) {
+            throw new Error(`[generator-web] ${format} output requires renderer_wasm_url in init() options`);
+        }
+    }
+    /** Generate a book cover using this instance's compiler and renderer */
+    async generate(options) {
+        const format = options.format ?? 'pdf';
+        // Default to 144 PPI (2x typographic resolution, 2 × 72pt/in)
+        const ppi = options.ppi ?? 144;
+        const split = options.split ?? false;
+        // Parse schema and get dimensions from printing-services
+        const parsed = cover_schema.parse(options.schema);
+        const assets = this.opts.assets_prefix ?? '/assets/';
+        // (Re)initialise the compiler when the set of required fonts changes — including on
+        // the very first generate, since the compiler is created lazily ('' never matches).
+        // Noto Serif (base font) is always included — it's not bundled in the WASM assets.
+        // collect_all_fonts also includes every Noto fallback family needed to cover non-Latin
+        // scripts detected in the schema's text, so only those specific families get fetched.
+        const needed_fonts = collect_all_fonts(parsed);
+        const custom_fonts_id = options.custom_fonts
+            ? options.custom_fonts.map(b => String(this.custom_font_id(b))).join(':')
+            : '';
+        const cache_key = needed_fonts.join(',') + '|' + custom_fonts_id;
+        if (cache_key !== this.active_fonts) {
+            await this.reinit_compiler(this.font_urls_for(needed_fonts), options.custom_fonts);
+            this.active_fonts = cache_key;
+        }
+        // Convert Blob to ImageInput (Uint8Array + extension) for the core builder
+        let image_input;
+        if (options.image) {
+            const blob = options.image;
+            const ext = '.' + (blob.type.split('/')[1] ?? 'jpg').replace('jpeg', 'jpg');
+            image_input = { data: new Uint8Array(await blob.arrayBuffer()), ext };
+        }
+        // Load typst templates from assets
+        const [cover_typ, helpers_typ] = await Promise.all([
+            fetch(asset_path(assets, TYPST_DIR, TEMPLATE_FILES.cover)).then(r => r.text()),
+            fetch(asset_path(assets, TYPST_DIR, TEMPLATE_FILES.helpers)).then(r => r.text()),
+        ]);
+        const templates = { cover: cover_typ, helpers: helpers_typ };
+        // Load the frame PNG from assets when the schema uses painted coverage
+        let frame_blob;
+        if (parsed.bg_image_coverage === 'painted') {
+            const url = frame_asset_path(assets, 'painted');
+            const resp = await fetch(url);
+            frame_blob = await resp.blob();
+        }
+        const { files, dims } = await build(templates, parsed, image_input, frame_image, frame_blob);
+        this.load_files(files);
+        // Compile to the requested format
+        let data;
+        if (format === 'pdf') {
+            data = await this.compile_pdf();
+        }
+        else if (format === 'svg') {
+            data = await this.compile_svg();
+        }
+        else {
+            data = await this.compile_png(ppi);
+        }
+        const result = { data };
+        // Split into front/back/spine panels
+        if (split) {
+            if (format === 'pdf') {
+                result.split = split_pdf(data, dims);
+            }
+            else if (format === 'svg') {
+                result.split = split_svg(data, dims);
+            }
+            else {
+                result.split = await split_png(data, dims, ppi, canvas_crop);
+            }
+        }
+        return result;
+    }
+    /** Revoke blob URLs and drop cached font bytes to free memory */
+    destroy() {
+        revoke_blob_urls(this.font_blob_urls);
+        this.font_blob_urls = [];
+        this.font_bytes.clear();
+    }
+}
+/**
+ * Create a CoverGenerator instance with an optional initialised WASM renderer.
+ * The compiler itself is created lazily by the first generate() call, once the schema's
+ * font set is known. Each instance is independent — multiple generators can run concurrently.
+ */
+export async function init(options) {
+    // Load the curated font manifest before anything else below resolves a font family
+    await load_fonts_prefix(options.fonts_prefix ?? '/fonts/');
+    // Renderer only needs base fonts (glyph shapes are embedded in compiled vector data)
+    let renderer = null;
+    if (options.renderer_wasm_url) {
+        const renderer_font_opts = loadFonts([]);
+        const r = createTypstRenderer();
+        await r.init({
+            getModule: () => ({ module_or_path: options.renderer_wasm_url }),
+            beforeBuild: [renderer_font_opts],
+        });
+        renderer = r;
+    }
+    const gen = new CoverGenerator(options, renderer);
+    // Warm the font byte cache with the always-needed base font while the rest of the app
+    // finishes loading — a failure here is fine, the first generate simply refetches
+    gen.prefetch_fonts([base_font()]).catch(() => { });
+    return gen;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,26 @@
+{
+    "name": "bookcover-web",
+    "version": "0.1.0",
+    "license": "MIT-0",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/gracious-tech/bookcover.git",
+        "directory": "generator-web"
+    },
+    "homepage": "https://github.com/gracious-tech/bookcover/tree/main/generator-web#readme",
+    "bugs": "https://github.com/gracious-tech/bookcover/issues",
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch"
+    },
+    "dependencies": {
+        "@myriaddreamin/typst-ts-renderer": "^0.7.0",
+        "@myriaddreamin/typst-ts-web-compiler": "^0.7.0",
+        "@myriaddreamin/typst.ts": "^0.7.0",
+        "bookcover-core": "file:../generator",
+        "typst-fonts": "^0.1.0"
+    }
+}

package/src/index.ts

@@ -0,0 +1,412 @@
+
+// Browser cover generator — compiles typst files via WebAssembly, supports PDF/SVG/PNG output
+
+import {createTypstCompiler, CompileFormatEnum} from '@myriaddreamin/typst.ts/compiler'
+import {createTypstRenderer} from '@myriaddreamin/typst.ts/renderer'
+import type {TypstCompiler} from '@myriaddreamin/typst.ts/compiler'
+import type {TypstRenderer} from '@myriaddreamin/typst.ts/renderer'
+import {loadFonts} from '@myriaddreamin/typst.ts'
+import {build, cover_schema, split_svg, split_png, split_pdf, frame_image, frame_asset_path,
+    asset_path, TYPST_DIR, TEMPLATE_FILES, collect_all_fonts} from 'bookcover-core'
+import type {OutputFormat, SplitResult, Templates} from 'bookcover-core'
+import {base_font} from 'typst-fonts'
+import {load_fonts_prefix, font_urls_for as build_font_urls, fetch_font_bytes,
+    fonts_to_blob_urls, revoke_blob_urls} from 'typst-fonts/web'
+
+export type {CoverSchema, TitlePosition, FontConfig,
+    OutputFormat, SplitResult, PatternDef} from 'bookcover-core'
+export type {BundledFont, CjkVariant} from 'typst-fonts'
+export {font_file_url} from 'typst-fonts/web'
+export {get_fonts, get_bundled_font} from 'typst-fonts'
+export {list_patterns, collect_fonts, collect_all_fonts, default_spine_title} from 'bookcover-core'
+
+const decoder = new TextDecoder()
+
+export interface InitOptions {
+    // URL or path to typst_ts_web_compiler_bg.wasm — required
+    wasm_url:string
+    // URL or path to typst_ts_renderer_bg.wasm — required for SVG/PNG output
+    renderer_wasm_url?:string
+    // URL prefix for generator assets (e.g. '/generator_assets/').
+    // Used to load typst templates, frames, backgrounds, etc.
+    assets_prefix?:string
+    // URL prefix for fonts — curated and Noto fallback alike (e.g.
+    // 'http://localhost:5300/generator_assets/fonts' in dev, 'https://assets.paper.bible/fonts' in
+    // production). Kept separate from assets_prefix since the fonts tree is managed and
+    // published by its own separate repo.
+    fonts_prefix?:string
+}
+
+export interface GenerateOptions {
+    schema:unknown
+    // Background image as a Blob (content type included)
+    image?:Blob
+    // Output format: 'pdf' (default), 'svg', or 'png'
+    format?:OutputFormat
+    // PPI for PNG output (default 144)
+    ppi?:number
+    // Whether to split the result into front/back/spine panels
+    split?:boolean
+    // Raw TTF bytes for user-uploaded custom fonts
+    custom_fonts?:Uint8Array[]
+}
+
+export interface GenerateResult {
+    // The full cover data (PDF/PNG bytes, or SVG string)
+    data:Uint8Array | string
+    // Split panel data (only present when split is true and format is svg/png)
+    split?:SplitResult<Uint8Array> | SplitResult<string>
+}
+
+
+/** Format compilation diagnostics into a readable error */
+function throw_compile_error(diagnostics:unknown):never {
+    const diag = Array.isArray(diagnostics)
+        ? diagnostics.map((d) => (typeof d === 'string' ? d : JSON.stringify(d))).join('\n')
+        : 'unknown error'
+    throw new Error(`[generator-web] Typst compilation failed:\n${diag}`)
+}
+
+/** Create a 2D canvas — a DOM element on the main thread, OffscreenCanvas inside a worker */
+function make_canvas(width:number, height:number):HTMLCanvasElement | OffscreenCanvas {
+    if (typeof document === 'undefined') {
+        return new OffscreenCanvas(width, height)
+    }
+    const canvas = document.createElement('canvas')
+    canvas.width = width
+    canvas.height = height
+    return canvas
+}
+
+/** Encode a canvas' contents as PNG bytes (handles both canvas types) */
+async function canvas_png_bytes(canvas:HTMLCanvasElement | OffscreenCanvas):Promise<Uint8Array> {
+    const blob = 'convertToBlob' in canvas
+        ? await canvas.convertToBlob({type: 'image/png'})
+        : await new Promise<Blob>((resolve) => {
+            canvas.toBlob((b) => resolve(b!), 'image/png')
+        })
+    return new Uint8Array(await blob.arrayBuffer())
+}
+
+/** Crop a region from a PNG using the Canvas API — used as PngCropFn */
+async function canvas_crop(
+    data:Uint8Array,
+    x:number,
+    y:number,
+    w:number,
+    h:number,
+):Promise<Uint8Array> {
+    const blob = new Blob([data as BlobPart], {type: 'image/png'})
+    const bitmap = await createImageBitmap(blob)
+
+    const canvas = make_canvas(w, h)
+    const ctx = (canvas as HTMLCanvasElement).getContext('2d')!
+    ctx.drawImage(bitmap, x, y, w, h, 0, 0, w, h)
+    bitmap.close()
+
+    return canvas_png_bytes(canvas)
+}
+
+/** Stateful cover generator — each instance owns its own compiler and renderer */
+export class CoverGenerator {
+    private opts:InitOptions
+    // Created lazily on first generate() — the font set isn't known until a schema arrives,
+    // so creating one earlier would just instantiate WASM with fonts that get replaced
+    private compiler!:TypstCompiler
+    private renderer:TypstRenderer | null
+
+    // Cache key of the font set the current compiler was init'd with ('' = no compiler yet)
+    private active_fonts = ''
+    // Fetched font bytes keyed by URL, so a compiler reinit (any font-set change) never
+    // refetches families already seen this session
+    private font_bytes = new Map<string, Uint8Array>()
+    // Blob URLs handed to the current compiler (bundled + custom) — revoked on reinit
+    private font_blob_urls:string[] = []
+    // Identity-based ids for custom font byte arrays (see custom_font_id)
+    private custom_font_ids = new WeakMap<Uint8Array, number>()
+    private next_custom_font_id = 1
+
+    constructor(opts:InitOptions, renderer:TypstRenderer | null) {
+        this.opts = opts
+        this.renderer = renderer
+    }
+
+    /** Build fetch URLs for the given font families against fonts_prefix — curated families
+     *  live at <prefix>/<family>/, Noto fallback families at <prefix>/_noto/<family>/,
+     *  mirroring the top-level fonts/ directory's own layout exactly */
+    private font_urls_for(families:string[]):string[] {
+        return build_font_urls(this.opts.fonts_prefix ?? '/fonts/', families)
+    }
+
+    /** Fetch a font file's bytes, memoised in font_bytes (failures aren't cached, so a
+     *  later generate retries the fetch) */
+    private async fetch_font(url:string):Promise<Uint8Array> {
+        const cached = this.font_bytes.get(url)
+        if (cached) {
+            return cached
+        }
+        const bytes = await fetch_font_bytes(url)
+        this.font_bytes.set(url, bytes)
+        return bytes
+    }
+
+    /** Pre-fetch the given font families into the in-memory byte cache */
+    async prefetch_fonts(families:string[]):Promise<void> {
+        await Promise.all(this.font_urls_for(families).map(url => this.fetch_font(url)))
+    }
+
+    /** Stable id for a custom font's byte array. The widget passes the same Uint8Array
+     *  references across generates, so object identity distinguishes fonts without hashing
+     *  their bytes (byteLength alone could collide between two different fonts). */
+    private custom_font_id(data:Uint8Array):number {
+        let id = this.custom_font_ids.get(data)
+        if (id === undefined) {
+            id = this.next_custom_font_id
+            this.next_custom_font_id += 1
+            this.custom_font_ids.set(data, id)
+        }
+        return id
+    }
+
+    /** (Re)initialise the compiler with a different font set. Bundled font bytes come from
+     *  the in-memory cache (fetched at most once per session) and everything is handed to
+     *  loadFonts() as blob URLs, keeping the network out of the reinit path. The renderer
+     *  never needs reinitialisation because it reads glyph outlines from compiled vector
+     *  data. */
+    private async reinit_compiler(font_urls:string[], custom_fonts?:Uint8Array[]):Promise<void> {
+        // Fetch any fonts not yet cached, in parallel
+        const bundled_bytes = await Promise.all(font_urls.map(url => this.fetch_font(url)))
+
+        // Revoke the previous compiler's blob URLs to avoid memory leaks
+        revoke_blob_urls(this.font_blob_urls)
+
+        // One blob URL per font file (bundled + custom) for loadFonts() to read —
+        // mapShadow only adds to the virtual filesystem, not the font book
+        this.font_blob_urls = fonts_to_blob_urls([...bundled_bytes, ...(custom_fonts ?? [])])
+
+        // assets:false stops typst.ts silently appending its default text fonts (NewCM,
+        // Libertinus, DejaVu... fetched from jsdelivr) — all fonts we need are passed explicitly
+        const compiler_font_opts = loadFonts(this.font_blob_urls, {assets: false})
+
+        const c = createTypstCompiler()
+        await c.init({
+            getModule: () => ({module_or_path: this.opts.wasm_url}),
+            beforeBuild: [compiler_font_opts],
+        })
+
+        this.compiler = c
+    }
+
+    /** Load the typst file map into the compiler's shadow filesystem */
+    private load_files(files:Map<string, Uint8Array>):void {
+        this.compiler.resetShadow()
+        for (const [filename, bytes] of files) {
+            const vpath = `/${filename}`
+            if (filename.endsWith('.typ')) {
+                this.compiler.addSource(vpath, decoder.decode(bytes))
+            }
+            else {
+                this.compiler.mapShadow(vpath, bytes)
+            }
+        }
+    }
+
+    /** Compile to PDF and return raw bytes */
+    private async compile_pdf():Promise<Uint8Array> {
+        const result = await this.compiler.compile({
+            mainFilePath: '/cover.typ',
+            format: CompileFormatEnum.pdf,
+        })
+        if (!result.result) {
+            throw_compile_error(result.diagnostics)
+        }
+        return result.result!
+    }
+
+    /** Compile to vector format, then render as SVG string covering the full canvas */
+    private async compile_svg():Promise<string> {
+        this.assert_renderer('SVG')
+        const result = await this.compiler.compile({
+            mainFilePath: '/cover.typ',
+            format: CompileFormatEnum.vector,
+        })
+        if (!result.result) {
+            throw_compile_error(result.diagnostics)
+        }
+
+        const svg = await this.renderer!.renderSvg({
+            artifactContent: result.result!,
+            format: 'vector',
+            data_selection: {js: false, css: true, body: true, defs: true},
+        })
+
+        // Patch unitless width/height to add `pt` suffix (Typst SVG output uses pt) so
+        // browsers render at 96 CSS px per inch, matching the split SVGs from split_svg()
+        return svg.replace(/<svg([^>]*)>/, (_match, attrs:string) => {
+            const patched = attrs
+                .replace(/width="([\d.]+)"/, 'width="$1pt"')
+                .replace(/height="([\d.]+)"/, 'height="$1pt"')
+            return `<svg${patched}>`
+        })
+    }
+
+    /** Compile to vector format, then render as PNG via offscreen canvas */
+    private async compile_png(ppi:number):Promise<Uint8Array> {
+        this.assert_renderer('PNG')
+        const result = await this.compiler.compile({
+            mainFilePath: '/cover.typ',
+            format: CompileFormatEnum.vector,
+        })
+        if (!result.result) {
+            throw_compile_error(result.diagnostics)
+        }
+
+        // Render to a canvas at the desired PPI (typst uses 72pt/inch)
+        const scale = ppi / 72
+        const canvas = document.createElement('canvas')
+
+        await this.renderer!.renderCanvas({
+            artifactContent: result.result!,
+            format: 'vector',
+            canvas,
+            pageOffset: 0,
+            pixelPerPt: scale,
+            backgroundColor: '#ffffff',
+        })
+
+        // Extract PNG from canvas
+        const blob = await new Promise<Blob>((resolve) => {
+            canvas.toBlob((b) => resolve(b!), 'image/png')
+        })
+        return new Uint8Array(await blob.arrayBuffer())
+    }
+
+    /** Throw if the renderer was not initialised */
+    private assert_renderer(format:string):void {
+        if (!this.renderer) {
+            throw new Error(
+                `[generator-web] ${format} output requires renderer_wasm_url in init() options`
+            )
+        }
+    }
+
+    /** Generate a book cover using this instance's compiler and renderer */
+    async generate(options:GenerateOptions):Promise<GenerateResult> {
+        const format = options.format ?? 'pdf'
+        // Default to 144 PPI (2x typographic resolution, 2 × 72pt/in)
+        const ppi = options.ppi ?? 144
+        const split = options.split ?? false
+
+        // Parse schema and get dimensions from printing-services
+        const parsed = cover_schema.parse(options.schema)
+        const assets = this.opts.assets_prefix ?? '/assets/'
+
+        // (Re)initialise the compiler when the set of required fonts changes — including on
+        // the very first generate, since the compiler is created lazily ('' never matches).
+        // Noto Serif (base font) is always included — it's not bundled in the WASM assets.
+        // collect_all_fonts also includes every Noto fallback family needed to cover non-Latin
+        // scripts detected in the schema's text, so only those specific families get fetched.
+        const needed_fonts = collect_all_fonts(parsed)
+        const custom_fonts_id = options.custom_fonts
+            ? options.custom_fonts.map(b => String(this.custom_font_id(b))).join(':')
+            : ''
+        const cache_key = needed_fonts.join(',') + '|' + custom_fonts_id
+        if (cache_key !== this.active_fonts) {
+            await this.reinit_compiler(this.font_urls_for(needed_fonts), options.custom_fonts)
+            this.active_fonts = cache_key
+        }
+
+        // Convert Blob to ImageInput (Uint8Array + extension) for the core builder
+        let image_input:{data:Uint8Array, ext:string} | undefined
+        if (options.image) {
+            const blob = options.image
+            const ext = '.' + (blob.type.split('/')[1] ?? 'jpg').replace('jpeg', 'jpg')
+            image_input = {data: new Uint8Array(await blob.arrayBuffer()), ext}
+        }
+
+        // Load typst templates from assets
+        const [cover_typ, helpers_typ] = await Promise.all([
+            fetch(asset_path(assets, TYPST_DIR, TEMPLATE_FILES.cover)).then(r => r.text()),
+            fetch(asset_path(assets, TYPST_DIR, TEMPLATE_FILES.helpers)).then(r => r.text()),
+        ])
+        const templates:Templates = {cover: cover_typ, helpers: helpers_typ}
+
+        // Load the frame PNG from assets when the schema uses painted coverage
+        let frame_blob:Blob | undefined
+        if (parsed.bg_image_coverage === 'painted') {
+            const url = frame_asset_path(assets, 'painted')
+            const resp = await fetch(url)
+            frame_blob = await resp.blob()
+        }
+
+        const {files, dims} = await build(templates, parsed, image_input, frame_image, frame_blob)
+        this.load_files(files)
+
+        // Compile to the requested format
+        let data:Uint8Array | string
+
+        if (format === 'pdf') {
+            data = await this.compile_pdf()
+        }
+        else if (format === 'svg') {
+            data = await this.compile_svg()
+        }
+        else {
+            data = await this.compile_png(ppi)
+        }
+
+        const result:GenerateResult = {data}
+
+        // Split into front/back/spine panels
+        if (split) {
+            if (format === 'pdf') {
+                result.split = split_pdf(data as Uint8Array, dims)
+            }
+            else if (format === 'svg') {
+                result.split = split_svg(data as string, dims)
+            }
+            else {
+                result.split = await split_png(data as Uint8Array, dims, ppi, canvas_crop)
+            }
+        }
+
+        return result
+    }
+
+    /** Revoke blob URLs and drop cached font bytes to free memory */
+    destroy():void {
+        revoke_blob_urls(this.font_blob_urls)
+        this.font_blob_urls = []
+        this.font_bytes.clear()
+    }
+}
+
+/**
+ * Create a CoverGenerator instance with an optional initialised WASM renderer.
+ * The compiler itself is created lazily by the first generate() call, once the schema's
+ * font set is known. Each instance is independent — multiple generators can run concurrently.
+ */
+export async function init(options:InitOptions):Promise<CoverGenerator> {
+    // Load the curated font manifest before anything else below resolves a font family
+    await load_fonts_prefix(options.fonts_prefix ?? '/fonts/')
+
+    // Renderer only needs base fonts (glyph shapes are embedded in compiled vector data)
+    let renderer:TypstRenderer | null = null
+    if (options.renderer_wasm_url) {
+        const renderer_font_opts = loadFonts([])
+        const r = createTypstRenderer()
+        await r.init({
+            getModule: () => ({module_or_path: options.renderer_wasm_url!}),
+            beforeBuild: [renderer_font_opts],
+        })
+        renderer = r
+    }
+
+    const gen = new CoverGenerator(options, renderer)
+
+    // Warm the font byte cache with the always-needed base font while the rest of the app
+    // finishes loading — a failure here is fine, the first generate simply refetches
+    gen.prefetch_fonts([base_font()]).catch(() => {})
+
+    return gen
+}

package/tsconfig.json

@@ -0,0 +1,19 @@
+
+{
+    "compilerOptions": {
+        "target": "ES2022",
+        "module": "NodeNext",
+        "moduleResolution": "NodeNext",
+        "lib": ["ES2022", "DOM"],
+        "outDir": "dist",
+        "rootDir": "src",
+        "strict": true,
+        "declaration": true,
+        "declarationMap": true,
+        "sourceMap": true,
+        "forceConsistentCasingInFileNames": true,
+        "skipLibCheck": true
+    },
+    "include": ["src"],
+    "exclude": ["node_modules", "dist"]
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/index.ts"],"version":"5.9.3"}