Overview
Feature Improvements & Known Issues
The current engineering journal: recent improvements, resolved defects, active issues, physical proof and sprint priorities.
Historical 2026-08-01 project summary — superseded
| Item | Current record |
|---|---|
| Last updated | 2026-08-01 |
| Standard Widget proof total | 29 of 39 (74%) |
| Remaining Standard widgets | 10 |
| Reference stack | LVGL 9.2.2 · ESP-IDF 5.5.4 |
| Target | Waveshare ESP32-P4-WiFi6-Touch-LCD-7B · 1024 × 600 |
| Development phase | End-of-sprint archive; Text and Icon final hardware re-proof pending |
Recently improved
- —2026-08-01 — Button, Heading, Box and Divider completed physical ESP32-P4 proof.
- —Canonical Icon Pipeline now carries selection, persisted assets, Canvas, Browser Preview and native export through one normalized model.
- —Icon selector persistence now keeps real source dimensions instead of forcing the selector preview dimensions into saved metadata.
- —Source-aware scaling applies the shared 92% automatic-fit rule when boxSize is unset while preserving exact explicit sizes.
- —Fi Runtime now separates 90 object creation, 95 optional click hooks and 96 generated presentation APIs; the click path is physically proven.
- —Native TileView replaced the synthetic export.
- —Standard Text gained multiline wrapping/export parity and remains READY FOR FINAL HARDWARE RE-PROOF.
- —Divider now receives immediately visible vertical default geometry without changing horizontal behavior.
- —Heading gained multiline and alignment parity; Box gained child ownership and Browser nesting parity.
| Date | Subsystem | Improvement and validation |
|---|---|---|
| 2026-08-01 | Standard Text | Multiline Inspector authoring, preserved whitespace, shared bounded preview wrapping and native LVGL size/wrap/alignment export. Focused tests passed 18/18; broader selected regressions passed 72/72. Corrected hardware re-proof remains open. |
| 2026-07-31 | TileView | Synthetic panels were replaced with native LVGL paging. Horizontal/vertical navigation, coordinates, callbacks and repeated ESP32-P4 stability passed. |
| 2026-07-31 | Spinbox | Completed the native Registry-to-Standalone vertical slice with signed/decimal values, clamping, rollover, collision-safe runtime APIs and physical proof. |
| 2026-07-31 | Registry and Runtime SDK | Consolidated widget authority and strengthened generated silent-setter/genuine-user-hook contracts. |
| 2026-07-30 | Documentation Centre | Published searchable static documentation for Studio, generated C, Runtime SDK, ESP-IDF and hardware evidence boundaries. |
Resolved issues
- —Text wrapping software correction — actual bounds and LV_LABEL_LONG_WRAP are applied before the complete escaped label text; corrected physical re-proof remains a separate open gate.
- —Spinbox export coordinates — helper geometry now derives from normalized component bounds and passed live/Standalone proof.
- —Canvas click suppression — authoring gestures no longer consume the Spinbox control interaction path.
- —Synthetic TileView export — replaced with native LVGL tiles, directions and active-coordinate transitions.
- —List callback validation — controlled physical taps returned one matching index/text callback.
- —TabView startup suppression — startup and setters remain silent while effective physical selection emits once.
- —SD filename compatibility — bounded host/export and firmware filename handling were aligned.
Historical active issues — superseded
| Priority | Subsystem | Description | Next action |
|---|---|---|---|
| P1 | Standard Text | READY FOR FINAL HARDWARE RE-PROOF after wrapping and multiline parity correction. | Compare Live/Standalone blocks, flash and visually verify both proof strings plus all alignments. |
| P1 | Standard Icon | READY FOR FINAL HARDWARE RE-PROOF after source-aware automatic sizing and clipping correction. | Compare Live/Standalone blocks, flash both and verify complete edges against Canvas and Browser Preview. |
| P1 | Fi Icon Runtime | Click hooks are proven; presentation setters and full Fi Runtime remain short of hardware proof. | Prove colour, opacity, visibility, retained/suppressed state, click-disabled behavior, independent instances and Standalone parity. |
| P2 | Studio TypeScript | Full checking reports two existing unrelated diagnostics in the CircularProgress test preview and StandardListPreview polymorphic prop typing. | Fix each in its owning widget task without weakening compiler settings. |
| P2 | Widget proof backlog | The authoritative ledger records 10 Standard widgets outside full proof; QR scanning plus Text and Icon final re-proof remain explicit gates. | Complete one isolated Registry-to-hardware proof at a time. |
Physical proof ledger
| Widget | Studio | Standalone | ESP32-P4 | Status |
|---|---|---|---|---|
| Spinbox | Passed | Passed | Passed | PROVEN |
| TabView | Passed | Passed | Passed | PROVEN |
| List | Passed | Passed | Passed | PROVEN |
| TileView | Passed | Passed | Passed | PROVEN |
| Button | Passed | Passed | Passed | PROVEN |
| Heading | Passed | Passed | Passed | PROVEN |
| Box | Passed | Passed | Passed | PROVEN |
| Divider | Passed | Passed | Passed | PROVEN |
| Text | Software passed | Shared parity path | Corrected build not yet accepted | READY FOR FINAL HARDWARE RE-PROOF |
| Icon | Software passed | Shared parity path | Corrected build not yet accepted | READY FOR FINAL HARDWARE RE-PROOF |
Validation history
- —2026-08-01 — Button, Heading, Box and Divider physical proof accepted on ESP32-P4.
- —2026-08-01 — Icon sizing/clipping validation passed 157/157 focused tests.
- —2026-08-01 — Standard Text focused suites: 18/18 passed.
- —2026-08-01 — Broader selected Text/theme/export regressions: 72/72 passed.
- —2026-08-01 — Studio TypeScript: two existing unrelated diagnostics remain; no Text diagnostic.
- —2026-07-31 — Spinbox, List, TabView and TileView proof milestones passed on the ESP32-P4 reference target.
- —2026-07-31 — ESP-IDF 5.5.4 / LVGL 9.2.2 live and Standalone builds passed for the recorded proof batch.
Historical test and build limitations — superseded
| Check | Recorded historical boundary |
|---|---|
| Focused Fi validation | 7 suites, 104/104 tests passed; focused ESLint passed. |
| Full regression | 148/152 suites passed; 11 unrelated failures existed in this archived snapshot. |
| TypeScript | Feature code was clean; two unrelated diagnostics remained in this archived snapshot. |
| Production build in source record | Was blocked by unrelated lint errors in test/mock files. |
| ESP-IDF Live build | An obsolete Hosted experiment reported Unknown Slave Target; this is not the current board-profile stack. |
| Standalone feature build | Was not established in this historical Fi snapshot. |
Current sprint
This archived objective recorded the 29/39 end-of-sprint save point. It is retained as history and does not describe the current platform.
Engineering decisions
- —The Widget Registry is the authoritative widget catalogue; Tray and compatibility data derive from it.
- —The Proven Widget Pipeline ends with live and Standalone ESP32-P4 physical evidence, not automation alone.
- —The Runtime SDK is a generated semantic layer above private LVGL objects.
- —Live and Standalone workflows consume the same native generator while retaining different ownership boundaries.
- —Board Profiles, Registry capabilities and serialized usage drive feature gating.
- —Canvas, Browser Preview, generated C, successful builds and hardware observations are distinct evidence classes.
