starwing / musubi / 20087509453

100%

push

github

feat(api): implement Cache/Source architecture for multi-source diagnostics

Breaking Changes:
- Replaced Report-centric source management with Cache-based API
- Changed `mu_render(R, pos, src_id)` to `mu_render(R, pos, cache)`
- Removed `mu_source()`, replaced with `mu_addsource()` pattern
- Source auto-upgrade: single Source can be used as Cache transparently

C API Changes:
1. New Cache API
   - `mu_newcache()` / `mu_delcache()` for lifecycle management
   - `mu_addmemory()` / `mu_addfile()` for adding sources
   - `mu_sourcecount()` to query source count
   - Double-pointer pattern: `mu_addmemory(&C, ...)` auto-upgrades NULL

2. Source lifecycle
   - `mu_addsource()` creates Source with allocator
   - Single Source is-a Cache (cache.sources = &self)
   - `mu_delcache()` handles both single Source and multi-Cache
   - `mu_sourceoffset()` macro replaces direct field access

3. Render API
   - `mu_render()` takes `const mu_Cache*` instead of `src_id`
   - Validates all label src_id against cache source count
   - Groups are rebuilt per render (removed source-level gidx)

4. Memory management
   - `mu_Allocator` struct extracted from Report
   - `muM_alloc()` / `muM_free()` helpers
   -  Default allocator uses realloc/free

5. Internal restructuring
   - `muG_init_info()` returns LabelInfo by value
   - `mu_LabelInfo.label` now const pointer
   - Reference header uses Source* directly
   - Array helpers use mu_Allocator instead of Report

Lua Bindings:
- `lmu_Report` now owns `mu_Cache *C`
- `:source()` calls `mu_addmemory()` / `mu_addfile()`
- New `mu.cache()` class with `:source()` / `:file()` / `:render()`
- Cache `#` operator returns source count
- Render requires at least one source added

Documentation:
- README.md: Added C API Usage section
  * stb-style library setup (MU_IMPLEMENTATION, MU_STATIC_API)
  * Basic example with buffer_writer
  * Source/Cache lifecycle explanation
  * Multi-source, file streaming, error handling examples
  * Comple... (continued)

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

1363 of 1363 relevant lines covered (100.0%)

9355.61 hits per line