tweaks

Author: gfx

.claude/skills/wasm/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: wasm
 description: |
-  Modern WebAssembly (WASM) development expertise covering WASM 3.0 features
+  Modern WebAssembly (Wasm) development expertise covering modern Wasm features
   and optimization techniques. Use this skill when working with WebAssembly
-  modules, optimizing WASM performance, or integrating WASM with JavaScript/TypeScript.
+  modules or optimizing Wasm performance.
 compatibility: WebAssembly v3.0 and later
 ---
 
@@ -23,7 +23,7 @@ local.get $y
 i32.add
 ```
 
-## WebAssembly 3.0 Features
+## WebAssembly Features
 
 ### Memory64 (64-bit Address Space)
 - Memories and tables use `i64` as address type
@@ -62,6 +62,21 @@ i32.add
 - Hardware-dependent SIMD optimizations beyond fixed-width 128-bit
 - `i8x16.relaxed_swizzle`, `f32x4.relaxed_madd`, etc.
 
+### WasmGC
+- Native garbage-collected types: `struct`, `array`
+- Instructions: `array.new`, `array.get`, `array.set`, `struct.new`, `struct.get`
+- Reference types: `(ref $type)`, `(ref null $type)`
+
+### externref
+- Opaque reference to host (JS) objects
+- Cannot be inspected or modified in Wasm, only passed around
+- Used with js-string-builtins for efficient string handling
+
+### js-string-builtins
+- Import `"wasm:js-string"` for direct JS string operations
+- Functions: `length`, `charCodeAt`, `fromCharCodeArray`, `intoCharCodeArray`
+- Avoids costly JS↔Wasm boundary crossings for string processing
+
 ### SIMD Example
 ```wat
 ;; Process 16 bytes at a time
@@ -75,26 +90,11 @@ i32.add
 
 | Task | Command |
 |------|---------|
-| Assemble WAT to WASM | `wasm-as module.wat -o module.wasm` |
-| Disassemble WASM to WAT | `wasm-dis module.wasm -o module.wat` |
+| Assemble WAT to Wasm | `wasm-as module.wat -o module.wasm` |
+| Disassemble Wasm to WAT | `wasm-dis module.wasm -o module.wat` |
 | Optimize for size | `wasm-opt -Oz in.wasm -o out.wasm` |
 | Optimize for speed | `wasm-opt -O3 in.wasm -o out.wasm` |
 
-## JavaScript/TypeScript Integration
-
-### Instantiation
-```typescript
-const module = await WebAssembly.compileStreaming(fetch('module.wasm'));
-const instance = await WebAssembly.instantiate(module, imports);
-```
-
-### Memory Access
-```typescript
-const memory = new WebAssembly.Memory({ initial: 1, maximum: 100 });
-const buffer = new Uint8Array(instance.exports.memory.buffer);
-buffer.set(data, offset);
-```
-
 ## Resources
 
 - [WebAssembly Specification](https://webassembly.github.io/spec/)

src/utils/utf8-wasm-binary.ts

@@ -6,18 +6,18 @@ AGFzbQEAAAABNQhedwFgAW8Bf2ACb38Bf2ADb2QAfwF/YANkAH9/AWRvYAJ/ZAABf2ABfwFkAGADZA
 B/fwFvAnsEDndhc206anMtc3RyaW5nBmxlbmd0aAABDndhc206anMtc3RyaW5nCmNoYXJDb2RlQXQA
 Ag53YXNtOmpzLXN0cmluZxFpbnRvQ2hhckNvZGVBcnJheQADDndhc206anMtc3RyaW5nEWZyb21DaG
 FyQ29kZUFycmF5AAQDBgUBAgUGBwUDAQABB1QGBm1lbW9yeQIACXV0ZjhDb3VudAAECnV0ZjhFbmNv
-ZGUABRF1dGY4RGVjb2RlVG9BcnJheQAGCmFsbG9jQXJyYXkABw1hcnJheVRvU3RyaW5nAAgK9gUFaw
+ZGUABRF1dGY4RGVjb2RlVG9BcnJheQAGCmFsbG9jQXJyYXkABw1hcnJheVRvU3RyaW5nAAgK6AUFaw
 EEfyAAEAAhBANAIAEgBE9FBEAgACABEAEiA0GAAUkEfyACQQFqBSADQYAQSQR/IAJBAmoFIANB/7cD
 TSADQYCwA09xBH8gAUEBaiEBIAJBBGoFIAJBA2oLCwshAiABQQFqIQEMAQsLIAILswICBH8BZAAgAS
 ECIAAgABAAIgX7BwAiBkEAEAIaA0AgBCAFT0UEQCAGIAT7DQAiA0GAAUkEfyACIAM6AAAgAkEBagUg
 A0GAEEkEfyACIANBBnZBwAFyOgAAIAJBAWogA0E/cUGAAXI6AAAgAkECagUgA0H/twNNIANBgLADT3
 EEfyACIANBCnQgBiAEQQFqIgT7DQBqQYC4/xprIgNBEnZB8AFyOgAAIAJBAWogA0EMdkE/cUGAAXI6
 AAAgAkECaiADQQZ2QT9xQYABcjoAACACQQNqIANBP3FBgAFyOgAAIAJBBGoFIAIgA0EMdkHgAXI6AA
 AgAkEBaiADQQZ2QT9xQYABcjoAACACQQJqIANBP3FBgAFyOgAAIAJBA2oLCwshAiAEQQFqIQQMAQsL
-IAIgAWsLvwIBA38DQCAAIAJLBEAgAi0AACIEQYABcUUEQCABIAMgBPsOACADQQFqIQMgAkEBaiECDA
-ILIARB4AFxQcABRgRAIAEgAyACQQFqLQAAQT9xIARBH3FBBnRy+w4AIANBAWohAyACQQJqIQIMAgsg
-BEHwAXFB4AFGBEAgASADIAJBAmotAABBP3EgBEEPcUEMdCACQQFqLQAAQT9xQQZ0cnL7DgAgA0EBai
-EDIAJBA2ohAgwCCyAEQfgBcUHwAUYEQCABIAMgAkEDai0AAEE/cSAEQQdxQRJ0IAJBAWotAABBP3FB
-DHRyIAJBAmotAABBP3FBBnRyckGAgARrIgRBCnZBgLADcvsOACABIANBAWoiAyAEQf8HcUGAuANy+w
-4AIANBAWohAyACQQRqIQIMAgUgAkEBaiECDAILAAsLIAMLBwAgAPsHAAsKACAAIAEgAhADCw==
+IAIgAWsLsQIBA38DQCAAIANNRQRAIAMtAAAiBEGAAXEEfyAEQeABcUHAAUYEfyABIAIgA0EBai0AAE
+E/cSAEQR9xQQZ0cvsOACACQQFqIQIgA0ECagUgBEHwAXFB4AFGBH8gASACIANBAmotAABBP3EgBEEP
+cUEMdCADQQFqLQAAQT9xQQZ0cnL7DgAgAkEBaiECIANBA2oFIARB+AFxQfABRgR/IAEgAiADQQNqLQ
+AAQT9xIARBB3FBEnQgA0EBai0AAEE/cUEMdHIgA0ECai0AAEE/cUEGdHJyQYCABGsiBEEKdkGAsANy
++w4AIAEgAkEBaiICIARB/wdxQYC4A3L7DgAgAkEBaiECIANBBGoFIANBAWoLCwsFIAEgAiAE+w4AIA
+JBAWohAiADQQFqCyEDDAELCyACCwcAIAD7BwALCgAgACABIAIQAws=
 `;