@stll/scan-engine 0.1.1 → 0.1.2

package/README.md

@@ -119,4 +119,16 @@ bun run build:wasm && bun run check:wasm --check
 ```
 
 Generated bindings in `generated/` are committed and ship in the package next
-to `dist/`.
+to `dist/`. CI requires them byte for byte, so `build:wasm` runs only on x86_64
+Linux with the Rust version in `rust-toolchain.toml`. On any other host (macOS,
+ARM64 Linux), run `bun run build:wasm:container`: it runs the same script in
+the official `linux/amd64` Rust image pinned by digest, through Docker or a
+compatible runtime such as OrbStack. Crates, the `wasm-bindgen` CLI and the
+build cache stay in Docker volumes, never in the host's `~/.cargo`. A cold run
+compiles `wasm-bindgen` under emulation and takes several minutes.
+
+Update crates with `bun run cargo:update --manifest-path
+packages/scan-engine/Cargo.toml <crate>` from the repository root, never with a
+bare `cargo update`: it keeps every new pin out of the release-age quarantine
+that CI enforces on `Cargo.lock`. `deny.toml` is the crate's `cargo deny`
+policy (licenses, bans, sources and advisories).

package/dist/review.d.ts

@@ -1,6 +1,5 @@
 import { CleanScanResult, PhysicalPageSize, RasterizedScanPage, ScanEngine, ScanEngineError, ScanOptions, ScanPageRotation } from "./types.js";
 import { Result } from "better-result";
-//#region src/review.d.ts
 type CleanedScan = Extract<CleanScanResult, {
   type: "cleaned";
 }>;
@@ -47,5 +46,4 @@ export type TargetPageBox = PhysicalPageSize & {
   rotation: ScanPageRotation;
 };
 export declare const targetPageBox: (pageSize: PhysicalPageSize, rotation: ScanPageRotation) => TargetPageBox;
-//#endregion
 export {};

package/dist/review.js

@@ -1,5 +1,5 @@
 import { Result, panic } from "better-result";
-//#region src/review.ts
+// src/review.ts
 const reviewPage = async ({ engine, pageId, page, options }) => {
 	const result = await engine.clean(page, options);
 	if (result.isErr()) return Result.err(result.error);
@@ -78,5 +78,4 @@ const targetPageBox = (pageSize, rotation) => ({
 	heightPoints: pageSize.heightPoints,
 	rotation
 });
-//#endregion
 export { applyAll, applyOne, createCleanScanReview, rejectOne, reviewPage, setPageReview, targetPageBox, undoCleanScanReview };

package/dist/scan-engine.d.ts

@@ -1,5 +1,4 @@
 import { RasterizedScanPage, ScanEngine, ScanOptions } from "./types.js";
-//#region src/worker-protocol.d.ts
 type SerializedWasmResult = {
   status: string;
   reason: string;
@@ -25,8 +24,6 @@ type WorkerResponse = {
   errorType: "runtime-trap" | "failure";
   message: string;
 };
-//#endregion
-//#region src/scan-engine.d.ts
 type WasmScanResult = {
   free: () => void;
   readonly status: string;
@@ -54,5 +51,4 @@ type WorkerEngineOptions = {
 };
 export declare const createScanEngine: (load?: WasmLoader, workerOptions?: WorkerEngineOptions) => ScanEngine;
 export declare const scanEngine: ScanEngine;
-//#endregion
 export {};

package/dist/scan-engine.js

@@ -3,7 +3,7 @@ import { Result } from "better-result";
 import { fetchWithTimeout } from "@stll/fetch";
 import { readBodyWithIdleDeadline } from "@stll/fetch/body-reader";
 import { clean_scan_rgba, initSync } from "../generated/scan_engine.js";
-//#region src/scan-engine.ts
+// src/scan-engine.ts
 const WASM_LOAD_TIMEOUT_MS = 1e4;
 const WORKER_REQUEST_TIMEOUT_MS = 1e4;
 const loadWasmBindings = async () => {
@@ -220,5 +220,4 @@ const createScanEngine = (load, workerOptions) => {
 	}) };
 };
 const scanEngine = createScanEngine();
-//#endregion
 export { createScanEngine, scanEngine };

package/dist/scan-engine.worker.js

@@ -1,7 +1,7 @@
 import { fetchWithTimeout } from "@stll/fetch";
 import { readBodyWithIdleDeadline } from "@stll/fetch/body-reader";
 import initWasm, { clean_scan_rgba } from "../generated/scan_engine.js";
-//#region src/scan-engine.worker.ts
+// src/scan-engine.worker.ts
 const WASM_LOAD_TIMEOUT_MS = 1e4;
 const post = (response, transfer = []) => {
 	Reflect.apply(postMessage, globalThis, [response, transfer]);
@@ -58,4 +58,3 @@ addEventListener("message", (event) => {
 		});
 	});
 });
-//#endregion

package/dist/types.d.ts

@@ -1,5 +1,4 @@
 import { Result } from "better-result";
-//#region src/types.d.ts
 export type ScanPageRotation = 0 | 90 | 180 | 270;
 export type PhysicalPageSize = {
   widthPoints: number;
@@ -69,5 +68,4 @@ export declare class ScanEngineError extends ScanEngineError_base<{
 export type ScanEngine = {
   clean: (page: RasterizedScanPage, options: ScanOptions) => Promise<Result<CleanScanResult, ScanEngineError>>;
 };
-//#endregion
 export {};

package/dist/types.js

@@ -1,5 +1,4 @@
 import { TaggedError } from "better-result";
-//#region src/types.ts
+// src/types.ts
 var ScanEngineError = class extends TaggedError("ScanEngineError") {};
-//#endregion
 export { ScanEngineError };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/scan-engine",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Document scan cleanup engine (Rust, WebAssembly): deskew, content crop and binarization off the main thread, plus a per-page review state machine",
   "keywords": [
     "binarization",
@@ -56,6 +56,7 @@
     "lint:fix": "cd ../.. && bun --bun oxlint -c oxlint.config.ts --type-aware --fix packages/scan-engine",
     "format:rust": "cargo fmt",
     "build:wasm": "bash scripts/build-wasm.sh",
+    "build:wasm:container": "bash scripts/build-wasm-container.sh",
     "check:wasm": "bun --preload ../../scripts/offline-network-preload.ts scripts/check-wasm.ts",
     "generate:fixtures": "bun scripts/generate-fixtures.ts",
     "check:fixtures": "bun scripts/generate-fixtures.ts --check",