@zntc/wasm 0.1.5 → 0.1.7

package/README.md

@@ -48,15 +48,23 @@ const result = transpile('const x: number = 1;', { filename: 'input.ts' });
 ### Bundler build
 
 ```ts
-import { build, initBundler, bundlerLastErrorMessage } from '@zntc/wasm';
+import { build, initBundler, bundlerLastErrorMessage, VirtualFileSystem } from '@zntc/wasm';
 import wasmUrl from '@zntc/wasm/zntc-bundler.wasm?url';
 
-await initBundler(wasmUrl); // separate from init() used for transpile
-const out = build('/main.ts', { format: 'esm', target: 'es2020' });
+// The bundler reads a VFS instead of a real file system. Imports in the entry are
+// resolved recursively against the paths registered here.
+const vfs = new VirtualFileSystem();
+vfs.set('/src/util.ts', 'export const scale = (n: number) => n * 2;');
+vfs.set('/src/main.ts', `import { scale } from './util'; export const x = scale(21);`);
+
+await initBundler(vfs, wasmUrl); // separate from init() used for transpile
+const out = build('/src/main.ts', { format: 'esm', target: 'es2020' });
 if (out === null) throw new Error(bundlerLastErrorMessage());
 ```
 
-`build` is synchronous and returns `null` on failure — call `bundlerLastErrorMessage()` to read the last error.
+`build` is synchronous and returns `null` on failure — call `bundlerLastErrorMessage()` to read the last error. When the build produces error diagnostics (an unresolvable import, for example) it returns `null` rather than partial output — the same contract as the CLI ("skip output and exit 1 on errors").
+
+A VFS holds files only; directories exist as path prefixes. To back it with a lazy source (network, IndexedDB), subclass `VirtualFileSystem` and override `get` / `has` / `paths` (and `listDir` / `isDir` if needed).
 
 ## `@zntc/core` vs `@zntc/wasm`
 

package/dist/index.js

@@ -288,6 +288,18 @@ function transpile(source, options = {}) {
     wasm.dealloc(optsPtr, optsLen);
   }
 }
+var VFS_KIND_FILE = 0;
+var VFS_KIND_DIRECTORY = 1;
+function dirPrefix(dir) {
+  if (dir === "" || dir === ".")
+    return "";
+  const trimmed = dir.endsWith("/") && dir.length > 1 ? dir.slice(0, -1) : dir;
+  if (trimmed === "/")
+    return "/";
+  if (trimmed === ".")
+    return "";
+  return `${trimmed}/`;
+}
 
 class VirtualFileSystem {
   files = new Map;
@@ -307,6 +319,39 @@ class VirtualFileSystem {
   paths() {
     return this.files.keys();
   }
+  isDir(dir) {
+    const prefix = dirPrefix(dir);
+    if (prefix.length === 0)
+      return true;
+    for (const path of this.paths()) {
+      if (path.startsWith(prefix))
+        return true;
+    }
+    return false;
+  }
+  listDir(dir) {
+    const prefix = dirPrefix(dir);
+    const files = [];
+    const dirs = new Set;
+    for (const path of this.paths()) {
+      if (prefix.length > 0 && !path.startsWith(prefix))
+        continue;
+      const rest = path.slice(prefix.length);
+      if (rest.length === 0)
+        continue;
+      const slash = rest.indexOf("/");
+      if (slash === -1)
+        files.push(rest);
+      else if (slash > 0)
+        dirs.add(rest.slice(0, slash));
+    }
+    if (files.length === 0 && dirs.size === 0)
+      return null;
+    const entries = files.map((name) => ({ name, kind: VFS_KIND_FILE }));
+    for (const name of dirs)
+      entries.push({ name, kind: VFS_KIND_DIRECTORY });
+    return entries;
+  }
   size() {
     return this.files.size;
   }
@@ -345,27 +390,36 @@ function createBundlerImports(memory) {
       statFile(pathPtr, pathLen, outSize, outKind, outMtimeLo, outMtimeHi) {
         const path = readBundlerString(pathPtr, pathLen);
         const data = bundlerVfs?.get(path);
-        if (!data)
+        const isDir = !data && (bundlerVfs?.isDir(path) ?? false);
+        if (!data && !isDir)
           return 1;
         const view = new DataView(bundlerMemory.buffer);
-        view.setBigUint64(outSize, BigInt(data.length), true);
-        new Uint8Array(bundlerMemory.buffer, outKind, 1)[0] = 0;
+        view.setBigUint64(outSize, BigInt(data?.length ?? 0), true);
+        new Uint8Array(bundlerMemory.buffer, outKind, 1)[0] = isDir ? VFS_KIND_DIRECTORY : VFS_KIND_FILE;
         view.setBigUint64(outMtimeLo, 0n, true);
         view.setBigUint64(outMtimeHi, 0n, true);
         return 0;
       },
       access(pathPtr, pathLen) {
         const path = readBundlerString(pathPtr, pathLen);
-        return bundlerVfs?.has(path) ? 0 : 1;
+        if (!bundlerVfs)
+          return 1;
+        return bundlerVfs.has(path) || bundlerVfs.isDir(path) ? 0 : 1;
       },
       realpath(pathPtr, pathLen) {
         const path = readBundlerString(pathPtr, pathLen);
-        if (!bundlerVfs?.has(path))
+        if (!bundlerVfs)
+          return 0n;
+        if (!bundlerVfs.has(path) && !bundlerVfs.isDir(path))
           return 0n;
         return packBytes(encoder.encode(path));
       },
-      listDir(_pathPtr, _pathLen) {
-        return 0n;
+      listDir(pathPtr, pathLen) {
+        const path = readBundlerString(pathPtr, pathLen);
+        const entries = bundlerVfs?.listDir(path);
+        if (!entries || entries.length === 0)
+          return 0n;
+        return packBytes(encoder.encode(JSON.stringify(entries)));
       },
       hostFreeBytes(ptr, len) {
         bundler?.dealloc(ptr, len);

package/dist/wasm/index.d.ts

@@ -14,6 +14,10 @@ import type { Target, TranspileOptions, TranspileResult } from '../shared/index'
 export declare function init(input?: URL | string | Request | Response | BufferSource | WebAssembly.Module): Promise<void>;
 export declare function initSync(input: WebAssembly.Module | BufferSource): void;
 export declare function transpile(source: string, options?: TranspileOptions): TranspileResult;
+export interface VfsDirEntry {
+    name: string;
+    kind: number;
+}
 export declare class VirtualFileSystem {
     private files;
     set(path: string, content: string | Uint8Array): void;
@@ -21,6 +25,8 @@ export declare class VirtualFileSystem {
     has(path: string): boolean;
     delete(path: string): boolean;
     paths(): IterableIterator<string>;
+    isDir(dir: string): boolean;
+    listDir(dir: string): VfsDirEntry[] | null;
     size(): number;
     clear(): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zntc/wasm",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "ZNTC native transpiler & compiler — WASM build",
   "keywords": [
     "browser",