@math.gl/tasks 0.0.0-stage → 5.0.0-beta.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (212) hide show
  1. package/LICENSE +147 -0
  2. package/LOADERS-GL-LICENSE.txt +52 -0
  3. package/README.md +26 -2
  4. package/THIRD-PARTY-NOTICES.md +5 -0
  5. package/dist/index.cjs +3454 -0
  6. package/dist/index.cjs.map +6 -0
  7. package/dist/index.d.ts +2 -0
  8. package/dist/index.d.ts.map +1 -0
  9. package/dist/index.js +5 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/tasks/index.d.ts +9 -0
  12. package/dist/tasks/index.d.ts.map +1 -0
  13. package/dist/tasks/index.js +9 -0
  14. package/dist/tasks/index.js.map +1 -0
  15. package/dist/tasks/task-channel.d.ts +48 -0
  16. package/dist/tasks/task-channel.d.ts.map +1 -0
  17. package/dist/tasks/task-channel.js +166 -0
  18. package/dist/tasks/task-channel.js.map +1 -0
  19. package/dist/tasks/task-operation-queue.d.ts +26 -0
  20. package/dist/tasks/task-operation-queue.d.ts.map +1 -0
  21. package/dist/tasks/task-operation-queue.js +106 -0
  22. package/dist/tasks/task-operation-queue.js.map +1 -0
  23. package/dist/tasks/task-preload.d.ts +13 -0
  24. package/dist/tasks/task-preload.d.ts.map +1 -0
  25. package/dist/tasks/task-preload.js +96 -0
  26. package/dist/tasks/task-preload.js.map +1 -0
  27. package/dist/tasks/task-runner.d.ts +74 -0
  28. package/dist/tasks/task-runner.d.ts.map +1 -0
  29. package/dist/tasks/task-runner.js +811 -0
  30. package/dist/tasks/task-runner.js.map +1 -0
  31. package/dist/tasks/task-runtime.d.ts +27 -0
  32. package/dist/tasks/task-runtime.d.ts.map +1 -0
  33. package/dist/tasks/task-runtime.js +216 -0
  34. package/dist/tasks/task-runtime.js.map +1 -0
  35. package/dist/tasks/task-sync.d.ts +4 -0
  36. package/dist/tasks/task-sync.d.ts.map +1 -0
  37. package/dist/tasks/task-sync.js +95 -0
  38. package/dist/tasks/task-sync.js.map +1 -0
  39. package/dist/tasks/task-worker-channel.d.ts +11 -0
  40. package/dist/tasks/task-worker-channel.d.ts.map +1 -0
  41. package/dist/tasks/task-worker-channel.js +34 -0
  42. package/dist/tasks/task-worker-channel.js.map +1 -0
  43. package/dist/tasks/task.d.ts +132 -0
  44. package/dist/tasks/task.d.ts.map +1 -0
  45. package/dist/tasks/task.js +5 -0
  46. package/dist/tasks/task.js.map +1 -0
  47. package/dist/tasks/typed-task-dispatch.d.ts +30 -0
  48. package/dist/tasks/typed-task-dispatch.d.ts.map +1 -0
  49. package/dist/tasks/typed-task-dispatch.js +12 -0
  50. package/dist/tasks/typed-task-dispatch.js.map +1 -0
  51. package/dist/worker-utils/index.d.ts +25 -0
  52. package/dist/worker-utils/index.d.ts.map +1 -0
  53. package/dist/worker-utils/index.js +46 -0
  54. package/dist/worker-utils/index.js.map +1 -0
  55. package/dist/worker-utils/lib/async-queue/async-queue.d.ts +32 -0
  56. package/dist/worker-utils/lib/async-queue/async-queue.d.ts.map +1 -0
  57. package/dist/worker-utils/lib/async-queue/async-queue.js +88 -0
  58. package/dist/worker-utils/lib/async-queue/async-queue.js.map +1 -0
  59. package/dist/worker-utils/lib/env-utils/assert.d.ts +3 -0
  60. package/dist/worker-utils/lib/env-utils/assert.d.ts.map +1 -0
  61. package/dist/worker-utils/lib/env-utils/assert.js +13 -0
  62. package/dist/worker-utils/lib/env-utils/assert.js.map +1 -0
  63. package/dist/worker-utils/lib/env-utils/globals.d.ts +22 -0
  64. package/dist/worker-utils/lib/env-utils/globals.d.ts.map +1 -0
  65. package/dist/worker-utils/lib/env-utils/globals.js +30 -0
  66. package/dist/worker-utils/lib/env-utils/globals.js.map +1 -0
  67. package/dist/worker-utils/lib/env-utils/version.d.ts +3 -0
  68. package/dist/worker-utils/lib/env-utils/version.d.ts.map +1 -0
  69. package/dist/worker-utils/lib/env-utils/version.js +11 -0
  70. package/dist/worker-utils/lib/env-utils/version.js.map +1 -0
  71. package/dist/worker-utils/lib/library-utils/library-utils.d.ts +42 -0
  72. package/dist/worker-utils/lib/library-utils/library-utils.d.ts.map +1 -0
  73. package/dist/worker-utils/lib/library-utils/library-utils.js +251 -0
  74. package/dist/worker-utils/lib/library-utils/library-utils.js.map +1 -0
  75. package/dist/worker-utils/lib/node/worker_threads-browser.d.ts +15 -0
  76. package/dist/worker-utils/lib/node/worker_threads-browser.d.ts.map +1 -0
  77. package/dist/worker-utils/lib/node/worker_threads-browser.js +23 -0
  78. package/dist/worker-utils/lib/node/worker_threads-browser.js.map +1 -0
  79. package/dist/worker-utils/lib/node/worker_threads.d.ts +16 -0
  80. package/dist/worker-utils/lib/node/worker_threads.d.ts.map +1 -0
  81. package/dist/worker-utils/lib/node/worker_threads.js +7 -0
  82. package/dist/worker-utils/lib/node/worker_threads.js.map +1 -0
  83. package/dist/worker-utils/lib/npm-tag.d.ts +2 -0
  84. package/dist/worker-utils/lib/npm-tag.d.ts.map +1 -0
  85. package/dist/worker-utils/lib/npm-tag.js +5 -0
  86. package/dist/worker-utils/lib/npm-tag.js.map +1 -0
  87. package/dist/worker-utils/lib/process-utils/child-process-proxy.browser.d.ts +8 -0
  88. package/dist/worker-utils/lib/process-utils/child-process-proxy.browser.d.ts.map +1 -0
  89. package/dist/worker-utils/lib/process-utils/child-process-proxy.browser.js +18 -0
  90. package/dist/worker-utils/lib/process-utils/child-process-proxy.browser.js.map +1 -0
  91. package/dist/worker-utils/lib/process-utils/child-process-proxy.d.ts +45 -0
  92. package/dist/worker-utils/lib/process-utils/child-process-proxy.d.ts.map +1 -0
  93. package/dist/worker-utils/lib/process-utils/child-process-proxy.js +128 -0
  94. package/dist/worker-utils/lib/process-utils/child-process-proxy.js.map +1 -0
  95. package/dist/worker-utils/lib/process-utils/process-utils.d.ts +2 -0
  96. package/dist/worker-utils/lib/process-utils/process-utils.d.ts.map +1 -0
  97. package/dist/worker-utils/lib/process-utils/process-utils.js +32 -0
  98. package/dist/worker-utils/lib/process-utils/process-utils.js.map +1 -0
  99. package/dist/worker-utils/lib/worker-api/create-worker.d.ts +9 -0
  100. package/dist/worker-utils/lib/worker-api/create-worker.d.ts.map +1 -0
  101. package/dist/worker-utils/lib/worker-api/create-worker.js +229 -0
  102. package/dist/worker-utils/lib/worker-api/create-worker.js.map +1 -0
  103. package/dist/worker-utils/lib/worker-api/get-worker-url.d.ts +29 -0
  104. package/dist/worker-utils/lib/worker-api/get-worker-url.d.ts.map +1 -0
  105. package/dist/worker-utils/lib/worker-api/get-worker-url.js +101 -0
  106. package/dist/worker-utils/lib/worker-api/get-worker-url.js.map +1 -0
  107. package/dist/worker-utils/lib/worker-api/process-on-worker.d.ts +67 -0
  108. package/dist/worker-utils/lib/worker-api/process-on-worker.d.ts.map +1 -0
  109. package/dist/worker-utils/lib/worker-api/process-on-worker.js +429 -0
  110. package/dist/worker-utils/lib/worker-api/process-on-worker.js.map +1 -0
  111. package/dist/worker-utils/lib/worker-api/shared-state.d.ts +34 -0
  112. package/dist/worker-utils/lib/worker-api/shared-state.d.ts.map +1 -0
  113. package/dist/worker-utils/lib/worker-api/shared-state.js +105 -0
  114. package/dist/worker-utils/lib/worker-api/shared-state.js.map +1 -0
  115. package/dist/worker-utils/lib/worker-api/validate-output-ownership.d.ts +3 -0
  116. package/dist/worker-utils/lib/worker-api/validate-output-ownership.d.ts.map +1 -0
  117. package/dist/worker-utils/lib/worker-api/validate-output-ownership.js +10 -0
  118. package/dist/worker-utils/lib/worker-api/validate-output-ownership.js.map +1 -0
  119. package/dist/worker-utils/lib/worker-api/validate-worker-version.d.ts +9 -0
  120. package/dist/worker-utils/lib/worker-api/validate-worker-version.d.ts.map +1 -0
  121. package/dist/worker-utils/lib/worker-api/validate-worker-version.js +35 -0
  122. package/dist/worker-utils/lib/worker-api/validate-worker-version.js.map +1 -0
  123. package/dist/worker-utils/lib/worker-api/worker-resource.d.ts +33 -0
  124. package/dist/worker-utils/lib/worker-api/worker-resource.d.ts.map +1 -0
  125. package/dist/worker-utils/lib/worker-api/worker-resource.js +156 -0
  126. package/dist/worker-utils/lib/worker-api/worker-resource.js.map +1 -0
  127. package/dist/worker-utils/lib/worker-farm/worker-body.d.ts +20 -0
  128. package/dist/worker-utils/lib/worker-farm/worker-body.d.ts.map +1 -0
  129. package/dist/worker-utils/lib/worker-farm/worker-body.js +134 -0
  130. package/dist/worker-utils/lib/worker-farm/worker-body.js.map +1 -0
  131. package/dist/worker-utils/lib/worker-farm/worker-farm.d.ts +73 -0
  132. package/dist/worker-utils/lib/worker-farm/worker-farm.d.ts.map +1 -0
  133. package/dist/worker-utils/lib/worker-farm/worker-farm.js +135 -0
  134. package/dist/worker-utils/lib/worker-farm/worker-farm.js.map +1 -0
  135. package/dist/worker-utils/lib/worker-farm/worker-job.d.ts +47 -0
  136. package/dist/worker-utils/lib/worker-farm/worker-job.d.ts.map +1 -0
  137. package/dist/worker-utils/lib/worker-farm/worker-job.js +124 -0
  138. package/dist/worker-utils/lib/worker-farm/worker-job.js.map +1 -0
  139. package/dist/worker-utils/lib/worker-farm/worker-pool.d.ts +152 -0
  140. package/dist/worker-utils/lib/worker-farm/worker-pool.d.ts.map +1 -0
  141. package/dist/worker-utils/lib/worker-farm/worker-pool.js +584 -0
  142. package/dist/worker-utils/lib/worker-farm/worker-pool.js.map +1 -0
  143. package/dist/worker-utils/lib/worker-farm/worker-thread.d.ts +77 -0
  144. package/dist/worker-utils/lib/worker-farm/worker-thread.d.ts.map +1 -0
  145. package/dist/worker-utils/lib/worker-farm/worker-thread.js +215 -0
  146. package/dist/worker-utils/lib/worker-farm/worker-thread.js.map +1 -0
  147. package/dist/worker-utils/lib/worker-utils/get-input-byte-length.d.ts +5 -0
  148. package/dist/worker-utils/lib/worker-utils/get-input-byte-length.d.ts.map +1 -0
  149. package/dist/worker-utils/lib/worker-utils/get-input-byte-length.js +39 -0
  150. package/dist/worker-utils/lib/worker-utils/get-input-byte-length.js.map +1 -0
  151. package/dist/worker-utils/lib/worker-utils/get-loadable-worker-url.d.ts +15 -0
  152. package/dist/worker-utils/lib/worker-utils/get-loadable-worker-url.d.ts.map +1 -0
  153. package/dist/worker-utils/lib/worker-utils/get-loadable-worker-url.js +84 -0
  154. package/dist/worker-utils/lib/worker-utils/get-loadable-worker-url.js.map +1 -0
  155. package/dist/worker-utils/lib/worker-utils/get-transfer-list.d.ts +16 -0
  156. package/dist/worker-utils/lib/worker-utils/get-transfer-list.d.ts.map +1 -0
  157. package/dist/worker-utils/lib/worker-utils/get-transfer-list.js +127 -0
  158. package/dist/worker-utils/lib/worker-utils/get-transfer-list.js.map +1 -0
  159. package/dist/worker-utils/lib/worker-utils/remove-nontransferable-options.d.ts +6 -0
  160. package/dist/worker-utils/lib/worker-utils/remove-nontransferable-options.d.ts.map +1 -0
  161. package/dist/worker-utils/lib/worker-utils/remove-nontransferable-options.js +27 -0
  162. package/dist/worker-utils/lib/worker-utils/remove-nontransferable-options.js.map +1 -0
  163. package/dist/worker-utils/types.d.ts +165 -0
  164. package/dist/worker-utils/types.d.ts.map +1 -0
  165. package/dist/worker-utils/types.js +5 -0
  166. package/dist/worker-utils/types.js.map +1 -0
  167. package/dist/worker-utils/workers/null-worker.d.ts +2 -0
  168. package/dist/worker-utils/workers/null-worker.d.ts.map +1 -0
  169. package/dist/worker-utils/workers/null-worker.js +17 -0
  170. package/dist/worker-utils/workers/null-worker.js.map +1 -0
  171. package/package.json +43 -4
  172. package/src/index.ts +5 -0
  173. package/src/tasks/index.ts +33 -0
  174. package/src/tasks/task-channel.ts +191 -0
  175. package/src/tasks/task-operation-queue.ts +109 -0
  176. package/src/tasks/task-preload.ts +107 -0
  177. package/src/tasks/task-runner.ts +933 -0
  178. package/src/tasks/task-runtime.ts +244 -0
  179. package/src/tasks/task-sync.ts +100 -0
  180. package/src/tasks/task-worker-channel.ts +44 -0
  181. package/src/tasks/task.ts +168 -0
  182. package/src/tasks/typed-task-dispatch.ts +44 -0
  183. package/src/worker-utils/index.ts +105 -0
  184. package/src/worker-utils/lib/async-queue/async-queue.ts +100 -0
  185. package/src/worker-utils/lib/env-utils/assert.ts +14 -0
  186. package/src/worker-utils/lib/env-utils/globals.ts +40 -0
  187. package/src/worker-utils/lib/env-utils/version.ts +15 -0
  188. package/src/worker-utils/lib/library-utils/library-utils.ts +305 -0
  189. package/src/worker-utils/lib/node/worker_threads-browser.ts +44 -0
  190. package/src/worker-utils/lib/node/worker_threads.ts +21 -0
  191. package/src/worker-utils/lib/npm-tag.ts +5 -0
  192. package/src/worker-utils/lib/process-utils/child-process-proxy.browser.ts +23 -0
  193. package/src/worker-utils/lib/process-utils/child-process-proxy.ts +172 -0
  194. package/src/worker-utils/lib/process-utils/process-utils.ts +34 -0
  195. package/src/worker-utils/lib/worker-api/create-worker.ts +271 -0
  196. package/src/worker-utils/lib/worker-api/get-worker-url.ts +130 -0
  197. package/src/worker-utils/lib/worker-api/process-on-worker.ts +596 -0
  198. package/src/worker-utils/lib/worker-api/shared-state.ts +135 -0
  199. package/src/worker-utils/lib/worker-api/validate-output-ownership.ts +10 -0
  200. package/src/worker-utils/lib/worker-api/validate-worker-version.ts +44 -0
  201. package/src/worker-utils/lib/worker-api/worker-resource.ts +203 -0
  202. package/src/worker-utils/lib/worker-farm/worker-body.ts +154 -0
  203. package/src/worker-utils/lib/worker-farm/worker-farm.ts +172 -0
  204. package/src/worker-utils/lib/worker-farm/worker-job.ts +148 -0
  205. package/src/worker-utils/lib/worker-farm/worker-pool.ts +719 -0
  206. package/src/worker-utils/lib/worker-farm/worker-thread.ts +260 -0
  207. package/src/worker-utils/lib/worker-utils/get-input-byte-length.ts +34 -0
  208. package/src/worker-utils/lib/worker-utils/get-loadable-worker-url.ts +96 -0
  209. package/src/worker-utils/lib/worker-utils/get-transfer-list.ts +125 -0
  210. package/src/worker-utils/lib/worker-utils/remove-nontransferable-options.ts +27 -0
  211. package/src/worker-utils/types.ts +224 -0
  212. package/src/worker-utils/workers/null-worker.ts +20 -0
