@componentor/quickjs-emscripten 0.31.0

package/dist/chunk-IBGVJUFE.mjs

@@ -0,0 +1,2 @@
+import{newQuickJSWASMModuleFromVariant,newQuickJSAsyncWASMModuleFromVariant}from"@componentor/quickjs-emscripten-core";import DEBUG_SYNC from"@componentor/quickjs-wasmfile-debug-sync";import RELEASE_SYNC from"@componentor/quickjs-wasmfile-release-sync";import DEBUG_ASYNC from"@componentor/quickjs-wasmfile-debug-asyncify";import RELEASE_ASYNC from"@componentor/quickjs-wasmfile-release-asyncify";async function newQuickJSWASMModule(variantOrPromise=RELEASE_SYNC){return newQuickJSWASMModuleFromVariant(variantOrPromise)}async function newQuickJSAsyncWASMModule(variantOrPromise=RELEASE_ASYNC){return newQuickJSAsyncWASMModuleFromVariant(variantOrPromise)}export{DEBUG_SYNC,RELEASE_SYNC,DEBUG_ASYNC,RELEASE_ASYNC,newQuickJSWASMModule,newQuickJSAsyncWASMModule};
+//# sourceMappingURL=chunk-IBGVJUFE.mjs.map

package/dist/chunk-IBGVJUFE.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/variants.ts"],"sourcesContent":["import type {\n  QuickJSSyncVariant,\n  QuickJSAsyncVariant,\n  QuickJSWASMModule,\n  QuickJSAsyncWASMModule,\n  PromisedDefault,\n} from \"@componentor/quickjs-emscripten-core\"\nimport {\n  newQuickJSWASMModuleFromVariant,\n  newQuickJSAsyncWASMModuleFromVariant,\n} from \"@componentor/quickjs-emscripten-core\"\nimport DEBUG_SYNC from \"@componentor/quickjs-wasmfile-debug-sync\"\nimport RELEASE_SYNC from \"@componentor/quickjs-wasmfile-release-sync\"\nimport DEBUG_ASYNC from \"@componentor/quickjs-wasmfile-debug-asyncify\"\nimport RELEASE_ASYNC from \"@componentor/quickjs-wasmfile-release-asyncify\"\n\n/**\n * Create a new, completely isolated WebAssembly module containing the QuickJS library.\n * See the documentation on {@link QuickJSWASMModule}.\n *\n * Note that there is a hard limit on the number of WebAssembly modules in older\n * versions of v8:\n * https://bugs.chromium.org/p/v8/issues/detail?id=12076\n */\nexport async function newQuickJSWASMModule(\n  /**\n   * Optionally, pass a {@link QuickJSSyncVariant} to construct a different WebAssembly module.\n   */\n  variantOrPromise: PromisedDefault<QuickJSSyncVariant> = RELEASE_SYNC,\n): Promise<QuickJSWASMModule> {\n  return newQuickJSWASMModuleFromVariant(variantOrPromise)\n}\n\n/**\n * Create a new, completely isolated WebAssembly module containing a version of the QuickJS library\n * compiled with Emscripten's [ASYNCIFY](https://emscripten.org/docs/porting/asyncify.html) transform.\n *\n * This version of the library offers features that enable synchronous code\n * inside the VM to interact with asynchronous code in the host environment.\n * See the documentation on {@link QuickJSAsyncWASMModule}, {@link QuickJSAsyncRuntime},\n * and {@link QuickJSAsyncContext}.\n *\n * Note that there is a hard limit on the number of WebAssembly modules in older\n * versions of v8:\n * https://bugs.chromium.org/p/v8/issues/detail?id=12076\n */\nexport async function newQuickJSAsyncWASMModule(\n  /**\n   * Optionally, pass a {@link QuickJSAsyncVariant} to construct a different WebAssembly module.\n   */\n  variantOrPromise: PromisedDefault<QuickJSAsyncVariant> = RELEASE_ASYNC,\n): Promise<QuickJSAsyncWASMModule> {\n  return newQuickJSAsyncWASMModuleFromVariant(variantOrPromise)\n}\n\nexport { DEBUG_SYNC, RELEASE_SYNC, DEBUG_ASYNC, RELEASE_ASYNC }\n"],"mappings":"AAOA,OACE,gCACA,yCACK,uCACP,OAAO,eAAgB,2CACvB,OAAO,iBAAkB,6CACzB,OAAO,gBAAiB,+CACxB,OAAO,kBAAmB,iDAU1B,eAAsB,qBAIpB,iBAAwD,aAC5B,CAC5B,OAAO,gCAAgC,gBAAgB,CACzD,CAeA,eAAsB,0BAIpB,iBAAyD,cACxB,CACjC,OAAO,qCAAqC,gBAAgB,CAC9D","names":[]}

package/dist/index.d.mts

