Struct QuickJsRuntime 

pub struct QuickJsRuntime { /* private fields */ }

QuickJS-backed runtime adapter. One instance is reusable across many documents; callers MUST invoke XfaJsRuntime::reset_for_new_document at the start of each flatten.

Implementations

impl QuickJsRuntime

pub fn new() -> Result<Self, SandboxError>

Construct a new sandboxed runtime with default budgets.

pub fn with_time_budget(self, budget: Duration) -> Self

Override the per-script wall-clock budget. Must be called before any execute_script invocation; takes effect on the next call.

pub fn with_memory_budget(self, bytes: usize) -> Self

Override the per-document memory budget. Must be called before any execute_script invocation; takes effect on the next document.

Trait Implementations

impl Debug for QuickJsRuntime

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl XfaJsRuntime for QuickJsRuntime

fn init(&mut self) -> Result<(), SandboxError>

One-time initialisation. Idempotent.

fn reset_for_new_document(&mut self) -> Result<(), SandboxError>

Reset per-document state (memory budget, instruction counter, any cached compiled scripts). Called once per flatten.

fn set_form_handle( &mut self, form: *mut FormTree, root_id: FormNodeId, ) -> Result<(), SandboxError>

Phase C: install the FormTree the runtime should resolve paths against and mutate. The dispatch path owns the mutable borrow and clears the handle before returning.

fn set_data_handle(&mut self, dom: *const DataDom)

Phase D-γ: install a read-only view of the DataDom for the current document. Called once per document after set_form_handle, before any scripts run. Default: no-op (backends without DataDom support ignore it).

fn reset_per_script( &mut self, current_id: FormNodeId, activity: Option<&str>, ) -> Result<(), SandboxError>

Phase C: reset per-script host counters and install the current script context node / activity. Backends without host bindings ignore it.

fn set_static_page_count(&mut self, page_count: u32) -> Result<(), SandboxError>

Phase C page-count foundation. The current flatten order runs scripts before layout, so callers normally leave this at 0.

fn execute_script( &mut self, activity: Option<&str>, body: &str, ) -> Result<RuntimeOutcome, SandboxError>

Execute one script body inside the sandbox.

fn take_metadata(&mut self) -> RuntimeMetadata

Take the cumulative metadata since the last take_metadata call (or since reset_for_new_document, whichever was later).