chore(wasm): prepare 0.1.2 release

.github/workflows/ci.yml

@@ -42,6 +42,9 @@ jobs:
       - name: Check formatting
         run: cargo fmt --all -- --check
 
+      - name: Check WASM formatting
+        run: cargo fmt --manifest-path wasm/Cargo.toml -- --check
+
   clippy:
     name: Clippy
     runs-on: ubuntu-latest
@@ -80,3 +83,37 @@ jobs:
 
       - name: Build
         run: cargo build --release --verbose
+
+  wasm:
+    name: WebAssembly
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+          components: clippy
+
+      - name: Cache cargo
+        uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: |
+            wasm -> target
+          key: wasm
+
+      - name: Check WebAssembly bindings
+        run: cargo check --manifest-path wasm/Cargo.toml --target wasm32-unknown-unknown
+
+      - name: Check root package for WebAssembly
+        run: cargo check --target wasm32-unknown-unknown
+
+      - name: Lint WebAssembly bindings
+        run: cargo clippy --manifest-path wasm/Cargo.toml --target wasm32-unknown-unknown -- -D warnings
+
+      - name: Install wasm-pack
+        run: cargo install wasm-pack --version 0.15.0 --locked
+
+      - name: Test WebAssembly package
+        run: wasm-pack test --node --release wasm

.github/workflows/publish-wasm.yml

