feat(chart): v0.4.0 portfolio hardening
Ship 15-task plan via kmp-manager group-by-group flow. Library moves
from "prototype" to "senior-engineer-built KMP library" per 3-reviewer
audit (android-reviewer + mobile-performance-reviewer + mobile-architect).
Critical fixes:
- LICENSE MIT (T1) — legal blocker resolved
- explicitApi() Strict + BCV 0.16.3 + klib enabled (T2) — ABI locked
baseline: chart-realtime.api 161 LOC + chart-realtime.klib.api 211 LOC
- Internal lockdown: CircularBuffer, TieredBuffer, LodDecimator,
dataVersion, rememberFrameTick (T3)
- kotlinx-datetime 0.6.2 replaces expect/actual currentTimeMs (T4)
Platform.kt + .android.kt + .ios.kt deleted
- CircularBuffer.writeIndex Int -> Long (T5) — fix 124d overflow @ 200Hz
- Remove !! and @Suppress("UNUSED_EXPRESSION") from commonMain (T6)
- Remove dead config: maxBufferSeconds, xLabelDecimals,
SignalConfig.label (T7)
Correctness:
- POSITIVE_INFINITY/Float.MAX_VALUE sentinels -> hasData flag (T8)
- Snapshot.withMutableSnapshot + SnapshotApplyConflictException retry
in push/addSignal/removeSignal (T9)
- dataVersion mutableLongStateOf — Compose-observable, idle = 0
recompositions (T10) — RenderLoop.kt deleted, targetFps @Deprecated
- Single buffer.snapshot() per signal per frame via SignalEntry
per-signal scratch arrays (T11) — render-time snapshot cost halved
- M4 binning Tier1/Tier2: firstTs/V + minTs/V + maxTs/V + lastTs/V
with chronological dedup (T12) — no C7 vertical spike artifacts.
TIER1/TIER2 CAPACITY x2 -> x4 (TOTAL 77.4k -> 94.8k)
- NaN/Inf/backward-timestamp guards on push (T13) — silent drop,
per-signal lastPushedTs tracking, KDoc contract
Test gap fill:
- NumberFormat extracted from AxisRenderer to internal object (T14)
+38 tests pinning rounding/scientific/time-format behavior
- TieredBufferTest +15 tests: tier roll, window-crossing, clear,
edge cases (T15)
- LodDecimatorTest +10 LTTB-specific branch coverage tests (T15)
Test count: 33 -> 107 (+74).
ABI: 211/272 -> 161/211 LOC (locked, baseline committed).
Deferred to v0.5.0:
- Bump kotlinx-datetime 0.6.2 -> 0.7.x (needs Kotlin 2.1.20+)
- Remove ChartConfig.targetFps (currently @Deprecated, ignored)
- NumberFormat Long overflow @ 1e19 (safe via current routing)
- LTTB upper-bound inclusive vs snapshot half-open semantic mismatch
- Macrobench setup for -30% frame-time verification
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Trentin Davide
parent
d6f51cdef2
commit
0e3b79e2da
38 changed files with 2399 additions and 264 deletions
108
.paul/ROADMAP.md
108
.paul/ROADMAP.md
|
|
@ -11,7 +11,9 @@ KMP real-time chart library. Six phases v0.1.0 MVP shipped; v0.2.0 polish shippe
|
||||||
| v0.1.0 MVP | 0.1.0 | ✓ Shipped | 2026-05-20 |
|
| v0.1.0 MVP | 0.1.0 | ✓ Shipped | 2026-05-20 |
|
||||||
| v0.2.0 Polish | 0.5.0-SNAPSHOT | ✓ Shipped | 2026-05-21 |
|
| v0.2.0 Polish | 0.5.0-SNAPSHOT | ✓ Shipped | 2026-05-21 |
|
||||||
| v0.3.0 iOS Build Pipeline | 0.5.0-SNAPSHOT | ✓ Shipped | 2026-05-21 |
|
| v0.3.0 iOS Build Pipeline | 0.5.0-SNAPSHOT | ✓ Shipped | 2026-05-21 |
|
||||||
| v0.4.0 (TBD) | - | Not started | - |
|
| v0.4.0 Portfolio Hardening | 0.5.0-SNAPSHOT | ✓ Shipped | 2026-05-21 |
|
||||||
|
| v0.5.0 Architecture + Interaction | - | Planned | - |
|
||||||
|
| v1.0.0 Public Release | - | Planned | - |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
@ -79,15 +81,101 @@ Plan: .paul/phases/v0.3.0-ios-build-plan.md
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## v0.4.0 — Potential Scope (TBD)
|
## v0.4.0 — Portfolio Hardening (SHIPPED)
|
||||||
|
|
||||||
| Item | Effort | Priority |
|
Plan: .paul/phases/v0.4.0-portfolio-hardening-plan.md
|
||||||
|------|--------|----------|
|
Source: 3-reviewer audit 2026-05-21
|
||||||
| Publish to Maven Central / GitHub Packages | M | Medium |
|
Executed via: kmp-manager group-by-group flow, 8 P-groups, ~15 agent calls
|
||||||
| iOS demo app (SwiftUI) | L | Medium |
|
Completed: 2026-05-21
|
||||||
| CI workflow GitHub Actions (Android + iOS) | M | Medium |
|
|
||||||
| Compose compiler stability annotation on SignalConfig | S | Low |
|
### Delivered
|
||||||
| CocoaPods / SPM publication | M | Low |
|
|
||||||
|
**Critical fixes:**
|
||||||
|
- LICENSE MIT (T1)
|
||||||
|
- explicitApi() Strict + BCV 0.16.3 + klib enabled (T2) — ABI baseline 161/211 LOC
|
||||||
|
- Internal lockdown of CircularBuffer / TieredBuffer / LodDecimator / dataVersion / rememberFrameTick (T3)
|
||||||
|
- kotlinx-datetime 0.6.2 replaces expect/actual currentTimeMs (T4) — Platform.* 3 files deleted
|
||||||
|
- CircularBuffer.writeIndex Int→Long (T5) — overflow 124d @ 200Hz fixed
|
||||||
|
- @Suppress + !! removed from commonMain (T6)
|
||||||
|
- Dead config removed: maxBufferSeconds, xLabelDecimals, SignalConfig.label (T7)
|
||||||
|
|
||||||
|
**Correctness:**
|
||||||
|
- POSITIVE_INFINITY/Float.MAX_VALUE sentinels → hasData boolean flag (T8)
|
||||||
|
- Snapshot.withMutableSnapshot + SnapshotApplyConflictException retry in push/addSignal/removeSignal (T9)
|
||||||
|
- dataVersion mutableLongStateOf — Compose-observable, idle = 0 recompositions (T10)
|
||||||
|
- RenderLoop.kt deleted; targetFps @Deprecated (T6/T10)
|
||||||
|
- Single snapshot per signal per frame via per-signal scratch arrays in SignalEntry (T11)
|
||||||
|
- M4 binning Tier1/Tier2: firstTs/V, minTs/V, maxTs/V, lastTs/V with chronological dedup (T12) — no C7 spikes
|
||||||
|
- NaN/Inf/backward-timestamp guards on push, KDoc contract, per-signal lastPushedTs (T13)
|
||||||
|
|
||||||
|
**Test gap fill:**
|
||||||
|
- NumberFormat extracted from AxisRenderer to internal object (T14) — 38 tests
|
||||||
|
- TieredBufferTest +15 tests (tier roll, window crossing, clear, edge cases) (T15)
|
||||||
|
- LodDecimatorTest +10 LTTB-specific tests (T15)
|
||||||
|
- iosSimulatorArm64Test: **33 → 107 tests** (target was ≥60)
|
||||||
|
|
||||||
|
**Capacity changes:**
|
||||||
|
- TIER1_CAPACITY 12k → 24k (×2 → ×4)
|
||||||
|
- TIER2_CAPACITY 5.4k → 10.8k (×2 → ×4)
|
||||||
|
- TOTAL_CAPACITY 77.4k → 94.8k
|
||||||
|
- Memory per signal: ~1.14 MB (was ~760 KB pre-bump)
|
||||||
|
|
||||||
|
**Deviations / deferred to v0.5.0:**
|
||||||
|
- kotlinx-datetime 0.6.2 (not 0.7.x) — Kotlin 2.1.0 compat
|
||||||
|
- ChartConfig.targetFps @Deprecated but kept for ABI stability
|
||||||
|
- NumberFormat Long overflow @ 1e19 (safe via current routing)
|
||||||
|
- LTTB upper-bound inclusive vs snapshot half-open semantic mismatch
|
||||||
|
|
||||||
---
|
---
|
||||||
*Roadmap updated: 2026-05-21*
|
|
||||||
|
## v0.5.0 — Architecture + Interaction (PLANNED)
|
||||||
|
|
||||||
|
Plan: .paul/phases/v0.5.0-architecture-plan.md
|
||||||
|
Effort: 5-7 giorni full-time, ~12 agent calls
|
||||||
|
Prereq: v0.4.0 shipped
|
||||||
|
|
||||||
|
### Highlights
|
||||||
|
- Interaction layer S0 (pinch zoom + drag pan + crosshair tap) — fatale senza
|
||||||
|
- LodStrategy/SignalRenderer/AxisFormatter interfaces (apri estensibilità)
|
||||||
|
- MinMaxLTTB SOTA algorithm (10x faster than LTTB puro, arXiv 2305.00332)
|
||||||
|
- Bisect tier snapshot per timestamp window (30x perf win)
|
||||||
|
- ChartConfig split DataConfig/AxisConfig/RenderConfig
|
||||||
|
- FrameRate sealed (replace `targetFps: Int?` nullable-as-sentinel)
|
||||||
|
- Compose @Stable/@Immutable annotations
|
||||||
|
- Cache Stroke + TextStyle + TextLayoutResult (zero-alloc render reale)
|
||||||
|
- Replace Pair<Float,Float> return + Map iter alloc
|
||||||
|
- RealtimeChartState.clear() API
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## v1.0.0 — Public Release (PLANNED)
|
||||||
|
|
||||||
|
Plan: .paul/phases/v1.0.0-public-release-plan.md
|
||||||
|
Effort: 2-3 giorni full-time + manual ops, ~10 agent calls
|
||||||
|
Prereq: v0.4.0 + v0.5.0 shipped
|
||||||
|
|
||||||
|
### Highlights
|
||||||
|
- Maven Central publishing (`dev.dtrentin:chart-realtime:1.0.0`)
|
||||||
|
- GitHub Actions CI (Android + iOS)
|
||||||
|
- SwiftUI iOS demo app consuming XCFramework
|
||||||
|
- Benchmark vs Vico/KoalaPlot/MPAndroidChart con numeri reali
|
||||||
|
- README professionale: GIF + badge + benchmark + onesta comparison table
|
||||||
|
- CHANGELOG.md + CONTRIBUTING.md + CODE_OF_CONDUCT.md
|
||||||
|
- Performance budget docs (frame time, memory, battery)
|
||||||
|
- Logo + banner + demo GIF
|
||||||
|
- Tag v1.0.0 + GitHub release con artifact
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Backlog (post v1.0.0)
|
||||||
|
- Multi-Y axis / log scale
|
||||||
|
- Annotations / threshold lines / regions
|
||||||
|
- Headless data export (PNG/CSV)
|
||||||
|
- CocoaPods publication
|
||||||
|
- Swift Package Manager (SPM)
|
||||||
|
- Wasm + desktop (jvm) targets
|
||||||
|
- ScatterRenderer / AreaRenderer / BarRenderer (sfrutta SignalRenderer interface)
|
||||||
|
- Legend composable
|
||||||
|
|
||||||
|
---
|
||||||
|
*Roadmap updated: 2026-05-21 — post 3-reviewer audit*
|
||||||
|
|
|
||||||
130
.paul/STATE.md
130
.paul/STATE.md
|
|
@ -5,26 +5,28 @@
|
||||||
See: .paul/PROJECT.md (updated 2026-05-21)
|
See: .paul/PROJECT.md (updated 2026-05-21)
|
||||||
|
|
||||||
**Core value:** Android devs plot 200Hz+ multi-signal sensor data without frame drops
|
**Core value:** Android devs plot 200Hz+ multi-signal sensor data without frame drops
|
||||||
**Current focus:** v0.3.0 iOS build pipeline SHIPPED — 33 tests pass on iOS sim, XCFramework produced
|
**Current focus:** v0.4.0 portfolio hardening SHIPPED — next v0.5.0 architecture + interaction
|
||||||
|
|
||||||
## Current Position
|
## Current Position
|
||||||
|
|
||||||
Milestone: v0.3.0-ios-build
|
Milestone: v0.5.0-architecture (NEXT)
|
||||||
Phase: 6 of 6 — Complete
|
Phase: 0 of N — Planned, not started
|
||||||
Plan: .paul/phases/v0.3.0-ios-build-plan.md
|
Plan: .paul/phases/v0.5.0-architecture-plan.md
|
||||||
Status: Complete
|
Status: Awaiting kickoff
|
||||||
Last activity: 2026-05-21 — iOS pipeline: compile 3 targets, link debug framework, iosSimulatorArm64Test green (33 tests, 0 failures), XCFramework "ChartRealtime" output (ios-arm64 + ios-arm64_x86_64-simulator slices). Android non-regression confirmed.
|
Last completed: v0.4.0 portfolio hardening (2026-05-21)
|
||||||
|
Last activity: 2026-05-21 — v0.4.0 closed via kmp-manager group-by-group flow. 8 P-groups executed. 15 plan tasks done. 107 tests pass (was 33). ABI lockdown active. Compose snapshot thread-safe.
|
||||||
|
|
||||||
Progress:
|
Progress:
|
||||||
- v0.1.0 milestone: [██████████] 100% SHIPPED
|
- v0.1.0 milestone: [██████████] 100% SHIPPED
|
||||||
- v0.2.0 milestone: [██████████] 100% SHIPPED
|
- v0.2.0 milestone: [██████████] 100% SHIPPED
|
||||||
- v0.3.0 milestone: [██████████] 100% SHIPPED
|
- v0.3.0 milestone: [██████████] 100% SHIPPED
|
||||||
|
- v0.4.0 milestone: [██████████] 100% SHIPPED
|
||||||
|
|
||||||
## Loop Position
|
## Loop Position
|
||||||
|
|
||||||
```
|
```
|
||||||
PLAN ──▶ APPLY ──▶ UNIFY
|
PLAN ──▶ APPLY ──▶ UNIFY
|
||||||
✓ ✓ ✓ [v0.3.0 iOS build SHIPPED — v0.5.0-SNAPSHOT]
|
✓ ✓ ✓ [v0.4.0 portfolio hardening SHIPPED — v0.5.0-SNAPSHOT]
|
||||||
```
|
```
|
||||||
|
|
||||||
## Accumulated Context
|
## Accumulated Context
|
||||||
|
|
@ -47,6 +49,19 @@ PLAN ──▶ APPLY ──▶ UNIFY
|
||||||
| applyDefaultHierarchyTemplate() explicit | v0.3.0 iOS | iosMain/iosTest auto-wired across 3 iOS targets |
|
| applyDefaultHierarchyTemplate() explicit | v0.3.0 iOS | iosMain/iosTest auto-wired across 3 iOS targets |
|
||||||
| Manual format helpers in AxisRenderer | v0.3.0 iOS | String.format JVM-only; private formatFixed/formatScientific/pow10 |
|
| Manual format helpers in AxisRenderer | v0.3.0 iOS | String.format JVM-only; private formatFixed/formatScientific/pow10 |
|
||||||
| kotlin.concurrent.Volatile + kotlin.jvm.JvmName imports | v0.3.0 iOS | Multiplatform replacements for JVM-default annotations |
|
| kotlin.concurrent.Volatile + kotlin.jvm.JvmName imports | v0.3.0 iOS | Multiplatform replacements for JVM-default annotations |
|
||||||
|
| MIT License | v0.4.0 T1 | Personal project, permissive, no patent grant required |
|
||||||
|
| explicitApi() Strict + BCV 0.16.3 + klib enabled | v0.4.0 T2 | ABI lockdown active; chart-realtime.api 161 LOC + .klib.api 211 LOC baseline |
|
||||||
|
| kotlinx-datetime 0.6.2 (NOT 0.7.x) | v0.4.0 T4 | Kotlin 2.1.0 compat; bump to 0.7.x when Kotlin → 2.1.20+ in v0.5.0 |
|
||||||
|
| CircularBuffer.writeIndex Long | v0.4.0 T5 | Overflow 124d @ 200Hz fixed |
|
||||||
|
| hasData boolean flag | v0.4.0 T8 | Replace Float.MAX_VALUE/POSITIVE_INFINITY sentinels in TieredBuffer + RealtimeChart |
|
||||||
|
| _signals as @Volatile copy-on-write Map | v0.4.0 T9 | Replace MutableState<Map>; eliminate snapshot writes from data thread for collection |
|
||||||
|
| dataVersion as mutableLongStateOf | v0.4.0 T10 | Compose-observable; drives recomposition data-driven; idle = 0 recompositions |
|
||||||
|
| applySnapshot retry helper (Snapshot.withMutableSnapshot + SnapshotApplyConflictException) | v0.4.0 T9 | Thread-safe push from background thread |
|
||||||
|
| RenderLoop.kt deleted | v0.4.0 T6/T10 | rememberFrameTick removed; targetFps deprecated (KDoc + @Deprecated) |
|
||||||
|
| Per-signal scratch arrays in SignalEntry | v0.4.0 T11 | Single buffer snapshot per signal per frame (was 2); ~1.14 MB/signal |
|
||||||
|
| M4 binning (firstTs/V, minTs/V, maxTs/V, lastTs/V) | v0.4.0 T12 | Replace double-push min/max sentinel; TIER1/2 CAPACITY *4; no vertical spikes at bin boundaries |
|
||||||
|
| NaN/Inf/backward-timestamp guards on push | v0.4.0 T13 | Silent drop; KDoc contract added; per-signal lastPushedTs tracking |
|
||||||
|
| NumberFormat internal object | v0.4.0 T14 | Extracted from AxisRenderer for testability; 38 tests pinned behavior |
|
||||||
|
|
||||||
### Deferred Issues
|
### Deferred Issues
|
||||||
|
|
||||||
|
|
@ -58,26 +73,107 @@ PLAN ──▶ APPLY ──▶ UNIFY
|
||||||
| ~~KDoc on public API surface~~ | v0.2.0 | M | ✓ v0.3.0 |
|
| ~~KDoc on public API surface~~ | v0.2.0 | M | ✓ v0.3.0 |
|
||||||
| ~~README with integration example~~ | v0.2.0 | S | ✓ v0.3.0 |
|
| ~~README with integration example~~ | v0.2.0 | S | ✓ v0.3.0 |
|
||||||
| ~~iOS build/test pipeline (compile + iosTest + XCFramework)~~ | v0.3.0 plan | M | ✓ v0.3.0 iOS |
|
| ~~iOS build/test pipeline (compile + iosTest + XCFramework)~~ | v0.3.0 plan | M | ✓ v0.3.0 iOS |
|
||||||
| Publish to Maven Central / GitHub Packages | v0.2.0 | M | v0.4.0 |
|
| Publish to Maven Central / GitHub Packages | v0.2.0 | M | v1.0.0 |
|
||||||
| iOS demo app (SwiftUI) | v0.3.0 iOS | L | v0.4.0 |
|
| iOS demo app (SwiftUI) | v0.3.0 iOS | L | v1.0.0 |
|
||||||
| CI workflow for iOS build (GitHub Actions) | v0.3.0 iOS | M | v0.4.0 |
|
| CI workflow for iOS build (GitHub Actions) | v0.3.0 iOS | M | v1.0.0 |
|
||||||
| Compose compiler unstable warning on SignalConfig | v0.3.0 iOS | S | v0.4.0 |
|
| Compose compiler unstable warning on SignalConfig | v0.3.0 iOS | S | v0.5.0 |
|
||||||
|
| ~~LICENSE missing~~ | v0.4.0 plan | S | ✓ v0.4.0 T1 (MIT) |
|
||||||
|
| ~~explicitApi + BCV~~ | v0.4.0 plan | M | ✓ v0.4.0 T2 |
|
||||||
|
| ~~Internal lockdown 6 leaked symbols~~ | v0.4.0 plan | M | ✓ v0.4.0 T3 |
|
||||||
|
| ~~Drop expect/actual currentTimeMs~~ | v0.4.0 plan | S | ✓ v0.4.0 T4 |
|
||||||
|
| ~~CircularBuffer.writeIndex Long~~ | v0.4.0 plan | S | ✓ v0.4.0 T5 |
|
||||||
|
| ~~@Suppress + !! cleanup~~ | v0.4.0 plan | S | ✓ v0.4.0 T6 |
|
||||||
|
| ~~Dead config removal~~ | v0.4.0 plan | S | ✓ v0.4.0 T7 |
|
||||||
|
| ~~POSITIVE_INFINITY sentinel replace~~ | v0.4.0 plan | S | ✓ v0.4.0 T8 |
|
||||||
|
| ~~Compose snapshot thread safety~~ | v0.4.0 plan | M | ✓ v0.4.0 T9 |
|
||||||
|
| ~~dataVersion mutableLongStateOf~~ | v0.4.0 plan | M | ✓ v0.4.0 T10 |
|
||||||
|
| ~~Single snapshot per signal per frame~~ | v0.4.0 plan | M | ✓ v0.4.0 T11 |
|
||||||
|
| ~~M4 binning Tier1/Tier2~~ | v0.4.0 plan | M | ✓ v0.4.0 T12 |
|
||||||
|
| ~~NaN/Inf/backward-timestamp guards~~ | v0.4.0 plan | S | ✓ v0.4.0 T13 |
|
||||||
|
| ~~AxisRenderer format helpers test~~ | v0.4.0 plan | M | ✓ v0.4.0 T14 (38 tests) |
|
||||||
|
| ~~TieredBuffer + LTTB test gap~~ | v0.4.0 plan | M | ✓ v0.4.0 T15 (25 tests) |
|
||||||
|
| Bump kotlinx-datetime 0.6.2 → 0.7.x | v0.4.0 T4 | S | v0.5.0 (needs Kotlin 2.1.20+) |
|
||||||
|
| Long overflow at |value| ≥ 1e19 in NumberFormat.formatFixed | v0.4.0 T14 | S | v0.5.0 (currently safe via routing) |
|
||||||
|
| LTTB upper bound inclusive vs snapshot half-open semantic mismatch | v0.4.0 T15 | S | v0.5.0 |
|
||||||
|
| Remove ChartConfig.targetFps (now @Deprecated, ignored) | v0.4.0 T10 | S | v0.5.0 |
|
||||||
|
| Memory budget: ~1.14 MB/signal post-CAPACITY *4 (was ~760 KB pre-bump) | v0.4.0 T12 | doc | document in README post-v0.4.0 |
|
||||||
|
|
||||||
|
### Reviewer Audit Findings (2026-05-21)
|
||||||
|
|
||||||
|
Source: 3 parallel reviewer agents (android-reviewer + mobile-performance-reviewer + mobile-architect).
|
||||||
|
|
||||||
|
**S0 (block portfolio) findings:**
|
||||||
|
- LICENSE missing → legalmente nessuno può usare la lib
|
||||||
|
- Compose snapshot violation: `push()` mutate MutableState da thread arbitrario senza withMutableSnapshot
|
||||||
|
- `dataVersion @Volatile` NON è Compose-observable, recomposition driven solo da frameTick side-effect
|
||||||
|
- Render NON zero-alloc: Pair + Stroke + TextLayoutResult + Strings per tick per frame (~50-100 KB/s)
|
||||||
|
- Snapshot doppia per signal per frame (8x lavoro su 4 segnali)
|
||||||
|
- No interaction layer (touch/zoom/pan) → fatale per "real-time chart" piece
|
||||||
|
|
||||||
|
**S1 (visibili) findings:**
|
||||||
|
- CircularBuffer.writeIndex Int overflow dopo 124 giorni @ 200Hz
|
||||||
|
- Tier1/Tier2 binning C7 artifacts (push doppio min poi max stesso ts)
|
||||||
|
- 6 leaked internal symbols pubblici (CircularBuffer, TieredBuffer, LodDecimator, dataVersion, rememberFrameTick, capacity constants)
|
||||||
|
- 3 dead config field (maxBufferSeconds, xLabelDecimals, SignalConfig.label)
|
||||||
|
- `@Suppress("UNUSED_EXPRESSION")` hack + `!!` non-null assertion in render hot path
|
||||||
|
- Test gap: AxisRenderer format helpers untested + buggy (Q4 formatFixed Long overflow), TieredBuffer untested (143 LOC), LTTB branch untested
|
||||||
|
- `expect/actual currentTimeMs` over-engineered — kotlinx-datetime 0.7.0+ replaces it
|
||||||
|
- iOS targets build ma README + samples Android-only
|
||||||
|
|
||||||
|
**Claims aggiustati:**
|
||||||
|
- "Zero GC at render time" → **falso oggi**, vero post v0.5.0 T8/T9
|
||||||
|
- "Lock-free SPSC ring buffer" → impreciso, fragile JMM su Native
|
||||||
|
- "200Hz sustained" → plausibile JVM, borderline mid Android multi-signal pre-v0.5.0 T11
|
||||||
|
- "1h buffer" → vero ma costa 720KB+ per signal (non documentato)
|
||||||
|
|
||||||
|
**Posizionamento mercato:**
|
||||||
|
Nicchia genuinamente vuota: nessun KMP chart lib (Vico, KoalaPlot, AAY-chart, netguru) targeta real-time 200Hz multi-signal con bounded memory. Differentiation reale ma serve interaction layer per essere prendibile sul serio.
|
||||||
|
|
||||||
### Blockers/Concerns
|
### Blockers/Concerns
|
||||||
None.
|
- ~~LICENSE missing~~ → ✓ MIT shipped in v0.4.0 T1
|
||||||
|
- ~~API surface non lockdown~~ → ✓ explicitApi + BCV shipped in v0.4.0 T2-T3
|
||||||
|
- ~~Compose snapshot thread safety~~ → ✓ withMutableSnapshot + retry shipped in v0.4.0 T9
|
||||||
|
- No interaction layer (touch/zoom/pan) → blocking "real-time chart" claim (v0.5.0 scope)
|
||||||
|
- targetFps deprecated but not removed → minor noise in public API (v0.5.0)
|
||||||
|
|
||||||
## Session Continuity
|
## Session Continuity
|
||||||
|
|
||||||
Last session: 2026-05-21 (iOS build pipeline)
|
Last session: 2026-05-21 (v0.4.0 portfolio hardening shipped via kmp-manager group-by-group flow)
|
||||||
Stopped at: v0.3.0 iOS shipped. All 5 acceptance items pass (A1-A5). 33 tests green on iOS sim. ChartRealtime.xcframework at chart-realtime/build/XCFrameworks/release/.
|
Stopped at: v0.4.0 closed. 15 plan tasks done. 107 tests pass. Full verify suite green.
|
||||||
Next action: Define v0.4.0 scope (Maven Central publish, iOS demo app, CI)
|
Next action: kickoff v0.5.0 architecture + interaction layer
|
||||||
Resume context:
|
Resume context:
|
||||||
- Library: chart-realtime, published dev.dtrentin:chart-realtime:0.5.0-SNAPSHOT to mavenLocal
|
- Library: chart-realtime, dev.dtrentin:chart-realtime:0.5.0-SNAPSHOT (version unbumped post-v0.4.0; bump deferred to v1.0.0 release)
|
||||||
- App: AndroidChartsApp consuming library, builds clean
|
- App: AndroidChartsApp consuming library, builds clean
|
||||||
- Remote: ssh://git@3nt-git.duckdns.org:222/davide.trentin/KMPCharts.git
|
- Remote: ssh://git@3nt-git.duckdns.org:222/davide.trentin/KMPCharts.git
|
||||||
- Package: dev.dtrentin.chart
|
- Package: dev.dtrentin.chart
|
||||||
- iOS: 3 targets compile, link, test (33 tests). XCFramework name `ChartRealtime`, baseName CamelCase.
|
- iOS: 3 targets compile, link, test (107 tests). XCFramework name `ChartRealtime`, baseName CamelCase.
|
||||||
- Local Mac setup: Xcode.app at /Applications/Xcode.app, iOS sim runtime installed (iPhone 17 family), local.properties points to ~/Library/Android/sdk, JDK 21 Temurin via JAVA_HOME.
|
- Local Mac setup: Xcode.app at /Applications/Xcode.app, iOS sim runtime installed (iPhone 17 family), local.properties points to ~/Library/Android/sdk, JDK 21 Temurin via JAVA_HOME.
|
||||||
|
- ABI baseline committed: chart-realtime/api/chart-realtime.api (161 LOC) + chart-realtime.klib.api (211 LOC)
|
||||||
|
- Plans: v0.4.0 ✓ SHIPPED · v0.5.0 + v1.0.0 PLANNED
|
||||||
|
- Effort residuo verso v1.0.0: ~7-10 giorni full-time
|
||||||
|
|
||||||
|
### v0.4.0 close summary (2026-05-21)
|
||||||
|
|
||||||
|
15 plan tasks executed across 8 P-groups via kmp-manager:
|
||||||
|
- P0: T1 (LICENSE MIT) + T7 (dead config removal)
|
||||||
|
- P1: T2 (explicitApi + BCV 0.16.3 + klib enabled)
|
||||||
|
- P2: T3 (internal lockdown) + T4 (kotlinx-datetime 0.6.2)
|
||||||
|
- P3: T5 (writeIndex Long) + T8 (hasData boolean flag)
|
||||||
|
- P4: T6 (RealtimeChart cleanup) + T9 (snapshot thread safety) + T10 (mutableLongStateOf)
|
||||||
|
- P5: T11 (single snapshot per signal) + T12 (M4 binning)
|
||||||
|
- P6: T13 (NaN/Inf/backward guards)
|
||||||
|
- P7: T14 (NumberFormat extract + 38 tests) + T15 (TieredBuffer/LTTB +25 tests)
|
||||||
|
|
||||||
|
Test count: 33 → 107 (+74).
|
||||||
|
ABI: 211/272 → 161/211 LOC (locked, baseline committed).
|
||||||
|
RenderLoop.kt deleted. Platform.kt + .android.kt + .ios.kt deleted.
|
||||||
|
0 `!!` assertions in commonMain. 0 `@Suppress` hacks. explicitApi Strict.
|
||||||
|
|
||||||
|
Deviations from plan:
|
||||||
|
- T4 kotlinx-datetime 0.6.2 instead of 0.7.x (Kotlin 2.1.0 compat — 0.7.x needs Kotlin 2.1.20+). Bump deferred to v0.5.0.
|
||||||
|
- T7 ChartConfig.targetFps NOT removed (would break ABI of data class). Marked @Deprecated, ignored at runtime. Full removal in v0.5.0.
|
||||||
|
- T11 memory per signal ~1.14 MB (plan estimate was ~760 KB based on pre-bump TOTAL_CAPACITY). Acceptable.
|
||||||
|
- T13 unknown-signal push no longer bumps dataVersion (was bumping in v0.3.0). Existing test `push_unknownSignal_stillIncrementsDataVersion` replaced with `pushIgnoresUnknownSignalName` per new contract.
|
||||||
|
|
||||||
---
|
---
|
||||||
*STATE.md — Updated after every significant action*
|
*STATE.md — Updated after every significant action*
|
||||||
|
|
|
||||||
|
|
@ -1,10 +1,10 @@
|
||||||
{
|
{
|
||||||
"name": "chart-realtime",
|
"name": "chart-realtime",
|
||||||
"version": "0.0.0",
|
"version": "0.5.0-SNAPSHOT",
|
||||||
"milestone": {
|
"milestone": {
|
||||||
"name": "v0.1.0 MVP",
|
"name": "v0.5.0 Architecture + Interaction",
|
||||||
"version": "0.1.0",
|
"version": "0.5.0",
|
||||||
"status": "not_started"
|
"status": "planned"
|
||||||
},
|
},
|
||||||
"phase": {
|
"phase": {
|
||||||
"number": 0,
|
"number": 0,
|
||||||
|
|
@ -12,12 +12,12 @@
|
||||||
"status": "not_started"
|
"status": "not_started"
|
||||||
},
|
},
|
||||||
"loop": {
|
"loop": {
|
||||||
"plan": null,
|
"plan": ".paul/phases/v0.4.0-portfolio-hardening-plan.md",
|
||||||
"position": "IDLE"
|
"position": "CLOSED"
|
||||||
},
|
},
|
||||||
"timestamps": {
|
"timestamps": {
|
||||||
"created_at": "2026-05-20T00:00:00Z",
|
"created_at": "2026-05-20T00:00:00Z",
|
||||||
"updated_at": "2026-05-20T00:00:00Z"
|
"updated_at": "2026-05-21T00:00:00Z"
|
||||||
},
|
},
|
||||||
"satellite": {
|
"satellite": {
|
||||||
"groom": true
|
"groom": true
|
||||||
|
|
|
||||||
201
.paul/phases/v0.4.0-portfolio-hardening-plan.md
Normal file
201
.paul/phases/v0.4.0-portfolio-hardening-plan.md
Normal file
|
|
@ -0,0 +1,201 @@
|
||||||
|
# v0.4.0 — Portfolio Hardening Plan
|
||||||
|
|
||||||
|
## Source
|
||||||
|
Verdict consolidato 3 reviewer (android-reviewer + mobile-performance-reviewer + mobile-architect) 2026-05-21. Library oggi = **prototipo solido NON portfolio-grade**. Stima totale: ~10-12 giorni full-time.
|
||||||
|
|
||||||
|
## Goal
|
||||||
|
Portare `chart-realtime` da "promising prototype" a "senior-engineer-built KMP library". Fix issue critiche, lockdown ABI, correttezza thread-safety, zero-alloc render reale.
|
||||||
|
|
||||||
|
## Scope IN (Fase 1 + 2 del plan completo)
|
||||||
|
- Hygiene base: LICENSE, explicitApi, binary-compatibility-validator, dead code removal
|
||||||
|
- Correttezza: Compose snapshot thread safety, M4 binning, single-snapshot per frame, NaN/Inf guards
|
||||||
|
- Test coverage: AxisRenderer format helpers + TieredBuffer + LTTB
|
||||||
|
|
||||||
|
## Scope OUT
|
||||||
|
- Interaction layer (touch/zoom/pan) → v0.5.0
|
||||||
|
- MinMaxLTTB algorithm swap → v0.5.0
|
||||||
|
- Marketing (Maven Central, screenshots, CI badges, demo iOS) → v1.0.0
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Tasks
|
||||||
|
|
||||||
|
### T1 — LICENSE (S0 blocker)
|
||||||
|
- File: `/Users/henesis/dev/dav/KMPCharts/LICENSE`
|
||||||
|
- Action: scegli MIT o Apache 2.0. Aggiungi file root + reference in README + `chart-realtime/build.gradle.kts` pom config (per Maven publish futuro).
|
||||||
|
- Agent: manager direct (10 LoC)
|
||||||
|
- Verify: `ls LICENSE` + git tracked
|
||||||
|
|
||||||
|
### T2 — explicitApi + binary-compatibility-validator
|
||||||
|
- Files: `chart-realtime/build.gradle.kts`, root `build.gradle.kts`, `gradle/libs.versions.toml`
|
||||||
|
- Action:
|
||||||
|
- Aggiungi `kotlin { explicitApi() }` a `chart-realtime/build.gradle.kts`
|
||||||
|
- Plugin `org.jetbrains.kotlinx.binary-compatibility-validator` versione corrente
|
||||||
|
- Config `apiValidation { @OptIn(kotlinx.validation.ExperimentalBCVApi::class) klib { enabled = true } }`
|
||||||
|
- Commit `chart-realtime/api/chart-realtime.api` dump
|
||||||
|
- Agent: gradle-expert
|
||||||
|
- Verify: `./gradlew :chart-realtime:apiDump` + check committed file
|
||||||
|
- Pattern: [RevenueCat KMP example](https://www.revenuecat.com/blog/engineering/binary-compatability/)
|
||||||
|
|
||||||
|
### T3 — Internal lockdown (6 leaked symbols)
|
||||||
|
- Files:
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/RealtimeChartState.kt:33` → `dataVersion` internal
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/buffer/CircularBuffer.kt` → class internal
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/buffer/TieredBuffer.kt` → class + companion internal
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/buffer/LodDecimator.kt` → class internal
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/render/RenderLoop.kt:16` → `rememberFrameTick` internal
|
||||||
|
- Action: cambia visibility a `internal`. Fixare call site `RealtimeChart.kt:51-54` che usa `TieredBuffer.TOTAL_CAPACITY` (resta accessibile da stesso modulo).
|
||||||
|
- Agent: kmp-architect
|
||||||
|
- Verify: `./gradlew :chart-realtime:apiCheck` + compile green
|
||||||
|
|
||||||
|
### T4 — Drop expect/actual currentTimeMs → kotlinx-datetime
|
||||||
|
- Files:
|
||||||
|
- Delete: `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/Platform.kt`
|
||||||
|
- Delete: `chart-realtime/src/androidMain/kotlin/dev/dtrentin/chart/Platform.android.kt`
|
||||||
|
- Delete: `chart-realtime/src/iosMain/kotlin/dev/dtrentin/chart/Platform.ios.kt`
|
||||||
|
- Modify: `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/RealtimeChartState.kt:64` (callsite)
|
||||||
|
- Modify: `chart-realtime/build.gradle.kts` add kotlinx-datetime dep
|
||||||
|
- Modify: `gradle/libs.versions.toml` add kotlinx-datetime ≥ 0.7.0
|
||||||
|
- Action: import `kotlinx.datetime.Clock`. Replace callsite con `Clock.System.now().toEpochMilliseconds()`.
|
||||||
|
- Agent: kmp-architect
|
||||||
|
- Verify: `compileKotlinIosSimulatorArm64` + `compileDebugKotlinAndroid` green
|
||||||
|
- Pattern: [kotlinx-datetime GitHub](https://github.com/Kotlin/kotlinx-datetime)
|
||||||
|
|
||||||
|
### T5 — CircularBuffer.writeIndex: Int → Long (overflow critico dopo 124 giorni @ 200Hz)
|
||||||
|
- File: `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/buffer/CircularBuffer.kt:15-46`
|
||||||
|
- Action:
|
||||||
|
- `writeIndex: Int → Long`
|
||||||
|
- Aggiorna call site `(writeIndex % capacity).toInt()` per index access
|
||||||
|
- Update `snapshot` boundary math `currentWrite - capacity`
|
||||||
|
- Agent: data-impl
|
||||||
|
- Verify: nuovo test `writeIndexSurvivesIntMaxValue` in CircularBufferTest
|
||||||
|
|
||||||
|
### T6 — Rimuovi `@Suppress("UNUSED_EXPRESSION") frameTick` + `!!`
|
||||||
|
- File: `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/RealtimeChart.kt:50,59,63,90,103`
|
||||||
|
- Action:
|
||||||
|
- Linea 59: delete (recomposition già triggata da line 41 read)
|
||||||
|
- Linea 63: aggiungi `val t0 = state.resolvedT0Ms ?: return@Canvas`
|
||||||
|
- Linea 90: replace `state.resolvedT0Ms!!` con `t0` capturato
|
||||||
|
- Linea 50/103: replace `mutableLongStateOf` con `remember { longArrayOf(-1L) }` → versionHolder[0] (no snapshot write in draw)
|
||||||
|
- Agent: compose-guide
|
||||||
|
- Verify: compose preview funziona + 33 test pass
|
||||||
|
|
||||||
|
### T7 — Remove dead config
|
||||||
|
- Files:
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/model/ChartConfig.kt:18` → `maxBufferSeconds` (ignored by TieredBuffer)
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/model/ChartConfig.kt:24` → `xLabelDecimals` (ignored by formatTimeSec)
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/model/SignalConfig.kt:17` → `label` (never used)
|
||||||
|
- Action: rimuovi i 3 field. Update README dove menzionano.
|
||||||
|
- Agent: kmp-architect
|
||||||
|
- Verify: compile green + test green
|
||||||
|
|
||||||
|
### T8 — Replace POSITIVE_INFINITY sentinel
|
||||||
|
- Files:
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/RealtimeChart.kt:77-87`
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/buffer/TieredBuffer.kt:35,54`
|
||||||
|
- Action: introdurre `var hasData = false` flag invece di confronto float-equality sentinel.
|
||||||
|
- Agent: data-impl
|
||||||
|
- Verify: test esistenti pass + nuovo test `tier1BinAcceptsFloatMaxValueSample`
|
||||||
|
|
||||||
|
### T9 — Compose snapshot thread safety
|
||||||
|
- File: `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/RealtimeChartState.kt:42-66`
|
||||||
|
- Action: wrap `push`, `addSignal`, `removeSignal` body in `Snapshot.withMutableSnapshot { }`. Catch `SnapshotApplyConflictException` con retry loop.
|
||||||
|
- Alt: replace `_signals: MutableState<Map>` con `mutableLongStateOf` versione bumped on mutation + plain volatile map → eliminate snapshot writes from background thread.
|
||||||
|
- Agent: kmp-architect + compose-guide (paired review)
|
||||||
|
- Verify: stress test multi-producer (2+ thread call push 200Hz). Aggiungere `pushFromBackgroundThreadIsSafe` test.
|
||||||
|
- Pattern: [Zach Klipp Snapshot guide](https://blog.zachklipp.com/introduction-to-the-compose-snapshot-system/)
|
||||||
|
|
||||||
|
### T10 — dataVersion → mutableLongStateOf (drop frameTick dependency)
|
||||||
|
- Files:
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/RealtimeChartState.kt:33`
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/RealtimeChart.kt:41,60`
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/render/RenderLoop.kt` → ridurre frameTick a heartbeat opzionale o eliminarlo
|
||||||
|
- Action: `dataVersion` come `mutableLongStateOf(0L)`. Canvas reads diventano Compose-observable. Recomposition data-driven, no più dipendenza da rememberFrameTick polling.
|
||||||
|
- Agent: compose-guide
|
||||||
|
- Verify: idle behavior — no new data = no recomposition. Use Layout Inspector recomposition count.
|
||||||
|
|
||||||
|
### T11 — Single snapshot per signal per frame
|
||||||
|
- Files:
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/RealtimeChart.kt:79-86`
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/render/SignalRenderer.kt:30`
|
||||||
|
- Action: snapshot una sola volta per signal in RealtimeChart, calcola dataMin/dataMax nello stesso loop, passa `count` a `drawSignal` (rimuovi snapshot interno).
|
||||||
|
- Agent: kmp-architect
|
||||||
|
- Verify: macrobench frame time -30% con 4 signals
|
||||||
|
|
||||||
|
### T12 — M4 binning per Tier1/Tier2 (fix artefatti visivi C7)
|
||||||
|
- File: `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/buffer/TieredBuffer.kt:30-66`
|
||||||
|
- Action: per bin store `(firstTs, firstV, lastTs, lastV, minV, maxV)` invece di doppio push `(midTs, min), (midTs, max)`. Rispetta ordine cronologico downstream.
|
||||||
|
- Agent: data-impl
|
||||||
|
- Verify: nuovi test `tier1BinPreservesM4`, `tier2BinPreservesM4`, `noVerticalSpikesAtBinBoundaries`
|
||||||
|
- Pattern: M4 paper / [MinMaxLTTB arXiv 2305.00332](https://arxiv.org/pdf/2305.00332)
|
||||||
|
|
||||||
|
### T13 — NaN/Inf/backward-timestamp guards
|
||||||
|
- File: `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/RealtimeChartState.kt:52`
|
||||||
|
- Action:
|
||||||
|
- `push` rifiuta `!value.isFinite()` (early return)
|
||||||
|
- `push` rifiuta `timestampMs < lastPushedTs` per signal (drop or expose `PushResult` sealed)
|
||||||
|
- KDoc contratto: "Samples must have finite value and monotonic non-decreasing timestamps"
|
||||||
|
- Agent: data-impl
|
||||||
|
- Verify: test `pushRejectsNaN`, `pushRejectsBackwardTimestamp`
|
||||||
|
|
||||||
|
### T14 — Test gap: AxisRenderer format helpers
|
||||||
|
- File new: `chart-realtime/src/commonTest/kotlin/dev/dtrentin/chart/render/NumberFormatTest.kt`
|
||||||
|
- Refactor: extract `formatFixed`, `formatScientific`, `formatTimeSec`, `niceInterval`, `pow10` da `AxisRenderer` privato → `internal object NumberFormat`.
|
||||||
|
- Action: 20+ edge case test (0.999 rounding, 1.005 banker's, 99.999 carry, 1e19 Long overflow, negative, NaN, very large exp, time -65s, time 3700s)
|
||||||
|
- Agent: unit-test-writer
|
||||||
|
- Verify: `iosSimulatorArm64Test` count passa da 33 a 50+
|
||||||
|
|
||||||
|
### T15 — Test gap: TieredBuffer + LodDecimator LTTB branch
|
||||||
|
- Files new:
|
||||||
|
- `chart-realtime/src/commonTest/kotlin/dev/dtrentin/chart/buffer/TieredBufferTest.kt`
|
||||||
|
- Extend `LodDecimatorTest.kt` con LTTB branch coverage
|
||||||
|
- Action: 10+ test su tier roll, bin flush, snapshot window crossing 3 tier boundaries, clear()
|
||||||
|
- Agent: unit-test-writer
|
||||||
|
- Verify: coverage TieredBuffer ≥80%
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Acceptance v0.4.0
|
||||||
|
- A1: `./gradlew :chart-realtime:apiCheck` green con .api dump committato
|
||||||
|
- A2: `kotlin { explicitApi() }` attivo, nessun warning visibility
|
||||||
|
- A3: LICENSE presente, riferito in README + Gradle publish config
|
||||||
|
- A4: Tutti i symbol "leaked" sono `internal` (CircularBuffer, TieredBuffer, LodDecimator, dataVersion, rememberFrameTick, capacity constants)
|
||||||
|
- A5: kotlinx-datetime sostituisce expect/actual currentTimeMs (3 file cancellati)
|
||||||
|
- A6: 0 `!!` non null assertion in commonMain
|
||||||
|
- A7: 0 `@Suppress` magic-fix annotations
|
||||||
|
- A8: Multi-producer push test green (50 thread × 100 push each, no lost samples, no race exceptions)
|
||||||
|
- A9: Macrobench frame time -30% post T11 (single snapshot)
|
||||||
|
- A10: iosSimulatorArm64Test ≥ 60 test (da 33)
|
||||||
|
- A11: Compose snapshot conformance: writes da background thread sempre via `withMutableSnapshot`
|
||||||
|
- A12: NaN/Inf samples rifiutati, backward timestamps droppati
|
||||||
|
- A13: TieredBuffer M4 binning, no vertical spike artifacts
|
||||||
|
- A14: README aggiornato — rimuovi dead config refs, claim "zero GC at render" qualificato
|
||||||
|
|
||||||
|
## Parallelism
|
||||||
|
| Group | Tasks |
|
||||||
|
|-------|-------|
|
||||||
|
| P0 | T1, T7 (parallel, file-isolated) |
|
||||||
|
| P1 | T2 (Gradle config) |
|
||||||
|
| P2 | T3, T4 (parallel: visibility + kotlinx-datetime in disjoint files) |
|
||||||
|
| P3 | T5, T8 (buffer fixes parallel) |
|
||||||
|
| P4 | T6, T9, T10 (compose layer) |
|
||||||
|
| P5 | T11, T12 (render perf + M4) |
|
||||||
|
| P6 | T13 (input validation) |
|
||||||
|
| P7 | T14, T15 (test gap fill, parallel) |
|
||||||
|
|
||||||
|
## Estimated agent calls
|
||||||
|
~15 agent calls. ~3-4 giorni full-time.
|
||||||
|
|
||||||
|
## Risks
|
||||||
|
- T9 (snapshot thread safety) may surface API changes — minor breaking
|
||||||
|
- T12 (M4 binning) requires LodDecimator MIN_MAX consumer update — coupled
|
||||||
|
- T10 may remove `rememberFrameTick` public API — breaking, mitigate via @Deprecated
|
||||||
|
|
||||||
|
## Verification commands (consolidated)
|
||||||
|
```bash
|
||||||
|
./gradlew :chart-realtime:apiCheck
|
||||||
|
./gradlew :chart-realtime:compileKotlinIosX64 :chart-realtime:compileKotlinIosArm64 :chart-realtime:compileKotlinIosSimulatorArm64
|
||||||
|
./gradlew :chart-realtime:iosSimulatorArm64Test
|
||||||
|
./gradlew :chart-realtime:assembleRelease
|
||||||
|
./gradlew :chart-realtime:assembleChartRealtimeXCFramework
|
||||||
|
```
|
||||||
159
.paul/phases/v0.5.0-architecture-plan.md
Normal file
159
.paul/phases/v0.5.0-architecture-plan.md
Normal file
|
|
@ -0,0 +1,159 @@
|
||||||
|
# v0.5.0 — Architecture + Interaction Plan
|
||||||
|
|
||||||
|
## Source
|
||||||
|
mobile-architect verdict 2026-05-21: "Library is a closed renderer with single skin. Anything beyond first-party use case requires forking." Senza interaction layer "no senior reviewer will take a real-time chart claim seriously."
|
||||||
|
|
||||||
|
## Goal
|
||||||
|
Aprire estensibilità + aggiungere interaction layer (S0 per portfolio). MinMaxLTTB SOTA algorithm. Config split. Bisect tier snapshot per perf.
|
||||||
|
|
||||||
|
## Prereq
|
||||||
|
v0.4.0 shipped (hygiene + correctness).
|
||||||
|
|
||||||
|
## Scope IN
|
||||||
|
- Interaction layer: pinch zoom, drag pan, crosshair, tap-to-inspect
|
||||||
|
- Renderer/LodStrategy/AxisFormatter interfaces
|
||||||
|
- MinMaxLTTB algorithm (replaces both MIN_MAX and LTTB attuali)
|
||||||
|
- Bisect-based windowed snapshot (30x perf win)
|
||||||
|
- ChartConfig split DataConfig/AxisConfig/RenderConfig
|
||||||
|
- Compose stability annotations (@Stable, @Immutable)
|
||||||
|
|
||||||
|
## Scope OUT
|
||||||
|
- Multi-Y axis / log scale → v0.6.0+
|
||||||
|
- Annotations / threshold lines → v0.6.0+
|
||||||
|
- Headless data export → backlog
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Tasks
|
||||||
|
|
||||||
|
### T1 — Bisect tier snapshot (perf S0)
|
||||||
|
- Files: `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/buffer/CircularBuffer.kt`, `TieredBuffer.kt`
|
||||||
|
- Goal: `snapshotWindow(startMs, endMs, outTs, outV): Int` bisect su timestamps monotonici. Cuts 30x copies su 10s window in 5min buffer.
|
||||||
|
- Agent: data-impl + mobile-performance-reviewer review
|
||||||
|
- Verify: macrobench frame time -50% addizionale post v0.4.0 T11
|
||||||
|
|
||||||
|
### T2 — LodStrategy interface + MinMaxLTTB impl
|
||||||
|
- New files:
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/lod/LodStrategy.kt`
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/lod/MinMaxLttb.kt`
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/lod/MinMaxLod.kt`
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/lod/LttbLod.kt`
|
||||||
|
- Move + rename: `buffer/LodDecimator.kt` → `lod/LodDecimator.kt` (delegate to strategy)
|
||||||
|
- Goal: interface `LodStrategy { fun decimate(...): Int }`. Default = `MinMaxLttb` (10x faster than LTTB puro per arXiv 2305.00332).
|
||||||
|
- API change: `LodMode` enum → `LodStrategy` interface. `ChartConfig.lodMode: LodMode` → `lodStrategy: LodStrategy`. Backward compat: `LodMode.MIN_MAX_LTTB` shorthand.
|
||||||
|
- Agent: kmp-architect + data-impl
|
||||||
|
- Verify: nuovi test `MinMaxLttbVisualFidelityTest`, perf ≥ MIN_MAX puro su large datasets
|
||||||
|
- Pattern: [MinMaxLTTB arXiv 2305.00332](https://arxiv.org/pdf/2305.00332), [Rust ref impl](https://github.com/andrei-ng/minmaxlttb-rs)
|
||||||
|
|
||||||
|
### T3 — SignalRenderer interface
|
||||||
|
- New file: `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/render/SignalRenderer.kt` (interface)
|
||||||
|
- Move impl → `LineSignalRenderer.kt`
|
||||||
|
- Goal: pluggable rendering. Future-proof per `ScatterRenderer`, `AreaRenderer`, `BarRenderer`. Default `LineSignalRenderer`.
|
||||||
|
- `SignalConfig.renderer: SignalRenderer = LineSignalRenderer` (per-signal opt-in)
|
||||||
|
- Agent: kmp-architect
|
||||||
|
- Verify: existing rendering unchanged, plus `customRendererPlugsIn` test
|
||||||
|
|
||||||
|
### T4 — AxisFormatter interface
|
||||||
|
- New file: `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/render/AxisFormatter.kt`
|
||||||
|
- Default impls: `TimeAxisFormatter` (current behavior), `DecimalAxisFormatter`, `DateTimeAxisFormatter`, `UnitAxisFormatter("mV", "°C", "Hz")`.
|
||||||
|
- `AxisConfig.xFormatter: AxisFormatter = TimeAxisFormatter`, `yFormatter: AxisFormatter = DecimalAxisFormatter`
|
||||||
|
- Agent: kmp-architect + ui-impl
|
||||||
|
- Verify: user can pass `UnitAxisFormatter("ms")` and labels show "5 ms"
|
||||||
|
|
||||||
|
### T5 — Split ChartConfig → DataConfig + AxisConfig + RenderConfig
|
||||||
|
- File: `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/model/ChartConfig.kt`
|
||||||
|
- New: `DataConfig`, `AxisConfig`, `RenderConfig`. `ChartConfig` = wrapper o builder DSL.
|
||||||
|
- `targetFps: Int?` → `sealed class FrameRate { object Display; data class Fixed(val fps: Int) }`
|
||||||
|
- Mark old `ChartConfig` ctor `@Deprecated(level = WARNING)` con `ReplaceWith`.
|
||||||
|
- Agent: kmp-architect
|
||||||
|
- Verify: README example updated, compile green con deprecation warning
|
||||||
|
|
||||||
|
### T6 — Compose stability annotations
|
||||||
|
- Files (tutti i data class in model/):
|
||||||
|
- `ChartConfig.kt`, `SignalConfig.kt`, `ChartTheme.kt`, `T0.kt`, `YRange.kt`, `LodMode.kt`, `AxisLabelMode.kt`
|
||||||
|
- `RealtimeChartState.kt`
|
||||||
|
- Action: `@Immutable` su data class + sealed root. `@Stable` su `RealtimeChartState`.
|
||||||
|
- Agent: compose-guide
|
||||||
|
- Verify: Compose compiler report `chart-realtime` mostra 0 unstable classes nel public API. `./gradlew :chart-realtime:compileReleaseKotlinAndroid -Pkotlinx.compose.report` etc.
|
||||||
|
|
||||||
|
### T7 — Interaction layer S0 (touch/zoom/pan/crosshair)
|
||||||
|
- New files:
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/interaction/ChartInteractionState.kt`
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/interaction/InteractionConfig.kt`
|
||||||
|
- Modify: `RealtimeChart.kt` aggiunge `Modifier.pointerInput` con `detectTransformGestures` (pinch) + `detectDragGestures` (pan) + `detectTapGestures` (crosshair toggle).
|
||||||
|
- State:
|
||||||
|
- `viewportOffsetMs: Long` — pan offset history
|
||||||
|
- `viewportScale: Float` — zoom factor on xWindowSeconds
|
||||||
|
- `mode: ViewportMode { Following, Frozen, History(offsetMs) }`
|
||||||
|
- `crosshair: CrosshairState?` — pixel position + projected (timestampMs, value) per ogni signal
|
||||||
|
- Inverse projection helper (pixel → data) per tooltip
|
||||||
|
- Agent: ui-impl + compose-guide
|
||||||
|
- Verify:
|
||||||
|
- pinch zoom restringe/allarga xWindowSeconds
|
||||||
|
- drag pan sposta viewport (mode Frozen automatically)
|
||||||
|
- tap mostra crosshair con valori istantanei
|
||||||
|
- tap su crosshair attivo → dismiss
|
||||||
|
- swipe a destra estrema → mode Following (auto-scroll resumes)
|
||||||
|
- New tests: `ChartInteractionStateTest`, integration test composable
|
||||||
|
|
||||||
|
### T8 — Cache Stroke + TextStyle + TextLayoutResult per zero-alloc reale
|
||||||
|
- Files:
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/render/SignalRenderer.kt:50` — `Stroke` cached per signal
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/render/AxisRenderer.kt:54-131` — `TextStyle` hoisted in `remember`, label `TextLayoutResult` cached via `remember(label, style)`
|
||||||
|
- Action: introduce `internal class FrameCaches` holding stroke per signal + label LRU.
|
||||||
|
- Agent: compose-guide + mobile-performance-reviewer
|
||||||
|
- Verify: allocation tracker show < 1 KB/s steady-state at 30fps, 4 signals
|
||||||
|
- Pattern: [TextMeasurer LRU - composables.com](https://composables.com/jetpack-compose/androidx.compose.ui/ui-text/classes/TextMeasurer/api), [Modifier.drawWithCache - Android Devs](https://developer.android.com/develop/ui/compose/graphics/draw/overview)
|
||||||
|
|
||||||
|
### T9 — Replace Pair<Float,Float> return + Map iteration alloc
|
||||||
|
- Files:
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/render/AxisRenderer.kt:144-152` — `resolveYRange` riempie `FloatArray(2)` out param
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/RealtimeChart.kt:70,79,93` — Map iter via cached `signalsArray`
|
||||||
|
- `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/RealtimeChartState.kt` — invalidate signalsArray su addSignal/removeSignal
|
||||||
|
- Agent: mobile-performance-reviewer + data-impl
|
||||||
|
- Verify: Map iter allocation count = 0 in macrobench
|
||||||
|
|
||||||
|
### T10 — clear() / reset() su RealtimeChartState
|
||||||
|
- File: `chart-realtime/src/commonMain/kotlin/dev/dtrentin/chart/RealtimeChartState.kt`
|
||||||
|
- Goal: `fun clear()` purge tutti i buffer + reset dataVersion + reset resolvedT0Ms. Public API.
|
||||||
|
- Agent: data-impl
|
||||||
|
- Verify: test `clearResetsState`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Acceptance v0.5.0
|
||||||
|
|
||||||
|
- A1: `LodStrategy` interface + `MinMaxLttb` default, perf ≥ MIN_MAX puro su 100k+ samples
|
||||||
|
- A2: `SignalRenderer` interface, default `LineSignalRenderer`, user custom renderer impl-able in 50 LoC
|
||||||
|
- A3: `AxisFormatter` interface con 4 default impls (Time, Decimal, DateTime, Unit)
|
||||||
|
- A4: ChartConfig split, FrameRate sealed, deprecated old API con ReplaceWith
|
||||||
|
- A5: Compose compiler report: 0 unstable public types
|
||||||
|
- A6: Interaction layer: pinch zoom + drag pan + crosshair tap funzionanti
|
||||||
|
- A7: Bisect snapshot taglia copy 30x su 10s window in 5min buffer (macrobench)
|
||||||
|
- A8: Render zero-alloc reale (< 1 KB/s in macrobench steady)
|
||||||
|
- A9: `RealtimeChartState.clear()` API + test
|
||||||
|
|
||||||
|
## Parallelism
|
||||||
|
| Group | Tasks |
|
||||||
|
|-------|-------|
|
||||||
|
| P0 | T1, T6, T10 (parallel) |
|
||||||
|
| P1 | T2, T3, T4 (interfaces parallel) |
|
||||||
|
| P2 | T5 (config split, depends on T2-T4 interfaces) |
|
||||||
|
| P3 | T7 (interaction layer, biggest task) |
|
||||||
|
| P4 | T8, T9 (perf finishing) |
|
||||||
|
|
||||||
|
## Estimated agent calls
|
||||||
|
~12 agent calls. ~5-7 giorni full-time.
|
||||||
|
|
||||||
|
## Risks
|
||||||
|
- T2 (MinMaxLTTB): break LodMode enum API → migration required by consumers
|
||||||
|
- T7 (interaction): biggest scope, multi-modal touch testing manual
|
||||||
|
- T5 (config split): breaking API change, mitigare con typealias + deprecated factory
|
||||||
|
|
||||||
|
## Verification commands
|
||||||
|
```bash
|
||||||
|
./gradlew :chart-realtime:apiCheck
|
||||||
|
./gradlew :chart-realtime:iosSimulatorArm64Test
|
||||||
|
./gradlew :app:installDebug # manual interaction test
|
||||||
|
./gradlew :chart-realtime:assembleRelease
|
||||||
|
```
|
||||||
169
.paul/phases/v1.0.0-public-release-plan.md
Normal file
169
.paul/phases/v1.0.0-public-release-plan.md
Normal file
|
|
@ -0,0 +1,169 @@
|
||||||
|
# v1.0.0 — Public Release Plan
|
||||||
|
|
||||||
|
## Source
|
||||||
|
Action plan 2026-05-21. Fase 4 "Marketing portfolio".
|
||||||
|
|
||||||
|
## Goal
|
||||||
|
Portare `chart-realtime` da private repo a libreria pubblica consumibile + portfolio piece. Maven Central publish, CI, demo iOS, benchmark numerici vs competitors, README professionale.
|
||||||
|
|
||||||
|
## Prereq
|
||||||
|
v0.4.0 + v0.5.0 shipped.
|
||||||
|
|
||||||
|
## Scope IN
|
||||||
|
- Maven Central / GitHub Packages publishing
|
||||||
|
- GitHub Actions CI (Android + iOS)
|
||||||
|
- SwiftUI demo app consuming XCFramework
|
||||||
|
- Benchmark vs Vico, KoalaPlot, MPAndroidChart numeri reali
|
||||||
|
- README professionale: screenshot/GIF, badge, limitazioni oneste
|
||||||
|
- CHANGELOG.md, CONTRIBUTING.md
|
||||||
|
|
||||||
|
## Scope OUT
|
||||||
|
- CocoaPods publication → backlog
|
||||||
|
- SPM (Swift Package Manager) → backlog
|
||||||
|
- Wasm/desktop targets → backlog
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Tasks
|
||||||
|
|
||||||
|
### T1 — Maven Central publishing
|
||||||
|
- Files: `chart-realtime/build.gradle.kts`, root `build.gradle.kts`, `gradle/libs.versions.toml`
|
||||||
|
- Action:
|
||||||
|
- Sonatype OSSRH account setup (manual, user side)
|
||||||
|
- Plugin `com.vanniktech.maven.publish` (modern Maven Central plugin)
|
||||||
|
- POM metadata: name, description, url, licenses, developers, scm
|
||||||
|
- GPG signing
|
||||||
|
- `dev.dtrentin:chart-realtime:1.0.0` published per Android AAR + iOS klibs + KMP metadata
|
||||||
|
- Agent: gradle-expert
|
||||||
|
- Verify: `./gradlew :chart-realtime:publishToMavenCentral` succeed
|
||||||
|
- User action: registrare dev.dtrentin namespace su Sonatype OSSRH, fornire GPG key
|
||||||
|
|
||||||
|
### T2 — GitHub Actions CI (Android + iOS)
|
||||||
|
- New files:
|
||||||
|
- `.github/workflows/ci.yml`
|
||||||
|
- `.github/workflows/release.yml`
|
||||||
|
- Action:
|
||||||
|
- PR: `assembleDebug` + `testReleaseUnitTest` + `iosSimulatorArm64Test` su macos-latest runner
|
||||||
|
- Push master: above + `assembleChartRealtimeXCFramework`
|
||||||
|
- Tag v* : publish to Maven Central + GitHub release con XCFramework artifact
|
||||||
|
- Caching gradle + konan
|
||||||
|
- Agent: gradle-expert
|
||||||
|
- Verify: PR mostra CI green badge, push tag triggera release
|
||||||
|
- Pattern: [Vico CI workflow](https://github.com/patrykandpatrick/vico/tree/master/.github/workflows)
|
||||||
|
|
||||||
|
### T3 — SwiftUI demo iOS app
|
||||||
|
- New dir: `samples/ios/`
|
||||||
|
- Action:
|
||||||
|
- Xcode project consuming `ChartRealtime.xcframework` da maven local (sviluppo) o CocoaPods/SPM (release)
|
||||||
|
- SwiftUI view che embedding compose RealtimeChart via `UIKitView`
|
||||||
|
- Demo: 4 segnali fake (sine, square, noise, triangle) a 200Hz
|
||||||
|
- Pinch/pan/crosshair test reale
|
||||||
|
- Agent: ui-impl (manual + scripted)
|
||||||
|
- Verify: app gira su iPhone simulator, 60fps, no crash
|
||||||
|
- Justification: senza demo iOS reale "iOS targets" claim è solo build artifact
|
||||||
|
|
||||||
|
### T4 — Benchmark vs competitors
|
||||||
|
- New files:
|
||||||
|
- `benchmark/build.gradle.kts` (modulo separato)
|
||||||
|
- `benchmark/src/main/kotlin/.../BufferBench.kt` (microbench JMH)
|
||||||
|
- `benchmark/src/main/kotlin/.../RenderBench.kt` (androidx.benchmark macrobench)
|
||||||
|
- `benchmark/RESULTS.md`
|
||||||
|
- Comparativi:
|
||||||
|
- Push throughput: chart-realtime vs Vico vs KoalaPlot vs MPAndroidChart
|
||||||
|
- Frame time 4×200Hz × 60s sustained
|
||||||
|
- Memory steady-state dopo 30 min
|
||||||
|
- Agent: mobile-performance-reviewer
|
||||||
|
- Verify: numeri pubblicati su `benchmark/RESULTS.md`, embedded in README
|
||||||
|
- Onesto: se chart-realtime perde, dichiararlo. "Library wins at sustained 200Hz multi-signal; loses at static dataset rendering vs Vico."
|
||||||
|
|
||||||
|
### T5 — README professionale
|
||||||
|
- File: `chart-realtime/README.md` (rewrite)
|
||||||
|
- Sections:
|
||||||
|
- Banner GIF (chart real-time animato 8 segnali — screen record da demo)
|
||||||
|
- Badges: Maven Central, CI build, license, Kotlin version, Compose version
|
||||||
|
- One-line pitch: "Real-time line chart per Compose Multiplatform, ottimizzato per sensor data 200Hz+ multi-signal"
|
||||||
|
- Why exists (gap nel mercato KMP charts)
|
||||||
|
- Quick start (gradle dep + 20 LoC example)
|
||||||
|
- Architecture diagram (TieredBuffer + LodStrategy + interaction state)
|
||||||
|
- Performance numbers (benchmark.md link)
|
||||||
|
- Limitations (onestamente: no multi-Y, no log scale, line-only)
|
||||||
|
- Comparison table vs Vico/KoalaPlot
|
||||||
|
- Roadmap
|
||||||
|
- License
|
||||||
|
- Agent: manager direct (markdown)
|
||||||
|
- Verify: rendered su GitHub mostra GIF, badge verdi
|
||||||
|
|
||||||
|
### T6 — CHANGELOG + CONTRIBUTING + CODE_OF_CONDUCT
|
||||||
|
- New files:
|
||||||
|
- `CHANGELOG.md` — Keep-a-changelog format, retroactive entries v0.1-v0.5
|
||||||
|
- `CONTRIBUTING.md` — how to build, test, submit PR, code style
|
||||||
|
- `CODE_OF_CONDUCT.md` — Contributor Covenant v2.1
|
||||||
|
- Agent: manager direct
|
||||||
|
- Verify: GitHub mostra "Insights → Community Standards" all checkmarks
|
||||||
|
|
||||||
|
### T7 — Logo / asset visuale
|
||||||
|
- New file: `docs/logo.svg`, `docs/banner.png`, `docs/demo.gif`
|
||||||
|
- Action: logo minimale (single signal sine wave + "ChartRealtime" wordmark). Demo GIF da SwiftUI app o screen recording Android.
|
||||||
|
- Agent: manager direct (user provides assets or generates with tool)
|
||||||
|
- Verify: embedded in README, mostra correttamente su GitHub
|
||||||
|
|
||||||
|
### T8 — Sample Android app polish
|
||||||
|
- File: `app/src/main/kotlin/.../MainActivity.kt`
|
||||||
|
- Action: aggiungi UI controls (slider per Hz, picker per # signals, toggle pan/zoom), make it portfolio-grade demo not just sandbox
|
||||||
|
- Agent: ui-impl
|
||||||
|
- Verify: app installa, dimostrazione visiva clean del library capability
|
||||||
|
|
||||||
|
### T9 — Performance budget docs
|
||||||
|
- File: `docs/PERFORMANCE.md`
|
||||||
|
- Content: "Frame budget per 200Hz × N signals su Pixel 6 / iPhone 13", "Memory cost per signal", "Allocation tracking results", "Battery impact su 1h sessione".
|
||||||
|
- Source: benchmark dati T4.
|
||||||
|
- Agent: manager direct
|
||||||
|
- Verify: claim README sono backed by numeri qui
|
||||||
|
|
||||||
|
### T10 — Tag v1.0.0 + GitHub release
|
||||||
|
- Action manuale:
|
||||||
|
- Git tag `v1.0.0`, push
|
||||||
|
- CI release workflow triggers Maven publish
|
||||||
|
- GitHub release con XCFramework + AAR artifact attachments
|
||||||
|
- Release notes from CHANGELOG.md v1.0.0 section
|
||||||
|
- Agent: manager direct (git ops)
|
||||||
|
- Verify: Maven Central search shows `dev.dtrentin:chart-realtime:1.0.0`, GitHub release page populated
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Acceptance v1.0.0
|
||||||
|
|
||||||
|
- A1: `dev.dtrentin:chart-realtime:1.0.0` consumibile via `implementation("dev.dtrentin:chart-realtime:1.0.0")` da progetto esterno (Android)
|
||||||
|
- A2: XCFramework consumibile da SwiftUI demo app (zip artifact in release page)
|
||||||
|
- A3: CI green su PR + tag triggers Maven publish
|
||||||
|
- A4: README ha GIF + 5 badge verdi + benchmark numeri
|
||||||
|
- A5: Benchmark `benchmark/RESULTS.md` confronta vs almeno Vico + KoalaPlot
|
||||||
|
- A6: SwiftUI iOS demo app gira reale, 60fps
|
||||||
|
- A7: GitHub Community Standards 100% (LICENSE, README, CONTRIBUTING, CoC, CHANGELOG)
|
||||||
|
- A8: GitHub release v1.0.0 con artifact attachments
|
||||||
|
|
||||||
|
## Parallelism
|
||||||
|
| Group | Tasks |
|
||||||
|
|-------|-------|
|
||||||
|
| P0 | T1 (Maven setup) |
|
||||||
|
| P1 | T2 (CI), T4 (benchmark) parallel |
|
||||||
|
| P2 | T3 (SwiftUI demo), T8 (Android demo polish) parallel |
|
||||||
|
| P3 | T5 (README), T6 (CHANGELOG etc), T9 (perf docs) parallel |
|
||||||
|
| P4 | T7 (assets) |
|
||||||
|
| P5 | T10 (release, manual) |
|
||||||
|
|
||||||
|
## Estimated agent calls
|
||||||
|
~10 agent calls + manual ops. ~2-3 giorni full-time.
|
||||||
|
|
||||||
|
## Risks
|
||||||
|
- Sonatype OSSRH account approval può richiedere giorni
|
||||||
|
- SwiftUI demo richiede Xcode skill non automatizzabili
|
||||||
|
- Maven Central namespace `dev.dtrentin` deve essere claimed via DNS TXT record o GitHub ownership proof
|
||||||
|
|
||||||
|
## Verification commands
|
||||||
|
```bash
|
||||||
|
./gradlew :chart-realtime:publishToMavenCentral --dry-run
|
||||||
|
gh workflow run ci.yml
|
||||||
|
xcodebuild -project samples/ios/ChartRealtimeDemo.xcodeproj test
|
||||||
|
gh release create v1.0.0 chart-realtime/build/XCFrameworks/release/ChartRealtime.xcframework.zip --notes-from-tag
|
||||||
|
```
|
||||||
21
LICENSE
Normal file
21
LICENSE
Normal file
|
|
@ -0,0 +1,21 @@
|
||||||
|
MIT License
|
||||||
|
|
||||||
|
Copyright (c) 2026 Davide Trentin
|
||||||
|
|
||||||
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||||
|
of this software and associated documentation files (the "Software"), to deal
|
||||||
|
in the Software without restriction, including without limitation the rights
|
||||||
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||||
|
copies of the Software, and to permit persons to whom the Software is
|
||||||
|
furnished to do so, subject to the following conditions:
|
||||||
|
|
||||||
|
The above copyright notice and this permission notice shall be included in all
|
||||||
|
copies or substantial portions of the Software.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||||
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||||
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||||
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||||
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||||
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||||
|
SOFTWARE.
|
||||||
|
|
@ -42,7 +42,6 @@ fun DemoScreen() {
|
||||||
config = ChartConfig(
|
config = ChartConfig(
|
||||||
xWindowSeconds = 10f,
|
xWindowSeconds = 10f,
|
||||||
yRange = YRange.Auto(),
|
yRange = YRange.Auto(),
|
||||||
maxBufferSeconds = 3600f,
|
|
||||||
),
|
),
|
||||||
).apply {
|
).apply {
|
||||||
addSignal("sin", SignalConfig(color = Color(0xFF6750A4)))
|
addSignal("sin", SignalConfig(color = Color(0xFF6750A4)))
|
||||||
|
|
|
||||||
|
|
@ -1,3 +1,5 @@
|
||||||
|
import kotlinx.validation.ExperimentalBCVApi
|
||||||
|
|
||||||
plugins {
|
plugins {
|
||||||
alias(libs.plugins.kotlin.multiplatform) apply false
|
alias(libs.plugins.kotlin.multiplatform) apply false
|
||||||
alias(libs.plugins.kotlin.android) apply false
|
alias(libs.plugins.kotlin.android) apply false
|
||||||
|
|
@ -5,4 +7,14 @@ plugins {
|
||||||
alias(libs.plugins.compose.compiler) apply false
|
alias(libs.plugins.compose.compiler) apply false
|
||||||
alias(libs.plugins.android.library) apply false
|
alias(libs.plugins.android.library) apply false
|
||||||
alias(libs.plugins.android.application) apply false
|
alias(libs.plugins.android.application) apply false
|
||||||
|
alias(libs.plugins.kotlinx.bcv)
|
||||||
|
}
|
||||||
|
|
||||||
|
apiValidation {
|
||||||
|
ignoredProjects += listOf("app")
|
||||||
|
|
||||||
|
@OptIn(ExperimentalBCVApi::class)
|
||||||
|
klib {
|
||||||
|
enabled = true
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -49,7 +49,6 @@ ChartConfig(
|
||||||
yRange = YRange.Auto(), // or YRange.Fixed(-1f, 1f)
|
yRange = YRange.Auto(), // or YRange.Fixed(-1f, 1f)
|
||||||
t0 = T0.FirstSample, // or T0.Fixed(epochMs)
|
t0 = T0.FirstSample, // or T0.Fixed(epochMs)
|
||||||
targetFps = 30, // default 30 fps; null = max display refresh rate
|
targetFps = 30, // default 30 fps; null = max display refresh rate
|
||||||
maxBufferSeconds = 3600f, // 1h history per signal
|
|
||||||
theme = ChartTheme( // optional visual override
|
theme = ChartTheme( // optional visual override
|
||||||
backgroundColor = Color(0xFF1A1A2E),
|
backgroundColor = Color(0xFF1A1A2E),
|
||||||
gridColor = Color(0x22FFFFFF),
|
gridColor = Color(0x22FFFFFF),
|
||||||
|
|
@ -95,7 +94,7 @@ state.collectFrom("ecg", ecgFlow, viewModelScope) // ecgFlow emits (timestampMs
|
||||||
## Performance notes
|
## Performance notes
|
||||||
|
|
||||||
- Data thread pushes at any rate; render thread reads at `targetFps` (default 30) or display refresh if null
|
- Data thread pushes at any rate; render thread reads at `targetFps` (default 30) or display refresh if null
|
||||||
- Buffer sized to `maxBufferSeconds × 1000 samples/s` per signal
|
- TieredBuffer keeps ~1h history per signal (3-tier ring, no caller config)
|
||||||
- LoD decimation reduces >pixel-count data to min/max per pixel column
|
- LoD decimation reduces >pixel-count data to min/max per pixel column
|
||||||
- Pre-allocated arrays — zero GC on hot render path (except LoD scratch, see TODO in `LodDecimator.kt`)
|
- Pre-allocated arrays — zero GC on hot render path (except LoD scratch, see TODO in `LodDecimator.kt`)
|
||||||
- Dirty-flag skips canvas draw when buffer unchanged since last frame
|
- Dirty-flag skips canvas draw when buffer unchanged since last frame
|
||||||
|
|
@ -105,3 +104,7 @@ state.collectFrom("ecg", ecgFlow, viewModelScope) // ecgFlow emits (timestampMs
|
||||||
- Android minSdk 26
|
- Android minSdk 26
|
||||||
- Jetpack Compose / Compose Multiplatform 1.8+
|
- Jetpack Compose / Compose Multiplatform 1.8+
|
||||||
- Kotlin 2.1+
|
- Kotlin 2.1+
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
MIT License — see [LICENSE](../LICENSE).
|
||||||
|
|
|
||||||
161
chart-realtime/api/chart-realtime.api
Normal file
161
chart-realtime/api/chart-realtime.api
Normal file
|
|
@ -0,0 +1,161 @@
|
||||||
|
public final class dev/dtrentin/chart/RealtimeChartKt {
|
||||||
|
public static final fun RealtimeChart (Ldev/dtrentin/chart/RealtimeChartState;Landroidx/compose/ui/Modifier;FLdev/dtrentin/chart/model/ChartTheme;Landroidx/compose/runtime/Composer;II)V
|
||||||
|
}
|
||||||
|
|
||||||
|
public final class dev/dtrentin/chart/RealtimeChartState {
|
||||||
|
public static final field $stable I
|
||||||
|
public fun <init> ()V
|
||||||
|
public fun <init> (Ldev/dtrentin/chart/model/ChartConfig;)V
|
||||||
|
public synthetic fun <init> (Ldev/dtrentin/chart/model/ChartConfig;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
|
||||||
|
public final fun addSignal (Ljava/lang/String;Ldev/dtrentin/chart/model/SignalConfig;)V
|
||||||
|
public final fun collectFromFloat (Ljava/lang/String;Lkotlinx/coroutines/flow/Flow;Lkotlinx/coroutines/CoroutineScope;)Lkotlinx/coroutines/Job;
|
||||||
|
public final fun collectFromTimestamped (Ljava/lang/String;Lkotlinx/coroutines/flow/Flow;Lkotlinx/coroutines/CoroutineScope;)Lkotlinx/coroutines/Job;
|
||||||
|
public final fun getConfig ()Ldev/dtrentin/chart/model/ChartConfig;
|
||||||
|
public final fun push (Ljava/lang/String;JF)V
|
||||||
|
public final fun removeSignal (Ljava/lang/String;)V
|
||||||
|
}
|
||||||
|
|
||||||
|
public final class dev/dtrentin/chart/model/AxisLabelMode : java/lang/Enum {
|
||||||
|
public static final field BESIDE Ldev/dtrentin/chart/model/AxisLabelMode;
|
||||||
|
public static final field HIDDEN Ldev/dtrentin/chart/model/AxisLabelMode;
|
||||||
|
public static final field INSIDE Ldev/dtrentin/chart/model/AxisLabelMode;
|
||||||
|
public static fun getEntries ()Lkotlin/enums/EnumEntries;
|
||||||
|
public static fun valueOf (Ljava/lang/String;)Ldev/dtrentin/chart/model/AxisLabelMode;
|
||||||
|
public static fun values ()[Ldev/dtrentin/chart/model/AxisLabelMode;
|
||||||
|
}
|
||||||
|
|
||||||
|
public final class dev/dtrentin/chart/model/ChartConfig {
|
||||||
|
public static final field $stable I
|
||||||
|
public fun <init> ()V
|
||||||
|
public fun <init> (FLdev/dtrentin/chart/model/YRange;Ldev/dtrentin/chart/model/T0;Ljava/lang/Integer;Ldev/dtrentin/chart/model/ChartTheme;ZLdev/dtrentin/chart/model/AxisLabelMode;Ldev/dtrentin/chart/model/AxisLabelMode;ILdev/dtrentin/chart/model/LodMode;)V
|
||||||
|
public synthetic fun <init> (FLdev/dtrentin/chart/model/YRange;Ldev/dtrentin/chart/model/T0;Ljava/lang/Integer;Ldev/dtrentin/chart/model/ChartTheme;ZLdev/dtrentin/chart/model/AxisLabelMode;Ldev/dtrentin/chart/model/AxisLabelMode;ILdev/dtrentin/chart/model/LodMode;ILkotlin/jvm/internal/DefaultConstructorMarker;)V
|
||||||
|
public final fun component1 ()F
|
||||||
|
public final fun component10 ()Ldev/dtrentin/chart/model/LodMode;
|
||||||
|
public final fun component2 ()Ldev/dtrentin/chart/model/YRange;
|
||||||
|
public final fun component3 ()Ldev/dtrentin/chart/model/T0;
|
||||||
|
public final fun component4 ()Ljava/lang/Integer;
|
||||||
|
public final fun component5 ()Ldev/dtrentin/chart/model/ChartTheme;
|
||||||
|
public final fun component6 ()Z
|
||||||
|
public final fun component7 ()Ldev/dtrentin/chart/model/AxisLabelMode;
|
||||||
|
public final fun component8 ()Ldev/dtrentin/chart/model/AxisLabelMode;
|
||||||
|
public final fun component9 ()I
|
||||||
|
public final fun copy (FLdev/dtrentin/chart/model/YRange;Ldev/dtrentin/chart/model/T0;Ljava/lang/Integer;Ldev/dtrentin/chart/model/ChartTheme;ZLdev/dtrentin/chart/model/AxisLabelMode;Ldev/dtrentin/chart/model/AxisLabelMode;ILdev/dtrentin/chart/model/LodMode;)Ldev/dtrentin/chart/model/ChartConfig;
|
||||||
|
public static synthetic fun copy$default (Ldev/dtrentin/chart/model/ChartConfig;FLdev/dtrentin/chart/model/YRange;Ldev/dtrentin/chart/model/T0;Ljava/lang/Integer;Ldev/dtrentin/chart/model/ChartTheme;ZLdev/dtrentin/chart/model/AxisLabelMode;Ldev/dtrentin/chart/model/AxisLabelMode;ILdev/dtrentin/chart/model/LodMode;ILjava/lang/Object;)Ldev/dtrentin/chart/model/ChartConfig;
|
||||||
|
public fun equals (Ljava/lang/Object;)Z
|
||||||
|
public final fun getLodMode ()Ldev/dtrentin/chart/model/LodMode;
|
||||||
|
public final fun getShowGrid ()Z
|
||||||
|
public final fun getT0 ()Ldev/dtrentin/chart/model/T0;
|
||||||
|
public final fun getTargetFps ()Ljava/lang/Integer;
|
||||||
|
public final fun getTheme ()Ldev/dtrentin/chart/model/ChartTheme;
|
||||||
|
public final fun getXLabelMode ()Ldev/dtrentin/chart/model/AxisLabelMode;
|
||||||
|
public final fun getXWindowSeconds ()F
|
||||||
|
public final fun getYLabelDecimals ()I
|
||||||
|
public final fun getYLabelMode ()Ldev/dtrentin/chart/model/AxisLabelMode;
|
||||||
|
public final fun getYRange ()Ldev/dtrentin/chart/model/YRange;
|
||||||
|
public fun hashCode ()I
|
||||||
|
public fun toString ()Ljava/lang/String;
|
||||||
|
}
|
||||||
|
|
||||||
|
public final class dev/dtrentin/chart/model/ChartTheme {
|
||||||
|
public static final field $stable I
|
||||||
|
public synthetic fun <init> (JJJJFILkotlin/jvm/internal/DefaultConstructorMarker;)V
|
||||||
|
public synthetic fun <init> (JJJJFLkotlin/jvm/internal/DefaultConstructorMarker;)V
|
||||||
|
public final fun component1-0d7_KjU ()J
|
||||||
|
public final fun component2-0d7_KjU ()J
|
||||||
|
public final fun component3-0d7_KjU ()J
|
||||||
|
public final fun component4-0d7_KjU ()J
|
||||||
|
public final fun component5 ()F
|
||||||
|
public final fun copy-gPfMexM (JJJJF)Ldev/dtrentin/chart/model/ChartTheme;
|
||||||
|
public static synthetic fun copy-gPfMexM$default (Ldev/dtrentin/chart/model/ChartTheme;JJJJFILjava/lang/Object;)Ldev/dtrentin/chart/model/ChartTheme;
|
||||||
|
public fun equals (Ljava/lang/Object;)Z
|
||||||
|
public final fun getAxisColor-0d7_KjU ()J
|
||||||
|
public final fun getBackgroundColor-0d7_KjU ()J
|
||||||
|
public final fun getGridColor-0d7_KjU ()J
|
||||||
|
public final fun getLabelColor-0d7_KjU ()J
|
||||||
|
public final fun getStrokeWidth ()F
|
||||||
|
public fun hashCode ()I
|
||||||
|
public fun toString ()Ljava/lang/String;
|
||||||
|
}
|
||||||
|
|
||||||
|
public final class dev/dtrentin/chart/model/ChartThemeKt {
|
||||||
|
public static final fun rememberMaterialChartTheme (Landroidx/compose/runtime/Composer;I)Ldev/dtrentin/chart/model/ChartTheme;
|
||||||
|
}
|
||||||
|
|
||||||
|
public final class dev/dtrentin/chart/model/LodMode : java/lang/Enum {
|
||||||
|
public static final field LTTB Ldev/dtrentin/chart/model/LodMode;
|
||||||
|
public static final field MIN_MAX Ldev/dtrentin/chart/model/LodMode;
|
||||||
|
public static fun getEntries ()Lkotlin/enums/EnumEntries;
|
||||||
|
public static fun valueOf (Ljava/lang/String;)Ldev/dtrentin/chart/model/LodMode;
|
||||||
|
public static fun values ()[Ldev/dtrentin/chart/model/LodMode;
|
||||||
|
}
|
||||||
|
|
||||||
|
public final class dev/dtrentin/chart/model/SignalConfig {
|
||||||
|
public static final field $stable I
|
||||||
|
public synthetic fun <init> (JFZILkotlin/jvm/internal/DefaultConstructorMarker;)V
|
||||||
|
public synthetic fun <init> (JFZLkotlin/jvm/internal/DefaultConstructorMarker;)V
|
||||||
|
public final fun component1-0d7_KjU ()J
|
||||||
|
public final fun component2 ()F
|
||||||
|
public final fun component3 ()Z
|
||||||
|
public final fun copy-ek8zF_U (JFZ)Ldev/dtrentin/chart/model/SignalConfig;
|
||||||
|
public static synthetic fun copy-ek8zF_U$default (Ldev/dtrentin/chart/model/SignalConfig;JFZILjava/lang/Object;)Ldev/dtrentin/chart/model/SignalConfig;
|
||||||
|
public fun equals (Ljava/lang/Object;)Z
|
||||||
|
public final fun getColor-0d7_KjU ()J
|
||||||
|
public final fun getStrokeWidth ()F
|
||||||
|
public final fun getVisible ()Z
|
||||||
|
public fun hashCode ()I
|
||||||
|
public fun toString ()Ljava/lang/String;
|
||||||
|
}
|
||||||
|
|
||||||
|
public abstract class dev/dtrentin/chart/model/T0 {
|
||||||
|
public static final field $stable I
|
||||||
|
}
|
||||||
|
|
||||||
|
public final class dev/dtrentin/chart/model/T0$FirstSample : dev/dtrentin/chart/model/T0 {
|
||||||
|
public static final field $stable I
|
||||||
|
public static final field INSTANCE Ldev/dtrentin/chart/model/T0$FirstSample;
|
||||||
|
}
|
||||||
|
|
||||||
|
public final class dev/dtrentin/chart/model/T0$Fixed : dev/dtrentin/chart/model/T0 {
|
||||||
|
public static final field $stable I
|
||||||
|
public fun <init> (J)V
|
||||||
|
public final fun component1 ()J
|
||||||
|
public final fun copy (J)Ldev/dtrentin/chart/model/T0$Fixed;
|
||||||
|
public static synthetic fun copy$default (Ldev/dtrentin/chart/model/T0$Fixed;JILjava/lang/Object;)Ldev/dtrentin/chart/model/T0$Fixed;
|
||||||
|
public fun equals (Ljava/lang/Object;)Z
|
||||||
|
public final fun getEpochMs ()J
|
||||||
|
public fun hashCode ()I
|
||||||
|
public fun toString ()Ljava/lang/String;
|
||||||
|
}
|
||||||
|
|
||||||
|
public abstract class dev/dtrentin/chart/model/YRange {
|
||||||
|
public static final field $stable I
|
||||||
|
}
|
||||||
|
|
||||||
|
public final class dev/dtrentin/chart/model/YRange$Auto : dev/dtrentin/chart/model/YRange {
|
||||||
|
public static final field $stable I
|
||||||
|
public fun <init> ()V
|
||||||
|
public fun <init> (F)V
|
||||||
|
public synthetic fun <init> (FILkotlin/jvm/internal/DefaultConstructorMarker;)V
|
||||||
|
public final fun component1 ()F
|
||||||
|
public final fun copy (F)Ldev/dtrentin/chart/model/YRange$Auto;
|
||||||
|
public static synthetic fun copy$default (Ldev/dtrentin/chart/model/YRange$Auto;FILjava/lang/Object;)Ldev/dtrentin/chart/model/YRange$Auto;
|
||||||
|
public fun equals (Ljava/lang/Object;)Z
|
||||||
|
public final fun getPaddingFraction ()F
|
||||||
|
public fun hashCode ()I
|
||||||
|
public fun toString ()Ljava/lang/String;
|
||||||
|
}
|
||||||
|
|
||||||
|
public final class dev/dtrentin/chart/model/YRange$Fixed : dev/dtrentin/chart/model/YRange {
|
||||||
|
public static final field $stable I
|
||||||
|
public fun <init> (FF)V
|
||||||
|
public final fun component1 ()F
|
||||||
|
public final fun component2 ()F
|
||||||
|
public final fun copy (FF)Ldev/dtrentin/chart/model/YRange$Fixed;
|
||||||
|
public static synthetic fun copy$default (Ldev/dtrentin/chart/model/YRange$Fixed;FFILjava/lang/Object;)Ldev/dtrentin/chart/model/YRange$Fixed;
|
||||||
|
public fun equals (Ljava/lang/Object;)Z
|
||||||
|
public final fun getMax ()F
|
||||||
|
public final fun getMin ()F
|
||||||
|
public fun hashCode ()I
|
||||||
|
public fun toString ()Ljava/lang/String;
|
||||||
|
}
|
||||||
|
|
||||||
213
chart-realtime/api/chart-realtime.klib.api
Normal file
213
chart-realtime/api/chart-realtime.klib.api
Normal file
|
|
@ -0,0 +1,213 @@
|
||||||
|
// Klib ABI Dump
|
||||||
|
// Targets: [iosArm64, iosSimulatorArm64, iosX64]
|
||||||
|
// Rendering settings:
|
||||||
|
// - Signature version: 2
|
||||||
|
// - Show manifest properties: true
|
||||||
|
// - Show declarations: true
|
||||||
|
|
||||||
|
// Library unique name: <dev.dtrentin:chart-realtime>
|
||||||
|
final enum class dev.dtrentin.chart.model/AxisLabelMode : kotlin/Enum<dev.dtrentin.chart.model/AxisLabelMode> { // dev.dtrentin.chart.model/AxisLabelMode|null[0]
|
||||||
|
enum entry BESIDE // dev.dtrentin.chart.model/AxisLabelMode.BESIDE|null[0]
|
||||||
|
enum entry HIDDEN // dev.dtrentin.chart.model/AxisLabelMode.HIDDEN|null[0]
|
||||||
|
enum entry INSIDE // dev.dtrentin.chart.model/AxisLabelMode.INSIDE|null[0]
|
||||||
|
|
||||||
|
final val entries // dev.dtrentin.chart.model/AxisLabelMode.entries|#static{}entries[0]
|
||||||
|
final fun <get-entries>(): kotlin.enums/EnumEntries<dev.dtrentin.chart.model/AxisLabelMode> // dev.dtrentin.chart.model/AxisLabelMode.entries.<get-entries>|<get-entries>#static(){}[0]
|
||||||
|
|
||||||
|
final fun valueOf(kotlin/String): dev.dtrentin.chart.model/AxisLabelMode // dev.dtrentin.chart.model/AxisLabelMode.valueOf|valueOf#static(kotlin.String){}[0]
|
||||||
|
final fun values(): kotlin/Array<dev.dtrentin.chart.model/AxisLabelMode> // dev.dtrentin.chart.model/AxisLabelMode.values|values#static(){}[0]
|
||||||
|
}
|
||||||
|
|
||||||
|
final enum class dev.dtrentin.chart.model/LodMode : kotlin/Enum<dev.dtrentin.chart.model/LodMode> { // dev.dtrentin.chart.model/LodMode|null[0]
|
||||||
|
enum entry LTTB // dev.dtrentin.chart.model/LodMode.LTTB|null[0]
|
||||||
|
enum entry MIN_MAX // dev.dtrentin.chart.model/LodMode.MIN_MAX|null[0]
|
||||||
|
|
||||||
|
final val entries // dev.dtrentin.chart.model/LodMode.entries|#static{}entries[0]
|
||||||
|
final fun <get-entries>(): kotlin.enums/EnumEntries<dev.dtrentin.chart.model/LodMode> // dev.dtrentin.chart.model/LodMode.entries.<get-entries>|<get-entries>#static(){}[0]
|
||||||
|
|
||||||
|
final fun valueOf(kotlin/String): dev.dtrentin.chart.model/LodMode // dev.dtrentin.chart.model/LodMode.valueOf|valueOf#static(kotlin.String){}[0]
|
||||||
|
final fun values(): kotlin/Array<dev.dtrentin.chart.model/LodMode> // dev.dtrentin.chart.model/LodMode.values|values#static(){}[0]
|
||||||
|
}
|
||||||
|
|
||||||
|
final class dev.dtrentin.chart.model/ChartConfig { // dev.dtrentin.chart.model/ChartConfig|null[0]
|
||||||
|
constructor <init>(kotlin/Float = ..., dev.dtrentin.chart.model/YRange = ..., dev.dtrentin.chart.model/T0 = ..., kotlin/Int? = ..., dev.dtrentin.chart.model/ChartTheme = ..., kotlin/Boolean = ..., dev.dtrentin.chart.model/AxisLabelMode = ..., dev.dtrentin.chart.model/AxisLabelMode = ..., kotlin/Int = ..., dev.dtrentin.chart.model/LodMode = ...) // dev.dtrentin.chart.model/ChartConfig.<init>|<init>(kotlin.Float;dev.dtrentin.chart.model.YRange;dev.dtrentin.chart.model.T0;kotlin.Int?;dev.dtrentin.chart.model.ChartTheme;kotlin.Boolean;dev.dtrentin.chart.model.AxisLabelMode;dev.dtrentin.chart.model.AxisLabelMode;kotlin.Int;dev.dtrentin.chart.model.LodMode){}[0]
|
||||||
|
|
||||||
|
final val lodMode // dev.dtrentin.chart.model/ChartConfig.lodMode|{}lodMode[0]
|
||||||
|
final fun <get-lodMode>(): dev.dtrentin.chart.model/LodMode // dev.dtrentin.chart.model/ChartConfig.lodMode.<get-lodMode>|<get-lodMode>(){}[0]
|
||||||
|
final val showGrid // dev.dtrentin.chart.model/ChartConfig.showGrid|{}showGrid[0]
|
||||||
|
final fun <get-showGrid>(): kotlin/Boolean // dev.dtrentin.chart.model/ChartConfig.showGrid.<get-showGrid>|<get-showGrid>(){}[0]
|
||||||
|
final val t0 // dev.dtrentin.chart.model/ChartConfig.t0|{}t0[0]
|
||||||
|
final fun <get-t0>(): dev.dtrentin.chart.model/T0 // dev.dtrentin.chart.model/ChartConfig.t0.<get-t0>|<get-t0>(){}[0]
|
||||||
|
final val targetFps // dev.dtrentin.chart.model/ChartConfig.targetFps|{}targetFps[0]
|
||||||
|
final fun <get-targetFps>(): kotlin/Int? // dev.dtrentin.chart.model/ChartConfig.targetFps.<get-targetFps>|<get-targetFps>(){}[0]
|
||||||
|
final val theme // dev.dtrentin.chart.model/ChartConfig.theme|{}theme[0]
|
||||||
|
final fun <get-theme>(): dev.dtrentin.chart.model/ChartTheme // dev.dtrentin.chart.model/ChartConfig.theme.<get-theme>|<get-theme>(){}[0]
|
||||||
|
final val xLabelMode // dev.dtrentin.chart.model/ChartConfig.xLabelMode|{}xLabelMode[0]
|
||||||
|
final fun <get-xLabelMode>(): dev.dtrentin.chart.model/AxisLabelMode // dev.dtrentin.chart.model/ChartConfig.xLabelMode.<get-xLabelMode>|<get-xLabelMode>(){}[0]
|
||||||
|
final val xWindowSeconds // dev.dtrentin.chart.model/ChartConfig.xWindowSeconds|{}xWindowSeconds[0]
|
||||||
|
final fun <get-xWindowSeconds>(): kotlin/Float // dev.dtrentin.chart.model/ChartConfig.xWindowSeconds.<get-xWindowSeconds>|<get-xWindowSeconds>(){}[0]
|
||||||
|
final val yLabelDecimals // dev.dtrentin.chart.model/ChartConfig.yLabelDecimals|{}yLabelDecimals[0]
|
||||||
|
final fun <get-yLabelDecimals>(): kotlin/Int // dev.dtrentin.chart.model/ChartConfig.yLabelDecimals.<get-yLabelDecimals>|<get-yLabelDecimals>(){}[0]
|
||||||
|
final val yLabelMode // dev.dtrentin.chart.model/ChartConfig.yLabelMode|{}yLabelMode[0]
|
||||||
|
final fun <get-yLabelMode>(): dev.dtrentin.chart.model/AxisLabelMode // dev.dtrentin.chart.model/ChartConfig.yLabelMode.<get-yLabelMode>|<get-yLabelMode>(){}[0]
|
||||||
|
final val yRange // dev.dtrentin.chart.model/ChartConfig.yRange|{}yRange[0]
|
||||||
|
final fun <get-yRange>(): dev.dtrentin.chart.model/YRange // dev.dtrentin.chart.model/ChartConfig.yRange.<get-yRange>|<get-yRange>(){}[0]
|
||||||
|
|
||||||
|
final fun component1(): kotlin/Float // dev.dtrentin.chart.model/ChartConfig.component1|component1(){}[0]
|
||||||
|
final fun component10(): dev.dtrentin.chart.model/LodMode // dev.dtrentin.chart.model/ChartConfig.component10|component10(){}[0]
|
||||||
|
final fun component2(): dev.dtrentin.chart.model/YRange // dev.dtrentin.chart.model/ChartConfig.component2|component2(){}[0]
|
||||||
|
final fun component3(): dev.dtrentin.chart.model/T0 // dev.dtrentin.chart.model/ChartConfig.component3|component3(){}[0]
|
||||||
|
final fun component4(): kotlin/Int? // dev.dtrentin.chart.model/ChartConfig.component4|component4(){}[0]
|
||||||
|
final fun component5(): dev.dtrentin.chart.model/ChartTheme // dev.dtrentin.chart.model/ChartConfig.component5|component5(){}[0]
|
||||||
|
final fun component6(): kotlin/Boolean // dev.dtrentin.chart.model/ChartConfig.component6|component6(){}[0]
|
||||||
|
final fun component7(): dev.dtrentin.chart.model/AxisLabelMode // dev.dtrentin.chart.model/ChartConfig.component7|component7(){}[0]
|
||||||
|
final fun component8(): dev.dtrentin.chart.model/AxisLabelMode // dev.dtrentin.chart.model/ChartConfig.component8|component8(){}[0]
|
||||||
|
final fun component9(): kotlin/Int // dev.dtrentin.chart.model/ChartConfig.component9|component9(){}[0]
|
||||||
|
final fun copy(kotlin/Float = ..., dev.dtrentin.chart.model/YRange = ..., dev.dtrentin.chart.model/T0 = ..., kotlin/Int? = ..., dev.dtrentin.chart.model/ChartTheme = ..., kotlin/Boolean = ..., dev.dtrentin.chart.model/AxisLabelMode = ..., dev.dtrentin.chart.model/AxisLabelMode = ..., kotlin/Int = ..., dev.dtrentin.chart.model/LodMode = ...): dev.dtrentin.chart.model/ChartConfig // dev.dtrentin.chart.model/ChartConfig.copy|copy(kotlin.Float;dev.dtrentin.chart.model.YRange;dev.dtrentin.chart.model.T0;kotlin.Int?;dev.dtrentin.chart.model.ChartTheme;kotlin.Boolean;dev.dtrentin.chart.model.AxisLabelMode;dev.dtrentin.chart.model.AxisLabelMode;kotlin.Int;dev.dtrentin.chart.model.LodMode){}[0]
|
||||||
|
final fun equals(kotlin/Any?): kotlin/Boolean // dev.dtrentin.chart.model/ChartConfig.equals|equals(kotlin.Any?){}[0]
|
||||||
|
final fun hashCode(): kotlin/Int // dev.dtrentin.chart.model/ChartConfig.hashCode|hashCode(){}[0]
|
||||||
|
final fun toString(): kotlin/String // dev.dtrentin.chart.model/ChartConfig.toString|toString(){}[0]
|
||||||
|
}
|
||||||
|
|
||||||
|
final class dev.dtrentin.chart.model/ChartTheme { // dev.dtrentin.chart.model/ChartTheme|null[0]
|
||||||
|
constructor <init>(androidx.compose.ui.graphics/Color = ..., androidx.compose.ui.graphics/Color = ..., androidx.compose.ui.graphics/Color = ..., androidx.compose.ui.graphics/Color = ..., kotlin/Float = ...) // dev.dtrentin.chart.model/ChartTheme.<init>|<init>(androidx.compose.ui.graphics.Color;androidx.compose.ui.graphics.Color;androidx.compose.ui.graphics.Color;androidx.compose.ui.graphics.Color;kotlin.Float){}[0]
|
||||||
|
|
||||||
|
final val axisColor // dev.dtrentin.chart.model/ChartTheme.axisColor|{}axisColor[0]
|
||||||
|
final fun <get-axisColor>(): androidx.compose.ui.graphics/Color // dev.dtrentin.chart.model/ChartTheme.axisColor.<get-axisColor>|<get-axisColor>(){}[0]
|
||||||
|
final val backgroundColor // dev.dtrentin.chart.model/ChartTheme.backgroundColor|{}backgroundColor[0]
|
||||||
|
final fun <get-backgroundColor>(): androidx.compose.ui.graphics/Color // dev.dtrentin.chart.model/ChartTheme.backgroundColor.<get-backgroundColor>|<get-backgroundColor>(){}[0]
|
||||||
|
final val gridColor // dev.dtrentin.chart.model/ChartTheme.gridColor|{}gridColor[0]
|
||||||
|
final fun <get-gridColor>(): androidx.compose.ui.graphics/Color // dev.dtrentin.chart.model/ChartTheme.gridColor.<get-gridColor>|<get-gridColor>(){}[0]
|
||||||
|
final val labelColor // dev.dtrentin.chart.model/ChartTheme.labelColor|{}labelColor[0]
|
||||||
|
final fun <get-labelColor>(): androidx.compose.ui.graphics/Color // dev.dtrentin.chart.model/ChartTheme.labelColor.<get-labelColor>|<get-labelColor>(){}[0]
|
||||||
|
final val strokeWidth // dev.dtrentin.chart.model/ChartTheme.strokeWidth|{}strokeWidth[0]
|
||||||
|
final fun <get-strokeWidth>(): kotlin/Float // dev.dtrentin.chart.model/ChartTheme.strokeWidth.<get-strokeWidth>|<get-strokeWidth>(){}[0]
|
||||||
|
|
||||||
|
final fun component1(): androidx.compose.ui.graphics/Color // dev.dtrentin.chart.model/ChartTheme.component1|component1(){}[0]
|
||||||
|
final fun component2(): androidx.compose.ui.graphics/Color // dev.dtrentin.chart.model/ChartTheme.component2|component2(){}[0]
|
||||||
|
final fun component3(): androidx.compose.ui.graphics/Color // dev.dtrentin.chart.model/ChartTheme.component3|component3(){}[0]
|
||||||
|
final fun component4(): androidx.compose.ui.graphics/Color // dev.dtrentin.chart.model/ChartTheme.component4|component4(){}[0]
|
||||||
|
final fun component5(): kotlin/Float // dev.dtrentin.chart.model/ChartTheme.component5|component5(){}[0]
|
||||||
|
final fun copy(androidx.compose.ui.graphics/Color = ..., androidx.compose.ui.graphics/Color = ..., androidx.compose.ui.graphics/Color = ..., androidx.compose.ui.graphics/Color = ..., kotlin/Float = ...): dev.dtrentin.chart.model/ChartTheme // dev.dtrentin.chart.model/ChartTheme.copy|copy(androidx.compose.ui.graphics.Color;androidx.compose.ui.graphics.Color;androidx.compose.ui.graphics.Color;androidx.compose.ui.graphics.Color;kotlin.Float){}[0]
|
||||||
|
final fun equals(kotlin/Any?): kotlin/Boolean // dev.dtrentin.chart.model/ChartTheme.equals|equals(kotlin.Any?){}[0]
|
||||||
|
final fun hashCode(): kotlin/Int // dev.dtrentin.chart.model/ChartTheme.hashCode|hashCode(){}[0]
|
||||||
|
final fun toString(): kotlin/String // dev.dtrentin.chart.model/ChartTheme.toString|toString(){}[0]
|
||||||
|
}
|
||||||
|
|
||||||
|
final class dev.dtrentin.chart.model/SignalConfig { // dev.dtrentin.chart.model/SignalConfig|null[0]
|
||||||
|
constructor <init>(androidx.compose.ui.graphics/Color, kotlin/Float = ..., kotlin/Boolean = ...) // dev.dtrentin.chart.model/SignalConfig.<init>|<init>(androidx.compose.ui.graphics.Color;kotlin.Float;kotlin.Boolean){}[0]
|
||||||
|
|
||||||
|
final val color // dev.dtrentin.chart.model/SignalConfig.color|{}color[0]
|
||||||
|
final fun <get-color>(): androidx.compose.ui.graphics/Color // dev.dtrentin.chart.model/SignalConfig.color.<get-color>|<get-color>(){}[0]
|
||||||
|
final val strokeWidth // dev.dtrentin.chart.model/SignalConfig.strokeWidth|{}strokeWidth[0]
|
||||||
|
final fun <get-strokeWidth>(): kotlin/Float // dev.dtrentin.chart.model/SignalConfig.strokeWidth.<get-strokeWidth>|<get-strokeWidth>(){}[0]
|
||||||
|
final val visible // dev.dtrentin.chart.model/SignalConfig.visible|{}visible[0]
|
||||||
|
final fun <get-visible>(): kotlin/Boolean // dev.dtrentin.chart.model/SignalConfig.visible.<get-visible>|<get-visible>(){}[0]
|
||||||
|
|
||||||
|
final fun component1(): androidx.compose.ui.graphics/Color // dev.dtrentin.chart.model/SignalConfig.component1|component1(){}[0]
|
||||||
|
final fun component2(): kotlin/Float // dev.dtrentin.chart.model/SignalConfig.component2|component2(){}[0]
|
||||||
|
final fun component3(): kotlin/Boolean // dev.dtrentin.chart.model/SignalConfig.component3|component3(){}[0]
|
||||||
|
final fun copy(androidx.compose.ui.graphics/Color = ..., kotlin/Float = ..., kotlin/Boolean = ...): dev.dtrentin.chart.model/SignalConfig // dev.dtrentin.chart.model/SignalConfig.copy|copy(androidx.compose.ui.graphics.Color;kotlin.Float;kotlin.Boolean){}[0]
|
||||||
|
final fun equals(kotlin/Any?): kotlin/Boolean // dev.dtrentin.chart.model/SignalConfig.equals|equals(kotlin.Any?){}[0]
|
||||||
|
final fun hashCode(): kotlin/Int // dev.dtrentin.chart.model/SignalConfig.hashCode|hashCode(){}[0]
|
||||||
|
final fun toString(): kotlin/String // dev.dtrentin.chart.model/SignalConfig.toString|toString(){}[0]
|
||||||
|
}
|
||||||
|
|
||||||
|
final class dev.dtrentin.chart/RealtimeChartState { // dev.dtrentin.chart/RealtimeChartState|null[0]
|
||||||
|
constructor <init>(dev.dtrentin.chart.model/ChartConfig = ...) // dev.dtrentin.chart/RealtimeChartState.<init>|<init>(dev.dtrentin.chart.model.ChartConfig){}[0]
|
||||||
|
|
||||||
|
final val config // dev.dtrentin.chart/RealtimeChartState.config|{}config[0]
|
||||||
|
final fun <get-config>(): dev.dtrentin.chart.model/ChartConfig // dev.dtrentin.chart/RealtimeChartState.config.<get-config>|<get-config>(){}[0]
|
||||||
|
|
||||||
|
final fun addSignal(kotlin/String, dev.dtrentin.chart.model/SignalConfig) // dev.dtrentin.chart/RealtimeChartState.addSignal|addSignal(kotlin.String;dev.dtrentin.chart.model.SignalConfig){}[0]
|
||||||
|
final fun collectFrom(kotlin/String, kotlinx.coroutines.flow/Flow<kotlin/Float>, kotlinx.coroutines/CoroutineScope): kotlinx.coroutines/Job // dev.dtrentin.chart/RealtimeChartState.collectFrom|collectFrom(kotlin.String;kotlinx.coroutines.flow.Flow<kotlin.Float>;kotlinx.coroutines.CoroutineScope){}[0]
|
||||||
|
final fun collectFrom(kotlin/String, kotlinx.coroutines.flow/Flow<kotlin/Pair<kotlin/Long, kotlin/Float>>, kotlinx.coroutines/CoroutineScope): kotlinx.coroutines/Job // dev.dtrentin.chart/RealtimeChartState.collectFrom|collectFrom(kotlin.String;kotlinx.coroutines.flow.Flow<kotlin.Pair<kotlin.Long,kotlin.Float>>;kotlinx.coroutines.CoroutineScope){}[0]
|
||||||
|
final fun push(kotlin/String, kotlin/Long, kotlin/Float) // dev.dtrentin.chart/RealtimeChartState.push|push(kotlin.String;kotlin.Long;kotlin.Float){}[0]
|
||||||
|
final fun removeSignal(kotlin/String) // dev.dtrentin.chart/RealtimeChartState.removeSignal|removeSignal(kotlin.String){}[0]
|
||||||
|
}
|
||||||
|
|
||||||
|
sealed class dev.dtrentin.chart.model/T0 { // dev.dtrentin.chart.model/T0|null[0]
|
||||||
|
final class Fixed : dev.dtrentin.chart.model/T0 { // dev.dtrentin.chart.model/T0.Fixed|null[0]
|
||||||
|
constructor <init>(kotlin/Long) // dev.dtrentin.chart.model/T0.Fixed.<init>|<init>(kotlin.Long){}[0]
|
||||||
|
|
||||||
|
final val epochMs // dev.dtrentin.chart.model/T0.Fixed.epochMs|{}epochMs[0]
|
||||||
|
final fun <get-epochMs>(): kotlin/Long // dev.dtrentin.chart.model/T0.Fixed.epochMs.<get-epochMs>|<get-epochMs>(){}[0]
|
||||||
|
|
||||||
|
final fun component1(): kotlin/Long // dev.dtrentin.chart.model/T0.Fixed.component1|component1(){}[0]
|
||||||
|
final fun copy(kotlin/Long = ...): dev.dtrentin.chart.model/T0.Fixed // dev.dtrentin.chart.model/T0.Fixed.copy|copy(kotlin.Long){}[0]
|
||||||
|
final fun equals(kotlin/Any?): kotlin/Boolean // dev.dtrentin.chart.model/T0.Fixed.equals|equals(kotlin.Any?){}[0]
|
||||||
|
final fun hashCode(): kotlin/Int // dev.dtrentin.chart.model/T0.Fixed.hashCode|hashCode(){}[0]
|
||||||
|
final fun toString(): kotlin/String // dev.dtrentin.chart.model/T0.Fixed.toString|toString(){}[0]
|
||||||
|
}
|
||||||
|
|
||||||
|
final object FirstSample : dev.dtrentin.chart.model/T0 // dev.dtrentin.chart.model/T0.FirstSample|null[0]
|
||||||
|
}
|
||||||
|
|
||||||
|
sealed class dev.dtrentin.chart.model/YRange { // dev.dtrentin.chart.model/YRange|null[0]
|
||||||
|
final class Auto : dev.dtrentin.chart.model/YRange { // dev.dtrentin.chart.model/YRange.Auto|null[0]
|
||||||
|
constructor <init>(kotlin/Float = ...) // dev.dtrentin.chart.model/YRange.Auto.<init>|<init>(kotlin.Float){}[0]
|
||||||
|
|
||||||
|
final val paddingFraction // dev.dtrentin.chart.model/YRange.Auto.paddingFraction|{}paddingFraction[0]
|
||||||
|
final fun <get-paddingFraction>(): kotlin/Float // dev.dtrentin.chart.model/YRange.Auto.paddingFraction.<get-paddingFraction>|<get-paddingFraction>(){}[0]
|
||||||
|
|
||||||
|
final fun component1(): kotlin/Float // dev.dtrentin.chart.model/YRange.Auto.component1|component1(){}[0]
|
||||||
|
final fun copy(kotlin/Float = ...): dev.dtrentin.chart.model/YRange.Auto // dev.dtrentin.chart.model/YRange.Auto.copy|copy(kotlin.Float){}[0]
|
||||||
|
final fun equals(kotlin/Any?): kotlin/Boolean // dev.dtrentin.chart.model/YRange.Auto.equals|equals(kotlin.Any?){}[0]
|
||||||
|
final fun hashCode(): kotlin/Int // dev.dtrentin.chart.model/YRange.Auto.hashCode|hashCode(){}[0]
|
||||||
|
final fun toString(): kotlin/String // dev.dtrentin.chart.model/YRange.Auto.toString|toString(){}[0]
|
||||||
|
}
|
||||||
|
|
||||||
|
final class Fixed : dev.dtrentin.chart.model/YRange { // dev.dtrentin.chart.model/YRange.Fixed|null[0]
|
||||||
|
constructor <init>(kotlin/Float, kotlin/Float) // dev.dtrentin.chart.model/YRange.Fixed.<init>|<init>(kotlin.Float;kotlin.Float){}[0]
|
||||||
|
|
||||||
|
final val max // dev.dtrentin.chart.model/YRange.Fixed.max|{}max[0]
|
||||||
|
final fun <get-max>(): kotlin/Float // dev.dtrentin.chart.model/YRange.Fixed.max.<get-max>|<get-max>(){}[0]
|
||||||
|
final val min // dev.dtrentin.chart.model/YRange.Fixed.min|{}min[0]
|
||||||
|
final fun <get-min>(): kotlin/Float // dev.dtrentin.chart.model/YRange.Fixed.min.<get-min>|<get-min>(){}[0]
|
||||||
|
|
||||||
|
final fun component1(): kotlin/Float // dev.dtrentin.chart.model/YRange.Fixed.component1|component1(){}[0]
|
||||||
|
final fun component2(): kotlin/Float // dev.dtrentin.chart.model/YRange.Fixed.component2|component2(){}[0]
|
||||||
|
final fun copy(kotlin/Float = ..., kotlin/Float = ...): dev.dtrentin.chart.model/YRange.Fixed // dev.dtrentin.chart.model/YRange.Fixed.copy|copy(kotlin.Float;kotlin.Float){}[0]
|
||||||
|
final fun equals(kotlin/Any?): kotlin/Boolean // dev.dtrentin.chart.model/YRange.Fixed.equals|equals(kotlin.Any?){}[0]
|
||||||
|
final fun hashCode(): kotlin/Int // dev.dtrentin.chart.model/YRange.Fixed.hashCode|hashCode(){}[0]
|
||||||
|
final fun toString(): kotlin/String // dev.dtrentin.chart.model/YRange.Fixed.toString|toString(){}[0]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
final val dev.dtrentin.chart.buffer/dev_dtrentin_chart_buffer_CircularBuffer$stableprop // dev.dtrentin.chart.buffer/dev_dtrentin_chart_buffer_CircularBuffer$stableprop|#static{}dev_dtrentin_chart_buffer_CircularBuffer$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart.buffer/dev_dtrentin_chart_buffer_LodDecimator$stableprop // dev.dtrentin.chart.buffer/dev_dtrentin_chart_buffer_LodDecimator$stableprop|#static{}dev_dtrentin_chart_buffer_LodDecimator$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart.buffer/dev_dtrentin_chart_buffer_TieredBuffer$stableprop // dev.dtrentin.chart.buffer/dev_dtrentin_chart_buffer_TieredBuffer$stableprop|#static{}dev_dtrentin_chart_buffer_TieredBuffer$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart.model/dev_dtrentin_chart_model_ChartConfig$stableprop // dev.dtrentin.chart.model/dev_dtrentin_chart_model_ChartConfig$stableprop|#static{}dev_dtrentin_chart_model_ChartConfig$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart.model/dev_dtrentin_chart_model_ChartTheme$stableprop // dev.dtrentin.chart.model/dev_dtrentin_chart_model_ChartTheme$stableprop|#static{}dev_dtrentin_chart_model_ChartTheme$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart.model/dev_dtrentin_chart_model_SignalConfig$stableprop // dev.dtrentin.chart.model/dev_dtrentin_chart_model_SignalConfig$stableprop|#static{}dev_dtrentin_chart_model_SignalConfig$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart.model/dev_dtrentin_chart_model_T0$stableprop // dev.dtrentin.chart.model/dev_dtrentin_chart_model_T0$stableprop|#static{}dev_dtrentin_chart_model_T0$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart.model/dev_dtrentin_chart_model_T0_FirstSample$stableprop // dev.dtrentin.chart.model/dev_dtrentin_chart_model_T0_FirstSample$stableprop|#static{}dev_dtrentin_chart_model_T0_FirstSample$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart.model/dev_dtrentin_chart_model_T0_Fixed$stableprop // dev.dtrentin.chart.model/dev_dtrentin_chart_model_T0_Fixed$stableprop|#static{}dev_dtrentin_chart_model_T0_Fixed$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart.model/dev_dtrentin_chart_model_YRange$stableprop // dev.dtrentin.chart.model/dev_dtrentin_chart_model_YRange$stableprop|#static{}dev_dtrentin_chart_model_YRange$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart.model/dev_dtrentin_chart_model_YRange_Auto$stableprop // dev.dtrentin.chart.model/dev_dtrentin_chart_model_YRange_Auto$stableprop|#static{}dev_dtrentin_chart_model_YRange_Auto$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart.model/dev_dtrentin_chart_model_YRange_Fixed$stableprop // dev.dtrentin.chart.model/dev_dtrentin_chart_model_YRange_Fixed$stableprop|#static{}dev_dtrentin_chart_model_YRange_Fixed$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart.render/dev_dtrentin_chart_render_AxisRenderer$stableprop // dev.dtrentin.chart.render/dev_dtrentin_chart_render_AxisRenderer$stableprop|#static{}dev_dtrentin_chart_render_AxisRenderer$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart.render/dev_dtrentin_chart_render_NumberFormat$stableprop // dev.dtrentin.chart.render/dev_dtrentin_chart_render_NumberFormat$stableprop|#static{}dev_dtrentin_chart_render_NumberFormat$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart.render/dev_dtrentin_chart_render_SignalRenderer$stableprop // dev.dtrentin.chart.render/dev_dtrentin_chart_render_SignalRenderer$stableprop|#static{}dev_dtrentin_chart_render_SignalRenderer$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart/dev_dtrentin_chart_RealtimeChartState$stableprop // dev.dtrentin.chart/dev_dtrentin_chart_RealtimeChartState$stableprop|#static{}dev_dtrentin_chart_RealtimeChartState$stableprop[0]
|
||||||
|
final val dev.dtrentin.chart/dev_dtrentin_chart_SignalEntry$stableprop // dev.dtrentin.chart/dev_dtrentin_chart_SignalEntry$stableprop|#static{}dev_dtrentin_chart_SignalEntry$stableprop[0]
|
||||||
|
|
||||||
|
final fun dev.dtrentin.chart.buffer/dev_dtrentin_chart_buffer_CircularBuffer$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.buffer/dev_dtrentin_chart_buffer_CircularBuffer$stableprop_getter|dev_dtrentin_chart_buffer_CircularBuffer$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart.buffer/dev_dtrentin_chart_buffer_LodDecimator$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.buffer/dev_dtrentin_chart_buffer_LodDecimator$stableprop_getter|dev_dtrentin_chart_buffer_LodDecimator$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart.buffer/dev_dtrentin_chart_buffer_TieredBuffer$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.buffer/dev_dtrentin_chart_buffer_TieredBuffer$stableprop_getter|dev_dtrentin_chart_buffer_TieredBuffer$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart.model/dev_dtrentin_chart_model_ChartConfig$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.model/dev_dtrentin_chart_model_ChartConfig$stableprop_getter|dev_dtrentin_chart_model_ChartConfig$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart.model/dev_dtrentin_chart_model_ChartTheme$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.model/dev_dtrentin_chart_model_ChartTheme$stableprop_getter|dev_dtrentin_chart_model_ChartTheme$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart.model/dev_dtrentin_chart_model_SignalConfig$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.model/dev_dtrentin_chart_model_SignalConfig$stableprop_getter|dev_dtrentin_chart_model_SignalConfig$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart.model/dev_dtrentin_chart_model_T0$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.model/dev_dtrentin_chart_model_T0$stableprop_getter|dev_dtrentin_chart_model_T0$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart.model/dev_dtrentin_chart_model_T0_FirstSample$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.model/dev_dtrentin_chart_model_T0_FirstSample$stableprop_getter|dev_dtrentin_chart_model_T0_FirstSample$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart.model/dev_dtrentin_chart_model_T0_Fixed$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.model/dev_dtrentin_chart_model_T0_Fixed$stableprop_getter|dev_dtrentin_chart_model_T0_Fixed$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart.model/dev_dtrentin_chart_model_YRange$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.model/dev_dtrentin_chart_model_YRange$stableprop_getter|dev_dtrentin_chart_model_YRange$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart.model/dev_dtrentin_chart_model_YRange_Auto$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.model/dev_dtrentin_chart_model_YRange_Auto$stableprop_getter|dev_dtrentin_chart_model_YRange_Auto$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart.model/dev_dtrentin_chart_model_YRange_Fixed$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.model/dev_dtrentin_chart_model_YRange_Fixed$stableprop_getter|dev_dtrentin_chart_model_YRange_Fixed$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart.model/rememberMaterialChartTheme(androidx.compose.runtime/Composer?, kotlin/Int): dev.dtrentin.chart.model/ChartTheme // dev.dtrentin.chart.model/rememberMaterialChartTheme|rememberMaterialChartTheme(androidx.compose.runtime.Composer?;kotlin.Int){}[0]
|
||||||
|
final fun dev.dtrentin.chart.render/dev_dtrentin_chart_render_AxisRenderer$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.render/dev_dtrentin_chart_render_AxisRenderer$stableprop_getter|dev_dtrentin_chart_render_AxisRenderer$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart.render/dev_dtrentin_chart_render_NumberFormat$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.render/dev_dtrentin_chart_render_NumberFormat$stableprop_getter|dev_dtrentin_chart_render_NumberFormat$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart.render/dev_dtrentin_chart_render_SignalRenderer$stableprop_getter(): kotlin/Int // dev.dtrentin.chart.render/dev_dtrentin_chart_render_SignalRenderer$stableprop_getter|dev_dtrentin_chart_render_SignalRenderer$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart/RealtimeChart(dev.dtrentin.chart/RealtimeChartState, androidx.compose.ui/Modifier?, kotlin/Float, dev.dtrentin.chart.model/ChartTheme?, androidx.compose.runtime/Composer?, kotlin/Int, kotlin/Int) // dev.dtrentin.chart/RealtimeChart|RealtimeChart(dev.dtrentin.chart.RealtimeChartState;androidx.compose.ui.Modifier?;kotlin.Float;dev.dtrentin.chart.model.ChartTheme?;androidx.compose.runtime.Composer?;kotlin.Int;kotlin.Int){}[0]
|
||||||
|
final fun dev.dtrentin.chart/dev_dtrentin_chart_RealtimeChartState$stableprop_getter(): kotlin/Int // dev.dtrentin.chart/dev_dtrentin_chart_RealtimeChartState$stableprop_getter|dev_dtrentin_chart_RealtimeChartState$stableprop_getter(){}[0]
|
||||||
|
final fun dev.dtrentin.chart/dev_dtrentin_chart_SignalEntry$stableprop_getter(): kotlin/Int // dev.dtrentin.chart/dev_dtrentin_chart_SignalEntry$stableprop_getter|dev_dtrentin_chart_SignalEntry$stableprop_getter(){}[0]
|
||||||
|
|
@ -13,6 +13,7 @@ version = "0.5.0-SNAPSHOT"
|
||||||
|
|
||||||
kotlin {
|
kotlin {
|
||||||
applyDefaultHierarchyTemplate()
|
applyDefaultHierarchyTemplate()
|
||||||
|
explicitApi()
|
||||||
|
|
||||||
androidTarget {
|
androidTarget {
|
||||||
compilations.all {
|
compilations.all {
|
||||||
|
|
@ -44,6 +45,7 @@ kotlin {
|
||||||
implementation(compose.foundation)
|
implementation(compose.foundation)
|
||||||
implementation(compose.material3)
|
implementation(compose.material3)
|
||||||
implementation(libs.coroutines.core)
|
implementation(libs.coroutines.core)
|
||||||
|
implementation(libs.kotlinx.datetime)
|
||||||
}
|
}
|
||||||
androidMain.dependencies {
|
androidMain.dependencies {
|
||||||
implementation(libs.androidx.core)
|
implementation(libs.androidx.core)
|
||||||
|
|
@ -71,4 +73,24 @@ android {
|
||||||
publishing {
|
publishing {
|
||||||
// KMP plugin auto-creates per-target publications.
|
// KMP plugin auto-creates per-target publications.
|
||||||
// Run: ./gradlew publishToMavenLocal
|
// Run: ./gradlew publishToMavenLocal
|
||||||
|
publications.withType<MavenPublication>().configureEach {
|
||||||
|
pom {
|
||||||
|
name.set("chart-realtime")
|
||||||
|
description.set("KMP real-time line chart for high-frequency sensor data (200Hz+ multi-signal, bounded memory).")
|
||||||
|
url.set("https://github.com/davide-trentin/KMPCharts")
|
||||||
|
licenses {
|
||||||
|
license {
|
||||||
|
name.set("MIT License")
|
||||||
|
url.set("https://opensource.org/licenses/MIT")
|
||||||
|
distribution.set("repo")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
developers {
|
||||||
|
developer {
|
||||||
|
id.set("dtrentin")
|
||||||
|
name.set("Davide Trentin")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -1,3 +0,0 @@
|
||||||
package dev.dtrentin.chart
|
|
||||||
|
|
||||||
internal actual fun currentTimeMs(): Long = System.currentTimeMillis()
|
|
||||||
|
|
@ -1,3 +0,0 @@
|
||||||
package dev.dtrentin.chart
|
|
||||||
|
|
||||||
internal expect fun currentTimeMs(): Long
|
|
||||||
|
|
@ -4,9 +4,6 @@ import androidx.compose.foundation.Canvas
|
||||||
import androidx.compose.foundation.background
|
import androidx.compose.foundation.background
|
||||||
import androidx.compose.runtime.Composable
|
import androidx.compose.runtime.Composable
|
||||||
import androidx.compose.runtime.remember
|
import androidx.compose.runtime.remember
|
||||||
import androidx.compose.runtime.mutableLongStateOf
|
|
||||||
import androidx.compose.runtime.getValue
|
|
||||||
import androidx.compose.runtime.setValue
|
|
||||||
import androidx.compose.ui.Modifier
|
import androidx.compose.ui.Modifier
|
||||||
import androidx.compose.ui.graphics.Path
|
import androidx.compose.ui.graphics.Path
|
||||||
import androidx.compose.ui.platform.LocalDensity
|
import androidx.compose.ui.platform.LocalDensity
|
||||||
|
|
@ -20,10 +17,11 @@ import dev.dtrentin.chart.render.AxisRenderer.drawXAxis
|
||||||
import dev.dtrentin.chart.render.AxisRenderer.drawYAxis
|
import dev.dtrentin.chart.render.AxisRenderer.drawYAxis
|
||||||
import dev.dtrentin.chart.render.AxisRenderer.resolveYRange
|
import dev.dtrentin.chart.render.AxisRenderer.resolveYRange
|
||||||
import dev.dtrentin.chart.render.SignalRenderer.drawSignal
|
import dev.dtrentin.chart.render.SignalRenderer.drawSignal
|
||||||
import dev.dtrentin.chart.render.rememberFrameTick
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Renders all signals held by [state] on a Canvas that repaints at [ChartConfig.targetFps].
|
* Renders all signals held by [state] on a Canvas. Recomposition is driven by Compose
|
||||||
|
* snapshot observation of `state.dataVersion`, so the Canvas redraws only when new data
|
||||||
|
* arrives (batched per frame by the Compose snapshot system).
|
||||||
*
|
*
|
||||||
* @param state holds all signal data and config.
|
* @param state holds all signal data and config.
|
||||||
* @param modifier applied to Canvas.
|
* @param modifier applied to Canvas.
|
||||||
|
|
@ -31,14 +29,13 @@ import dev.dtrentin.chart.render.rememberFrameTick
|
||||||
* @param theme visual theme; overrides [state.config.theme] at call site.
|
* @param theme visual theme; overrides [state.config.theme] at call site.
|
||||||
*/
|
*/
|
||||||
@Composable
|
@Composable
|
||||||
fun RealtimeChart(
|
public fun RealtimeChart(
|
||||||
state: RealtimeChartState,
|
state: RealtimeChartState,
|
||||||
modifier: Modifier = Modifier,
|
modifier: Modifier = Modifier,
|
||||||
xWindowSeconds: Float = state.config.xWindowSeconds,
|
xWindowSeconds: Float = state.config.xWindowSeconds,
|
||||||
theme: ChartTheme = state.config.theme,
|
theme: ChartTheme = state.config.theme,
|
||||||
) {
|
) {
|
||||||
val config = state.config
|
val config = state.config
|
||||||
val frameTick = rememberFrameTick(config.targetFps)
|
|
||||||
val textMeasurer = rememberTextMeasurer()
|
val textMeasurer = rememberTextMeasurer()
|
||||||
val density = LocalDensity.current
|
val density = LocalDensity.current
|
||||||
val chartLeftPx = remember(config.yLabelMode) {
|
val chartLeftPx = remember(config.yLabelMode) {
|
||||||
|
|
@ -47,20 +44,20 @@ fun RealtimeChart(
|
||||||
val chartBottomInsetPx = remember(config.xLabelMode) {
|
val chartBottomInsetPx = remember(config.xLabelMode) {
|
||||||
if (config.xLabelMode == AxisLabelMode.BESIDE) with(density) { 20.dp.toPx() } else 0f
|
if (config.xLabelMode == AxisLabelMode.BESIDE) with(density) { 20.dp.toPx() } else 0f
|
||||||
}
|
}
|
||||||
var lastRenderedVersion by remember { mutableLongStateOf(-1L) }
|
// Plain mutable Long slot — written inside draw lambda. Not a Compose state, so the
|
||||||
val snapTs = remember { LongArray(TieredBuffer.TOTAL_CAPACITY) }
|
// write does NOT invalidate the composition (avoids self-recomposition loop).
|
||||||
val snapV = remember { FloatArray(TieredBuffer.TOTAL_CAPACITY) }
|
val lastRenderedVersion = remember { longArrayOf(-1L) }
|
||||||
val lodX = remember { FloatArray(TieredBuffer.TOTAL_CAPACITY) }
|
val lodX = remember { FloatArray(TieredBuffer.TOTAL_CAPACITY) }
|
||||||
val lodY = remember { FloatArray(TieredBuffer.TOTAL_CAPACITY) }
|
val lodY = remember { FloatArray(TieredBuffer.TOTAL_CAPACITY) }
|
||||||
val path = remember { Path() }
|
val path = remember { Path() }
|
||||||
val lodDecimator = remember { LodDecimator() }
|
val lodDecimator = remember { LodDecimator() }
|
||||||
|
|
||||||
Canvas(modifier = modifier.background(theme.backgroundColor)) {
|
Canvas(modifier = modifier.background(theme.backgroundColor)) {
|
||||||
@Suppress("UNUSED_EXPRESSION") frameTick
|
|
||||||
val currentVersion = state.dataVersion
|
val currentVersion = state.dataVersion
|
||||||
if (currentVersion == lastRenderedVersion) return@Canvas
|
if (currentVersion == lastRenderedVersion[0]) return@Canvas
|
||||||
val signals = state.signals
|
val signals = state.signals
|
||||||
if (signals.isEmpty() || state.resolvedT0Ms == null) return@Canvas
|
val t0 = state.resolvedT0Ms ?: return@Canvas
|
||||||
|
if (signals.isEmpty()) return@Canvas
|
||||||
val windowMs = (xWindowSeconds * 1000f).toLong()
|
val windowMs = (xWindowSeconds * 1000f).toLong()
|
||||||
if (windowMs <= 0L) return@Canvas
|
if (windowMs <= 0L) return@Canvas
|
||||||
|
|
||||||
|
|
@ -74,25 +71,33 @@ fun RealtimeChart(
|
||||||
if (latestMs == Long.MIN_VALUE) return@Canvas
|
if (latestMs == Long.MIN_VALUE) return@Canvas
|
||||||
val windowStartMs = latestMs - windowMs
|
val windowStartMs = latestMs - windowMs
|
||||||
|
|
||||||
var dataMin = Float.POSITIVE_INFINITY
|
// Single snapshot pass per signal (T11). Per-signal scratch arrays live in SignalEntry.
|
||||||
var dataMax = Float.NEGATIVE_INFINITY
|
// Y-range scan and path generation both read the same snapshot — no double-snapshot.
|
||||||
|
var dataMin = 0f
|
||||||
|
var dataMax = 0f
|
||||||
|
var hasData = false
|
||||||
for ((_, entry) in signals) {
|
for ((_, entry) in signals) {
|
||||||
if (!entry.config.visible) continue
|
if (!entry.config.visible) { entry.scratchCount = 0; continue }
|
||||||
val n = entry.buffer.snapshot(windowStartMs, windowMs, snapTs, snapV)
|
val n = entry.buffer.snapshot(windowStartMs, windowMs, entry.scratchTs, entry.scratchV)
|
||||||
|
entry.scratchCount = n
|
||||||
for (i in 0 until n) {
|
for (i in 0 until n) {
|
||||||
if (snapV[i] < dataMin) dataMin = snapV[i]
|
val v = entry.scratchV[i]
|
||||||
if (snapV[i] > dataMax) dataMax = snapV[i]
|
if (!hasData) { dataMin = v; dataMax = v; hasData = true }
|
||||||
|
else {
|
||||||
|
if (v < dataMin) dataMin = v
|
||||||
|
if (v > dataMax) dataMax = v
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if (dataMin == Float.POSITIVE_INFINITY) { dataMin = -1f; dataMax = 1f }
|
if (!hasData) { dataMin = -1f; dataMax = 1f }
|
||||||
val (yMin, yMax) = resolveYRange(config, dataMin, dataMax)
|
val (yMin, yMax) = resolveYRange(config, dataMin, dataMax)
|
||||||
|
|
||||||
drawXAxis(windowStartMs, windowMs, theme, textMeasurer, config.xLabelMode, config.xLabelDecimals, chartLeftPx, chartBottom, state.resolvedT0Ms!!, showGrid = config.showGrid)
|
drawXAxis(windowStartMs, windowMs, theme, textMeasurer, config.xLabelMode, chartLeftPx, chartBottom, t0, showGrid = config.showGrid)
|
||||||
drawYAxis(yMin, yMax, theme, textMeasurer, config.yLabelMode, config.yLabelDecimals, chartLeftPx, chartBottom, showGrid = config.showGrid)
|
drawYAxis(yMin, yMax, theme, textMeasurer, config.yLabelMode, config.yLabelDecimals, chartLeftPx, chartBottom, showGrid = config.showGrid)
|
||||||
|
|
||||||
for ((_, entry) in signals) {
|
for ((_, entry) in signals) {
|
||||||
drawSignal(
|
drawSignal(
|
||||||
entry = entry, snapTs = snapTs, snapV = snapV,
|
entry = entry, count = entry.scratchCount,
|
||||||
lodX = lodX, lodY = lodY, path = path,
|
lodX = lodX, lodY = lodY, path = path,
|
||||||
windowStartMs = windowStartMs, windowMs = windowMs,
|
windowStartMs = windowStartMs, windowMs = windowMs,
|
||||||
yMin = yMin, yMax = yMax,
|
yMin = yMin, yMax = yMax,
|
||||||
|
|
@ -100,6 +105,6 @@ fun RealtimeChart(
|
||||||
lodDecimator = lodDecimator, mode = config.lodMode,
|
lodDecimator = lodDecimator, mode = config.lodMode,
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
lastRenderedVersion = currentVersion
|
lastRenderedVersion[0] = currentVersion
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,8 @@
|
||||||
package dev.dtrentin.chart
|
package dev.dtrentin.chart
|
||||||
|
|
||||||
import androidx.compose.runtime.mutableStateOf
|
import androidx.compose.runtime.mutableLongStateOf
|
||||||
|
import androidx.compose.runtime.snapshots.Snapshot
|
||||||
|
import androidx.compose.runtime.snapshots.SnapshotApplyConflictException
|
||||||
import dev.dtrentin.chart.buffer.TieredBuffer
|
import dev.dtrentin.chart.buffer.TieredBuffer
|
||||||
import dev.dtrentin.chart.model.ChartConfig
|
import dev.dtrentin.chart.model.ChartConfig
|
||||||
import dev.dtrentin.chart.model.SignalConfig
|
import dev.dtrentin.chart.model.SignalConfig
|
||||||
|
|
@ -11,6 +13,7 @@ import kotlinx.coroutines.CoroutineScope
|
||||||
import kotlinx.coroutines.Job
|
import kotlinx.coroutines.Job
|
||||||
import kotlinx.coroutines.flow.Flow
|
import kotlinx.coroutines.flow.Flow
|
||||||
import kotlinx.coroutines.launch
|
import kotlinx.coroutines.launch
|
||||||
|
import kotlinx.datetime.Clock
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Holds all state for a [RealtimeChart]. Create once, pass to composable.
|
* Holds all state for a [RealtimeChart]. Create once, pass to composable.
|
||||||
|
|
@ -22,16 +25,25 @@ import kotlinx.coroutines.launch
|
||||||
* state.addSignal("v1", SignalConfig(color = Color.Red))
|
* state.addSignal("v1", SignalConfig(color = Color.Red))
|
||||||
* RealtimeChart(state, Modifier.fillMaxSize())
|
* RealtimeChart(state, Modifier.fillMaxSize())
|
||||||
* ```
|
* ```
|
||||||
|
*
|
||||||
|
* Contract for [push]:
|
||||||
|
* - Samples must have finite [Float] values. NaN / Infinity samples are silently dropped.
|
||||||
|
* - Timestamps per signal must be monotonic non-decreasing. Backward samples are silently dropped.
|
||||||
|
* - Samples for unknown signal names are silently dropped (call [addSignal] first).
|
||||||
*/
|
*/
|
||||||
class RealtimeChartState(
|
public class RealtimeChartState(
|
||||||
val config: ChartConfig = ChartConfig(),
|
public val config: ChartConfig = ChartConfig(),
|
||||||
) {
|
) {
|
||||||
private val _signals = mutableStateOf<Map<String, SignalEntry>>(emptyMap())
|
// Plain @Volatile copy-on-write map. NOT a MutableState — writes happen on data thread.
|
||||||
internal val signals: Map<String, SignalEntry> get() = _signals.value
|
// Compose observes mutations indirectly via [dataVersion] (a Compose Long state).
|
||||||
|
@Volatile private var _signals: Map<String, SignalEntry> = emptyMap()
|
||||||
|
internal val signals: Map<String, SignalEntry> get() = _signals
|
||||||
|
|
||||||
/** Increments on every [push] call. Use to skip rendering when no new data has arrived. */
|
// Compose-observable counter. Reads inside composition register snapshot dependencies,
|
||||||
@Volatile var dataVersion: Long = 0L
|
// writes from background threads are routed through Snapshot.withMutableSnapshot.
|
||||||
private set
|
private val _dataVersion = mutableLongStateOf(0L)
|
||||||
|
/** Increments on every [push] / [addSignal] / [removeSignal]. Use to skip rendering when unchanged. */
|
||||||
|
internal val dataVersion: Long get() = _dataVersion.longValue
|
||||||
|
|
||||||
@Volatile internal var resolvedT0Ms: Long? = when (val t = config.t0) {
|
@Volatile internal var resolvedT0Ms: Long? = when (val t = config.t0) {
|
||||||
is T0.Fixed -> t.epochMs
|
is T0.Fixed -> t.epochMs
|
||||||
|
|
@ -39,34 +51,74 @@ class RealtimeChartState(
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Registers a signal. Must call before [push]. If [name] exists, buffer is replaced. */
|
/** Registers a signal. Must call before [push]. If [name] exists, buffer is replaced. */
|
||||||
fun addSignal(name: String, signalConfig: SignalConfig) {
|
public fun addSignal(name: String, signalConfig: SignalConfig) {
|
||||||
_signals.value = _signals.value + (name to SignalEntry(signalConfig, TieredBuffer()))
|
_signals = _signals + (name to SignalEntry(signalConfig, TieredBuffer()))
|
||||||
|
applySnapshot { _dataVersion.longValue++ }
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Removes signal [name] and its buffer. No-op if absent. */
|
/** Removes signal [name] and its buffer. No-op if absent. */
|
||||||
fun removeSignal(name: String) {
|
public fun removeSignal(name: String) {
|
||||||
_signals.value = _signals.value - name
|
_signals = _signals - name
|
||||||
|
applySnapshot { _dataVersion.longValue++ }
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Pushes one sample. Thread-safe. @param timestampMs ms epoch. */
|
/**
|
||||||
fun push(name: String, timestampMs: Long, value: Float) {
|
* Pushes one sample. Thread-safe. See class-level contract: NaN / Infinity values,
|
||||||
|
* backward timestamps (per signal), and unknown signal names are silently dropped
|
||||||
|
* and do NOT bump [dataVersion]. Equal timestamps are accepted (non-decreasing).
|
||||||
|
*
|
||||||
|
* @param timestampMs ms epoch.
|
||||||
|
*/
|
||||||
|
public fun push(name: String, timestampMs: Long, value: Float) {
|
||||||
|
if (!value.isFinite()) return
|
||||||
|
val entry = _signals[name] ?: return
|
||||||
|
if (timestampMs < entry.lastPushedTs) return
|
||||||
|
entry.lastPushedTs = timestampMs
|
||||||
if (resolvedT0Ms == null) resolvedT0Ms = timestampMs
|
if (resolvedT0Ms == null) resolvedT0Ms = timestampMs
|
||||||
_signals.value[name]?.buffer?.push(timestampMs, value)
|
entry.buffer.push(timestampMs, value)
|
||||||
dataVersion++
|
applySnapshot { _dataVersion.longValue++ }
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Collects (timestampMs, value) pairs from [flow] into signal [name]. Returns [Job]. */
|
/** Collects (timestampMs, value) pairs from [flow] into signal [name]. Returns [Job]. */
|
||||||
@JvmName("collectFromTimestamped")
|
@JvmName("collectFromTimestamped")
|
||||||
fun collectFrom(name: String, flow: Flow<Pair<Long, Float>>, scope: CoroutineScope): Job =
|
public fun collectFrom(name: String, flow: Flow<Pair<Long, Float>>, scope: CoroutineScope): Job =
|
||||||
scope.launch { flow.collect { (ts, v) -> push(name, ts, v) } }
|
scope.launch { flow.collect { (ts, v) -> push(name, ts, v) } }
|
||||||
|
|
||||||
/** Collects raw [Float] from [flow], stamps with current time. Returns [Job]. */
|
/** Collects raw [Float] from [flow], stamps with current time. Returns [Job]. */
|
||||||
@JvmName("collectFromFloat")
|
@JvmName("collectFromFloat")
|
||||||
fun collectFrom(name: String, flow: Flow<Float>, scope: CoroutineScope): Job =
|
public fun collectFrom(name: String, flow: Flow<Float>, scope: CoroutineScope): Job =
|
||||||
scope.launch { flow.collect { v -> push(name, currentTimeMs(), v) } }
|
scope.launch { flow.collect { v -> push(name, Clock.System.now().toEpochMilliseconds(), v) } }
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Apply a Compose snapshot write from any thread. Retries on conflict (e.g. concurrent
|
||||||
|
* producer threads racing on `_dataVersion`). The block is intentionally tiny — only the
|
||||||
|
* Compose state mutation — so retries are cheap.
|
||||||
|
*/
|
||||||
|
private inline fun applySnapshot(block: () -> Unit) {
|
||||||
|
while (true) {
|
||||||
|
try {
|
||||||
|
Snapshot.withMutableSnapshot { block() }
|
||||||
|
return
|
||||||
|
} catch (_: SnapshotApplyConflictException) {
|
||||||
|
// retry
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
internal class SignalEntry(
|
internal class SignalEntry(
|
||||||
val config: SignalConfig,
|
val config: SignalConfig,
|
||||||
val buffer: TieredBuffer,
|
val buffer: TieredBuffer,
|
||||||
)
|
) {
|
||||||
|
// Per-signal scratch arrays for snapshot output. Pre-allocated at signal add to
|
||||||
|
// amortize alloc cost across frames. Used by render loop to snapshot ONCE per signal
|
||||||
|
// per frame (T11) — same data feeds both Y-range computation and path generation.
|
||||||
|
val scratchTs: LongArray = LongArray(TieredBuffer.TOTAL_CAPACITY)
|
||||||
|
val scratchV: FloatArray = FloatArray(TieredBuffer.TOTAL_CAPACITY)
|
||||||
|
var scratchCount: Int = 0
|
||||||
|
|
||||||
|
// Monotonic guard for push() (T13). Writer: data thread inside push().
|
||||||
|
// Reader: same writer thread only (never read by render thread).
|
||||||
|
// @Volatile is precautionary for multi-producer SPMC scenarios (not currently exercised).
|
||||||
|
@Volatile var lastPushedTs: Long = Long.MIN_VALUE
|
||||||
|
}
|
||||||
|
|
|
||||||
|
|
@ -6,17 +6,20 @@ import kotlin.concurrent.Volatile
|
||||||
* Lock-free circular buffer for (timestampMs, value) sensor samples.
|
* Lock-free circular buffer for (timestampMs, value) sensor samples.
|
||||||
* Pre-allocated — zero allocations after construction.
|
* Pre-allocated — zero allocations after construction.
|
||||||
* Thread safety: single writer, single reader. @Volatile for visibility.
|
* Thread safety: single writer, single reader. @Volatile for visibility.
|
||||||
|
*
|
||||||
|
* writeIndex is Long to prevent Int overflow on long-running sessions
|
||||||
|
* (e.g. 200Hz sampling would overflow Int after ~124 days).
|
||||||
*/
|
*/
|
||||||
class CircularBuffer(val capacity: Int) {
|
internal class CircularBuffer(val capacity: Int) {
|
||||||
|
|
||||||
private val timestamps = LongArray(capacity)
|
private val timestamps = LongArray(capacity)
|
||||||
private val values = FloatArray(capacity)
|
private val values = FloatArray(capacity)
|
||||||
|
|
||||||
@Volatile private var writeIndex = 0
|
@Volatile private var writeIndex: Long = 0L
|
||||||
@Volatile private var size = 0
|
@Volatile private var size = 0
|
||||||
|
|
||||||
fun push(timestampMs: Long, value: Float) {
|
fun push(timestampMs: Long, value: Float) {
|
||||||
val idx = writeIndex % capacity
|
val idx = (writeIndex % capacity).toInt()
|
||||||
timestamps[idx] = timestampMs
|
timestamps[idx] = timestampMs
|
||||||
values[idx] = value
|
values[idx] = value
|
||||||
writeIndex++
|
writeIndex++
|
||||||
|
|
@ -31,9 +34,9 @@ class CircularBuffer(val capacity: Int) {
|
||||||
val currentWrite = writeIndex
|
val currentWrite = writeIndex
|
||||||
val currentSize = size.coerceAtMost(capacity)
|
val currentSize = size.coerceAtMost(capacity)
|
||||||
if (currentSize == 0) return 0
|
if (currentSize == 0) return 0
|
||||||
val startIdx = if (currentSize < capacity) 0 else currentWrite - capacity
|
val startIdx: Long = if (currentSize < capacity) 0L else currentWrite - capacity
|
||||||
for (i in 0 until currentSize) {
|
for (i in 0 until currentSize) {
|
||||||
val src = ((startIdx + i) % capacity + capacity) % capacity
|
val src = (((startIdx + i) % capacity + capacity) % capacity).toInt()
|
||||||
outTimestamps[i] = timestamps[src]
|
outTimestamps[i] = timestamps[src]
|
||||||
outValues[i] = values[src]
|
outValues[i] = values[src]
|
||||||
}
|
}
|
||||||
|
|
@ -42,10 +45,13 @@ class CircularBuffer(val capacity: Int) {
|
||||||
|
|
||||||
fun latestTimestampMs(): Long {
|
fun latestTimestampMs(): Long {
|
||||||
if (size == 0) return -1L
|
if (size == 0) return -1L
|
||||||
return timestamps[(writeIndex - 1 + capacity) % capacity]
|
return timestamps[((writeIndex - 1L + capacity) % capacity).toInt()]
|
||||||
}
|
}
|
||||||
|
|
||||||
fun clear() { writeIndex = 0; size = 0 }
|
fun clear() { writeIndex = 0L; size = 0 }
|
||||||
|
|
||||||
val currentSize: Int get() = size.coerceAtMost(capacity)
|
val currentSize: Int get() = size.coerceAtMost(capacity)
|
||||||
|
|
||||||
|
/** Test-only: seed writeIndex to simulate long-running sessions past Int.MAX_VALUE. */
|
||||||
|
internal fun setWriteIndexForTest(idx: Long) { writeIndex = idx }
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -2,7 +2,7 @@ package dev.dtrentin.chart.buffer
|
||||||
|
|
||||||
import dev.dtrentin.chart.model.LodMode
|
import dev.dtrentin.chart.model.LodMode
|
||||||
|
|
||||||
class LodDecimator(
|
internal class LodDecimator(
|
||||||
maxCount: Int = TieredBuffer.TOTAL_CAPACITY,
|
maxCount: Int = TieredBuffer.TOTAL_CAPACITY,
|
||||||
maxPixelWidth: Int = 2048,
|
maxPixelWidth: Int = 2048,
|
||||||
) {
|
) {
|
||||||
|
|
|
||||||
|
|
@ -1,18 +1,27 @@
|
||||||
package dev.dtrentin.chart.buffer
|
package dev.dtrentin.chart.buffer
|
||||||
|
|
||||||
class TieredBuffer {
|
internal class TieredBuffer {
|
||||||
|
|
||||||
private val tier0 = CircularBuffer(TIER0_CAPACITY)
|
private val tier0 = CircularBuffer(TIER0_CAPACITY)
|
||||||
private val tier1 = CircularBuffer(TIER1_CAPACITY)
|
private val tier1 = CircularBuffer(TIER1_CAPACITY)
|
||||||
private val tier2 = CircularBuffer(TIER2_CAPACITY)
|
private val tier2 = CircularBuffer(TIER2_CAPACITY)
|
||||||
|
|
||||||
|
// M4 per-bin accumulator: first/min/max/last (ts, value) pairs.
|
||||||
|
// Preserves visual shape across bin boundaries vs (midTs, min)/(midTs, max) pairs
|
||||||
|
// that collapse to a vertical spike at flush time (C7 artifact).
|
||||||
private var tier1BinStartMs = -1L
|
private var tier1BinStartMs = -1L
|
||||||
private var tier1BinMin = Float.MAX_VALUE
|
private var tier1BinFirstTs = 0L; private var tier1BinFirstV = 0f
|
||||||
private var tier1BinMax = -Float.MAX_VALUE
|
private var tier1BinLastTs = 0L; private var tier1BinLastV = 0f
|
||||||
|
private var tier1BinMinTs = 0L; private var tier1BinMinV = 0f
|
||||||
|
private var tier1BinMaxTs = 0L; private var tier1BinMaxV = 0f
|
||||||
|
private var tier1BinHasData = false
|
||||||
|
|
||||||
private var tier2BinStartMs = -1L
|
private var tier2BinStartMs = -1L
|
||||||
private var tier2BinMin = Float.MAX_VALUE
|
private var tier2BinFirstTs = 0L; private var tier2BinFirstV = 0f
|
||||||
private var tier2BinMax = -Float.MAX_VALUE
|
private var tier2BinLastTs = 0L; private var tier2BinLastV = 0f
|
||||||
|
private var tier2BinMinTs = 0L; private var tier2BinMinV = 0f
|
||||||
|
private var tier2BinMaxTs = 0L; private var tier2BinMaxV = 0f
|
||||||
|
private var tier2BinHasData = false
|
||||||
|
|
||||||
private val t0Ts = LongArray(TIER0_CAPACITY)
|
private val t0Ts = LongArray(TIER0_CAPACITY)
|
||||||
private val t0Vs = FloatArray(TIER0_CAPACITY)
|
private val t0Vs = FloatArray(TIER0_CAPACITY)
|
||||||
|
|
@ -21,6 +30,10 @@ class TieredBuffer {
|
||||||
private val t2Ts = LongArray(TIER2_CAPACITY)
|
private val t2Ts = LongArray(TIER2_CAPACITY)
|
||||||
private val t2Vs = FloatArray(TIER2_CAPACITY)
|
private val t2Vs = FloatArray(TIER2_CAPACITY)
|
||||||
|
|
||||||
|
// Reusable scratch for M4 flush sort/dedup (4 records max per bin). Avoids per-call alloc.
|
||||||
|
private val flushTs = LongArray(4)
|
||||||
|
private val flushVs = FloatArray(4)
|
||||||
|
|
||||||
fun push(timestampMs: Long, value: Float) {
|
fun push(timestampMs: Long, value: Float) {
|
||||||
tier0.push(timestampMs, value)
|
tier0.push(timestampMs, value)
|
||||||
feedTier1(timestampMs, value)
|
feedTier1(timestampMs, value)
|
||||||
|
|
@ -32,17 +45,28 @@ class TieredBuffer {
|
||||||
tier1BinStartMs = (ts / TIER1_BIN_MS) * TIER1_BIN_MS
|
tier1BinStartMs = (ts / TIER1_BIN_MS) * TIER1_BIN_MS
|
||||||
}
|
}
|
||||||
if (ts >= tier1BinStartMs + TIER1_BIN_MS) {
|
if (ts >= tier1BinStartMs + TIER1_BIN_MS) {
|
||||||
if (tier1BinMin != Float.MAX_VALUE) {
|
if (tier1BinHasData) {
|
||||||
val midTs = tier1BinStartMs + TIER1_BIN_MS / 2L
|
flushM4ToTier1()
|
||||||
tier1.push(midTs, tier1BinMin)
|
|
||||||
tier1.push(midTs, tier1BinMax)
|
|
||||||
}
|
}
|
||||||
tier1BinStartMs = (ts / TIER1_BIN_MS) * TIER1_BIN_MS
|
tier1BinStartMs = (ts / TIER1_BIN_MS) * TIER1_BIN_MS
|
||||||
tier1BinMin = value
|
tier1BinFirstTs = ts; tier1BinFirstV = value
|
||||||
tier1BinMax = value
|
tier1BinLastTs = ts; tier1BinLastV = value
|
||||||
|
tier1BinMinTs = ts; tier1BinMinV = value
|
||||||
|
tier1BinMaxTs = ts; tier1BinMaxV = value
|
||||||
|
tier1BinHasData = true
|
||||||
} else {
|
} else {
|
||||||
if (value < tier1BinMin) tier1BinMin = value
|
if (!tier1BinHasData) {
|
||||||
if (value > tier1BinMax) tier1BinMax = value
|
tier1BinFirstTs = ts; tier1BinFirstV = value
|
||||||
|
tier1BinLastTs = ts; tier1BinLastV = value
|
||||||
|
tier1BinMinTs = ts; tier1BinMinV = value
|
||||||
|
tier1BinMaxTs = ts; tier1BinMaxV = value
|
||||||
|
tier1BinHasData = true
|
||||||
|
} else {
|
||||||
|
// Samples arrive in chronological order → always update last.
|
||||||
|
tier1BinLastTs = ts; tier1BinLastV = value
|
||||||
|
if (value < tier1BinMinV) { tier1BinMinV = value; tier1BinMinTs = ts }
|
||||||
|
if (value > tier1BinMaxV) { tier1BinMaxV = value; tier1BinMaxTs = ts }
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -51,17 +75,75 @@ class TieredBuffer {
|
||||||
tier2BinStartMs = (ts / TIER2_BIN_MS) * TIER2_BIN_MS
|
tier2BinStartMs = (ts / TIER2_BIN_MS) * TIER2_BIN_MS
|
||||||
}
|
}
|
||||||
if (ts >= tier2BinStartMs + TIER2_BIN_MS) {
|
if (ts >= tier2BinStartMs + TIER2_BIN_MS) {
|
||||||
if (tier2BinMin != Float.MAX_VALUE) {
|
if (tier2BinHasData) {
|
||||||
val midTs = tier2BinStartMs + TIER2_BIN_MS / 2L
|
flushM4ToTier2()
|
||||||
tier2.push(midTs, tier2BinMin)
|
|
||||||
tier2.push(midTs, tier2BinMax)
|
|
||||||
}
|
}
|
||||||
tier2BinStartMs = (ts / TIER2_BIN_MS) * TIER2_BIN_MS
|
tier2BinStartMs = (ts / TIER2_BIN_MS) * TIER2_BIN_MS
|
||||||
tier2BinMin = value
|
tier2BinFirstTs = ts; tier2BinFirstV = value
|
||||||
tier2BinMax = value
|
tier2BinLastTs = ts; tier2BinLastV = value
|
||||||
|
tier2BinMinTs = ts; tier2BinMinV = value
|
||||||
|
tier2BinMaxTs = ts; tier2BinMaxV = value
|
||||||
|
tier2BinHasData = true
|
||||||
} else {
|
} else {
|
||||||
if (value < tier2BinMin) tier2BinMin = value
|
if (!tier2BinHasData) {
|
||||||
if (value > tier2BinMax) tier2BinMax = value
|
tier2BinFirstTs = ts; tier2BinFirstV = value
|
||||||
|
tier2BinLastTs = ts; tier2BinLastV = value
|
||||||
|
tier2BinMinTs = ts; tier2BinMinV = value
|
||||||
|
tier2BinMaxTs = ts; tier2BinMaxV = value
|
||||||
|
tier2BinHasData = true
|
||||||
|
} else {
|
||||||
|
tier2BinLastTs = ts; tier2BinLastV = value
|
||||||
|
if (value < tier2BinMinV) { tier2BinMinV = value; tier2BinMinTs = ts }
|
||||||
|
if (value > tier2BinMaxV) { tier2BinMaxV = value; tier2BinMaxTs = ts }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Push M4 records (first/min/max/last) for current tier1 bin in chronological order,
|
||||||
|
* deduplicated by (ts, v). 4-element insertion sort. Worst case 4 distinct pushes,
|
||||||
|
* best case 1 (single-sample bin).
|
||||||
|
*/
|
||||||
|
private fun flushM4ToTier1() {
|
||||||
|
flushTs[0] = tier1BinFirstTs; flushVs[0] = tier1BinFirstV
|
||||||
|
flushTs[1] = tier1BinMinTs; flushVs[1] = tier1BinMinV
|
||||||
|
flushTs[2] = tier1BinMaxTs; flushVs[2] = tier1BinMaxV
|
||||||
|
flushTs[3] = tier1BinLastTs; flushVs[3] = tier1BinLastV
|
||||||
|
sort4ByTs(flushTs, flushVs)
|
||||||
|
pushDistinctRecords(tier1, flushTs, flushVs)
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun flushM4ToTier2() {
|
||||||
|
flushTs[0] = tier2BinFirstTs; flushVs[0] = tier2BinFirstV
|
||||||
|
flushTs[1] = tier2BinMinTs; flushVs[1] = tier2BinMinV
|
||||||
|
flushTs[2] = tier2BinMaxTs; flushVs[2] = tier2BinMaxV
|
||||||
|
flushTs[3] = tier2BinLastTs; flushVs[3] = tier2BinLastV
|
||||||
|
sort4ByTs(flushTs, flushVs)
|
||||||
|
pushDistinctRecords(tier2, flushTs, flushVs)
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun sort4ByTs(ts: LongArray, vs: FloatArray) {
|
||||||
|
// Insertion sort on 4 elements. Co-sorts vs alongside ts.
|
||||||
|
for (i in 1 until 4) {
|
||||||
|
val tk = ts[i]; val vk = vs[i]
|
||||||
|
var j = i - 1
|
||||||
|
while (j >= 0 && ts[j] > tk) {
|
||||||
|
ts[j + 1] = ts[j]; vs[j + 1] = vs[j]
|
||||||
|
j--
|
||||||
|
}
|
||||||
|
ts[j + 1] = tk; vs[j + 1] = vk
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private fun pushDistinctRecords(target: CircularBuffer, ts: LongArray, vs: FloatArray) {
|
||||||
|
// Push first; subsequent only if (ts, v) differs from previous pushed pair.
|
||||||
|
target.push(ts[0], vs[0])
|
||||||
|
var prevTs = ts[0]; var prevV = vs[0]
|
||||||
|
for (i in 1 until 4) {
|
||||||
|
if (ts[i] != prevTs || vs[i] != prevV) {
|
||||||
|
target.push(ts[i], vs[i])
|
||||||
|
prevTs = ts[i]; prevV = vs[i]
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -119,11 +201,31 @@ class TieredBuffer {
|
||||||
|
|
||||||
fun clear() {
|
fun clear() {
|
||||||
tier0.clear(); tier1.clear(); tier2.clear()
|
tier0.clear(); tier1.clear(); tier2.clear()
|
||||||
tier1BinStartMs = -1L; tier1BinMin = Float.MAX_VALUE; tier1BinMax = -Float.MAX_VALUE
|
tier1BinStartMs = -1L
|
||||||
tier2BinStartMs = -1L; tier2BinMin = Float.MAX_VALUE; tier2BinMax = -Float.MAX_VALUE
|
tier1BinFirstTs = 0L; tier1BinFirstV = 0f
|
||||||
|
tier1BinLastTs = 0L; tier1BinLastV = 0f
|
||||||
|
tier1BinMinTs = 0L; tier1BinMinV = 0f
|
||||||
|
tier1BinMaxTs = 0L; tier1BinMaxV = 0f
|
||||||
|
tier1BinHasData = false
|
||||||
|
tier2BinStartMs = -1L
|
||||||
|
tier2BinFirstTs = 0L; tier2BinFirstV = 0f
|
||||||
|
tier2BinLastTs = 0L; tier2BinLastV = 0f
|
||||||
|
tier2BinMinTs = 0L; tier2BinMinV = 0f
|
||||||
|
tier2BinMaxTs = 0L; tier2BinMaxV = 0f
|
||||||
|
tier2BinHasData = false
|
||||||
}
|
}
|
||||||
|
|
||||||
companion object {
|
/**
|
||||||
|
* Tier capacities. TIER1/TIER2 multiplied by 4 because M4 binning (T12) emits up to
|
||||||
|
* 4 records per bin (first, min, max, last) instead of the previous 2 (min, max).
|
||||||
|
* Steady-state average likely 2–3 records/bin after (ts, v) dedup; ×4 is safe upper bound.
|
||||||
|
*
|
||||||
|
* TIER0_CAPACITY: 5 min × 200 Hz = 60_000 raw samples.
|
||||||
|
* TIER1_CAPACITY: 10 min × 10 Hz × 4 M4 records = 24_000 records.
|
||||||
|
* TIER2_CAPACITY: 45 min × 1 Hz × 4 M4 records = 10_800 records.
|
||||||
|
* TOTAL_CAPACITY: 94_800 samples per signal.
|
||||||
|
*/
|
||||||
|
internal companion object {
|
||||||
const val TIER0_MAX_HZ = 200
|
const val TIER0_MAX_HZ = 200
|
||||||
const val TIER1_HZ = 10
|
const val TIER1_HZ = 10
|
||||||
const val TIER2_HZ = 1
|
const val TIER2_HZ = 1
|
||||||
|
|
@ -136,8 +238,8 @@ class TieredBuffer {
|
||||||
const val TIER2_BIN_MS = 1000L / TIER2_HZ
|
const val TIER2_BIN_MS = 1000L / TIER2_HZ
|
||||||
|
|
||||||
val TIER0_CAPACITY = ((TIER0_DURATION_MS / 1000L) * TIER0_MAX_HZ).toInt()
|
val TIER0_CAPACITY = ((TIER0_DURATION_MS / 1000L) * TIER0_MAX_HZ).toInt()
|
||||||
val TIER1_CAPACITY = ((TIER1_DURATION_MS / 1000L) * TIER1_HZ).toInt() * 2
|
val TIER1_CAPACITY = ((TIER1_DURATION_MS / 1000L) * TIER1_HZ).toInt() * 4
|
||||||
val TIER2_CAPACITY = ((TIER2_DURATION_MS / 1000L) * TIER2_HZ).toInt() * 2
|
val TIER2_CAPACITY = ((TIER2_DURATION_MS / 1000L) * TIER2_HZ).toInt() * 4
|
||||||
val TOTAL_CAPACITY = TIER0_CAPACITY + TIER1_CAPACITY + TIER2_CAPACITY
|
val TOTAL_CAPACITY = TIER0_CAPACITY + TIER1_CAPACITY + TIER2_CAPACITY
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
package dev.dtrentin.chart.model
|
package dev.dtrentin.chart.model
|
||||||
|
|
||||||
/** Controls where axis tick labels are drawn. */
|
/** Controls where axis tick labels are drawn. */
|
||||||
enum class AxisLabelMode {
|
public enum class AxisLabelMode {
|
||||||
/** Labels drawn over chart data area. No margin reserved. */
|
/** Labels drawn over chart data area. No margin reserved. */
|
||||||
INSIDE,
|
INSIDE,
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -6,21 +6,25 @@ package dev.dtrentin.chart.model
|
||||||
* @param xWindowSeconds visible X range in seconds. Data older than (latestTs - xWindowSeconds) is not rendered.
|
* @param xWindowSeconds visible X range in seconds. Data older than (latestTs - xWindowSeconds) is not rendered.
|
||||||
* @param yRange Y axis range strategy.
|
* @param yRange Y axis range strategy.
|
||||||
* @param t0 Origin of X axis (seconds = 0).
|
* @param t0 Origin of X axis (seconds = 0).
|
||||||
* @param targetFps Render rate cap. Default 30 fps. Pass null to render at display refresh rate (use for signals ≥ display Hz). Range: 1..displayMax.
|
* @param targetFps DEPRECATED in v0.4.0. Ignored. Recomposition is now data-driven via the
|
||||||
* @param maxBufferSeconds Max history kept per signal. Caller is responsible for memory implications.
|
* Compose snapshot system: Canvas redraws when `dataVersion` changes (Compose batches
|
||||||
|
* snapshot applies per frame, so writes faster than displayHz still produce at most
|
||||||
|
* displayHz recompositions). Will be removed in v0.5.0.
|
||||||
* @param theme Visual theme (colors, stroke widths).
|
* @param theme Visual theme (colors, stroke widths).
|
||||||
*/
|
*/
|
||||||
data class ChartConfig(
|
public data class ChartConfig(
|
||||||
val xWindowSeconds: Float = 10f,
|
val xWindowSeconds: Float = 10f,
|
||||||
val yRange: YRange = YRange.Auto(),
|
val yRange: YRange = YRange.Auto(),
|
||||||
val t0: T0 = T0.FirstSample,
|
val t0: T0 = T0.FirstSample,
|
||||||
|
@Deprecated(
|
||||||
|
message = "Ignored since v0.4.0; recomposition is data-driven via Compose snapshots. Will be removed in v0.5.0.",
|
||||||
|
level = DeprecationLevel.WARNING,
|
||||||
|
)
|
||||||
val targetFps: Int? = 30,
|
val targetFps: Int? = 30,
|
||||||
val maxBufferSeconds: Float = 60f,
|
|
||||||
val theme: ChartTheme = ChartTheme(),
|
val theme: ChartTheme = ChartTheme(),
|
||||||
val showGrid: Boolean = true,
|
val showGrid: Boolean = true,
|
||||||
val xLabelMode: AxisLabelMode = AxisLabelMode.INSIDE,
|
val xLabelMode: AxisLabelMode = AxisLabelMode.INSIDE,
|
||||||
val yLabelMode: AxisLabelMode = AxisLabelMode.INSIDE,
|
val yLabelMode: AxisLabelMode = AxisLabelMode.INSIDE,
|
||||||
val yLabelDecimals: Int = 2,
|
val yLabelDecimals: Int = 2,
|
||||||
val xLabelDecimals: Int = 1,
|
|
||||||
val lodMode: LodMode = LodMode.MIN_MAX,
|
val lodMode: LodMode = LodMode.MIN_MAX,
|
||||||
)
|
)
|
||||||
|
|
|
||||||
|
|
@ -14,7 +14,7 @@ import androidx.compose.ui.graphics.Color
|
||||||
* @param labelColor Axis tick label text color.
|
* @param labelColor Axis tick label text color.
|
||||||
* @param strokeWidth Axis line stroke width in px.
|
* @param strokeWidth Axis line stroke width in px.
|
||||||
*/
|
*/
|
||||||
data class ChartTheme(
|
public data class ChartTheme(
|
||||||
val backgroundColor: Color = Color(0xFF1A1A2E),
|
val backgroundColor: Color = Color(0xFF1A1A2E),
|
||||||
val gridColor: Color = Color(0x66FFFFFF),
|
val gridColor: Color = Color(0x66FFFFFF),
|
||||||
val axisColor: Color = Color(0xFFBBBBBB),
|
val axisColor: Color = Color(0xFFBBBBBB),
|
||||||
|
|
@ -23,7 +23,7 @@ data class ChartTheme(
|
||||||
)
|
)
|
||||||
|
|
||||||
@Composable
|
@Composable
|
||||||
fun rememberMaterialChartTheme(): ChartTheme {
|
public fun rememberMaterialChartTheme(): ChartTheme {
|
||||||
val cs = MaterialTheme.colorScheme
|
val cs = MaterialTheme.colorScheme
|
||||||
return remember(cs) {
|
return remember(cs) {
|
||||||
ChartTheme(
|
ChartTheme(
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
package dev.dtrentin.chart.model
|
package dev.dtrentin.chart.model
|
||||||
|
|
||||||
/** Level-of-Detail decimation strategy applied when visible samples exceed pixel columns. */
|
/** Level-of-Detail decimation strategy applied when visible samples exceed pixel columns. */
|
||||||
enum class LodMode {
|
public enum class LodMode {
|
||||||
/** Retain min and max per pixel column. Preserves signal peaks. Zero allocations at render time. */
|
/** Retain min and max per pixel column. Preserves signal peaks. Zero allocations at render time. */
|
||||||
MIN_MAX,
|
MIN_MAX,
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -8,11 +8,9 @@ import androidx.compose.ui.graphics.Color
|
||||||
* @param color Line color.
|
* @param color Line color.
|
||||||
* @param strokeWidth Line width in dp.
|
* @param strokeWidth Line width in dp.
|
||||||
* @param visible If false, signal is skipped during rendering.
|
* @param visible If false, signal is skipped during rendering.
|
||||||
* @param label Optional display label for legend (future use).
|
|
||||||
*/
|
*/
|
||||||
data class SignalConfig(
|
public data class SignalConfig(
|
||||||
val color: Color,
|
val color: Color,
|
||||||
val strokeWidth: Float = 2f,
|
val strokeWidth: Float = 2f,
|
||||||
val visible: Boolean = true,
|
val visible: Boolean = true,
|
||||||
val label: String? = null,
|
|
||||||
)
|
)
|
||||||
|
|
|
||||||
|
|
@ -1,13 +1,13 @@
|
||||||
package dev.dtrentin.chart.model
|
package dev.dtrentin.chart.model
|
||||||
|
|
||||||
/** Origin of X axis (t=0 seconds). */
|
/** Origin of X axis (t=0 seconds). */
|
||||||
sealed class T0 {
|
public sealed class T0 {
|
||||||
/** Use timestamp of first sample ever pushed as t=0. */
|
/** Use timestamp of first sample ever pushed as t=0. */
|
||||||
object FirstSample : T0()
|
public object FirstSample : T0()
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Use a fixed epoch timestamp as t=0.
|
* Use a fixed epoch timestamp as t=0.
|
||||||
* @param epochMs absolute timestamp in milliseconds (e.g. System.currentTimeMillis()).
|
* @param epochMs absolute timestamp in milliseconds (e.g. System.currentTimeMillis()).
|
||||||
*/
|
*/
|
||||||
data class Fixed(val epochMs: Long) : T0()
|
public data class Fixed(val epochMs: Long) : T0()
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -1,17 +1,17 @@
|
||||||
package dev.dtrentin.chart.model
|
package dev.dtrentin.chart.model
|
||||||
|
|
||||||
/** Y axis range strategy. */
|
/** Y axis range strategy. */
|
||||||
sealed class YRange {
|
public sealed class YRange {
|
||||||
/**
|
/**
|
||||||
* Auto-fit to data visible in current X window.
|
* Auto-fit to data visible in current X window.
|
||||||
* @param paddingFraction fractional padding added above and below data range (default 10%).
|
* @param paddingFraction fractional padding added above and below data range (default 10%).
|
||||||
*/
|
*/
|
||||||
data class Auto(val paddingFraction: Float = 0.1f) : YRange()
|
public data class Auto(val paddingFraction: Float = 0.1f) : YRange()
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Fixed range regardless of data.
|
* Fixed range regardless of data.
|
||||||
*/
|
*/
|
||||||
data class Fixed(val min: Float, val max: Float) : YRange() {
|
public data class Fixed(val min: Float, val max: Float) : YRange() {
|
||||||
init { require(min < max) { "YRange.Fixed: min ($min) must be < max ($max)" } }
|
init { require(min < max) { "YRange.Fixed: min ($min) must be < max ($max)" } }
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -14,8 +14,6 @@ import dev.dtrentin.chart.model.ChartTheme
|
||||||
import dev.dtrentin.chart.model.YRange
|
import dev.dtrentin.chart.model.YRange
|
||||||
import kotlin.math.ceil
|
import kotlin.math.ceil
|
||||||
import kotlin.math.floor
|
import kotlin.math.floor
|
||||||
import kotlin.math.log10
|
|
||||||
import kotlin.math.pow
|
|
||||||
|
|
||||||
internal object AxisRenderer {
|
internal object AxisRenderer {
|
||||||
|
|
||||||
|
|
@ -25,7 +23,6 @@ internal object AxisRenderer {
|
||||||
theme: ChartTheme,
|
theme: ChartTheme,
|
||||||
textMeasurer: TextMeasurer,
|
textMeasurer: TextMeasurer,
|
||||||
labelMode: AxisLabelMode,
|
labelMode: AxisLabelMode,
|
||||||
labelDecimals: Int,
|
|
||||||
chartLeft: Float,
|
chartLeft: Float,
|
||||||
chartBottom: Float,
|
chartBottom: Float,
|
||||||
t0Ms: Long,
|
t0Ms: Long,
|
||||||
|
|
@ -36,7 +33,7 @@ internal object AxisRenderer {
|
||||||
if (windowMs <= 0 || chartW <= 0) return
|
if (windowMs <= 0 || chartW <= 0) return
|
||||||
|
|
||||||
val windowSec = windowMs / 1000.0
|
val windowSec = windowMs / 1000.0
|
||||||
val tickInterval = niceInterval(windowSec, targetTickCount = 6)
|
val tickInterval = NumberFormat.niceInterval(windowSec, targetTickCount = 6)
|
||||||
var tickSec = floor((windowStartMs / 1000.0) / tickInterval) * tickInterval
|
var tickSec = floor((windowStartMs / 1000.0) / tickInterval) * tickInterval
|
||||||
val windowEndSec = (windowStartMs + windowMs) / 1000.0
|
val windowEndSec = (windowStartMs + windowMs) / 1000.0
|
||||||
|
|
||||||
|
|
@ -46,7 +43,7 @@ internal object AxisRenderer {
|
||||||
if (xPx in chartLeft..w) {
|
if (xPx in chartLeft..w) {
|
||||||
if (showGrid) drawLine(theme.gridColor, Offset(xPx, 0f), Offset(xPx, chartBottom), strokeWidth = 1f)
|
if (showGrid) drawLine(theme.gridColor, Offset(xPx, 0f), Offset(xPx, chartBottom), strokeWidth = 1f)
|
||||||
if (labelMode != AxisLabelMode.HIDDEN) {
|
if (labelMode != AxisLabelMode.HIDDEN) {
|
||||||
val label = formatTimeSec(tickSec - t0Ms / 1000.0)
|
val label = NumberFormat.formatTimeSec(tickSec - t0Ms / 1000.0)
|
||||||
when (labelMode) {
|
when (labelMode) {
|
||||||
AxisLabelMode.INSIDE -> {
|
AxisLabelMode.INSIDE -> {
|
||||||
val availableW = w - xPx - 6f
|
val availableW = w - xPx - 6f
|
||||||
|
|
@ -99,7 +96,7 @@ internal object AxisRenderer {
|
||||||
if (yMax <= yMin || chartW <= 0) return
|
if (yMax <= yMin || chartW <= 0) return
|
||||||
|
|
||||||
val range = (yMax - yMin).toDouble()
|
val range = (yMax - yMin).toDouble()
|
||||||
val tickInterval = niceInterval(range, targetTickCount = 5)
|
val tickInterval = NumberFormat.niceInterval(range, targetTickCount = 5)
|
||||||
var tick = ceil(yMin / tickInterval) * tickInterval
|
var tick = ceil(yMin / tickInterval) * tickInterval
|
||||||
|
|
||||||
while (tick <= yMax + tickInterval * 0.01) {
|
while (tick <= yMax + tickInterval * 0.01) {
|
||||||
|
|
@ -108,7 +105,7 @@ internal object AxisRenderer {
|
||||||
if (yPx in 0f..chartBottom) {
|
if (yPx in 0f..chartBottom) {
|
||||||
if (showGrid) drawLine(theme.gridColor, Offset(chartLeft, yPx), Offset(w, yPx), strokeWidth = 1f)
|
if (showGrid) drawLine(theme.gridColor, Offset(chartLeft, yPx), Offset(w, yPx), strokeWidth = 1f)
|
||||||
if (labelMode != AxisLabelMode.HIDDEN) {
|
if (labelMode != AxisLabelMode.HIDDEN) {
|
||||||
val label = formatAxisValue(tick, labelDecimals)
|
val label = NumberFormat.formatAxisValue(tick, labelDecimals)
|
||||||
when (labelMode) {
|
when (labelMode) {
|
||||||
AxisLabelMode.INSIDE -> {
|
AxisLabelMode.INSIDE -> {
|
||||||
val labelY = (yPx - 10f).coerceAtMost(chartBottom - 14f)
|
val labelY = (yPx - 10f).coerceAtMost(chartBottom - 14f)
|
||||||
|
|
@ -151,72 +148,4 @@ internal object AxisRenderer {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
private fun formatTimeSec(totalSec: Double): String {
|
|
||||||
val negative = totalSec < 0
|
|
||||||
val s = kotlin.math.abs(totalSec.toLong())
|
|
||||||
val formatted = when {
|
|
||||||
s < 60L -> "${s}s"
|
|
||||||
s < 3600L -> "${s / 60}:${(s % 60).toString().padStart(2, '0')}"
|
|
||||||
else -> "${s / 3600}:${((s % 3600) / 60).toString().padStart(2, '0')}:${(s % 60).toString().padStart(2, '0')}"
|
|
||||||
}
|
|
||||||
return if (negative) "-$formatted" else formatted
|
|
||||||
}
|
|
||||||
|
|
||||||
private fun formatAxisValue(value: Double, decimals: Int): String {
|
|
||||||
val absVal = kotlin.math.abs(value)
|
|
||||||
return when {
|
|
||||||
value == 0.0 -> "0"
|
|
||||||
absVal < 0.01 || absVal >= 1e5 -> formatScientific(value, decimals)
|
|
||||||
else -> formatFixed(value, decimals)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
private fun formatFixed(value: Double, decimals: Int): String {
|
|
||||||
val negative = value < 0.0
|
|
||||||
val absVal = kotlin.math.abs(value)
|
|
||||||
val factor = pow10(decimals)
|
|
||||||
val rounded = kotlin.math.round(absVal * factor)
|
|
||||||
val whole = (rounded / factor).toLong()
|
|
||||||
val frac = (rounded - whole * factor).toLong()
|
|
||||||
val sign = if (negative && (whole != 0L || frac != 0L)) "-" else ""
|
|
||||||
return if (decimals <= 0) {
|
|
||||||
"$sign$whole"
|
|
||||||
} else {
|
|
||||||
val fracStr = frac.toString().padStart(decimals, '0')
|
|
||||||
"$sign$whole.$fracStr"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
private fun formatScientific(value: Double, decimals: Int): String {
|
|
||||||
if (value == 0.0) return formatFixed(0.0, decimals) + "e+00"
|
|
||||||
val negative = value < 0.0
|
|
||||||
val absVal = kotlin.math.abs(value)
|
|
||||||
val exp = kotlin.math.floor(kotlin.math.log10(absVal)).toInt()
|
|
||||||
val mantissa = absVal / pow10(exp)
|
|
||||||
val mantStr = formatFixed(mantissa, decimals)
|
|
||||||
val sign = if (negative) "-" else ""
|
|
||||||
val expSign = if (exp >= 0) "+" else "-"
|
|
||||||
val expAbs = kotlin.math.abs(exp).toString().padStart(2, '0')
|
|
||||||
return "$sign${mantStr}e$expSign$expAbs"
|
|
||||||
}
|
|
||||||
|
|
||||||
private fun pow10(n: Int): Double {
|
|
||||||
if (n == 0) return 1.0
|
|
||||||
var r = 1.0
|
|
||||||
val absN = kotlin.math.abs(n)
|
|
||||||
repeat(absN) { r *= 10.0 }
|
|
||||||
return if (n < 0) 1.0 / r else r
|
|
||||||
}
|
|
||||||
|
|
||||||
private fun niceInterval(range: Double, targetTickCount: Int): Double {
|
|
||||||
if (range <= 0) return 1.0
|
|
||||||
val rough = range / targetTickCount
|
|
||||||
val mag = 10.0.pow(floor(log10(rough)))
|
|
||||||
return when {
|
|
||||||
rough / mag < 1.5 -> mag
|
|
||||||
rough / mag < 3.5 -> 2.0 * mag
|
|
||||||
rough / mag < 7.5 -> 5.0 * mag
|
|
||||||
else -> 10.0 * mag
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,88 @@
|
||||||
|
package dev.dtrentin.chart.render
|
||||||
|
|
||||||
|
import kotlin.math.floor
|
||||||
|
import kotlin.math.log10
|
||||||
|
import kotlin.math.pow
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Pure formatting helpers extracted from [AxisRenderer] for unit testability.
|
||||||
|
*
|
||||||
|
* Internal: not part of public API surface. Exposed to commonTest via the same module.
|
||||||
|
*
|
||||||
|
* Behavior pinned by `NumberFormatTest`. Do not change rounding semantics without
|
||||||
|
* updating the corresponding tests.
|
||||||
|
*/
|
||||||
|
internal object NumberFormat {
|
||||||
|
|
||||||
|
fun formatTimeSec(totalSec: Double): String {
|
||||||
|
val negative = totalSec < 0
|
||||||
|
val s = kotlin.math.abs(totalSec.toLong())
|
||||||
|
val formatted = when {
|
||||||
|
s < 60L -> "${s}s"
|
||||||
|
s < 3600L -> "${s / 60}:${(s % 60).toString().padStart(2, '0')}"
|
||||||
|
else -> "${s / 3600}:${((s % 3600) / 60).toString().padStart(2, '0')}:${(s % 60).toString().padStart(2, '0')}"
|
||||||
|
}
|
||||||
|
return if (negative) "-$formatted" else formatted
|
||||||
|
}
|
||||||
|
|
||||||
|
fun formatAxisValue(value: Double, decimals: Int): String {
|
||||||
|
val absVal = kotlin.math.abs(value)
|
||||||
|
return when {
|
||||||
|
value == 0.0 -> "0"
|
||||||
|
absVal < 0.01 || absVal >= 1e5 -> formatScientific(value, decimals)
|
||||||
|
else -> formatFixed(value, decimals)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TODO(v0.5.0): for |value| >= ~1e19 the cast `(rounded / factor).toLong()` overflows
|
||||||
|
// Long range and produces garbage digits. Current callers gate by `formatAxisValue`
|
||||||
|
// (scientific for >=1e5) so production is safe. Fix when exposed publicly.
|
||||||
|
fun formatFixed(value: Double, decimals: Int): String {
|
||||||
|
val negative = value < 0.0
|
||||||
|
val absVal = kotlin.math.abs(value)
|
||||||
|
val factor = pow10(decimals)
|
||||||
|
val rounded = kotlin.math.round(absVal * factor)
|
||||||
|
val whole = (rounded / factor).toLong()
|
||||||
|
val frac = (rounded - whole * factor).toLong()
|
||||||
|
val sign = if (negative && (whole != 0L || frac != 0L)) "-" else ""
|
||||||
|
return if (decimals <= 0) {
|
||||||
|
"$sign$whole"
|
||||||
|
} else {
|
||||||
|
val fracStr = frac.toString().padStart(decimals, '0')
|
||||||
|
"$sign$whole.$fracStr"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fun formatScientific(value: Double, decimals: Int): String {
|
||||||
|
if (value == 0.0) return formatFixed(0.0, decimals) + "e+00"
|
||||||
|
val negative = value < 0.0
|
||||||
|
val absVal = kotlin.math.abs(value)
|
||||||
|
val exp = kotlin.math.floor(kotlin.math.log10(absVal)).toInt()
|
||||||
|
val mantissa = absVal / pow10(exp)
|
||||||
|
val mantStr = formatFixed(mantissa, decimals)
|
||||||
|
val sign = if (negative) "-" else ""
|
||||||
|
val expSign = if (exp >= 0) "+" else "-"
|
||||||
|
val expAbs = kotlin.math.abs(exp).toString().padStart(2, '0')
|
||||||
|
return "$sign${mantStr}e$expSign$expAbs"
|
||||||
|
}
|
||||||
|
|
||||||
|
fun pow10(n: Int): Double {
|
||||||
|
if (n == 0) return 1.0
|
||||||
|
var r = 1.0
|
||||||
|
val absN = kotlin.math.abs(n)
|
||||||
|
repeat(absN) { r *= 10.0 }
|
||||||
|
return if (n < 0) 1.0 / r else r
|
||||||
|
}
|
||||||
|
|
||||||
|
fun niceInterval(range: Double, targetTickCount: Int): Double {
|
||||||
|
if (range <= 0) return 1.0
|
||||||
|
val rough = range / targetTickCount
|
||||||
|
val mag = 10.0.pow(floor(log10(rough)))
|
||||||
|
return when {
|
||||||
|
rough / mag < 1.5 -> mag
|
||||||
|
rough / mag < 3.5 -> 2.0 * mag
|
||||||
|
rough / mag < 7.5 -> 5.0 * mag
|
||||||
|
else -> 10.0 * mag
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -1,32 +0,0 @@
|
||||||
package dev.dtrentin.chart.render
|
|
||||||
|
|
||||||
import androidx.compose.runtime.Composable
|
|
||||||
import androidx.compose.runtime.LaunchedEffect
|
|
||||||
import androidx.compose.runtime.getValue
|
|
||||||
import androidx.compose.runtime.mutableLongStateOf
|
|
||||||
import androidx.compose.runtime.remember
|
|
||||||
import androidx.compose.runtime.setValue
|
|
||||||
import androidx.compose.runtime.withFrameNanos
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Returns a monotonically increasing frame counter.
|
|
||||||
* Increments at display refresh rate, or capped to targetFps if non-null.
|
|
||||||
*/
|
|
||||||
@Composable
|
|
||||||
fun rememberFrameTick(targetFps: Int? = null): Long {
|
|
||||||
var tick by remember { mutableLongStateOf(0L) }
|
|
||||||
val minFrameNanos = if (targetFps != null && targetFps > 0) 1_000_000_000L / targetFps else 0L
|
|
||||||
|
|
||||||
LaunchedEffect(targetFps) {
|
|
||||||
var lastFrameNanos = 0L
|
|
||||||
while (true) {
|
|
||||||
withFrameNanos { frameNanos ->
|
|
||||||
if (frameNanos - lastFrameNanos >= minFrameNanos) {
|
|
||||||
tick++
|
|
||||||
lastFrameNanos = frameNanos
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return tick
|
|
||||||
}
|
|
||||||
|
|
@ -10,10 +10,14 @@ import dev.dtrentin.chart.model.LodMode
|
||||||
|
|
||||||
internal object SignalRenderer {
|
internal object SignalRenderer {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Draws a single signal path using a pre-populated snapshot stored in [entry].
|
||||||
|
* Caller is responsible for invoking [dev.dtrentin.chart.buffer.TieredBuffer.snapshot]
|
||||||
|
* once per frame (T11) and setting [entry.scratchCount] before calling this.
|
||||||
|
*/
|
||||||
fun DrawScope.drawSignal(
|
fun DrawScope.drawSignal(
|
||||||
entry: SignalEntry,
|
entry: SignalEntry,
|
||||||
snapTs: LongArray,
|
count: Int,
|
||||||
snapV: FloatArray,
|
|
||||||
lodX: FloatArray,
|
lodX: FloatArray,
|
||||||
lodY: FloatArray,
|
lodY: FloatArray,
|
||||||
path: Path,
|
path: Path,
|
||||||
|
|
@ -27,13 +31,12 @@ internal object SignalRenderer {
|
||||||
mode: LodMode,
|
mode: LodMode,
|
||||||
) {
|
) {
|
||||||
if (!entry.config.visible) return
|
if (!entry.config.visible) return
|
||||||
val count = entry.buffer.snapshot(windowStartMs, windowMs, snapTs, snapV)
|
|
||||||
if (count == 0) return
|
if (count == 0) return
|
||||||
val chartW = size.width - chartLeft
|
val chartW = size.width - chartLeft
|
||||||
val pixelWidth = chartW.toInt().coerceAtLeast(1)
|
val pixelWidth = chartW.toInt().coerceAtLeast(1)
|
||||||
if (chartBottom <= 0f || chartW <= 0f) return
|
if (chartBottom <= 0f || chartW <= 0f) return
|
||||||
val pairs = lodDecimator.decimate(
|
val pairs = lodDecimator.decimate(
|
||||||
timestamps = snapTs, values = snapV, count = count,
|
timestamps = entry.scratchTs, values = entry.scratchV, count = count,
|
||||||
windowStartMs = windowStartMs, windowMs = windowMs,
|
windowStartMs = windowStartMs, windowMs = windowMs,
|
||||||
pixelWidth = pixelWidth, outX = lodX, outY = lodY,
|
pixelWidth = pixelWidth, outX = lodX, outY = lodY,
|
||||||
mode = mode,
|
mode = mode,
|
||||||
|
|
|
||||||
|
|
@ -85,15 +85,69 @@ class RealtimeChartStateTest {
|
||||||
@Test fun push_multipleIncrements_eachPushBumpsVersion() {
|
@Test fun push_multipleIncrements_eachPushBumpsVersion() {
|
||||||
val state = RealtimeChartState()
|
val state = RealtimeChartState()
|
||||||
state.addSignal("s1", defaultSignalConfig)
|
state.addSignal("s1", defaultSignalConfig)
|
||||||
|
// addSignal also bumps dataVersion (T9), so anchor relative to current value.
|
||||||
|
val before = state.dataVersion
|
||||||
repeat(5) { i -> state.push("s1", (1000L + i), i.toFloat()) }
|
repeat(5) { i -> state.push("s1", (1000L + i), i.toFloat()) }
|
||||||
assertEquals(5L, state.dataVersion)
|
assertEquals(before + 5L, state.dataVersion)
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test fun push_unknownSignal_stillIncrementsDataVersion() {
|
@Test fun pushIgnoresUnknownSignalName() {
|
||||||
val state = RealtimeChartState()
|
val state = RealtimeChartState()
|
||||||
// no addSignal — push on ghost still bumps dataVersion
|
// T13: push on unknown signal silently dropped — no dataVersion bump.
|
||||||
|
val before = state.dataVersion
|
||||||
state.push("ghost", 1000L, 1f)
|
state.push("ghost", 1000L, 1f)
|
||||||
assertEquals(1L, state.dataVersion)
|
assertEquals(before, state.dataVersion)
|
||||||
|
}
|
||||||
|
|
||||||
|
// ── push input validation (T13) ───────────────────────────────────────────
|
||||||
|
|
||||||
|
@Test fun pushRejectsNaN() {
|
||||||
|
val state = RealtimeChartState()
|
||||||
|
state.addSignal("s1", defaultSignalConfig)
|
||||||
|
val before = state.dataVersion
|
||||||
|
state.push("s1", 1000L, Float.NaN)
|
||||||
|
assertEquals(before, state.dataVersion)
|
||||||
|
// Buffer empty: latestTimestampMs() returns -1L sentinel.
|
||||||
|
assertEquals(-1L, state.signals["s1"]!!.buffer.latestTimestampMs())
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun pushRejectsPositiveInfinity() {
|
||||||
|
val state = RealtimeChartState()
|
||||||
|
state.addSignal("s1", defaultSignalConfig)
|
||||||
|
val before = state.dataVersion
|
||||||
|
state.push("s1", 1000L, Float.POSITIVE_INFINITY)
|
||||||
|
assertEquals(before, state.dataVersion)
|
||||||
|
assertEquals(-1L, state.signals["s1"]!!.buffer.latestTimestampMs())
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun pushRejectsNegativeInfinity() {
|
||||||
|
val state = RealtimeChartState()
|
||||||
|
state.addSignal("s1", defaultSignalConfig)
|
||||||
|
val before = state.dataVersion
|
||||||
|
state.push("s1", 1000L, Float.NEGATIVE_INFINITY)
|
||||||
|
assertEquals(before, state.dataVersion)
|
||||||
|
assertEquals(-1L, state.signals["s1"]!!.buffer.latestTimestampMs())
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun pushRejectsBackwardTimestamp() {
|
||||||
|
val state = RealtimeChartState()
|
||||||
|
state.addSignal("s1", defaultSignalConfig)
|
||||||
|
val before = state.dataVersion
|
||||||
|
state.push("s1", 100L, 1f)
|
||||||
|
state.push("s1", 50L, 2f) // backward — dropped
|
||||||
|
assertEquals(before + 1L, state.dataVersion)
|
||||||
|
// Buffer's latest ts remains 100 (50 rejected).
|
||||||
|
assertEquals(100L, state.signals["s1"]!!.buffer.latestTimestampMs())
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun pushAcceptsEqualTimestamp() {
|
||||||
|
val state = RealtimeChartState()
|
||||||
|
state.addSignal("s1", defaultSignalConfig)
|
||||||
|
val before = state.dataVersion
|
||||||
|
state.push("s1", 100L, 1f)
|
||||||
|
state.push("s1", 100L, 2f) // equal — accepted (non-decreasing)
|
||||||
|
assertEquals(before + 2L, state.dataVersion)
|
||||||
|
assertEquals(100L, state.signals["s1"]!!.buffer.latestTimestampMs())
|
||||||
}
|
}
|
||||||
|
|
||||||
// ── resolvedT0Ms / T0 ─────────────────────────────────────────────────────
|
// ── resolvedT0Ms / T0 ─────────────────────────────────────────────────────
|
||||||
|
|
@ -146,4 +200,22 @@ class RealtimeChartStateTest {
|
||||||
val state = RealtimeChartState()
|
val state = RealtimeChartState()
|
||||||
assertEquals(0L, state.dataVersion)
|
assertEquals(0L, state.dataVersion)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// ── snapshot-system thread safety ─────────────────────────────────────────
|
||||||
|
//
|
||||||
|
// Pragmatic single-threaded variant of `pushFromBackgroundThreadIsSafe`:
|
||||||
|
// kotlin.test on iosSimulatorArm64 is single-threaded and the module does not
|
||||||
|
// declare a `kotlinx-coroutines-test` dependency, so we exercise the
|
||||||
|
// `Snapshot.withMutableSnapshot { ... }` path with a high-volume sequential
|
||||||
|
// burst instead. Asserts:
|
||||||
|
// • no exception (e.g. SnapshotApplyConflictException leaking) escapes,
|
||||||
|
// • every push increments `_dataVersion` exactly once (apply did succeed).
|
||||||
|
// True multi-threaded fuzz lives in instrumented/JVM tests (out of scope here).
|
||||||
|
@Test fun pushFromBackgroundThreadIsSafe() {
|
||||||
|
val state = RealtimeChartState()
|
||||||
|
state.addSignal("s", defaultSignalConfig)
|
||||||
|
val before = state.dataVersion
|
||||||
|
repeat(1000) { i -> state.push("s", (1000L + i), i.toFloat()) }
|
||||||
|
assertEquals(before + 1000L, state.dataVersion)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -78,4 +78,28 @@ class CircularBufferTest {
|
||||||
buf.push(5L, 0f)
|
buf.push(5L, 0f)
|
||||||
assertEquals(4, buf.currentSize)
|
assertEquals(4, buf.currentSize)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@Test fun writeIndexSurvivesIntMaxValue() {
|
||||||
|
val cap = 16
|
||||||
|
val buf = CircularBuffer(cap)
|
||||||
|
// Seed writeIndex past Int.MAX_VALUE to simulate long-running session.
|
||||||
|
// Fill buffer first so size == capacity, then advance writeIndex.
|
||||||
|
for (i in 0 until cap) buf.push(i.toLong(), i.toFloat())
|
||||||
|
buf.setWriteIndexForTest(Int.MAX_VALUE.toLong() + 2L)
|
||||||
|
// Push 4 fresh samples past the boundary.
|
||||||
|
buf.push(1001L, 1f)
|
||||||
|
buf.push(1002L, 2f)
|
||||||
|
buf.push(1003L, 3f)
|
||||||
|
buf.push(1004L, 4f)
|
||||||
|
// latestTimestampMs() must use Long arithmetic without overflow.
|
||||||
|
assertEquals(1004L, buf.latestTimestampMs())
|
||||||
|
// snapshot() must return correct count and newest sample at count-1.
|
||||||
|
val ts = LongArray(cap); val v = FloatArray(cap)
|
||||||
|
val count = buf.snapshot(ts, v)
|
||||||
|
assertEquals(cap, count)
|
||||||
|
assertEquals(1004L, ts[cap - 1]); assertEquals(4f, v[cap - 1])
|
||||||
|
assertEquals(1003L, ts[cap - 2]); assertEquals(3f, v[cap - 2])
|
||||||
|
assertEquals(1002L, ts[cap - 3]); assertEquals(2f, v[cap - 3])
|
||||||
|
assertEquals(1001L, ts[cap - 4]); assertEquals(1f, v[cap - 4])
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -56,4 +56,134 @@ class LodDecimatorTest {
|
||||||
assertTrue(yOut.contains(1f), "min=1 missing, got $yOut")
|
assertTrue(yOut.contains(1f), "min=1 missing, got $yOut")
|
||||||
assertTrue(yOut.contains(10f), "max=10 missing, got $yOut")
|
assertTrue(yOut.contains(10f), "max=10 missing, got $yOut")
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// ---------- T15: LTTB branch coverage ----------
|
||||||
|
|
||||||
|
@Test fun lttb_belowPixelWidth_returnsExactSamples() {
|
||||||
|
// n=5, pixelWidth=10 → pass-through (line 41-44).
|
||||||
|
val ts = longArrayOf(0L, 100L, 200L, 300L, 400L)
|
||||||
|
val v = floatArrayOf(1f, 2f, 3f, 4f, 5f)
|
||||||
|
val count = decimator.decimate(ts, v, 5, 0L, 1000L, 10, outX, outY, mode = LodMode.LTTB)
|
||||||
|
assertEquals(5, count)
|
||||||
|
for (i in 0 until count) {
|
||||||
|
assertEquals(v[i], outY[i], "LTTB pass-through must mirror input at i=$i")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun lttb_singleColumn_returnsSingleSample() {
|
||||||
|
// pw=2, windowMs=100 → col boundary at tRel=50.
|
||||||
|
// Cluster all n samples in col 0: ts cycles through [0, 49].
|
||||||
|
// n > pixelWidth=2 forces LTTB main branch (bypasses pass-through).
|
||||||
|
val n = 100
|
||||||
|
val ts = LongArray(n) { (it % 50).toLong() }
|
||||||
|
val v = FloatArray(n) { (it + 1).toFloat() }
|
||||||
|
val count = decimator.decimate(ts, v, n, 0L, 100L, 2, outX, outY, mode = LodMode.LTTB)
|
||||||
|
assertEquals(1, count, "single occupied column should emit 1 LTTB sample")
|
||||||
|
assertEquals(0.5f, outX[0], "single-col output X must be col 0 center")
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun lttb_twoBucketsBasic() {
|
||||||
|
// 100 samples spread across 2 cols (pw=2, windowMs=200, ts in [0, 199]).
|
||||||
|
val n = 100
|
||||||
|
val ts = LongArray(n) { (it * 2L) } // 0,2,4,...,198
|
||||||
|
val v = FloatArray(n) { it.toFloat() }
|
||||||
|
val count = decimator.decimate(ts, v, n, 0L, 200L, 2, outX, outY, mode = LodMode.LTTB)
|
||||||
|
assertEquals(2, count, "LTTB across 2 cols should emit 2 points, got $count")
|
||||||
|
// First col anchor = first sample value.
|
||||||
|
assertEquals(0f, outY[0])
|
||||||
|
// Second col is the last bucket (nextCol < 0 path) → last sample value.
|
||||||
|
// Last sample of second bucket: largest ts < 200 with col=1 → ts=198 (i=99, v=99f).
|
||||||
|
assertEquals(99f, outY[1])
|
||||||
|
assertTrue(outX[1] > outX[0], "outX must be monotonic")
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun lttb_triangleAreaSelectionPicksOutlier() {
|
||||||
|
// 3 buckets. Middle bucket has one outlier with large deviation.
|
||||||
|
// pw=3, windowMs=300, ts split across cols [0..99],[100..199],[200..299].
|
||||||
|
// Bucket layout:
|
||||||
|
// col 0: ts 0,10,20,30,40,50,60,70,80,90 (v=1f all)
|
||||||
|
// col 1: ts 100,110,...,180 (v=1f) + one outlier ts=150, v=1000f
|
||||||
|
// col 2: ts 200,210,...,290 (v=1f all)
|
||||||
|
val tsList = mutableListOf<Long>()
|
||||||
|
val vList = mutableListOf<Float>()
|
||||||
|
for (t in 0L..90L step 10L) { tsList += t; vList += 1f }
|
||||||
|
for (t in 100L..140L step 10L) { tsList += t; vList += 1f }
|
||||||
|
tsList += 150L; vList += 1000f // outlier
|
||||||
|
for (t in 160L..190L step 10L) { tsList += t; vList += 1f }
|
||||||
|
for (t in 200L..290L step 10L) { tsList += t; vList += 1f }
|
||||||
|
val n = tsList.size
|
||||||
|
val ts = LongArray(n) { tsList[it] }
|
||||||
|
val v = FloatArray(n) { vList[it] }
|
||||||
|
val count = decimator.decimate(ts, v, n, 0L, 300L, 3, outX, outY, mode = LodMode.LTTB)
|
||||||
|
assertEquals(3, count, "expected 3 LTTB points across 3 cols")
|
||||||
|
// Middle output must be the outlier (area maximization).
|
||||||
|
assertEquals(1000f, outY[1], "LTTB middle bucket must pick outlier value 1000f")
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun lttb_emptyBucketsSkippedViaNextNonEmpty() {
|
||||||
|
// pw=10, windowMs=1000. Place samples only in cols 0, 5, 9 → 3 nonempty cols.
|
||||||
|
// Need n > pw=10 to bypass pass-through → cluster multiple samples per nonempty col.
|
||||||
|
val tsList = mutableListOf<Long>()
|
||||||
|
val vList = mutableListOf<Float>()
|
||||||
|
// col 0: tRel ∈ [0, 100) → ts 0..99 step 10 (10 samples).
|
||||||
|
for (t in 0L..90L step 10L) { tsList += t; vList += 1f }
|
||||||
|
// col 5: tRel ∈ [500, 600).
|
||||||
|
for (t in 500L..590L step 10L) { tsList += t; vList += 2f }
|
||||||
|
// col 9: tRel ∈ [900, 1000).
|
||||||
|
for (t in 900L..990L step 10L) { tsList += t; vList += 3f }
|
||||||
|
val n = tsList.size
|
||||||
|
val ts = LongArray(n) { tsList[it] }
|
||||||
|
val v = FloatArray(n) { vList[it] }
|
||||||
|
assertTrue(n > 10, "must exceed pixelWidth=10 to enter LTTB path")
|
||||||
|
val count = decimator.decimate(ts, v, n, 0L, 1000L, 10, outX, outY, mode = LodMode.LTTB)
|
||||||
|
assertEquals(3, count, "LTTB must skip empty buckets, expected 3 outputs")
|
||||||
|
// outX values map to cols 0, 5, 9 → 0.5, 5.5, 9.5.
|
||||||
|
assertEquals(0.5f, outX[0])
|
||||||
|
assertEquals(5.5f, outX[1])
|
||||||
|
assertEquals(9.5f, outX[2])
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun lttb_zeroPixelWidth_returnsZero() {
|
||||||
|
val count = decimator.decimate(longArrayOf(0L), floatArrayOf(1f), 1, 0L, 1000L, 0, outX, outY, mode = LodMode.LTTB)
|
||||||
|
assertEquals(0, count)
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun lttb_zeroSamples_returnsZero() {
|
||||||
|
val count = decimator.decimate(LongArray(0), FloatArray(0), 0, 0L, 1000L, 100, outX, outY, mode = LodMode.LTTB)
|
||||||
|
assertEquals(0, count)
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun lttb_windowMsZero_returnsZero() {
|
||||||
|
val count = decimator.decimate(longArrayOf(0L), floatArrayOf(1f), 1, 0L, 0L, 100, outX, outY, mode = LodMode.LTTB)
|
||||||
|
assertEquals(0, count)
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun lttb_outOfWindowSamplesFiltered() {
|
||||||
|
// ts entries outside [windowStartMs, windowStartMs+windowMs] are dropped (line 33-34).
|
||||||
|
// Use windowStartMs=100, windowMs=200 → in-window ts ∈ [100, 300].
|
||||||
|
val ts = longArrayOf(50L, 99L, 100L, 200L, 300L, 301L, 500L)
|
||||||
|
val v = floatArrayOf(1f, 2f, 3f, 4f, 5f, 6f, 7f)
|
||||||
|
// 7 samples but only 3 in window — n in LTTB will be ≤3 < pixelWidth → pass-through.
|
||||||
|
val count = decimator.decimate(ts, v, ts.size, 100L, 200L, 100, outX, outY, mode = LodMode.LTTB)
|
||||||
|
assertEquals(3, count, "only in-window samples should survive filter")
|
||||||
|
// outY must come from in-window v values {3f, 4f, 5f}.
|
||||||
|
val ySet = outY.copyOf(count).toSet()
|
||||||
|
assertTrue(ySet.contains(3f), "in-window v=3f missing")
|
||||||
|
assertTrue(ySet.contains(4f), "in-window v=4f missing")
|
||||||
|
assertTrue(ySet.contains(5f), "in-window v=5f missing")
|
||||||
|
assertTrue(!ySet.contains(1f), "out-of-window v=1f leaked through")
|
||||||
|
assertTrue(!ySet.contains(7f), "out-of-window v=7f leaked through")
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun lttb_orderPreserved_outputXMonotonic() {
|
||||||
|
// Larger n > pixelWidth across many cols → LTTB main path.
|
||||||
|
val n = 500
|
||||||
|
val ts = LongArray(n) { it.toLong() }
|
||||||
|
val v = FloatArray(n) { kotlin.math.sin(it.toFloat() / 20f) }
|
||||||
|
val count = decimator.decimate(ts, v, n, 0L, n.toLong(), 50, outX, outY, mode = LodMode.LTTB)
|
||||||
|
assertTrue(count > 0, "expected non-empty LTTB output")
|
||||||
|
for (i in 1 until count) {
|
||||||
|
assertTrue(outX[i] > outX[i - 1], "outX must be strictly increasing at i=$i: ${outX[i - 1]} -> ${outX[i]}")
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,433 @@
|
||||||
|
package dev.dtrentin.chart.buffer
|
||||||
|
|
||||||
|
import kotlin.test.Test
|
||||||
|
import kotlin.test.assertEquals
|
||||||
|
import kotlin.test.assertTrue
|
||||||
|
|
||||||
|
class TieredBufferTest {
|
||||||
|
|
||||||
|
private fun outTs() = LongArray(TieredBuffer.TOTAL_CAPACITY)
|
||||||
|
private fun outVs() = FloatArray(TieredBuffer.TOTAL_CAPACITY)
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Regression test for T8: legitimate sample equal to former sentinel value
|
||||||
|
* (Float.MAX_VALUE) must not be dropped or misclassified by tier1 bin
|
||||||
|
* accumulator. After T8 swaps sentinel-based "empty" detection for explicit
|
||||||
|
* hasData flag, MAX_VALUE samples are retained.
|
||||||
|
*/
|
||||||
|
@Test fun tier1BinAcceptsFloatMaxValueSample() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
// All 4 pushes in tier0 (5min retention); tier1 bin = 100ms.
|
||||||
|
// ts=0,50,99 share bin [0,100); ts=100 rolls bin and flushes prior.
|
||||||
|
buf.push(0L, Float.MAX_VALUE)
|
||||||
|
buf.push(50L, Float.MAX_VALUE)
|
||||||
|
buf.push(99L, Float.MAX_VALUE)
|
||||||
|
buf.push(100L, 1f)
|
||||||
|
|
||||||
|
val outTs = LongArray(TieredBuffer.TOTAL_CAPACITY)
|
||||||
|
val outV = FloatArray(TieredBuffer.TOTAL_CAPACITY)
|
||||||
|
// Wide window covering tier0 region — should include raw samples.
|
||||||
|
val n = buf.snapshot(0L, 10_000L, outTs, outV)
|
||||||
|
assertTrue(n >= 4, "expected at least 4 samples in tier0 snapshot, got $n")
|
||||||
|
|
||||||
|
var found = 0
|
||||||
|
for (i in 0 until n) {
|
||||||
|
if (outV[i] == Float.MAX_VALUE) found++
|
||||||
|
}
|
||||||
|
assertTrue(found >= 3, "expected ≥3 MAX_VALUE samples retained, got $found")
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* T12: tier1 M4 bin emits first/min/max/last with their original timestamps,
|
||||||
|
* preserving visual shape. Snapshot via direct tier1 access (no tier0 fallback)
|
||||||
|
* by forcing time advancement well past tier0 retention.
|
||||||
|
*/
|
||||||
|
@Test fun tier1BinPreservesM4() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
// Tier1 bin = 100ms. Push 4 distinct samples into bin [0, 100):
|
||||||
|
// ts=0 v=5 (first)
|
||||||
|
// ts=30 v=1 (min)
|
||||||
|
// ts=60 v=10 (max)
|
||||||
|
// ts=90 v=3 (last)
|
||||||
|
buf.push(0L, 5f)
|
||||||
|
buf.push(30L, 1f)
|
||||||
|
buf.push(60L, 10f)
|
||||||
|
buf.push(90L, 3f)
|
||||||
|
// Roll bin: push a sample past 100ms to trigger flush of prior bin.
|
||||||
|
buf.push(100L, 7f)
|
||||||
|
|
||||||
|
// Force snapshot to read from tier1 (not tier0) by advancing time past
|
||||||
|
// tier0 retention. Push sample at tier0-window-far-future.
|
||||||
|
val farFuture = TieredBuffer.TIER0_DURATION_MS + 200L
|
||||||
|
buf.push(farFuture, 0f)
|
||||||
|
|
||||||
|
val outTs = LongArray(TieredBuffer.TOTAL_CAPACITY)
|
||||||
|
val outV = FloatArray(TieredBuffer.TOTAL_CAPACITY)
|
||||||
|
// Window covers ts=[0, 100) — should hit tier1 (not tier0, since now - TIER0_DUR > 100).
|
||||||
|
val n = buf.snapshot(0L, 100L, outTs, outV)
|
||||||
|
|
||||||
|
assertTrue(n in 1..4, "expected 1..4 M4 records, got $n")
|
||||||
|
|
||||||
|
// Strict chronological order.
|
||||||
|
for (i in 1 until n) {
|
||||||
|
assertTrue(outTs[i] > outTs[i - 1], "ts must be strictly increasing across M4 records at i=$i: ${outTs[i - 1]} -> ${outTs[i]}")
|
||||||
|
}
|
||||||
|
|
||||||
|
// First record = (ts=0, v=5f)
|
||||||
|
assertEquals(0L, outTs[0])
|
||||||
|
assertEquals(5f, outV[0])
|
||||||
|
// Last record = (ts=90, v=3f)
|
||||||
|
assertEquals(90L, outTs[n - 1])
|
||||||
|
assertEquals(3f, outV[n - 1])
|
||||||
|
|
||||||
|
// Min (1f) and max (10f) must appear in the snapshot.
|
||||||
|
var hasMin = false; var hasMax = false
|
||||||
|
for (i in 0 until n) {
|
||||||
|
if (outV[i] == 1f) hasMin = true
|
||||||
|
if (outV[i] == 10f) hasMax = true
|
||||||
|
}
|
||||||
|
assertTrue(hasMin, "min value 1f missing from M4 records")
|
||||||
|
assertTrue(hasMax, "max value 10f missing from M4 records")
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* T12: tier2 M4 bin (1Hz, 1000ms) analogous to tier1 test.
|
||||||
|
* Forces snapshot to read from tier2 by pushing past tier0+tier1 retention.
|
||||||
|
*/
|
||||||
|
@Test fun tier2BinPreservesM4() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
// Tier2 bin = 1000ms. Push 4 distinct samples into bin [0, 1000):
|
||||||
|
// ts=0 v=2 (first)
|
||||||
|
// ts=300 v=8 (max)
|
||||||
|
// ts=600 v=1 (min)
|
||||||
|
// ts=900 v=5 (last)
|
||||||
|
buf.push(0L, 2f)
|
||||||
|
buf.push(300L, 8f)
|
||||||
|
buf.push(600L, 1f)
|
||||||
|
buf.push(900L, 5f)
|
||||||
|
// Roll bin: push sample past 1000ms to flush prior tier2 bin.
|
||||||
|
buf.push(1000L, 4f)
|
||||||
|
|
||||||
|
// Force snapshot to read from tier2 by advancing past tier0 + tier1 retention.
|
||||||
|
val farFuture = TieredBuffer.TIER0_DURATION_MS + TieredBuffer.TIER1_DURATION_MS + 2000L
|
||||||
|
buf.push(farFuture, 0f)
|
||||||
|
|
||||||
|
val outTs = LongArray(TieredBuffer.TOTAL_CAPACITY)
|
||||||
|
val outV = FloatArray(TieredBuffer.TOTAL_CAPACITY)
|
||||||
|
// Window covers ts=[0, 1000) — should hit tier2 only.
|
||||||
|
val n = buf.snapshot(0L, 1000L, outTs, outV)
|
||||||
|
|
||||||
|
assertTrue(n in 1..4, "expected 1..4 M4 records in tier2, got $n")
|
||||||
|
|
||||||
|
// Strict chronological order.
|
||||||
|
for (i in 1 until n) {
|
||||||
|
assertTrue(outTs[i] > outTs[i - 1], "tier2 ts must be strictly increasing at i=$i")
|
||||||
|
}
|
||||||
|
|
||||||
|
// First & last anchors.
|
||||||
|
assertEquals(0L, outTs[0])
|
||||||
|
assertEquals(2f, outV[0])
|
||||||
|
assertEquals(900L, outTs[n - 1])
|
||||||
|
assertEquals(5f, outV[n - 1])
|
||||||
|
|
||||||
|
var hasMin = false; var hasMax = false
|
||||||
|
for (i in 0 until n) {
|
||||||
|
if (outV[i] == 1f) hasMin = true
|
||||||
|
if (outV[i] == 8f) hasMax = true
|
||||||
|
}
|
||||||
|
assertTrue(hasMin, "tier2 min 1f missing")
|
||||||
|
assertTrue(hasMax, "tier2 max 8f missing")
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* T12 (C7 fix): adjacent bins must not collide at the same timestamp.
|
||||||
|
* Previous (midTs, min)/(midTs, max) pair produced a vertical spike at flush time;
|
||||||
|
* with M4 each record carries its original ts → strict monotonicity preserved
|
||||||
|
* across bin boundaries.
|
||||||
|
*/
|
||||||
|
@Test fun noVerticalSpikesAtBinBoundaries() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
// Bin A [0, 100): push samples that span the bin's value range.
|
||||||
|
buf.push(10L, 4f)
|
||||||
|
buf.push(40L, 1f)
|
||||||
|
buf.push(70L, 9f)
|
||||||
|
buf.push(99L, 3f)
|
||||||
|
// Bin B [100, 200): distinct values.
|
||||||
|
buf.push(110L, 6f)
|
||||||
|
buf.push(140L, 2f)
|
||||||
|
buf.push(170L, 8f)
|
||||||
|
buf.push(199L, 5f)
|
||||||
|
// Flush bin B by triggering a rollover.
|
||||||
|
buf.push(200L, 7f)
|
||||||
|
|
||||||
|
// Force snapshot from tier1.
|
||||||
|
val farFuture = TieredBuffer.TIER0_DURATION_MS + 500L
|
||||||
|
buf.push(farFuture, 0f)
|
||||||
|
|
||||||
|
val outTs = LongArray(TieredBuffer.TOTAL_CAPACITY)
|
||||||
|
val outV = FloatArray(TieredBuffer.TOTAL_CAPACITY)
|
||||||
|
val n = buf.snapshot(0L, 200L, outTs, outV)
|
||||||
|
|
||||||
|
assertTrue(n >= 4, "expected ≥4 tier1 records across two bins, got $n")
|
||||||
|
|
||||||
|
// Strict monotonicity across all records, including the bin A→B boundary.
|
||||||
|
for (i in 1 until n) {
|
||||||
|
assertTrue(
|
||||||
|
outTs[i] > outTs[i - 1],
|
||||||
|
"C7 regression: ts not strictly increasing at i=$i (${outTs[i - 1]} -> ${outTs[i]})",
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------- T15: empty state ----------
|
||||||
|
|
||||||
|
@Test fun snapshot_emptyBuffer_returnsZero() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
val n = buf.snapshot(0L, 10_000L, outTs(), outVs())
|
||||||
|
assertEquals(0, n)
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun latestTimestampMs_emptyBuffer_returnsNegative() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
assertEquals(-1L, buf.latestTimestampMs())
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------- T15: tier0 only ----------
|
||||||
|
|
||||||
|
@Test fun tier0_singleSample_snapshotReturnsIt() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
buf.push(100L, 1.5f)
|
||||||
|
val ts = outTs(); val vs = outVs()
|
||||||
|
val n = buf.snapshot(0L, 10_000L, ts, vs)
|
||||||
|
assertEquals(1, n)
|
||||||
|
assertEquals(100L, ts[0])
|
||||||
|
assertEquals(1.5f, vs[0])
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun tier0_multipleSamples_preservesOrder() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
val srcTs = longArrayOf(10L, 20L, 30L, 40L, 50L)
|
||||||
|
val srcVs = floatArrayOf(1f, 2f, 3f, 4f, 5f)
|
||||||
|
for (i in srcTs.indices) buf.push(srcTs[i], srcVs[i])
|
||||||
|
val ts = outTs(); val vs = outVs()
|
||||||
|
val n = buf.snapshot(0L, 10_000L, ts, vs)
|
||||||
|
assertEquals(5, n)
|
||||||
|
for (i in 1 until n) {
|
||||||
|
assertTrue(ts[i] >= ts[i - 1], "expected non-decreasing ts at i=$i")
|
||||||
|
}
|
||||||
|
// Values match source in order.
|
||||||
|
for (i in 0 until n) {
|
||||||
|
assertEquals(srcTs[i], ts[i])
|
||||||
|
assertEquals(srcVs[i], vs[i])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------- T15: tier roll boundaries ----------
|
||||||
|
|
||||||
|
@Test fun tier1Roll_singleBinFlush() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
// 3 samples in tier1 bin [0, 100), then roll bin with ts=100.
|
||||||
|
buf.push(10L, 1f)
|
||||||
|
buf.push(40L, 2f)
|
||||||
|
buf.push(80L, 3f)
|
||||||
|
buf.push(100L, 4f)
|
||||||
|
// Force tier1 snapshot path: push far-future.
|
||||||
|
val farFuture = TieredBuffer.TIER0_DURATION_MS + 300L
|
||||||
|
buf.push(farFuture, 9f)
|
||||||
|
|
||||||
|
val ts = outTs(); val vs = outVs()
|
||||||
|
val n = buf.snapshot(0L, 100L, ts, vs)
|
||||||
|
assertTrue(n >= 1, "expected ≥1 tier1 flushed record, got $n")
|
||||||
|
// All records inside [0, 100).
|
||||||
|
for (i in 0 until n) {
|
||||||
|
assertTrue(ts[i] in 0L..99L, "tier1 record out of window at i=$i: ${ts[i]}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun tier1Roll_emptyBinSkipped() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
// Single sample in bin [0, 100).
|
||||||
|
buf.push(50L, 7f)
|
||||||
|
// Jump several empty bins ahead → roll directly to bin [500, 600).
|
||||||
|
buf.push(550L, 8f)
|
||||||
|
// Push another to flush bin [500, 600).
|
||||||
|
buf.push(600L, 9f)
|
||||||
|
// Force tier1 path.
|
||||||
|
val farFuture = TieredBuffer.TIER0_DURATION_MS + 300L
|
||||||
|
buf.push(farFuture, 0f)
|
||||||
|
|
||||||
|
val ts = outTs(); val vs = outVs()
|
||||||
|
// Window over the empty span [100, 500): expect zero records (no spurious flush).
|
||||||
|
val n = buf.snapshot(100L, 400L, ts, vs)
|
||||||
|
assertEquals(0, n, "empty bins between sparse samples must not produce records")
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun tier2Roll_singleBinFlush() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
// tier2 bin = 1000ms.
|
||||||
|
buf.push(100L, 1f)
|
||||||
|
buf.push(400L, 2f)
|
||||||
|
buf.push(800L, 3f)
|
||||||
|
// Roll tier2 bin.
|
||||||
|
buf.push(1000L, 4f)
|
||||||
|
// Force tier2 snapshot: push past tier0 + tier1 retention.
|
||||||
|
val farFuture = TieredBuffer.TIER0_DURATION_MS + TieredBuffer.TIER1_DURATION_MS + 2000L
|
||||||
|
buf.push(farFuture, 9f)
|
||||||
|
|
||||||
|
val ts = outTs(); val vs = outVs()
|
||||||
|
val n = buf.snapshot(0L, 1000L, ts, vs)
|
||||||
|
assertTrue(n >= 1, "expected ≥1 tier2 record, got $n")
|
||||||
|
for (i in 0 until n) {
|
||||||
|
assertTrue(ts[i] in 0L..999L, "tier2 record out of window at i=$i: ${ts[i]}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------- T15: window crossing tier boundaries ----------
|
||||||
|
|
||||||
|
@Test fun snapshot_windowSpansT0T1Boundary() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
// Old data destined for tier1 flush.
|
||||||
|
buf.push(0L, 1f)
|
||||||
|
buf.push(50L, 2f)
|
||||||
|
buf.push(99L, 3f)
|
||||||
|
// Flush bin [0,100).
|
||||||
|
buf.push(100L, 4f)
|
||||||
|
// Advance now past tier0 retention so old data exits tier0.
|
||||||
|
val nowTs = TieredBuffer.TIER0_DURATION_MS + 1000L
|
||||||
|
buf.push(nowTs, 5f)
|
||||||
|
// Recent sample fresh in tier0.
|
||||||
|
buf.push(nowTs + 100L, 6f)
|
||||||
|
|
||||||
|
val ts = outTs(); val vs = outVs()
|
||||||
|
// Window spans from before tier0Boundary to now → should pick up both tier1 and tier0 ranges.
|
||||||
|
val n = buf.snapshot(0L, nowTs + 200L, ts, vs)
|
||||||
|
assertTrue(n >= 2, "expected ≥2 samples across t0/t1, got $n")
|
||||||
|
// Chronological non-decreasing.
|
||||||
|
for (i in 1 until n) {
|
||||||
|
assertTrue(ts[i] >= ts[i - 1], "non-monotonic at i=$i: ${ts[i - 1]} -> ${ts[i]}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun snapshot_windowSpansT1T2Boundary() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
// Very old samples for tier2.
|
||||||
|
buf.push(0L, 1f)
|
||||||
|
buf.push(500L, 2f)
|
||||||
|
// Roll tier2 bin.
|
||||||
|
buf.push(1000L, 3f)
|
||||||
|
// Mid-age samples for tier1.
|
||||||
|
val tier1Start = TieredBuffer.TIER1_DURATION_MS
|
||||||
|
buf.push(tier1Start, 10f)
|
||||||
|
buf.push(tier1Start + 50L, 11f)
|
||||||
|
buf.push(tier1Start + 100L, 12f)
|
||||||
|
// Force snapshot past both tier0 + tier1 retention.
|
||||||
|
val nowTs = TieredBuffer.TIER0_DURATION_MS + TieredBuffer.TIER1_DURATION_MS + 2000L
|
||||||
|
buf.push(nowTs, 99f)
|
||||||
|
|
||||||
|
val ts = outTs(); val vs = outVs()
|
||||||
|
// Wide window covering both tier1 and tier2 regions.
|
||||||
|
val n = buf.snapshot(0L, nowTs + 100L, ts, vs)
|
||||||
|
assertTrue(n >= 2, "expected ≥2 records across t1/t2, got $n")
|
||||||
|
for (i in 1 until n) {
|
||||||
|
assertTrue(ts[i] >= ts[i - 1], "non-monotonic at i=$i")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun snapshot_windowSpansAll3Tiers() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
// Oldest tier2 sample.
|
||||||
|
buf.push(0L, 1f)
|
||||||
|
buf.push(1000L, 2f) // flush bin [0,1000)
|
||||||
|
// Mid tier1 region.
|
||||||
|
val tier1Start = TieredBuffer.TIER1_DURATION_MS
|
||||||
|
buf.push(tier1Start, 5f)
|
||||||
|
buf.push(tier1Start + 100L, 6f) // flush bin
|
||||||
|
// Recent tier0.
|
||||||
|
val nowTs = TieredBuffer.TIER0_DURATION_MS + TieredBuffer.TIER1_DURATION_MS + 1000L
|
||||||
|
buf.push(nowTs, 10f)
|
||||||
|
buf.push(nowTs + 50L, 11f)
|
||||||
|
|
||||||
|
val ts = outTs(); val vs = outVs()
|
||||||
|
val n = buf.snapshot(0L, nowTs + 200L, ts, vs)
|
||||||
|
assertTrue(n >= 3, "expected ≥3 records across all tiers, got $n")
|
||||||
|
for (i in 1 until n) {
|
||||||
|
assertTrue(ts[i] >= ts[i - 1], "non-monotonic at i=$i: ${ts[i - 1]} -> ${ts[i]}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------- T15: clear() ----------
|
||||||
|
|
||||||
|
@Test fun clear_resetsBuffer() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
for (i in 0 until 10) buf.push(i * 10L, i.toFloat())
|
||||||
|
buf.clear()
|
||||||
|
val n = buf.snapshot(0L, 10_000L, outTs(), outVs())
|
||||||
|
assertEquals(0, n)
|
||||||
|
assertEquals(-1L, buf.latestTimestampMs())
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun clear_resetsBinAccumulators() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
// Seed tier1 bin [0, 100) with 3 samples — pre-flush, accumulator holds state.
|
||||||
|
buf.push(10L, 100f)
|
||||||
|
buf.push(40L, 200f)
|
||||||
|
buf.push(80L, 300f)
|
||||||
|
buf.clear()
|
||||||
|
|
||||||
|
// Push 1 fresh sample into bin [0, 100) and roll.
|
||||||
|
buf.push(20L, 1f)
|
||||||
|
buf.push(100L, 2f) // roll flushes the post-clear single-sample bin
|
||||||
|
// Force tier1 snapshot.
|
||||||
|
val farFuture = TieredBuffer.TIER0_DURATION_MS + 300L
|
||||||
|
buf.push(farFuture, 0f)
|
||||||
|
|
||||||
|
val ts = outTs(); val vs = outVs()
|
||||||
|
val n = buf.snapshot(0L, 100L, ts, vs)
|
||||||
|
assertTrue(n >= 1, "expected ≥1 post-clear tier1 record, got $n")
|
||||||
|
// Records must only reflect post-clear data (single sample at ts=20, v=1f).
|
||||||
|
for (i in 0 until n) {
|
||||||
|
assertEquals(20L, ts[i], "stale ts leaked through clear at i=$i")
|
||||||
|
assertEquals(1f, vs[i], "stale value leaked through clear at i=$i")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// ---------- T15: edge cases ----------
|
||||||
|
|
||||||
|
@Test fun snapshot_windowEntirelyBeforeData_returnsZero() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
buf.push(10_000L, 1f)
|
||||||
|
buf.push(10_500L, 2f)
|
||||||
|
val n = buf.snapshot(0L, 5_000L, outTs(), outVs())
|
||||||
|
assertEquals(0, n)
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun snapshot_windowEntirelyAfterData_returnsZero() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
buf.push(500L, 1f)
|
||||||
|
buf.push(1_000L, 2f)
|
||||||
|
val n = buf.snapshot(10_000L, 10_000L, outTs(), outVs())
|
||||||
|
assertEquals(0, n)
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun tier1BinHandlesSamePostFlushTimestamp() {
|
||||||
|
val buf = TieredBuffer()
|
||||||
|
// Bin [0, 100): single sample.
|
||||||
|
buf.push(50L, 1f)
|
||||||
|
// Roll to bin [100, 200) at exactly ts=100.
|
||||||
|
buf.push(100L, 2f)
|
||||||
|
// Another sample at the same ts=100 within new bin.
|
||||||
|
buf.push(100L, 3f)
|
||||||
|
// Continue with monotonic-non-decreasing ts.
|
||||||
|
buf.push(150L, 4f)
|
||||||
|
buf.push(200L, 5f) // roll again
|
||||||
|
|
||||||
|
val ts = outTs(); val vs = outVs()
|
||||||
|
// Wide window via tier0 fallback — no crash expected, sane ordering.
|
||||||
|
val n = buf.snapshot(0L, 1_000L, ts, vs)
|
||||||
|
assertTrue(n >= 5, "expected raw samples retained in tier0, got $n")
|
||||||
|
for (i in 1 until n) {
|
||||||
|
assertTrue(ts[i] >= ts[i - 1], "monotonic-non-decreasing ts violated at i=$i")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -0,0 +1,190 @@
|
||||||
|
package dev.dtrentin.chart.render
|
||||||
|
|
||||||
|
import kotlin.math.abs
|
||||||
|
import kotlin.test.Test
|
||||||
|
import kotlin.test.assertEquals
|
||||||
|
import kotlin.test.assertTrue
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Pins behavior of [NumberFormat] helpers. Do not modify expected strings unless
|
||||||
|
* the source has been intentionally changed and the v0.4.0 plan task T14 updated.
|
||||||
|
*/
|
||||||
|
class NumberFormatTest {
|
||||||
|
|
||||||
|
// ── formatFixed ────────────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
@Test fun formatFixed_zero_returnsZeroWithDecimals() {
|
||||||
|
assertEquals("0.00", NumberFormat.formatFixed(0.0, 2))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatFixed_positiveSimple() {
|
||||||
|
assertEquals("1.5", NumberFormat.formatFixed(1.5, 1))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatFixed_negativeSimple() {
|
||||||
|
assertEquals("-1.5", NumberFormat.formatFixed(-1.5, 1))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatFixed_rounding999() {
|
||||||
|
assertEquals("1.00", NumberFormat.formatFixed(0.999, 2))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatFixed_roundingHalfUpUnambiguous() {
|
||||||
|
// 1.0050001 is unambiguously above the half-way point on both JVM and K/Native.
|
||||||
|
// Avoids platform-dependent half-even/half-up behavior on the exact 1.005 boundary.
|
||||||
|
assertEquals("1.01", NumberFormat.formatFixed(1.0050001, 2))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatFixed_carryOver() {
|
||||||
|
assertEquals("100.00", NumberFormat.formatFixed(99.999, 2))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatFixed_zeroDecimals() {
|
||||||
|
assertEquals("4", NumberFormat.formatFixed(3.7, 0))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatFixed_largeValue() {
|
||||||
|
assertEquals("12345.7", NumberFormat.formatFixed(12345.678, 1))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatFixed_negativeRoundsToZero_signSuppressed() {
|
||||||
|
// Sign suppression when |value| rounds to 0 across both whole and frac parts.
|
||||||
|
assertEquals("0.00", NumberFormat.formatFixed(-0.001, 2))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatFixed_negativeZeroDecimals() {
|
||||||
|
assertEquals("-4", NumberFormat.formatFixed(-3.7, 0))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatFixed_largeSafeValue() {
|
||||||
|
// Value safely within Long range (Long.MAX_VALUE ~ 9.22e18).
|
||||||
|
// See NumberFormat.kt TODO(v0.5.0) — values >= ~1e19 overflow Long cast.
|
||||||
|
assertEquals("1000000000000000.0", NumberFormat.formatFixed(1e15, 1))
|
||||||
|
}
|
||||||
|
|
||||||
|
// ── formatScientific ───────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
@Test fun formatScientific_zero() {
|
||||||
|
assertEquals("0.00e+00", NumberFormat.formatScientific(0.0, 2))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatScientific_positivePower() {
|
||||||
|
assertEquals("1.23e+05", NumberFormat.formatScientific(1.23e5, 2))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatScientific_negativePower() {
|
||||||
|
assertEquals("1.23e-05", NumberFormat.formatScientific(1.23e-5, 2))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatScientific_negativeValue() {
|
||||||
|
assertEquals("-2.5e+03", NumberFormat.formatScientific(-2.5e3, 1))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatScientific_smallPositive() {
|
||||||
|
assertEquals("5.00e-03", NumberFormat.formatScientific(0.005, 2))
|
||||||
|
}
|
||||||
|
|
||||||
|
// ── formatAxisValue ────────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
@Test fun formatAxisValue_zero_returnsZero() {
|
||||||
|
assertEquals("0", NumberFormat.formatAxisValue(0.0, 2))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatAxisValue_smallScientific() {
|
||||||
|
// |0.005| < 0.01 → scientific branch
|
||||||
|
assertEquals("5.00e-03", NumberFormat.formatAxisValue(0.005, 2))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatAxisValue_largeScientific() {
|
||||||
|
// |2e6| >= 1e5 → scientific branch
|
||||||
|
assertEquals("2.00e+06", NumberFormat.formatAxisValue(2e6, 2))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatAxisValue_normalFixed() {
|
||||||
|
assertEquals("42.5", NumberFormat.formatAxisValue(42.5, 1))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatAxisValue_negativeNormal() {
|
||||||
|
assertEquals("-7.25", NumberFormat.formatAxisValue(-7.25, 2))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatAxisValue_boundaryAt0_01_usesFixed() {
|
||||||
|
// absVal >= 0.01 → fixed branch (not scientific). Pins boundary.
|
||||||
|
assertEquals("0.01", NumberFormat.formatAxisValue(0.01, 2))
|
||||||
|
}
|
||||||
|
|
||||||
|
// ── formatTimeSec ──────────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
@Test fun formatTimeSec_zero() {
|
||||||
|
assertEquals("0s", NumberFormat.formatTimeSec(0.0))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatTimeSec_secondsBelow60() {
|
||||||
|
assertEquals("45s", NumberFormat.formatTimeSec(45.0))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatTimeSec_exactlyMinute() {
|
||||||
|
assertEquals("1:00", NumberFormat.formatTimeSec(60.0))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatTimeSec_mmSs() {
|
||||||
|
assertEquals("2:05", NumberFormat.formatTimeSec(125.0))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatTimeSec_exactlyHour() {
|
||||||
|
assertEquals("1:00:00", NumberFormat.formatTimeSec(3600.0))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatTimeSec_hhMmSs() {
|
||||||
|
assertEquals("1:02:05", NumberFormat.formatTimeSec(3725.0))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatTimeSec_negativeSeconds() {
|
||||||
|
assertEquals("-1:05", NumberFormat.formatTimeSec(-65.0))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun formatTimeSec_negativeOverHour() {
|
||||||
|
assertEquals("-1:01:40", NumberFormat.formatTimeSec(-3700.0))
|
||||||
|
}
|
||||||
|
|
||||||
|
// ── pow10 ──────────────────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
@Test fun pow10_zero_returnsOne() {
|
||||||
|
assertEquals(1.0, NumberFormat.pow10(0))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun pow10_positive() {
|
||||||
|
assertEquals(1000.0, NumberFormat.pow10(3))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun pow10_negative() {
|
||||||
|
val result = NumberFormat.pow10(-2)
|
||||||
|
assertTrue(abs(result - 0.01) < 1e-12, "expected ~0.01, got $result")
|
||||||
|
}
|
||||||
|
|
||||||
|
// ── niceInterval ───────────────────────────────────────────────────────────
|
||||||
|
|
||||||
|
@Test fun niceInterval_zeroRange_returnsFallbackOne() {
|
||||||
|
assertEquals(1.0, NumberFormat.niceInterval(0.0, 5))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun niceInterval_negativeRange_returnsFallbackOne() {
|
||||||
|
assertEquals(1.0, NumberFormat.niceInterval(-5.0, 5))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun niceInterval_typicalRange10() {
|
||||||
|
// rough = 2, mag = 1, rough/mag = 2.0 → 2 * mag = 2.0
|
||||||
|
assertEquals(2.0, NumberFormat.niceInterval(10.0, 5))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun niceInterval_largeRange1000() {
|
||||||
|
// rough = 200, mag = 100, rough/mag = 2.0 → 2 * mag = 200.0
|
||||||
|
assertEquals(200.0, NumberFormat.niceInterval(1000.0, 5))
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test fun niceInterval_smallRange() {
|
||||||
|
// range=1, target=5 → rough=0.2, log10=-0.7, floor=-1, mag=0.1, rough/mag=2.0 → 0.2
|
||||||
|
val result = NumberFormat.niceInterval(1.0, 5)
|
||||||
|
assertTrue(abs(result - 0.2) < 1e-12, "expected ~0.2, got $result")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
@ -1,11 +0,0 @@
|
||||||
package dev.dtrentin.chart
|
|
||||||
|
|
||||||
import platform.Foundation.NSDate
|
|
||||||
|
|
||||||
private const val REFERENCE_DATE_OFFSET_SEC = 978_307_200.0
|
|
||||||
|
|
||||||
internal actual fun currentTimeMs(): Long {
|
|
||||||
val date = NSDate()
|
|
||||||
val secsSince1970 = date.timeIntervalSinceReferenceDate + REFERENCE_DATE_OFFSET_SEC
|
|
||||||
return (secsSince1970 * 1000).toLong()
|
|
||||||
}
|
|
||||||
|
|
@ -9,6 +9,8 @@ kotlin-test = "2.1.0"
|
||||||
activity-compose = "1.10.1"
|
activity-compose = "1.10.1"
|
||||||
androidx-compose-bom = "2025.01.01"
|
androidx-compose-bom = "2025.01.01"
|
||||||
material3 = "1.3.1"
|
material3 = "1.3.1"
|
||||||
|
binary-compatibility-validator = "0.16.3"
|
||||||
|
kotlinx-datetime = "0.6.2"
|
||||||
|
|
||||||
[libraries]
|
[libraries]
|
||||||
compose-runtime = { module = "org.jetbrains.compose.runtime:runtime", version.ref = "compose-multiplatform" }
|
compose-runtime = { module = "org.jetbrains.compose.runtime:runtime", version.ref = "compose-multiplatform" }
|
||||||
|
|
@ -16,6 +18,7 @@ compose-ui = { module = "org.jetbrains.compose.ui:ui", version.ref = "compose-mu
|
||||||
compose-ui-graphics = { module = "org.jetbrains.compose.ui:ui-graphics", version.ref = "compose-multiplatform" }
|
compose-ui-graphics = { module = "org.jetbrains.compose.ui:ui-graphics", version.ref = "compose-multiplatform" }
|
||||||
compose-foundation = { module = "org.jetbrains.compose.foundation:foundation", version.ref = "compose-multiplatform" }
|
compose-foundation = { module = "org.jetbrains.compose.foundation:foundation", version.ref = "compose-multiplatform" }
|
||||||
coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "coroutines" }
|
coroutines-core = { module = "org.jetbrains.kotlinx:kotlinx-coroutines-core", version.ref = "coroutines" }
|
||||||
|
kotlinx-datetime = { module = "org.jetbrains.kotlinx:kotlinx-datetime", version.ref = "kotlinx-datetime" }
|
||||||
androidx-core = { module = "androidx.core:core-ktx", version.ref = "androidx-core" }
|
androidx-core = { module = "androidx.core:core-ktx", version.ref = "androidx-core" }
|
||||||
kotlin-test = { module = "org.jetbrains.kotlin:kotlin-test", version.ref = "kotlin-test" }
|
kotlin-test = { module = "org.jetbrains.kotlin:kotlin-test", version.ref = "kotlin-test" }
|
||||||
androidx-activity-compose = { module = "androidx.activity:activity-compose", version.ref = "activity-compose" }
|
androidx-activity-compose = { module = "androidx.activity:activity-compose", version.ref = "activity-compose" }
|
||||||
|
|
@ -31,3 +34,4 @@ compose-compiler = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "
|
||||||
android-library = { id = "com.android.library", version.ref = "android-gradle" }
|
android-library = { id = "com.android.library", version.ref = "android-gradle" }
|
||||||
android-application = { id = "com.android.application", version.ref = "android-gradle" }
|
android-application = { id = "com.android.application", version.ref = "android-gradle" }
|
||||||
kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
|
kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
|
||||||
|
kotlinx-bcv = { id = "org.jetbrains.kotlinx.binary-compatibility-validator", version.ref = "binary-compatibility-validator" }
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue