Struct RuntimeMetadata 

pub struct RuntimeMetadata {

    pub executed: usize,
    pub runtime_errors: usize,
    pub timeouts: usize,
    pub oom: usize,
    pub host_calls: usize,
    pub mutations: usize,
    pub instance_writes: usize,
    pub list_writes: usize,
    pub binding_errors: usize,
    pub resolve_failures: usize,
    pub data_reads: usize,
    pub unsupported_host_calls: usize,
    pub probe_skips: usize,
    pub variables_scripts_collected: usize,
    pub variables_data_items_collected: usize,
    pub script_objects_registered: usize,
    pub script_objects_register_failed: usize,
    pub script_objects_subform_scoped: usize,
    pub som_lookups_total: usize,
    pub som_lookup_successes: usize,
    pub som_lookup_failures: usize,
    pub som_lookup_ambiguous: usize,
    pub som_subform_scripts_exposed: usize,
    pub som_occur_path_refs: usize,
    pub occur_lookups_total: usize,
    pub occur_lookup_successes: usize,
    pub occur_lookup_failures: usize,
    pub occur_property_reads: usize,
    pub occur_property_writes: usize,
    pub occur_min_writes: usize,
    pub occur_max_writes: usize,
    pub occur_mutations_captured: usize,
    pub occur_mutations_applied: usize,
    pub occur_mutations_skipped: usize,
    pub occur_application_ambiguous: usize,
    pub occur_application_targets: usize,
    pub som_data_root_hits: usize,
    pub som_items_path_hits: usize,
}

Cumulative metadata for a single document’s flatten. The runtime adapter accumulates counters across calls; the dispatch site reads them via XfaJsRuntime::take_metadata when the document is done.

Fields

executed: usize

Scripts that ran to completion inside the sandbox.

runtime_errors: usize

Generic runtime / script errors (parse, throw, NoBindings, …).

timeouts: usize

Time-budget exhaustions.

oom: usize

Memory-budget exhaustions.

host_calls: usize

Phase C host-binding invocations.

mutations: usize

Phase C successful field.rawValue writes.

instance_writes: usize

Phase D successful instanceManager structure writes.

list_writes: usize

Phase D-β successful listbox clearItems / addItem writes.

binding_errors: usize

Phase C binding-level failures (type, activity, cap, parse).

resolve_failures: usize

Phase C SOM resolution misses / failures.

data_reads: usize

Phase D-γ successful DataDom reads (children / value / child-by-name).

unsupported_host_calls: usize

Phase E (XFA-JS-HOST-STUBS): Calls into host capabilities that require genuine viewer / user interaction (UI dialogs, signature panels, network submit). The sandbox cannot honestly satisfy these during a non-interactive flatten; instead of raising a TypeError (which would abort the script and inflate runtime_errors) the stubs return a safe default value and increment this counter so the dispatch site keeps observability of “would-have-been-interactive” touch points. Note: this counter is intentionally NOT folded into is_clean — a script that touched xfa.host.messageBox is still considered to have run cleanly because the sandbox did not error; embedders that care about UI gaps should inspect this field explicitly.

probe_skips: usize

Phase D-θ.2 probe calls skipped because parentIds.length == 1 && chain.length == 1 (no same-name ambiguity possible). Every skipped call saves one resolveWithFullChainStrict host round-trip.

variables_scripts_collected: usize

D3 (trace-only): <variables> <script> objects collected from the template for this document (root + subform scopes).

variables_data_items_collected: usize

D3 (trace-only): <variables> <text> data items collected.

script_objects_registered: usize

D3 (trace-only): script objects whose JS-side registration returned success (namespace bound into variablesScripts / subformVariables).

script_objects_register_failed: usize

D3 (trace-only): script objects that did NOT register — either a Rust skip (BodyTooLarge / RegexRejected / panic) or a JS-side eval failure (setVariablesScript returned false). Pure observability; never folded into is_clean or rollback.

script_objects_subform_scoped: usize

D3 (trace-only): script objects collected under a NESTED subform scope (registered into subformVariables only, hence not reachable as a bare identifier today — the “scope_hidden” gap class).

som_lookups_total: usize

D4: total SOM lookups observed at the host resolve boundary (successes + failures across the instrumented resolve_* entry points).

som_lookup_successes: usize

D4: SOM lookups that resolved to at least one node.

som_lookup_failures: usize

D4: SOM lookups that returned NoMatch.

som_lookup_ambiguous: usize

D4: subform-scoped script-object names NOT exposed because the same name is declared by ≥2 subforms (fail-closed ambiguity).

som_subform_scripts_exposed: usize

D4: subform-scoped script objects exposed to bare-identifier lookup (unique-name, sandboxed-only).

som_occur_path_refs: usize

D4 (trace-only): SOM NoMatch references whose path is an occur path (occur / occur.min / occur.max …). Classified, NOT resolved.

occur_lookups_total: usize

D5: node.occur handle accesses (successes + failures).

occur_lookup_successes: usize

D5: node.occur accesses where the node handle was live.

occur_lookup_failures: usize

D5: node.occur accesses where the node handle was not live.

occur_property_reads: usize

D5: reads of an occur property (min/max/initial).

occur_property_writes: usize

D5: writes to an occur property (captured, not applied).

occur_min_writes: usize

D5: writes specifically to occur.min.

occur_max_writes: usize

D5: writes specifically to occur.max.

occur_mutations_captured: usize

D5: occur mutations captured as intent (no layout effect).

occur_mutations_applied: usize

D5: occur mutations APPLIED to layout. Always 0 in D5 (capture-only); D6 bumps this when XFA_OCCUR_APPLY=1 applies a captured occur.min.

occur_mutations_skipped: usize

D6: captured occur mutations NOT applied (rollback, apply-flag off, dead/non-repeatable target, unsupported prop, negative value).

occur_application_ambiguous: usize

D6: captured occur mutations skipped because the target node is not a repeatable container (Subform/Area/ExclGroup) — fail-closed.

occur_application_targets: usize

D6: distinct form nodes whose occur was applied.

som_data_root_hits: usize

BE-1: $data bare-global intercepts resolved successfully (JS layer).

som_items_path_hits: usize

BE-1: #items property accesses resolved to a non-empty item list.

Implementations

impl RuntimeMetadata

pub fn is_clean(&self) -> bool

True when the runtime never reported any error class.

pub fn accumulate(&mut self, other: RuntimeMetadata)

Add another metadata snapshot into this one.

Trait Implementations

impl Clone for RuntimeMetadata

fn clone(&self) -> RuntimeMetadata

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for RuntimeMetadata

impl Debug for RuntimeMetadata

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

Formats the value using the given formatter.

impl Default for RuntimeMetadata

fn default() -> RuntimeMetadata

Returns the “default value” for a type.

impl Eq for RuntimeMetadata

impl PartialEq for RuntimeMetadata

fn eq(&self, other: &RuntimeMetadata) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RuntimeMetadata