Fluentqt

> **Status:** Historical release note

<!-- docs-nav:top:start -->

[Contents](../SUMMARY.md) · [Releases index](README.md)
<!-- docs-nav:top:end -->

and tools for editing live previews. Optional extension modules share a
common lifecycle across C++, Python, and WebAssembly applications.

Date and time ranges

- `DateTimeRangePicker` combines a range calendar, independently optional
start and end values, inline time editing, and whole-day presets in one
compact entry. Endpoint dates use small anchored flyouts; selecting a
range keeps the panel open until **Done** or a light-dismiss action.
- The range picker preserves time zones and the end-of-day value when using
coarser minute increments. It supports localized labels and date formats,
keyboard input, and accessible range validation.
- `CalendarView` scrolls continuously through date, month, and year rows.
Trackpad input follows the gesture, while mouse-wheel input uses a short
transition. Header arrows and Page Up/Down retain page navigation.

QML pages and optional extensions

- QmlBridge embeds application QML pages in Widgets windows, with shared
application data and Fluent theme settings. Gallery examples cover loading,
theme changes, actions, errors, and unloading in C++, Python, and the browser.
- The optional Plugins module manages extension dependencies, activation,
and cleanup. Spatial and QmlBridge offer session helpers while preserving
application-owned widgets and models. Their additional dependencies remain
separate from the core Widgets library.
- QMLPlus gains computed bindings, conditional state, motion, and anchor
helpers for composing Widgets interfaces, with focused Gallery examples.

Live preview tools

- Python Live Scene previews reload in the same window while retaining user
input and selection. Local preview commands and MCP tools support inspecting
the scene, interacting with controls, and capturing the result.
- The optional region editor lets a scene author register editable values,
select a region, preview source changes, and compare actual before/after
screenshots. Changes can be kept, reverted, or undone; revision checks
protect intervening source edits. Enable it with `--edit`.

Interaction and rendering fixes

Button layout spacing and TreeView selection indicators behave consistently
when controls are resized or reselected. Spatial and QML previews also receive
fixes for renderer transitions, resource cleanup, input mapping, and fallback
to a usable 2D view across supported platforms.

[Compare v1.9.3...v1.10.0](https://github.com/calvinhxx/Fluent-Qt/compare/v1.9.3...v1.10.0)

<!-- docs-nav:bottom:start -->
---
[Contents](../SUMMARY.md) · [Releases index](README.md)
<!-- docs-nav:bottom:end -->

material changes. It also fixes window captures that could finish a material
change before the window itself had drawn its replacement background.

Window background fixes

- New windows prepare their theme and material background before becoming
visible. This avoids a brief white or mismatched background in dark mode
and when Mica or Acrylic uses a painted fallback on Windows, macOS and
Linux.
- Switching from Mica or Acrylic to Normal (`BackdropEffect::Solid`), or to
a painted fallback, keeps the previous native material until the window
has drawn and submitted its opaque replacement. The change waits while
drawing is paused, and a recreated window must paint its background afresh.
- Widget screenshots and cache refreshes no longer count as a real window
redraw or finish an in-progress material change. Captures are handled
safely both before the first paint and after the window is shown.

[Compare v1.9.2...v1.9.3](https://github.com/calvinhxx/Fluent-Qt/compare/v1.9.2...v1.9.3)

<!-- docs-nav:bottom:start -->
---
[Contents](../SUMMARY.md) · [Releases index](README.md) · [Fluent-Qt 1.9.2 →](v1.9.2.md)
<!-- docs-nav:bottom:end -->

Gallery clarity at different display scales. C++, Python and WebAssembly
Gallery examples share the new controls and their presentation.

Timeline and Stepper

Timeline displays application-defined sequences with titles, descriptions,
timestamps, icons and status markers. It borrows a caller-owned item model
and supports leading, trailing and alternating node alignment. Its item-view
foundation preserves the existing Fluent scrolling and selection behavior.

Stepper presents horizontal or vertical steps with independently controlled
completion and error states. Activating a step requests navigation; the
application decides whether to change the current step. Both controls reuse
Fluent theme, accessibility and motion behavior.

The Gallery includes interactive examples and matching source for both
controls. They are available through the C++ and PySide6 public APIs.

Clearer Gallery images and text

Gallery component cards now render SVG artwork at the actual display
resolution. They retain detail on high-density screens and in the 3D panel
cache. Reused documents and rendered images are cached to reduce work during
page changes and scrolling. Every card has a maintained SVG master and a
matching PNG export.

Text crossing a cached panel boundary keeps its original shaping and pixel
coverage, including fractional display scales and Qt 5.15. Glyph scratch
images stay within their memory budget, and oversized fonts use Qt's direct
rendering path. These fixes also apply to the Python Gallery.

The Calendar example consistently opens its demonstrated month, so its
selected date remains visible throughout the year.

Website and package delivery

The project site offers an interactive Spatial example and updated native
Gallery imagery. The embedded example loads on request and pauses while
hidden.

Gallery installers and Python wheels include the SVG artwork and rendering
dependencies. Release checks cover their contents and architecture across
the existing Windows, Linux and macOS package matrix.

Upgrade both Python packages together:

bash
python -m pip install --upgrade "FluentQt==1.9.2" "FluentQt-Gallery==1.9.2"
python -m fluentqt_gallery


[Compare v1.9.1...v1.9.2](https://github.com/calvinhxx/Fluent-Qt/compare/v1.9.1...v1.9.2)

<!-- docs-nav:bottom:start -->
---
[Contents](../SUMMARY.md) · [Releases index](README.md) · [Fluent-Qt 1.9.1 →](v1.9.1.md)
<!-- docs-nav:bottom:end -->

> **Status:** Historical release note

<!-- docs-nav:top:start -->