Public: anyone can read this; the crew can change it.

Code colouring's token classes are named in docs/design/areas/highlight.md, and the .tok-* lines leave §5d #5514

Merged opened this

Check · Review · Land · Live done — Landed and live in production.

Merged

The highlighter's token colours now have their own area file, `docs/design/areas/highlight.md`, and the 19 `.tok-*` classes the issue lists are no longer in `docs/DESIGN.md` §5d.

shipped production is serving it deploy 4915f35

opened this

The highlighter's token colours now have their own area file, docs/design/areas/highlight.md, and the 19 .tok-* classes the issue lists are no longer in docs/DESIGN.md §5d.

  • docs/design/areas/highlight.md (new): it follows docs/design/areas/README.md. It says what the component is for (§6b) and that tokenClasses in src/web/highlight-html.ts writes it as tok-${kind}, coloured by the --tok-* tokens in src/design/themes.ts. Each class sits in a code span with one line on what it marks.
  • docs/DESIGN.md: only those 19 list lines are deleted, all from the "style/content.ts, code view" entry in §5d.

.tok-deleted and .tok-inserted stay in §5d, next to .blob-view and .ln, because the issue doesn't list them. Moving them to the new file would be a small follow-up. No markup or stylesheet rule changed.

bun scripts/design-lint.ts passes: it reads the new file as vocabulary and finds no class left undocumented. bun test passes for test/design-lint.test.ts, test/review-design.test.ts and test/tui-code.test.ts (30 tests).

🤖 Generated with Claude Code

Closes #5502

commented

The highlighter's token colours now have their own area file, docs/design/areas/highlight.md, and the 19 .tok-* classes the issue lists are no longer in docs/DESIGN.md §5d.

  • docs/design/areas/highlight.md (new): it follows docs/design/areas/README.md. It says what the component is for (§6b) and that tokenClasses in src/web/highlight-html.ts writes it as tok-${kind}, coloured by the --tok-* tokens in src/design/themes.ts. Each class sits in a code span with one line on what it marks.
  • docs/DESIGN.md: only those 19 list lines are deleted, all from the "style/content.ts, code view" entry in §5d.

.tok-deleted and .tok-inserted stay in §5d, next to .blob-view and .ln, because the issue doesn't list them. Moving them to the new file would be a small follow-up. No markup or stylesheet rule changed.

bun scripts/design-lint.ts passes: it reads the new file as vocabulary and finds no class left undocumented. bun test passes for test/design-lint.test.ts, test/review-design.test.ts and test/tui-code.test.ts (30 tests).

🤖 Generated with Claude Code

Approved

Matches #5502: highlight.md names the component, tokenClasses in src/web/highlight-html.ts and the --tok-* tokens in themes.ts, and lists all 19 classes in code spans. Only those 19 lines leave §5d. .tok-deleted and .tok-inserted correctly stay. design-lint passes here, and no markup or CSS changed. Next: (1) move .tok-deleted/.tok-inserted into highlight.md as the follow-up; (2) drop the stale "syntax-highlight token classes" wording from the §5d code-view entry once those two leave.

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs