@bytecodealliance/jco 1.11.3-rc.1 → 1.12.0-rc.1

package/obj/js-component-bindgen-component.js

@@ -21,44 +21,30 @@ const { InputStream,
   OutputStream } = streams;
 const { getRandomBytes } = random;
 
-const base64Compile = str => WebAssembly.compile(typeof Buffer !== 'undefined' ? Buffer.from(str, 'base64') : Uint8Array.from(atob(str), b => b.charCodeAt(0)));
-
-class ComponentError extends Error {
-  constructor (value) {
-    const enumerable = typeof value !== 'string';
-    super(enumerable ? `${String(value)} (see error.payload)` : value);
-    Object.defineProperty(this, 'payload', { value, enumerable });
-  }
-}
-
-let curResourceBorrows = [];
-
 let dv = new DataView(new ArrayBuffer());
 const dataView = mem => dv.buffer === mem.buffer ? dv : dv = new DataView(mem.buffer);
 
-const isNode = typeof process !== 'undefined' && process.versions && process.versions.node;
-let _fs;
-async function fetchCompile (url) {
-  if (isNode) {
-    _fs = _fs || await import('node:fs/promises');
-    return WebAssembly.compile(await _fs.readFile(url));
-  }
-  return fetch(url).then(WebAssembly.compileStreaming);
-}
+const toUint64 = val => BigInt.asUintN(64, BigInt(val));
 
