@parcel/rust 2.12.1-canary.3318 → 2.12.1-canary.3320

package/index.d.ts

@@ -16,7 +16,7 @@ export function hashString(s: string): string
 export function hashBuffer(buf: Buffer): string
 export function optimizeImage(kind: string, buf: Buffer): Buffer
 export interface ParcelNapiBuildOptions {
-  
+  registerWorker: (...args: any[]) => any
 }
 export interface ParcelNapiBuildResult {
   
@@ -29,7 +29,29 @@ export interface ParcelNapiOptions {
   threads?: number
   tracerOptions?: object
 }
-export function registerWorker(worker: object): void
+/**
+ * This function is run in the Nodejs worker context upon initialization
+ * to notify the main thread that a Nodejs worker thread has started
+ *
+ * A Rust channel is transferred to the worker via JavaScript `worker.postMessage`.
+ * The worker then calls `register_worker`, supplying it with an object containing
+ * callbacks.
+ *
+ * The callbacks are later called from the main thread to send work to the worker.
+ *
+ * |-------------| --- Init channel ----> |-------------------|
+ * | Main Thread |                        | Worker Thread (n) |
+ * |-------------| <-- Worker wrapper --- |-------------------|
+ *
+ *                 **Later During Build**
+ *
+ *                 -- Resolver.resolve -->
+ *                 <- DependencyResult ---
+ *
+ *                 -- Transf.transform -->
+ *                 <--- Array<Asset> -----
+ */
+export function registerWorker(channel: JsTransferable, worker: object): void
 export interface JsFileSystemOptions {
   canonicalize: (...args: any[]) => any
   read: (...args: any[]) => any

package/index.js.flow

@@ -9,6 +9,8 @@ import type {
 
 declare export var init: void | (() => void);
 
+export type Transferable = {||};
+
 export type ProjectPath = any;
 export interface ConfigRequest {
   id: string;
@@ -58,10 +60,14 @@ export type ParcelNapiOptions = {|
       |},
 |};
 
+export type ParcelBuildOptions = {|
+  registerWorker: (channel: Transferable) => void | Promise<void>,
+|};
+
 declare export class ParcelNapi {
   nodeWorkerCount: number;
   constructor(options: ParcelNapiOptions): ParcelNapi;
-  build(): Promise<void>;
+  build(options: ParcelBuildOptions): Promise<void>;
   static defaultThreadCount(): number;
   testingTempFsReadToString(path: string): string;
   testingTempFsIsDir(path: string): boolean;
@@ -69,7 +75,10 @@ declare export class ParcelNapi {
   testingRpcPing(): void;
 }
 
-declare export function registerWorker(worker: any): void;
+declare export function registerWorker(
+  channel: Transferable,
+  worker: any,
+): void;
 
 declare export function initSentry(): void;
 declare export function closeSentry(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parcel/rust",
-  "version": "2.12.1-canary.3318+7068dd69b",
+  "version": "2.12.1-canary.3320+8cc5c8f48",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -40,5 +40,5 @@
     "wasm:build": "cargo build -p parcel-node-bindings --target wasm32-unknown-unknown && cp ../../../target/wasm32-unknown-unknown/debug/parcel_node_bindings.wasm .",
     "wasm:build-release": "CARGO_PROFILE_RELEASE_LTO=true cargo build -p parcel-node-bindings --target wasm32-unknown-unknown --release && wasm-opt --strip-debug -O ../../../target/wasm32-unknown-unknown/release/parcel_node_bindings.wasm -o parcel_node_bindings.wasm"
   },
-  "gitHead": "7068dd69b916d001c2551ceadff778aa032dff14"
+  "gitHead": "8cc5c8f4826882f8f066b3efff751324c3b9986c"
 }