For AI agents: the "Reading aid" section on this page contains the raw Markdown source identical to the rendered content, with HTML markup and animations removed. AI is advised to read that section directly to understand the content quickly and with less noise.
> Only the changes that affect your code are listed.

- **v1.15.0**: data-view virtualization (`SetItemCount` etc.) + hide/filter/visible-order sort (two coordinate systems); cross-thread/locking hardening; `ComboBox` source-index API; `TreeView::BeginUpdate/SetNodeText`.
- **v1.17.0**: **UIA accessibility** (on by default); **external debug/automation channel** (`SetDebugEnabled`, off by default, commands 1~22); **layout stretch weights** (`ColumnBox`/`RowBox`/`GridLayout` distribute leftover by weight); **automatic ellipsis tooltips** (Label/Button); `CaptionButton::Kind::Pin`; `TreeView` node `bgColor` / `Get/SetScrollOffsetY` / `ScrollToNode`; `Window::DefaultBackdropColor` pure white.
- **v1.18.0**:
  - New `ZufyUICharts.h`: `ChartBase` / `BarChart` / `LineChart` / `PieChart`; `BarChart` horizontal orientation; `PieChart` wheel zoom.
  - New `TextEdit` multi-line editor/viewer; `TextRun`; base `AcceptsTab()`.
  - `UIElement::ReleaseDeviceResourcesRecursive()`; `PageHost` delayed hidden-page cache release (~1.2 s); `ScrollViewer::UseCache()=false`; `SetUseCache(false)` frees immediately.
  - Library fixes: `Snap` DPI scale also set on the UI thread; `ZSignal::Fire` RAII exception safety; `TextBox` shift+click; `Slider` zero-width NaN guard; `ListView` pooled-label re-measure on width change (`poolW_`).
- **v1.19.0**:
  - New **drag & drop** (`ZufyUIDragDrop.h`): `Window::BeginDrag` + `DragDataBuilder`; element `SetDropTargetEnabled` / `OnDragEnter/Over/Leave/Drop` + signals; `Label`/`Button`/`TextBox`/`TextEdit`/`ComboBox` accept and start drags; drag files out to Explorer.
  - New `Expander` (collapsible card: smoothstep easing + rotating arrow + header hover highlight), `SettingsList` (settings rows); image display uses `Label::SetImage` + `SetImageFit` (scale to fully visible).
  - `ComboBox` dropdown arrow is now a chevron that rotates with expansion.
  - Text drag now has **move** semantics: the source deletes the original selection first, then inserts at the drop point (private format dedups same-control drags).
- **v1.19.1**:
  - `TextEdit` undo/redo switched to the **standard scheme** (stack top = current state): both undo and redo **restore the selection and cursor** of that point; Backspace/Delete/typing/paste are one step each; drop insert/move are undoable and redoable.
  - `ScrollViewer`: content is measured at the **viewport width** (fixes "clipped cards" and wrong scroll range from an infinite desired width for FillWidth/wrapping content); content is measured **twice** (re-measured at the narrower width once a vertical bar appears); the content element's own **`margin` is honored**; the clip gets a **1px bleed** so edge borders are not cut in half.
  - The drop caret now shows even when the target is **unfocused**; during a drag the **source selection is preserved** and a preview caret shows at the drop point; dropping inside the original selection is a no-op.
  - `Expander`: header hover highlight (no longer covering the card border), arrow rotates with the collapse easing, `SetIcon` leading icon.
  - Whole-window drag & drop: `Window::SetDropTargetEnabled` + window-level `DragEnter/DragOver/DragLeave/Drop`.
  - Image display merged into `Label` (new `SetImageFit`); the standalone `ImageView` is removed.
- **v1.19.2**:
  - New top **menu bar** `MenuBar` (VS-style: click opens the `Menu`; hovering only highlights, **no auto-expand**; the open entry stays **pressed** until the menu closes; overlaid on the custom title bar by default, empty areas pass through so the title bar stays draggable).
  - New bottom **status bar** `StatusBar` (left/right panels: optional icon + text).
  - `Window`: `SetMenuBar` / `SetStatusBar` / `SetMenuBarInTitleBar` / `SetShowTitleText` (title text and an on-title-bar menu are **mutually exclusive**).
  - `Menu` gains an `onClosed` callback; `MenuWindow::OnPopupClosed`.
