slhx agent
40 lines
1.5 KiB
Markdown
40 lines
1.5 KiB
Markdown
---
|
|
id: SLICE-0010
|
|
type: slice
|
|
status: ready
|
|
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
|
|
|
|
The docs already establish `.heml` as HTML plus a small overlay; this slice makes that boundary executable before writing queries.
|