blocky-writer is a Mozilla Firefox extension for block-based PDF form filling.

Stack

• Extension UI: ReScript + React

• Background/content scripts: ReScript

• Core processing: Rust compiled to WebAssembly (WASM)

• Local storage: IndexedDB

Repo Layout

• src/ — ReScript sources for popup UI, background script, content script, and core modules

• public/ — static extension files (manifest.json, popup HTML, icons)

• rust/pdftool_core/ — Rust WASM crate for block detection and PDF operations

• scripts/ — build helpers for WASM and extension bundles

Quick Start

1. Install dependencies (Deno-first):

   deno install

1. Build ReScript output and bundle extension assets:

   deno task build

1. Build the Rust WASM package:

   deno task build:wasm

1. Run the extension in Firefox via web-ext:

   deno task dev

1. Run core fill fixture tests (error taxonomy + AcroForm writeback):

   deno task test:core-fill

Notes

• Rust fill_blocks now performs AcroForm-aware writeback for text/select and button widgets, and emits structured taxonomy errors (code, message, context).

• Popup/background/content surfaces preserve taxonomy codes from the Rust WASM boundary.

• Source files include SPDX headers targeting MPL-2.0.

Firefox Troubleshooting

• If deno task dev fails with ECONNREFUSED 127.0.0.1:<port>, verify Firefox is installed and runnable.

• Close stale Firefox instances launched by prior web-ext sessions, then retry deno task dev.

• You can run web-ext directly with an explicit binary when needed:

  deno run -A npm:web-ext run --source-dir dist --firefox /usr/bin/firefox

Architecture

See TOPOLOGY for a visual architecture map and completion dashboard.

Wondering how this works? See EXPLAINME.adoc.

License

SPDX-License-Identifier: CC-BY-SA-4.0
See LICENSE.