- **v1.19.3**:
  - New **theme system** (`ThemeRole` / `Theme` / `ThemeManager`; `Light/Dark/HighContrast`; window-level `SetTheme`; `UIZSignals::ThemeChanged/ThemeReapply`) — one palette by role; re-applied to the visible subtree on page/tab switch.
  - **Follow system**: reads the registry light/dark + system accent, handles `WM_SETTINGCHANGE` / `WM_THEMECHANGED` / `WM_DWMCOLORIZATIONCOLORCHANGED` / `WM_SYSCOLORCHANGE`; `ThemeManager::SetFollowSystem(bool)`.
  - **Explicit instance color wins**: once a control's `Set*Color` is called it is flagged "user-colored" and the theme no longer overrides it; ListView items / TableView cells+rich cells / TreeView cells / headers / alternating rows / Tab selected+hover / radio / NumberBox hover / CheckBox hover all themed.
  - `Backdrop` token (window base white/black); window periphery (caption buttons) follows the **system** theme; `ThemeManager::Map` color remap.
  - Fixes: `ThemeReapply` connection leak (UAF); `SyncThemeBackdrop` swallowing user tint; ListView/TableView/TreeView theme overriding per-item colors.
- **v1.19.4**:
  - New **DSL** (`ZufyUIDsl.h`): `Ref<T>` (`with/on/add` + layout shortcuts), `Make<T>`, `Col/Row/Grid` and per-control short factories — fluent construction / subtree assembly / signal wiring; demo gains a "DSL" page.
  - Fix: `CheckBox` hard-coded `width_/height_` in its ctor → treated as a **fixed width** in `RowBox/ColumnBox` and the **label was clipped**.
  - `ListView/TableView` `RefreshChildren` cache criteria collapsed into a **single signature** `ChildrenSig()` (criteria in one place, harder to forget); consistent with `TreeView`.
  - `ChartBase::MeasureOverride`: falls back to `420×260` when `fill` but unconstrained/no size (no longer collapses to 0).
  - `Window::SetMinSize` default content measure gets a **600 DIP** width floor; `pch.h` `ZufyUI_DEBUG` now `#ifdef _DEBUG`; `Theme::HighContrast` role colors distinguished (no longer all-yellow).
- **v1.19.5**:
  - DSL enhancements: `dsl::App()` / `WindowApp` window builder (fluent config + `run()`); `Page()/Menu()/Settings()` short factories; **SFINAE-gated** per-control sugar (`text/checked/value/placeholder/padding/category/series/slice/item/menu`).
  - The demo "DSL" page uses the sugar and chart composition (`Pie().slice(...)`, `Bar().category(...).series(...)`, `Progress().value(...)`).
- **v1.19.6**:
  - Fix: `ListView` button mode checkbox **hit test was 4px off** (now aligned with the draw / child left edge).
  - Fix: `Label::MeasureOverride` wrap branch **ignored inline children width** (wrapping Labels with `AddChild` squeezed/overflowed text).
  - Docs: version is now a **single source** (`API.md`/`README.md` headers reference the `ZufyUI.h` macro; the generator `mdapi2html.py` injects `1.29.1`); cleaned stale items (`ImageView` default row, `Sort`→`SortItems`, `Menu::onClosed`, chart fill wording, README menu `+90MB` history entry); `mdapi2html.py` fixes `--theme auto` semantics and `c++`-style language names in the code-fence regex.
- **v1.19.7**:
  - Fixes: `ChartBase` swapped horizontal/vertical scrollbar allowance (`viewW` uses the vertical bar, `viewH` the horizontal) → rightmost/bottom content unreachable; `NumberBox` wheel focus check (focus is on the inner `TextBox`); `lastActiveAnimElements_` dangling (erased from the anim sets on destruction, prevents random crashes); `Menu::ShowAt` throwing `bad_weak_ptr` when not shared-owned; `ChildrenSig` missing `EnsureView`; `TreeView::SetDefaultExpandDepth` not applied by `AddRoot`/`AddChild`.
  - Fixes: `ColumnBox`/`RowBox` spacing counts only layout-participating children; `GridLayout` row/col count skips invisible; `Label` wrap ignored/duplicated spacing; `ListView`/`TableView` clear `childrenView_` before releasing labels and release pooled/rich/cell labels; `Window::defaultIMC_` via `ImmAssociateContext`; `DragData::GetFiles` buffer `len+1`; `TextEdit` fires `SelectionChanged` when clearing a selection; `MessageBox` default title localized.
  - Added `TODO.md` (merges the former `FEATURE_PLAN.md`/`OPTIMIZATION_PLAN.md`; the single authoritative backlog).
