Add start/end comments for multi-line annotation ranges

[pomber]

Fix #530

Summary

• add !name(start) / !name(end) comment markers for multi-line annotation ranges
• keep nested ranges of the same annotation name paired correctly
• ignore adjacent empty ranges and cover the behavior with regression tests

Usage

Before, multi-line ranges had to use the existing explicit range syntax:

// !focus(2:3)
const a = 1
const b = 2
const c = 3

This PR adds comment markers as an alternative:

const a = 1
// !focus(start)
const b = 2
const c = 3
// !focus(end)
const d = 4

That produces the same multi-line focus annotation over const b = 2 and const c = 3.

Testing

• pnpm --dir packages/codehike build
• pnpm --dir packages/codehike exec vitest run src/code/extract-annotations.test.ts

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
codehike.org	Ready	Preview, Comment	Mar 17, 2026 8:28am

[github-actions]

Try codehike from this pull request in your project with:

npm i https://pkg.pr.new/codehike@532