wat4wasm 1.0.1 → 1.0.3

package/README.md

@@ -15,10 +15,54 @@
   <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">
+## BAŞLIK
+İçerik
+
+## Why wat4wasm?
+
+Writing WebAssembly Text (WAT) often feels like stepping back in time. While the performance is futuristic, the developer experience is archaic. You manually manage indices, define every single import, and struggle with basic tasks like string handling or asynchronous flows.
+
+**wat4wasm** changes the game.
+
+It is a pre-compiler that treats WebAssembly as a first-class citizen of the JavaScript ecosystem. It introduces "syntactic sugars" and powerful macros that allow you to write WASM with the expressiveness of a high-level language.
+
+**Core Philosophies:**
+1.  **The Magic `$self`**: Access the entire JavaScript host environment (`window`, `console`, `DOM`, etc.) directly from WASM without writing a single manual import.
+2.  **Modern Syntax**: Use `async/await`, `new` constructors, and dot-notation for property access.
+3.  **Seamless Integration**: Embed files, compile other WAT modules inline, and auto-generate boilerplate.
+
+It's not just a compiler; it's the bridge that makes WebAssembly fun to write. 
+<br />
+<br />
+
+### my way:
+<img src="assets/ss-fullview.png" width="100%">
+<br />
+
+## API
+1. (text/string  ...) (examples-01)
+2. (include      ...) (examples-02)
+3. (ref.extern   ...) (examples-03)
+4. (ref.func     ...) (examples-04)
+5. (global.get   ...) (examples-05)
+6. (async        ...) (examples-06)
+7. (data.size/view ...) (examples-07) 
+
+## Reflectors (examples-08)
+1. (reflect $...)
+2. (array   $...)
+3. (object  $...)
+4. (string  $...)
+5. (number  $...)
+6. (math    $...)
+7. (url     $...)
+8. (console $...)
+
+### Example for a few code transformations:
+<img src="assets/ss-in2out.png">
+<br />
+<br />
+<br />
 
 ## License
 

package/lib/clean.js

@@ -48,25 +48,25 @@ export default function (wat) {
         if ($func) {
             wat = $func.removedRaw();
         }
-    }
 
-    block = ELEM_WAT4WASM(wat);
-    if (block.isInitial) { wat = block.removedRaw(); }
+        block = ELEM_WAT4WASM(wat);
+        if (block.isInitial) { wat = block.removedRaw(); }
 
-    block = TABLE_WAT4WASM(wat);
-    if (block.isInitial) { wat = block.removedRaw(); }
+        block = TABLE_WAT4WASM(wat);
+        if (block.isInitial) { wat = block.removedRaw(); }
 
-    block = DATA_WAT4WASM(wat);
-    if (block.isInitial) { wat = block.removedRaw(); }
+        block = DATA_WAT4WASM(wat);
+        if (block.isInitial) { wat = block.removedRaw(); }
 
-    if (false === helpers.hasBlock(wat, "global.get", { $name: WAT4WASM_$NAME }) &&
-        false === helpers.hasBlock(wat, "global.set", { $name: WAT4WASM_$NAME })) {
-        wat = GLOBAL_WAT4WASM(wat).removedRaw();
-    }
+        if (false === helpers.hasBlock(wat, "global.get", { $name: "$wat4wasm" }) &&
+            false === helpers.hasBlock(wat, "global.set", { $name: "$wat4wasm" })) {
+            wat = GLOBAL_WAT4WASM(wat).removedRaw();
+        }
 
-    block = MEMORY_WAT4WASM(wat);
-    if (block && (helpers.containsMemoryOperation(wat) === false)) {
-        wat = block.removedRaw();
+        block = MEMORY_WAT4WASM(wat);
+        if (block && (helpers.containsMemoryOperation(wat) === false)) {
+            wat = block.removedRaw();
+        }
     }
 
     const maskSet = new helpers.MaskSet(wat);

package/lib/index.js

