Maintenance Guide

A plugin for rolldown-vite that provides a fallback error message for .wasm files, ported from Vite's wasmPlugin.

This plugin is exclusive to rolldown-vite and is not recommended for external use.

📦 What it does

This plugin intercepts all imports ending in .wasm and throws an informative error.

Since native ESM integration for WebAssembly is not yet supported, this plugin reminds users to use community plugins or explicit suffixes such as ?init or ?url.

🚀 Debug Usage

import { defineConfig } from 'rolldown';
import { wasmFallbackPlugin } from 'rolldown/experimental';

export default defineConfig({
  input: {
    entry: './main.ts',
  },
  plugins: [wasmFallbackPlugin()],
});