@bytecodealliance/jco 1.15.3 → 1.16.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytecodealliance/jco",
-  "version": "1.15.3",
+  "version": "1.16.0",
   "description": "JavaScript tooling for working with WebAssembly Components",
   "homepage": "https://github.com/bytecodealliance/jco#readme",
   "author": "Guy Bedford",
@@ -63,6 +63,7 @@
     "build": "cargo xtask build debug",
     "build:release": "cargo xtask build release",
     "build:types:preview2-shim": "npm run build:types:preview2-shim --include-workspace-root",
+    "build:test:components": "cargo xtask build-test-components",
     "fmt": "npm run lint:fix",
     "lint": "eslint -c ../../eslint.config.mjs --ext .js src test",
     "lint:fix": "npm run lint -- --fix",
@@ -86,12 +87,13 @@
     "@typescript-eslint/parser": "^8.39.1",
     "commitlint": "^19.8.1",
     "conventional-changelog-conventionalcommits": "^9.1.0",
-    "eslint": "^9.33.0",
+    "eslint": "^9.39.1",
     "mime": "^4.0.7",
     "puppeteer": "^24.16.2",
     "semver": "^7.7.1",
     "smol-toml": "^1.4.2",
     "typescript": "^5.9.2",
+    "vite": "^7.1.5",
     "vitest": "^3.2.4",
     "which": "^2.0.2"
   }

package/src/cmd/opt.js

@@ -2,7 +2,7 @@ import { writeFile } from 'node:fs/promises';
 
 import { $init, tools } from '../../obj/wasm-tools.js';
 const { metadataShow, print } = tools;
-import { fileURLToPath } from 'url';
+import { fileURLToPath } from 'node:url';
 import {
     readFile,
     sizeStr,

package/src/cmd/transpile.d.ts

@@ -1,5 +1,9 @@
+import type { Command } from 'commander';
+
 export function types(witPath: any, opts: any): Promise<void>;
+
 export function guestTypes(witPath: any, opts: any): Promise<void>;
+
 /**
  * @param {string} witPath
  * @param {{
@@ -30,7 +34,45 @@ export function typesComponent(witPath: string, opts: {
 }): Promise<{
     [filename: string]: Uint8Array;
 }>;
-export function transpile(componentPath: any, opts: any, program: any): Promise<void>;
+
+
+export function transpile(
+    componentPath: string,
+    opts: TranspilationOptions,
+    program: Command,
+): Promise<TranspilationResult>;
+
+type TranspilationOptions = {
+    name: string;
+    instantiation?: 'async' | 'sync';
+    importBindings?: 'js' | 'optimized' | 'hybrid' | 'direct-optimized';
+    map?: Record<string, string>;
+    asyncMode?: string;
+    asyncImports?: string[];
+    asyncExports?: string[];
+    asyncWasiImports?: string[];
+    asyncWasiExports?: string[];
+    validLiftingOptimization?: boolean;
+    tracing?: boolean;
+    nodejsCompat?: boolean;
+    tlaCompat?: boolean;
+    base64Cutoff?: boolean;
+    js?: boolean;
+    minify?: boolean;
+    optimize?: boolean;
+    namespacedExports?: boolean;
+    outDir?: string;
+    multiMemory?: boolean;
+    experimentalIdlImports?: boolean;
+    optArgs?: string[];
+};
+
+type TranspilationResult = {
+    files: FileBytes;
+    imports: string[];
+    exports: [string, 'function' | 'instance'][];
+};
+
 /**
  *
  * @param {Uint8Array} component

package/src/cmd/transpile.js

@@ -3,7 +3,7 @@
 import { extname, basename, resolve } from 'node:path';
 
 import { minify } from 'terser';
-import { fileURLToPath } from 'url';
+import { fileURLToPath } from 'node:url';
 
 import { optimizeComponent } from './opt.js';
 
@@ -179,6 +179,11 @@ export async function transpileComponent(component, opts = {}) {
             'async exports cannot be specified in sync mode (consider adding --async-mode=jspi)'
         );
     }
+    if (asyncMode === 'sync' && asyncImports.size > 0) {
+        throw new Error(
+            'async imports cannot be specified in sync mode (consider adding --async-mode=jspi)'
+        );
+    }
     let asyncModeObj;
     if (asyncMode === 'sync') {
         asyncModeObj = null;

package/src/common.js

@@ -240,7 +240,7 @@ export async function resolveDefaultWITPath(witPath) {
 }
 
 /**
- * Partial polyfill for 'node:utils' `styleText()`
+ * Partial polyfill for 'node:util' `styleText()`
  *
  * @param {string | string[]} styles - styles to apply to the given text
  * @param {string} text - text that should be styled

package/src/jco.js

@@ -25,7 +25,7 @@ program
     )
     .usage('<command> [options]')
     .enablePositionalOptions()
-    .version('1.15.3');
+    .version('1.16.0');
 
 function myParseInt(value) {
     return parseInt(value, 10);

package/types/common.d.ts

@@ -55,7 +55,7 @@ export function writeFiles(files: Record<string, string>, summaryTitle: boolean)
  */
 export function resolveDefaultWITPath(witPath?: string | undefined): Promise<string>;
 /**
- * Partial polyfill for 'node:utils' `styleText()`
+ * Partial polyfill for 'node:util' `styleText()`
  *
  * @param {string | string[]} styles - styles to apply to the given text
  * @param {string} text - text that should be styled