hemx/work/slices/SLICE-0007-lsp-hover-surface.md

id, type, status, parent, title, refs

id	type	status	parent	title	refs
SLICE-0007	slice	done	NS-0002	Complete hover help for documented hemplate facts	REQUIREMENTS.md docs/editor-support.md docs/hemplate-syntax.md hemx-lsp/src/main.rs

Objective

Make hover explain the real .heml facts that contributors see in templates without turning hover into a tutorial or alternative spec.

Authority

docs/hemplate-syntax.md defines the facts; REQUIREMENTS.md diagnostics/007 and diagnostics/008 constrain hover and editor behavior.

Close when

• Hover covers escaped/trusted text, dynamic attributes, control-flow directives, generated targets, forms, handles, roots, and keyed slots.
• Hover content is short and points back to the documented syntax authority.
• Hover tests assert range-sensitive behavior and no hover for unrelated HTML text where normal editor tooling owns the answer.

Verification

• cargo test -p hemx-lsp

Non-goals

• Do not duplicate docs/hemplate-syntax.md wholesale in source strings.
• Do not include provider-specific Markdown rendering assumptions.

Evidence

Done at commit 258524f and verified again at 38794cf with cargo test -p hemx-lsp: hover is token-position aware and tests cover documented hemplate facts while ordinary HTML remains left to normal editor tooling.