- **v1.20.0**:
  - **DSL**: `root()` now accepts **any `Layout` subclass** (previously only `Col` had a dedicated overload, so `Row`/`Grid` failed to compile because `Ref` → `shared_ptr<Layout>` needs **two user-defined conversions**); `titleBar/menuBar/statusBar` likewise take a `Ref<T>` directly.
  - **DSL**: `add()` dispatches on the container's real API (`ColumnBox`/`RowBox`/`Label` → `AddChild`; `PageHost` → `AddPage`, skipping non-`Page` arguments; `GridLayout` goes through the new coordinate API). Added `dsl::Cell(row,col,child[,rowSpan,colSpan])` and `Ref::cell`, the `apply()` escape hatch, and `Wrap()`.
  - **DSL**: more shortcuts — size limits (`minWidth/minHeight/maxWidth/maxHeight/minSize/maxSize`), stretch weights (`weight/hWeight/vWeight`), `cache/bleed/clipRect/noClip/cursor/dropTarget/contextMenuEnabled/accessible`, `spacing` (single-arg on `Col`/`Row`, two-arg on `GridLayout`), `padding(Thickness)`, `background/textColor`, `align` (GridLayout); per-control sugar gained `image/imageFit/items/rows/cols/header/cell/root(s)/separator/submenu`; new factories `RadioGroup()/ScrollBar()/Glyph()` (`Image` is a resource object, not a `UIElement`, so it has no factory — use the `Label::SetImage` sugar).
  - **DSL**: `WindowApp::run()` **now calls `Show()`** — `Window::Create` does not show the window, so the previous implementation ran a **message loop with no window** (looked like a hang); added `hidden/minSize/position/frameRateLimit/theme/useAppTheme/dropTarget/icon/titleBarVisible/showTitleText/menuBarInTitleBar` and the window signal hook `on<&Window::Closed>` (`Window`'s signals are plain members, there is no `Connect`); `WindowApp` is now **movable** (it holds a `unique_ptr<Window>`, because `Window` itself is neither copyable nor movable).
  - **Fix**: null guards in `ColumnBox`/`RowBox`/`GridLayout::AddChild` — the DSL's variadic forwarding can pass `nullptr`, which used to dereference a null pointer.
  - **Fix**: `ZufyUIWindowTool.h` was **not self-contained** — it used `Label`/`Button`/`ColumnBox::AddChild` without including `ZufyUIWidgets.h`, relying on the caller to include it first (`pch.h` happened to do so); the include is now present and the header can be included on its own.
  - **Tooling**: new `tools/build.ps1` (one shot: **auto-fix BOM before building** → kill processes holding files → build demo + `ZufyUIDebugger` → run self-tests), `tools/ensure_bom.ps1` (adds a UTF-8 BOM only to C++ sources that contain non-ASCII and lack one, preventing the GBK misparse behind `C2143/C2259/C2888/C4819`), and `tests/zufyui_tests.cpp` + `tools/run_tests.ps1` (47 compile-time/runtime assertions, no window created, runnable from a shell or CI).
- **v1.21.0**:
  - **Fix**: `Card` flashed a **blue hover border** — the theme applier set `SetHoverBorderColor(Accent)` on cards, a behaviour cards never had; removed (hover still changes the background).
  - **Fix**: `ProgressBar` **inner fill radius no longer matched the outer frame after stretching** — the track, the clip geometry and the border still used the member `height_` (construction-time height) while only the fill used the arranged height; all three now use `arrangedRect_.height / 2`.
  - **Fix**: `Button` captions were **ellipsized even with room to spare** — `MeasureOverride` returned a constant `width_` (set to `DefaultWidth = 120` in the constructor); it now grows to fit the text (`max(width_, textWidth + 2*padding)`), with `Button::AutoSizeToText` (static, default `true`) and `SetAutoSizeToText(false)`. **This is a layout behaviour change.**
  - **New**: `ToggleSwitch` uses **duration-driven ease-in-out** (`DefaultAnimationDuration = 0.25s`, stops exactly on time); also fixes mouse-click/keyboard paths that bypassed `SetOn` and therefore never started the animation (the "instant snap").
  - **New**: `ProgressBar` value **easing** (`DefaultValueAnimDuration = 0.22s`; fill and percentage text move together).
  - **New**: `SplitView` **collapse**: dragging within the edge threshold first shows an "about to collapse" overlay (translucent accent + direction arrow, alpha fade, **content untouched**); the pane collapses on release (size eases to 0); afterwards a small button is drawn **on top of the content** at that edge (rounded light grey + arrow pointing in the expand direction + hover easing), and clicking it eases that side from 0 to its minimum limit. `SetCollapseEnabled(false)` disables the whole feature. Public API: `SetCollapseEnabled/IsCollapseEnabled/SetCollapseThreshold/CollapseFirst/CollapseSecond/Expand/IsFirstCollapsed/IsSecondCollapsed/GetCollapsedSide/IsCollapsing/GetCollapseProgress/SetExpandButtonColors/SetExpandButtonSize` plus the `CollapsedChanged(int)` signal.
  - **New**: `detail::EaseOutCubic` / `detail::EaseInOutCubic` (duration-driven easing, one shared convention for in-library animations).
  - **New**: `ThemeRole::Shadow` (**appended at the end of the enum** so existing values keep their numbers) with Light/Dark/HighContrast values; `UIElement::DefaultShadowColor`/`SetDefaultShadowColor`; `Window::SetBackdrop(Backdrop)` follows the theme (the `tint` overload means "locked") plus the `ApplyThemeToBackdropParams` hook.
  - **Fix**: `PieChart` **Ctrl+wheel zoom did nothing** — `PieChart`'s own `zoom_` shadows `ChartBase::zoom_`, so delegating to the base only changed the base's copy; the pie now handles Ctrl itself via `SetZoom`. Semantics are explicit: **Ctrl+wheel = zoom / plain wheel = pan only**.
  - **Fix**: chart wheel panning "did not move" — the wheel path was missing `SyncScrollPositions()` (it changed `scrollX_/scrollY_` but never recomputed `baseX_/baseY_`).
  - **Fix**: documented that `ColumnBox` arranges a child **without an explicit width** at the available width (horizontal stretch ignores the weight) — so "make a card hug its content" means wrapping it in a `Row`; and that a `SettingsList` placed in a `Card`'s built-in `GridLayout` (auto columns pass `FLT_MAX`) degenerates to zero width — use `SetLayout(Col(...))` + `SetFillWidth(true)`.
  - **Tooling**: `tests/zufyui_tests.cpp` 62 → **85** assertions (regressions for this batch: button auto-size on/off, label width follows text, progress/toggle easing convergence, SplitView collapse and expand-to-minimum).
- **v1.22.0** (**contains breaking API changes**):
  - **Fix**: `MessageBox` (and any modal) **first click falling through to the window behind** — when a modal is opened from inside `Window::OnMouseUp`'s slot, that function's trailing `ReleaseCapture()` only runs after the modal loop ends, so the main window keeps `SetCapture` for the whole modal and Windows routes mouse input to the capture window; `Window::RunModal` now does `if (GetCapture()) ReleaseCapture();` before entering the loop.
  - **Fix**: `ScrollViewer` **scroll chaining** — it no longer swallows the wheel at the top/bottom (returns `false` to bubble up the parent chain when that axis can't scroll further), so the outer page keeps scrolling.
  - **Fix**: `SplitView` **expand had no easing + expand button jumped sides** — the old `Expand()` cleared the collapsed flags before starting the animation, but `PaneLengths` keyed off them; now a single `collapseSide_` drives both directions and is cleared only when the animation finishes.
  - **Breaking · P0-1**: member functions with **default arguments split into non-defaulted overloads** (so `.with()` works): `TreeView::SetCheckable(bool)` + `SetCheckableShallow(bool)`; `SetNodeCheckable(node,bool)` + `SetNodeCheckableRecursive`; `SetNodeEnabled(node,bool)` + `SetNodeEnabledRecursive`; `SetNodeCheckState(node,state)` + `SetNodeCheckStateFull(...,updateChildren,updateParent)`; `ListView::AddItem(text)` and rich-item **`AddItemWidget(shared_ptr<Label>)`** (old name dropped); `RadioGroup::AddItem` / **`AddItemSelected`** / `AddButton` / **`AddButtonSelected`**; `Menu::AddCheckItem(text,checked)` / **`AddCheckItemCb`** / **`AddCheckItemRadio`**.
  - **New · P0-2**: collision-free aliases `make_slider/make_card/make_page/make_menu/make_menu_bar/make_status_bar/make_radio_group/make_scroll_bar/make_expander`.
  - **New · P1-2**: `Page::SetScrollableContent(content)` — one line wraps the whole page in a `ScrollViewer` + margin.
  - **New · P1-4**: `ThemeManager::RegisterHook` / `RegisterSubtreeApplier` return a **RAII `HookHandle`** (auto-disconnect on destruction); the library's own fixed hooks use `RegisterHookPermanent` / `RegisterSubtreeApplierPermanent`.
  - **Docs · P3**: added `docs/pitfalls.md`; `AGENTS.md` gained a "chaining / API conventions" section.
- **v1.22.1**:
  - **Fix (layout)**: `RowBox` / `ColumnBox` `ArrangeOverride` did not clamp each child's `base` to its min/max before distributing leftover → a child with `SetMinWidth/Height` pushed its extra space onto a stretching sibling, **overflowing the row/column** (classic case: a `SetMinWidth` label + `SetFillWidth` slider → the slider grew too long and spilled outside its card). Now `base = clamp(base, min, max)` before computing leftover.
  - **Behaviour**: `ColumnBox` / `RowBox` / `GridLayout` **no longer shrink content** — insufficient space now **overflows** and is left to an outer `ScrollViewer` (desktop UI does not compress content). `GridLayout` dropped its proportional row/column compression on overflow.
  - **Fix (alignment)**: `GridLayout`'s `SetHorizontalAlignment/SetVerticalAlignment` never took effect because the test `colStretchWeights.empty()` was always false; now it checks "all zero", so `Center/End` work (only when no column/row stretch weight is set).
  - **Fix (text/IME)**: `TextBox` / `TextEdit` now merge **UTF-16 surrogate pairs** (emoji / beyond-BMP) and insert them as one unit; `←/→`, `Backspace`, `Delete` move/delete across the whole pair. **On losing focus** the control clears its own composition state and the `Window` cancels the IME composition (`ResetImeState()`) — both control and program IME state reset. `TextBox::SetImeEnabled(false)` also clears composition.
  - **Fix (accessibility)**: `GetAutomationIdOrAuto()` now uses a **per-window** counter (`Window::NextAccessibleAutoId()`), so multi-window/multi-root ids no longer collide; `ElementProviderFromPoint` descends **child-before-parent** to the deepest hit (e.g. a Button embedded in a Label).
  - **Fix**: data view item/cell placement `bleedY` is read from each element's `GetBleed()` (no longer a fixed `3.0f`), so shadows/bleed aren't clipped; `indicatorY_` is initialised to `-1` so the selection indicator snaps on the first frame.
  - **Fix (visual)**: the focus ring uses `ThemeRole::FocusRing` and `Theme::cornerRadius` (was a hard-coded blue + fixed 4); in `WM_NCHITTEST` the custom title-bar buttons take priority over the resize border (the maximize-button corner is no longer taken by `HTTOPRIGHT` → Win11 Snap Layouts can appear).
  - **Engineering**: `pch.h` no longer includes the library headers (editing a lib header no longer rebuilds the whole PCH); added `UIElement::MarkUserColor()` centralising 40+ "user colour" markers; removed dead code `ListView::FindEnabledFrom`.
- **v1.23.0**:
  - **New · `ZufyUIHwndView.h` (`HwndView`)**: native HWND content host. Because the main window is NRB+DComp (child HWNDs are not composited), it uses a **top-level owned popup** as the host; `SetContentHwnd` re-parents the external window as its `WS_CHILD` (cross-process allowed) and shows it. Moving the host moves the child natively; clipping = host client + `SetWindowRgn` (element rect ∩ window client ∩ ancestor `GetClipRect`, incl. the `ScrollViewer` viewport). Supports `SetObscured`, `SetOnBoundsChanged`, `SetFill*`.
  - **New · `Window` external-visual attachment**: `CreateExternalVisual()` (WinRT `ContainerVisual` inserted atop the root visual, for WebView2 `put_RootVisualTarget`), `SetExternalVisualBounds` (DIP→physical px), `RemoveExternalVisual`; `AddOverlaySync/RemoveOverlaySync/SyncOverlays` (unified overlay sync).
  - **Performance**: overlay sync is now a **single window-level point** (`WM_MOVE/WM_SIZE/WM_DPICHANGED` immediate + one shared 16ms fallback timer) instead of a per-instance timer; DPI/client cached; redundant `SetWindowPos` skipped and `SWP_NOSIZE/NOMOVE` used as appropriate; the demo's color pattern is cached into a DIB.
  - **Fix · `NumberBox`**: the empty-text error clears once the text becomes a **valid number**; `ResetToDefault` force-clears the error after notifying the app; step/clear buttons fire **on press** (no re-check against the moving rect; fixes staying red after the × button).
  - **Fix · data-view fill**: `ListView`/`TableView`/`TreeView` `MeasureOverride` honours `SetFillWidth/SetFillHeight` (like charts) instead of always returning the default 200/400.
  - **Demo**: new "Native HWND" page (GDI color pattern + Card/Grid/Column/ScrollViewer layouts + an out-of-process `--outproc` producer window hosted by `HwndView`).
- **v1.23.1**:
  - **Fix (layout / hit-testing)**: `PageHost::MeasureOverride` now **measures every page**. Previously `PageHost` only arranged pages while `Page::Arrange` re-measured solely on a size change, so page content made visible at runtime (e.g. an `Expander` card revealed after a combo-box selection) was never re-measured: the new element kept a zero `arrangedRect` (no border, `HitTest` failed) until the window was resized. Clean pages hit the `Measure` cache, so no duplicate work is added.
- **v1.23.2**:
  - **Build**: added `/bigobj` to the **Debug|Win32** / **Debug|x64** configurations of `ZufyUI.vcxproj` / `ZufyUIDebugger.vcxproj` (Release already had it); the full Release/Debug matrix passes.
- **v1.23.3**:
  - **Button**: the internal `Label` is a real child now (rich content via `GetLabel()->AddChild` / `SetContent`); added the drop 2x2 switches (`SetDropWriteBack` / `SetDropOpenOnClick`) and a single-select menu (`DropSelected` / `DropMenuOpened`).
  - **Fix ? drop-menu position**: `GetDpiScale()` returns 96/144 (not 1.0/1.5); the old multiplier sent the menu to the screen bottom-right. Dividing by 96 places it under the button, and the demo no longer shows a MessageBox.
  - **Fixes**: `SetBackdrop(Acrylic/Mica)` no longer covers the system material with opaque white when no tint is set; `ListView::SetItemHeight` is clamped to >=1px and Draw/hit-testing no longer divide by zero.
  - **Docs/cleanup**: documented `HwndView` cross-process risks; removed the redundant `WM_ACTIVATE` check, added `<cstring>`, removed the demo's empty callback.
- **v1.24.0** (**contains breaking changes**):
  - **Signal lifetime**: `ConnectionState::alive` is atomic; `Connection::disconnect` / receiver destruction logically cancels pending `UIThread` / `NewThread` tasks; `Fire` concurrent with signal destruction is explicitly UB.
  - **Receiver context**: `UIElement` / `Window` derive from `ConnectionOwner`; `elem->Connect(...)` / `Connect(elem, ...)` / `sig.connect(elem, ...)` disconnect with the receiver; added free `Connect` and `ConnectWeak`.
  - **Breaking**: `ZSignal` is neither copyable nor movable; member-function pointers use `Connect(elem, sig, &Class::Method)` / `ConnectWeak`; `elem->Connect(sig, &Class::Method)` is no longer supported.
  - **Notes**: `Menu` / `MenuItem` / `Timer` still use `signal.connect` and do not auto-disconnect; signal arguments are passed as lvalues.
- **v1.25.0**:
  - **New · `Drawer`**: left/right/top/bottom × Overlay / Push / Permanent; rounded scrim, rounded panel/border/outer shadow, Esc and outside-click dismiss.
  - **New · `Window::AddKeyHandler / RemoveKeyHandler`**: temporary window-level key handlers.
  - **Improvement**: `ScrollViewer` clip bleed follows the content `GetBleed()`; tests renamed to `zufyui_tests`, signal-focused and Drawer tests added (213 assertions).
- **v1.29.1**: fixed PageHost EaseOut reverse progress, animated hit-test transforms and page-removal indices; `OnPointerCancel` is wired to `WM_CANCELMODE/WM_CAPTURECHANGED` with an OLE drag-out exemption; `Opening`/`Opened` work again for menus and non-DWM windows.
- **v1.29.0**: pointer/focus/input feedback (cursor states, pointer cancel, TextBox focus styling/caret/password eye, ComboBox keyboard, Slider release, data-view/scrollbar/Expander cursors); window transitions (`SetTransitionDurations` / `PresentationState` / `DefaultWindowSetup`); menu `QueueToUIThread` and PageHost reverse navigation; Expander/SettingsList/chart font inheritance, MenuBar/Button/EnsureVisible fixes; API doc mojibake and chapter 8 title fixes.
- **v1.28.0**: nonblocking Present / high-refresh pacing (`SetNonBlockingPresent` / `SetDisplayFramePacing` / `GetDisplayRefreshHz`); private `IDWriteFontCollection`; UIA root/child provider teardown and `WM_DESTROY` event-map cleanup; menus opt into the same presentation policy by default.
- **v1.27.3**: popup window behavior. `Placement` (center owner/screen), `FollowOwner`, `MoveBounds` (owner client / monitor work area), `CloseReason`, `RequestClose/ForceClose` and close-veto signals; `SetMovable/SetCloseEnabled/SetCloseOnEscape`; custom title-bar buttons follow window policy; reliable popup first frame.
- **v1.27.2**:
  - Window raw-pointer/UIA lifetime: `Window::ForgetElement` centralizes focus/pressed/capture/hover/tooltip/pending-repaint/UIA provider cleanup; `SetParent` detaches before release and `UiaDisconnectProvider` prevents the CFG crash.
  - `TreeView::SetStretchLastColumn` (default on) fills the last column; SplitView button direction/disabled state, full-pane slide transition and collapse clamping; TrayIcon v3/v4 click fallbacks; Drawer close refresh; Card margins; password eye button; MessageBox sizing fix.
- **v1.27.1**: disabled the experimental independent render thread while preserving VBLANK frame sync; adapted context menus to non-DWM chrome; fixed stale menu-bar hover and menu placement after hiding the title bar or switching to the native frame; resize now submits a new frame immediately instead of leaving a transparent/stale picture.
- **v1.27.0**:
  - **Windows 10 Acrylic**: enable `ACCENT_ENABLE_HOSTBACKDROP` before creating the HostBackdropBrush on Win10, preserving the custom blur/tint/noise chain; stop writing Win11-only DWM attributes on Win10.
  - **DWM / Snap**: keep `DwmExtendFrameIntoClientArea({1,1,1,1})` for custom frames on both Win10 and Win11; reapply frame state after `WM_SIZE` / `WM_WINDOWPOSCHANGED`, fixing lost borders/shadows after Snap.
  - **Render driver**: added `RenderDriver` / `SetRenderDriver()` / `GetActiveRenderDriver()` / `GetRenderDeviceName()`; the demo supports `--warp` / `--gpu` and a restart-based home-page switcher. WARP changes only application content rendering; DWM/Compositor may still use the GPU.
  - **Breaking**: removed the public corner API `WindowCorner`, `SetWindowCorner()`, `GetWindowCorner()` and DSL `corner()`; Win10 stays square, Win11 follows DWM, and custom corners require calling Win32 DWM APIs directly.
  - **Controls/demo**: title-bar glyphs fall back correctly to `Segoe MDL2 Assets` on Win10; the maximize button refreshes after Snap/restore; UI animation updates pause during drag/resize.
- **v1.26.0**:
  - **Layout**: explicit Grid size constrains cell measurement; finite Row/Column main-axis allocation for Fill; Card/Page/ScrollViewer honour explicit sizes when empty; Button measures content with autoSize disabled; Label explicit width wraps; ScrollViewer no longer re-measures in Arrange.
  - **UIA**: provider cache/context lifetime synchronized with COM callback threads, fixing CFG `FAST_FAIL_GUARD_ICALL_CHECK_FAILURE`.
  - **Controls**: Expander first-expand/collapse-re-expand/clipping fixes; ToggleSwitch press-drag; Slider immediate drag, click/snap easing, `GetDisplayValue()`.
Chapter 21

Version digest

v1.15.0 → v1.29.1

Only the changes that affect your code are listed.

↑