wat4wasm 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Özgür, Dr.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+# wat4wasm
+
+<p align="center">
+  <br />
+  <strong><code>wat4wasm</code></strong>
+  <br />
+  <br />
+  sweet <em><strong>WebAssembly</strong></em> sugars
+  <br />
+  Designed to make you faster, smarter and aesthetically pleasing WebAssembly coder.
+</p>
+
+<p align="center">
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
+  <img src="https://img.shields.io/badge/node-14.0.0-green.svg" alt="Node.js Version">
+</p>
+
+## ... 
+<img src="ss-console.png">
+<hr />
+<img src="ss-terminal.png">
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+<p align="center">
+  <a target="_blank" href="https://gemini.google.com/">Gemini</a> and <a target="_blank" href="https://github.com/tokbuga">Özgür</a> created with 💚
+</p>

package/examples/01-text/module-output.wat

@@ -0,0 +1,228 @@
+(module
+  (import "self" "self"           (global $self                             externref))
+  (import "self" "Array"          (func $self.Array<>ext                    (param) (result externref)))
+  (import "String" "fromCharCode" (global $self.String.fromCharCode         externref))
+  (import "Reflect" "set"         (func $self.Reflect.set<ext.i32.i32>      (param externref i32 i32) (result)))
+  (import "Reflect" "set"         (func $self.Reflect.set<ext.i32.ext>      (param externref i32 externref) (result)))
+  (import "Reflect" "get"         (func $self.Reflect.get<ext.ext>ext       (param externref externref) (result externref)))
+  (import "Reflect" "construct"   (func $self.Reflect.construct<ext.ext>ext (param externref externref) (result externref)))
+  (import "Reflect" "apply"       (func $self.Reflect.apply<ext.ext.ext>ext (param externref externref externref) (result externref)))
+
+
+  (func $main
+    (table.get $wat4wasm (i32.const 1));; hello world
+
+    (drop)
+
+
+    (block (; "hello world" ;)
+      (result externref)
+      (global.set $wat4wasm (call $self.Array<>ext))
+
+      (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 0) (i32.const 104))
+      (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 1) (i32.const 101))
+      (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 2) (i32.const 108))
+      (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 3) (i32.const 108))
+      (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 4) (i32.const 111))
+      (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 5) (i32.const 32))
+      (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 6) (i32.const 119))
+      (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 7) (i32.const 111))
+      (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 8) (i32.const 114))
+      (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 9) (i32.const 108))
+      (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 10) (i32.const 100))
+
+      (call $self.Reflect.apply<ext.ext.ext>ext
+        (global.get $self.String.fromCharCode)
+        (ref.null extern)
+        (global.get $wat4wasm)
+      )
+      ;; stacked
+
+      (global.set $wat4wasm (ref.null extern))
+      ;; cleared
+    )
+
+    (drop)
+  )
+
+  (global $wat4wasm (mut externref) (ref.null extern))
+
+  (table $wat4wasm 2 externref)
+
+
+
+
+  (func $wat4wasm
+    (local $textDecoder externref)
+    (local $textDecoder.decode externref)
+    (local $Uint8Array externref)
+    (local $arguments externref)
+    (local $arrayBufferView externref)
+    (local $viewAt i32)
+    (local $offset i32)
+    (local $length i32)
+    (block $prepare
+      (local.set $textDecoder
+        (call $self.Reflect.construct<ext.ext>ext
+          (call $self.Reflect.get<ext.ext>ext
+            (global.get $self)
+
+            (block (; "TextDecoder" ;)
+              (result externref)
+              (global.set $wat4wasm (call $self.Array<>ext))
+
+              (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 0) (i32.const 84))
+              (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 1) (i32.const 101))
+              (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 2) (i32.const 120))
+              (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 3) (i32.const 116))
+              (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 4) (i32.const 68))
+              (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 5) (i32.const 101))
+              (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 6) (i32.const 99))
+              (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 7) (i32.const 111))
+              (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 8) (i32.const 100))
+              (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 9) (i32.const 101))
+              (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 10) (i32.const 114))
+
+              (call $self.Reflect.apply<ext.ext.ext>ext
+                (global.get $self.String.fromCharCode)
+                (ref.null extern)
+                (global.get $wat4wasm)
+              )
+              ;; stacked
+
+              (global.set $wat4wasm (ref.null extern))
+              ;; cleared
+            )
+
+          )
+          (global.get $self)
+        )
+      )
+      (local.set $textDecoder.decode
+        (call $self.Reflect.get<ext.ext>ext
+          (local.get $textDecoder)
+
+          (block (; "decode" ;)
+            (result externref)
+            (global.set $wat4wasm (call $self.Array<>ext))
+
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 0) (i32.const 100))
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 1) (i32.const 101))
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 2) (i32.const 99))
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 3) (i32.const 111))
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 4) (i32.const 100))
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 5) (i32.const 101))
+
+            (call $self.Reflect.apply<ext.ext.ext>ext
+              (global.get $self.String.fromCharCode)
+              (ref.null extern)
+              (global.get $wat4wasm)
+            )
+            ;; stacked
+
+            (global.set $wat4wasm (ref.null extern))
+            ;; cleared
+          )
+
+        )
+      )
+      (local.set $Uint8Array
+        (call $self.Reflect.get<ext.ext>ext
+          (global.get $self)
+
+          (block (; "Uint8Array" ;)
+            (result externref)
+            (global.set $wat4wasm (call $self.Array<>ext))
+
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 0) (i32.const 85))
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 1) (i32.const 105))
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 2) (i32.const 110))
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 3) (i32.const 116))
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 4) (i32.const 56))
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 5) (i32.const 65))
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 6) (i32.const 114))
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 7) (i32.const 114))
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 8) (i32.const 97))
+            (call $self.Reflect.set<ext.i32.i32> (global.get $wat4wasm) (i32.const 9) (i32.const 121))
+
+            (call $self.Reflect.apply<ext.ext.ext>ext
+              (global.get $self.String.fromCharCode)
+              (ref.null extern)
+              (global.get $wat4wasm)
+            )
+            ;; stacked
+
+            (global.set $wat4wasm (ref.null extern))
+            ;; cleared
+          )
+
+        )
+      )
+    )
+    ;;secure zero heap for memory.init
+    (i32.const 0)
+    (i32.load (i32.const 0))
+    ;; offset and value stacked now
+    (block $oninit
+      (block $decodeText/4:11
+        (local.set $viewAt (i32.const 0))
+        (local.set $offset (i32.const 4))
+        (local.set $length (i32.const 11))
+        (local.set $arguments (call $self.Array<>ext))
+
+        (call $self.Reflect.set<ext.i32.i32>
+          (local.get $arguments) (i32.const 0) (local.get $length)
+        )
+        (local.set $arrayBufferView
+          (call $self.Reflect.construct<ext.ext>ext
+            (local.get $Uint8Array)
+            (local.get $arguments)
+          )
+        )
+        (loop $length--
+          (if (local.get $length)
+            (then
+              (memory.init $wat4wasm
+                (i32.const 0)
+                (local.get $offset)
+                (i32.const 1)
+              )
+              (call $self.Reflect.set<ext.i32.i32>
+                (local.get $arrayBufferView)
+                (local.get $viewAt)
+                (i32.load8_u (i32.const 0))
+              )
+              (local.set $viewAt (i32.add (local.get $viewAt) (i32.const 1)))
+              (local.set $offset (i32.add (local.get $offset) (i32.const 1)))
+              (local.set $length (i32.sub (local.get $length) (i32.const 1)))
+              (br $length--)
+            )
+          )
+        )
+        (local.set $arguments (call $self.Array<>ext))
+        (call $self.Reflect.set<ext.i32.ext>
+          (local.get $arguments)
+          (i32.const 0)
+          (local.get $arrayBufferView)
+        )
+        (table.set $wat4wasm (i32.const 1)
+          (call $self.Reflect.apply<ext.ext.ext>ext
+            (local.get $textDecoder.decode)
+            (local.get $textDecoder)
+            (local.get $arguments) ;; hello world
+        ))
+      )
+    )
+
+
+
+    ;; restore zero heap value
+    (i32.store (; stack stack ;))
+    (nop)
+  )
+
+
+  (data $wat4wasm "\0f\00\00\00\68\65\6c\6c\6f\20\77\6f\72\6c\64")
+
+  (memory $wat4wasm 1)
+)

package/examples/01-text/module.wat

@@ -0,0 +1,9 @@
+(module 
+    (func $main
+        (text "hello world")
+        (drop)
+
+        (string "hello world")
+        (drop)
+    )
+)

package/examples/02-include/module-output.wat

@@ -0,0 +1,22 @@
+(module
+
+
+
+  (func $included_content
+
+  )
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+)

package/examples/02-include/module.wat

@@ -0,0 +1,3 @@
+(module 
+    (include "used-folder/included-file.wat")
+)

package/examples/02-include/used-folder/included-file.wat

@@ -0,0 +1,4 @@
+    
+    (func $included_content
+    
+    )