Merge pull request #128 from wasmerio/docs-update-1000091c-9892-4479-be26-e4f7f4963386-20250422-143151

docs: Add WebAssembly profiling feature documentation

Author: syrusakbary

pages/runtime/cli.mdx

@@ -59,6 +59,18 @@ You can also pass environment variables:
 wasmer run my_wasi_program.wasm --env MYVAR=MYVALUE -- arg1 arg2 arg3
 ```
 
+### Profiling WebAssembly Code
+
+You can enable profiling data generation for your WebAssembly code using the `--profiler` option:
+
+```bash copy
+wasmer run my_program.wasm --profiler=perfmap
+```
+
+This generates profiling information in the [perfmap format](https://github.com/torvalds/linux/blob/master/tools/perf/Documentation/jit-interface.txt), which can be used with Linux perf tools to analyze the performance of your WebAssembly code. The profiler data is written to `/tmp/perf-{PID}.map`.
+
+This option is available for the Cranelift, LLVM, and Singlepass compiler backends.
+
 
 ## Help
 
@@ -135,6 +147,14 @@ Options:
           
           Available for cranelift, LLVM and singlepass.
 
+      --profiler <PROFILER>
+          Enable a profiler.
+          
+          Available for cranelift, LLVM and singlepass.
+          
+          Possible values:
+          - perfmap: Generate profiling data in perfmap format
+
       --llvm-debug-dir <LLVM_DEBUG_DIR>
           LLVM debug directory, where IR and object files will be written to.
           
@@ -277,4 +297,4 @@ Options:
 
   -h, --help
           Print help (see a summary with '-h')
-```
+```

pages/runtime/features.mdx

@@ -31,6 +31,7 @@ Each of this backends support different features, and have different support for
 ### Wasmer features
   - **Caching**: compiled WebAssembly modules can be reused so subsequent runs of a Wasm file will have very little start up time;
   - **Metering**: computation time and other resources can be monitored and limits set to control how the Wasm code runs. This is also known as "gas metering";
+  - **Profiling**: generate profiling data for WebAssembly code to analyze performance using tools like Linux perf;
 
 ## Support of features by backend
 
@@ -58,6 +59,7 @@ Wasmer features:
 | -------- | ---------- | --------- | ---- | -- | ----- | -------------- | ------- |
 | Caching  | ✅         | ✅        | ✅   | ❌  | ❌     | ❌             | ❌      |
 | Metering | ✅         | ✅        | ✅   | ❌  | ❌     | ❌             | ❌      |
+| Profiling| ✅         | ✅        | ✅   | ❌  | ❌     | ❌             | ❌      |
 
 
 ## Backend support by Operating System
@@ -76,10 +78,10 @@ Wasmer features:
 
 |                | x86_64 | arm64 | x86 | RISC-V 64-bit | RISC-V 32-bit |
 | -------------- | ------ | ----- | --- | ------------- | ------------- |
-| Cranelift      | ✅     | ✅    | ✅  | ✅            | ✅            |
+| Cranelift      | ✅     | ✅    | ✅  | ✅            | ❌            |
 | LLVM           | ✅     | ✅    | ✅  | ✅            | ✅            |
-| Singlepass     | ✅     | ✅    | ❌  | ❌            | ❌            |
+| Singlepass     | ✅     | ✅    | ❌  | ⏰            | ⏰            |
 | V8             | ✅     | ✅    | ✅  | ✅            | ✅            |
 | Wasmi          | ✅     | ✅    | ✅  | ✅            | ✅            |
-| JavascriptCore | ✅     | ✅    | ✅  | ❌            | ❌            |
-| Browser        | ✅     | ✅    | ✅  | ✅            | ✅            |
+| JavascriptCore | ✅     | ✅    | ❌  | ❌            | ❌            |
+| Browser        | ✅     | ✅    | ✅  | ✅            | ✅            |