import { useSyncExternalStore } from 'react' import glueUrl from '@faunosteo/core-wasm/pkg/faunosteo_wasm.js?url' import wasmUrl from '@faunosteo/core-wasm/pkg/faunosteo_wasm_bg.wasm?url' import { CoreRuntime, type CoreSource, type GlueModule, } from '@faunosteo/core-wasm' /** * The application's core runtime (Rust compiled to WebAssembly, R2). Vite emits the glue * and the `.wasm` as hashed assets that no route chunk imports: nothing is fetched until a * sheet path or an import asks `ready()` (review III.3 rule 6). The production CSP must * carry `'wasm-unsafe-eval'` (DEPLOY.md); without it the load fails and the editor shows * the degraded state. */ async function compileModule(): Promise { const response = await fetch(wasmUrl) if (!response.ok) throw new Error(`core module HTTP ${response.status}`) try { // Needs `Content-Type: application/wasm`; any other type falls back to bytes. return await WebAssembly.compileStreaming(response.clone()) } catch { return WebAssembly.compile(await response.arrayBuffer()) } } const browserSource: CoreSource = { compile: compileModule, // A distinct query per instance gives a new glue module record (R0 finding). importGlue: (instance) => import(/* @vite-ignore */ `${glueUrl}?instance=${instance}`) as Promise, } let runtime: CoreRuntime | null = null /** Whether the page's runtime spent its recoveries (never creates the runtime). */ export function coreStopped(): boolean { return runtime?.stopped ?? false } /** Subscribes to the runtime's status changes (stable identity for `useSyncExternalStore`). */ export function subscribeCore(listener: () => void): () => void { return coreRuntime().subscribe(listener) } /** Whether the engine stopped for good on this page; re-renders when it does. */ export function useCoreStopped(): boolean { return useSyncExternalStore(subscribeCore, coreStopped) } /** The page's runtime, created on first use. */ export function coreRuntime(): CoreRuntime { runtime ??= new CoreRuntime(browserSource) return runtime } /** Test seam: run the application on another runtime (the Node source in vitest). */ export function setCoreRuntime(next: CoreRuntime): void { runtime = next }