@bytecodealliance/jco 1.13.3 → 1.15.0

package/src/cmd/types.js

@@ -1,27 +1,56 @@
-import { platform } from 'node:process';
-import { stat } from 'node:fs/promises';
+import { stat, mkdir } 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 {
+    isWindows,
     writeFiles,
+    resolveDefaultWITPath,
+    styleText,
     ASYNC_WASI_IMPORTS,
     ASYNC_WASI_EXPORTS,
+    DEFAULT_ASYNC_MODE,
 } from '../common.js';
 
-const isWindows = platform === 'win32';
+/** Default relative path for guest type declaration generation */
+const DEFAULT_GUEST_TYPES_OUTPUT_DIR_PATH = './types/generated/wit/guest';
+
+/** Default relative path for host type declaration generation */
+const DEFAULT_HOST_TYPES_OUTPUT_DIR_PATH = './types/generated/wit/host';
 
 export async function types(witPath, opts) {
+    witPath = await resolveDefaultWITPath(witPath);
+
+    // Use the default output directory if one was not provided
+    if (!opts.outDir) {
+        await mkdir(DEFAULT_HOST_TYPES_OUTPUT_DIR_PATH, { recursive: true });
+        opts.outDir = resolve(DEFAULT_HOST_TYPES_OUTPUT_DIR_PATH);
+        console.error(
+            `no output directory specified for host type declarations, using [${DEFAULT_HOST_TYPES_OUTPUT_DIR_PATH}]`
+        );
+    }
+
     const files = await typesComponent(witPath, opts);
+
     await writeFiles(files, opts.quiet ? false : 'Generated Type Files');
 }
 
 export async function guestTypes(witPath, opts) {
+    witPath = await resolveDefaultWITPath(witPath);
+
+    // Use the default output directory if one was not provided
+    if (!opts.outDir) {
+        await mkdir(DEFAULT_GUEST_TYPES_OUTPUT_DIR_PATH, { recursive: true });
+        opts.outDir = resolve(DEFAULT_GUEST_TYPES_OUTPUT_DIR_PATH);
+        console.error(
+            `no output directory specified for guest type declarations, using [${DEFAULT_GUEST_TYPES_OUTPUT_DIR_PATH}]`
+        );
+    }
+
     const files = await typesComponent(witPath, { ...opts, guest: true });
     await writeFiles(
         files,
@@ -47,6 +76,8 @@ export async function guestTypes(witPath, opts) {
  *   features?: string[] | 'all',
  *   asyncWasiImports?: string[],
  *   asyncWasiExports?: string[],
+ *   asyncExports?: string[],
+ *   asyncImports?: string[],
  *   guest?: bool,
  * }} opts
  * @returns {Promise<{ [filename: string]: Uint8Array }>}
@@ -67,6 +98,7 @@ export async function typesComponent(witPath, opts) {
         outDir += '/';
     }
 
+    // Bulid list of enabled features
     let features = null;
     if (opts.allFeatures) {
         features = { tag: 'all' };
@@ -76,24 +108,36 @@ export async function typesComponent(witPath, opts) {
         features = { tag: 'list', val: opts.features };
     }
 
+    // Build list of async imports/exports
+    let asyncImports = new Set([...(opts.asyncImports ?? [])]);
     if (opts.asyncWasiImports) {
-        opts.asyncImports = ASYNC_WASI_IMPORTS.concat(opts.asyncImports || []);
+        ASYNC_WASI_IMPORTS.forEach((v) => asyncImports.add(v));
     }
+    let asyncExports = new Set([...(opts.asyncExports ?? [])]);
     if (opts.asyncWasiExports) {
-        opts.asyncExports = ASYNC_WASI_EXPORTS.concat(opts.asyncExports || []);
+        ASYNC_WASI_EXPORTS.forEach((v) => asyncExports.add(v));
     }
 
-    const asyncMode =
-        !opts.asyncMode || opts.asyncMode === 'sync'
-            ? null
-            : {
-                  tag: opts.asyncMode,
-                  val: {
-                      imports: opts.asyncImports || [],
-                      exports: opts.asyncExports || [],
-                  },
-              };
+    // For simple type generation, we choose the "async mode" for the user
+    // even though it is not relevant here (JSPI may not be used, as types may
+    // be used to generate a guest that is never transpiled).
+    let asyncMode = opts.asyncMode ?? DEFAULT_ASYNC_MODE;
+    let asyncModeObj;
+    if (asyncMode === 'jspi' || asyncExports.size > 0) {
+        asyncModeObj = {
+            tag: 'jspi',
+            val: {
+                imports: [...asyncImports],
+                exports: [...asyncExports],
+            },
+        };
+    } else if (asyncMode === 'sync') {
+        asyncModeObj = null;
+    } else {
+        throw new Error(`invalid/unrecognized async mode [${asyncMode}]`);
+    }
 
+    // Run the type generation
     let types;
     const absWitPath = resolve(witPath);
     try {
@@ -104,7 +148,7 @@ export async function typesComponent(witPath, opts) {
             world: opts.worldName,
             features,
             guest: opts.guest ?? false,
-            asyncMode,
+            asyncMode: asyncModeObj,
         }).map(([name, file]) => [`${outDir}${name}`, file]);
     } catch (err) {
         if (err.toString().includes('does not match previous package name')) {
@@ -126,17 +170,18 @@ export async function typesComponent(witPath, opts) {
  * @param {(string, any) => void} consoleFn
  */
 async function printWITLayoutHint(witPath) {
+    const warningPrefix = styleText(['yellow', 'bold'], 'warning');
     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`;
+        output += `${warningPrefix} 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`;
+    output += `${warningPrefix} Your WIT ${ftype} [${witPath}] may be laid out incorrectly\n`;
+    output += `${warningPrefix} Keep in mind the following rules:\n`;
+    output += `${warningPrefix}     - Top level WIT files are in the same package (i.e. "ns:pkg" in "wit/*.wit")\n`;
+    output += `${warningPrefix}     - All package dependencies should be in "wit/deps" (i.e. "some:dep" in "wit/deps/some-dep.wit"\n`;
     return output;
 }
 

package/src/cmd/wasm-tools.js

@@ -1,5 +1,7 @@
+import { resolve, basename, extname } from 'node:path';
 import { writeFile } from 'node:fs/promises';
-import { readFile, isWindows } from '../common.js';
+
+import { readFile, isWindows, styleText } from '../common.js';
 import { $init, tools } from '../../obj/wasm-tools.js';
 const {
     print: printFn,
@@ -10,8 +12,6 @@ const {
     metadataAdd: metadataAddFn,
     metadataShow: metadataShowFn,
 } = tools;
-import { resolve, basename, extname } from 'node:path';
-import c from 'chalk-template';
 
 export async function parse(file, opts) {
     await $init;
@@ -142,19 +142,19 @@ export async function metadataShow(file, opts) {
             output += '  '.repeat(stack.length - 1);
             const indent = '  '.repeat(stack.length);
             if (metaType.tag === 'component') {
-                output += c`{bold [component${name ? ' ' + name : ''}]}\n`;
+                output += `${styleText('bold', `[component${name ? ' ' + name : ''}]`)}\n`;
                 if (metaType.val > 0) {
                     stack.push(metaType.val);
                 }
             } else {
-                output += c`{bold [module${name ? ' ' + name : ''}]}\n`;
+                output += `${styleText('bold', `[module${name ? ' ' + name : ''}]`)}\n`;
             }
             if (producers.length === 0) {
                 output += `${indent}(no metadata)\n`;
             }
             for (const [field, items] of producers) {
                 for (const [name, version] of items) {
-                    output += `${indent}${(field + ':').padEnd(13, ' ')} ${name}${version ? c`{cyan  ${version}}` : ''}\n`;
+                    output += `${indent}${(field + ':').padEnd(13, ' ')} ${name}${version ? `${styleText('cyan', version)}` : ''}\n`;
                 }
             }
             output += '\n';

package/src/common.js

@@ -1,11 +1,17 @@
 import { normalize, resolve, sep, dirname } from 'node:path';
 import { tmpdir } from 'node:os';
-import { readFile, writeFile, rm, mkdtemp, mkdir } from 'node:fs/promises';
+import {
+    readFile,
+    writeFile,
+    rm,
+    mkdtemp,
+    mkdir,
+    stat,
+} from 'node:fs/promises';
 import { spawn } from 'node:child_process';
 import { argv0 } from 'node:process';
 import { platform } from 'node:process';
-
-import c from 'chalk-template';
+import * as nodeUtils from 'node:util';
 
 export const isWindows = platform === 'win32';
 
@@ -25,6 +31,11 @@ export const ASYNC_WASI_EXPORTS = [
     'wasi:http/incoming-handler#handle',
 ];
 
+export const DEFAULT_ASYNC_MODE = 'sync';
+
+/** Path of WIT files by default when one is not specified */
+export const DEFAULT_WIT_PATH = './wit';
+
 let _showSpinner = false;
 export function setShowSpinner(val) {
     _showSpinner = val;
@@ -62,16 +73,23 @@ export function fixedDigitDisplay(num, maxChars) {
     return ' '.repeat(maxChars - str.length) + str;
 }
 
-export function table(data, align = []) {
-    if (data.length === 0) {
+/**
+ * Generate tabular output
+ *
+ * @param {string[][]} rows - data to put in rows
+ * @param {string[]} align - alignment of columns
+ * @returns string
+ */
+export function table(rows, align = []) {
+    if (rows.length === 0) {
         return '';
     }
-    const colLens = data.reduce(
+    const colLens = rows.reduce(
         (maxLens, cur) => maxLens.map((len, i) => Math.max(len, cur[i].length)),
-        data[0].map((cell) => cell.length)
+        rows[0].map((cell) => cell.length)
     );
     let outTable = '';
-    for (const row of data) {
+    for (const row of rows) {
         for (const [i, cell] of row.entries()) {
             if (align[i] === 'right') {
                 outTable += ' '.repeat(colLens[i] - cell.length) + cell;
@@ -88,27 +106,52 @@ export function table(data, align = []) {
  * Securely creates a temporary directory and returns its path.
  *
  * The new directory is created using `fsPromises.mkdtemp()`.
+ *
+ * @returns {Promise<string>} A `Promise` that resovles to a created temporary directory path
  */
 export async function getTmpDir() {
     return await mkdtemp(normalize(tmpdir() + sep));
 }
 
-async function readFileCli(file, encoding) {
+/**
+ * Read a given file, throwing a formatted error if one occurs
+ *
+ * @param {string} filePath - path to teh file to read
+ * @param {encoding} encoding - file encoding
+ * @returns {Promise<Buffer>} A promise that resolves to the contents of the file
+ */
+async function readFileCli(filePath, encoding) {
     try {
-        return await readFile(file, encoding);
+        return await readFile(filePath, encoding);
     } catch {
-        throw c`Unable to read file {bold ${file}}`;
+        throw `Unable to read file ${styleText('bold', filePath)}`;
     }
 }
 export { readFileCli as readFile };
 
-export async function spawnIOTmp(cmd, input, args) {
+/**
+ * Spawn a command that processes a given wasm binary bytes with some
+ * command.
+ *
+ * The command invocations that are generated by this function
+ * take the following form:
+ *
+ * ```
+ * <cmd> <input wasm file> <...arguments> <output wasm file>
+ * ```
+ *
+ * @param {string} cmd - the command to run
+ * @param {Buffer<ArrayBufferLike>} inputWasmBytes - bytes that of the input WebAssembly binary
+ * @param {string[]} args - arguments to pass to the command (after the input file and before the output file)
+ * @returns {Promise<Buffer<ArrayBufferLike>>} A `Promise` that resolves when the command has exited
+ */
+export async function spawnIOTmp(cmd, inputWasmBytes, args) {
     const tmpDir = await getTmpDir();
     try {
         const inFile = resolve(tmpDir, 'in.wasm');
         let outFile = resolve(tmpDir, 'out.wasm');
 
-        await writeFile(inFile, input);
+        await writeFile(inFile, inputWasmBytes);
 
         const cp = spawn(argv0, [cmd, inFile, ...args, outFile], {
             stdio: 'pipe',
@@ -137,23 +180,75 @@ export async function spawnIOTmp(cmd, input, args) {
     }
 }
 
+/**
+ * Given an object that has file names as keys and file contents as values,
+ * write out the files to a their locations.
+ *
+ * This function also prints out the files that were written
+ *
+ * @param {Record<string, string>} files - object which contains files to be written out
+ * @param {boolean} summaryTitle - whether to print the summary after writing out files
+ * @returns {Promise<void>>} A `Promise` that resolves when the fiels are all written
+ *
+ */
 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);
+        Object.entries(files).map(async ([filePath, contents]) => {
+            await mkdir(dirname(filePath), { recursive: true });
+            await writeFile(filePath, contents);
         })
     );
     if (!summaryTitle) {
         return;
     }
-    console.log(c`
-  {bold ${summaryTitle}:}
-
-${table(
-    Object.entries(files).map(([name, source]) => [
-        c` - {italic ${name}}  `,
-        c`{black.italic ${sizeStr(source.length)}}`,
-    ])
-)}`);
+
+    let rows = Object.entries(files).map(([name, source]) => [
+        ` - ${styleText('italic', name)}  `,
+        `${styleText(['black', 'italic'], sizeStr(source.length))}`,
+    ]);
+    console.log(`
+  ${styleText('bold', summaryTitle + ":")}
+
+${table(rows)}`);
+}
+
+/**
+ * Resolve the deafult WIT path, given a possibly
+ *
+ * @param {string | undefined} [witPath]
+ * @returns {Promise<string>}
+ */
+export async function resolveDefaultWITPath(witPath) {
+    if (witPath) {
+        return witPath;
+    }
+
+    // Use a default/standard current-folder WIT directory (wit) if we can find it
+    const witDirExists = await stat(DEFAULT_WIT_PATH)
+        .then((p) => p.isDirectory())
+        .catch(() => false);
+    if (!witDirExists) {
+        throw new Error(
+            'Failed to determine WIT directory, please specify WIT directory argument'
+        );
+    }
+    witPath = resolve(DEFAULT_WIT_PATH);
+    console.error(
+        `no WIT directory specified, using detected WIT directory @ [${DEFAULT_WIT_PATH}]`
+    );
+    return witPath;
+}
+
+/**
+ * Partial polyfill for 'node:utils' `styleText()`
+ *
+ * @param {string | string[]} styles - styles to apply to the given text
+ * @param {string} text - text that should be styled
+ * @returns {string} The styled string
+ */
+export function styleText(styles, text) {
+    if (nodeUtils.styleText) {
+        return nodeUtils.styleText(styles, text);
+    }
+    return text;
 }

package/src/jco.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 
-import c from 'chalk-template';
 import { program, Option } from 'commander';
 
 import { opt } from './cmd/opt.js';
@@ -17,15 +16,16 @@ import {
     componentWit,
 } from './cmd/wasm-tools.js';
 import { componentize } from './cmd/componentize.js';
+import { styleText } from './common.js';
 
 program
     .name('jco')
     .description(
-        c`{bold jco - WebAssembly JS Component Tools}\n      JS Component Transpilation Bindgen & Wasm Tools for JS`
+        `${styleText('bold', "jco - WebAssembly JS Component Tools")}\n      JS Component Transpilation Bindgen & Wasm Tools for JS`
     )
     .usage('<command> [options]')
     .enablePositionalOptions()
-    .version('1.13.3');
+    .version('1.15.0');
 
 function myParseInt(value) {
     return parseInt(value, 10);
@@ -41,6 +41,16 @@ function collectOptions(value, previous) {
     return previous.concat([value]);
 }
 
+/** Choices for features (enabling/disabling) */
+const FEATURE_CHOICES = [
+    'clocks',
+    'http',
+    'random',
+    'stdio',
+    'fetch-event',
+    'all',
+];
+
 program
     .command('componentize')
     .description('Create a component from a JavaScript module')
@@ -58,9 +68,17 @@ program
         new Option(
             '-d, --disable <feature...>',
             'disable WASI features'
-        ).choices(['clocks', 'http', 'random', 'stdio', 'fetch-event', 'all'])
+        ).choices(FEATURE_CHOICES)
+    )
+    .addOption(
+        new Option('--enable <feature...>', 'enable WASI features').choices(
+            FEATURE_CHOICES
+        )
+    )
+    .option(
+        '--debug',
+        'configure jco for debug (e.g. disable all features except stdio, etc)'
     )
-    // .addOption(new Option('-e, --enable <feature...>', 'enable WASI features').choices(['http']))
     .option(
         '--preview2-adapter <adapter>',
         'provide a custom preview2 adapter path'
@@ -186,10 +204,10 @@ program
     .command('types')
     .description('Generate types for the given WIT')
     .usage('<wit-path> -o <out-dir>')
-    .argument('<wit-path>', 'path to a WIT file or directory')
+    .argument('[<wit-path>]', 'path to a WIT file or directory')
     .option('--name <name>', 'custom output name')
     .option('-n, --world-name <world>', 'WIT world to generate types for')
-    .requiredOption('-o, --out-dir <out-dir>', 'output directory')
+    .option('-o, --out-dir <out-dir>', 'output directory')
     .option(
         '--tla-compat',
         'generates types for the TLA compat output with an async $init promise export'
@@ -224,7 +242,7 @@ program
     )
     .option(
         '--async-exports <exports...>',
-        'EXPERIMENTAL: async component exports (examples: "wasi:cli/run@#run", "handle")'
+        'EXPERIMENTAL: async component exports (examples: "ns:pkg/iface#func", "wasi:cli/run@0.2.3#run", "handle")'
     )
     .option('-q, --quiet', 'disable output summary')
     .option(
@@ -234,16 +252,19 @@ program
         []
     )
     .option('--all-features', 'enable all features')
+    .option(
+        "--wasm-opt-bin <path-to-wasm-opt>', 'wasm-opt binary path (default: 'binaryen/bin/wasm-opt')"
+    )
     .action(asyncAction(types));
 
 program
     .command('guest-types')
     .description('(experimental) Generate guest types for the given WIT')
     .usage('<wit-path> -o <out-dir>')
-    .argument('<wit-path>', 'path to a WIT file or directory')
+    .argument('[<wit-path>]', 'path to a WIT file or directory')
     .option('--name <name>', 'custom output name')
     .option('-n, --world-name <world>', 'WIT world to generate types for')
-    .requiredOption('-o, --out-dir <out-dir>', 'output directory')
+    .option('-o, --out-dir <out-dir>', 'output directory')
     .option('-q, --quiet', 'disable output summary')
     .option(
         '--feature <feature>',
@@ -252,6 +273,18 @@ program
         []
     )
     .option('--all-features', 'enable all features')
+    .option(
+        '--async-exports <exports...>',
+        'EXPERIMENTAL: generate async exports (examples: "ns:pkg/iface#func", "wasi:cli/run@0.2.3#run", "handle")'
+    )
+    .addOption(
+        new Option(
+            '--async-mode [mode]',
+            'EXPERIMENTAL: use async imports and exports'
+        )
+            .choices(['sync', 'jspi'])
+            .preset('sync')
+    )
     .action(asyncAction(guestTypes));
 
 program
@@ -345,6 +378,9 @@ program
     )
     .option('--asyncify', 'runs Asyncify pass in wasm-opt')
     .option('-q, --quiet')
+    .option(
+        "--wasm-opt-bin <path-to-wasm-opt>', 'wasm-opt binary path (default: 'binaryen/bin/wasm-opt')"
+    )
     .allowExcessArguments(true)
     .action(asyncAction(opt));
 
@@ -450,7 +486,7 @@ function asyncAction(cmd) {
             } catch (e) {
                 process.stdout.write(`(jco ${cmd.name}) `);
                 if (typeof e === 'string') {
-                    console.error(c`{red.bold Error}: ${e}\n`);
+                    console.error(`${styleText(['red', 'bold'], "Error")}: ${e}\n`);
                 } else {
                     console.error(e);
                 }

package/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.js"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,8BAHW,UAAU,CAAC,GAAoC,CAAC,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,UAAU,CAAC,GAAoC,CAAC,CAAC,CAKpE;AACD;;;GAGG;AACH,2BAHW,UAAU,CAAC,GAAoC,CAAC,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,UAAU,CAAC,GAAoC,CAAC,CAAC,CAKpE;AACD;;;GAGG;AACH,qCAHW,UAAU,CAAC,GAA2C,CAAC,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,UAAU,CAAC,GAA2C,CAAC,CAAC,CAK3E;AACD;;;;GAIG;AACH,qCAJW,UAAU,CAAC,GAA2C,CAAC,CAAC,CAAC,CAAC,YAC1D,UAAU,CAAC,GAA2C,CAAC,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,UAAU,CAAC,GAA2C,CAAC,CAAC,CAK3E;AACD;;;GAGG;AACH,0CAHW,UAAU,CAAC,GAA6C,CAAC,CAAC,CAAC,CAAC,GAC3D,OAAO,CAAC,UAAU,CAAC,GAA6C,CAAC,CAAC,CAK7E;AACD;;;;GAIG;AACH,oCAJW,UAAU,CAAC,GAA0C,CAAC,CAAC,CAAC,CAAC,YACzD,UAAU,CAAC,GAA0C,CAAC,CAAC,CAAC,CAAC,GACxD,OAAO,CAAC,UAAU,CAAC,GAA0C,CAAC,CAAC,CAK1E;AACD;;;GAGG;AACH,qCAHW,UAAU,CAAC,GAA2C,CAAC,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,UAAU,CAAC,GAA2C,CAAC,CAAC,CAK3E;AACD,kDAKC;AACD,kDAKC"}

package/types/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.js"],"names":[],"mappings":"AAMA,uDAGC;AAED,4DAGC"}

package/types/common.d.ts

@@ -0,0 +1,80 @@
+export function setShowSpinner(val: any): void;
+export function getShowSpinner(): boolean;
+export function sizeStr(num: any): string;
+export function fixedDigitDisplay(num: any, maxChars: any): string;
+/**
+ * Generate tabular output
+ *
+ * @param {string[][]} rows - data to put in rows
+ * @param {string[]} align - alignment of columns
+ * @returns string
+ */
+export function table(rows: string[][], align?: string[]): string;
+/**
+ * Securely creates a temporary directory and returns its path.
+ *
+ * The new directory is created using `fsPromises.mkdtemp()`.
+ *
+ * @returns {Promise<string>} A `Promise` that resovles to a created temporary directory path
+ */
+export function getTmpDir(): Promise<string>;
+/**
+ * Spawn a command that processes a given wasm binary bytes with some
+ * command.
+ *
+ * The command invocations that are generated by this function
+ * take the following form:
+ *
+ * ```
+ * <cmd> <input wasm file> <...arguments> <output wasm file>
+ * ```
+ *
+ * @param {string} cmd - the command to run
+ * @param {Buffer<ArrayBufferLike>} inputWasmBytes - bytes that of the input WebAssembly binary
+ * @param {string[]} args - arguments to pass to the command (after the input file and before the output file)
+ * @returns {Promise<Buffer<ArrayBufferLike>>} A `Promise` that resolves when the command has exited
+ */
+export function spawnIOTmp(cmd: string, inputWasmBytes: Buffer<ArrayBufferLike>, args: string[]): Promise<Buffer<ArrayBufferLike>>;
+/**
+ * Given an object that has file names as keys and file contents as values,
+ * write out the files to a their locations.
+ *
+ * This function also prints out the files that were written
+ *
+ * @param {Record<string, string>} files - object which contains files to be written out
+ * @param {boolean} summaryTitle - whether to print the summary after writing out files
+ * @returns {Promise<void>>} A `Promise` that resolves when the fiels are all written
+ *
+ */
+export function writeFiles(files: Record<string, string>, summaryTitle: boolean): Promise<void>;
+/**
+ * Resolve the deafult WIT path, given a possibly
+ *
+ * @param {string | undefined} [witPath]
+ * @returns {Promise<string>}
+ */
+export function resolveDefaultWITPath(witPath?: string | undefined): Promise<string>;
+/**
+ * Partial polyfill for 'node:utils' `styleText()`
+ *
+ * @param {string | string[]} styles - styles to apply to the given text
+ * @param {string} text - text that should be styled
+ * @returns {string} The styled string
+ */
+export function styleText(styles: string | string[], text: string): string;
+export const isWindows: boolean;
+export const ASYNC_WASI_IMPORTS: string[];
+export const ASYNC_WASI_EXPORTS: string[];
+export const DEFAULT_ASYNC_MODE: "sync";
+/** Path of WIT files by default when one is not specified */
+export const DEFAULT_WIT_PATH: "./wit";
+export { readFileCli as readFile };
+/**
+ * Read a given file, throwing a formatted error if one occurs
+ *
+ * @param {string} filePath - path to teh file to read
+ * @param {encoding} encoding - file encoding
+ * @returns {Promise<Buffer>} A promise that resolves to the contents of the file
+ */
+declare function readFileCli(filePath: string, encoding: any): Promise<Buffer>;
+//# sourceMappingURL=common.d.ts.map

package/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.js"],"names":[],"mappings":"AAuCA,+CAEC;AACD,0CAIC;AAED,0CASC;AAED,mEAcC;AAED;;;;;;GAMG;AACH,4BAJW,MAAM,EAAE,EAAE,UACV,MAAM,EAAE,UAuBlB;AAED;;;;;;GAMG;AACH,6BAFa,OAAO,CAAC,MAAM,CAAC,CAI3B;AAkBD;;;;;;;;;;;;;;;GAeG;AACH,gCALW,MAAM,kBACN,MAAM,CAAC,eAAe,CAAC,QACvB,MAAM,EAAE,GACN,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAmC5C;AAED;;;;;;;;;;GAUG;AACH,kCALW,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,gBACtB,OAAO,GACL,OAAO,CAAC,IAAI,CAAC,CAsBzB;AAED;;;;;GAKG;AACH,gDAHW,MAAM,GAAG,SAAS,GAChB,OAAO,CAAC,MAAM,CAAC,CAqB3B;AAED;;;;;;GAMG;AACH,kCAJW,MAAM,GAAG,MAAM,EAAE,QACjB,MAAM,GACJ,MAAM,CAOlB;AA9OD,gCAA8C;AAE9C,0CASE;AAEF,0CAGE;AAEF,iCAAkC,MAAM,CAAC;AAEzC,6DAA6D;AAC7D,+BAAgC,OAAO,CAAC;;AA+ExC;;;;;;GAMG;AACH,uCAJW,MAAM,kBAEJ,OAAO,CAAC,MAAM,CAAC,CAQ3B"}

package/types/jco.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jco.d.ts","sourceRoot":"","sources":["../src/jco.js"],"names":[],"mappings":""}

package/types/ora-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ora-shim.d.ts","sourceRoot":"","sources":["../src/ora-shim.js"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,mCAEC;AAED;IACI,cAAU;IACV,aAAS;CACZ"}

package/src/api.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["api.js"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,8BAHW,UAAU,CAAC,GAAoC,CAAC,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,UAAU,CAAC,GAAoC,CAAC,CAAC,CAKpE;AACD;;;GAGG;AACH,2BAHW,UAAU,CAAC,GAAoC,CAAC,CAAC,CAAC,CAAC,GAClD,OAAO,CAAC,UAAU,CAAC,GAAoC,CAAC,CAAC,CAKpE;AACD;;;GAGG;AACH,qCAHW,UAAU,CAAC,GAA2C,CAAC,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,UAAU,CAAC,GAA2C,CAAC,CAAC,CAK3E;AACD;;;;GAIG;AACH,qCAJW,UAAU,CAAC,GAA2C,CAAC,CAAC,CAAC,CAAC,YAC1D,UAAU,CAAC,GAA2C,CAAC,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,UAAU,CAAC,GAA2C,CAAC,CAAC,CAK3E;AACD;;;GAGG;AACH,0CAHW,UAAU,CAAC,GAA6C,CAAC,CAAC,CAAC,CAAC,GAC3D,OAAO,CAAC,UAAU,CAAC,GAA6C,CAAC,CAAC,CAK7E;AACD;;;;GAIG;AACH,oCAJW,UAAU,CAAC,GAA0C,CAAC,CAAC,CAAC,CAAC,YACzD,UAAU,CAAC,GAA0C,CAAC,CAAC,CAAC,CAAC,GACxD,OAAO,CAAC,UAAU,CAAC,GAA0C,CAAC,CAAC,CAK1E;AACD;;;GAGG;AACH,qCAHW,UAAU,CAAC,GAA2C,CAAC,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,UAAU,CAAC,GAA2C,CAAC,CAAC,CAK3E;AACD,kDAKC;AACD,kDAKC"}

package/src/browser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["browser.js"],"names":[],"mappings":"AAMA,uDAGC;AAED,4DAGC"}