---
id: SLICE-0007
type: slice
status: done
parent: NS-0002
title: Complete hover help for documented hemplate facts
refs:
  - 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.