Protocol v1 (task → ready → result | failed with phase and kind), the worker entry with the glue bundled statically and the page's compiled Module posted, the file streamed into the module's memory; client with start and task timers (paused while hidden), settle-once, terminate always, error events never masked; module-level controller (one import at a time, cancel on leaving Home, worker chunk prefetched once the engine is loaded); the settlement mapped to the B.1.8 messages (OD-5: a trap, a timeout or an unreadable file is « Erreur de lecture du PDF. », never a corrupt PDF). HomeRoute keeps its routing and size pre-checks, loads its own index after acceptance, drops a result when the session changed. Tests: handler and client in-process, the corpus message test (O8 51, O7 stored inputs, O2/O3/Step 5), the six existing suites migrated to the real worker logic.
packages/
Shared code lives here once it has a real owner and real content: an empty
package would only add build configuration to maintain (IMPLEMENTATION_PLAN.md
Step 2, FRONTEND_ARCHITECTURE.md §6). First package: supabase/ (Step 3).
Planned packages and the step that creates each one:
| Package | Content | Created at |
|---|---|---|
@faunosteo/domain |
Zod schemas: anatomical sheet document + integrity rules (created, Step 4); report document, entitlement capabilities later | Step 4 (sheet model) |
@faunosteo/anatomy |
legacy importer (created, Step 4b), curation pipeline: changeset → working draft + report migration map (created, Steps 4c/5), pure annotation-layer renderer @faunosteo/anatomy/render (created, Step 5; since R3 used by the PDF engine and the pipeline only, the app canvas draws the Rust core's composition) |
Step 4b (importer) |
@faunosteo/pdf |
browser-free PDF engine (created, Step 6): report archive export from explicit inputs (report, sheet snapshot, branding, labels, rasterizer), layered archive reading, SVG sanitiser, page renderers | Step 6 (PDF archives) |
@faunosteo/i18n |
FR/EN dictionaries (no React) + useT |
first second consumer (public-web or worker) |
@faunosteo/supabase |
browser client factory, generated database types, PGlite harness running the pgTAP suite, sheet publish gate | created, Step 3 |
@faunosteo/core-wasm |
the Rust core compiled to WebAssembly: CoreRuntime (lazy load, poison on a trap, offline re-instantiation, sheet handles per instance), Node source, pkg/ shipped and pkg-proofs/ (built by pnpm wasm:build, git-ignored, BUILD_STAMP), TypeScript types of the contracts generated by ts-rs (committed), the frozen N-1 Zod reader (./n-1), the trap, size and measurement tests |
created, R0; runtime and app consumers R2 |
Since R2 the Rust core (crates/core) holds the business logic domain held
for the application (docs/development/RUST.md §8); domain stays frozen
for the PDF engine, the pipeline and the compare CLI. Since R3 the core also
holds the SVG reader, the annotation layer and the view composition the editor
canvas draws (RUST.md §9); anatomy/render stays frozen for the engine and the
pipeline. pdf follows at R4 (docs/development/RUST_ARCHITECTURE_REVIEW.md Part
VI); each TypeScript package is deleted in the phase that switches its last
consumer (domain and anatomy at R5, pdf at R4).
| @faunosteo/config | runtime config resolution shared by app, public-web, worker | with public-web |
| @faunosteo/ui | UI primitives and design tokens | only when public-web reuses them |
Convention: a package has its own package.json (name, exports, types),
tsconfig.json extending the root one, and tests beside its sources.