@@ -0,0 +1,96 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+ import { WorkerPool, preloadWorker } from "../worker-utils/index.js";
5
+ const pending = new WeakMap();
6
+ const loaded = new WeakSet();
7
+ /** @internal One code-loading hook per definition in this JavaScript environment. */
8
+ export function preloadTaskCode(task, signal) {
9
+ if (!task.preload)
10
+ return Promise.resolve();
11
+ let promise = pending.get(task);
12
+ if (!promise) {
13
+ promise = Promise.resolve()
14
+ .then(() => task.preload())
15
+ .then(() => {
16
+ loaded.add(task);
17
+ });
18
+ pending.set(task, promise);
19
+ void promise.catch(() => pending.delete(task));
20
+ }
21
+ return withSignal(promise, signal);
22
+ }
23
+ /** @internal Synchronous calls cannot start or await module loading. */
24
+ export function isTaskCodeLoaded(task) {
25
+ return !task.preload || loaded.has(task);
26
+ }
27
+ /**
28
+ * Load code ahead of execution, without task state or a runner-owned worker pool.
29
+ * Worker targets use a temporary worker to load their actual bundled dependency
30
+ * graph, await preload/readiness, then terminate. Later workers use browser caches
31
+ * where cache headers permit; worker startup and state initialization still occur.
32
+ */
33
+ export async function preloadTasks(tasks, options = {}) {
34
+ const execution = options.execution ?? 'auto';
35
+ if (!['auto', 'main-thread', 'worker'].includes(execution))
36
+ throw new TypeError('Invalid execution mode');
37
+ options.signal?.throwIfAborted();
38
+ // Sequential loading bounds temporary workers to one per invocation.
39
+ for (const task of new Set(tasks)) {
40
+ options.signal?.throwIfAborted();
41
+ if (execution === 'worker' && !task.worker)
42
+ throw new Error('Task has no worker');
43
+ if (execution === 'main-thread' || !task.worker) {
44
+ await preloadTaskCode(task, options.signal);
45
+ continue;
46
+ }
47
+ const target = task.worker;
48
+ if (Boolean(target.url) === Boolean(target.create))
49
+ throw new Error('Supply exactly one worker URL or factory');
50
+ const pool = new WorkerPool({
51
+ name: task.id,
52
+ url: target.url?.toString(),
53
+ loadWorker: target.create,
54
+ workerType: 'module',
55
+ maxConcurrency: 1,
56
+ maxMobileConcurrency: 1
57
+ });
58
+ const descriptor = {
59
+ id: task.id,
60
+ name: task.id,
61
+ module: 'tasks',
62
+ version: 'prototype',
63
+ options: {},
64
+ worker: target.url?.toString() ?? true,
65
+ loadWorker: target.create,
66
+ workerInBatches: target.capabilities.streaming
67
+ };
68
+ try {
69
+ await preloadWorker(descriptor, { workerPool: pool, workerType: 'module', signal: options.signal }, { count: 1 });
70
+ }
71
+ finally {
72
+ await pool.destroy();
73
+ }
74
+ }
75
+ }
76
+ function withSignal(operation, signal) {
77
+ if (!signal)
78
+ return operation;
79
+ return new Promise((resolve, reject) => {
80
+ const abort = () => {
81
+ signal.removeEventListener('abort', abort);
82
+ reject(signal.reason);
83
+ };
84
+ signal.addEventListener('abort', abort, { once: true });
85
+ if (signal.aborted)
86
+ abort();
87
+ operation.then(value => {
88
+ signal.removeEventListener('abort', abort);
89
+ resolve(value);
90
+ }, error => {
91
+ signal.removeEventListener('abort', abort);
92
+ reject(error);
93
+ });
94
+ });
95
+ }
96
+ //# sourceMappingURL=task-preload.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-preload.js","sourceRoot":"","sources":["../../src/tasks/task-preload.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,74 @@
1
+ import type { AnyTask, TaskInput, TaskOutput, TaskBatchInput, TaskBatchOutput, Initialization, TaskRunControls, TaskInitializeControls, TaskRunOptions, TaskBatchRunOptions, TaskRunsOptions, InitializedTaskOptions, InitializedTaskCallOptions, InitializedTaskBatchOptions, RequestArgs, TaskRunnerOptions, SynchronousTask, TaskSyncRunOptions } from "./task.js";
2
+ /** A state instance bound to one execution location, serialized unless explicitly opted in. */
3
+ export declare class InitializedTask<D extends AnyTask> {
4
+ private task;
5
+ private release;
6
+ private readonly initializationControls;
7
+ private runtime;
8
+ private pool?;
9
+ private workerChannel?;
10
+ private channelInputs?;
11
+ private nextProgressId;
12
+ private progressCallbacks;
13
+ private streamProgress?;
14
+ private streamProgressId?;
15
+ private callbackFailures;
16
+ private descriptor?;
17
+ private readonly operationQueue;
18
+ private closing?;
19
+ private closed;
20
+ private finalized;
21
+ private streams;
22
+ private invalid;
23
+ private readonly concurrent;
24
+ private controller;
25
+ /** @internal Use TaskRunner.initializeTask. */
26
+ constructor(task: D, release: () => void, initializationControls: TaskInitializeControls);
27
+ /** @internal */
28
+ initialize(input: object, controls: TaskRunControls): Promise<void>;
29
+ runTask(input: TaskInput<D>, ...args: RequestArgs<InitializedTaskCallOptions<D>>): Promise<TaskOutput<D>>;
30
+ /** Independent calls sharing this instance, always serial and in input order. */
31
+ runTasks(inputs: Iterable<TaskInput<D>> | AsyncIterable<TaskInput<D>>, ...args: RequestArgs<InitializedTaskOptions<D>>): AsyncIterable<TaskOutput<D>>;
32
+ /** One processor invocation for the entire input iterable. */
33
+ runTaskInBatches(inputs: Iterable<TaskBatchInput<D>> | AsyncIterable<TaskBatchInput<D>>, ...args: RequestArgs<InitializedTaskBatchOptions<D>>): AsyncIterable<TaskBatchOutput<D>>;
34
+ /** Lifecycle status of this initialized task. */
35
+ get state(): 'ready' | 'closing' | 'closed' | 'invalid';
36
+ /** Drain accepted work, invoke destroy, and release execution capacity. */
37
+ close(): Promise<void>;
38
+ /** Abort work. Local JavaScript must settle before its state can be destroyed. */
39
+ terminate(reason?: unknown): Promise<void>;
40
+ private checkCapability;
41
+ private controls;
42
+ private workerOptions;
43
+ private invoke;
44
+ private runtimeContext;
45
+ private enqueue;
46
+ private serialStream;
47
+ private acquireStream;
48
+ }
49
+ /**
50
+ * Owns execution capacity and task lifetimes. No shared singleton or task registry.
51
+ * This experimental prototype deliberately exposes only implemented controls.
52
+ */
53
+ export declare class TaskRunner {
54
+ private maxConcurrency;
55
+ private active;
56
+ private count;
57
+ private waiters;
58
+ private closed;
59
+ private closing?;
60
+ private initializing;
61
+ private iterations;
62
+ constructor(options?: TaskRunnerOptions);
63
+ /** Execute synchronous hooks immediately on the calling thread, without queueing. */
64
+ runTaskSync<D extends AnyTask>(task: D & SynchronousTask<D>, input: TaskInput<D>, ...args: RequestArgs<TaskSyncRunOptions<D>>): TaskOutput<D>;
65
+ initializeTask<D extends AnyTask>(task: D, initialization: Initialization<D>, controls?: TaskInitializeControls): Promise<InitializedTask<D>>;
66
+ runTask<D extends AnyTask>(task: D, input: TaskInput<D>, ...args: RequestArgs<TaskRunOptions<D>>): Promise<TaskOutput<D>>;
67
+ runTasks<D extends AnyTask>(task: D, inputs: Iterable<TaskInput<D>> | AsyncIterable<TaskInput<D>>, ...args: RequestArgs<TaskRunsOptions<D>>): AsyncIterable<TaskOutput<D>>;
68
+ runTaskInBatches<D extends AnyTask>(task: D, inputs: Iterable<TaskBatchInput<D>> | AsyncIterable<TaskBatchInput<D>>, ...args: RequestArgs<TaskBatchRunOptions<D>>): AsyncIterable<TaskBatchOutput<D>>;
69
+ /** Close owned handles and workers. Finish or return active iterators first. */
70
+ close(): Promise<void>;
71
+ terminate(reason?: unknown): Promise<void>;
72
+ private open;
73
+ }
74
+ //# sourceMappingURL=task-runner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"task-runner.d.ts","sourceRoot":"","sources":["../../src/tasks/task-runner.ts"],"names":[],"mappings":"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"}