@@ -0,0 +1,57 @@
+import { QuickJSWASMModule, AsyncRuntimeOptions, QuickJSAsyncRuntime, ContextOptions, QuickJSAsyncContext } from '@componentor/quickjs-emscripten-core';
+export * from '@componentor/quickjs-emscripten-core';
+export { newQuickJSAsyncWASMModule, newQuickJSWASMModule } from './variants.mjs';
+export { default as DEBUG_SYNC } from '@componentor/quickjs-wasmfile-debug-sync';
+export { default as RELEASE_SYNC } from '@componentor/quickjs-wasmfile-release-sync';
+export { default as DEBUG_ASYNC } from '@componentor/quickjs-wasmfile-debug-asyncify';
+export { default as RELEASE_ASYNC } from '@componentor/quickjs-wasmfile-release-asyncify';
+
+/**
+ * Get a shared singleton {@link QuickJSWASMModule}. Use this to evaluate code
+ * or create Javascript environments.
+ *
+ * This is the top-level entrypoint for the quickjs-emscripten library.
+ *
+ * If you need strictest possible isolation guarantees, you may create a
+ * separate {@link QuickJSWASMModule} via {@link newQuickJSWASMModule}.
+ *
+ * To work with the asyncified version of this library, see these functions:
+ *
+ * - {@link newAsyncRuntime}.
+ * - {@link newAsyncContext}.
+ * - {@link newQuickJSAsyncWASMModule}.
+ */
+declare function getQuickJS(): Promise<QuickJSWASMModule>;
+/**
+ * Provides synchronous access to the shared {@link QuickJSWASMModule} instance returned by {@link getQuickJS}, as long as
+ * least once.
+ * @throws If called before `getQuickJS` resolves.
+ */
+declare function getQuickJSSync(): QuickJSWASMModule;
+/**
+ * Create a new {@link QuickJSAsyncRuntime} in a separate WebAssembly module.
+ *
+ * Each runtime is isolated in a separate WebAssembly module, so that errors in
+ * one runtime cannot contaminate another runtime, and each runtime can execute
+ * an asynchronous action without conflicts.
+ *
+ * Note that there is a hard limit on the number of WebAssembly modules in older
+ * versions of v8:
+ * https://bugs.chromium.org/p/v8/issues/detail?id=12076
+ */
+declare function newAsyncRuntime(options?: AsyncRuntimeOptions): Promise<QuickJSAsyncRuntime>;
+/**
+ * Create a new {@link QuickJSAsyncContext} (with an associated runtime) in an
+ * separate WebAssembly module.
+ *
+ * Each context is isolated in a separate WebAssembly module, so that errors in
+ * one runtime cannot contaminate another runtime, and each runtime can execute
+ * an asynchronous action without conflicts.
+ *
+ * Note that there is a hard limit on the number of WebAssembly modules in older
+ * versions of v8:
+ * https://bugs.chromium.org/p/v8/issues/detail?id=12076
+ */
+declare function newAsyncContext(options?: ContextOptions): Promise<QuickJSAsyncContext>;
+
+export { getQuickJS, getQuickJSSync, newAsyncContext, newAsyncRuntime };

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+import { QuickJSWASMModule, AsyncRuntimeOptions, QuickJSAsyncRuntime, ContextOptions, QuickJSAsyncContext } from '@componentor/quickjs-emscripten-core';
+export * from '@componentor/quickjs-emscripten-core';
+export { newQuickJSAsyncWASMModule, newQuickJSWASMModule } from './variants.js';
+export { default as DEBUG_SYNC } from '@componentor/quickjs-wasmfile-debug-sync';
+export { default as RELEASE_SYNC } from '@componentor/quickjs-wasmfile-release-sync';
+export { default as DEBUG_ASYNC } from '@componentor/quickjs-wasmfile-debug-asyncify';
+export { default as RELEASE_ASYNC } from '@componentor/quickjs-wasmfile-release-asyncify';
+
+/**
+ * Get a shared singleton {@link QuickJSWASMModule}. Use this to evaluate code
+ * or create Javascript environments.
+ *
+ * This is the top-level entrypoint for the quickjs-emscripten library.
+ *
+ * If you need strictest possible isolation guarantees, you may create a
+ * separate {@link QuickJSWASMModule} via {@link newQuickJSWASMModule}.
+ *
+ * To work with the asyncified version of this library, see these functions:
+ *
+ * - {@link newAsyncRuntime}.
+ * - {@link newAsyncContext}.
+ * - {@link newQuickJSAsyncWASMModule}.
+ */
+declare function getQuickJS(): Promise<QuickJSWASMModule>;
+/**
+ * Provides synchronous access to the shared {@link QuickJSWASMModule} instance returned by {@link getQuickJS}, as long as
+ * least once.
+ * @throws If called before `getQuickJS` resolves.
+ */
+declare function getQuickJSSync(): QuickJSWASMModule;
+/**
+ * Create a new {@link QuickJSAsyncRuntime} in a separate WebAssembly module.
+ *
+ * Each runtime is isolated in a separate WebAssembly module, so that errors in
+ * one runtime cannot contaminate another runtime, and each runtime can execute
+ * an asynchronous action without conflicts.
+ *
+ * Note that there is a hard limit on the number of WebAssembly modules in older
+ * versions of v8:
+ * https://bugs.chromium.org/p/v8/issues/detail?id=12076
+ */
+declare function newAsyncRuntime(options?: AsyncRuntimeOptions): Promise<QuickJSAsyncRuntime>;
+/**
+ * Create a new {@link QuickJSAsyncContext} (with an associated runtime) in an
+ * separate WebAssembly module.
+ *
+ * Each context is isolated in a separate WebAssembly module, so that errors in
+ * one runtime cannot contaminate another runtime, and each runtime can execute
+ * an asynchronous action without conflicts.
+ *
+ * Note that there is a hard limit on the number of WebAssembly modules in older
+ * versions of v8:
+ * https://bugs.chromium.org/p/v8/issues/detail?id=12076
+ */
+declare function newAsyncContext(options?: ContextOptions): Promise<QuickJSAsyncContext>;
+
+export { getQuickJS, getQuickJSSync, newAsyncContext, newAsyncRuntime };