@spec build_scxml_context(map()) :: map()

Build SCXML evaluation context from interpreter state.

@spec build_scxml_functions(map()) :: %{
  required(String.t()) => {integer(), function()}
}

Build SCXML-specific functions for Predicator v2.0.

Returns a map of function names to {arity, function} tuples for use with the functions option in Predicator.evaluate/3.

@spec compile_condition(String.t() | nil) ::
  {:ok, term()} | {:error, term()} | {:ok, nil}

Compile a conditional expression string into predicator instructions.

Returns {:ok, compiled} on success, {:error, reason} on failure.

@spec evaluate_condition(term() | nil, map()) :: boolean()

Evaluate a compiled condition with SCXML context.

Context includes:

• Current state configuration
• Current event
• Data model variables

Returns boolean result. On error, returns false per SCXML spec.

@spec in_state?(String.t(), map()) :: boolean()

Check if the current configuration contains a specific state (In function). This is used for SCXML In() predicate support.