-function getErrorPayload(e) {
-  if (e && hasOwnProperty.call(e, 'payload')) return e.payload;
-  if (e instanceof Error) throw e;
-  return e;
+function toUint32(val) {
+  return val >>> 0;
 }
 
-const hasOwnProperty = Object.prototype.hasOwnProperty;
-
-const instantiateCore = WebAssembly.instantiate;
+const utf8Decoder = new TextDecoder();
 
-const _debugLog = (...args) => {
-  if (!globalThis?.process?.env?.JCO_DEBUG) { return; }
-  console.debug(...args);
+const utf8Encoder = new TextEncoder();
+let utf8EncodedLen = 0;
+function utf8Encode(s, realloc, memory) {
+  if (typeof s !== 'string') throw new TypeError('expected a string');
+  if (s.length === 0) {
+    utf8EncodedLen = 0;
+    return 1;
+  }
+  let buf = utf8Encoder.encode(s);
+  let ptr = realloc(0, 0, 1, buf.length);
+  new Uint8Array(memory.buffer).set(buf, ptr);
+  utf8EncodedLen = buf.length;
+  return ptr;
 }
 
 const T_FLAG = 1 << 30;
@@ -87,6 +73,25 @@ function rscTableRemove (table, handle) {
   return { rep, scope, own };
 }
 
+let curResourceBorrows = [];
+
+const _debugLog = (...args) => {
+  if (!globalThis?.process?.env?.JCO_DEBUG) { return; }
+  console.debug(...args);
+}
+
+const base64Compile = str => WebAssembly.compile(typeof Buffer !== 'undefined' ? Buffer.from(str, 'base64') : Uint8Array.from(atob(str), b => b.charCodeAt(0)));
+
+const isNode = typeof process !== 'undefined' && process.versions && process.versions.node;
+let _fs;
+async function fetchCompile (url) {
+  if (isNode) {
+    _fs = _fs || await import('node:fs/promises');
+    return WebAssembly.compile(await _fs.readFile(url));
+  }
+  return fetch(url).then(WebAssembly.compileStreaming);
+}
+
 const symbolCabiDispose = Symbol.for('cabiDispose');
 
 const symbolRscHandle = Symbol('handle');
@@ -95,34 +100,29 @@ const symbolRscRep = Symbol.for('cabiRep');
 
 const symbolDispose = Symbol.dispose || Symbol.for('dispose');
 
-function throwUninitialized() {
-  throw new TypeError('Wasm uninitialized use `await $init` first');
-}
-
-const toUint64 = val => BigInt.asUintN(64, BigInt(val));
+const handleTables = [];
 
-function toUint32(val) {
-  return val >>> 0;
+class ComponentError extends Error {
+  constructor (value) {
+    const enumerable = typeof value !== 'string';
+    super(enumerable ? `${String(value)} (see error.payload)` : value);
+    Object.defineProperty(this, 'payload', { value, enumerable });
+  }
 }
 
-const utf8Decoder = new TextDecoder();
+function getErrorPayload(e) {
+  if (e && hasOwnProperty.call(e, 'payload')) return e.payload;
+  if (e instanceof Error) throw e;
+  return e;
+}
 
-const utf8Encoder = new TextEncoder();
-let utf8EncodedLen = 0;
-function utf8Encode(s, realloc, memory) {
-  if (typeof s !== 'string') throw new TypeError('expected a string');
-  if (s.length === 0) {
-    utf8EncodedLen = 0;
-    return 1;
-  }
-  let buf = utf8Encoder.encode(s);
-  let ptr = realloc(0, 0, 1, buf.length);
-  new Uint8Array(memory.buffer).set(buf, ptr);
-  utf8EncodedLen = buf.length;
-  return ptr;
+function throwUninitialized() {
+  throw new TypeError('Wasm uninitialized use `await $init` first');
 }
 
-const handleTables = [];
+const hasOwnProperty = Object.prototype.hasOwnProperty;
+
+const instantiateCore = WebAssembly.instantiate;
 
 
 let exports0;

package/obj/wasm-tools.js

@@ -21,44 +21,30 @@ const { InputStream,
   OutputStream } = streams;
 const { getRandomBytes } = random;
 
-const base64Compile = str => WebAssembly.compile(typeof Buffer !== 'undefined' ? Buffer.from(str, 'base64') : Uint8Array.from(atob(str), b => b.charCodeAt(0)));
-
-class ComponentError extends Error {
-  constructor (value) {
-    const enumerable = typeof value !== 'string';
-    super(enumerable ? `${String(value)} (see error.payload)` : value);
-    Object.defineProperty(this, 'payload', { value, enumerable });
-  }
-}
-
-let curResourceBorrows = [];
-
 let dv = new DataView(new ArrayBuffer());
 const dataView = mem => dv.buffer === mem.buffer ? dv : dv = new DataView(mem.buffer);
 
-const isNode = typeof process !== 'undefined' && process.versions && process.versions.node;
-let _fs;
-async function fetchCompile (url) {
-  if (isNode) {
-    _fs = _fs || await import('node:fs/promises');
-    return WebAssembly.compile(await _fs.readFile(url));
-  }
-  return fetch(url).then(WebAssembly.compileStreaming);
-}
+const toUint64 = val => BigInt.asUintN(64, BigInt(val));
 
-function getErrorPayload(e) {
-  if (e && hasOwnProperty.call(e, 'payload')) return e.payload;
-  if (e instanceof Error) throw e;
-  return e;
+function toUint32(val) {
+  return val >>> 0;
 }
 
-const hasOwnProperty = Object.prototype.hasOwnProperty;
-
-const instantiateCore = WebAssembly.instantiate;
+const utf8Decoder = new TextDecoder();
 
-const _debugLog = (...args) => {
-  if (!globalThis?.process?.env?.JCO_DEBUG) { return; }
-  console.debug(...args);
+const utf8Encoder = new TextEncoder();
+let utf8EncodedLen = 0;
+function utf8Encode(s, realloc, memory) {
+  if (typeof s !== 'string') throw new TypeError('expected a string');
+  if (s.length === 0) {
+    utf8EncodedLen = 0;
+    return 1;
+  }
+  let buf = utf8Encoder.encode(s);
+  let ptr = realloc(0, 0, 1, buf.length);
+  new Uint8Array(memory.buffer).set(buf, ptr);
+  utf8EncodedLen = buf.length;
+  return ptr;
 }
 
 const T_FLAG = 1 << 30;
@@ -87,6 +73,25 @@ function rscTableRemove (table, handle) {
   return { rep, scope, own };
 }
 
+let curResourceBorrows = [];
+
+const _debugLog = (...args) => {
+  if (!globalThis?.process?.env?.JCO_DEBUG) { return; }
+  console.debug(...args);
+}
+
+const base64Compile = str => WebAssembly.compile(typeof Buffer !== 'undefined' ? Buffer.from(str, 'base64') : Uint8Array.from(atob(str), b => b.charCodeAt(0)));
+
+const isNode = typeof process !== 'undefined' && process.versions && process.versions.node;
+let _fs;
+async function fetchCompile (url) {
+  if (isNode) {
+    _fs = _fs || await import('node:fs/promises');
+    return WebAssembly.compile(await _fs.readFile(url));
+  }
+  return fetch(url).then(WebAssembly.compileStreaming);
+}
+
 const symbolCabiDispose = Symbol.for('cabiDispose');
 
 const symbolRscHandle = Symbol('handle');
@@ -95,34 +100,29 @@ const symbolRscRep = Symbol.for('cabiRep');
 
 const symbolDispose = Symbol.dispose || Symbol.for('dispose');
 
-function throwUninitialized() {
-  throw new TypeError('Wasm uninitialized use `await $init` first');
-}
-
-const toUint64 = val => BigInt.asUintN(64, BigInt(val));
+const handleTables = [];
 
-function toUint32(val) {
-  return val >>> 0;
+class ComponentError extends Error {
+  constructor (value) {
+    const enumerable = typeof value !== 'string';
+    super(enumerable ? `${String(value)} (see error.payload)` : value);
+    Object.defineProperty(this, 'payload', { value, enumerable });
+  }
 }
 
-const utf8Decoder = new TextDecoder();
+function getErrorPayload(e) {
+  if (e && hasOwnProperty.call(e, 'payload')) return e.payload;
+  if (e instanceof Error) throw e;
+  return e;
+}
 
-const utf8Encoder = new TextEncoder();
-let utf8EncodedLen = 0;
-function utf8Encode(s, realloc, memory) {
-  if (typeof s !== 'string') throw new TypeError('expected a string');
-  if (s.length === 0) {
-    utf8EncodedLen = 0;
-    return 1;
-  }
-  let buf = utf8Encoder.encode(s);
-  let ptr = realloc(0, 0, 1, buf.length);
-  new Uint8Array(memory.buffer).set(buf, ptr);
-  utf8EncodedLen = buf.length;
-  return ptr;
+function throwUninitialized() {
+  throw new TypeError('Wasm uninitialized use `await $init` first');
 }
 
-const handleTables = [];
+const hasOwnProperty = Object.prototype.hasOwnProperty;
+
+const instantiateCore = WebAssembly.instantiate;
 
 
 let exports0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytecodealliance/jco",
-  "version": "1.11.3-rc.1",
+  "version": "1.12.0-rc.1",
   "description": "JavaScript tooling for working with WebAssembly Components",
   "homepage": "https://github.com/bytecodealliance/jco#readme",
   "author": "Guy Bedford",
@@ -66,7 +66,7 @@
     "prepack": "cargo xtask build release"
   },
   "dependencies": {
-    "@bytecodealliance/componentize-js": "^0.17.0",
+    "@bytecodealliance/componentize-js": "^0.18.3",
     "@bytecodealliance/preview2-shim": "^0.17.2",
     "binaryen": "^123.0.0",
     "chalk-template": "^1",
@@ -90,7 +90,7 @@
     "puppeteer": "^24.0.1",
     "semver": "^7.7.1",
     "smol-toml": "^1.3.1",
-    "typescript": "^5.5.4",
+    "typescript": "^5.8.3",
     "vitest": "^3.0.7"
   }
 }

package/src/cmd/componentize.js

@@ -28,7 +28,20 @@ export async function componentize(jsSource, opts) {
             enableFeatures: opts.enable,
             preview2Adapter: opts.preview2Adapter,
             debugBuild: opts.debugStarlingmonkeyBuild,
+            debug: {
+                bindings: opts.debugBindings,
+                bindingsDir: opts.debugBindingsDir,
+                binary: opts.debugBinary,
+                binaryPath: opts.debugBinaryPath,
+                enableWizerLogging: opts.debugEnableWizerLogging,
+            },
         });
+        if (result.debug) {
+            console.error(
+                c`{cyan DEBUG} Debug output\n${JSON.stringify(debug, null, 2)}\n`
+            );
+        }
+
         component = result.component;
     } catch (err) {
         // Detect package resolution issues that usually mean a misconfigured "witPath"

package/src/cmd/transpile.js

@@ -1,26 +1,22 @@
 import { platform } from 'node:process';
-import { writeFile, stat } from 'node:fs/promises';
-import { mkdir } from 'node:fs/promises';
-import { dirname, extname, basename, resolve } from 'node:path';
+import { extname, basename, resolve } from 'node:path';
 
 import c from 'chalk-template';
 import { minify } from 'terser';
 import { fileURLToPath } from 'url';
 
-import {
-    $init,
-    generate,
-    generateTypes,
-} from '../../obj/js-component-bindgen-component.js';
+import { optimizeComponent } from './opt.js';
+
+import { $init, generate } from '../../obj/js-component-bindgen-component.js';
 import {
     readFile,
-    sizeStr,
-    table,
     spawnIOTmp,
     setShowSpinner,
     getShowSpinner,
+    writeFiles,
+    ASYNC_WASI_IMPORTS,
+    ASYNC_WASI_EXPORTS,
 } from '../common.js';
-import { optimizeComponent } from './opt.js';
 import { $init as wasmToolsInit, tools } from '../../obj/wasm-tools.js';
 const { componentEmbed, componentNew } = tools;
 
@@ -28,166 +24,8 @@ import ora from '#ora';
 
 const isWindows = platform === 'win32';
 
-const ASYNC_WASI_IMPORTS = [
-    'wasi:io/poll#poll',
-    'wasi:io/poll#[method]pollable.block',
-    'wasi:io/streams#[method]input-stream.blocking-read',
-    'wasi:io/streams#[method]input-stream.blocking-skip',
-    'wasi:io/streams#[method]output-stream.blocking-flush',
-    'wasi:io/streams#[method]output-stream.blocking-write-and-flush',
-    'wasi:io/streams#[method]output-stream.blocking-write-zeroes-and-flush',
-    'wasi:io/streams#[method]output-stream.blocking-splice',
-];
-
-const ASYNC_WASI_EXPORTS = [
-    'wasi:cli/run#run',
-    'wasi:http/incoming-handler#handle',
-];
-
-export async function types(witPath, opts) {
-    const files = await typesComponent(witPath, opts);
-    await writeFiles(files, opts.quiet ? false : 'Generated Type Files');
-}
-
-export async function guestTypes(witPath, opts) {
-    const files = await typesComponent(witPath, { ...opts, guest: true });
-    await writeFiles(
-        files,
-        opts.quiet
-            ? false
-            : 'Generated Guest Typescript Definition Files (.d.ts)'
-    );
-}
-
-/**
- * @param {string} witPath
- * @param {{
- *   name?: string,
- *   worldName?: string,
- *   instantiation?: 'async' | 'sync',
- *   tlaCompat?: bool,
- *   asyncMode?: string,
- *   asyncImports?: string[],
- *   asyncExports?: string[],
- *   outDir?: string,
- *   allFeatures?: bool,
- *   feature?: string[] | 'all', // backwards compat
- *   features?: string[] | 'all',
- *   asyncWasiImports?: string[],
- *   asyncWasiExports?: string[],
- *   guest?: bool,
- * }} opts
- * @returns {Promise<{ [filename: string]: Uint8Array }>}
- */
-export async function typesComponent(witPath, opts) {
-    await $init;
-    const name =
-        opts.name ||
-        (opts.worldName
-            ? opts.worldName.split(':').pop().split('/').pop()
-            : basename(witPath.slice(0, -extname(witPath).length || Infinity)));
-    let instantiation;
-    if (opts.instantiation) {
-        instantiation = { tag: opts.instantiation };
-    }
-    let outDir = (opts.outDir ?? '').replace(/\\/g, '/');
-    if (!outDir.endsWith('/') && outDir !== '') {
-        outDir += '/';
-    }
-
-    let features = null;
-    if (opts.allFeatures) {
-        features = { tag: 'all' };
-    } else if (Array.isArray(opts.feature)) {
-        features = { tag: 'list', val: opts.feature };
-    } else if (Array.isArray(opts.features)) {
-        features = { tag: 'list', val: opts.features };
-    }
-
-    if (opts.asyncWasiImports) {
-        opts.asyncImports = ASYNC_WASI_IMPORTS.concat(opts.asyncImports || []);
-    }
-    if (opts.asyncWasiExports) {
-        opts.asyncExports = ASYNC_WASI_EXPORTS.concat(opts.asyncExports || []);
-    }
-
-    const asyncMode =
-        !opts.asyncMode || opts.asyncMode === 'sync'
-            ? null
-            : {
-                  tag: opts.asyncMode,
-                  val: {
-                      imports: opts.asyncImports || [],
-                      exports: opts.asyncExports || [],
-                  },
-              };
-
-    let types;
-    const absWitPath = resolve(witPath);
-    try {
-        types = generateTypes(name, {
-            wit: { tag: 'path', val: (isWindows ? '//?/' : '') + absWitPath },
-            instantiation,
-            tlaCompat: opts.tlaCompat ?? false,
-            world: opts.worldName,
-            features,
-            guest: opts.guest ?? false,
-            asyncMode,
-        }).map(([name, file]) => [`${outDir}${name}`, file]);
-    } catch (err) {
-        if (err.toString().includes('does not match previous package name')) {
-            const hint = await printWITLayoutHint(absWitPath);
-            if (err.message) {
-                err.message += `\n${hint}`;
-            }
-            throw err;
-        }
-        throw err;
-    }
-
-    return Object.fromEntries(types);
-}
-
-/**
- * Print a hint about WIT folder layout
- *
- * @param {(string, any) => void} consoleFn
- */
-async function printWITLayoutHint(witPath) {
-    const pathMeta = await stat(witPath);
-    let output = '\n';
-    if (!pathMeta.isFile() && !pathMeta.isDirectory()) {
-        output += c`{yellow.bold warning} The supplited WIT path [${witPath}] is neither a file or directory.\n`;
-        return output;
-    }
-    const ftype = pathMeta.isDirectory() ? 'directory' : 'file';
-    output += c`{yellow.bold warning} Your WIT ${ftype} [${witPath}] may be laid out incorrectly\n`;
-    output += c`{yellow.bold warning} Keep in mind the following rules:\n`;
-    output += c`{yellow.bold warning}     - Top level WIT files are in the same package (i.e. "ns:pkg" in "wit/*.wit")\n`;
-    output += c`{yellow.bold warning}     - All package dependencies should be in "wit/deps" (i.e. "some:dep" in "wit/deps/some-dep.wit"\n`;
-    return output;
-}
-
-async function writeFiles(files, summaryTitle) {
-    await Promise.all(
-        Object.entries(files).map(async ([name, file]) => {
-            await mkdir(dirname(name), { recursive: true });
-            await writeFile(name, file);
-        })
-    );
-    if (!summaryTitle) {
-        return;
-    }
-    console.log(c`
-  {bold ${summaryTitle}:}
-
-${table(
-    Object.entries(files).map(([name, source]) => [
-        c` - {italic ${name}}  `,
-        c`{black.italic ${sizeStr(source.length)}}`,
-    ])
-)}`);
-}
+// These re-exports exist to avoid breaking backwards compatibility
+export { types, guestTypes, typesComponent } from './types.js';
 
 export async function transpile(witPath, opts, program) {
     const varIdx = program?.parent.rawArgs.indexOf('--');

package/src/cmd/types.d.ts

@@ -0,0 +1,33 @@
+export function types(witPath: any, opts: any): Promise<void>;
+export function guestTypes(witPath: any, opts: any): Promise<void>;
+/**
+ * @param {string} witPath
+ * @param {{
+ *   name?: string,
+ *   worldName?: string,
+ *   instantiation?: 'async' | 'sync',
+ *   tlaCompat?: bool,
+ *   asyncMode?: string,
+ *   asyncImports?: string[],
+ *   asyncExports?: string[],
+ *   outDir?: string,
+ *   features?: string[] | 'all',
+ *   guest?: bool,
+ * }} opts
+ * @returns {Promise<{ [filename: string]: Uint8Array }>}
+ */
+export function typesComponent(witPath: string, opts: {
+    name?: string;
+    worldName?: string;
+    instantiation?: "async" | "sync";
+    tlaCompat?: boolean;
+    asyncMode?: string;
+    asyncImports?: string[];
+    asyncExports?: string[];
+    outDir?: string;
+    features?: string[] | "all";
+    guest?: boolean;
+}): Promise<{
+    [filename: string]: Uint8Array;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/src/cmd/types.js

@@ -0,0 +1,147 @@
+import { platform } from 'node:process';
+import { stat } from 'node:fs/promises';
+import { extname, basename, resolve } from 'node:path';
+
+import c from 'chalk-template';
+
+import {
+    $init,
+    generateTypes,
+} from '../../obj/js-component-bindgen-component.js';
+import {
+    writeFiles,
+    ASYNC_WASI_IMPORTS,
+    ASYNC_WASI_EXPORTS,
+} from '../common.js';
+
+const isWindows = platform === 'win32';
+
+export async function types(witPath, opts) {
+    const files = await typesComponent(witPath, opts);
+    await writeFiles(files, opts.quiet ? false : 'Generated Type Files');
+}
+
+export async function guestTypes(witPath, opts) {
+    const files = await typesComponent(witPath, { ...opts, guest: true });
+    await writeFiles(
+        files,
+        opts.quiet
+            ? false
+            : 'Generated Guest Typescript Definition Files (.d.ts)'
+    );
+}
+
+/**
+ * @param {string} witPath
+ * @param {{
+ *   name?: string,
+ *   worldName?: string,
+ *   instantiation?: 'async' | 'sync',
+ *   tlaCompat?: bool,
+ *   asyncMode?: string,
+ *   asyncImports?: string[],
+ *   asyncExports?: string[],
+ *   outDir?: string,
+ *   allFeatures?: bool,
+ *   feature?: string[] | 'all', // backwards compat
+ *   features?: string[] | 'all',
+ *   asyncWasiImports?: string[],
+ *   asyncWasiExports?: string[],
+ *   guest?: bool,
+ * }} opts
+ * @returns {Promise<{ [filename: string]: Uint8Array }>}
+ */
+export async function typesComponent(witPath, opts) {
+    await $init;
+    const name =
+        opts.name ||
+        (opts.worldName
+            ? opts.worldName.split(':').pop().split('/').pop()
+            : basename(witPath.slice(0, -extname(witPath).length || Infinity)));
+    let instantiation;
+    if (opts.instantiation) {
+        instantiation = { tag: opts.instantiation };
+    }
+    let outDir = (opts.outDir ?? '').replace(/\\/g, '/');
+    if (!outDir.endsWith('/') && outDir !== '') {
+        outDir += '/';
+    }
+
+    let features = null;
+    if (opts.allFeatures) {
+        features = { tag: 'all' };
+    } else if (Array.isArray(opts.feature)) {
+        features = { tag: 'list', val: opts.feature };
+    } else if (Array.isArray(opts.features)) {
+        features = { tag: 'list', val: opts.features };
+    }
+
+    if (opts.asyncWasiImports) {
+        opts.asyncImports = ASYNC_WASI_IMPORTS.concat(opts.asyncImports || []);
+    }
+    if (opts.asyncWasiExports) {
+        opts.asyncExports = ASYNC_WASI_EXPORTS.concat(opts.asyncExports || []);
+    }
+
+    const asyncMode =
+        !opts.asyncMode || opts.asyncMode === 'sync'
+            ? null
+            : {
+                  tag: opts.asyncMode,
+                  val: {
+                      imports: opts.asyncImports || [],
+                      exports: opts.asyncExports || [],
+                  },
+              };
+
+    let types;
+    const absWitPath = resolve(witPath);
+    try {
+        types = generateTypes(name, {
+            wit: { tag: 'path', val: (isWindows ? '//?/' : '') + absWitPath },
+            instantiation,
+            tlaCompat: opts.tlaCompat ?? false,
+            world: opts.worldName,
+            features,
+            guest: opts.guest ?? false,
+            asyncMode,
+        }).map(([name, file]) => [`${outDir}${name}`, file]);
+    } catch (err) {
+        if (err.toString().includes('does not match previous package name')) {
+            const hint = await printWITLayoutHint(absWitPath);
+            if (err.message) {
+                err.message += `\n${hint}`;
+            }
+            throw err;
+        }
+        throw err;
+    }
+
+    return Object.fromEntries(types);
+}
+
+/**
+ * Print a hint about WIT folder layout
+ *
+ * @param {(string, any) => void} consoleFn
+ */
+async function printWITLayoutHint(witPath) {
+    const pathMeta = await stat(witPath);
+    let output = '\n';
+    if (!pathMeta.isFile() && !pathMeta.isDirectory()) {
+        output += c`{yellow.bold warning} The supplited WIT path [${witPath}] is neither a file or directory.\n`;
+        return output;
+    }
+    const ftype = pathMeta.isDirectory() ? 'directory' : 'file';
+    output += c`{yellow.bold warning} Your WIT ${ftype} [${witPath}] may be laid out incorrectly\n`;
+    output += c`{yellow.bold warning} Keep in mind the following rules:\n`;
+    output += c`{yellow.bold warning}     - Top level WIT files are in the same package (i.e. "ns:pkg" in "wit/*.wit")\n`;
+    output += c`{yellow.bold warning}     - All package dependencies should be in "wit/deps" (i.e. "some:dep" in "wit/deps/some-dep.wit"\n`;
+    return output;
+}
+
+// see: https://github.com/vitest-dev/vitest/issues/6953#issuecomment-2505310022
+if (typeof __vite_ssr_import_meta__ !== 'undefined') {
+    __vite_ssr_import_meta__.resolve = (path) =>
+        'file://' + globalCreateRequire(import.meta.url).resolve(path);
+}

package/src/common.d.ts

@@ -10,7 +10,10 @@ export function table(data: any, align?: any[]): string;
  */
 export function getTmpDir(): Promise<string>;
 export function spawnIOTmp(cmd: any, input: any, args: any): Promise<Buffer<ArrayBufferLike>>;
+export function writeFiles(files: any, summaryTitle: any): Promise<void>;
 export const isWindows: boolean;
+export const ASYNC_WASI_IMPORTS: string[];
+export const ASYNC_WASI_EXPORTS: string[];
 export { readFileCli as readFile };
 declare function readFileCli(file: any, encoding: any): Promise<Buffer<ArrayBufferLike>>;
 //# sourceMappingURL=common.d.ts.map

package/src/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["common.js"],"names":[],"mappings":"AAWA,+CAEC;AACD,0CAIC;AAED,0CASC;AAED,mEAcC;AAED,wDAoBC;AAED;;;;GAIG;AACH,6CAEC;AAWD,8FAiCC;AAhHD,gCAA8C;;AAsE9C,yFAMC"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["common.js"],"names":[],"mappings":"AA4BA,+CAEC;AACD,0CAIC;AAED,0CASC;AAED,mEAcC;AAED,wDAoBC;AAED;;;;GAIG;AACH,6CAEC;AAWD,8FAiCC;AAED,yEAmBC;AArJD,gCAA8C;AAE9C,0CASE;AAEF,0CAGE;;AAsEF,yFAMC"}

package/src/common.js

@@ -1,13 +1,30 @@
-import { normalize, resolve, sep } from 'node:path';
+import { normalize, resolve, sep, dirname } from 'node:path';
 import { tmpdir } from 'node:os';
-import { readFile, writeFile, rm, mkdtemp } from 'node:fs/promises';
+import { readFile, writeFile, rm, mkdtemp, mkdir } from 'node:fs/promises';
 import { spawn } from 'node:child_process';
 import { argv0 } from 'node:process';
-import c from 'chalk-template';
 import { platform } from 'node:process';
 
+import c from 'chalk-template';
+
 export const isWindows = platform === 'win32';
 
+export const ASYNC_WASI_IMPORTS = [
+    'wasi:io/poll#poll',
+    'wasi:io/poll#[method]pollable.block',
+    'wasi:io/streams#[method]input-stream.blocking-read',
+    'wasi:io/streams#[method]input-stream.blocking-skip',
+    'wasi:io/streams#[method]output-stream.blocking-flush',
+    'wasi:io/streams#[method]output-stream.blocking-write-and-flush',
+    'wasi:io/streams#[method]output-stream.blocking-write-zeroes-and-flush',
+    'wasi:io/streams#[method]output-stream.blocking-splice',
+];
+
+export const ASYNC_WASI_EXPORTS = [
+    'wasi:cli/run#run',
+    'wasi:http/incoming-handler#handle',
+];
+
 let _showSpinner = false;
 export function setShowSpinner(val) {
     _showSpinner = val;
@@ -119,3 +136,24 @@ export async function spawnIOTmp(cmd, input, args) {
         await rm(tmpDir, { recursive: true });
     }
 }
+
+export async function writeFiles(files, summaryTitle) {
+    await Promise.all(
+        Object.entries(files).map(async ([name, file]) => {
+            await mkdir(dirname(name), { recursive: true });
+            await writeFile(name, file);
+        })
+    );
+    if (!summaryTitle) {
+        return;
+    }
+    console.log(c`
+  {bold ${summaryTitle}:}
+
+${table(
+    Object.entries(files).map(([name, source]) => [
+        c` - {italic ${name}}  `,
+        c`{black.italic ${sizeStr(source.length)}}`,
+    ])
+)}`);
+}

package/src/jco.js

@@ -4,7 +4,8 @@ import c from 'chalk-template';
 import { program, Option } from 'commander';
 
 import { opt } from './cmd/opt.js';
-import { transpile, types, guestTypes } from './cmd/transpile.js';
+import { transpile } from './cmd/transpile.js';
+import { types, guestTypes } from './cmd/types.js';
 import { run as runCmd, serve as serveCmd } from './cmd/run.js';
 import {
     parse,
@@ -23,7 +24,7 @@ program
         c`{bold jco - WebAssembly JS Component Tools}\n      JS Component Transpilation Bindgen & Wasm Tools for JS`
     )
     .usage('<command> [options]')
-    .version('1.11.3-rc.1');
+    .version('1.12.0-rc.1');
 
 function myParseInt(value) {
     return parseInt(value, 10);
@@ -68,6 +69,23 @@ program
         'use a debug build of StarlingMonkey'
     )
     .requiredOption('-o, --out <out>', 'output component file')
+    .option(
+        '--debug-bindings',
+        'Output debug bindings and metadata during componentization (by default to stderr)'
+    )
+    .option(
+        '--debug-bindings-dir <dir>',
+        'Directory to which to output generated bindings and metadata'
+    )
+    .option(
+        '--debug-binary',
+        'Output binary (without component metadata) created during componentization (by default to tmp dir)'
+    )
+    .option(
+        '--debug-binary-path <path>',
+        'Path to which to write the generated debug binary'
+    )
+    .option('--debug-enable-wizer-logging', 'Enable wizer call debugging')
     .action(asyncAction(componentize));
 
 program