Паттерн
Rust-крейт, скомпилированный в wasm-модуль на 20 КБ, закоммиченный в репозиторий и загружаемый без единого Vite-плагина. Dev-контейнеру никогда не нужен Rust-тулчейн: одноразовый контейнер-сборщик компилирует крейт, а сгенерированный glue-код и бинарник коммитятся как обычный исходный код.
Ядро
Пиксели живут в линейной памяти wasm. JS записывает их через представление один раз, вызовы фильтров пересекают границу с двумя скалярами, а vitest-гейт паритета держит реализации на Rust и JS байт-в-байт идентичными.
#[wasm_bindgen]
pub struct PixelKernel {
width: u32,
height: u32,
pixels: Vec<u8>, // JS writes through a view over pixels_ptr() — once
scratch: Vec<u8>, // preallocated: no filter call may grow wasm memory
}
#[wasm_bindgen]
impl PixelKernel {
/// Filter calls cross the boundary with two scalars, never with the frame.
pub fn box_blur(&mut self, radius: u32) { /* (2r+1)² taps per pixel */ }
pub fn grayscale(&mut self) { /* Rec.601 integer luma */ }
}Сборка
Один скрипт на хосте, один эфемерный Rust-контейнер, артефакты в коммите. Воспроизводимость закреплена образом сборщика, запинованным по digest, rust-toolchain.toml и Cargo.lock — а закоммиченный манифест сборки красит гейт в красный, если исходники и артефакты разошлись.
# scripts/wasm/build.sh — the v10r container stays Rust-free
RUST_IMAGE="docker.io/library/rust:1.97-slim@sha256:8e8cf8…" # digest-pinned
podman run --rm -v "$PWD:/work" -w /work/crates/kernel "$RUST_IMAGE" bash -c '
cargo build --release --target wasm32-unknown-unknown
wasm-bindgen --target web --out-dir /work/src/lib/wasm/kernel \
target/wasm32-unknown-unknown/release/v10r_kernel.wasm'
# kernel.js + kernel_bg.wasm (+ .d.ts) are COMMITTED, plus build-manifest.json:
# sha256 of sources and artifacts — a vitest gate recomputes them, so a Rust
# edit without a rebuild goes red. `bun run validate` never needs Rust.Загрузчик
?url плюс явный вызов init обходит все известные расхождения dev-против-build для wasm в Vite и SvelteKit — без wasm-плагина, без top-level await, ничего не исполняется при SSR.
import wasmUrl from './kernel/kernel_bg.wasm?url';
let ready: Promise<Kernel> | null = null;
export function loadKernel(): Promise<Kernel> {
// ?url + explicit init: no Vite wasm plugins, no top-level await (broken
// under Svelte 5 — sveltejs/kit#13015), nothing executed during SSR, and
// the binary ships as a hashed immutable asset.
if (!ready) {
ready = import('./kernel/kernel.js').then(async (mod) => {
const out = await mod.default({ module_or_path: wasmUrl });
return { mod, memory: out.memory };
});
}
return ready;
}