@makolabs/ripple 3.9.1 → 3.9.2

package/dist/elements/pdf-viewer/PdfViewer.svelte

@@ -13,6 +13,7 @@
 		type FitMode
 	} from '../../helper/pdf-safety.js';
 	import { MAX_PAGES } from '../../helper/resource-limits.js';
+	import { PdfBinaryDataFactory } from '../../helper/pdf-assets.js';
 	import Spinner from '../spinner/Spinner.svelte';
 	import Button from '../../button/Button.svelte';
 	import { Color, Size } from '../../variants.js';
@@ -193,6 +194,10 @@
 
 		const loadingTask = (currentLoadingTask = pdfjsLib.getDocument({
 			url,
+			// Serve pdfjs's image-codec wasm (JPEG2000/JPX, JBIG2) from
+			// bundler-emitted asset URLs. Without this, JPX-encoded pages render
+			// blank because pdfjs can't load `openjpeg.wasm`. See pdf-assets.ts.
+			BinaryDataFactory: PdfBinaryDataFactory,
 			...PDFJS_DOCUMENT_OPTIONS
 		}));
 

package/dist/helper/pdf-assets.d.ts

@@ -0,0 +1,42 @@
+/**
+ * pdfjs ships its image codecs (JPEG2000/JPX, JBIG2) and colour management as
+ * separate WebAssembly modules that live in `pdfjs-dist/wasm/`. Since pdfjs v4+
+ * the JPX decoder is one of these wasm modules, so a page whose images are
+ * JPEG2000-encoded (`/Filter /JPXDecode`) renders BLANK unless pdfjs can load
+ * `openjpeg.wasm` at runtime. pdfjs's own `wasmUrl` option expects a directory
+ * URL and then fetches `<wasmUrl>openjpeg.wasm` by its literal name — but a
+ * bundler (Vite/webpack) content-hashes emitted assets and can't emit a bare
+ * directory, so a plain `wasmUrl` can't be resolved reliably from a library.
+ *
+ * Instead we resolve each wasm file individually with the same bundler-agnostic
+ * `new URL('<file>', import.meta.url)` mechanism used for the pdf worker (every
+ * major bundler rewrites it to the emitted asset URL), fetch the bytes, and hand
+ * them straight to pdfjs through a custom `BinaryDataFactory`. This sidesteps
+ * both the directory requirement and asset hashing: we already hold the correct
+ * (hashed) URL for each file, so the exact emitted name never has to be guessed.
+ *
+ * pdfjs only reaches this factory for image-codec wasm (JPX/JBIG2); ICC colour
+ * (`qcms_bg.wasm`) is loaded by pdfjs via a separate synchronous path that still
+ * needs `wasmUrl` and is left unconfigured (non-fatal — ICC profiles are rare in
+ * scanned docs and pdfjs simply warns and skips them). Predefined CMaps and
+ * standard fonts are likewise unconfigured, matching the prior behaviour.
+ */
+/** Argument shape pdfjs passes to `BinaryDataFactory#fetch`. */
+type FetchRequest = {
+    kind: string;
+    filename: string;
+};
+/**
+ * A pdfjs `BinaryDataFactory` that serves the image-codec wasm modules from
+ * bundler-emitted asset URLs. Pass the class (not an instance) as the
+ * `BinaryDataFactory` option to `getDocument` — pdfjs instantiates it itself.
+ *
+ * For any request it doesn't recognise (predefined CMaps, standard fonts) it
+ * throws the same "API parameter not provided" error pdfjs's default factory
+ * would, so behaviour for those unconfigured assets is unchanged.
+ */
+export declare class PdfBinaryDataFactory {
+    constructor(_options?: unknown);
+    fetch({ kind, filename }: FetchRequest): Promise<Uint8Array>;
+}
+export {};

package/dist/helper/pdf-assets.js

@@ -0,0 +1,57 @@
+/**
+ * pdfjs ships its image codecs (JPEG2000/JPX, JBIG2) and colour management as
+ * separate WebAssembly modules that live in `pdfjs-dist/wasm/`. Since pdfjs v4+
+ * the JPX decoder is one of these wasm modules, so a page whose images are
+ * JPEG2000-encoded (`/Filter /JPXDecode`) renders BLANK unless pdfjs can load
+ * `openjpeg.wasm` at runtime. pdfjs's own `wasmUrl` option expects a directory
+ * URL and then fetches `<wasmUrl>openjpeg.wasm` by its literal name — but a
+ * bundler (Vite/webpack) content-hashes emitted assets and can't emit a bare
+ * directory, so a plain `wasmUrl` can't be resolved reliably from a library.
+ *
+ * Instead we resolve each wasm file individually with the same bundler-agnostic
+ * `new URL('<file>', import.meta.url)` mechanism used for the pdf worker (every
+ * major bundler rewrites it to the emitted asset URL), fetch the bytes, and hand
+ * them straight to pdfjs through a custom `BinaryDataFactory`. This sidesteps
+ * both the directory requirement and asset hashing: we already hold the correct
+ * (hashed) URL for each file, so the exact emitted name never has to be guessed.
+ *
+ * pdfjs only reaches this factory for image-codec wasm (JPX/JBIG2); ICC colour
+ * (`qcms_bg.wasm`) is loaded by pdfjs via a separate synchronous path that still
+ * needs `wasmUrl` and is left unconfigured (non-fatal — ICC profiles are rare in
+ * scanned docs and pdfjs simply warns and skips them). Predefined CMaps and
+ * standard fonts are likewise unconfigured, matching the prior behaviour.
+ */
+/**
+ * Bundler-resolved URLs for the wasm image codecs. The `new URL(<literal>,
+ * import.meta.url)` calls must use string literals so Vite/webpack can statically
+ * detect them and emit the assets. Keyed by the exact filename pdfjs requests.
+ */
+const WASM_ASSET_URLS = {
+    'openjpeg.wasm': new URL('pdfjs-dist/wasm/openjpeg.wasm', import.meta.url),
+    'jbig2.wasm': new URL('pdfjs-dist/wasm/jbig2.wasm', import.meta.url)
+};
+/**
+ * A pdfjs `BinaryDataFactory` that serves the image-codec wasm modules from
+ * bundler-emitted asset URLs. Pass the class (not an instance) as the
+ * `BinaryDataFactory` option to `getDocument` — pdfjs instantiates it itself.
+ *
+ * For any request it doesn't recognise (predefined CMaps, standard fonts) it
+ * throws the same "API parameter not provided" error pdfjs's default factory
+ * would, so behaviour for those unconfigured assets is unchanged.
+ */
+export class PdfBinaryDataFactory {
+    // pdfjs constructs this with { cMapUrl, standardFontDataUrl, wasmUrl }; we
+    // resolve wasm ourselves and ignore the (unset) URL options.
+    constructor(_options) { }
+    async fetch({ kind, filename }) {
+        const assetUrl = WASM_ASSET_URLS[filename];
+        if (!assetUrl) {
+            throw new Error(`Ensure that the \`${kind}\` API parameter is provided.`);
+        }
+        const response = await fetch(assetUrl);
+        if (!response.ok) {
+            throw new Error(`Unable to load pdf wasm asset "${filename}" (HTTP ${response.status})`);
+        }
+        return new Uint8Array(await response.arrayBuffer());
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@makolabs/ripple",
-	"version": "3.9.1",
+	"version": "3.9.2",
 	"description": "Simple Svelte 5 powered component library ✨",
 	"license": "SEE LICENSE IN LICENSE",
 	"repository": {