@noir-lang/noir_wasm 0.23.0 → 0.24.0

package/README.md

@@ -1,9 +1,32 @@
 # Noir Lang WASM JavaScript Package
 
-This JavaScript package enables users to compile a Noir program, i.e. generating its artifacts.
+This JavaScript package enables users to compile a Noir program, i.e. generating its artifacts, both in Node.JS environments and the browser.
 
 The package also handles dependency management like how Nargo (Noir's CLI tool) operates, but the package is used just for compilation, not proving, verifying and simulating functions.
 
+## Usage
+
+```typescript
+// Node.js
+
+import { compile, createFileManager } from '@noir-lang/noir_wasm';
+
+const fm = createFileManager(myProjectPath);
+const myCompiledCode = await compile(fm);
+```
+
+```typescript
+// Browser
+
+import { compile, createFileManager } from '@noir-lang/noir_wasm';
+
+const fm = createFileManager('/');
+for (const path of files) {
+  await fm.writeFile(path, await getFileAsStream(path));
+}
+const myCompiledCode = await compile(fm);
+```
+
 ## Building from source
 
 Outside of the [noir repo](https://github.com/noir-lang/noir), this package can be built using the command below:

package/build/cjs/package.json

@@ -3,7 +3,7 @@
   "collaborators": [
     "The Noir Team <team@noir-lang.org>"
   ],
-  "version": "0.23.0",
+  "version": "0.24.0",
   "license": "MIT OR Apache-2.0",
   "files": [
     "index_bg.wasm",

package/build/esm/package.json

@@ -3,7 +3,7 @@
   "collaborators": [
     "The Noir Team <team@noir-lang.org>"
   ],
-  "version": "0.23.0",
+  "version": "0.24.0",
   "license": "MIT OR Apache-2.0",
   "files": [
     "index_bg.wasm",

package/dist/node/main.js

@@ -540,7 +540,7 @@ module.exports.__wbindgen_object_drop_ref = function(arg0) {
     takeObject(arg0);
 };
 
-module.exports.__wbg_constructor_28ca684b2f9696ac = function() { return logError(function () {
+module.exports.__wbg_constructor_05d6d198f3477d6f = function() { return logError(function () {
     const ret = new Object();
     return addHeapObject(ret);
 }, arguments) };
@@ -551,7 +551,7 @@ module.exports.__wbindgen_is_undefined = function(arg0) {
     return ret;
 };
 
-module.exports.__wbg_constructor_287b714b768ecf13 = function() { return logError(function (arg0) {
+module.exports.__wbg_constructor_e8767839abf8a966 = function() { return logError(function (arg0) {
     const ret = new Error(takeObject(arg0));
     return addHeapObject(ret);
 }, arguments) };
@@ -686,7 +686,10 @@ module.exports.__wasm = wasm;
 Object.defineProperty(exports, "__esModule", ({ value: true }));
 exports.inflateDebugSymbols = void 0;
 const pako_1 = __webpack_require__(/*! pako */ "../../node_modules/pako/index.js");
-/** Decompresses and decodes the debug symbols */
+/**
+ * Decompresses and decodes the debug symbols
+ * @param debugSymbols - The base64 encoded debug symbols
+ */
 function inflateDebugSymbols(debugSymbols) {
     return JSON.parse((0, pako_1.inflate)(Buffer.from(debugSymbols, 'base64'), { to: 'string', raw: true }));
 }
@@ -1143,8 +1146,9 @@ async function readdirRecursive(dir) {
 }
 exports.readdirRecursive = readdirRecursive;
 /**
- * Creates a new FileManager instance based on nodejs fs
- * @param dataDir - where to store files
+ * Creates a new FileManager instance based on fs in node and memfs in the browser (via webpack alias)
+ *
+ * @param dataDir - root of the file system
  */
 function createNodejsFileManager(dataDir) {
     return new file_manager_1.FileManager({
@@ -12818,6 +12822,36 @@ const nodejs_file_manager_1 = __webpack_require__(/*! ./noir/file-manager/nodejs
 const noir_wasm_compiler_1 = __webpack_require__(/*! ./noir/noir-wasm-compiler */ "./src/noir/noir-wasm-compiler.ts");
 const debug_1 = __webpack_require__(/*! ./noir/debug */ "./src/noir/debug.ts");
 Object.defineProperty(exports, "inflateDebugSymbols", ({ enumerable: true, get: function () { return debug_1.inflateDebugSymbols; } }));
+/**
+ * Compiles a Noir project
+ *
+ * @param fileManager - The file manager to use
+ * @param projectPath - The path to the project inside the file manager. Defaults to the root of the file manager
+ * @param logFn - A logging function. If not provided, console.log will be used
+ * @param debugLogFn - A debug logging function. If not provided, logFn will be used
+ *
+ * @example
+ * ```typescript
+ * // Node.js
+ *
+ * import { compile, createFileManager } from '@noir-lang/noir_wasm';
+ *
+ * const fm = createFileManager(myProjectPath);
+ * const myCompiledCode = await compile(fm);
+ * ```
+ *
+ * ```typescript
+ * // Browser
+ *
+ * import { compile, createFileManager } from '@noir-lang/noir_wasm';
+ *
+ * const fm = createFileManager('/');
+ * for (const path of files) {
+ *   await fm.writeFile(path, await getFileAsStream(path));
+ * }
+ * const myCompiledCode = await compile(fm);
+ * ```
+ */
 async function compile(fileManager, projectPath, logFn, debugLogFn) {
     if (logFn && !debugLogFn) {
         debugLogFn = logFn;