starwing / musubi / 20212874813

100%

push

github

feat: release v0.5.0 with primary labels and cross-file ordering

Major features:
1. Primary label mechanism
   - Added mu_primary() API to mark labels as primary
   - Primary label determines header location in diagnostics
   - Automatic fallback to earliest label if no primary set
   - Lua: report:primary(), C: mu_primary(R)

2. Simplified report() constructors (Lua)
   - mu.report() - no arguments
   - mu.report(message) - error with message
   - mu.report(level, message) - custom level
   - Removed mu_location() API (breaking change)

3. Cross-file label ordering
   - Labels now ordered by: order → src_id → pointer
   - Simplified muG_make_groups: sort once, process sequentially
   - Better handling of multi-source diagnostics

4. Context lines support
   - Config option: context_lines (default: 0)
   - Shows N lines before/after labeled lines
   - Smart ellipsis handling for gaps
   - Lua: cfg:context_lines(n), C: config.context_lines = n

5. Charset extensions
   - Added line_margin elements: left, middle, right, single
   - Improved vbar/hbar crossing (draw vbar first)
   - Better visual continuity for margin labels

Implementation improvements:
- Replaced mu_Source.gidx with .inited flag (clearer semantics)
- Added mu_Source.line_count() function pointer
- New muG_calc_charpos() for unified byte/char conversion
- Optimized muG_init: leverages sorted label order
- Added muA_isempty() macro for better readability

Testing:
- 100+ test cases updated for new API
- Added 6 context_lines edge case tests
- All cross-file ordering tests passing
- Coverage maintained at 100%

Breaking changes:
- Removed mu_location() / report:location() API
- Use mu_primary() / report:primary() instead

Docs:
- README.md: Updated all examples for v0.5.0 API
- Added "Primary Label Mechanism" section
- Updated Lua/C API reference tables
- All code samples use new constructors

196 of 196 new or added lines in 2 files covered. (100.0%)

1419 of 1419 relevant lines covered (100.0%)

9614.23 hits per line