Docs menu

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

ItemCurrent record
Last updated2026-08-01
Standard Widget proof total29 of 39 (74%)
Remaining Standard widgets10
Reference stackLVGL 9.2.2 · ESP-IDF 5.5.4
TargetWaveshare ESP32-P4-WiFi6-Touch-LCD-7B · 1024 × 600
Development phaseEnd-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.
DateSubsystemImprovement and validation
2026-08-01Standard TextMultiline 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-31TileViewSynthetic panels were replaced with native LVGL paging. Horizontal/vertical navigation, coordinates, callbacks and repeated ESP32-P4 stability passed.
2026-07-31SpinboxCompleted the native Registry-to-Standalone vertical slice with signed/decimal values, clamping, rollover, collision-safe runtime APIs and physical proof.
2026-07-31Registry and Runtime SDKConsolidated widget authority and strengthened generated silent-setter/genuine-user-hook contracts.
2026-07-30Documentation CentrePublished 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

PrioritySubsystemDescriptionNext action
P1Standard TextREADY 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.
P1Standard IconREADY 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.
P1Fi Icon RuntimeClick 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.
P2Studio TypeScriptFull 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.
P2Widget proof backlogThe 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

WidgetStudioStandaloneESP32-P4Status
SpinboxPassedPassedPassedPROVEN
TabViewPassedPassedPassedPROVEN
ListPassedPassedPassedPROVEN
TileViewPassedPassedPassedPROVEN
ButtonPassedPassedPassedPROVEN
HeadingPassedPassedPassedPROVEN
BoxPassedPassedPassedPROVEN
DividerPassedPassedPassedPROVEN
TextSoftware passedShared parity pathCorrected build not yet acceptedREADY FOR FINAL HARDWARE RE-PROOF
IconSoftware passedShared parity pathCorrected build not yet acceptedREADY 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

CheckRecorded historical boundary
Focused Fi validation7 suites, 104/104 tests passed; focused ESLint passed.
Full regression148/152 suites passed; 11 unrelated failures existed in this archived snapshot.
TypeScriptFeature code was clean; two unrelated diagnostics remained in this archived snapshot.
Production build in source recordWas blocked by unrelated lint errors in test/mock files.
ESP-IDF Live buildAn obsolete Hosted experiment reported Unknown Slave Target; this is not the current board-profile stack.
Standalone feature buildWas 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.