Changelog

# Changelog

## Unreleased

Breaking changes in the display-present and LCD-host APIs:

- `esp_display_presenter_begin_frame()` renamed to
  `esp_display_presenter_begin_next_frame()`; the frame timeline is now
  presenter-owned and render areas are returned up front.
- `esp_display_presenter_acquire_region()`/`esp_display_presenter_submit_region()`
  renamed to `esp_display_presenter_acquire_buffer()`/
  `esp_display_presenter_submit_buffer()`; submission takes an explicit
  logical area and stride.
- Presenter buffer configuration unified under `drawbuf`
  (`drawbuf_bytes` replaces the per-partition sizing).
- Removed `esp_display_presenter_get_completed_transfer()`/
  `esp_display_presenter_get_completed_present()`; completion tickets are
  now private to the presenter, use `esp_display_presenter_quiesce()`.
- `esp_gsp_esp_lcd_pause()` now yields an opaque pause token consumed by
  `esp_gsp_esp_lcd_resume_paused()`, which resumes the exact paused UI and
  forces its first frame to redraw in full.

## 0.2.3

- Fixed a dual-core PPA teardown race where an application switch could delete
  the global SRM mutex while another render task was entering it, leading to
  an interrupt watchdog timeout in `ppa_blit()`.

## 0.2.2

- Added the dropdown `open_direction` scene property. It accepts `down`
  (default) or `up`, allowing panels near the bottom edge to open above their
  selection box.

## 0.2.1

- Fixed decoded-image cache entry negotiation so a non-zero project baseline
  is still raised to fit the compiled startup images and runtime image
  generations. Applications no longer need to predict each scene's image
  count or carry a per-bundle cache-entry override.
- Applied resolved instance-state, image-cache budget, idle/pointer cadence and
  StackView depth settings to their actual runtime consumers. These settings
  no longer report an effective value while silently using a built-in default.
- GSPB requirements now include declared template instances, per-instance
  state width and StackView depth. Standalone `gspc bundle` reads the exact
  requirements emitted by `gspc build` and rejects stale/missing sidecars
  instead of silently packaging placeholder capacities.
- Source-free registry/local components hide the complete ESP-GSP menuconfig
  tree. Hidden defaults still feed the project bridge; source checkouts retain
  the engineering menu.
- Requirements contract version 2 identifies StackView-depth and
  per-instance-state fields so an older runtime rejects newer gspc output
  instead of silently ignoring them. The 0.2.1 runtime still accepts legacy
  version-1 requirements without interpreting those formerly reserved fields.
- Removed the internal `ESP_GSP_CONFIG_*` Kconfig compatibility layer. Build
  capabilities now come from a schema-generated header; runtime code and
  package consumers read the project/effective configuration structures.
- Prebuilt consumers now use one menu-level visibility rule, so every project
  symbol is present in `sdkconfig` with its schema default while the complete
  engineering menu remains hidden.

## 0.2.0

- Replaced compile-time product configuration in prebuilt libraries with a
  versioned project bridge and immutable per-instance effective policy and
  capacity snapshots.
- Added GSPB capacity requirements, strict schema/ABI validation, AUTO
  resolution and precise diagnostics for undersized application overrides.
- Changed the public override ABI to eight sparse inline entries plus an
  optional caller-owned read-only extension table. The transitional typed
  fields remain available until 0.3.0.
- Runtime pools, List rows and StackView pages are allocated from resolved
  capacities; source, prebuilt, SDL and WASM consumers share the same model.
- GSPB and public configuration artifacts from 0.1.x are incompatible and
  must be regenerated with gspc 0.2.0.

- Applied consumer `menuconfig` runtime settings to source-free prebuilt
  libraries instead of freezing product behavior into the release build.
- Added source-free SDL/headless and WebAssembly simulators to the Registry
  component, built from the same portable core as the device archives.
- Made packaged simulation self-describing through deployable metadata and
  fixed JPEG, FreeType, dynamic-font, component-directory and capability ABI
  support across native and browser runtimes.
- Added final-package simulator tests and minimum/current ESP-IDF consumer
  matrices; stripped debug information from distributed device archives.

## 0.1.3

- Made CMake helpers namespace-independent by using the component's registered
  target and validated the exact Registry-qualified consumption path.
- Added component-specific release tags and stricter per-target FreeType
  symbol validation.

## 0.1.2

- Fixed the source-free managed component to resolve its namespaced ESP-GSP
  target and keep a configurable static component target.
- Included the FreeType provider in every target's prebuilt archive so dynamic
  CJK fonts work from the published package.

## 0.1.1

- Added typed generated helpers for application-backed List components.
- Improved low-memory image, animation, and transition behavior.
- Hardened portable compiler, simulator, header, and component-package checks.
- Made the built-in Dropdown indicator independent of application font glyphs.
- Reorganized user documentation around the recommended integration workflow,
  JSON/Kconfig authoring, public structures, ownership, and troubleshooting.
- Added a repository-scoped ESP-GSP UI vibecoding skill for natural-language
  and reference-image scene creation.

## 0.1.0

- Ahead-of-time JSON scene compiler with embedded assets and generated C APIs.
- RGB565/RGB888 rendering, dirty updates, transitions, gestures, and ESP-LCD
  presentation.
- Controls, layouts, lists, page flows, stacks, drawers, shapes, charts,
  needles, clocks, templates, and runtime positioning.
- Static and runtime text, images, animations, dynamic resources, and Canvas.
- Velocity-aware scene, PageFlow, and Drawer gestures with guarded short flicks,
  adaptive settling, and ESP touch-dropout filtering.
- Transform-aware dynamic/visibility damage and stable conditional-control hit
  testing for keyboards, checkbox/radio controls, and nested viewports.
- User-controlled Showcase for 800x480 RGB565/RGB888 and 1024x600 MIPI-DSI.
- Host simulator, reference renderer, compiler tests, and target examples.