Webaudio audioworklet module to run mimium code on web browser.

https://mimium.org

The main entrypoint of compiler on web platform is mimium-web, which is directory exported from Rust code using wasm-pack.

The reason to split package for audioworklet module is because wasm-pack is not fully compatible with WebAudio AudioWorklet and need to write some wrapper code to load wasm modules.

npm install @mimium/mimium-webaudio

import {
	preloadMimiumLibCache,
	setupMimiumAudioWorklet,
} from "@mimium/mimium-webaudio";
import processorUrl from "@mimium/mimium-webaudio/dist/audioprocessor.mjs?url";

const ctx = new AudioContext();

const src = `
fn dsp(){
	0.0
}
`;

await preloadMimiumLibCache({
	libBaseUrl: "https://raw.githubusercontent.com/mimium-org/mimium-rs/dev/lib/",
});

const node = await setupMimiumAudioWorklet(ctx, src, processorUrl);
node.connect(ctx.destination);

setupMimiumAudioWorklet returns MimiumProcessorNode (AudioWorkletNode).

preloadMimiumLibCache(options?: {
	libBaseUrl?: string;
}): Promise<void>

setupMimiumAudioWorklet(
	ctx: AudioContext,
	src: string,
	MimiumProcessorUrl: string,
	options?: {
		libBaseUrl?: string;
		moduleBaseUrl?: string;
	}
): Promise<MimiumProcessorNode>

• libBaseUrl: Base URL for standard mimium libraries (default: https://raw.githubusercontent.com/mimium-org/mimium-rs/main/lib/).
• moduleBaseUrl: Base URL for user modules resolved by mod / include (default: current page base URL).

For code that uses standard library modules (use osc::sinwave, etc.), calling preloadMimiumLibCache before setupMimiumAudioWorklet is recommended.

• Compilation and library/module fetch are done on the main thread.
• AudioWorklet uses preloaded virtual file cache and does not fetch files directly.

npx playwright install chromium
npx playwright test tests/compile.spec.ts

This test opens a browser page, creates AudioContext + AudioWorklet, compiles a mimium source, and verifies compile completion.