small docs and compilation changes

packages/wasm_packages/image_rs/example/image_rs_example.dart

@@ -1,6 +1,6 @@
-import 'package:image_rs/image_rs.dart';
+// import 'package:image_rs/image_rs.dart';
 
 void main() {
-  var awesome = Awesome();
-  print('awesome: ${awesome.isAwesome}');
+  // var awesome = Awesome();
+  // print('awesome: ${awesome.isAwesome}');
 }

packages/wasm_packages/image_rs/lib/src/image_rs_base.dart

@@ -1,6 +1,43 @@
-// TODO: Put public facing types in this file.
+import 'package:wasm_run/load_module.dart';
+import 'package:wasm_run/wasm_run.dart';
+import 'package:image_rs/src/image_rs_wit.gen.dart';
 
-/// Checks if you are awesome. Spoiler: you are.
-class Awesome {
-  bool get isAwesome => true;
+export 'package:image_rs/src/image_rs_wit.gen.dart';
+
+/// Creates a [ImageRsWorld] with the given [wasiConfig].
+/// It setsUp the dynamic library for wasm_run in native platforms and
+/// loads the image_rs WASM module from the file system or
+/// from the url pointing to 'lib/image_rs_wasm.wasm'.
+///
+/// If [loadModule] is provided, it will be used to load the WASM module.
+/// This can be useful if you want to provide a different configuration
+/// or implementation, or you are loading it from Flutter assets or
+/// from a different HTTP endpoint. By default, it will load the WASM module
+/// from the file system in `lib/image_rs_wasm.wasm` either reading it directly
+/// in native platforms or with a GET request for Dart web.
+Future<ImageRsWorld> createImageRs({
+  required WasiConfig wasiConfig,
+  Future<WasmModule> Function()? loadModule,
+  WorkersConfig? workersConfig,
+}) async {
+  await WasmRunLibrary.setUp(override: false);
+
+  final WasmModule module;
+  if (loadModule != null) {
+    module = await loadModule();
+  } else {
+    final uri = await WasmFileUris.uriForPackage(
+      package: 'image_rs',
+      libPath: 'image_rs_wasm.wasm',
+      envVariable: 'IMAGE_RS_WASM_PATH',
+    );
+    final uris = WasmFileUris(uri: uri);
+    module = await uris.loadModule();
+  }
+  final builder = module.builder(
+    wasiConfig: wasiConfig,
+    workersConfig: workersConfig,
+  );
+
+  return ImageRsWorld.init(builder, imports: const ImageRsWorldImports());
 }

packages/wasm_packages/image_rs/test/image_rs_test.dart

@@ -1,16 +1,16 @@
-import 'package:image_rs/image_rs.dart';
+// import 'package:image_rs/image_rs.dart';
 import 'package:test/test.dart';
 
 void main() {
   group('A group of tests', () {
-    final awesome = Awesome();
+    // final awesome = Awesome();
 
     setUp(() {
       // Additional setup goes here.
     });
 
     test('First Test', () {
-      expect(awesome.isAwesome, isTrue);
+      // expect(awesome.isAwesome, isTrue);
     });
   });
 }

packages/wasm_packages/rust_crypto/lib/rust_crypto.dart

@@ -14,7 +14,7 @@ export 'package:wasm_run/wasm_run.dart';
 
 const _isWeb = identical(0, 0.0);
 
-/// Creates a [DartWitGeneratorWorld] from for the given [wasiConfig].
+/// Creates a [RustCryptoWorld] with the given [wasiConfig].
 /// It setsUp the dynamic library for wasm_run for native platforms and
 /// loads the dart_wit_component WASM module from the file system or
 /// from the releases of wasm_run repository.

packages/wasm_run/lib/src/wasm_bindings/wasm_interface.dart

@@ -40,7 +40,11 @@ export 'package:wasm_run/src/int64_bigint/int64_bigint.dart';
 abstract class WasmModule {
   /// A builder that creates a new [WasmInstance] from this module.
   /// It configures the imports and definitions of the instance.
-  /// [wasiConfig] is not supported in the browser executor.
+  /// [wasiConfig] is used to configure WASI imports, environment variables,
+  /// arguments and the file system access.
+  /// [workersConfig] is used to configure the number of workers and the
+  /// web worker script url. The module should support atomics, threads and
+  /// shared memory to be able to use workers.
   WasmInstanceBuilder builder({
     WasiConfig? wasiConfig,
     WorkersConfig? workersConfig,