Struct HookRegistry 

pub struct HookRegistry { /* private fields */ }

Central registry for all hooks.

Hooks are indexed by HookPoint for O(1) lookup. Within each point, hooks are sorted by priority (ascending).

Concurrency

Use Arc<std::sync::RwLock<HookRegistry>> for concurrent access:

• dispatch() takes &self (read lock)
• register() / unregister() take &mut self (write lock)

Implementations

impl HookRegistry

pub fn new() -> Self

Creates an empty registry.

pub fn register(&mut self, hook: Box<dyn Hook>) -> String

Registers a hook. Returns the hook’s ID.

The hook is inserted in priority order (ascending).

pub fn register_owned( &mut self, hook: Box<dyn Hook>, owner: ComponentId, ) -> String

Registers a hook owned by a component.

Owned hooks are automatically unregistered when unregister_by_owner() is called (e.g., on component shutdown).

pub fn unregister(&mut self, id: &str) -> bool

Unregisters a hook by ID. Returns true if found and removed.

pub fn unregister_by_owner(&mut self, owner: &ComponentId) -> usize

Unregisters all hooks owned by the given component.

Returns the number of hooks removed.

pub fn set_enabled(&mut self, id: &str, enabled: bool)

Enables or disables a hook by ID.

pub fn len(&self) -> usize

Returns the number of registered hooks.

pub fn is_empty(&self) -> bool

Returns true if no hooks are registered.

pub fn dispatch( &self, point: HookPoint, component_id: &ComponentId, child_id: Option<&str>, ctx: HookContext, ) -> HookAction

Dispatches hooks for the given point and target.

Hooks are executed in priority order (ascending). Chain semantics:

• Pre-hook: Skip or Abort → stop chain immediately
• Post-hook: Replace → update payload, continue chain
• Disabled hooks and FQL non-matches are skipped
• Depth exceeded → break with warning

Trait Implementations

impl Default for HookRegistry

fn default() -> Self

Returns the “default value” for a type.