Struct LexBuiltinsHandler 

pub struct LexBuiltinsHandler { /* private fields */ }

Composite handler for the lex.* built-in namespace.

Registry::register_namespace accepts one handler per namespace; the composite shape lets every lex.* built-in live under a single namespace registration while keeping per-label logic isolated. The doc.* family is registered separately with DocBuiltinsHandler — see register_into.

Implementations across hooks (one per lifecycle phase):

• on_resolve: only LexIncludeHandler (#532). lex.tabular.* and lex.media.* migrated off on_resolve in #615 — verbatim hydration belongs on the IR-construction lifecycle, not the AST-substitution lifecycle.
• on_ir_build: lex.tabular.table (verbatim body → typed WireNode::Table) and lex.media.{image,video,audio} (params → typed WireNode::Image|Video|Audio). #615 unified surface.
• on_format: lex.tabular.table and lex.media.{image,video,audio} round-trip back to :: lex.<family>.<kind> :: Lex source. (#570 Phase 4b.)

Implementations

impl LexBuiltinsHandler

pub fn new(loader: Arc<dyn Loader + Send + Sync>, config: ResolveConfig) -> Self

Trait Implementations

impl LexHandler for LexBuiltinsHandler

fn on_format( &self, ctx: &FormatCtx, ) -> Result<Option<LexAnnotationOut>, HandlerError>

Phase 4b of #570: emit the canonical Lex-source shape for the built-in lex.tabular.* and lex.media.* labels.

The verbatim labels round-trip as :: lex.<family>.<kind> :: closers with the body text and parameters carried verbatim from the supplied WireNode::Verbatim. Anything else (e.g. lex.include, metadata labels, unrecognised labels) returns Ok(None) so the host falls back to its built-in formatter.

fn on_resolve(&self, ctx: &LabelCtx) -> Result<Option<WireNode>, HandlerError>

Returns an AST replacement subtree, which the host splices into the parent in place of the labelled node. Fires during the resolve phase, before analyse. Ok(None) leaves the original node in place.

fn on_ir_build(&self, ctx: &LabelCtx) -> Result<Option<WireNode>, HandlerError>

Returns a typed wire node consumed by the host while building its in-memory IR from the parsed source. Fires during IR construction (from_lex), strictly after parsing and strictly before render. Ok(None) falls back to the host’s generic verbatim/annotation IR.

fn on_label(&self, _ctx: &LabelCtx)

Informational notification fired during the analyse phase. No response is expected. Use this for handlers that maintain external state (caches, indices, link graphs).

fn on_validate(&self, _ctx: &LabelCtx) -> Result<Vec<Diagnostic>, HandlerError>

Returns diagnostics for a labelled node. Fires during analyse, after resolve.

fn on_render( &self, _ctx: &LabelCtx, _fmt: Format, ) -> Result<Option<RenderOut>, HandlerError>

Returns the labelled node’s representation in a target format. Fires during lexd convert or library-driven rendering. Ok(None) falls back to default rendering of the underlying node.

fn on_hover(&self, _ctx: &LabelCtx) -> Result<Option<Hover>, HandlerError>

Returns hover content for a labelled node. Fires in response to textDocument/hover LSP requests.

fn on_completion( &self, _ctx: &LabelCtx, ) -> Result<Vec<Completion>, HandlerError>

Returns completion items for a position inside a labelled node’s params or body. Fires in response to textDocument/completion.

fn on_code_action( &self, _ctx: &LabelCtx, ) -> Result<Vec<CodeAction>, HandlerError>

Returns code actions for a labelled node. Fires in response to textDocument/codeAction.