yuku 0.2.0 → 0.2.2

package/README.md

@@ -0,0 +1,25 @@
+<!-- markdownlint-disable first-line-h1 -->
+
+<!-- markdownlint-start-capture -->
+<!-- markdownlint-disable-file no-inline-html -->
+<div align="center">
+
+  <!-- markdownlint-disable-next-line no-alt-text -->
+  <img src="/assets/logo.svg" alt="Logo" width="300" />
+
+  [![NPM Version](https://img.shields.io/npm/v/yuku?logo=npm&logoColor=212121&label=version&labelColor=ffc44e&color=212121)](https://npmjs.com/package/yuku)
+  [![sponsor](https://img.shields.io/badge/sponsor-EA4AAA?logo=githubsponsors&labelColor=FAFAFA)](https://github.com/sponsors/arshad-yaseen)
+
+A very fast JavaScript/TypeScript parser written in Zig to enable JavaScript tooling in Zig.
+
+</div>
+
+<br/>
+
+- Full ECMAScript spec compliance
+- Very fast, built with performance in mind from the start, competitive with established parsers like Oxc.
+- Robust error recovery, partial ASTs on recoverable errors.
+- Rich features, including JSX and TypeScript support.
+- Can output 100% ESTree + TypeScript-ESTree compliant AST when needed.
+
+<br/>

package/{dist → npm/dist}/browser.d.ts

@@ -17,7 +17,11 @@ interface YukuNode {
 	type: string;
 	[key: string]: unknown;
 }
-type YukuAST = YukuNode;
+type YukuAST = {
+	program: YukuNode[];
+	errors: Record<string, unknown>[];
+	comments: Record<string, unknown>[];
+};
 /**
 * Parse JavaScript/TypeScript source code into a Yuku AST.
 *

package/{dist → npm/dist}/browser.js

@@ -1,4 +1,4 @@
-// src/browser.ts
+// npm/browser.ts
 var SourceType;
 ((SourceType2) => {
   SourceType2[SourceType2["Script"] = 0] = "Script";
@@ -16,31 +16,43 @@ var wasmInstance = null;
 async function getWasmInstance() {
   if (wasmInstance)
     return wasmInstance;
-  const wasmUrl = new URL("./yuku.wasm", import.meta.url);
-  const wasmBuffer = await fetch(wasmUrl).then((r) => r.arrayBuffer());
-  const wasmModule = await WebAssembly.instantiate(wasmBuffer);
+  const wasmModule = await WebAssembly.instantiateStreaming(fetch(new URL("./yuku.wasm", import.meta.url)));
   wasmInstance = wasmModule.instance.exports;
   return wasmInstance;
 }
-async function parse(source, options = {}) {
-  const wasm = await getWasmInstance();
+function readLengthPrefixedData(memory, ptr) {
+  const view = new DataView(memory.buffer);
+  const length = view.getUint32(ptr, true);
+  const dataPtr = ptr + 4;
+  return { length, dataPtr };
+}
+function parseInternal(wasm, source, options) {
   const encoder = new TextEncoder;
   const sourceBytes = encoder.encode(source);
   const sourceLen = sourceBytes.length;
-  const sourcePtr = wasm.alloc(sourceLen);
-  if (!sourcePtr) {
+  const sourcePtr = sourceLen > 0 ? wasm.alloc(sourceLen) : 0;
+  if (sourceLen > 0 && !sourcePtr) {
     throw new Error("Failed to allocate memory for source code");
   }
   try {
-    const wasmMemory = new Uint8Array(wasm.memory.buffer, sourcePtr, sourceLen);
-    wasmMemory.set(sourceBytes);
+    if (sourceLen > 0 && sourcePtr) {
+      const wasmMemory = new Uint8Array(wasm.memory.buffer, sourcePtr, sourceLen);
+      wasmMemory.set(sourceBytes);
+    }
     const sourceType = normalizeSourceType(options.sourceType);
     const lang = normalizeLang(options.lang);
     const resultPtr = wasm.parse(sourcePtr, sourceLen, sourceType, lang);
     if (resultPtr === 0) {
       throw new Error("Failed to parse source code");
     }
+    if (!Number.isInteger(resultPtr) || resultPtr < 0 || resultPtr >= wasm.memory.buffer.byteLength || resultPtr + 4 > wasm.memory.buffer.byteLength) {
+      throw new Error("Invalid result pointer from WASM parser");
+    }
     const { length: jsonLen, dataPtr: jsonDataPtr } = readLengthPrefixedData(wasm.memory, resultPtr);
+    if (!Number.isInteger(jsonDataPtr) || jsonDataPtr < 0 || jsonDataPtr >= wasm.memory.buffer.byteLength || jsonDataPtr + jsonLen > wasm.memory.buffer.byteLength) {
+      wasm.free(resultPtr, jsonLen + 4);
+      throw new Error("Invalid result pointer from WASM parser");
+    }
     try {
       const decoder = new TextDecoder;
       const jsonBytes = new Uint8Array(wasm.memory.buffer, jsonDataPtr, jsonLen);
@@ -50,42 +62,23 @@ async function parse(source, options = {}) {
       wasm.free(resultPtr, jsonLen + 4);
     }
   } finally {
-    wasm.free(sourcePtr, sourceLen);
+    if (sourceLen > 0 && sourcePtr) {
+      wasm.free(sourcePtr, sourceLen);
+    }
   }
 }
+async function parse(source, options = {}) {
+  const wasm = await getWasmInstance();
+  return parseInternal(wasm, source, options);
+}
 function parseSync(source, options = {}) {
   if (!wasmInstance) {
     throw new Error("WASM not loaded. Call parse() first or manually call preload()");
   }
-  const wasm = wasmInstance;
-  const encoder = new TextEncoder;
-  const sourceBytes = encoder.encode(source);
-  const sourceLen = sourceBytes.length;
-  const sourcePtr = wasm.alloc(sourceLen);
-  if (!sourcePtr) {
-    throw new Error("Failed to allocate memory for source code");
-  }
-  try {
-    const wasmMemory = new Uint8Array(wasm.memory.buffer, sourcePtr, sourceLen);
-    wasmMemory.set(sourceBytes);
-    const sourceType = normalizeSourceType(options.sourceType);
-    const lang = normalizeLang(options.lang);
-    const resultPtr = wasm.parse(sourcePtr, sourceLen, sourceType, lang);
-    if (resultPtr === 0) {
-      throw new Error("Failed to parse source code");
-    }
-    const { length: jsonLen, dataPtr: jsonDataPtr } = readLengthPrefixedData(wasm.memory, resultPtr);
-    try {
-      const decoder = new TextDecoder;
-      const jsonBytes = new Uint8Array(wasm.memory.buffer, jsonDataPtr, jsonLen);
-      const jsonStr = decoder.decode(jsonBytes);
-      return JSON.parse(jsonStr);
-    } finally {
-      wasm.free(resultPtr, jsonLen + 4);
-    }
-  } finally {
-    wasm.free(sourcePtr, sourceLen);
-  }
+  return parseInternal(wasmInstance, source, options);
+}
+async function preload() {
+  await getWasmInstance();
 }
 function normalizeSourceType(sourceType) {
   return sourceType === "script" ? 0 /* Script */ : 1 /* Module */;
@@ -104,15 +97,6 @@ function normalizeLang(lang) {
       return 0 /* JS */;
   }
 }
-function readLengthPrefixedData(memory, ptr) {
-  const view = new DataView(memory.buffer);
-  const length = view.getUint32(ptr, true);
-  const dataPtr = ptr + 4;
-  return { length, dataPtr };
-}
-async function preload() {
-  await getWasmInstance();
-}
 export {
   preload,
   parseSync,

package/{dist → npm/dist}/index.js

@@ -1,4 +1,4 @@
-// src/index.ts
+// npm/index.ts
 function parse() {
   return "Welcome to Yuku!";
 }

package/package.json

@@ -1,37 +1,38 @@
 {
   "name": "yuku",
   "description": "A very fast JavaScript/TypeScript parser written in Zig",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "files": [
-    "dist"
+    "npm/dist"
   ],
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "browser": "./dist/browser.js",
   "exports": {
     ".": {
-      "browser": {
-        "types": "./dist/browser.d.ts",
-        "import": "./dist/browser.js",
-        "default": "./dist/browser.js"
-      },
       "import": {
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       }
     },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "default": "./dist/browser.js"
+    },
     "./package.json": "./package.json"
   },
   "license": "MIT",
   "scripts": {
     "build": "bunup",
     "dev": "bunup --watch",
-    "type-check": "tsc --noEmit"
+    "type-check": "tsc --noEmit",
+    "test": "zig build && bun run build && bun test/run.ts"
   },
   "devDependencies": {
     "@types/bun": "^1.3.5",
     "bunup": "^0.16.11",
+    "fast-deep-equal": "^3.1.3",
+    "jest-diff": "^30.2.0",
     "typescript": "^5.9.3"
   },
   "peerDependencies": {