@ariestools/threads 8.1.0 → 8.1.2

package/dist/neutral/types/master.d.ts

@@ -27,9 +27,13 @@ export type ModuleProxy<Methods extends ModuleMethods> = {
 };
 /** Internal symbol-keyed properties attached to every spawned thread. */
 export interface PrivateThreadProps {
+    /** Observable stream of worker errors. */
     [$errors]: Observable<Error>;
+    /** Observable stream of worker lifecycle events. */
     [$events]: Observable<WorkerEvent>;
+    /** Terminates the backing worker. */
     [$terminate]: () => Promise<void>;
+    /** Worker backing the thread proxy. */
     [$worker]: Worker;
 }
 /** A thread wrapping a single exposed function. */
@@ -47,6 +51,7 @@ export type Thread = AnyFunctionThread | AnyModuleThread;
 export type TransferList = Transferable[];
 /** Worker instance. Either a web worker or a Node.js Worker provided by `worker_threads`. */
 export interface Worker extends EventTarget {
+    /** Send a value and optional transfer list to the worker. */
     postMessage(value: any, transferList?: TransferList): void;
     /** In Node.js return type is Promise while in browser return type is void */
     terminate(callback?: (error?: Error, exitCode?: number) => void): void | Promise<number>;
@@ -71,38 +76,53 @@ export interface ThreadsWorkerOptions extends WorkerOptions {
 }
 /** Worker implementation. Either web worker or a Node.js Worker class. */
 export declare class WorkerImplementation extends EventTarget implements Worker {
+    /** Create a worker for the given script path. */
     constructor(path: string, options?: ThreadsWorkerOptions);
+    /** Send a value and optional transfer list to the worker. */
     postMessage(value: any, transferList?: TransferList): void;
+    /** Terminate the worker. */
     terminate(): void | Promise<number>;
 }
 /** Class to spawn workers from a blob or source string. */
 export declare class BlobWorker extends WorkerImplementation {
+    /** Create a worker from a source blob. */
     constructor(blob: Blob, options?: ThreadsWorkerOptions);
+    /** Create a worker from JavaScript source text. */
     static fromText(source: string, options?: ThreadsWorkerOptions): WorkerImplementation;
 }
 /** Export shape for platform-specific worker implementations. */
 export interface ImplementationExport {
+    /** Constructor used for blob-backed workers. */
     blob: typeof BlobWorker;
+    /** Default constructor used for path-backed workers. */
     default: typeof WorkerImplementation;
 }
 /** Event as emitted by worker thread. Subscribe to using `Thread.events(thread)`. */
 export declare enum WorkerEventType {
+    /** The threads implementation encountered an internal error. */
     internalError = "internalError",
+    /** The worker emitted a message. */
     message = "message",
+    /** The worker terminated. */
     termination = "termination"
 }
 /** Event indicating an internal error occurred in the worker. */
 export interface WorkerInternalErrorEvent {
+    /** Error raised by the worker implementation. */
     error: Error;
+    /** Event discriminant. */
     type: WorkerEventType.internalError;
 }
 /** Event containing a message received from the worker. */
 export interface WorkerMessageEvent<Data> {
+    /** Message data received from the worker. */
     data: Data;
+    /** Event discriminant. */
     type: WorkerEventType.message;
 }
 /** Event indicating the worker has been terminated. */
 export interface WorkerTerminationEvent {
+    /** Event discriminant. */
     type: WorkerEventType.termination;
 }
 /** Union of all possible worker event types. */

package/dist/neutral/types/master.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"master.d.ts","sourceRoot":"","sources":["../../../src/types/master.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"master.d.ts","sourceRoot":"","sources":["../../../src/types/master.ts"],"names":[],"mappings":"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"}

package/dist/neutral/types/messages.d.ts

@@ -1,38 +1,57 @@
 /** Serialized representation of an Error for transmission between threads. */
 export interface SerializedError {
+    /** Marker distinguishing serialized errors from ordinary values. */
     __error_marker: '$$error';
+    /** Error message. */
     message: string;
+    /** Error class name. */
     name: string;
+    /** Captured stack trace, when available. */
     stack?: string;
 }
 /** Types of messages that the master thread can send to a worker. */
 export declare enum MasterMessageType {
+    /** Cancel a previously submitted job. */
     cancel = "cancel",
+    /** Run a job in the worker. */
     run = "run"
 }
 /** Message sent by the master to cancel a running job. */
 export type MasterJobCancelMessage = {
+    /** Message discriminant. */
     type: MasterMessageType.cancel;
+    /** Unique identifier of the job to cancel. */
     uid: number;
 };
 /** Message sent by the master to run a function in the worker. */
 export type MasterJobRunMessage = {
+    /** Message discriminant. */
     type: MasterMessageType.run;
+    /** Unique identifier assigned to the job. */
     uid: number;
+    /** Exposed module method to invoke, or omitted for an exposed function. */
     method?: string;
+    /** Arguments passed to the exposed function or method. */
     args: any[];
 };
 /** Types of messages that a worker thread can send to the master. */
 export declare enum WorkerMessageType {
+    /** A job failed. */
     error = "error",
+    /** The worker exposed its callable API. */
     init = "init",
+    /** A job produced a result. */
     result = "result",
+    /** A job started running. */
     running = "running",
+    /** An error escaped the worker job handler. */
     uncaughtError = "uncaughtError"
 }
 /** Message sent by a worker when an uncaught error occurs. */
 export type WorkerUncaughtErrorMessage = {
+    /** Message discriminant. */
     type: WorkerMessageType.uncaughtError;
+    /** Uncaught error details. */
     error: {
         message: string;
         name: string;
@@ -41,7 +60,9 @@ export type WorkerUncaughtErrorMessage = {
 };
 /** Message sent by a worker after calling `expose()` to signal its API to the master. */
 export type WorkerInitMessage = {
+    /** Message discriminant. */
     type: WorkerMessageType.init;
+    /** Shape of the function or module exposed by the worker. */
     exposed: {
         type: 'function';
     } | {
@@ -51,21 +72,31 @@ export type WorkerInitMessage = {
 };
 /** Message sent by a worker when a job encounters an error. */
 export type WorkerJobErrorMessage = {
+    /** Message discriminant. */
     type: WorkerMessageType.error;
+    /** Unique identifier of the failed job. */
     uid: number;
+    /** Serialized failure raised by the job. */
     error: SerializedError;
 };
 /** Message sent by a worker containing a job's result value. */
 export type WorkerJobResultMessage = {
+    /** Message discriminant. */
     type: WorkerMessageType.result;
+    /** Unique identifier of the completed or updated job. */
     uid: number;
+    /** Whether an observable job has finished emitting values. */
     complete?: true;
+    /** Result value or observable emission. */
     payload?: any;
 };
 /** Message sent by a worker when a job starts executing. */
 export type WorkerJobStartMessage = {
+    /** Message discriminant. */
     type: WorkerMessageType.running;
+    /** Unique identifier of the started job. */
     uid: number;
+    /** Asynchronous result protocol used by the job. */
     resultType: 'observable' | 'promise';
 };
 //# sourceMappingURL=messages.d.ts.map

package/dist/neutral/types/messages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/types/messages.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,SAAS,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAKD,qEAAqE;AACrE,oBAAY,iBAAiB;IAC3B,MAAM,WAAW;IACjB,GAAG,QAAQ;CACZ;AAED,0DAA0D;AAC1D,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAA;IAC9B,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,kEAAkE;AAClE,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,iBAAiB,CAAC,GAAG,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,GAAG,EAAE,CAAA;CACZ,CAAA;AAKD,qEAAqE;AACrE,oBAAY,iBAAiB;IAC3B,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,aAAa,kBAAkB;CAChC;AAED,8DAA8D;AAC9D,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,iBAAiB,CAAC,aAAa,CAAA;IACrC,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;CACF,CAAA;AAED,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAA;IAC5B,OAAO,EAAE;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CACtE,CAAA;AAED,+DAA+D;AAC/D,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAA;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,eAAe,CAAA;CACvB,CAAA;AAED,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAA;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,OAAO,CAAC,EAAE,GAAG,CAAA;CACd,CAAA;AAED,4DAA4D;AAC5D,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAA;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,YAAY,GAAG,SAAS,CAAA;CACrC,CAAA"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../../src/types/messages.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,cAAc,EAAE,SAAS,CAAA;IACzB,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAKD,qEAAqE;AACrE,oBAAY,iBAAiB;IAC3B,yCAAyC;IACzC,MAAM,WAAW;IACjB,+BAA+B;IAC/B,GAAG,QAAQ;CACZ;AAED,0DAA0D;AAC1D,MAAM,MAAM,sBAAsB,GAAG;IACnC,4BAA4B;IAC5B,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAA;IAC9B,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,kEAAkE;AAClE,MAAM,MAAM,mBAAmB,GAAG;IAChC,4BAA4B;IAC5B,IAAI,EAAE,iBAAiB,CAAC,GAAG,CAAA;IAC3B,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0DAA0D;IAC1D,IAAI,EAAE,GAAG,EAAE,CAAA;CACZ,CAAA;AAKD,qEAAqE;AACrE,oBAAY,iBAAiB;IAC3B,oBAAoB;IACpB,KAAK,UAAU;IACf,2CAA2C;IAC3C,IAAI,SAAS;IACb,+BAA+B;IAC/B,MAAM,WAAW;IACjB,6BAA6B;IAC7B,OAAO,YAAY;IACnB,+CAA+C;IAC/C,aAAa,kBAAkB;CAChC;AAED,8DAA8D;AAC9D,MAAM,MAAM,0BAA0B,GAAG;IACvC,4BAA4B;IAC5B,IAAI,EAAE,iBAAiB,CAAC,aAAa,CAAA;IACrC,8BAA8B;IAC9B,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;CACF,CAAA;AAED,yFAAyF;AACzF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4BAA4B;IAC5B,IAAI,EAAE,iBAAiB,CAAC,IAAI,CAAA;IAC5B,6DAA6D;IAC7D,OAAO,EAAE;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CACtE,CAAA;AAED,+DAA+D;AAC/D,MAAM,MAAM,qBAAqB,GAAG;IAClC,4BAA4B;IAC5B,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAA;IAC7B,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAA;IACX,4CAA4C;IAC5C,KAAK,EAAE,eAAe,CAAA;CACvB,CAAA;AAED,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG;IACnC,4BAA4B;IAC5B,IAAI,EAAE,iBAAiB,CAAC,MAAM,CAAA;IAC9B,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAA;IACX,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,IAAI,CAAA;IACf,2CAA2C;IAC3C,OAAO,CAAC,EAAE,GAAG,CAAA;CACd,CAAA;AAED,4DAA4D;AAC5D,MAAM,MAAM,qBAAqB,GAAG;IAClC,4BAA4B;IAC5B,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAA;IAC/B,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAA;IACX,oDAAoD;IACpD,UAAU,EAAE,YAAY,GAAG,SAAS,CAAA;CACrC,CAAA"}

package/dist/neutral/types/messages.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/types/messages.ts"],
-  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any */\n/* eslint-disable @typescript-eslint/member-ordering */\n\n/** Serialized representation of an Error for transmission between threads. */\nexport interface SerializedError {\n  __error_marker: '$$error'\n  message: string\n  name: string\n  stack?: string\n}\n\n/////////////////////////////\n// Messages sent by master:\n\n/** Types of messages that the master thread can send to a worker. */\nexport enum MasterMessageType {\n  cancel = 'cancel',\n  run = 'run',\n}\n\n/** Message sent by the master to cancel a running job. */\nexport type MasterJobCancelMessage = {\n  type: MasterMessageType.cancel\n  uid: number\n}\n\n/** Message sent by the master to run a function in the worker. */\nexport type MasterJobRunMessage = {\n  type: MasterMessageType.run\n  uid: number\n  method?: string\n  args: any[]\n}\n\n////////////////////////////\n// Messages sent by worker:\n\n/** Types of messages that a worker thread can send to the master. */\nexport enum WorkerMessageType {\n  error = 'error',\n  init = 'init',\n  result = 'result',\n  running = 'running',\n  uncaughtError = 'uncaughtError',\n}\n\n/** Message sent by a worker when an uncaught error occurs. */\nexport type WorkerUncaughtErrorMessage = {\n  type: WorkerMessageType.uncaughtError\n  error: {\n    message: string\n    name: string\n    stack?: string\n  }\n}\n\n/** Message sent by a worker after calling `expose()` to signal its API to the master. */\nexport type WorkerInitMessage = {\n  type: WorkerMessageType.init\n  exposed: { type: 'function' } | { type: 'module'; methods: string[] }\n}\n\n/** Message sent by a worker when a job encounters an error. */\nexport type WorkerJobErrorMessage = {\n  type: WorkerMessageType.error\n  uid: number\n  error: SerializedError\n}\n\n/** Message sent by a worker containing a job's result value. */\nexport type WorkerJobResultMessage = {\n  type: WorkerMessageType.result\n  uid: number\n  complete?: true\n  payload?: any\n}\n\n/** Message sent by a worker when a job starts executing. */\nexport type WorkerJobStartMessage = {\n  type: WorkerMessageType.running\n  uid: number\n  resultType: 'observable' | 'promise'\n}\n"],
-  "mappings": ";AAeO,IAAK,oBAAL,kBAAKA,uBAAL;AACL,EAAAA,mBAAA,YAAS;AACT,EAAAA,mBAAA,SAAM;AAFI,SAAAA;AAAA,GAAA;AAuBL,IAAK,oBAAL,kBAAKC,uBAAL;AACL,EAAAA,mBAAA,WAAQ;AACR,EAAAA,mBAAA,UAAO;AACP,EAAAA,mBAAA,YAAS;AACT,EAAAA,mBAAA,aAAU;AACV,EAAAA,mBAAA,mBAAgB;AALN,SAAAA;AAAA,GAAA;",
+  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any */\n/* eslint-disable @typescript-eslint/member-ordering */\n\n/** Serialized representation of an Error for transmission between threads. */\nexport interface SerializedError {\n  /** Marker distinguishing serialized errors from ordinary values. */\n  __error_marker: '$$error'\n  /** Error message. */\n  message: string\n  /** Error class name. */\n  name: string\n  /** Captured stack trace, when available. */\n  stack?: string\n}\n\n/////////////////////////////\n// Messages sent by master:\n\n/** Types of messages that the master thread can send to a worker. */\nexport enum MasterMessageType {\n  /** Cancel a previously submitted job. */\n  cancel = 'cancel',\n  /** Run a job in the worker. */\n  run = 'run',\n}\n\n/** Message sent by the master to cancel a running job. */\nexport type MasterJobCancelMessage = {\n  /** Message discriminant. */\n  type: MasterMessageType.cancel\n  /** Unique identifier of the job to cancel. */\n  uid: number\n}\n\n/** Message sent by the master to run a function in the worker. */\nexport type MasterJobRunMessage = {\n  /** Message discriminant. */\n  type: MasterMessageType.run\n  /** Unique identifier assigned to the job. */\n  uid: number\n  /** Exposed module method to invoke, or omitted for an exposed function. */\n  method?: string\n  /** Arguments passed to the exposed function or method. */\n  args: any[]\n}\n\n////////////////////////////\n// Messages sent by worker:\n\n/** Types of messages that a worker thread can send to the master. */\nexport enum WorkerMessageType {\n  /** A job failed. */\n  error = 'error',\n  /** The worker exposed its callable API. */\n  init = 'init',\n  /** A job produced a result. */\n  result = 'result',\n  /** A job started running. */\n  running = 'running',\n  /** An error escaped the worker job handler. */\n  uncaughtError = 'uncaughtError',\n}\n\n/** Message sent by a worker when an uncaught error occurs. */\nexport type WorkerUncaughtErrorMessage = {\n  /** Message discriminant. */\n  type: WorkerMessageType.uncaughtError\n  /** Uncaught error details. */\n  error: {\n    message: string\n    name: string\n    stack?: string\n  }\n}\n\n/** Message sent by a worker after calling `expose()` to signal its API to the master. */\nexport type WorkerInitMessage = {\n  /** Message discriminant. */\n  type: WorkerMessageType.init\n  /** Shape of the function or module exposed by the worker. */\n  exposed: { type: 'function' } | { type: 'module'; methods: string[] }\n}\n\n/** Message sent by a worker when a job encounters an error. */\nexport type WorkerJobErrorMessage = {\n  /** Message discriminant. */\n  type: WorkerMessageType.error\n  /** Unique identifier of the failed job. */\n  uid: number\n  /** Serialized failure raised by the job. */\n  error: SerializedError\n}\n\n/** Message sent by a worker containing a job's result value. */\nexport type WorkerJobResultMessage = {\n  /** Message discriminant. */\n  type: WorkerMessageType.result\n  /** Unique identifier of the completed or updated job. */\n  uid: number\n  /** Whether an observable job has finished emitting values. */\n  complete?: true\n  /** Result value or observable emission. */\n  payload?: any\n}\n\n/** Message sent by a worker when a job starts executing. */\nexport type WorkerJobStartMessage = {\n  /** Message discriminant. */\n  type: WorkerMessageType.running\n  /** Unique identifier of the started job. */\n  uid: number\n  /** Asynchronous result protocol used by the job. */\n  resultType: 'observable' | 'promise'\n}\n"],
+  "mappings": ";AAmBO,IAAK,oBAAL,kBAAKA,uBAAL;AAEL,EAAAA,mBAAA,YAAS;AAET,EAAAA,mBAAA,SAAM;AAJI,SAAAA;AAAA,GAAA;AA+BL,IAAK,oBAAL,kBAAKC,uBAAL;AAEL,EAAAA,mBAAA,WAAQ;AAER,EAAAA,mBAAA,UAAO;AAEP,EAAAA,mBAAA,YAAS;AAET,EAAAA,mBAAA,aAAU;AAEV,EAAAA,mBAAA,mBAAgB;AAVN,SAAAA;AAAA,GAAA;",
   "names": ["MasterMessageType", "WorkerMessageType"]
 }

package/dist/neutral/types/worker.d.ts

@@ -1,8 +1,11 @@
 type UnsubscribeFn = () => void;
 /** Abstraction layer for the worker runtime API, used by `expose()` to communicate with the master thread. */
 export interface AbstractedWorkerAPI {
+    /** Determine whether the current runtime is a worker. */
     isWorkerRuntime(): boolean;
+    /** Send a message and optional transfer list to the master thread. */
     postMessageToMaster(message: any, transferList?: Transferable[]): void;
+    /** Subscribe to messages sent by the master thread. */
     subscribeToMasterMessages(onMessage: (data: any) => void): UnsubscribeFn;
 }
 /** A function that can be exposed from a worker thread. */

package/dist/neutral/types/worker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/types/worker.ts"],"names":[],"mappings":"AAEA,KAAK,aAAa,GAAG,MAAM,IAAI,CAAA;AAE/B,8GAA8G;AAC9G,MAAM,WAAW,mBAAmB;IAClC,eAAe,IAAI,OAAO,CAAA;IAC1B,mBAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAA;IACtE,yBAAyB,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,aAAa,CAAA;CACzE;AAED,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAA;AAEpE,gGAAgG;AAChG,MAAM,MAAM,YAAY,CAAC,IAAI,SAAS,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA"}
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/types/worker.ts"],"names":[],"mappings":"AAEA,KAAK,aAAa,GAAG,MAAM,IAAI,CAAA;AAE/B,8GAA8G;AAC9G,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,eAAe,IAAI,OAAO,CAAA;IAC1B,sEAAsE;IACtE,mBAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAA;IACtE,uDAAuD;IACvD,yBAAyB,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,aAAa,CAAA;CACzE;AAED,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAA;AAEpE,gGAAgG;AAChG,MAAM,MAAM,YAAY,CAAC,IAAI,SAAS,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA"}

package/dist/neutral/worker/WorkerGlobalScope.d.ts

@@ -1,7 +1,10 @@
 /** Minimal interface representing the global scope inside a web worker. */
 export interface WorkerGlobalScope {
+    /** Register a worker-global event listener. */
     addEventListener(eventName: string, listener: (event: Event) => void): void;
+    /** Send a message and optional transfer list to the master context. */
     postMessage(message: unknown, transferList?: readonly Transferable[]): void;
+    /** Remove a worker-global event listener. */
     removeEventListener(eventName: string, listener: (event: Event) => void): void;
 }
 //# sourceMappingURL=WorkerGlobalScope.d.ts.map

package/dist/neutral/worker/WorkerGlobalScope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkerGlobalScope.d.ts","sourceRoot":"","sources":["../../../src/worker/WorkerGlobalScope.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAA;IAC3E,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAAA;IAC3E,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAA;CAC/E"}
+{"version":3,"file":"WorkerGlobalScope.d.ts","sourceRoot":"","sources":["../../../src/worker/WorkerGlobalScope.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAA;IAC3E,uEAAuE;IACvE,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAAA;IAC3E,6CAA6C;IAC7C,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAA;CAC/E"}

package/dist/node/index-node.mjs

@@ -469,6 +469,7 @@ function isThenable(thing) {
   return thing != null && typeof thing.then === "function";
 }
 var ObservablePromise = class _ObservablePromise extends Observable2 {
+  /** Standard object tag identifying this hybrid promise. */
   [Symbol.toStringTag] = "[object ObservablePromise]";
   initHasRun = false;
   fulfillmentCallbacks = [];
@@ -477,6 +478,10 @@ var ObservablePromise = class _ObservablePromise extends Observable2 {
   firstValueSet = false;
   rejection;
   state = "pending";
+  /**
+   * Create an observable promise.
+   * @param init Initializes each observable subscription.
+   */
   constructor(init) {
     super((originalObserver) => {
       const self = this;
@@ -559,12 +564,15 @@ var ObservablePromise = class _ObservablePromise extends Observable2 {
       this.rejectionCallbacks.push(rejectionCallback);
     });
   }
+  /** Register handlers for the first emitted value or a rejection. */
   then(onFulfilledRaw, onRejectedRaw) {
     return this.createPromise(onFulfilledRaw, onRejectedRaw);
   }
+  /** Register a rejection handler. */
   catch(onRejected) {
     return this.createPromise(void 0, onRejected);
   }
+  /** Register a handler invoked after fulfillment or rejection. */
   finally(onCompleted) {
     const handler = onCompleted || doNothing2;
     return this.createPromise(
@@ -575,6 +583,7 @@ var ObservablePromise = class _ObservablePromise extends Observable2 {
       () => handler()
     );
   }
+  /** Convert an observable, thenable, or array-like value to an observable promise. */
   static from(thing) {
     return isThenable(thing) ? new _ObservablePromise((observer) => {
       void (async () => {