@workflow/core 5.0.0-beta.42 → 5.0.0-beta.44

package/dist/runtime/quickjs-serde.d.ts

@@ -6,8 +6,8 @@
  * host code operating on `JSValueHandle`s, using devalue 5.9's pluggable
  * operations (quickjs-wasi's host-side introspection primitives underneath).
  * The serde bundle previously evaluated inside the VM is gone: guest values
- * are read and built through handles, so no serializer code lives in — or
- * can be tampered with from — the guest realm.
+ * are read and built through handles, so no serializer code lives in (or
+ * can be tampered with from) the guest realm.
  *
  * Side-effect discipline mirrors the node:vm engine's hardened codec
  * (serialization/hardened.ts):
@@ -17,7 +17,7 @@
  *   `Symbol.toStringTag`;
  * - extraction goes through intrinsics captured at boot (before any user
  *   code runs) invoked with explicit receivers, or through own-property
- *   descriptor reads — patched prototypes and inherited accessors never
+ *   descriptor reads, so patched prototypes and inherited accessors never
  *   run;
  * - the only guest code serialization can execute is the same code the
  *   previous in-VM codec executed by contract: a class's static
@@ -30,7 +30,7 @@
  * versa).
  *
  * Hybrid value space: reducers return host shapes (plain objects, strings,
- * numbers) whose leaves may be guest handles — exactly how the node:vm
+ * numbers) whose leaves may be guest handles, exactly how the node:vm
  * codec mixes host shapes with sandbox-realm leaves. Every stringify
  * operation therefore dispatches on `JSValueHandle` and falls back to
  * devalue's default host operations for host values. Parse operations
@@ -42,7 +42,7 @@ import { JSValueHandle, type QuickJS } from 'quickjs-wasi';
  * bootstrap and BEFORE any user code. The returned handle owns the
  * container; on the baseline-snapshot path its raw box pointer
  * (`handle.ptr`) is recorded next to the snapshot and re-adopted per
- * restored VM via {@link adoptSerdeRoot} — do NOT dispose the handle
+ * restored VM via {@link adoptSerdeRoot}. Do NOT dispose the handle
  * before the snapshot is taken (the box must stay live in the memory
  * image).
  */
@@ -51,14 +51,14 @@ export declare function captureSerdeRoot(vm: QuickJS): JSValueHandle;
  * Re-create the capture-root handle in a VM restored from a snapshot
  * taken while the exported root was alive, via quickjs-wasi's
  * snapshot-portable handle tokens (`importHandle` duplicates the
- * underlying value — the returned handle is independently owned and the
+ * underlying value: the returned handle is independently owned and the
  * serde disposes it per restored VM). No guest code executes.
  */
 export declare function adoptSerdeRoot(vm: QuickJS, token: number): JSValueHandle;
 /**
  * Export the capture root as a snapshot-portable token to record next to
  * the baseline snapshot. The root handle must stay undisposed until the
- * snapshot is taken (its box — and the reference it holds — must be part
+ * snapshot is taken (its box, and the reference it holds, must be part
  * of the memory image).
  */
 export declare function exportSerdeRoot(vm: QuickJS, root: JSValueHandle): number;
@@ -70,7 +70,7 @@ export interface QuickJSSerde {
     /**
      * The reducer names this codec applies, in registration order. Exposed
      * so tests can assert exhaustiveness against the shared value-space
-     * codec (codec-devalue-vm) — a reducer added there but not here would
+     * codec (codec-devalue-vm): a reducer added there but not here would
      * otherwise silently round-trip values as plain objects.
      */
     reducerKeys: readonly string[];
@@ -78,7 +78,7 @@ export interface QuickJSSerde {
     reviverKeys: readonly string[];
     /**
      * Install `globalThis.process = { env: Object.freeze({...}) }` in the
-     * VM through handles and boot-captured intrinsics only — no guest
+     * VM through handles and boot-captured intrinsics only: no guest
      * source is evaluated, so a module-scope wrapper around JSON.parse /
      * Object.freeze cannot observe the injection. This matters on the
      * baseline-snapshot path, where env injection happens after user code
@@ -98,7 +98,7 @@ export declare function createQuickJSSerde(vm: QuickJS,
  * Pre-captured serde root (baseline-snapshot path): the container
  * `captureSerdeRoot` created BEFORE user code, re-adopted from the
  * restored memory image via `adoptSerdeRoot`. When omitted, the root
- * is captured now — callers must guarantee no user code has run yet.
+ * is captured now; callers must guarantee no user code has run yet.
  * Either way, initialization below performs only plain-data property
  * reads and C-level classId reads on the container: NO guest code
  * executes here, so nothing user-patchable can observe or perturb it.