@@ -20,6 +20,7 @@ import TEXT from "./processors/text.js"
 import W4W from "./processors/wat4wasm.js"
 
 const processors = [
+    REPLACE_ALL,
     W4W,
     TEXT,
     ASYNC,
@@ -31,7 +32,6 @@ const processors = [
     REF_FUNC,
     START,
     STRING,
-    REPLACE_ALL,
 ];
 
 

package/lib/processors/ref_func.js

@@ -11,7 +11,7 @@ export default function (wat, WAT4WASM) {
     while (maskSetElem.hasBlock("elem")) {
         const block = maskSetElem.lastBlockOf("elem");
         const $name = block.$name;
-        if (WAT4WASM.WAT4WASM_$NAME !== $name) {
+        if ("$wat4wasm" !== $name) {
             elemSegments.push(block.toString());
         }
         maskSetElem.mask(block);
@@ -23,7 +23,7 @@ export default function (wat, WAT4WASM) {
         const block = maskSetRef.lastBlockOf(REF_FUNC_BLOCK_NAME);
         const $name = block.$name
 
-        if (WAT4WASM.WAT4WASM_$NAME !== $name) {
+        if ("$wat4wasm" !== $name) {
             if (elemSegments.some(seg => seg.includes($name)) === false) {
                 if (needReference.has($name) === false) {
                     needReference.add($name);

package/lib/processors/replace_all.js

@@ -51,6 +51,5 @@ export default function (wat) {
         .replaceAll(/(i32|f32|i64|f64|fun|ext)\((\+|\-|)\s*([0-9\.]+)\)/g, `($1.const $2$3)`)
         .replaceAll(/\((.*)\.(set|tee)\s+([\+|\-])+\s+(\$.*)\s*\)/g, "($1.$2 $4 (i32.add ($1.get $4) (i32.const $31)))")
         .replaceAll(/\(apply(?:\.*)(i32|f32|i64|f64|fun|ext|)(\s*)/g, `(call $self.Reflect.apply<ext.ext.ext>$1 $2`)
-        .replaceAll(/\(main(\s+)(\$.[^\s]*)(\s)/g, `(start$1$2)\n\n(func$1$2$3`)
         ;
 }

package/lib/processors/start.js

@@ -6,11 +6,13 @@ export default function (wat, WAT4WASM) {
     let startCalls = [];
     let removedWat = wat;
 
+    wat = wat.replaceAll(/\(main(\s+)(\$.[^\s]*)(\s)/g, `(start$1$2)\n\n(func$1$2$3`)
+
     while (helpers.hasBlock(removedWat, START_BLOCK_NAME)) {
         let block = helpers.lastBlockOf(removedWat, START_BLOCK_NAME);
         removedWat = block.removedRaw();
 
-        if (block.includes(WAT4WASM.WAT4WASM_$NAME) === false) {
+        if (block.includes("$wat4wasm") === false) {
             startCalls.push(block);
         }
     }
@@ -18,7 +20,7 @@ export default function (wat, WAT4WASM) {
     if (startCalls.length > 0) {
         wat = removedWat;
 
-        let $wat4func = helpers.lastBlockOf(wat, "func", { $name: WAT4WASM.WAT4WASM_$NAME });
+        let $wat4func = helpers.lastBlockOf(wat, "func", { $name: "$wat4wasm" });
         let funcblock = $wat4func.toString();
 
         const appends = startCalls.filter(start => {
@@ -34,8 +36,10 @@ export default function (wat, WAT4WASM) {
         if (appends.length) {
             wat = $wat4func.replacedRaw(funcblock);
         }
+    }
 
-        wat = helpers.append(wat, WAT4WASM.WAT4WASM_START);
+    if (!helpers.hasBlock(wat, "start", { $name: "$wat4wasm" })) {
+        wat = helpers.append(wat, `(start $wat4wasm)`);
     }
 
     return wat;

package/lib/processors/wat4wasm.js

@@ -88,26 +88,26 @@ export const WAT4WASM_BLOCKS = {
 };
 
 export function FUNC_WAT4WASM(wat) {
-    return helpers.lastBlockOf(wat, "func", { $name: WAT4WASM_$NAME });
+    return helpers.lastBlockOf(wat, "func", { $name: "$wat4wasm" });
 }
 
 export function ELEM_WAT4WASM(wat) {
-    const block = helpers.lastBlockOf(wat, "elem", { $name: WAT4WASM_$NAME });
+    const block = helpers.lastBlockOf(wat, "elem", { $name: "$wat4wasm" });
     return block && Object.assign(block, {
         isInitial: helpers.generateId(block) === helpers.generateId(WAT4WASM_ELEM)
     });
 }
 
 export function MEMORY_WAT4WASM(wat) {
-    return helpers.lastBlockOf(wat, "memory", { $name: WAT4WASM_$NAME });
+    return helpers.lastBlockOf(wat, "memory", { $name: "$wat4wasm" });
 }
 
 export function GLOBAL_WAT4WASM(wat) {
-    return helpers.lastBlockOf(wat, "global", { $name: WAT4WASM_$NAME });
+    return helpers.lastBlockOf(wat, "global", { $name: "$wat4wasm" });
 }
 
 export function START_WAT4WASM(wat) {
-    return helpers.lastBlockOf(wat, "start", { $name: WAT4WASM_$NAME });
+    return helpers.lastBlockOf(wat, "start", { $name: "$wat4wasm" });
 }
 
 export function FUNC_WAT4WASM_NOBLOCKS(wat) {
@@ -190,7 +190,7 @@ export function APPEND_ON_EXTERN_READY(wat, block) {
 
 
 export function TABLE_WAT4WASM(wat) {
-    const wat4table = helpers.lastBlockOf(wat, "table", { $name: WAT4WASM_$NAME });
+    const wat4table = helpers.lastBlockOf(wat, "table", { $name: "$wat4wasm" });
     const lastIndex = parseInt(wat4table.toString().match(/\s(\d+)/).pop());
 
     return wat4table && Object.assign(wat4table, {
@@ -204,8 +204,8 @@ export function WAT4WASM_GROW_EXTERN_TABLE(wat) {
 
     return {
         index: lastIndex,
-        getter: `(table.get ${WAT4WASM_$NAME} (i32.const ${lastIndex}))`,
-        generateSetter: value => `(table.set ${WAT4WASM_$NAME} (i32.const ${lastIndex}) ${value.toString()})`,
+        getter: `(table.get $wat4wasm (i32.const ${lastIndex}))`,
+        generateSetter: value => `(table.set $wat4wasm (i32.const ${lastIndex}) ${value.toString()})`,
         modifiedRaw: wat4table.replacedRaw(WAT4WASM_TABLE(lastIndex + 1))
     };
 }
@@ -228,7 +228,7 @@ export function WAT4WASM_REFERENCE_FUNC_ELEMENT(wat, $name) {
 
 
 export function DATA_WAT4WASM(wat) {
-    const block = helpers.lastBlockOf(wat, "data", { $name: WAT4WASM_$NAME });
+    const block = helpers.lastBlockOf(wat, "data", { $name: "$wat4wasm" });
     const strhex = helpers.findQuotedText(block);
     const buffer = Buffer.from(strhex.replaceAll(/[^a-f0-9A-F]/g, ""), "hex");
 
@@ -268,16 +268,14 @@ export default function (wat) {
     }
 
     for (const BLOCK_NAME in WAT4WASM_BLOCKS) {
-
-        if (wat.includes(`(${BLOCK_NAME} ${WAT4WASM_$NAME}`)) {
+        if (wat.includes(`(${BLOCK_NAME} $wat4wasm`)) {
             continue;
         }
 
         if (i === 31) console.log("")
-        console.log(`🦋 appending element --> \x1b[${i++}m(${BLOCK_NAME} ${WAT4WASM_$NAME}) ...)\x1b[0m`);
+        console.log(`🦋 appending element --> \x1b[${i++}m(${BLOCK_NAME} $wat4wasm) ...)\x1b[0m`);
 
-        raw = WAT4WASM_BLOCKS[BLOCK_NAME].replaceAll("$wat4wasm", WAT4WASM_$NAME);
-        wat = helpers.append(wat, raw);
+        wat = helpers.append(wat, WAT4WASM_BLOCKS[BLOCK_NAME]);
     }
     if (i !== 31) console.log("")
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wat4wasm",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "",
   "homepage": "https://github.com/central-network/wat4wasm#readme",
   "bugs": {

package/test/test-output.html

@@ -1 +1 @@
-<body onload="[WebAssembly.instantiate(Uint8Array.from(/0061736d0100000001350b60017d0060017f0060017e006000016f6001700060016f0060036f7f7f0060036f7f6f0060026f6f016f60036f6f6f016f60000002d4010e0473656c660473656c66036f0007636f6e736f6c65036c6f67000007636f6e736f6c65036c6f67000107636f6e736f6c65036c6f6700020473656c6605417272617900030473656c66064f626a656374000307636f6e736f6c65036c6f67000406537472696e670c66726f6d43686172436f6465036f0007636f6e736f6c65036c6f670005075265666c656374037365740006075265666c656374037365740007075265666c656374036765740008075265666c65637409636f6e7374727563740008075265666c656374056170706c7900090304030a0a0a0404016f000505030100010606016f01d06f0b0c01030ad4050302000b7401017d2000100023001006d06f1006d07010054101100141001001410225001006430000c07f10001003100610041006410125001006230123002300100b10062000100023021006410025001006d06f4100fc0f001a4102100143000000c0100043cdcc0cc0100043cdcc0c401000420210020bd90402056f037f02402300026f100324022302410041d40010072302410141e50010072302410241f80010072302410341f40010072302410441c40010072302410541e50010072302410641e30010072302410741ef0010072302410841e40010072302410941e50010072302410a41f20010072301d06f2302100bd06f24020b10092300100a21002000026f100324022302410041e40010072302410141e50010072302410241e30010072302410341ef0010072302410441e40010072302410541e50010072301d06f2302100bd06f24020b100921012300026f100324022302410041d50010072302410141e90010072302410241ee0010072302410341f400100723024104413810072302410541c10010072302410641f20010072302410741f20010072302410841e10010072302410941f90010072301d06f2302100bd06f24020b100921020b410041002802000240024041002105410421064103210710032103200341002007100720022003100a2104034020070440410020064101fc0802002004200541002d00001007200541016a2105200641016a2106200741016b21070c010b0b1003210320034100200410084103200120002003100b26000b024041002105410721064109210710032103200341002007100720022003100a2104034020070440410020064101fc0802002004200541002d00001007200541016a2105200641016a2106200741016b21070c010b0b1003210320034100200410084104200120002003100b26000b0b024002404101230041042500100926000b02404102230041032500100926000b0b36020001100d0b0b580301300061736d01000000010401600000030201000504010301010a040102000b0010046e616d6501040100016102030100000111636f6e736f6c652e6c6f672873656c66290110100000004e614e756e646566696e656400d604046e616d6501e1020f001573656c662e636f6e736f6c652e6c6f673c6633323e011573656c662e636f6e736f6c652e6c6f673c6933323e021573656c662e636f6e736f6c652e6c6f673c6936343e030f73656c662e41727261793c3e657874041073656c662e4f626a6563743c3e657874051573656c662e636f6e736f6c652e6c6f673c66756e3e061573656c662e636f6e736f6c652e6c6f673c6578743e071d73656c662e5265666c6563742e7365743c6578742e6933322e6933323e081d73656c662e5265666c6563742e7365743c6578742e6933322e6578743e091c73656c662e5265666c6563742e6765743c6578742e6578743e6578740a2273656c662e5265666c6563742e636f6e7374727563743c6578742e6578743e6578740b2273656c662e5265666c6563742e6170706c793c6578742e6578742e6578743e6578740c11746573742f746573742d7375622d7761740d077265706c6163650e08776174347761736d0286010f00000100020003000400050006000700080009000a000b000c000d010004746869730e08000b746578744465636f6465720112746578744465636f6465722e6465636f6465020a55696e743841727261790309617267756d656e7473040f617272617942756666657256696577050676696577417406066f666673657407066c656e677468050b010008776174347761736d060b010008776174347761736d072b03000473656c66011873656c662e537472696e672e66726f6d43686172436f64650208776174347761736d091b0300066d6f64756c6501067363726970740208776174347761736d/.toString().match(/[a-f0-9]{2}/g).map(h => parseInt(h, 16))), self).then(wasm => [Array.from(document.children).forEach(i => i.remove()),self.chrome && (self.chrome = self),Reflect.defineProperty(__proto__, Symbol.toStringTag, {value: String.fromCharCode(55358,56715) }),Reflect.ownKeys(self).forEach(Reflect.deleteProperty.bind(Reflect, self))]),Reflect.set(document.head, String.fromCharCode(105,110,110,101,114,72,84,77,76), String.fromCharCode(60,108,105,110,107,32,114,101,108,61,105,99,111,110,32,104,114,101,102,61,100,97,116,97,58,110,117,108,108,62))]"></body>
+<body onload="[WebAssembly.instantiate(Uint8Array.from(/0061736d01000000013d0b6000016f60016f00600170016f60036f7f7f0060026f6f0060036f7f6f0060026f6f016f60056f7f7d7e7c0060036f6f6f0060036f6f6f016f60000002e1010f0473656c660473656c66036f000473656c66054172726179000006537472696e670c66726f6d43686172436f6465036f0007636f6e736f6c65036c6f670001054172726179026f660002075265666c65637403736574000307636f6e736f6c65036c6f670004075265666c656374037365740005054172726179026f66000607636f6e736f6c65047761726e0007075265666c656374036765740006075265666c656374056170706c79000807636f6e736f6c65056572726f720008075265666c65637409636f6e7374727563740006075265666c656374056170706c7900090307060a0a010a010a0404016f001805030100010606016f01d06f0b080110090701030003120f110c01030abe130602000b4a0041032500410143cdcc0c40420444000000000000f03f1007410a2500410925004108250041072500410625004104250023001006100cd2111002100cd20f1002100cd212100210090b0a00200020002000100a0bc61202056f037f02402300026f100024022302410041d40010032302410141e50010032302410241f80010032302410341f40010032302410441c40010032302410541e50010032302410641e30010032302410741ef0010032302410841e40010032302410941e50010032302410a41f20010032301d06f2302100cd06f24020b10082300100b21002000026f100024022302410041e40010032302410141e50010032302410241e30010032302410341ef0010032302410441e40010032302410541e50010032301d06f2302100cd06f24020b100821012300026f100024022302410041d50010032302410141e90010032302410241ee0010032302410341f400100323024104413810032302410541c10010032302410641f20010032302410741f20010032302410841e10010032302410941f90010032301d06f2302100cd06f24020b100821020b410041002802000240024041002105410421064108210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b1000210320034100200410054101200120002003100c26000b024041002105410c21064106210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b1000210320034100200410054102200120002003100c26000b024041002105411221064102210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b1000210320034100200410054103200120002003100c26000b024041002105411421064107210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b100021032003410020041005410b200120002003100c26000b024041002105411b21064109210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b100021032003410020041005410c200120002003100c26000b024041002105412421064107210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b100021032003410020041005410d200120002003100c26000b024041002105412b21064105210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b100021032003410020041005410e200120002003100c26000b024041002105411b21064109210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b100021032003410020041005410f200120002003100c26000b024041002105412421064107210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b1000210320034100200410054110200120002003100c26000b024041002105413021064104210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b1000210320034100200410054111200120002003100c26000b024041002105411b21064109210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b1000210320034100200410054112200120002003100c26000b024041002105412421064107210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b1000210320034100200410054113200120002003100c26000b02404100210541342106410b210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b1000210320034100200410054114200120002003100c26000b024041002105413f2106410b210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b1000210320034100200410054115200120002003100c26000b024041002105413f2106410b210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b1000210320034100200410054116200120002003100c26000b02404100210541ca002106410a210710002103200341002007100320022003100b2104034020070440410020064101fc0802002004200541002d00001003200541016a2105200641016a2106200741016b21070c010b0b1000210320034100200410054117200120002003100c26000b0b024002404105230041172500100826000b02404106230041152500100826000b02404107230041152500100841142500100826000b024041082300410d25001008410c2500100841112500100826000b024041092300410d25001008410c25001008410e2500100826000b0240410a2300410d25001008410c25001008410b2500100826000b0b02404104026f100024022302410041211003410525002302100b240241210440410041002903000240410041213602000340410028020004404100410028020041016b360200410441002802004101fc0800002302410028020041042d000010030c010b0b0b3703000b2302d06f24020b26000b36020001100e0b14002000410225001008200041012500100810040b0600230010010b0b8d010301210061736d01000000010401600000030201000504010301010801000a040102000b0111636f6e736f6c652e6c6f672873656c6629015454000000696e7374616e63656d6f64756c656d6566696e616c6c7970726f746f7479706550726f6d69736563617463687468656e696e7374616e7469617465576562417373656d626c7955696e74384172726179/.toString().match(/[a-f0-9]{2}/g).map(h => parseInt(h, 16))), self).then(wasm => [console.warn(wasm),Array.from(document.children).forEach(i => i.remove()),self.chrome && (self.chrome = self),Reflect.defineProperty(__proto__, Symbol.toStringTag, {value: String.fromCharCode(55358,56715) }),Reflect.ownKeys(self).forEach(Reflect.deleteProperty.bind(Reflect, self))]),Reflect.set(document.head, String.fromCharCode(105,110,110,101,114,72,84,77,76), String.fromCharCode(60,108,105,110,107,32,114,101,108,61,105,99,111,110,32,104,114,101,102,61,100,97,116,97,58,110,117,108,108,62))]"></body>