@bytecodealliance/jco 0.4.1 → 0.4.2

package/README.md

@@ -18,11 +18,12 @@
 
 Features include:
 
+* Creating WebAssembly Components from JavaScript sources and a WIT world
 * "Transpiling" Wasm Component binaries into ES modules that can run in any JS environment.
-* Optimization helpers for Components via Binaryen
+* Optimization helpers for Components via Binaryen.
 * Component builds of [Wasm Tools](https://github.com/bytecodealliance/wasm-tools) helpers, available for use as a library or CLI commands for use in native JS environments.
 
-For creating components, see the [Cargo Component](https://github.com/bytecodealliance/cargo-Component) project for Rust and [Wit Bindgen](https://github.com/bytecodealliance/wit-bindgen) for various guest bindgen helpers.
+For creating components in other languages, see the [Cargo Component](https://github.com/bytecodealliance/cargo-Component) project for Rust and [Wit Bindgen](https://github.com/bytecodealliance/wit-bindgen) for various guest bindgen helpers.
 
 > **Note**: This is an experimental project, no guarantees are provided for stability or support and breaking changes may be made in future.
 
@@ -38,10 +39,42 @@ jco can be used as either a library or as a CLI via the `jco` CLI command.
 
 See the [example workflow](EXAMPLE.md) page for a full usage example.
 
+## CLI
+
+```shell
+Usage: jco <command> [options]
+
+jco - WebAssembly JS Component Tools
+      JS Component Transpilation Bindgen & Wasm Tools for JS
+
+Options:
+  -V, --version                         output the version number
+  -h, --help                            display help for command
+
+Commands:
+  componentize [options] <js-source>    Create a component from a JavaScript module
+  transpile [options] <component-path>  Transpile a WebAssembly Component to JS + core Wasm for JavaScript execution
+  opt [options] <component-file>        optimizes a Wasm component, including running wasm-opt Binaryen optimizations
+  wit [options] <component-path>        extract the WIT from a WebAssembly Component [wasm-tools component wit]
+  print [options] <input>               print the WebAssembly WAT text for a binary file [wasm-tools print]
+  metadata-show [options] [module]      extract the producer metadata for a Wasm binary [wasm-tools metadata show]
+  metadata-add [options] [module]       add producer metadata for a Wasm binary [wasm-tools metadata add]
+  parse [options] <input>               parses the Wasm text format into a binary file [wasm-tools parse]
+  new [options] <core-module>           create a WebAssembly component adapted from a component core Wasm [wasm-tools component new]
+  embed [options] [core-module]         embed the component typing section into a core Wasm module [wasm-tools component embed]
+  help [command]                        display help for command
+```
+
 ## API
 
 The below is an outline of the available API functions, see [api.d.ts](api.d.ts) file for the exact options.
 
+#### `componentize(jsSource: String, witWorld: String, opts?): Promise<{ component: Uint8Array }>`
+
+Creates a component from a JS file and WIT world definition, via a Spidermonkey engine embedding.
+
+See [ComponentizeJS](https://github.com/bytecodealliance/componentize-js) for more details on this process.
+
 #### `transpile(component: Uint8Array, opts?): Promise<{ files: Record<string, Uint8Array> }>`
 
 Transpile a Component to JS.
@@ -92,31 +125,6 @@ Parse a compoment WAT to output a Component binary.
 
 Add new producer metadata to a component or core Wasm binary.
 
-## CLI
-
-```shell
-Usage: jco <command> [options]
-
-jco - WebAssembly JS Component Tools
-       JS Component Transpilation Bindgen & Wasm Tools for JS
-
-Options:
-  -V, --version                         output the version number
-  -h, --help                            display help for command
-
-Commands:
-  transpile [options] <component-path>  Transpile a WebAssembly Component to JS + core Wasm for JavaScript execution
-  opt [options] <component-file>        optimizes a Wasm component, including running wasm-opt Binaryen optimizations
-  wit [options] <component-path>        extract the WIT from a WebAssembly Component [wasm-tools component wit]
-  print [options] <input>               print the WebAssembly WAT text for a binary file [wasm-tools print]
-  metadata-show [options] [module]      extract the producer metadata for a Wasm binary [wasm-tools metadata show]
-  metadata-add [options] [module]       add producer metadata for a Wasm binary [wasm-tools metadata add]
-  parse [options] <input>               parses the Wasm text format into a binary file [wasm-tools parse]
-  new [options] <core-module>           create a WebAssembly component adapted from a component core Wasm [wasm-tools component new]
-  embed [options] [core-module]         embed the component typing section into a core Wasm module [wasm-tools component embed]
-  help [command]                        display help for command
-```
-
 ## Contributing
 
 Development is based on a standard `npm install && npm run build && npm run test` workflow.

package/api.mjs

@@ -1,3 +1,4 @@
+import * as __WEBPACK_EXTERNAL_MODULE__bytecodealliance_componentize_js_a7e85369__ from "@bytecodealliance/componentize-js";
 import { createRequire as __WEBPACK_EXTERNAL_createRequire } from "module";
 /******/ var __webpack_modules__ = ({
 
@@ -6835,6 +6836,15 @@ function bisearch(ucs) {
 }
 
 
+/***/ }),
+
+/***/ 9291:
+/***/ ((module, __unused_webpack_exports, __nccwpck_require__) => {
+
+var x = y => { var x = {}; __nccwpck_require__.d(x, y); return x; }
+var y = x => () => x
+module.exports = x({ ["componentize"]: () => __WEBPACK_EXTERNAL_MODULE__bytecodealliance_componentize_js_a7e85369__.componentize });
+
 /***/ }),
 
 /***/ 9491:
@@ -40920,11 +40930,13 @@ __nccwpck_require__.a(__webpack_module__, async (__webpack_handle_async_dependen
 /* harmony export */   "S0": () => (/* binding */ print),
 /* harmony export */   "Xs": () => (/* binding */ metadataAdd),
 /* harmony export */   "YO": () => (/* binding */ componentWit),
-/* harmony export */   "eL": () => (/* binding */ metadataShow)
+/* harmony export */   "eL": () => (/* binding */ metadataShow),
+/* harmony export */   "he": () => (/* reexport safe */ _bytecodealliance_componentize_js__WEBPACK_IMPORTED_MODULE_3__.componentize)
 /* harmony export */ });
 /* harmony import */ var _cmd_opt_js__WEBPACK_IMPORTED_MODULE_0__ = __nccwpck_require__(5862);
 /* harmony import */ var _cmd_transpile_js__WEBPACK_IMPORTED_MODULE_1__ = __nccwpck_require__(2229);
 /* harmony import */ var _obj_wasm_tools_js__WEBPACK_IMPORTED_MODULE_2__ = __nccwpck_require__(8980);
+/* harmony import */ var _bytecodealliance_componentize_js__WEBPACK_IMPORTED_MODULE_3__ = __nccwpck_require__(9291);
 var __webpack_async_dependencies__ = __webpack_handle_async_dependencies__([_cmd_opt_js__WEBPACK_IMPORTED_MODULE_0__, _cmd_transpile_js__WEBPACK_IMPORTED_MODULE_1__, _obj_wasm_tools_js__WEBPACK_IMPORTED_MODULE_2__]);
 ([_cmd_opt_js__WEBPACK_IMPORTED_MODULE_0__, _cmd_transpile_js__WEBPACK_IMPORTED_MODULE_1__, _obj_wasm_tools_js__WEBPACK_IMPORTED_MODULE_2__] = __webpack_async_dependencies__.then ? (await __webpack_async_dependencies__)() : __webpack_async_dependencies__);
 
@@ -40932,6 +40944,7 @@ var __webpack_async_dependencies__ = __webpack_handle_async_dependencies__([_cmd
 
 const { parse, print, componentNew, componentWit, componentEmbed, metadataAdd, metadataShow } = _obj_wasm_tools_js__WEBPACK_IMPORTED_MODULE_2__/* .exports */ .I;
 
+
 __webpack_async_result__();
 } catch(e) { __webpack_async_result__(e); } });
 
@@ -41093,7 +41106,7 @@ async function optimizeComponent (componentBytes, opts) {
  * @param {Uint8Array} source 
  * @returns {Promise<Uint8Array>}
  */
-async function wasmOpt (source, args = ['-tnh', '--gufa', '--flatten', '--rereloop', '-Oz', '-Oz', '--low-memory-unused', '--enable-bulk-memory']) {
+async function wasmOpt (source, args = ['-O1', '--low-memory-unused', '--enable-bulk-memory']) {
   try {
     return await (0,_common_js__WEBPACK_IMPORTED_MODULE_4__/* .spawnIOTmp */ .np)(WASM_OPT, source, [
       ...args, '-o'
@@ -41824,11 +41837,12 @@ module.exports = JSON.parse('{"dots":{"interval":80,"frames":["⠋","⠙","⠹",
 /******/ var __webpack_exports__componentEmbed = __webpack_exports__.Ch;
 /******/ var __webpack_exports__componentNew = __webpack_exports__.LM;
 /******/ var __webpack_exports__componentWit = __webpack_exports__.YO;
+/******/ var __webpack_exports__componentize = __webpack_exports__.he;
 /******/ var __webpack_exports__metadataAdd = __webpack_exports__.Xs;
 /******/ var __webpack_exports__metadataShow = __webpack_exports__.eL;
 /******/ var __webpack_exports__opt = __webpack_exports__.MD;
 /******/ var __webpack_exports__parse = __webpack_exports__.Qc;
 /******/ var __webpack_exports__print = __webpack_exports__.S0;
 /******/ var __webpack_exports__transpile = __webpack_exports__.LZ;
-/******/ export { __webpack_exports__componentEmbed as componentEmbed, __webpack_exports__componentNew as componentNew, __webpack_exports__componentWit as componentWit, __webpack_exports__metadataAdd as metadataAdd, __webpack_exports__metadataShow as metadataShow, __webpack_exports__opt as opt, __webpack_exports__parse as parse, __webpack_exports__print as print, __webpack_exports__transpile as transpile };
+/******/ export { __webpack_exports__componentEmbed as componentEmbed, __webpack_exports__componentNew as componentNew, __webpack_exports__componentWit as componentWit, __webpack_exports__componentize as componentize, __webpack_exports__metadataAdd as metadataAdd, __webpack_exports__metadataShow as metadataShow, __webpack_exports__opt as opt, __webpack_exports__parse as parse, __webpack_exports__print as print, __webpack_exports__transpile as transpile };
 /******/ 

package/cli.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { createRequire as __WEBPACK_EXTERNAL_createRequire } from "module";
+import * as __WEBPACK_EXTERNAL_MODULE__bytecodealliance_componentize_js_a7e85369__ from "@bytecodealliance/componentize-js";
 /******/ var __webpack_modules__ = ({
 
 /***/ 2068:
@@ -44229,6 +44230,39 @@ await $init;
 __webpack_async_result__();
 } catch(e) { __webpack_async_result__(e); } }, 1);
 
+/***/ }),
+
+/***/ 3452:
+/***/ ((__unused_webpack___webpack_module__, __webpack_exports__, __nccwpck_require__) => {
+
+
+// EXPORTS
+__nccwpck_require__.d(__webpack_exports__, {
+  "h": () => (/* binding */ componentize)
+});
+
+// EXTERNAL MODULE: external "node:fs/promises"
+var promises_ = __nccwpck_require__(3977);
+;// CONCATENATED MODULE: external "@bytecodealliance/componentize-js"
+var x = y => { var x = {}; __nccwpck_require__.d(x, y); return x; }
+var y = x => () => x
+const componentize_js_namespaceObject = x({ ["componentize"]: () => __WEBPACK_EXTERNAL_MODULE__bytecodealliance_componentize_js_a7e85369__.componentize });
+// EXTERNAL MODULE: ./node_modules/chalk-template/index.js
+var chalk_template = __nccwpck_require__(267);
+;// CONCATENATED MODULE: ./src/cmd/componentize.js
+
+
+
+
+async function componentize (jsSource, opts) {
+  const source = await (0,promises_.readFile)(jsSource, 'utf8');
+  const wit = await (0,promises_.readFile)(opts.wit, 'utf8');
+  const { component, imports } = await (0,componentize_js_namespaceObject.componentize)(source, wit);
+  await (0,promises_.writeFile)(opts.out, component);
+  console.log(chalk_template/* default */.Z`{green OK} Successfully written {bold ${opts.out}} with imports (${imports.join(', ')}).`);
+}
+
+
 /***/ }),
 
 /***/ 5862:
@@ -44387,7 +44421,7 @@ async function optimizeComponent (componentBytes, opts) {
  * @param {Uint8Array} source 
  * @returns {Promise<Uint8Array>}
  */
-async function wasmOpt (source, args = ['-tnh', '--gufa', '--flatten', '--rereloop', '-Oz', '-Oz', '--low-memory-unused', '--enable-bulk-memory']) {
+async function wasmOpt (source, args = ['-O1', '--low-memory-unused', '--enable-bulk-memory']) {
   try {
     return await (0,_common_js__WEBPACK_IMPORTED_MODULE_4__/* .spawnIOTmp */ .np)(WASM_OPT, source, [
       ...args, '-o'
@@ -45079,7 +45113,8 @@ __nccwpck_require__.a(__webpack_module__, async (__webpack_handle_async_dependen
 /* harmony import */ var _cmd_opt_js__WEBPACK_IMPORTED_MODULE_1__ = __nccwpck_require__(5862);
 /* harmony import */ var _cmd_transpile_js__WEBPACK_IMPORTED_MODULE_2__ = __nccwpck_require__(2229);
 /* harmony import */ var _cmd_wasm_tools_js__WEBPACK_IMPORTED_MODULE_3__ = __nccwpck_require__(8154);
-/* harmony import */ var chalk_template__WEBPACK_IMPORTED_MODULE_4__ = __nccwpck_require__(267);
+/* harmony import */ var _cmd_componentize_js__WEBPACK_IMPORTED_MODULE_4__ = __nccwpck_require__(3452);
+/* harmony import */ var chalk_template__WEBPACK_IMPORTED_MODULE_5__ = __nccwpck_require__(267);
 var __webpack_async_dependencies__ = __webpack_handle_async_dependencies__([_cmd_opt_js__WEBPACK_IMPORTED_MODULE_1__, _cmd_transpile_js__WEBPACK_IMPORTED_MODULE_2__, _cmd_wasm_tools_js__WEBPACK_IMPORTED_MODULE_3__]);
 ([_cmd_opt_js__WEBPACK_IMPORTED_MODULE_1__, _cmd_transpile_js__WEBPACK_IMPORTED_MODULE_2__, _cmd_wasm_tools_js__WEBPACK_IMPORTED_MODULE_3__] = __webpack_async_dependencies__.then ? (await __webpack_async_dependencies__)() : __webpack_async_dependencies__);
 
@@ -45088,8 +45123,9 @@ var __webpack_async_dependencies__ = __webpack_handle_async_dependencies__([_cmd
 
 
 
+
 commander__WEBPACK_IMPORTED_MODULE_0__/* .program.name */ .Nx.name('jco')
-  .description(chalk_template__WEBPACK_IMPORTED_MODULE_4__/* ["default"] */ .Z`{bold jco - WebAssembly JS Component Tools}\n       JS Component Transpilation Bindgen & Wasm Tools for JS`)
+  .description(chalk_template__WEBPACK_IMPORTED_MODULE_5__/* ["default"] */ .Z`{bold jco - WebAssembly JS Component Tools}\n      JS Component Transpilation Bindgen & Wasm Tools for JS`)
   .usage('<command> [options]')
   .version('0.1.0');
 
@@ -45097,6 +45133,14 @@ function myParseInt(value) {
   return parseInt(value, 10);
 }
 
+commander__WEBPACK_IMPORTED_MODULE_0__/* .program.command */ .Nx.command('componentize')
+  .description('Create a component from a JavaScript module')
+  .usage('<js-source> -o <component-path>')
+  .argument('<js-source>', 'JS source file to build')
+  .requiredOption('-w, --wit <world>', 'WIT world to build with')
+  .requiredOption('-o, --out <out>', 'output component file')
+  .action(asyncAction(_cmd_componentize_js__WEBPACK_IMPORTED_MODULE_4__/* .componentize */ .h));
+
 commander__WEBPACK_IMPORTED_MODULE_0__/* .program.command */ .Nx.command('transpile')
   .description('Transpile a WebAssembly Component to JS + core Wasm for JavaScript execution')
   .usage('<component-path> -o <out-dir>')
@@ -45105,7 +45149,6 @@ commander__WEBPACK_IMPORTED_MODULE_0__/* .program.command */ .Nx.command('transp
   .requiredOption('-o, --out-dir <out-dir>', 'output directory')
   .option('-m, --minify', 'minify the JS output (--optimize / opt cmd still required)')
   .option('-O, --optimize', 'optimize the component first')
-  .option('-a, --args', 'when using --optimize, custom binaryen argument flags to pass')
   .option('--no-typescript', 'do not output TypeScript .d.ts types')
   .option('--valid-lifting-optimization', 'optimize component binary validations assuming all lifted values are valid')
   .option('-b, --base64-cutoff <bytes>', 'set the byte size under which core Wasm binaries will be inlined as base64', myParseInt)
@@ -45190,7 +45233,7 @@ function asyncAction (cmd) {
       catch (e) {
         process.stdout.write(`(jsct ${cmd.name}) `);
         if (typeof e === 'string') {
-          console.error(chalk_template__WEBPACK_IMPORTED_MODULE_4__/* ["default"] */ .Z`{red.bold Error}: ${e}\n`);
+          console.error(chalk_template__WEBPACK_IMPORTED_MODULE_5__/* ["default"] */ .Z`{red.bold Error}: ${e}\n`);
         } else {
           console.error(e);
         }

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@bytecodealliance/jco",
   "description": "JavaScript tooling for working with WebAssembly Components",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "exports": "./api.mjs",
   "types": "api.d.ts",
   "author": "Guy Bedford",
   "bin": {
     "jco": "cli.mjs"
   },
+  "dependencies": {
+    "@bytecodealliance/componentize-js": "^0.0.1"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/bytecodealliance/jco.git"