yuku 0.2.5 → 0.2.9

package/dist/browser.d.ts

@@ -1,73 +1,73 @@
-declare enum SourceType {
-	Script = 0,
-	Module = 1
+export declare enum SourceType {
+    Script = 0,
+    Module = 1
 }
-declare enum Lang {
-	JS = 0,
-	TS = 1,
-	JSX = 2,
-	TSX = 3,
-	DTS = 4
+export declare enum Lang {
+    JS = 0,
+    TS = 1,
+    JSX = 2,
+    TSX = 3,
+    DTS = 4
 }
-interface ParseOptions {
-	sourceType?: "script" | "module";
-	lang?: "js" | "ts" | "jsx" | "tsx" | "dts";
+export interface ParseOptions {
+    sourceType?: 'script' | 'module';
+    lang?: 'js' | 'ts' | 'jsx' | 'tsx' | 'dts';
 }
 interface YukuNode {
-	type: string;
-	[key: string]: unknown;
+    type: string;
+    [key: string]: unknown;
 }
 type YukuAST = {
-	program: YukuNode[];
-	errors: Record<string, unknown>[];
-	comments: Record<string, unknown>[];
+    program: YukuNode[];
+    errors: Record<string, unknown>[];
+    comments: Record<string, unknown>[];
 };
 /**
-* Parse JavaScript/TypeScript source code into a Yuku AST.
-*
-* @param source - Source code to parse
-* @param options - Parse options
-* @returns Yuku AST
-* @throws Error if parsing fails
-*
-* @example
-* ```ts
-* const ast = await parse('const x = 5;', {
-*   sourceType: 'module',
-*   lang: 'js'
-* });
-* ```
-*/
-declare function parse(source: string, options?: ParseOptions): Promise<YukuAST>;
+ * Parse JavaScript/TypeScript source code into a Yuku AST.
+ *
+ * @param source - Source code to parse
+ * @param options - Parse options
+ * @returns Yuku AST
+ * @throws Error if parsing fails
+ *
+ * @example
+ * ```ts
+ * const ast = await parse('const x = 5;', {
+ *   sourceType: 'module',
+ *   lang: 'js'
+ * });
+ * ```
+ */
+export declare function parse(source: string, options?: ParseOptions): Promise<YukuAST>;
 /**
-* Synchronous parse function (requires WASM to be preloaded).
-* Use `parse()` for most cases.
-*
-* @param source - Source code to parse
-* @param options - Parse options
-* @returns Yuku AST
-* @throws Error if WASM not loaded or parsing fails
-*
-* @example
-* ```ts
-* await preload(); // Load WASM first
-* const ast = parseSync('const x = 5;', {
-*   sourceType: 'module',
-*   lang: 'js'
-* });
-* ```
-*/
-declare function parseSync(source: string, options?: ParseOptions): YukuAST;
+ * Synchronous parse function (requires WASM to be preloaded).
+ * Use `parse()` for most cases.
+ *
+ * @param source - Source code to parse
+ * @param options - Parse options
+ * @returns Yuku AST
+ * @throws Error if WASM not loaded or parsing fails
+ *
+ * @example
+ * ```ts
+ * await preload(); // Load WASM first
+ * const ast = parseSync('const x = 5;', {
+ *   sourceType: 'module',
+ *   lang: 'js'
+ * });
+ * ```
+ */
+export declare function parseSync(source: string, options?: ParseOptions): YukuAST;
 /**
-* Preload WASM module (optional).
-* Useful if you want to load WASM before first parse.
-*
-* @example
-* ```ts
-* await preload();
-* // Now you can use parseSync()
-* const ast = parseSync('const x = 5;');
-* ```
-*/
-declare function preload(): Promise<void>;
-export { preload, parseSync, parse, YukuNode, YukuAST, SourceType, ParseOptions, Lang };
+ * Preload WASM module (optional).
+ * Useful if you want to load WASM before first parse.
+ *
+ * @example
+ * ```ts
+ * await preload();
+ * // Now you can use parseSync()
+ * const ast = parseSync('const x = 5;');
+ * ```
+ */
+export declare function preload(): Promise<void>;
+export {};

package/dist/browser.js

@@ -1,97 +1,141 @@
-// src/browser.ts
+export { SourceType };
 var SourceType;
-((SourceType2) => {
-  SourceType2[SourceType2["Script"] = 0] = "Script";
-  SourceType2[SourceType2["Module"] = 1] = "Module";
-})(SourceType ||= {});
+(function (SourceType) {
+    SourceType[SourceType["Script"] = 0] = "Script";
+    SourceType[SourceType["Module"] = 1] = "Module";
+})(SourceType || (SourceType = {}));
+export { Lang };
 var Lang;
-((Lang2) => {
-  Lang2[Lang2["JS"] = 0] = "JS";
-  Lang2[Lang2["TS"] = 1] = "TS";
-  Lang2[Lang2["JSX"] = 2] = "JSX";
-  Lang2[Lang2["TSX"] = 3] = "TSX";
-  Lang2[Lang2["DTS"] = 4] = "DTS";
-})(Lang ||= {});
-var wasmInstance = null;
+(function (Lang) {
+    Lang[Lang["JS"] = 0] = "JS";
+    Lang[Lang["TS"] = 1] = "TS";
+    Lang[Lang["JSX"] = 2] = "JSX";
+    Lang[Lang["TSX"] = 3] = "TSX";
+    Lang[Lang["DTS"] = 4] = "DTS";
+})(Lang || (Lang = {}));
+let wasmInstance = null;
 async function getWasmInstance() {
-  if (wasmInstance)
+    if (wasmInstance)
+        return wasmInstance;
+    const wasmModule = await WebAssembly.instantiateStreaming(fetch(new URL('./yuku.wasm', import.meta.url)));
+    wasmInstance = wasmModule.instance.exports;
     return wasmInstance;
-  const wasmModule = await WebAssembly.instantiateStreaming(fetch(new URL("./yuku.wasm", import.meta.url)));
-  wasmInstance = wasmModule.instance.exports;
-  return wasmInstance;
 }
 function parseInternal(wasm, source, options) {
-  const encoder = new TextEncoder;
-  const sourceBytes = encoder.encode(source);
-  const sourceLen = sourceBytes.length;
-  const sourcePtr = sourceLen > 0 ? wasm.alloc(sourceLen) : 0;
-  if (sourceLen > 0 && !sourcePtr) {
-    throw new Error("Failed to allocate memory for source code");
-  }
-  try {
-    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 result = wasm.parse(sourcePtr, sourceLen, sourceType, lang);
-    if (result === 0n) {
-      throw new Error("Failed to parse source code");
-    }
-    const resultPtr = Number(result & 0xFFFFFFFFn);
-    const jsonLen = Number(result >> 32n);
-    if (resultPtr + jsonLen > wasm.memory.buffer.byteLength) {
-      throw new Error("Invalid result pointer from WASM parser");
+    const encoder = new TextEncoder();
+    const sourceBytes = encoder.encode(source);
+    const sourceLen = sourceBytes.length;
+    // allocate source code buffer, allow empty source by not requiring allocation when length is 0
+    const sourcePtr = sourceLen > 0 ? wasm.alloc(sourceLen) : 0;
+    if (sourceLen > 0 && !sourcePtr) {
+        throw new Error('Failed to allocate memory for source code');
     }
     try {
-      const decoder = new TextDecoder;
-      const jsonBytes = new Uint8Array(wasm.memory.buffer, resultPtr, jsonLen);
-      const jsonStr = decoder.decode(jsonBytes);
-      return JSON.parse(jsonStr);
-    } finally {
-      wasm.free(resultPtr, jsonLen);
+        if (sourceLen > 0 && sourcePtr) {
+            const wasmMemory = new Uint8Array(wasm.memory.buffer, sourcePtr, sourceLen);
+            wasmMemory.set(sourceBytes);
+        }
+        // options are numbers, so normalize them to pass to wasm
+        const sourceType = normalizeSourceType(options.sourceType);
+        const lang = normalizeLang(options.lang);
+        const result = wasm.parse(sourcePtr, sourceLen, sourceType, lang);
+        if (result === 0n) {
+            throw new Error('Failed to parse source code');
+        }
+        // unpack u64: high 32 bits = length, low 32 bits = pointer
+        const resultPtr = Number(result & 0xffffffffn);
+        const jsonLen = Number(result >> 32n);
+        if (resultPtr + jsonLen > wasm.memory.buffer.byteLength) {
+            throw new Error('Invalid result pointer from WASM parser');
+        }
+        try {
+            const decoder = new TextDecoder();
+            const jsonBytes = new Uint8Array(wasm.memory.buffer, resultPtr, jsonLen);
+            const jsonStr = decoder.decode(jsonBytes);
+            return JSON.parse(jsonStr);
+        }
+        finally {
+            wasm.free(resultPtr, jsonLen);
+        }
     }
-  } finally {
-    if (sourceLen > 0 && sourcePtr) {
-      wasm.free(sourcePtr, sourceLen);
+    finally {
+        if (sourceLen > 0 && sourcePtr) {
+            wasm.free(sourcePtr, sourceLen);
+        }
     }
-  }
 }
-async function parse(source, options = {}) {
-  const wasm = await getWasmInstance();
-  return parseInternal(wasm, source, options);
+/**
+ * Parse JavaScript/TypeScript source code into a Yuku AST.
+ *
+ * @param source - Source code to parse
+ * @param options - Parse options
+ * @returns Yuku AST
+ * @throws Error if parsing fails
+ *
+ * @example
+ * ```ts
+ * const ast = await parse('const x = 5;', {
+ *   sourceType: 'module',
+ *   lang: 'js'
+ * });
+ * ```
+ */
+export 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()");
-  }
-  return parseInternal(wasmInstance, source, options);
+/**
+ * Synchronous parse function (requires WASM to be preloaded).
+ * Use `parse()` for most cases.
+ *
+ * @param source - Source code to parse
+ * @param options - Parse options
+ * @returns Yuku AST
+ * @throws Error if WASM not loaded or parsing fails
+ *
+ * @example
+ * ```ts
+ * await preload(); // Load WASM first
+ * const ast = parseSync('const x = 5;', {
+ *   sourceType: 'module',
+ *   lang: 'js'
+ * });
+ * ```
+ */
+export function parseSync(source, options = {}) {
+    if (!wasmInstance) {
+        throw new Error('WASM not loaded. Call parse() first or manually call preload()');
+    }
+    return parseInternal(wasmInstance, source, options);
 }
-async function preload() {
-  await getWasmInstance();
+/**
+ * Preload WASM module (optional).
+ * Useful if you want to load WASM before first parse.
+ *
+ * @example
+ * ```ts
+ * await preload();
+ * // Now you can use parseSync()
+ * const ast = parseSync('const x = 5;');
+ * ```
+ */
+export async function preload() {
+    await getWasmInstance();
 }
 function normalizeSourceType(sourceType) {
-  return sourceType === "script" ? 0 /* Script */ : 1 /* Module */;
+    return sourceType === 'script' ? SourceType.Script : SourceType.Module;
 }
 function normalizeLang(lang) {
-  switch (lang) {
-    case "ts":
-      return 1 /* TS */;
-    case "jsx":
-      return 2 /* JSX */;
-    case "tsx":
-      return 3 /* TSX */;
-    case "dts":
-      return 4 /* DTS */;
-    default:
-      return 0 /* JS */;
-  }
+    switch (lang) {
+        case 'ts':
+            return Lang.TS;
+        case 'jsx':
+            return Lang.JSX;
+        case 'tsx':
+            return Lang.TSX;
+        case 'dts':
+            return Lang.DTS;
+        default:
+            return Lang.JS;
+    }
 }
-export {
-  preload,
-  parseSync,
-  parse,
-  SourceType,
-  Lang
-};

package/dist/index.d.ts

@@ -1,2 +1 @@
-declare function parse(): string;
-export { parse };
+export declare function parse(): string;

package/dist/index.js

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

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "yuku",
-  "description": "A very fast JavaScript/TypeScript parser written in Zig",
-  "version": "0.2.5",
-  "type": "module",
-  "files": [
-    "dist"
-  ],
+  "version": "0.2.9",
+  "author": "Arshad Yaseen <arshadpyaseen@gmail.com> (https://arshad.fyi)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arshad-yaseen/yuku.git"
+  },
   "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "devDependencies": {
+    "@types/bun": "^1.3.5",
+    "@typescript/native-preview": "^7.0.0-dev.20260109.1"
+  },
   "exports": {
     ".": {
       "import": {
@@ -21,22 +24,28 @@
     },
     "./package.json": "./package.json"
   },
+  "description": "A very fast JavaScript/TypeScript parser written in Zig",
+  "files": [
+    "dist"
+  ],
+  "funding": "https://github.com/sponsors/arshad-yaseen",
+  "homepage": "https://yuku.fyi",
   "license": "MIT",
-  "scripts": {
-    "build": "bunup",
-    "type-check": "tsc --noEmit"
-  },
-  "devDependencies": {
-    "@types/bun": "^1.3.5",
-    "bunup": "^0.16.11",
-    "typescript": "^5.9.3"
-  },
-  "peerDependencies": {
-    "typescript": ">=4.5.0"
-  },
+  "maintainers": [
+    {
+      "name": "Arshad Yaseen",
+      "email": "arshadpyaseen@gmail.com",
+      "url": "https://arshad.fyi"
+    }
+  ],
   "peerDependenciesMeta": {
     "typescript": {
       "optional": true
     }
-  }
+  },
+  "scripts": {
+    "build": "tsgo && cp ../zig-out/bin/yuku.wasm dist"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts"
 }