@noir-lang/noir_wasm 0.24.0-722dc96.nightly → 0.24.0-9544813.nightly

package/dist/node/main.js

@@ -18,12 +18,6 @@ heap.push(undefined, null, true, false);
 
 function getObject(idx) { return heap[idx]; }
 
-function _assertBoolean(n) {
-    if (typeof(n) !== 'boolean') {
-        throw new Error('expected a boolean argument');
-    }
-}
-
 let heap_next = heap.length;
 
 function dropObject(idx) {
@@ -61,8 +55,6 @@ function addHeapObject(obj) {
     const idx = heap_next;
     heap_next = heap[idx];
 
-    if (typeof(heap_next) !== 'number') throw new Error('corrupt heap');
-
     heap[idx] = obj;
     return idx;
 }
@@ -86,8 +78,6 @@ const encodeString = (typeof cachedTextEncoder.encodeInto === 'function'
 
 function passStringToWasm0(arg, malloc, realloc) {
 
-    if (typeof(arg) !== 'string') throw new Error('expected a string argument');
-
     if (realloc === undefined) {
         const buf = cachedTextEncoder.encode(arg);
         const ptr = malloc(buf.length) >>> 0;
@@ -116,7 +106,7 @@ function passStringToWasm0(arg, malloc, realloc) {
         ptr = realloc(ptr, len, len = offset + arg.length * 3) >>> 0;
         const view = getUint8Memory0().subarray(ptr + offset, ptr + len);
         const ret = encodeString(arg, view);
-        if (ret.read !== arg.length) throw new Error('failed to pass whole string');
+
         offset += ret.written;
     }
 
@@ -208,33 +198,22 @@ function _assertClass(instance, klass) {
     }
     return instance.ptr;
 }
-
-function _assertNum(n) {
-    if (typeof(n) !== 'number') throw new Error('expected a number argument');
-}
 /**
 * This is a method that exposes the same API as `compile`
 * But uses the Context based APi internally
 * @param {string} entry_point
-* @param {boolean | undefined} contracts
 * @param {DependencyGraph | undefined} dependency_graph
 * @param {PathToFileSourceMap} file_source_map
-* @returns {CompileResult}
+* @returns {ProgramCompileResult}
 */
-module.exports.compile_ = function(entry_point, contracts, dependency_graph, file_source_map) {
+module.exports.compile_program_ = function(entry_point, dependency_graph, file_source_map) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
         const ptr0 = passStringToWasm0(entry_point, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
         const len0 = WASM_VECTOR_LEN;
-        if (!isLikeNone(contracts)) {
-            _assertBoolean(contracts);
-        }
         _assertClass(file_source_map, PathToFileSourceMap);
-        if (file_source_map.__wbg_ptr === 0) {
-            throw new Error('Attempt to use a moved value');
-        }
         var ptr1 = file_source_map.__destroy_into_raw();
-        wasm.compile_(retptr, ptr0, len0, isLikeNone(contracts) ? 0xFFFFFF : contracts ? 1 : 0, isLikeNone(dependency_graph) ? 0 : addHeapObject(dependency_graph), ptr1);
+        wasm.compile_program_(retptr, ptr0, len0, isLikeNone(dependency_graph) ? 0 : addHeapObject(dependency_graph), ptr1);
         var r0 = getInt32Memory0()[retptr / 4 + 0];
         var r1 = getInt32Memory0()[retptr / 4 + 1];
         var r2 = getInt32Memory0()[retptr / 4 + 2];
@@ -247,42 +226,74 @@ module.exports.compile_ = function(entry_point, contracts, dependency_graph, fil
     }
 };
 
-function logError(f, args) {
+/**
+* This is a method that exposes the same API as `compile`
+* But uses the Context based APi internally
+* @param {string} entry_point
+* @param {DependencyGraph | undefined} dependency_graph
+* @param {PathToFileSourceMap} file_source_map
+* @returns {ContractCompileResult}
+*/
+module.exports.compile_contract_ = function(entry_point, dependency_graph, file_source_map) {
     try {
-        return f.apply(this, args);
-    } catch (e) {
-        let error = (function () {
-            try {
-                return e instanceof Error ? `${e.message}\n\nStack:\n${e.stack}` : e.toString();
-            } catch(_) {
-                return "<failed to stringify thrown value>";
-            }
-        }());
-        console.error("wasm-bindgen: imported JS function that was not marked as `catch` threw an error:", error);
-        throw e;
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(entry_point, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+        const len0 = WASM_VECTOR_LEN;
+        _assertClass(file_source_map, PathToFileSourceMap);
+        var ptr1 = file_source_map.__destroy_into_raw();
+        wasm.compile_contract_(retptr, ptr0, len0, isLikeNone(dependency_graph) ? 0 : addHeapObject(dependency_graph), ptr1);
+        var r0 = getInt32Memory0()[retptr / 4 + 0];
+        var r1 = getInt32Memory0()[retptr / 4 + 1];
+        var r2 = getInt32Memory0()[retptr / 4 + 2];
+        if (r2) {
+            throw takeObject(r1);
+        }
+        return takeObject(r0);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
     }
-}
+};
+
 /**
 * @param {string} entry_point
-* @param {boolean | undefined} contracts
 * @param {DependencyGraph | undefined} dependency_graph
 * @param {PathToFileSourceMap} file_source_map
-* @returns {CompileResult}
+* @returns {ProgramCompileResult}
 */
-module.exports.compile = function(entry_point, contracts, dependency_graph, file_source_map) {
+module.exports.compile_program = function(entry_point, dependency_graph, file_source_map) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
         const ptr0 = passStringToWasm0(entry_point, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
         const len0 = WASM_VECTOR_LEN;
-        if (!isLikeNone(contracts)) {
-            _assertBoolean(contracts);
-        }
         _assertClass(file_source_map, PathToFileSourceMap);
-        if (file_source_map.__wbg_ptr === 0) {
-            throw new Error('Attempt to use a moved value');
+        var ptr1 = file_source_map.__destroy_into_raw();
+        wasm.compile_program(retptr, ptr0, len0, isLikeNone(dependency_graph) ? 0 : addHeapObject(dependency_graph), ptr1);
+        var r0 = getInt32Memory0()[retptr / 4 + 0];
+        var r1 = getInt32Memory0()[retptr / 4 + 1];
+        var r2 = getInt32Memory0()[retptr / 4 + 2];
+        if (r2) {
+            throw takeObject(r1);
         }
+        return takeObject(r0);
+    } finally {
+        wasm.__wbindgen_add_to_stack_pointer(16);
+    }
+};
+
+/**
+* @param {string} entry_point
+* @param {DependencyGraph | undefined} dependency_graph
+* @param {PathToFileSourceMap} file_source_map
+* @returns {ContractCompileResult}
+*/
+module.exports.compile_contract = function(entry_point, dependency_graph, file_source_map) {
+    try {
+        const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+        const ptr0 = passStringToWasm0(entry_point, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+        const len0 = WASM_VECTOR_LEN;
+        _assertClass(file_source_map, PathToFileSourceMap);
         var ptr1 = file_source_map.__destroy_into_raw();
-        wasm.compile(retptr, ptr0, len0, isLikeNone(contracts) ? 0xFFFFFF : contracts ? 1 : 0, isLikeNone(dependency_graph) ? 0 : addHeapObject(dependency_graph), ptr1);
+        wasm.compile_contract(retptr, ptr0, len0, isLikeNone(dependency_graph) ? 0 : addHeapObject(dependency_graph), ptr1);
         var r0 = getInt32Memory0()[retptr / 4 + 0];
         var r1 = getInt32Memory0()[retptr / 4 + 1];
         var r2 = getInt32Memory0()[retptr / 4 + 2];
@@ -296,10 +307,10 @@ module.exports.compile = function(entry_point, contracts, dependency_graph, file
 };
 
 /**
-* @param {string} filter
+* @param {string} level
 */
-module.exports.init_log_level = function(filter) {
-    const ptr0 = passStringToWasm0(filter, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+module.exports.init_log_level = function(level) {
+    const ptr0 = passStringToWasm0(level, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
     const len0 = WASM_VECTOR_LEN;
     wasm.init_log_level(ptr0, len0);
 };
@@ -350,9 +361,6 @@ class CompilerContext {
     */
     constructor(source_map) {
         _assertClass(source_map, PathToFileSourceMap);
-        if (source_map.__wbg_ptr === 0) {
-            throw new Error('Attempt to use a moved value');
-        }
         var ptr0 = source_map.__destroy_into_raw();
         const ret = wasm.compilercontext_new(ptr0);
         return CompilerContext.__wrap(ret);
@@ -362,8 +370,6 @@ class CompilerContext {
     * @returns {CrateId}
     */
     process_root_crate(path_to_crate) {
-        if (this.__wbg_ptr == 0) throw new Error('Attempt to use a moved value');
-        _assertNum(this.__wbg_ptr);
         const ptr0 = passStringToWasm0(path_to_crate, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
         const len0 = WASM_VECTOR_LEN;
         const ret = wasm.compilercontext_process_root_crate(this.__wbg_ptr, ptr0, len0);
@@ -374,8 +380,6 @@ class CompilerContext {
     * @returns {CrateId}
     */
     process_dependency_crate(path_to_crate) {
-        if (this.__wbg_ptr == 0) throw new Error('Attempt to use a moved value');
-        _assertNum(this.__wbg_ptr);
         const ptr0 = passStringToWasm0(path_to_crate, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
         const len0 = WASM_VECTOR_LEN;
         const ret = wasm.compilercontext_process_dependency_crate(this.__wbg_ptr, ptr0, len0);
@@ -388,19 +392,11 @@ class CompilerContext {
     */
     add_dependency_edge(crate_name, from, to) {
         try {
-            if (this.__wbg_ptr == 0) throw new Error('Attempt to use a moved value');
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            _assertNum(this.__wbg_ptr);
             const ptr0 = passStringToWasm0(crate_name, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
             const len0 = WASM_VECTOR_LEN;
             _assertClass(from, CrateId);
-            if (from.__wbg_ptr === 0) {
-                throw new Error('Attempt to use a moved value');
-            }
             _assertClass(to, CrateId);
-            if (to.__wbg_ptr === 0) {
-                throw new Error('Attempt to use a moved value');
-            }
             wasm.compilercontext_add_dependency_edge(retptr, this.__wbg_ptr, ptr0, len0, from.__wbg_ptr, to.__wbg_ptr);
             var r0 = getInt32Memory0()[retptr / 4 + 0];
             var r1 = getInt32Memory0()[retptr / 4 + 1];
@@ -413,15 +409,12 @@ class CompilerContext {
     }
     /**
     * @param {number} program_width
-    * @returns {CompileResult}
+    * @returns {ProgramCompileResult}
     */
     compile_program(program_width) {
         try {
-            if (this.__wbg_ptr == 0) throw new Error('Attempt to use a moved value');
             const ptr = this.__destroy_into_raw();
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            _assertNum(ptr);
-            _assertNum(program_width);
             wasm.compilercontext_compile_program(retptr, ptr, program_width);
             var r0 = getInt32Memory0()[retptr / 4 + 0];
             var r1 = getInt32Memory0()[retptr / 4 + 1];
@@ -436,15 +429,12 @@ class CompilerContext {
     }
     /**
     * @param {number} program_width
-    * @returns {CompileResult}
+    * @returns {ContractCompileResult}
     */
     compile_contract(program_width) {
         try {
-            if (this.__wbg_ptr == 0) throw new Error('Attempt to use a moved value');
             const ptr = this.__destroy_into_raw();
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            _assertNum(ptr);
-            _assertNum(program_width);
             wasm.compilercontext_compile_contract(retptr, ptr, program_width);
             var r0 = getInt32Memory0()[retptr / 4 + 0];
             var r1 = getInt32Memory0()[retptr / 4 + 1];
@@ -463,10 +453,6 @@ module.exports.CompilerContext = CompilerContext;
 */
 class CrateId {
 
-    constructor() {
-        throw new Error('cannot invoke `new` directly');
-    }
-
     static __wrap(ptr) {
         ptr = ptr >>> 0;
         const obj = Object.create(CrateId.prototype);
@@ -523,8 +509,6 @@ class PathToFileSourceMap {
     * @returns {boolean}
     */
     add_source_code(path, source_code) {
-        if (this.__wbg_ptr == 0) throw new Error('Attempt to use a moved value');
-        _assertNum(this.__wbg_ptr);
         const ptr0 = passStringToWasm0(path, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
         const len0 = WASM_VECTOR_LEN;
         const ptr1 = passStringToWasm0(source_code, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
@@ -535,40 +519,39 @@ class PathToFileSourceMap {
 }
 module.exports.PathToFileSourceMap = PathToFileSourceMap;
 
+module.exports.__wbindgen_object_drop_ref = function(arg0) {
+    takeObject(arg0);
+};
+
 module.exports.__wbindgen_is_undefined = function(arg0) {
     const ret = getObject(arg0) === undefined;
-    _assertBoolean(ret);
     return ret;
 };
 
-module.exports.__wbindgen_object_drop_ref = function(arg0) {
-    takeObject(arg0);
-};
-
-module.exports.__wbg_constructor_05d6d198f3477d6f = function() { return logError(function () {
+module.exports.__wbg_constructor_05d6d198f3477d6f = function() {
     const ret = new Object();
     return addHeapObject(ret);
-}, arguments) };
+};
 
-module.exports.__wbg_constructor_e8767839abf8a966 = function() { return logError(function (arg0) {
+module.exports.__wbg_constructor_e8767839abf8a966 = function(arg0) {
     const ret = new Error(takeObject(arg0));
     return addHeapObject(ret);
-}, arguments) };
+};
 
-module.exports.__wbg_new_abda76e883ba8a5f = function() { return logError(function () {
+module.exports.__wbg_new_abda76e883ba8a5f = function() {
     const ret = new Error();
     return addHeapObject(ret);
-}, arguments) };
+};
 
-module.exports.__wbg_stack_658279fe44541cf6 = function() { return logError(function (arg0, arg1) {
+module.exports.__wbg_stack_658279fe44541cf6 = function(arg0, arg1) {
     const ret = getObject(arg1).stack;
     const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
     const len1 = WASM_VECTOR_LEN;
     getInt32Memory0()[arg0 / 4 + 1] = len1;
     getInt32Memory0()[arg0 / 4 + 0] = ptr1;
-}, arguments) };
+};
 
-module.exports.__wbg_error_f851667af71bcfc6 = function() { return logError(function (arg0, arg1) {
+module.exports.__wbg_error_f851667af71bcfc6 = function(arg0, arg1) {
     let deferred0_0;
     let deferred0_1;
     try {
@@ -578,52 +561,44 @@ module.exports.__wbg_error_f851667af71bcfc6 = function() { return logError(funct
     } finally {
         wasm.__wbindgen_export_2(deferred0_0, deferred0_1);
     }
-}, arguments) };
+};
 
 module.exports.__wbindgen_string_new = function(arg0, arg1) {
     const ret = getStringFromWasm0(arg0, arg1);
     return addHeapObject(ret);
 };
 
-module.exports.__wbg_debug_e3f6a1578e6d45ca = function() { return logError(function (arg0) {
+module.exports.__wbg_debug_e3f6a1578e6d45ca = function(arg0) {
     console.debug(getObject(arg0));
-}, arguments) };
+};
 
-module.exports.__wbg_debug_efabe4eb183aa5d4 = function() { return logError(function (arg0, arg1, arg2, arg3) {
+module.exports.__wbg_debug_efabe4eb183aa5d4 = function(arg0, arg1, arg2, arg3) {
     console.debug(getObject(arg0), getObject(arg1), getObject(arg2), getObject(arg3));
-}, arguments) };
+};
 
-module.exports.__wbg_error_a7e23606158b68b9 = function() { return logError(function (arg0) {
+module.exports.__wbg_error_a7e23606158b68b9 = function(arg0) {
     console.error(getObject(arg0));
-}, arguments) };
+};
 
-module.exports.__wbg_error_50f42b952a595a23 = function() { return logError(function (arg0, arg1, arg2, arg3) {
+module.exports.__wbg_error_50f42b952a595a23 = function(arg0, arg1, arg2, arg3) {
     console.error(getObject(arg0), getObject(arg1), getObject(arg2), getObject(arg3));
-}, arguments) };
+};
 
-module.exports.__wbg_info_05db236d79f1b785 = function() { return logError(function (arg0) {
+module.exports.__wbg_info_05db236d79f1b785 = function(arg0) {
     console.info(getObject(arg0));
-}, arguments) };
+};
 
-module.exports.__wbg_info_24d8f53d98f12b95 = function() { return logError(function (arg0, arg1, arg2, arg3) {
+module.exports.__wbg_info_24d8f53d98f12b95 = function(arg0, arg1, arg2, arg3) {
     console.info(getObject(arg0), getObject(arg1), getObject(arg2), getObject(arg3));
-}, arguments) };
-
-module.exports.__wbg_log_dc06ec929fc95a20 = function() { return logError(function (arg0) {
-    console.log(getObject(arg0));
-}, arguments) };
-
-module.exports.__wbg_log_2f6947e39440ae3b = function() { return logError(function (arg0, arg1, arg2, arg3, arg4) {
-    console.log(getObject(arg0), getObject(arg1), getObject(arg2), getObject(arg3), getObject(arg4));
-}, arguments) };
+};
 
-module.exports.__wbg_warn_9bdd743e9f5fe1e0 = function() { return logError(function (arg0) {
+module.exports.__wbg_warn_9bdd743e9f5fe1e0 = function(arg0) {
     console.warn(getObject(arg0));
-}, arguments) };
+};
 
-module.exports.__wbg_warn_8342bfbc6028193a = function() { return logError(function (arg0, arg1, arg2, arg3) {
+module.exports.__wbg_warn_8342bfbc6028193a = function(arg0, arg1, arg2, arg3) {
     console.warn(getObject(arg0), getObject(arg1), getObject(arg2), getObject(arg3));
-}, arguments) };
+};
 
 module.exports.__wbindgen_string_get = function(arg0, arg1) {
     const obj = getObject(arg1);
@@ -646,7 +621,6 @@ module.exports.__wbg_stringify_d06ad2addc54d51e = function() { return handleErro
 
 module.exports.__wbg_set_07da13cc24b69217 = function() { return handleError(function (arg0, arg1, arg2) {
     const ret = Reflect.set(getObject(arg0), getObject(arg1), getObject(arg2));
-    _assertBoolean(ret);
     return ret;
 }, arguments) };
 
@@ -1237,18 +1211,54 @@ class NoirWasmCompiler {
     /**
      * Compile EntryPoint
      */
+    async compile_program() {
+        console.log(`Compiling at ${this.#package.getEntryPointPath()}`);
+        if (this.#package.getType() !== 'bin') {
+            throw new Error(`Expected to find package type "bin" but found ${this.#package.getType()}`);
+        }
+        await this.#dependencyManager.resolveDependencies();
+        this.#debugLog(`Dependencies: ${this.#dependencyManager.getPackageNames().join(', ')}`);
+        try {
+            const entrypoint = this.#package.getEntryPointPath();
+            const deps = {
+                /* eslint-disable camelcase */
+                root_dependencies: this.#dependencyManager.getEntrypointDependencies(),
+                library_dependencies: this.#dependencyManager.getLibraryDependencies(),
+                /* eslint-enable camelcase */
+            };
+            const packageSources = await this.#package.getSources(this.#fm);
+            const librarySources = (await Promise.all(this.#dependencyManager
+                .getLibraries()
+                .map(async ([alias, library]) => await library.package.getSources(this.#fm, alias)))).flat();
+            [...packageSources, ...librarySources].forEach((sourceFile) => {
+                this.#debugLog(`Adding source ${sourceFile.path}`);
+                this.#sourceMap.add_source_code(sourceFile.path, sourceFile.source);
+            });
+            const result = this.#wasmCompiler.compile_program(entrypoint, deps, this.#sourceMap);
+            return result;
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'CompileError') {
+                const logs = await this.#processCompileError(err);
+                for (const log of logs) {
+                    this.#log(log);
+                }
+                throw new Error(logs.join('\n'));
+            }
+            throw err;
+        }
+    }
     /**
      * Compile EntryPoint
      */
-    async compile() {
+    async compile_contract() {
         console.log(`Compiling at ${this.#package.getEntryPointPath()}`);
-        if (!(this.#package.getType() === 'contract' || this.#package.getType() === 'bin')) {
-            throw new Error(`Only supports compiling "contract" and "bin" package types (${this.#package.getType()})`);
+        if (this.#package.getType() !== 'contract') {
+            throw new Error(`Expected to find package type "contract" but found ${this.#package.getType()}`);
         }
         await this.#dependencyManager.resolveDependencies();
         this.#debugLog(`Dependencies: ${this.#dependencyManager.getPackageNames().join(', ')}`);
         try {
-            const isContract = this.#package.getType() === 'contract';
             const entrypoint = this.#package.getEntryPointPath();
             const deps = {
                 /* eslint-disable camelcase */
@@ -1264,10 +1274,7 @@ class NoirWasmCompiler {
                 this.#debugLog(`Adding source ${sourceFile.path}`);
                 this.#sourceMap.add_source_code(sourceFile.path, sourceFile.source);
             });
-            const result = this.#wasmCompiler.compile(entrypoint, isContract, deps, this.#sourceMap);
-            if ((isContract && !('contract' in result)) || (!isContract && !('program' in result))) {
-                throw new Error('Invalid compilation result');
-            }
+            const result = this.#wasmCompiler.compile_contract(entrypoint, deps, this.#sourceMap);
             return result;
         }
         catch (err) {
@@ -1396,7 +1403,7 @@ class Package {
      * Gets this package's dependencies.
      */
     getDependencies() {
-        return this.#config.dependencies;
+        return this.#config.dependencies ?? {};
     }
     /**
      * Gets this package's sources.
@@ -12816,7 +12823,7 @@ var exports = __webpack_exports__;
   \***********************/
 
 Object.defineProperty(exports, "__esModule", ({ value: true }));
-exports.inflateDebugSymbols = exports.createFileManager = exports.compile = void 0;
+exports.inflateDebugSymbols = exports.createFileManager = exports.compile_contract = exports.compile_program = exports.compile = void 0;
 const nodejs_file_manager_1 = __webpack_require__(/*! ./noir/file-manager/nodejs-file-manager */ "./src/noir/file-manager/nodejs-file-manager.ts");
 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");
@@ -12833,30 +12840,71 @@ Object.defineProperty(exports, "inflateDebugSymbols", ({ enumerable: true, get:
  * ```typescript
  * // Node.js
  *
- * import { compile, createFileManager } from '@noir-lang/noir_wasm';
+ * import { compile_program, createFileManager } from '@noir-lang/noir_wasm';
  *
  * const fm = createFileManager(myProjectPath);
- * const myCompiledCode = await compile(fm);
+ * const myCompiledCode = await compile_program(fm);
  * ```
  *
  * ```typescript
  * // Browser
  *
- * import { compile, createFileManager } from '@noir-lang/noir_wasm';
+ * import { compile_program, 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);
+ * const myCompiledCode = await compile_program(fm);
  * ```
  */
-async function compile(fileManager, projectPath, logFn, debugLogFn) {
+async function compile_program(fileManager, projectPath, logFn, debugLogFn) {
+    const compiler = await setup_compiler(fileManager, projectPath, logFn, debugLogFn);
+    return await compiler.compile_program();
+}
+exports.compile = compile_program;
+exports.compile_program = compile_program;
+/**
+ * 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_contract, createFileManager } from '@noir-lang/noir_wasm';
+ *
+ * const fm = createFileManager(myProjectPath);
+ * const myCompiledCode = await compile_contract(fm);
+ * ```
+ *
+ * ```typescript
+ * // Browser
+ *
+ * import { compile_contract, 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_contract(fm);
+ * ```
+ */
+async function compile_contract(fileManager, projectPath, logFn, debugLogFn) {
+    const compiler = await setup_compiler(fileManager, projectPath, logFn, debugLogFn);
+    return await compiler.compile_contract();
+}
+exports.compile_contract = compile_contract;
+async function setup_compiler(fileManager, projectPath, logFn, debugLogFn) {
     if (logFn && !debugLogFn) {
         debugLogFn = logFn;
     }
     const cjs = await __webpack_require__(/*! ../build/cjs */ "./build/cjs/index.js");
-    const compiler = await noir_wasm_compiler_1.NoirWasmCompiler.new(fileManager, projectPath ?? fileManager.getDataDir(), cjs, new cjs.PathToFileSourceMap(), {
+    return await noir_wasm_compiler_1.NoirWasmCompiler.new(fileManager, projectPath ?? fileManager.getDataDir(), cjs, new cjs.PathToFileSourceMap(), {
         log: logFn ??
             function (msg, data) {
                 if (data) {
@@ -12876,9 +12924,7 @@ async function compile(fileManager, projectPath, logFn, debugLogFn) {
                 }
             },
     });
-    return await compiler.compile();
 }
-exports.compile = compile;
 const createFileManager = nodejs_file_manager_1.createNodejsFileManager;
 exports.createFileManager = createFileManager;