slhx agent
34327d6b8f
Document the repo-owned .heml highlighting overlay tokens and exclude diagnostics/completion/formatting/build validation from highlighting authority. req: diagnostics/004 req: diagnostics/008
40 lines
1.7 KiB
Markdown
40 lines
1.7 KiB
Markdown
---
|
|
id: SLICE-0010
|
|
type: slice
|
|
status: done
|
|
parent: NS-0003
|
|
title: Define repo-owned hemplate highlighting boundary
|
|
refs:
|
|
- docs/editor-support.md
|
|
- docs/hemplate-syntax.md
|
|
- REQUIREMENTS.md
|
|
---
|
|
|
|
## Objective
|
|
|
|
Turn "tree-sitter highlighting for hemplate" into a bounded repo-owned contract: HTML stays the base grammar, hemplate overlay tokens are documented, and validation remains with `hemx-build`/`hemx-lsp`.
|
|
|
|
## Authority
|
|
|
|
`docs/editor-support.md` says normal HTML/tree-sitter tooling remains in use; `docs/hemplate-syntax.md` names the small overlay; `REQUIREMENTS.md` forbids a second template language or custom editor framework.
|
|
|
|
## Close when
|
|
|
|
- A highlighting boundary doc or work artifact lists the token classes the repo owns: escaped/trusted text delimiters, dynamic attribute prefix, `h-*` directives, and `data-hemx-*` facts.
|
|
- It explicitly excludes diagnostics, completion, hover, formatting, Rust expression parsing, and build validation from highlighting authority.
|
|
- It names what can be tested in-repo without editor package publishing.
|
|
|
|
## Verification
|
|
|
|
- `workledger check` for the slice contract now.
|
|
- Later implementation: a repo-owned fixture/query test command, or a manual editor smoke if no automated query runner exists yet.
|
|
|
|
## Non-goals
|
|
|
|
- Do not introduce a new parser for `hemx-build`.
|
|
- Do not publish or install editor packages.
|
|
|
|
## Evidence
|
|
|
|
Done at commit `5d38d0c` follow-up and verified with `workledger check`: `docs/editor-support.md` now lists repo-owned overlay token classes, explicitly excludes diagnostics/completion/hover/formatting/Rust parsing/build validation from highlighting authority, and names fixture/query tests as the repo-owned proof boundary before provider packaging.
|