qsharp-lang 1.0.28-dev → 1.0.30-dev

package/lib/node/qsc_wasm.cjs

@@ -1,7 +1,7 @@
 let imports = {};
 imports['__wbindgen_placeholder__'] = module.exports;
 let wasm;
-const { TextDecoder, TextEncoder } = require(`util`);
+const { TextEncoder, TextDecoder } = require(`util`);
 
 const heap = new Array(128).fill(undefined);
 
@@ -9,32 +9,7 @@ heap.push(undefined, null, true, false);
 
 function getObject(idx) { return heap[idx]; }
 
-let heap_next = heap.length;
-
-function dropObject(idx) {
-    if (idx < 132) return;
-    heap[idx] = heap_next;
-    heap_next = idx;
-}
-
-function takeObject(idx) {
-    const ret = getObject(idx);
-    dropObject(idx);
-    return ret;
-}
-
-function addHeapObject(obj) {
-    if (heap_next === heap.length) heap.push(heap.length + 1);
-    const idx = heap_next;
-    heap_next = heap[idx];
-
-    heap[idx] = obj;
-    return idx;
-}
-
-let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
-
-cachedTextDecoder.decode();
+let WASM_VECTOR_LEN = 0;
 
 let cachedUint8Memory0 = null;
 
@@ -45,13 +20,6 @@ function getUint8Memory0() {
     return cachedUint8Memory0;
 }
 
