@bytecodealliance/jco 1.16.0 → 1.17.0

package/package.json

@@ -1,100 +1,99 @@
 {
-  "name": "@bytecodealliance/jco",
-  "version": "1.16.0",
-  "description": "JavaScript tooling for working with WebAssembly Components",
-  "homepage": "https://github.com/bytecodealliance/jco#readme",
-  "author": "Guy Bedford",
-  "contributors": [
-    {
-      "name": "Guy Bedford"
+    "name": "@bytecodealliance/jco",
+    "version": "1.17.0",
+    "description": "JavaScript tooling for working with WebAssembly Components",
+    "keywords": [
+        "Component",
+        "Wasm",
+        "WebAssembly"
+    ],
+    "homepage": "https://github.com/bytecodealliance/jco#readme",
+    "bugs": {
+        "url": "https://github.com/bytecodealliance/jco/issues"
     },
-    {
-      "name": "Victor Adossi",
-      "email": "vadossi@cosmonic.com"
-    }
-  ],
-  "type": "module",
-  "license": "(Apache-2.0 WITH LLVM-exception)",
-  "bugs": {
-    "url": "https://github.com/bytecodealliance/jco/issues"
-  },
-  "keywords": [
-    "Wasm",
-    "WebAssembly",
-    "Component"
-  ],
-  "main": "src/jco.js",
-  "types": "types/jco.d.ts",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/bytecodealliance/jco.git"
-  },
-  "imports": {
-    "#ora": {
-      "types": "./src/ora-shim.d.ts",
-      "browser": "./src/ora-shim.js",
-      "default": "ora"
-    }
-  },
-  "exports": {
-    ".": {
-      "types": "./types/api.d.ts",
-      "browser": "./src/browser.js",
-      "default": "./src/api.js"
+    "license": "(Apache-2.0 WITH LLVM-exception)",
+    "author": "Guy Bedford",
+    "contributors": [
+        {
+            "name": "Guy Bedford"
+        },
+        {
+            "name": "Victor Adossi",
+            "email": "vadossi@cosmonic.com"
+        }
+    ],
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/bytecodealliance/jco.git"
+    },
+    "bin": {
+        "jco": "src/jco.js"
+    },
+    "files": [
+        "lib",
+        "src",
+        "types",
+        "obj/*.core*.wasm",
+        "obj/*.js",
+        "obj/*.ts",
+        "obj/interfaces"
+    ],
+    "type": "module",
+    "main": "src/jco.js",
+    "types": "types/jco.d.ts",
+    "imports": {
+        "#ora": {
+            "types": "./src/ora-shim.d.ts",
+            "browser": "./src/ora-shim.js",
+            "default": "ora"
+        }
+    },
+    "exports": {
+        ".": {
+            "types": "./types/api.d.ts",
+            "browser": "./src/browser.js",
+            "default": "./src/api.js"
+        },
+        "./component": {
+            "types": "./obj/js-component-bindgen-component.d.ts",
+            "default": "./src/browser.js"
+        }
+    },
+    "scripts": {
+        "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": "oxfmt",
+        "fmt:check": "oxfmt --check",
+        "lint": "oxlint",
+        "lint:fix": "npm run lint -- --fix",
+        "test": "vitest run -c test/vitest.ts",
+        "test:lts": "vitest run -c test/vitest.lts.ts",
+        "prepack": "cargo xtask build release"
+    },
+    "dependencies": {
+        "@bytecodealliance/componentize-js": "^0.19.3",
+        "@bytecodealliance/preview2-shim": "^0.17.3",
+        "binaryen": "^123.0.0",
+        "commander": "^14",
+        "mkdirp": "^3",
+        "ora": "^8",
+        "terser": "^5"
     },
-    "./component": {
-      "types": "./obj/js-component-bindgen-component.d.ts",
-      "default": "./src/browser.js"
+    "devDependencies": {
+        "@commitlint/config-conventional": "^19.8.1",
+        "@types/node": "^24.3.0",
+        "commitlint": "^19.8.1",
+        "conventional-changelog-conventionalcommits": "^9.1.0",
+        "mime": "^4.0.7",
+        "oxfmt": "^0.28.0",
+        "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"
     }
-  },
-  "bin": {
-    "jco": "src/jco.js"
-  },
-  "files": [
-    "lib",
-    "src",
-    "types",
-    "obj/*.core*.wasm",
-    "obj/*.js",
-    "obj/*.ts",
-    "obj/interfaces"
-  ],
-  "scripts": {
-    "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",
-    "test": "vitest run -c test/vitest.ts",
-    "test:lts": "vitest run -c test/vitest.lts.ts",
-    "prepack": "cargo xtask build release"
-  },
-  "dependencies": {
-    "@bytecodealliance/componentize-js": "^0.19.3",
-    "@bytecodealliance/preview2-shim": "^0.17.3",
-    "binaryen": "^123.0.0",
-    "commander": "^14",
-    "mkdirp": "^3",
-    "ora": "^8",
-    "terser": "^5"
-  },
-  "devDependencies": {
-    "@commitlint/config-conventional": "^19.8.1",
-    "@types/node": "^24.3.0",
-    "@typescript-eslint/eslint-plugin": "^8.39.1",
-    "@typescript-eslint/parser": "^8.39.1",
-    "commitlint": "^19.8.1",
-    "conventional-changelog-conventionalcommits": "^9.1.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/api.js

@@ -1,9 +1,6 @@
-export { optimizeComponent as opt } from './cmd/opt.js';
-export {
-    transpileComponent as transpile,
-    typesComponent as types,
-} from './cmd/transpile.js';
-import { $init, tools } from '../obj/wasm-tools.js';
+export { optimizeComponent as opt } from "./cmd/opt.js";
+export { transpileComponent as transpile, typesComponent as types } from "./cmd/transpile.js";
+import { $init, tools } from "../obj/wasm-tools.js";
 const {
     print: printFn,
     parse: parseFn,
@@ -73,14 +70,8 @@ export async function metadataShow(binary) {
     return metadataShowFn(binary);
 }
 export function preview1AdapterCommandPath() {
-    return new URL(
-        '../lib/wasi_snapshot_preview1.command.wasm',
-        import.meta.url
-    );
+    return new URL("../lib/wasi_snapshot_preview1.command.wasm", import.meta.url);
 }
 export function preview1AdapterReactorPath() {
-    return new URL(
-        '../lib/wasi_snapshot_preview1.reactor.wasm',
-        import.meta.url
-    );
+    return new URL("../lib/wasi_snapshot_preview1.reactor.wasm", import.meta.url);
 }

package/src/browser.js

@@ -2,7 +2,7 @@ import {
     $init,
     generate as _generate,
     generateTypes as _generateTypes,
-} from '../obj/js-component-bindgen-component.js';
+} from "../obj/js-component-bindgen-component.js";
 
 export async function generate() {
     await $init;

package/src/cmd/componentize.d.ts

@@ -1,2 +1,2 @@
 export function componentize(jsSource: any, opts: any): Promise<void>;
-//# sourceMappingURL=componentize.d.ts.map
+//# sourceMappingURL=componentize.d.ts.map

package/src/cmd/componentize.js

@@ -1,21 +1,19 @@
-import { stat, readFile, writeFile } from 'node:fs/promises';
-import { resolve, basename } from 'node:path';
-import { styleText } from '../common.js';
+import { stat, readFile, writeFile } from "node:fs/promises";
+import { resolve, basename } from "node:path";
+import { styleText } from "../common.js";
 
 /** All features that can be enabled/disabled */
-const ALL_FEATURES = ['clocks', 'http', 'random', 'stdio', 'fetch-event'];
+const ALL_FEATURES = ["clocks", "http", "random", "stdio", "fetch-event"];
 
 /** Features that should be used for --debug mode */
-const DEBUG_FEATURES = ['stdio'];
+const DEBUG_FEATURES = ["stdio"];
 
 export async function componentize(jsSource, opts) {
-    const { componentize: componentizeFn } = await eval(
-        'import("@bytecodealliance/componentize-js")'
-    );
+    const { componentize: componentizeFn } = await eval('import("@bytecodealliance/componentize-js")');
 
     const { disableFeatures, enableFeatures } = calculateFeatureSet(opts);
 
-    const source = await readFile(jsSource, 'utf8');
+    const source = await readFile(jsSource, "utf8");
 
     const witPath = resolve(opts.wit);
     const sourceName = basename(jsSource);
@@ -43,15 +41,13 @@ export async function componentize(jsSource, opts) {
             },
         });
         if (result.debug) {
-            console.error(
-                `${styleText('cyan', 'DEBUG')} Debug output\n${JSON.stringify(debug, null, 2)}\n`
-            );
+            console.error(`${styleText("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"
-        if (err.toString().includes('no known packages')) {
+        if (err.toString().includes("no known packages")) {
             const isFile = await stat(witPath).then((s) => s.isFile());
             if (isFile) {
                 const hint = await printWITPathHint(witPath);
@@ -65,7 +61,7 @@ export async function componentize(jsSource, opts) {
 
     await writeFile(opts.out, component);
 
-    console.log(`${styleText('green', 'OK')} Successfully written ${styleText('bold', opts.out)}.`);
+    console.log(`${styleText("green", "OK")} Successfully written ${styleText("bold", opts.out)}.`);
 }
 
 /**
@@ -75,9 +71,9 @@ export async function componentize(jsSource, opts) {
  * @returns {string} user-visible, highlighted output that can be printed
  */
 async function printWITPathHint(witPath) {
-    const warningPrefix = styleText(['yellow', 'bold'], 'warning');
+    const warningPrefix = styleText(["yellow", "bold"], "warning");
     const pathMeta = await stat(witPath);
-    let output = '\n';
+    let output = "\n";
     if (!pathMeta.isFile() && !pathMeta.isDirectory()) {
         output += `${warningPrefix} The supplited WIT path [${witPath}] is neither a file or directory.\n`;
         return output;
@@ -103,14 +99,14 @@ function calculateFeatureSet(opts) {
     const enable = opts?.enable ?? [];
 
     // Process disabled features
-    if (disable.includes('all')) {
+    if (disable.includes("all")) {
         ALL_FEATURES.forEach((v) => disableFeatures.add(v));
     } else {
         disable.forEach((v) => disableFeatures.add(v));
     }
 
     // Process enabled features
-    if (enable.includes('all')) {
+    if (enable.includes("all")) {
         ALL_FEATURES.forEach((v) => disableFeatures.delete(v));
     } else {
         enable.forEach((v) => disableFeatures.delete(v));

package/src/cmd/opt.d.ts

@@ -5,16 +5,19 @@ export function opt(componentPath: any, opts: any, program: any): Promise<void>;
  * @param {{ quiet: boolean, asyncify?: boolean, optArgs?: string[], noVerify?: boolean }} opts?
  * @returns {Promise<{ component: Uint8Array, compressionInfo: { beforeBytes: number, afterBytes: number }[] >}
  */
-export function optimizeComponent(componentBytes: Uint8Array, opts: {
-    quiet: boolean;
-    asyncify?: boolean;
-    optArgs?: string[];
-    noVerify?: boolean;
-}): Promise<{
+export function optimizeComponent(
+    componentBytes: Uint8Array,
+    opts: {
+        quiet: boolean;
+        asyncify?: boolean;
+        optArgs?: string[];
+        noVerify?: boolean;
+    },
+): Promise<{
     component: Uint8Array;
     compressionInfo: {
         beforeBytes: number;
         afterBytes: number;
     }[];
 }>;
-//# sourceMappingURL=opt.d.ts.map
+//# sourceMappingURL=opt.d.ts.map

package/src/cmd/opt.js

@@ -1,24 +1,16 @@
-import { writeFile } from 'node:fs/promises';
+import { writeFile } from "node:fs/promises";
 
-import { $init, tools } from '../../obj/wasm-tools.js';
+import { $init, tools } from "../../obj/wasm-tools.js";
 const { metadataShow, print } = tools;
-import { fileURLToPath } from 'node:url';
-import {
-    readFile,
-    sizeStr,
-    fixedDigitDisplay,
-    table,
-    spawnIOTmp,
-    setShowSpinner,
-    getShowSpinner,
-} from '../common.js';
-import ora from '#ora';
+import { fileURLToPath } from "node:url";
+import { readFile, sizeStr, fixedDigitDisplay, table, spawnIOTmp, setShowSpinner, getShowSpinner } from "../common.js";
+import ora from "#ora";
 
-import { styleText } from '../common.js';
+import { styleText } from "../common.js";
 
 export async function opt(componentPath, opts, program) {
     await $init;
-    const varIdx = program.parent.rawArgs.indexOf('--');
+    const varIdx = program.parent.rawArgs.indexOf("--");
     if (varIdx !== -1) {
         opts.optArgs = program.parent.rawArgs.slice(varIdx + 1);
     }
@@ -36,7 +28,7 @@ export async function opt(componentPath, opts, program) {
         totalAfterBytes = 0;
 
     if (!opts.quiet) {
-        const tableContent =  table(
+        const tableContent = table(
             [
                 ...compressionInfo.map(({ beforeBytes, afterBytes }, i) => {
                     totalBeforeBytes += beforeBytes;
@@ -44,25 +36,25 @@ export async function opt(componentPath, opts, program) {
                     return [
                         ` - Core Module ${i + 1}:  `,
                         sizeStr(beforeBytes),
-                        ' -> ',
-                        `${styleText('cyan', sizeStr(afterBytes))} `,
+                        " -> ",
+                        `${styleText("cyan", sizeStr(afterBytes))} `,
                         `(${fixedDigitDisplay((afterBytes / beforeBytes) * 100, 2)}%)`,
                     ];
                 }),
-                ['', '', '', '', ''],
+                ["", "", "", "", ""],
                 [
                     ` = Total:  `,
                     `${sizeStr(totalBeforeBytes)}`,
                     ` => `,
-                    `${styleText('cyan', sizeStr(totalAfterBytes))} `,
+                    `${styleText("cyan", sizeStr(totalAfterBytes))} `,
                     `(${fixedDigitDisplay((totalAfterBytes / totalBeforeBytes) * 100, 2)}%)`,
                 ],
             ],
-            [, , , , 'right']
+            [, , , , "right"],
         );
 
         console.log(`
-${styleText('bold', "Optimized WebAssembly Component Internal Core Modules:")}
+${styleText("bold", "Optimized WebAssembly Component Internal Core Modules:")}
 
 ${tableContent}`);
     }
@@ -101,18 +93,16 @@ export async function optimizeComponent(componentBytes, opts) {
             // compute previous LEB128 encoding length
             metadata.prevLEBLen = byteLengthLEB128(size);
         });
-        const coreModules = componentMetadata.filter(
-            ({ metaType }) => metaType.tag === 'module'
-        );
+        const coreModules = componentMetadata.filter(({ metaType }) => metaType.tag === "module");
 
         // log number of core Wasm modules to be run with wasm-opt
         let completed = 0;
         const spinnerText = () =>
-            `${styleText('cyan', `${completed} / ${coreModules.length}`)} Running Binaryen on WebAssembly Component Internal Core Modules \n`;
+            `${styleText("cyan", `${completed} / ${coreModules.length}`)} Running Binaryen on WebAssembly Component Internal Core Modules \n`;
         if (showSpinner) {
             spinner = ora({
-                color: 'cyan',
-                spinner: 'bouncingBar',
+                color: "cyan",
+                spinner: "bouncingBar",
             }).start();
             spinner.text = spinnerText();
         }
@@ -120,34 +110,25 @@ export async function optimizeComponent(componentBytes, opts) {
         // gather the options for wasm-opt. optionally, adding the asyncify flag
         const args = opts?.optArgs
             ? [...opts.optArgs]
-            : [
-                '-Oz',
-                '--low-memory-unused',
-                '--enable-bulk-memory',
-                '--strip-debug',
-            ];
+            : ["-Oz", "--low-memory-unused", "--enable-bulk-memory", "--strip-debug"];
         if (opts?.asyncify) {
-            args.push('--asyncify');
+            args.push("--asyncify");
         }
 
         // process core Wasm modules with wasm-opt
         await Promise.all(
             coreModules.map(async (metadata) => {
-                if (metadata.metaType.tag === 'module') {
+                if (metadata.metaType.tag === "module") {
                     // store the wasm-opt processed module in the metadata
                     metadata.optimized = await wasmOpt(
-                        componentBytes.subarray(
-                            metadata.range[0],
-                            metadata.range[1]
-                        ),
+                        componentBytes.subarray(metadata.range[0], metadata.range[1]),
                         args,
-                        opts
+                        opts,
                     );
 
                     // compute the size change, including the change to
                     // the LEB128 encoding of the size change
-                    const prevModuleSize =
-                        metadata.range[1] - metadata.range[0];
+                    const prevModuleSize = metadata.range[1] - metadata.range[0];
                     const newModuleSize = metadata.optimized.byteLength;
                     metadata.newLEBLen = byteLengthLEB128(newModuleSize);
                     metadata.sizeChange = newModuleSize - prevModuleSize;
@@ -157,7 +138,7 @@ export async function optimizeComponent(componentBytes, opts) {
                         spinner.text = spinnerText();
                     }
                 }
-            })
+            }),
         );
 
         // organize components in modules into tree parent and children
@@ -170,18 +151,11 @@ export async function optimizeComponent(componentBytes, opts) {
                     nodes.splice(i, 1); // remove from nodes
                     i--;
                     metadata.children = getChildren(metadata.index);
-                    metadata.sizeChange = metadata.children.reduce(
-                        (total, { prevLEBLen, newLEBLen, sizeChange }) => {
-                            return sizeChange
-                                ? total + sizeChange + newLEBLen - prevLEBLen
-                                : total;
-                        },
-                        metadata.sizeChange || 0
-                    );
+                    metadata.sizeChange = metadata.children.reduce((total, { prevLEBLen, newLEBLen, sizeChange }) => {
+                        return sizeChange ? total + sizeChange + newLEBLen - prevLEBLen : total;
+                    }, metadata.sizeChange || 0);
                     const prevSize = metadata.range[1] - metadata.range[0];
-                    metadata.newLEBLen = byteLengthLEB128(
-                        prevSize + metadata.sizeChange
-                    );
+                    metadata.newLEBLen = byteLengthLEB128(prevSize + metadata.sizeChange);
                     children.push(metadata);
                 }
             }
@@ -190,31 +164,17 @@ export async function optimizeComponent(componentBytes, opts) {
         const componentTree = getChildren(0);
 
         // compute the total size change in the component binary
-        const sizeChange = componentTree.reduce(
-            (total, { prevLEBLen, newLEBLen, sizeChange }) => {
-                return total + (sizeChange || 0) + newLEBLen - prevLEBLen;
-            },
-            0
-        );
+        const sizeChange = componentTree.reduce((total, { prevLEBLen, newLEBLen, sizeChange }) => {
+            return total + (sizeChange || 0) + newLEBLen - prevLEBLen;
+        }, 0);
 
-        let outComponentBytes = new Uint8Array(
-            componentBytes.byteLength + sizeChange
-        );
+        let outComponentBytes = new Uint8Array(componentBytes.byteLength + sizeChange);
         let nextReadPos = 0,
             nextWritePos = 0;
 
-        const write = ({
-            prevLEBLen,
-            range,
-            optimized,
-            children,
-            sizeChange,
-        }) => {
+        const write = ({ prevLEBLen, range, optimized, children, sizeChange }) => {
             // write from the last read to the LEB byte start
-            outComponentBytes.set(
-                componentBytes.subarray(nextReadPos, range[0] - prevLEBLen),
-                nextWritePos
-            );
+            outComponentBytes.set(componentBytes.subarray(nextReadPos, range[0] - prevLEBLen), nextWritePos);
             nextWritePos += range[0] - prevLEBLen - nextReadPos;
 
             // write the new LEB bytes
@@ -222,8 +182,7 @@ export async function optimizeComponent(componentBytes, opts) {
             do {
                 const byte = val & 0x7f;
                 val >>>= 7;
-                outComponentBytes[nextWritePos++] =
-                    val === 0 ? byte : byte | 0x80;
+                outComponentBytes[nextWritePos++] = val === 0 ? byte : byte | 0x80;
             } while (val !== 0);
 
             if (optimized) {
@@ -237,10 +196,7 @@ export async function optimizeComponent(componentBytes, opts) {
                 children.forEach(write);
             } else {
                 // write component
-                outComponentBytes.set(
-                    componentBytes.subarray(range[0], range[1]),
-                    nextWritePos
-                );
+                outComponentBytes.set(componentBytes.subarray(range[0], range[1]), nextWritePos);
                 nextReadPos = range[1];
                 nextWritePos += range[1] - range[0];
             }
@@ -250,19 +206,14 @@ export async function optimizeComponent(componentBytes, opts) {
         componentTree.forEach(write);
 
         // write remaining
-        outComponentBytes.set(
-            componentBytes.subarray(nextReadPos),
-            nextWritePos
-        );
+        outComponentBytes.set(componentBytes.subarray(nextReadPos), nextWritePos);
 
         // verify it still parses ok
         if (!opts?.noVerify) {
             try {
                 print(outComponentBytes);
             } catch (e) {
-                throw new Error(
-                    `Internal error performing optimization.\n${e.message}`
-                );
+                throw new Error(`Internal error performing optimization.\n${e.message}`);
             }
         }
 
@@ -286,14 +237,12 @@ export async function optimizeComponent(componentBytes, opts) {
  * @returns {Promise<Uint8Array>}
  */
 async function wasmOpt(source, args, transpileOpts) {
-    const wasmOptBin =
-        transpileOpts?.wasmOptBin ??
-        fileURLToPath(import.meta.resolve('binaryen/bin/wasm-opt'));
+    const wasmOptBin = transpileOpts?.wasmOptBin ?? fileURLToPath(import.meta.resolve("binaryen/bin/wasm-opt"));
 
     try {
-        return await spawnIOTmp(wasmOptBin, source, [...args, '-o']);
+        return await spawnIOTmp(wasmOptBin, source, [...args, "-o"]);
     } catch (e) {
-        if (e.toString().includes('BasicBlock requested')) {
+        if (e.toString().includes("BasicBlock requested")) {
             return wasmOpt(source, args);
         }
         throw e;
@@ -301,7 +250,6 @@ async function wasmOpt(source, args, transpileOpts) {
 }
 
 // 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);
+if (typeof __vite_ssr_import_meta__ !== "undefined") {
+    __vite_ssr_import_meta__.resolve = (path) => "file://" + globalCreateRequire(import.meta.url).resolve(path);
 }

package/src/cmd/run.d.ts

@@ -1,3 +1,3 @@
 export function run(componentPath: any, args: any, opts: any): Promise<void>;
 export function serve(componentPath: any, args: any, opts: any): Promise<void>;
-//# sourceMappingURL=run.d.ts.map
+//# sourceMappingURL=run.d.ts.map