Files
php-qml/framework/qml/CMakeLists.txt
magdev 030502ca38
Some checks failed
CI / Quality (push) Failing after 1m45s
Phase 2 sub-commit 3: full Update Semantics + ReactiveListModel + AppShell
BackendConnection's ConnectionState enum is now Connecting / Online /
Reconnecting / Offline (PLAN.md §5). The probe loop tracks the first
failure since the last Online and transitions to Reconnecting on any
failed probe, then to Offline once the configurable threshold (30 s
default) is exceeded. The Error state is gone; Reconnecting + the
exposed `error` string subsume its UI role.

ReactiveListModel is the headline QML type:

- QAbstractListModel that GETs `baseUrl + source` for an initial JSON
  array and then keeps in sync via an internal MercureClient subscribed
  to `topic`.
- Role names are derived dynamically from the first row's keys plus an
  internal `pending` boolean role used by optimistic mutations.
- Diff application: upsert (insert-or-update), delete, replace; gap
  detection via the envelope `version` field with auto re-fetch.
- `invoke(method, path, body, optimistic)` is the optimistic command
  primitive. Generates an Idempotency-Key, applies the local diff,
  POST/PATCH/DELETEs with that key, and resolves on the matching
  Mercure echo (correlation-key matched in ModelPublisher's envelope).
  Rolls back and emits commandFailed on 4xx/5xx, commandTimedOut after
  10 s without an echo. Phase 4 packaging will surface configuration
  for the timeout.

AppShell.qml is the optional convenience root:

- Reads BackendConnection.connectionState.
- Reconnecting → top banner.
- Offline → modal overlay with the error string and a Retry button
  (calls BackendConnection.restart()).
- Wraps user content via `default property alias content`.

Apps that want full chrome control can skip AppShell entirely; the
skeleton's Main.qml keeps its own status display for demonstration
and is unaffected.

ReactiveObject (single-entity twin of ReactiveListModel) is intentionally
deferred — same envelope handling, smaller surface; will land in Phase 2
follow-up or Phase 3 alongside the todo example. Cursor pagination is
similarly deferred (the Phase 2 done criterion uses small lists).

Smoke tested: /healthz + /api/ping round-trip cleanly, zero Mercure 401s,
clean shutdown. composer quality stays green (16 tests, 45 assertions).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 02:40:12 +02:00

50 lines
1.2 KiB
CMake

# php-qml framework — Qt module (PhpQml.Bridge).
#
# Designed to be add_subdirectory()'d from the consuming application's
# top-level CMakeLists.txt (see framework/skeleton/qml/CMakeLists.txt
# arriving in Phase 1 sub-commit 6). Standalone configuration also
# works for module-only sanity builds.
cmake_minimum_required(VERSION 3.21)
if(NOT DEFINED PROJECT_NAME)
project(php_qml_bridge LANGUAGES CXX)
endif()
set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_AUTOMOC ON)
if(NOT TARGET Qt6::Core)
find_package(Qt6 6.5 REQUIRED COMPONENTS Core Gui Quick Qml Network)
qt_standard_project_setup(REQUIRES 6.5)
endif()
qt_add_qml_module(php_qml_bridge
URI PhpQml.Bridge
VERSION 1.0
STATIC
SOURCES
src/BackendConnection.h
src/BackendConnection.cpp
src/SingleInstance.h
src/SingleInstance.cpp
src/MercureClient.h
src/MercureClient.cpp
src/ReactiveListModel.h
src/ReactiveListModel.cpp
QML_FILES
qml/RestClient.qml
qml/AppShell.qml
)
target_include_directories(php_qml_bridge PUBLIC src/)
target_link_libraries(php_qml_bridge PUBLIC
Qt6::Core
Qt6::Gui
Qt6::Network
Qt6::Qml
Qt6::Quick
)