Files
hemx/work/slices/SLICE-0010-highlight-boundary.md
T
slhx agent 34327d6b8f docs(editor): define hemplate highlight boundary
Document the repo-owned .heml highlighting overlay tokens and exclude diagnostics/completion/formatting/build validation from highlighting authority.

req: diagnostics/004

req: diagnostics/008
2026-06-26 00:16:47 +02:00

1.7 KiB

id, type, status, parent, title, refs
id type status parent title refs
SLICE-0010 slice done NS-0003 Define repo-owned hemplate highlighting boundary
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.