Struct FastV3HydrationPlugin 

pub struct FastV3HydrationPlugin { /* private fields */ }

FAST 3 hydration handler plugin.

Emits HTML comment markers around dynamic bindings so that FAST can re-hydrate server-rendered content on the client side.

The root scope is disabled (no markers) — hydration only activates in child scopes (components, for-loop items, if-condition bodies). This matches the C++ and JS prototype behavior.

Implementations

impl FastV3HydrationPlugin

pub fn new() -> Self

Create a new FAST 3 hydration plugin. The initial root scope is disabled — markers only emitted in child scopes.

Trait Implementations

impl Default for FastV3HydrationPlugin

fn default() -> Self

Returns the “default value” for a type.

impl HandlerPlugin for FastV3HydrationPlugin

fn write_route_component_state( &self, state: &Value, writer: &mut dyn ResponseWriter, ) -> Result<()>

FAST emits scalar attributes on route component elements. Components read these via @attr and their connection lifecycle.

fn push_scope(&mut self)

Enter a new scope (component or for-loop item boundary). Typically resets per-scope counters.

fn pop_scope(&mut self)

Exit the current scope, restoring the parent scope state.

fn on_binding_start( &mut self, _name: &str, _raw: bool, writer: &mut dyn ResponseWriter, ) -> Result<()>

Called before rendering a signal binding.

fn on_binding_end( &mut self, _name: &str, _raw: bool, writer: &mut dyn ResponseWriter, ) -> Result<()>

Called after rendering a signal binding.

fn on_repeat_item_start( &mut self, _index: usize, writer: &mut dyn ResponseWriter, ) -> Result<()>

Called before rendering a repeat item in a for loop.

fn on_repeat_item_end( &mut self, _index: usize, writer: &mut dyn ResponseWriter, ) -> Result<()>

Called after rendering a repeat item.

fn on_element_data( &mut self, data: &[u8], writer: &mut dyn ResponseWriter, ) -> Result<()>

Called when parser-produced element metadata is encountered.

fn on_for_start( &mut self, name: &str, writer: &mut dyn ResponseWriter, ) -> Result<()>

Called before rendering a for-loop block. Defaults to on_binding_start.

fn on_for_end( &mut self, name: &str, writer: &mut dyn ResponseWriter, ) -> Result<()>

Called after rendering a for-loop block. Defaults to on_binding_end.

fn on_if_start( &mut self, name: &str, writer: &mut dyn ResponseWriter, ) -> Result<()>

Called before rendering an if-condition block. Defaults to on_binding_start.

fn on_if_end( &mut self, name: &str, writer: &mut dyn ResponseWriter, ) -> Result<()>

Called after rendering an if-condition block. Defaults to on_binding_end.

fn emit_templates( &self, protocol: &WebUIProtocol, components: &[String], _nonce: Option<&str>, writer: &mut dyn ResponseWriter, ) -> Result<()>

Emit component templates collected during SSR. The default emits each template as-is (suitable for FAST <f-template> tags). The WebUI split-payload path uses HandlerPlugin::collect_template_payloads instead.

fn collect_template_payloads<'a>( &self, _protocol: &'a WebUIProtocol, _components: &[String], ) -> Option<Vec<WebUiTemplatePayload<'a>>>

Return split WebUI template payloads for the given components.

fn emit_templates_slice( &self, protocol: &WebUIProtocol, tags: &[&str], _nonce: Option<&str>, writer: &mut dyn ResponseWriter, ) -> Result<()>

Slice-based counterpart to HandlerPlugin::emit_templates.

fn collect_template_payloads_slice<'a>( &self, _protocol: &'a WebUIProtocol, _tags: &[&str], ) -> Option<Vec<WebUiTemplatePayload<'a>>>

Slice-based counterpart to HandlerPlugin::collect_template_payloads.

fn emit_bootstrap_extension_payloads( &self, _payloads: &[WebUiTemplatePayload<'_>], _nonce: Option<&str>, _writer: &mut dyn ResponseWriter, ) -> Result<()>

Emit plugin-specific executable SSR bootstrap code for the streaming path, given only the already-collected template payloads.

fn emit_bootstrap_extension( &self, _context: BootstrapExtensionContext<'_>, _writer: &mut dyn ResponseWriter, ) -> Result<()>

Emit plugin-specific executable SSR bootstrap code, if needed.