knitting 0.1.63 → 0.1.73

package/src/memory/payloadCodec.d.ts

@@ -1,12 +1,18 @@
 import { type PromisePayloadHandler, type Task } from "./lock.js";
 import type { LockBufferTextCompat } from "../common/shared-buffer-text.js";
 import { type PayloadBufferOptions } from "./payload-config.js";
-import type { SharedBufferSource } from "../common/shared-buffer-region.js";
+import { type SharedBufferSource } from "../common/shared-buffer-region.js";
+/** Minimum size for automatically borrowed byte returns. */
+export declare const SHARED_RETURN_MIN_BYTES: number;
+/** Number of later borrowed returns kept before a region is recycled. */
+export declare const SHARED_RETURN_BORROW_WINDOW = 32;
+/** The borrowed-region allocator for `payload`, if an encoder built one. */
+export declare const getSharedReturnAllocator: (payload: object) => ((byteLength: number, zeroFill?: boolean) => Uint8Array | undefined) | undefined;
 /**
  * Returns `true` when the payload is encoded successfully.
  * Returns `false` when dynamic payload space could not be reserved.
  */
-export declare const encodePayload: ({ lockSector, payload, sab, payloadConfig, headersBuffer, headerSlotStrideU32, textCompat, onPromise, processBoundary, }: {
+export declare const encodePayload: ({ lockSector, payload, sab, payloadConfig, headersBuffer, headerSlotStrideU32, textCompat, onPromise, processBoundary, sharedReturn, moveReturn, }: {
     lockSector?: SharedBufferSource;
     payload?: {
         sab?: SharedBufferSource;
@@ -29,6 +35,16 @@ export declare const encodePayload: ({ lockSector, payload, sab, payloadConfig,
      * Process transports must set this on both encoders and decoders.
      */
     processBoundary?: boolean;
+    /**
+     * Enable explicit `sharedBytes()` allocations on a worker return lane.
+     * Ordinary byte returns never become borrowed implicitly.
+     */
+    sharedReturn?: boolean;
+    /**
+     * Move large top-level byte returns into an owned host ArrayBuffer. Unlike a
+     * borrowed return, the result stays valid until the host drops it.
+     */
+    moveReturn?: boolean;
 }) => (task: Task, slotIndex: number) => boolean;
 export declare const decodePayload: ({ lockSector, payload, sab, payloadConfig, headersBuffer, headerSlotStrideU32, textCompat, host, processBoundary, }: {
     lockSector?: SharedBufferSource;