Class Folio

ReadonlythreadIds

capabilities

• get capabilities(): Readonly<
      {
          automaticRegions: "none"
          | "control-flow"
          | "counted-loops";
          dependence: "serial" | "ordered-validation";
          physicalSharing: "none" | "same-process";
      },
  >

  Active sharing, extraction and validation mode; a one-worker pool reports none and serial.

  Returns Readonly<
      {
          automaticRegions: "none"
          | "control-flow"
          | "counted-loops";
          dependence: "serial" | "ordered-validation";
          physicalSharing: "none" | "same-process";
      },
  >

diagnostics

• get diagnostics(): readonly string[]

  Module-wide reasons the optimizer refused or fell back. A refusal is not a proved dependency.

  Returns readonly string[]

exports

• get exports(): WebAssembly.Exports

  The original native exports, for trusted host integration. Raw calls bypass tracking.

  Returns WebAssembly.Exports

memories

• get memories(): Readonly<Record<string, WebAssembly.Memory>>

  Named imported and exported memory wrappers.

  Returns Readonly<Record<string, WebAssembly.Memory>>

memory

• get memory(): Memory

  The unique accessible arena, including a coordinator-exposed hidden memory. Throws otherwise.

  Returns Memory

[asyncDispose]

• "[asyncDispose]"(): Promise<void>

  await using support; equivalent to close().

  Returns Promise<void>

close

• close(): Promise<void>

  Joins worker termination and outstanding JSPI calls. Repeated calls share one join.

  Returns Promise<void>

inspect

• inspect(
      entry: string,
  ): Readonly<
      {
          automatic: boolean;
          diagnostics: readonly string[];
          mechanism: "counted-loop"
          | "control-flow"
          | "native";
          nativeGuard: boolean;
      },
  >

  Whether entry has an automatic plan or a native guard, by which mechanism, and why not.

  Parameters

  • entry: string

  Returns Readonly<
      {
          automatic: boolean;
          diagnostics: readonly string[];
          mechanism: "counted-loop"
          | "control-flow"
          | "native";
          nativeGuard: boolean;
      },
  >

run

• run(
      entry: string,
      args?: readonly unknown[],
      options?: RunOptions,
  ): Promise<ExecutionReport>

  Splits compiler-recognized loops automatically; otherwise runs the original entry.

  Parameters

  • entry: string
  • args: readonly unknown[] = []
  • options: RunOptions = {}

  Returns Promise<ExecutionReport>

runAll

• runAll(calls: readonly Call[], options?: RunOptions): Promise<ExecutionReport>

  Preserves call order while discovering memory dependencies at runtime.

  Parameters

  • calls: readonly Call[]
  • options: RunOptions = {}

  Returns Promise<ExecutionReport>

Staticopen

• open(input: ProgramInput, options?: FolioOptions): Promise<Folio>

  Instantiates the program, starts the worker group and returns a ready pool.

  Parameters

  • input: ProgramInput
  • options: FolioOptions = {}

  Returns Promise<Folio>