-function getStringFromWasm0(ptr, len) {
-    ptr = ptr >>> 0;
-    return cachedTextDecoder.decode(getUint8Memory0().subarray(ptr, ptr + len));
-}
-
-let WASM_VECTOR_LEN = 0;
-
 let cachedTextEncoder = new TextEncoder('utf-8');
 
 const encodeString = (typeof cachedTextEncoder.encodeInto === 'function'
@@ -127,6 +95,38 @@ function getFloat64Memory0() {
     return cachedFloat64Memory0;
 }
 
+let heap_next = heap.length;
+
+function dropObject(idx) {
+    if (idx < 132) return;
+    heap[idx] = heap_next;
+    heap_next = idx;
+}
+
+function takeObject(idx) {
+    const ret = getObject(idx);
+    dropObject(idx);
+    return ret;
+}
+
+function addHeapObject(obj) {
+    if (heap_next === heap.length) heap.push(heap.length + 1);
+    const idx = heap_next;
+    heap_next = heap[idx];
+
+    heap[idx] = obj;
+    return idx;
+}
+
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+
+cachedTextDecoder.decode();
+
+function getStringFromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return cachedTextDecoder.decode(getUint8Memory0().subarray(ptr, ptr + len));
+}
+
 function debugString(val) {
     // primitive types
     const type = typeof val;
@@ -192,12 +192,32 @@ function debugString(val) {
     return className;
 }
 
-let stack_pointer = 128;
+function makeMutClosure(arg0, arg1, dtor, f) {
+    const state = { a: arg0, b: arg1, cnt: 1, dtor };
+    const real = (...args) => {
+        // First up with a closure we increment the internal reference
+        // count. This ensures that the Rust closure environment won't
+        // be deallocated while we're invoking it.
+        state.cnt++;
+        const a = state.a;
+        state.a = 0;
+        try {
+            return f(a, state.b, ...args);
+        } finally {
+            if (--state.cnt === 0) {
+                wasm.__wbindgen_export_2.get(state.dtor)(a, state.b);
 
-function addBorrowedObject(obj) {
-    if (stack_pointer == 1) throw new Error('out of js stack');
-    heap[--stack_pointer] = obj;
-    return stack_pointer;
+            } else {
+                state.a = a;
+            }
+        }
+    };
+    real.original = state;
+
+    return real;
+}
+function __wbg_adapter_44(arg0, arg1, arg2) {
+    wasm.__wbindgen_export_3(arg0, arg1, addHeapObject(arg2));
 }
 
 let cachedUint32Memory0 = null;
@@ -209,13 +229,6 @@ function getUint32Memory0() {
     return cachedUint32Memory0;
 }
 
-function passArray32ToWasm0(arg, malloc) {
-    const ptr = malloc(arg.length * 4, 4) >>> 0;
-    getUint32Memory0().set(arg, ptr / 4);
-    WASM_VECTOR_LEN = arg.length;
-    return ptr;
-}
-
 function passArrayJsValueToWasm0(array, malloc) {
     const ptr = malloc(array.length * 4, 4) >>> 0;
     const mem = getUint32Memory0();
@@ -226,6 +239,21 @@ function passArrayJsValueToWasm0(array, malloc) {
     return ptr;
 }
 
+let stack_pointer = 128;
+
+function addBorrowedObject(obj) {
+    if (stack_pointer == 1) throw new Error('out of js stack');
+    heap[--stack_pointer] = obj;
+    return stack_pointer;
+}
+
+function passArray32ToWasm0(arg, malloc) {
+    const ptr = malloc(arg.length * 4, 4) >>> 0;
+    getUint32Memory0().set(arg, ptr / 4);
+    WASM_VECTOR_LEN = arg.length;
+    return ptr;
+}
+
 function getArrayJsValueFromWasm0(ptr, len) {
     ptr = ptr >>> 0;
     const mem = getUint32Memory0();
@@ -277,20 +305,20 @@ module.exports.git_hash = function() {
         return getStringFromWasm0(r0, r1);
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export_2(deferred1_0, deferred1_1, 1);
+        wasm.__wbindgen_export_4(deferred1_0, deferred1_1, 1);
     }
 };
 
 /**
-* @param {string} code
+* @param {(Array<any>)[]} sources
 * @returns {string}
 */
-module.exports.get_qir = function(code) {
+module.exports.get_qir = function(sources) {
     let deferred3_0;
     let deferred3_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passStringToWasm0(code, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+        const ptr0 = passArrayJsValueToWasm0(sources, wasm.__wbindgen_export_0);
         const len0 = WASM_VECTOR_LEN;
         wasm.get_qir(retptr, ptr0, len0);
         var r0 = getInt32Memory0()[retptr / 4 + 0];
@@ -308,21 +336,21 @@ module.exports.get_qir = function(code) {
         return getStringFromWasm0(ptr2, len2);
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export_2(deferred3_0, deferred3_1, 1);
+        wasm.__wbindgen_export_4(deferred3_0, deferred3_1, 1);
     }
 };
 
 /**
-* @param {string} code
+* @param {(Array<any>)[]} sources
 * @param {string} params
 * @returns {string}
 */
-module.exports.get_estimates = function(code, params) {
+module.exports.get_estimates = function(sources, params) {
     let deferred4_0;
     let deferred4_1;
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passStringToWasm0(code, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+        const ptr0 = passArrayJsValueToWasm0(sources, wasm.__wbindgen_export_0);
         const len0 = WASM_VECTOR_LEN;
         const ptr1 = passStringToWasm0(params, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
         const len1 = WASM_VECTOR_LEN;
@@ -342,7 +370,7 @@ module.exports.get_estimates = function(code, params) {
         return getStringFromWasm0(ptr3, len3);
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export_2(deferred4_0, deferred4_1, 1);
+        wasm.__wbindgen_export_4(deferred4_0, deferred4_1, 1);
     }
 };
 
@@ -361,7 +389,7 @@ module.exports.get_library_source_content = function(name) {
         let v2;
         if (r0 !== 0) {
             v2 = getStringFromWasm0(r0, r1).slice();
-            wasm.__wbindgen_export_2(r0, r1 * 1);
+            wasm.__wbindgen_export_4(r0, r1 * 1);
         }
         return v2;
     } finally {
@@ -388,21 +416,21 @@ module.exports.get_hir = function(code) {
         return getStringFromWasm0(r0, r1);
     } finally {
         wasm.__wbindgen_add_to_stack_pointer(16);
-        wasm.__wbindgen_export_2(deferred2_0, deferred2_1, 1);
+        wasm.__wbindgen_export_4(deferred2_0, deferred2_1, 1);
     }
 };
 
 /**
-* @param {string} code
+* @param {(Array<any>)[]} sources
 * @param {string} expr
 * @param {Function} event_cb
 * @param {number} shots
 * @returns {boolean}
 */
-module.exports.run = function(code, expr, event_cb, shots) {
+module.exports.run = function(sources, expr, event_cb, shots) {
     try {
         const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-        const ptr0 = passStringToWasm0(code, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+        const ptr0 = passArrayJsValueToWasm0(sources, wasm.__wbindgen_export_0);
         const len0 = WASM_VECTOR_LEN;
         const ptr1 = passStringToWasm0(expr, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
         const len1 = WASM_VECTOR_LEN;
@@ -441,9 +469,13 @@ function handleError(f, args) {
     try {
         return f.apply(this, args);
     } catch (e) {
-        wasm.__wbindgen_export_3(addHeapObject(e));
+        wasm.__wbindgen_export_5(addHeapObject(e));
     }
 }
+function __wbg_adapter_145(arg0, arg1, arg2, arg3) {
+    wasm.__wbindgen_export_6(arg0, arg1, addHeapObject(arg2), addHeapObject(arg3));
+}
+
 /**
 */
 module.exports.StepResultId = Object.freeze({ BreakpointHit:0,"0":"BreakpointHit",Next:1,"1":"Next",StepIn:2,"2":"StepIn",StepOut:3,"3":"StepOut",Return:4,"4":"Return", });
@@ -477,34 +509,31 @@ class DebugService {
         return DebugService.__wrap(ret);
     }
     /**
-    * @param {string} path
-    * @param {string} source
+    * @param {(Array<any>)[]} sources
     * @param {string} target_profile
     * @param {string | undefined} entry
     * @returns {string}
     */
-    load_source(path, source, target_profile, entry) {
-        let deferred5_0;
-        let deferred5_1;
+    load_source(sources, target_profile, entry) {
+        let deferred4_0;
+        let deferred4_1;
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            const ptr0 = passStringToWasm0(path, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+            const ptr0 = passArrayJsValueToWasm0(sources, wasm.__wbindgen_export_0);
             const len0 = WASM_VECTOR_LEN;
-            const ptr1 = passStringToWasm0(source, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+            const ptr1 = passStringToWasm0(target_profile, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
             const len1 = WASM_VECTOR_LEN;
-            const ptr2 = passStringToWasm0(target_profile, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
-            const len2 = WASM_VECTOR_LEN;
-            var ptr3 = isLikeNone(entry) ? 0 : passStringToWasm0(entry, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
-            var len3 = WASM_VECTOR_LEN;
-            wasm.debugservice_load_source(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2, ptr3, len3);
+            var ptr2 = isLikeNone(entry) ? 0 : passStringToWasm0(entry, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+            var len2 = WASM_VECTOR_LEN;
+            wasm.debugservice_load_source(retptr, this.__wbg_ptr, ptr0, len0, ptr1, len1, ptr2, len2);
             var r0 = getInt32Memory0()[retptr / 4 + 0];
             var r1 = getInt32Memory0()[retptr / 4 + 1];
-            deferred5_0 = r0;
-            deferred5_1 = r1;
+            deferred4_0 = r0;
+            deferred4_1 = r1;
             return getStringFromWasm0(r0, r1);
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
-            wasm.__wbindgen_export_2(deferred5_0, deferred5_1, 1);
+            wasm.__wbindgen_export_4(deferred4_0, deferred4_1, 1);
         }
     }
     /**
@@ -656,13 +685,28 @@ class LanguageService {
         wasm.__wbg_languageservice_free(ptr);
     }
     /**
-    * @param {(uri: string, version: number | undefined, diagnostics: VSDiagnostic[]) => void} diagnostics_callback
     */
-    constructor(diagnostics_callback) {
-        const ret = wasm.languageservice_new(addHeapObject(diagnostics_callback));
+    constructor() {
+        const ret = wasm.languageservice_new();
         return LanguageService.__wrap(ret);
     }
     /**
+    * @param {(uri: string, version: number | undefined, diagnostics: VSDiagnostic[]) => void} diagnostics_callback
+    * @param {(uri: string) => Promise<string | null>} read_file
+    * @param {(uri: string) => Promise<[string, number][]>} list_directory
+    * @param {(uri: string) => Promise<{ manifestDirectory: string }| null>} get_manifest
+    * @returns {Promise<any>}
+    */
+    start_background_work(diagnostics_callback, read_file, list_directory, get_manifest) {
+        const ret = wasm.languageservice_start_background_work(this.__wbg_ptr, addHeapObject(diagnostics_callback), addHeapObject(read_file), addHeapObject(list_directory), addHeapObject(get_manifest));
+        return takeObject(ret);
+    }
+    /**
+    */
+    stop_background_work() {
+        wasm.languageservice_stop_background_work(this.__wbg_ptr);
+    }
+    /**
     * @param {IWorkspaceConfiguration} config
     */
     update_configuration(config) {
@@ -702,14 +746,11 @@ class LanguageService {
     }
     /**
     * @param {string} notebook_uri
-    * @param {(string)[]} cell_uris
     */
-    close_notebook_document(notebook_uri, cell_uris) {
+    close_notebook_document(notebook_uri) {
         const ptr0 = passStringToWasm0(notebook_uri, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
         const len0 = WASM_VECTOR_LEN;
-        const ptr1 = passArrayJsValueToWasm0(cell_uris, wasm.__wbindgen_export_0);
-        const len1 = WASM_VECTOR_LEN;
-        wasm.languageservice_close_notebook_document(this.__wbg_ptr, ptr0, len0, ptr1, len1);
+        wasm.languageservice_close_notebook_document(this.__wbg_ptr, ptr0, len0);
     }
     /**
     * @param {string} uri
@@ -748,7 +789,7 @@ class LanguageService {
             var r0 = getInt32Memory0()[retptr / 4 + 0];
             var r1 = getInt32Memory0()[retptr / 4 + 1];
             var v2 = getArrayJsValueFromWasm0(r0, r1).slice();
-            wasm.__wbindgen_export_2(r0, r1 * 4);
+            wasm.__wbindgen_export_4(r0, r1 * 4);
             return v2;
         } finally {
             wasm.__wbindgen_add_to_stack_pointer(16);
@@ -803,11 +844,81 @@ class LanguageService {
     }
 }
 module.exports.LanguageService = LanguageService;
+/**
+* a minimal implementation for interacting with async JS filesystem callbacks to
+* load project files
+*/
+class ProjectLoader {
+
+    static __wrap(ptr) {
+        ptr = ptr >>> 0;
+        const obj = Object.create(ProjectLoader.prototype);
+        obj.__wbg_ptr = ptr;
+
+        return obj;
+    }
+
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+
+        return ptr;
+    }
+
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_projectloader_free(ptr);
+    }
+    /**
+    * @param {(uri: string) => Promise<string | null>} read_file
+    * @param {(uri: string) => Promise<[string, number][]>} list_directory
+    * @param {(uri: string) => Promise<{ manifestDirectory: string }| null>} get_manifest
+    */
+    constructor(read_file, list_directory, get_manifest) {
+        const ret = wasm.projectloader_new(addHeapObject(read_file), addHeapObject(list_directory), addHeapObject(get_manifest));
+        return ProjectLoader.__wrap(ret);
+    }
+    /**
+    * @param {{ manifestDirectory: string }} manifest
+    * @returns {Promise<[string, string][]>}
+    */
+    load_project(manifest) {
+        const ret = wasm.projectloader_load_project(this.__wbg_ptr, addHeapObject(manifest));
+        return takeObject(ret);
+    }
+}
+module.exports.ProjectLoader = ProjectLoader;
+
+module.exports.__wbindgen_string_get = function(arg0, arg1) {
+    const obj = getObject(arg1);
+    const ret = typeof(obj) === 'string' ? obj : undefined;
+    var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
+    var len1 = WASM_VECTOR_LEN;
+    getInt32Memory0()[arg0 / 4 + 1] = len1;
+    getInt32Memory0()[arg0 / 4 + 0] = ptr1;
+};
+
+module.exports.__wbindgen_number_get = function(arg0, arg1) {
+    const obj = getObject(arg1);
+    const ret = typeof(obj) === 'number' ? obj : undefined;
+    getFloat64Memory0()[arg0 / 8 + 1] = isLikeNone(ret) ? 0 : ret;
+    getInt32Memory0()[arg0 / 4 + 0] = !isLikeNone(ret);
+};
 
 module.exports.__wbindgen_object_drop_ref = function(arg0) {
     takeObject(arg0);
 };
 
+module.exports.__wbindgen_cb_drop = function(arg0) {
+    const obj = takeObject(arg0).original;
+    if (obj.cnt-- == 1) {
+        obj.a = 0;
+        return true;
+    }
+    const ret = false;
+    return ret;
+};
+
 module.exports.__wbindgen_bigint_from_u64 = function(arg0) {
     const ret = BigInt.asUintN(64, arg0);
     return addHeapObject(ret);
@@ -834,15 +945,6 @@ module.exports.__wbindgen_in = function(arg0, arg1) {
     return ret;
 };
 
-module.exports.__wbindgen_string_get = function(arg0, arg1) {
-    const obj = getObject(arg1);
-    const ret = typeof(obj) === 'string' ? obj : undefined;
-    var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_export_0, wasm.__wbindgen_export_1);
-    var len1 = WASM_VECTOR_LEN;
-    getInt32Memory0()[arg0 / 4 + 1] = len1;
-    getInt32Memory0()[arg0 / 4 + 0] = ptr1;
-};
-
 module.exports.__wbindgen_number_new = function(arg0) {
     const ret = arg0;
     return addHeapObject(ret);
@@ -866,11 +968,21 @@ module.exports.__wbg_stack_3090cd8fd3702c6e = function(arg0, arg1) {
     getInt32Memory0()[arg0 / 4 + 0] = ptr1;
 };
 
+module.exports.__wbindgen_is_null = function(arg0) {
+    const ret = getObject(arg0) === null;
+    return ret;
+};
+
 module.exports.__wbindgen_is_function = function(arg0) {
     const ret = typeof(getObject(arg0)) === 'function';
     return ret;
 };
 
+module.exports.__wbindgen_typeof = function(arg0) {
+    const ret = typeof getObject(arg0);
+    return addHeapObject(ret);
+};
+
 module.exports.__wbindgen_object_clone_ref = function(arg0) {
     const ret = getObject(arg0);
     return addHeapObject(ret);
@@ -887,13 +999,6 @@ module.exports.__wbindgen_boolean_get = function(arg0) {
     return ret;
 };
 
-module.exports.__wbindgen_number_get = function(arg0, arg1) {
-    const obj = getObject(arg1);
-    const ret = typeof(obj) === 'number' ? obj : undefined;
-    getFloat64Memory0()[arg0 / 8 + 1] = isLikeNone(ret) ? 0 : ret;
-    getInt32Memory0()[arg0 / 4 + 0] = !isLikeNone(ret);
-};
-
 module.exports.__wbg_getwithrefkey_d1f0d12f1f1b63ea = function(arg0, arg1) {
     const ret = getObject(arg0)[getObject(arg1)];
     return addHeapObject(ret);
@@ -1015,6 +1120,11 @@ module.exports.__wbg_isArray_4c24b343cb13cfb1 = function(arg0) {
     return ret;
 };
 
+module.exports.__wbg_push_ca1c26067ef907ac = function(arg0, arg1) {
+    const ret = getObject(arg0).push(getObject(arg1));
+    return ret;
+};
+
 module.exports.__wbg_instanceof_ArrayBuffer_39ac22089b74fddb = function(arg0) {
     let result;
     try {
@@ -1046,6 +1156,40 @@ module.exports.__wbg_buffer_085ec1f694018c4f = function(arg0) {
     return addHeapObject(ret);
 };
 
+module.exports.__wbg_new_43f1b47c28813cbd = function(arg0, arg1) {
+    try {
+        var state0 = {a: arg0, b: arg1};
+        var cb0 = (arg0, arg1) => {
+            const a = state0.a;
+            state0.a = 0;
+            try {
+                return __wbg_adapter_145(a, state0.b, arg0, arg1);
+            } finally {
+                state0.a = a;
+            }
+        };
+        const ret = new Promise(cb0);
+        return addHeapObject(ret);
+    } finally {
+        state0.a = state0.b = 0;
+    }
+};
+
+module.exports.__wbg_resolve_53698b95aaf7fcf8 = function(arg0) {
+    const ret = Promise.resolve(getObject(arg0));
+    return addHeapObject(ret);
+};
+
+module.exports.__wbg_then_f7e06ee3c11698eb = function(arg0, arg1) {
+    const ret = getObject(arg0).then(getObject(arg1));
+    return addHeapObject(ret);
+};
+
+module.exports.__wbg_then_b2267541e2a73865 = function(arg0, arg1, arg2) {
+    const ret = getObject(arg0).then(getObject(arg1), getObject(arg2));
+    return addHeapObject(ret);
+};
+
 module.exports.__wbg_self_1ff1d729e9aae938 = function() { return handleError(function () {
     const ret = self.self;
     return addHeapObject(ret);
@@ -1123,6 +1267,11 @@ module.exports.__wbindgen_memory = function() {
     return addHeapObject(ret);
 };
 
+module.exports.__wbindgen_closure_wrapper533 = function(arg0, arg1, arg2) {
+    const ret = makeMutClosure(arg0, arg1, 156, __wbg_adapter_44);
+    return addHeapObject(ret);
+};
+
 const path = require('path').join(__dirname, 'qsc_wasm_bg.wasm');
 const bytes = require('fs').readFileSync(path);
 

package/lib/node/qsc_wasm.d.cts

@@ -14,16 +14,16 @@ export function setLogLevel(level: number): void;
 */
 export function git_hash(): string;
 /**
-* @param {string} code
+* @param {(Array<any>)[]} sources
 * @returns {string}
 */
-export function get_qir(code: string): string;
+export function get_qir(sources: (Array<any>)[]): string;
 /**
-* @param {string} code
+* @param {(Array<any>)[]} sources
 * @param {string} params
 * @returns {string}
 */
-export function get_estimates(code: string, params: string): string;
+export function get_estimates(sources: (Array<any>)[], params: string): string;
 /**
 * @param {string} name
 * @returns {string | undefined}
@@ -35,13 +35,13 @@ export function get_library_source_content(name: string): string | undefined;
 */
 export function get_hir(code: string): string;
 /**
-* @param {string} code
+* @param {(Array<any>)[]} sources
 * @param {string} expr
 * @param {Function} event_cb
 * @param {number} shots
 * @returns {boolean}
 */
-export function run(code: string, expr: string, event_cb: Function, shots: number): boolean;
+export function run(sources: (Array<any>)[], expr: string, event_cb: Function, shots: number): boolean;
 /**
 * @param {string} solution_code
 * @param {any} exercise_sources_js
@@ -173,13 +173,13 @@ export interface ISignatureHelp {
 
 export interface ISignatureInformation {
         label: string;
-        documentation?: string;
+        documentation: string;
         parameters: IParameterInformation[];
     }
 
 export interface IParameterInformation {
         label: ISpan;
-        documentation?: string;
+        documentation: string;
     }
 
 export interface IWorkspaceEdit {
@@ -213,13 +213,12 @@ export class DebugService {
 */
   constructor();
 /**
-* @param {string} path
-* @param {string} source
+* @param {(Array<any>)[]} sources
 * @param {string} target_profile
 * @param {string | undefined} entry
 * @returns {string}
 */
-  load_source(path: string, source: string, target_profile: string, entry?: string): string;
+  load_source(sources: (Array<any>)[], target_profile: string, entry?: string): string;
 /**
 * @returns {IQuantumStateList}
 */
@@ -267,9 +266,19 @@ export class DebugService {
 export class LanguageService {
   free(): void;
 /**
+*/
+  constructor();
+/**
 * @param {(uri: string, version: number | undefined, diagnostics: VSDiagnostic[]) => void} diagnostics_callback
+* @param {(uri: string) => Promise<string | null>} read_file
+* @param {(uri: string) => Promise<[string, number][]>} list_directory
+* @param {(uri: string) => Promise<{ manifestDirectory: string }| null>} get_manifest
+* @returns {Promise<any>}
+*/
+  start_background_work(diagnostics_callback: (uri: string, version: number | undefined, diagnostics: VSDiagnostic[]) => void, read_file: (uri: string) => Promise<string | null>, list_directory: (uri: string) => Promise<[string, number][]>, get_manifest: (uri: string) => Promise<{ manifestDirectory: string }| null>): Promise<any>;
+/**
 */
-  constructor(diagnostics_callback: (uri: string, version: number | undefined, diagnostics: VSDiagnostic[]) => void);
+  stop_background_work(): void;
 /**
 * @param {IWorkspaceConfiguration} config
 */
@@ -292,9 +301,8 @@ export class LanguageService {
   update_notebook_document(notebook_uri: string, notebook_metadata: INotebookMetadata, cells: (ICell)[]): void;
 /**
 * @param {string} notebook_uri
-* @param {(string)[]} cell_uris
 */
-  close_notebook_document(notebook_uri: string, cell_uris: (string)[]): void;
+  close_notebook_document(notebook_uri: string): void;
 /**
 * @param {string} uri
 * @param {number} offset
@@ -340,3 +348,21 @@ export class LanguageService {
 */
   prepare_rename(uri: string, offset: number): ITextEdit | undefined;
 }
+/**
+* a minimal implementation for interacting with async JS filesystem callbacks to
+* load project files
+*/
+export class ProjectLoader {
+  free(): void;
+/**
+* @param {(uri: string) => Promise<string | null>} read_file
+* @param {(uri: string) => Promise<[string, number][]>} list_directory
+* @param {(uri: string) => Promise<{ manifestDirectory: string }| null>} get_manifest
+*/
+  constructor(read_file: (uri: string) => Promise<string | null>, list_directory: (uri: string) => Promise<[string, number][]>, get_manifest: (uri: string) => Promise<{ manifestDirectory: string }| null>);
+/**
+* @param {{ manifestDirectory: string }} manifest
+* @returns {Promise<[string, string][]>}
+*/
+  load_project(manifest: { manifestDirectory: string }): Promise<[string, string][]>;
+}