@@ -0,0 +1,111 @@
+name: Publish WebAssembly package
+
+on:
+  push:
+    branches: [main]
+    paths: ['wasm/Cargo.toml']
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  check-version:
+    name: Check version change
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    outputs:
+      changed: ${{ steps.check.outputs.changed }}
+      package_exists: ${{ steps.check.outputs.package_exists }}
+      published: ${{ steps.check.outputs.published }}
+      version: ${{ steps.check.outputs.version }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
+
+      - name: Check package version
+        id: check
+        run: |
+          NEW_VERSION=$(python3 -c 'import pathlib, tomllib; print(tomllib.loads(pathlib.Path("wasm/Cargo.toml").read_text())["package"]["version"])')
+          echo "version=$NEW_VERSION" >> "$GITHUB_OUTPUT"
+
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+          elif git cat-file -e HEAD~1:wasm/Cargo.toml 2>/dev/null; then
+            OLD_VERSION=$(git show HEAD~1:wasm/Cargo.toml | python3 -c 'import sys, tomllib; print(tomllib.loads(sys.stdin.read())["package"]["version"])')
+            if [ "$NEW_VERSION" = "$OLD_VERSION" ]; then
+              echo "changed=false" >> "$GITHUB_OUTPUT"
+              echo "published=false" >> "$GITHUB_OUTPUT"
+              exit 0
+            fi
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "changed=true" >> "$GITHUB_OUTPUT"
+          fi
+
+          if ! npm view "@firecrawl/pdf-inspector-wasm" name >/dev/null 2>&1; then
+            echo "package_exists=false" >> "$GITHUB_OUTPUT"
+            echo "published=false" >> "$GITHUB_OUTPUT"
+            echo "The initial package must be published once before trusted publishing can be configured."
+            exit 0
+          fi
+
+          echo "package_exists=true" >> "$GITHUB_OUTPUT"
+          if npm view "@firecrawl/pdf-inspector-wasm@$NEW_VERSION" version >/dev/null 2>&1; then
+            echo "published=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "published=false" >> "$GITHUB_OUTPUT"
+          fi
+
+  publish:
+    name: Build and publish
+    needs: check-version
+    if: needs.check-version.outputs.changed == 'true' && needs.check-version.outputs.package_exists == 'true' && needs.check-version.outputs.published == 'false'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: '24'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install wasm-pack
+        run: cargo install wasm-pack --version 0.15.0 --locked
+
+      - name: Build browser package
+        run: wasm-pack build wasm --target web --scope firecrawl --out-dir pkg --release
+
+      - name: Prepare package metadata
+        run: |
+          node -e '
+            const fs = require("fs")
+            const path = "wasm/pkg/package.json"
+            const pkg = JSON.parse(fs.readFileSync(path, "utf8"))
+            pkg.name = "@firecrawl/pdf-inspector-wasm"
+            pkg.description = "Browser WebAssembly bindings for the pdf-inspector Rust PDF parser"
+            pkg.keywords = ["pdf", "pdf-parser", "webassembly", "wasm", "markdown", "rust", "firecrawl"]
+            pkg.repository = { type: "git", url: "https://github.com/firecrawl/pdf-inspector" }
+            pkg.homepage = "https://github.com/firecrawl/pdf-inspector/tree/main/wasm"
+            pkg.publishConfig = { access: "public" }
+            fs.writeFileSync(path, JSON.stringify(pkg, null, 2) + "\n")
+          '
+
+      - name: Inspect package contents
+        run: npm pack --dry-run ./wasm/pkg
+
+      - name: Publish package
+        run: npm publish ./wasm/pkg --provenance --access public

.gitignore

@@ -1,10 +1,13 @@
 # Rust build artifacts
 /target/
+/wasm/target/
+/wasm/pkg/
 debug/
 *.pdb
 
 # Cargo lock (optional for libraries)
 Cargo.lock
+!/wasm/Cargo.lock
 
 # IDE
 .idea/
@@ -39,4 +42,3 @@ test_output/
 __pycache__/
 *.pyc
 .pytest_cache/
-

Cargo.toml

@@ -12,13 +12,13 @@ readme = "docs/rust-api.md"
 # alone exceeds that. external/bcmaps ships in the crate — tounicode.rs
 # loads it at runtime relative to CARGO_MANIFEST_DIR.
 include = [
-    "src/**",
-    "external/bcmaps/**",
-    "docs/rust-api.md",
-    "LICENSE",
+    "/src/**",
+    "/external/bcmaps/**",
+    "/docs/rust-api.md",
+    "/LICENSE",
     # maturin derives the sdist file list from this allowlist; the stub must
     # ship so wheels built from the sdist keep their type hints.
-    "pdf_inspector.pyi",
+    "/pdf_inspector.pyi",
 ]
 
 [lib]
@@ -29,18 +29,11 @@ crate-type = ["lib", "cdylib"]
 # Python bindings
 pyo3 = { version = "0.25", features = ["extension-module", "abi3-py38"], optional = true }
 
-# PDF parsing
-lopdf = { version = "0.41.0", features = ["rayon"] }
-
 # Error handling
 thiserror = "2.0"
 
-# Parallel processing
-rayon = "1.10"
-
 # Logging
 log = "0.4"
-env_logger = "0.11"
 
 # Text processing
 regex = "1.10"
@@ -50,6 +43,19 @@ unicode-normalization = "0.1"
 # TrueType font parsing (for Identity-H CID font cmap extraction)
 ttf-parser = "0.25"
 
+# Native builds keep lopdf's parallel parser and CLI logging. Browser WASM is
+# deliberately single-threaded so it works without cross-origin isolation.
+[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+lopdf = { version = "0.41.0", features = ["rayon"] }
+rayon = "1.10"
+env_logger = "0.11"
+
+# Browser builds use JavaScript randomness for encrypted PDFs and embed the
+# bundled CMaps because there is no filesystem at runtime.
+[target.'cfg(target_arch = "wasm32")'.dependencies]
+lopdf = { version = "0.41.0", default-features = false, features = ["wasm_js"] }
+include_dir = "0.7"
+
 [dev-dependencies]
 tempfile = "3.3"
 

README.md

@@ -5,7 +5,7 @@
 [![PyPI](https://img.shields.io/pypi/v/pdf-inspector.svg)](https://pypi.org/project/pdf-inspector/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
-Fast Rust library for PDF classification and text extraction. Detects whether a PDF is text-based or scanned, extracts text with position awareness, and converts to clean Markdown — all without OCR. Includes bindings for [Python](docs/python.md) and [Node.js](napi/README.md).
+Fast Rust library for PDF classification and text extraction. Detects whether a PDF is text-based or scanned, extracts text with position awareness, and converts to clean Markdown — all without OCR. Includes bindings for [Python](docs/python.md), [Node.js](napi/README.md), and [browser WebAssembly](wasm/README.md).
 
 Built by [Firecrawl](https://firecrawl.dev) to handle text-based PDFs locally in under 200ms, skipping expensive OCR services for the ~54% of PDFs that don't need them.
 
@@ -19,6 +19,7 @@ Built by [Firecrawl](https://firecrawl.dev) to handle text-based PDFs locally in
 - **Multi-column layout** — Automatic detection of newspaper-style columns, sequential reading order, and RTL text support.
 - **Encoding issue detection** — Automatically flags broken font encodings so callers can fall back to OCR.
 - **Single document load** — The document is parsed once and shared between detection and extraction, avoiding redundant I/O.
+- **Browser WebAssembly** — Run the same Rust parser locally in browsers and Web Workers, with embedded CMaps and no server round trip.
 - **Lightweight** — Pure Rust, no ML models, no external services. Single dependency on `lopdf` for PDF parsing.
 
 ## Benchmark
@@ -77,6 +78,26 @@ console.log(result.markdown);  // Markdown string or null
 
 > Full API reference: [napi/README.md](napi/README.md)
 
+### Browser WebAssembly
+
+```bash
+npm install @firecrawl/pdf-inspector-wasm
+```
+
+```javascript
+import init, { processPdf } from '@firecrawl/pdf-inspector-wasm';
+
+await init();
+const response = await fetch('/document.pdf');
+const pdf = new Uint8Array(await response.arrayBuffer());
+const result = processPdf(pdf);
+
+console.log(result.pdfType);
+console.log(result.markdown);
+```
+
+> Full API reference: [wasm/README.md](wasm/README.md)
+
 ### Rust
 
 Install from [crates.io](https://crates.io/crates/pdf-inspector):
@@ -188,6 +209,7 @@ src/
   markdown/             — Markdown conversion and structure detection
   bin/                  — CLI tools (pdf2md, detect_pdf)
 napi/                   — Node.js/Bun bindings (napi-rs)
+wasm/                   — Browser bindings (wasm-bindgen)
 ```
 
 ## How classification works

docs/publishing.md

@@ -19,3 +19,20 @@ The workflow uses `rust-lang/crates-io-auth-action@v1` to exchange GitHub's OIDC
 3. The publish workflow compares the new `Cargo.toml` version with `HEAD~1`, runs `cargo publish --dry-run`, then publishes if that version is not already on crates.io.
 
 If `Cargo.toml` changes without a package version bump, the workflow exits without publishing.
+
+## Browser WebAssembly package
+
+The browser package is published as `@firecrawl/pdf-inspector-wasm`. Its version lives in `wasm/Cargo.toml`, and `.github/workflows/publish-wasm.yml` builds the `web` target with `wasm-pack` before publishing the generated package.
+
+The npm package must exist before a trusted publisher can be configured. For the first release only:
+
+1. Build with `wasm-pack build wasm --target web --scope firecrawl --out-dir pkg --release`.
+2. Inspect with `npm pack --dry-run ./wasm/pkg`.
+3. Publish with `npm publish ./wasm/pkg --access public` from an authorized maintainer session.
+4. In the package settings on npm, configure the GitHub Actions trusted publisher:
+   - Organization: `firecrawl`
+   - Repository: `pdf-inspector`
+   - Workflow: `publish-wasm.yml`
+   - Allowed action: `npm publish`
+
+After that one-time bootstrap, bumping the version in `wasm/Cargo.toml` and merging it to `main` publishes through OIDC. Until the package exists, the workflow exits cleanly without attempting an unauthenticated first publish. See npm's [trusted publishing documentation](https://docs.npmjs.com/trusted-publishers/) for the registry-side setup.

src/bin/detect_pdf.rs

@@ -63,6 +63,7 @@ fn json_escape(s: &str) -> String {
 }
 
 fn main() {
+    #[cfg(not(target_arch = "wasm32"))]
     env_logger::init();
     let args: Vec<String> = env::args().collect();
 

src/bin/pdf2md.rs

@@ -190,6 +190,7 @@ fn print_layout_info(layout: &LayoutComplexity) {
 }
 
 fn main() {
+    #[cfg(not(target_arch = "wasm32"))]
     env_logger::init();
     let args: Vec<String> = env::args().collect();
 

src/extractor/layout.rs

@@ -1153,6 +1153,22 @@ pub fn group_into_lines(items: Vec<TextItem>) -> Vec<TextLine> {
     group_into_lines_with_thresholds(items, &HashMap::new(), &HashSet::new())
 }
 
+/// Group text items into lines without removing numeric page headers or footers.
+///
+/// Plain-text extraction uses this path because every extracted item is part of
+/// the API result. Markdown conversion keeps using [`group_into_lines`], where
+/// page-number suppression is an intentional presentation cleanup.
+pub fn group_into_lines_preserving_all_text(items: Vec<TextItem>) -> Vec<TextLine> {
+    group_into_lines_with_thresholds_and_regions_impl(
+        items,
+        &HashMap::new(),
+        &HashSet::new(),
+        &HashMap::new(),
+        &HashMap::new(),
+        false,
+    )
+}
+
 /// Group text items into lines, using pre-computed per-page adaptive thresholds
 /// from Canva-style letter-spacing detection. Falls back to computing the
 /// threshold from item gaps when no pre-computed value is available.
@@ -1195,16 +1211,39 @@ pub(crate) fn group_into_lines_with_thresholds_and_regions(
     table_pages: &HashSet<u32>,
     chart_regions: &HashMap<u32, Vec<(f32, f32, f32, f32)>>,
     image_regions: &HashMap<u32, Vec<super::reading_order::ImageRegion>>,
+) -> Vec<TextLine> {
+    group_into_lines_with_thresholds_and_regions_impl(
+        items,
+        page_thresholds,
+        table_pages,
+        chart_regions,
+        image_regions,
+        true,
+    )
+}
+
+fn group_into_lines_with_thresholds_and_regions_impl(
+    items: Vec<TextItem>,
+    page_thresholds: &HashMap<u32, f32>,
+    table_pages: &HashSet<u32>,
+    chart_regions: &HashMap<u32, Vec<(f32, f32, f32, f32)>>,
+    image_regions: &HashMap<u32, Vec<super::reading_order::ImageRegion>>,
+    filter_page_numbers: bool,
 ) -> Vec<TextLine> {
     if items.is_empty() {
         return Vec::new();
     }
 
-    // Filter out page numbers (standalone numbers at top/bottom of page)
-    let items: Vec<TextItem> = items
-        .into_iter()
-        .filter(|item| !is_page_number(item))
-        .collect();
+    // Markdown output omits standalone numeric headers/footers. Plain-text
+    // callers opt out because dropping extracted text violates that API.
+    let items = if filter_page_numbers {
+        items
+            .into_iter()
+            .filter(|item| !is_page_number(item))
+            .collect()
+    } else {
+        items
+    };
 
     // Get unique pages
     let mut pages: Vec<u32> = items.iter().map(|i| i.page).collect();

src/extractor/mod.rs

@@ -27,12 +27,12 @@ pub use crate::text_utils::{is_bold_font, is_italic_font};
 pub use crate::types::{ItemType, TextLine};
 pub(crate) use fonts::FontStyleCache;
 pub(crate) use layout::detect_columns;
-pub use layout::group_into_lines;
 pub(crate) use layout::group_into_lines_with_thresholds;
 pub(crate) use layout::group_into_lines_with_thresholds_and_charts;
 pub(crate) use layout::group_into_lines_with_thresholds_and_regions;
 pub(crate) use layout::is_newspaper_layout;
 pub(crate) use layout::ColumnRegion;
+pub use layout::{group_into_lines, group_into_lines_preserving_all_text};
 
 // ---------------------------------------------------------------------------
 // Public API
@@ -1519,6 +1519,18 @@ mod tests {
         assert_eq!(lines[1].text(), "Next line");
     }
 
+    #[test]
+    fn preserving_all_text_keeps_numeric_page_footer() {
+        let mut page_number = make_merge_item("42", 100.0, 12.0);
+        page_number.y = 50.0;
+
+        assert!(group_into_lines(vec![page_number.clone()]).is_empty());
+
+        let lines = group_into_lines_preserving_all_text(vec![page_number]);
+        assert_eq!(lines.len(), 1);
+        assert_eq!(lines[0].text(), "42");
+    }
+
     #[test]
     fn test_bold_italic_detection() {
         // Test bold detection

src/lib.rs

@@ -68,6 +68,40 @@ use text_quality::{
 };
 use tounicode::FontCMaps;
 
+#[cfg(not(target_arch = "wasm32"))]
+struct ProcessingTimer(std::time::Instant);
+
+#[cfg(target_arch = "wasm32")]
+struct ProcessingTimer;
+
+impl ProcessingTimer {
+    fn start() -> Self {
+        #[cfg(not(target_arch = "wasm32"))]
+        {
+            Self(std::time::Instant::now())
+        }
+
+        #[cfg(target_arch = "wasm32")]
+        {
+            Self
+        }
+    }
+
+    fn elapsed_ms(&self) -> u64 {
+        #[cfg(not(target_arch = "wasm32"))]
+        {
+            self.0.elapsed().as_millis() as u64
+        }
+
+        #[cfg(target_arch = "wasm32")]
+        {
+            // The wasm32-unknown-unknown standard library has no clock.
+            // Browser bindings measure with JavaScript's host clock.
+            0
+        }
+    }
+}
+
 /// OCR reason emitted when the extracted text layer appears garbled due to
 /// broken font decoding or mojibake.
 pub const OCR_REASON_SUSPECTED_GARBLED_TEXT: &str = "suspected_garbled_text";
@@ -250,7 +284,7 @@ pub fn process_pdf_with_options<P: AsRef<Path>>(
     path: P,
     options: PdfOptions,
 ) -> Result<PdfProcessResult, PdfError> {
-    let start = std::time::Instant::now();
+    let start = ProcessingTimer::start();
     validate_pdf_file(&path)?;
 
     // Load the document once — shared by detection AND extraction.
@@ -277,7 +311,7 @@ pub fn process_pdf_mem_with_options(
     buffer: &[u8],
     options: PdfOptions,
 ) -> Result<PdfProcessResult, PdfError> {
-    let start = std::time::Instant::now();
+    let start = ProcessingTimer::start();
     validate_pdf_bytes(buffer)?;
 
     let (doc, page_count) =
@@ -3526,7 +3560,7 @@ fn process_document(
     doc: Document,
     page_count: u32,
     options: PdfOptions,
-    start: std::time::Instant,
+    start: ProcessingTimer,
 ) -> Result<PdfProcessResult, PdfError> {
     // Step 1 — Detection (cheap: scans content streams for text operators)
     let detection = detector::detect_from_document(&doc, page_count, &options.detection)?;
@@ -3542,7 +3576,7 @@ fn process_document(
             pdf_type,
             markdown: None,
             page_count,
-            processing_time_ms: start.elapsed().as_millis() as u64,
+            processing_time_ms: start.elapsed_ms(),
             pages_needing_ocr,
             ocr_reasons_by_page: page_ocr_reasons_vec(detection_ocr_reasons),
             title,
@@ -3558,7 +3592,7 @@ fn process_document(
             pdf_type,
             markdown: None,
             page_count,
-            processing_time_ms: start.elapsed().as_millis() as u64,
+            processing_time_ms: start.elapsed_ms(),
             pages_needing_ocr,
             ocr_reasons_by_page: page_ocr_reasons_vec(detection_ocr_reasons),
             title,
@@ -3824,7 +3858,7 @@ fn process_document(
         pdf_type,
         markdown,
         page_count,
-        processing_time_ms: start.elapsed().as_millis() as u64,
+        processing_time_ms: start.elapsed_ms(),
         pages_needing_ocr,
         ocr_reasons_by_page: {
             // Detector reasons (scanned / no_text / vector_text / garbled) merged

src/tounicode.rs

@@ -4,11 +4,17 @@
 
 use log::{debug, warn};
 use lopdf::{Document, Object, ObjectId};
+use std::borrow::Cow;
 use std::collections::{HashMap, HashSet};
+#[cfg(not(target_arch = "wasm32"))]
 use std::path::{Path, PathBuf};
 
 use crate::glyph_names::glyph_to_char;
 
+#[cfg(target_arch = "wasm32")]
+static BUILTIN_CMAPS: include_dir::Dir<'_> =
+    include_dir::include_dir!("$CARGO_MANIFEST_DIR/external/bcmaps");
+
 /// A parsed ToUnicode CMap mapping CIDs to Unicode strings
 #[derive(Debug, Default, Clone)]
 pub struct ToUnicodeCMap {
@@ -1149,9 +1155,7 @@ fn build_gid_to_unicode(face: &ttf_parser::Face<'_>) -> Option<HashMap<u16, char
 /// Build a ToUnicodeCMap from pdf.js built-in binary CMaps (bcmaps).
 fn build_cmap_from_builtin_cmap(ordering: &str) -> Option<ToUnicodeCMap> {
     let name = format!("Adobe-{}-UCS2.bcmap", ordering);
-    let dir = find_bcmaps_dir()?;
-    let path = dir.join(name);
-    let data = std::fs::read(&path).ok()?;
+    let data = read_builtin_cmap_file(&name)?;
     let mut cmap = parse_binary_cmap(&data).ok()?;
     if cmap.char_map.is_empty() && cmap.ranges.is_empty() {
         return None;
@@ -1159,13 +1163,14 @@ fn build_cmap_from_builtin_cmap(ordering: &str) -> Option<ToUnicodeCMap> {
     cmap.code_byte_length = 2;
     debug!(
         "Built-in CMap {}: char_map={} ranges={}",
-        path.display(),
+        name,
         cmap.char_map.len(),
         cmap.ranges.len()
     );
     Some(cmap)
 }
 
+#[cfg(not(target_arch = "wasm32"))]
 fn find_bcmaps_dir() -> Option<PathBuf> {
     if let Ok(dir) = std::env::var("PDF_INSPECTOR_BCMAPS_DIR") {
         let p = PathBuf::from(dir);
@@ -1182,6 +1187,18 @@ fn find_bcmaps_dir() -> Option<PathBuf> {
     None
 }
 
+#[cfg(not(target_arch = "wasm32"))]
+fn read_builtin_cmap_file(name: &str) -> Option<Cow<'static, [u8]>> {
+    let path = find_bcmaps_dir()?.join(name);
+    std::fs::read(path).ok().map(Cow::Owned)
+}
+
+#[cfg(target_arch = "wasm32")]
+fn read_builtin_cmap_file(name: &str) -> Option<Cow<'static, [u8]>> {
+    let file = BUILTIN_CMAPS.get_file(name)?;
+    Some(Cow::Borrowed(file.contents()))
+}
+
 fn parse_binary_cmap(data: &[u8]) -> Result<ToUnicodeCMap, String> {
     let mut stream = BinaryCMapStream::new(data);
     let _header = stream.read_byte().ok_or("unexpected EOF in bcmap header")?;
@@ -1492,9 +1509,7 @@ fn parse_encoding_cmap_object(obj: &Object, doc: &Document) -> Option<EncodingCM
 }
 
 fn load_builtin_encoding_cmap(name: &str) -> Option<EncodingCMap> {
-    let dir = find_bcmaps_dir()?;
-    let path = dir.join(format!("{}.bcmap", name));
-    let data = std::fs::read(&path).ok()?;
+    let data = read_builtin_cmap_file(&format!("{}.bcmap", name))?;
     parse_binary_cmap_encoding(&data).ok()
 }
 
@@ -1779,9 +1794,7 @@ fn load_builtin_cmap_by_name(name: &str) -> Option<ToUnicodeCMap> {
     if !name.ends_with("UCS2") {
         return None;
     }
-    let dir = find_bcmaps_dir()?;
-    let path = dir.join(format!("{}.bcmap", name));
-    let data = std::fs::read(&path).ok()?;
+    let data = read_builtin_cmap_file(&format!("{}.bcmap", name))?;
     let mut cmap = parse_binary_cmap(&data).ok()?;
     if cmap.char_map.is_empty() && cmap.ranges.is_empty() {
         return None;

wasm/Cargo.toml

@@ -0,0 +1,37 @@
+[package]
+name = "pdf-inspector-wasm"
+version = "0.1.2"
+edition = "2021"
+authors = ["Firecrawl Team"]
+description = "Browser WebAssembly bindings for pdf-inspector"
+license = "MIT"
+repository = "https://github.com/firecrawl/pdf-inspector"
+homepage = "https://github.com/firecrawl/pdf-inspector"
+readme = "README.md"
+publish = false
+
+[lib]
+crate-type = ["cdylib", "rlib"]
+
+[dependencies]
+console_error_panic_hook = "0.1"
+js-sys = "0.3"
+pdf-inspector = { path = ".." }
+serde = { version = "1", features = ["derive"] }
+serde-wasm-bindgen = "0.6"
+wasm-bindgen = "0.2"
+
+[dev-dependencies]
+wasm-bindgen-test = "0.3"
+
+[profile.release]
+codegen-units = 1
+lto = true
+opt-level = "s"
+strip = true
+
+[package.metadata.wasm-pack.profile.release]
+# Rust 1.95 emits bulk-memory instructions that the binaryen bundled with
+# wasm-pack 0.15.0 does not yet validate. rustc still performs the release,
+# size, and LTO optimizations above.
+wasm-opt = false

wasm/LICENSE

@@ -0,0 +1,58 @@
+MIT License
+
+Copyright (c) 2026 Firecrawl
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Third-party notices
+===================
+
+Adobe CMaps
+-----------
+
+The WebAssembly binary embeds binary CMaps derived from Adobe CMap resources.
+
+Copyright 1990-2009 Adobe Systems Incorporated.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+Redistributions of source code must retain the above copyright notice, this
+list of conditions and the following disclaimer.
+
+Redistributions in binary form must reproduce the above copyright notice,
+this list of conditions and the following disclaimer in the documentation
+and/or other materials provided with the distribution.
+
+Neither the name of Adobe Systems Incorporated nor the names of its
+contributors may be used to endorse or promote products derived from this
+software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

wasm/README.md

@@ -0,0 +1,60 @@
+# @firecrawl/pdf-inspector-wasm
+
+Browser WebAssembly bindings for [pdf-inspector](https://github.com/firecrawl/pdf-inspector). Classify PDFs and extract structured Markdown locally from a `Uint8Array`, using the same Rust core as the native Node.js, Python, and Rust packages.
+
+## Install
+
+```bash
+npm install @firecrawl/pdf-inspector-wasm
+```
+
+## Usage
+
+```ts
+import init, { processPdf } from "@firecrawl/pdf-inspector-wasm";
+
+await init();
+
+const response = await fetch("/annual-report.pdf");
+const pdf = new Uint8Array(await response.arrayBuffer());
+const result = processPdf(pdf);
+
+console.log(result.pdfType);
+console.log(result.markdown);
+```
+
+Pass options when you need selected pages or compact Markdown:
+
+```ts
+const result = processPdf(pdf, {
+  pages: [1, 3, 5],
+  profile: "compact",
+  includePageMarkers: true,
+});
+```
+
+The package also exports:
+
+- `detectPdf(pdf, options?)` for detection without extraction.
+- `classifyPdf(pdf)` for the lightweight result shape shared with the native Node.js API.
+- `extractText(pdf)` for plain text.
+- `version()` for the WASM package version.
+
+## Browser behavior
+
+- Parsing runs locally. PDF bytes are not uploaded anywhere.
+- The build is single-threaded and does not require cross-origin isolation.
+- CMaps are embedded so CJK font decoding does not depend on a filesystem.
+- Extraction is synchronous after `init()`. For large documents, call it from a Web Worker to keep the UI responsive.
+- Image-only documents still require a separate OCR step.
+
+## Build from source
+
+```bash
+cargo install wasm-pack --version 0.15.0 --locked
+wasm-pack build wasm --target web --scope firecrawl --release
+```
+
+## License
+
+MIT

wasm/src/lib.rs

@@ -0,0 +1,440 @@
+use pdf_inspector::{
+    LayoutComplexity, MarkdownProfile, PageOcrReasons, PdfOptions, PdfProcessResult, PdfType,
+    ProcessMode,
+};
+use serde::{Deserialize, Serialize};
+use wasm_bindgen::prelude::*;
+
+#[wasm_bindgen(typescript_custom_section)]
+const TYPESCRIPT_TYPES: &str = r#"
+export type PdfType = "TextBased" | "Scanned" | "ImageBased" | "Mixed";
+export type MarkdownProfile = "fidelity" | "compact";
+
+export interface ProcessOptions {
+  /** Restrict extraction to these 1-indexed page numbers. */
+  pages?: number[];
+  /** Password for an encrypted PDF. */
+  password?: string;
+  /** Source-faithful output by default, or compact output for fewer tokens. */
+  profile?: MarkdownProfile;
+  /** Insert `<!-- Page N -->` markers between pages. */
+  includePageMarkers?: boolean;
+  /** Include image placeholders in Markdown output. */
+  includeImages?: boolean;
+}
+
+export interface PageOcrReasons {
+  /** 1-indexed page number. */
+  page: number;
+  reasons: string[];
+}
+
+export interface LayoutComplexity {
+  isComplex: boolean;
+  /** 1-indexed page numbers. */
+  pagesWithTables: number[];
+  /** 1-indexed page numbers. */
+  pagesWithColumns: number[];
+}
+
+export interface PdfProcessResult {
+  pdfType: PdfType;
+  markdown?: string;
+  pageCount: number;
+  processingTimeMs: number;
+  /** 1-indexed page numbers. */
+  pagesNeedingOcr: number[];
+  ocrReasonsByPage: PageOcrReasons[];
+  title?: string;
+  confidence: number;
+  layout: LayoutComplexity;
+  hasEncodingIssues: boolean;
+}
+
+export interface PdfClassification {
+  pdfType: PdfType;
+  pageCount: number;
+  /** 0-indexed page numbers, matching the native Node.js API. */
+  pagesNeedingOcr: number[];
+  confidence: number;
+}
+
+export function processPdf(data: Uint8Array, options?: ProcessOptions): PdfProcessResult;
+export function detectPdf(data: Uint8Array, options?: Pick<ProcessOptions, "password">): PdfProcessResult;
+export function classifyPdf(data: Uint8Array): PdfClassification;
+export function extractText(data: Uint8Array): string;
+export function version(): string;
+"#;
+
+#[derive(Debug, Default, Deserialize)]
+#[serde(default, rename_all = "camelCase", deny_unknown_fields)]
+struct WasmProcessOptions {
+    pages: Option<Vec<u32>>,
+    password: Option<String>,
+    profile: Option<WasmMarkdownProfile>,
+    include_page_markers: Option<bool>,
+    include_images: Option<bool>,
+}
+
+#[derive(Debug, Deserialize)]
+#[serde(rename_all = "lowercase")]
+enum WasmMarkdownProfile {
+    Fidelity,
+    Compact,
+}
+
+#[derive(Serialize)]
+#[serde(rename_all = "camelCase")]
+struct WasmPageOcrReasons {
+    page: u32,
+    reasons: Vec<String>,
+}
+
+impl From<PageOcrReasons> for WasmPageOcrReasons {
+    fn from(value: PageOcrReasons) -> Self {
+        Self {
+            page: value.page,
+            reasons: value.reasons,
+        }
+    }
+}
+
+#[derive(Serialize)]
+#[serde(rename_all = "camelCase")]
+struct WasmLayoutComplexity {
+    is_complex: bool,
+    pages_with_tables: Vec<u32>,
+    pages_with_columns: Vec<u32>,
+}
+
+impl From<LayoutComplexity> for WasmLayoutComplexity {
+    fn from(value: LayoutComplexity) -> Self {
+        Self {
+            is_complex: value.is_complex,
+            pages_with_tables: value.pages_with_tables,
+            pages_with_columns: value.pages_with_columns,
+        }
+    }
+}
+
+#[derive(Serialize)]
+#[serde(rename_all = "camelCase")]
+struct WasmPdfProcessResult {
+    pdf_type: &'static str,
+    markdown: Option<String>,
+    page_count: u32,
+    processing_time_ms: f64,
+    pages_needing_ocr: Vec<u32>,
+    ocr_reasons_by_page: Vec<WasmPageOcrReasons>,
+    title: Option<String>,
+    confidence: f64,
+    layout: WasmLayoutComplexity,
+    has_encoding_issues: bool,
+}
+
+impl From<PdfProcessResult> for WasmPdfProcessResult {
+    fn from(value: PdfProcessResult) -> Self {
+        Self {
+            pdf_type: pdf_type_name(value.pdf_type),
+            markdown: value.markdown,
+            page_count: value.page_count,
+            processing_time_ms: value.processing_time_ms as f64,
+            pages_needing_ocr: value.pages_needing_ocr,
+            ocr_reasons_by_page: value
+                .ocr_reasons_by_page
+                .into_iter()
+                .map(Into::into)
+                .collect(),
+            title: value.title,
+            confidence: value.confidence as f64,
+            layout: value.layout.into(),
+            has_encoding_issues: value.has_encoding_issues,
+        }
+    }
+}
+
+#[derive(Serialize)]
+#[serde(rename_all = "camelCase")]
+struct WasmPdfClassification {
+    pdf_type: &'static str,
+    page_count: u32,
+    pages_needing_ocr: Vec<u32>,
+    confidence: f64,
+}
+
+fn pdf_type_name(pdf_type: PdfType) -> &'static str {
+    match pdf_type {
+        PdfType::TextBased => "TextBased",
+        PdfType::Scanned => "Scanned",
+        PdfType::ImageBased => "ImageBased",
+        PdfType::Mixed => "Mixed",
+    }
+}
+
+fn js_error(context: &str, error: impl std::fmt::Display) -> JsValue {
+    js_sys::Error::new(&format!("{context}: {error}")).into()
+}
+
+fn deserialize_options(value: JsValue) -> Result<WasmProcessOptions, JsValue> {
+    if value.is_undefined() || value.is_null() {
+        return Ok(WasmProcessOptions::default());
+    }
+
+    serde_wasm_bindgen::from_value(value).map_err(|error| js_error("invalid options", error))
+}
+
+fn build_options(value: JsValue, mode: ProcessMode) -> Result<PdfOptions, JsValue> {
+    let options = deserialize_options(value)?;
+    if options
+        .pages
+        .as_ref()
+        .is_some_and(|pages| pages.contains(&0))
+    {
+        return Err(js_error(
+            "invalid options",
+            "pages are 1-indexed; page 0 is invalid",
+        ));
+    }
+
+    let mut result = PdfOptions::new().mode(mode);
+    if let Some(pages) = options.pages {
+        result = result.pages(pages);
+    }
+    if let Some(password) = options.password {
+        result = result.password(password);
+    }
+    if let Some(profile) = options.profile {
+        result.markdown.profile = match profile {
+            WasmMarkdownProfile::Fidelity => MarkdownProfile::Fidelity,
+            WasmMarkdownProfile::Compact => MarkdownProfile::Compact,
+        };
+    }
+    if let Some(include_page_markers) = options.include_page_markers {
+        result.markdown.include_page_numbers = include_page_markers;
+    }
+    if let Some(include_images) = options.include_images {
+        result.markdown.include_images = include_images;
+    }
+    Ok(result)
+}
+
+fn serialize<T: Serialize>(value: &T) -> Result<JsValue, JsValue> {
+    serde_wasm_bindgen::to_value(value).map_err(|error| js_error("serialize result", error))
+}
+
+fn initialize() {
+    console_error_panic_hook::set_once();
+}
+
+/// Process PDF bytes entirely inside WebAssembly.
+#[wasm_bindgen(js_name = processPdf, skip_typescript)]
+pub fn process_pdf(data: &[u8], options: JsValue) -> Result<JsValue, JsValue> {
+    initialize();
+    let options = build_options(options, ProcessMode::Full)?;
+    let started = js_sys::Date::now();
+    let mut result = pdf_inspector::process_pdf_mem_with_options(data, options)
+        .map_err(|error| js_error("process PDF", error))?;
+    result.processing_time_ms = (js_sys::Date::now() - started).max(0.0) as u64;
+    serialize(&WasmPdfProcessResult::from(result))
+}
+
+/// Classify PDF bytes without extracting text or producing Markdown.
+#[wasm_bindgen(js_name = detectPdf, skip_typescript)]
+pub fn detect_pdf(data: &[u8], options: JsValue) -> Result<JsValue, JsValue> {
+    initialize();
+    let options = build_options(options, ProcessMode::DetectOnly)?;
+    let started = js_sys::Date::now();
+    let mut result = pdf_inspector::process_pdf_mem_with_options(data, options)
+        .map_err(|error| js_error("detect PDF", error))?;
+    result.processing_time_ms = (js_sys::Date::now() - started).max(0.0) as u64;
+    serialize(&WasmPdfProcessResult::from(result))
+}
+
+/// Return the lightweight classification shape used by the native Node API.
+#[wasm_bindgen(js_name = classifyPdf, skip_typescript)]
+pub fn classify_pdf(data: &[u8]) -> Result<JsValue, JsValue> {
+    initialize();
+    let result =
+        pdf_inspector::classify_pdf_mem(data).map_err(|error| js_error("classify PDF", error))?;
+    serialize(&WasmPdfClassification {
+        pdf_type: pdf_type_name(result.pdf_type),
+        page_count: result.page_count,
+        pages_needing_ocr: result.pages_needing_ocr,
+        confidence: result.confidence as f64,
+    })
+}
+
+/// Extract plain text from PDF bytes without Markdown conversion.
+#[wasm_bindgen(js_name = extractText, skip_typescript)]
+pub fn extract_text(data: &[u8]) -> Result<String, JsValue> {
+    initialize();
+    let items = pdf_inspector::extractor::extract_text_with_positions_mem(data)
+        .map_err(|error| js_error("extract text", error))?;
+    Ok(
+        pdf_inspector::extractor::group_into_lines_preserving_all_text(items)
+            .into_iter()
+            .map(|line| line.text())
+            .filter(|line| !line.trim().is_empty())
+            .collect::<Vec<_>>()
+            .join("\n"),
+    )
+}
+
+/// Return the WebAssembly package version.
+#[wasm_bindgen(skip_typescript)]
+pub fn version() -> String {
+    env!("CARGO_PKG_VERSION").to_string()
+}
+
+#[cfg(all(test, target_arch = "wasm32"))]
+mod tests {
+    use super::*;
+    use js_sys::Reflect;
+    use wasm_bindgen_test::*;
+
+    const TEXT_PDF: &[u8] = include_bytes!("../../tests/fixtures/thermo-freon12.pdf");
+    const ENCRYPTED_PDF: &[u8] = include_bytes!("../../tests/fixtures/encrypted-secret123.pdf");
+
+    fn synthetic_korea1_pdf() -> Vec<u8> {
+        let mut pdf = b"%PDF-1.4\n".to_vec();
+        let mut offsets = vec![0usize];
+
+        fn add_object(pdf: &mut Vec<u8>, offsets: &mut Vec<usize>, id: usize, body: &str) {
+            offsets.push(pdf.len());
+            pdf.extend_from_slice(format!("{id} 0 obj\n").as_bytes());
+            pdf.extend_from_slice(body.as_bytes());
+            pdf.extend_from_slice(b"\nendobj\n");
+        }
+
+        add_object(
+            &mut pdf,
+            &mut offsets,
+            1,
+            "<< /Type /Catalog /Pages 2 0 R >>",
+        );
+        add_object(
+            &mut pdf,
+            &mut offsets,
+            2,
+            "<< /Type /Pages /Kids [3 0 R] /Count 1 >>",
+        );
+        add_object(
+            &mut pdf,
+            &mut offsets,
+            3,
+            "<< /Type /Page /Parent 2 0 R /MediaBox [0 0 200 200] /Resources << /Font << /F0 5 0 R >> >> /Contents 4 0 R >>",
+        );
+
+        // Adobe-Korea1 CID 1086 (0x043E) maps to U+AC00 (Korean syllable GA).
+        // There is deliberately no ToUnicode stream: decoding must use the
+        // embedded predefined CMap rather than lopdf's plain-text fallback.
+        // Korea1 CIDs 21 and 19 map to ASCII "4" and "2". Place them near
+        // the bottom edge so they look exactly like a numeric page footer.
+        let content = "BT /F0 12 Tf 50 100 Td <043E> Tj 0 -60 Td <00150013> Tj ET";
+        add_object(
+            &mut pdf,
+            &mut offsets,
+            4,
+            &format!(
+                "<< /Length {} >>\nstream\n{}\nendstream",
+                content.len(),
+                content
+            ),
+        );
+        add_object(
+            &mut pdf,
+            &mut offsets,
+            5,
+            "<< /Type /Font /Subtype /Type0 /BaseFont /SyntheticKorea1 /Encoding /Identity-H /DescendantFonts [6 0 R] >>",
+        );
+        add_object(
+            &mut pdf,
+            &mut offsets,
+            6,
+            "<< /Type /Font /Subtype /CIDFontType2 /BaseFont /SyntheticKorea1 /CIDSystemInfo << /Registry (Adobe) /Ordering (Korea1) /Supplement 2 >> /FontDescriptor 7 0 R /DW 1000 >>",
+        );
+        add_object(
+            &mut pdf,
+            &mut offsets,
+            7,
+            "<< /Type /FontDescriptor /FontName /SyntheticKorea1 /Flags 4 /FontBBox [-100 -200 1000 900] /ItalicAngle 0 /Ascent 800 /Descent -200 /CapHeight 700 /StemV 80 >>",
+        );
+
+        let xref_start = pdf.len();
+        pdf.extend_from_slice(format!("xref\n0 {}\n", offsets.len()).as_bytes());
+        pdf.extend_from_slice(b"0000000000 65535 f \n");
+        for offset in offsets.iter().skip(1) {
+            pdf.extend_from_slice(format!("{offset:010} 00000 n \n").as_bytes());
+        }
+        pdf.extend_from_slice(
+            format!(
+                "trailer\n<< /Size {} /Root 1 0 R >>\nstartxref\n{}\n%%EOF",
+                offsets.len(),
+                xref_start
+            )
+            .as_bytes(),
+        );
+        pdf
+    }
+
+    #[wasm_bindgen_test]
+    fn processes_pdf_to_markdown() {
+        let result = process_pdf(TEXT_PDF, JsValue::UNDEFINED).expect("process PDF");
+        let pdf_type = Reflect::get(&result, &JsValue::from_str("pdfType"))
+            .expect("pdfType")
+            .as_string()
+            .expect("pdfType string");
+        let markdown = Reflect::get(&result, &JsValue::from_str("markdown"))
+            .expect("markdown")
+            .as_string()
+            .expect("markdown string");
+
+        assert_eq!(pdf_type, "TextBased");
+        assert!(!markdown.is_empty());
+    }
+
+    #[wasm_bindgen_test]
+    fn rejects_non_pdf_bytes() {
+        assert!(process_pdf(b"not a PDF", JsValue::UNDEFINED).is_err());
+    }
+
+    #[wasm_bindgen_test]
+    fn classifies_and_extracts_plain_text() {
+        let classification = classify_pdf(TEXT_PDF).expect("classify PDF");
+        let pdf_type = Reflect::get(&classification, &JsValue::from_str("pdfType"))
+            .expect("pdfType")
+            .as_string()
+            .expect("pdfType string");
+        let text = extract_text(TEXT_PDF).expect("extract text");
+
+        assert_eq!(pdf_type, "TextBased");
+        assert!(!text.is_empty());
+    }
+
+    #[wasm_bindgen_test]
+    fn extracts_cjk_and_preserves_numeric_page_footer() {
+        let text = extract_text(&synthetic_korea1_pdf()).expect("extract predefined CMap text");
+
+        assert_eq!(text, "가\n42");
+    }
+
+    #[wasm_bindgen_test]
+    fn opens_encrypted_pdf_with_password() {
+        assert!(process_pdf(ENCRYPTED_PDF, JsValue::UNDEFINED).is_err());
+
+        let options = js_sys::Object::new();
+        Reflect::set(
+            &options,
+            &JsValue::from_str("password"),
+            &JsValue::from_str("secret123"),
+        )
+        .expect("set password");
+        let result = process_pdf(ENCRYPTED_PDF, options.into()).expect("process encrypted PDF");
+        let markdown = Reflect::get(&result, &JsValue::from_str("markdown"))
+            .expect("markdown")
+            .as_string()
+            .expect("markdown string");
+
+        assert!(!markdown.is_empty());
+    }
+}