Merge branch 'master' into librepcb-patches

Author: ubruhin

.github/workflows/nightly_snapshot.yaml

@@ -295,12 +295,12 @@ jobs:
               with:
                   pat: ${{ secrets.VSCODE_MARKETPLACE_PAT }}
                   registryUrl: https://marketplace.visualstudio.com
-                  dryRun: ${{ github.event.inputs.private == 'true' || (github.ref != 'refs/heads/master' && github.event.inputs.release != 'true') }}
+                  dryRun: ${{ github.event.inputs.private == 'true' || (github.ref != 'refs/heads/pre-release/1.16' && github.event.inputs.release != 'true') }}
                   packagePath: editors/vscode
                   dependencies: false
             - name: Publish to Open VSX Registry
               continue-on-error: true
-              if: ${{ github.event.inputs.private != 'true' && (github.ref == 'refs/heads/master' || github.event.inputs.release == 'true') }}
+              if: ${{ github.event.inputs.private != 'true' && (github.ref == 'refs/heads/pre-release/1.16' || github.event.inputs.release == 'true') }}
               uses: HaaLeo/publish-vscode-extension@v2
               with:
                   pat: ${{ secrets.OPENVSX_PAT }}
@@ -671,7 +671,7 @@ jobs:
                   tag: v${{ steps.version.outputs.VERSION }}
                   commit: ${{ github.sha }}
             - uses: ncipollo/release-action@v1
-              if: github.event.inputs.release != 'true' && github.ref == 'refs/heads/master'
+              if: github.event.inputs.release != 'true' && github.ref == 'refs/heads/pre-release/1.16'
               with:
                   allowUpdates: true
                   prerelease: true
@@ -706,6 +706,7 @@ jobs:
                     - os: ubuntu-22.04
                       name: "Ubuntu 22.04 1.92"
                       rust_version: "1.92"
+                      # plotter is excluded because with --all-features, its dependency cause build error because of fontconfig's dlopen feature
                       extra_args: "--exclude plotter"
                     - os: windows-2022
                       name: "Windows 2022 nightly"
@@ -714,7 +715,8 @@ jobs:
                     - os: macos-14
                       name: "MacOS 14 nightly"
                       rust_version: "nightly"
-                      extra_args: "--exclude ffmpeg --exclude gstreamer-player"
+                      # plotter is excluded because its dependency doesn't build with Nightly rust: https://github.com/servo/pathfinder/issues/584
+                      extra_args: "--exclude ffmpeg --exclude gstreamer-player --exclude plotter"
         uses: ./.github/workflows/build_and_test_reusable.yaml
         with:
             os: ${{ matrix.os }}

.github/workflows/nightly_tests.yaml

@@ -163,18 +163,18 @@ jobs:
             - run: brew install xcodegen
             - run: xcodegen -s ios-project.yml
               working-directory: ${{ matrix.demo }}
-            - name: "Find Simulator UDID from iOS 26.0 runtime"
+            - name: "Find Simulator UDID from iOS 26.4 runtime"
               run: |
-                echo "=== Finding device from iOS 26.0 runtime (default Xcode) ==="
-                # Find the device UDID from iOS 26.0 runtime to avoid ambiguity
+                echo "=== Finding device from iOS 26.4 runtime (default Xcode) ==="
+                # Find the device UDID from iOS 26.4 runtime to avoid ambiguity
                 # Multiple runtimes have devices with the same name, so we need the specific one
                 # Output format: "    Device Name (UDID) (Shutdown)"
-                DEVICE_LINE=$(xcrun simctl list devices available | grep -A 50 "iOS 26.0" | grep "${{ matrix.device }}" | head -n 1)
+                DEVICE_LINE=$(xcrun simctl list devices available | grep -A 50 "iOS 26.4" | grep "${{ matrix.device }}" | head -n 1)
 
                 if [ -z "$DEVICE_LINE" ]; then
-                  echo "ERROR: Could not find ${{ matrix.device }} in iOS 26.0 runtime"
-                  echo "Available iOS 26.0 devices:"
-                  xcrun simctl list devices available | grep -A 30 "iOS 26.0"
+                  echo "ERROR: Could not find ${{ matrix.device }} in iOS 26.4 runtime"
+                  echo "Available iOS 26.4 devices:"
+                  xcrun simctl list devices available | grep -A 30 "iOS 26.4"
                   exit 1
                 fi
 

.github/workflows/publish_npm_package.yaml

@@ -65,7 +65,7 @@ jobs:
                     - os: ubuntu-22.04-arm
                       rust-target: aarch64-unknown-linux-gnu
                       napi-rs-target: linux-arm64-gnu
-                    - os: macos-14
+                    - os: macos-26
                       rust-target: aarch64-apple-darwin
                       napi-rs-target: darwin-arm64
                     - os: windows-2022

.github/workflows/schedule_nightly_snapshot.yaml

@@ -15,7 +15,7 @@ jobs:
     strategy:
       matrix:
         branch:
-          - pre-release/1.15
+          - pre-release/1.16
           - master
 
     steps:

.github/workflows/upload_pypi.yaml

@@ -96,7 +96,7 @@ jobs:
                 taplo get -f Cargo.toml features.default
 
             - name: Build iOS wheels
-              uses: pypa/cibuildwheel@v3.4.0
+              uses: pypa/cibuildwheel@v3.4.1
               with:
                   package-dir: api/python/slint
                   output-dir: wheelhouse

.mise/tasks.toml

@@ -91,6 +91,11 @@ description = "Run pnpm format:fix"
 run = "pnpm type-check:ci"
 depends = ["prepare:pnpm-install"]
 
+["lint:ts:knip"]
+description = "Run knip"
+run = "pnpm knip"
+depends = ["prepare:pnpm-install"]
+
 ### Build
 
 ["build:lsp:wasm"]
@@ -138,4 +143,4 @@ depends = [
 
 ["ci:autofix:lint"]
 description = "CI autofix job -- lint steps"
-depends = ["lint:legal:reuse", "lint:ts:typecheck"]
+depends = ["lint:legal:reuse", "lint:ts:typecheck", "lint:ts:knip"]

AGENTS.md

@@ -2,17 +2,16 @@
 
 This file provides guidance to AI coding assistants when working with code in this repository.
 
-## Project Overview
-
-Slint is a declarative GUI toolkit for building native user interfaces across embedded systems, desktops, mobile, and web platforms. UIs are written in `.slint` markup files and connected to business logic in Rust, C++, JavaScript, or Python.
+Slint is a declarative GUI toolkit for embedded, desktop, mobile, and web.
+UIs are written in `.slint` markup and connected to Rust, C++, JavaScript, or Python business logic.
 
 ## Build Commands
 
 ### Rust (Primary)
 ```sh
 cargo build                                    # Build the workspace
-cargo build --release                          # Release build (use this flag whenever testing performance)
-cargo test                                     # Run tests (requires cargo build first!)
+cargo build --release                          # Release build (use whenever measuring performance)
+cargo test                                     # Run tests
 cargo build --workspace --exclude uefi-demo    # Build all examples
 ```
 
@@ -37,22 +36,33 @@ cd api/node && pnpm install
 
 ## Testing
 
-**Important**: Run `cargo build` before `cargo test` - the dynamic library must exist first.
+Don't run `cargo build` before `cargo test` — `cargo test` compiles what it needs.
 
 ### Test Drivers
 ```sh
-cargo test -p test-driver-interpreter         # Fast interpreter tests
-cargo test -p test-driver-rust                # Rust API tests
-cargo test -p test-driver-cpp                 # C++ tests (build slint-cpp first)
-cargo test -p test-driver-nodejs              # Node.js tests
-cargo test -p doctests                        # Documentation snippet tests
+cargo test -p test-driver-interpreter         # Fastest: interpreter-based
+cargo test -p test-driver-rust                # Rust API (slow to compile without SLINT_TEST_FILTER)
+cargo test -p test-driver-cpp                 # C++ (build slint-cpp first for the dynamic library)
+cargo test -p test-driver-nodejs              # Node.js
+cargo test -p doctests                        # Documentation snippets
 ```
 
-### Filtered Testing
+### Filtering .slint Test Cases
+
+The test drivers compile every `.slint` file under `tests/cases/` into a generated Rust test, which is slow.
+Set `SLINT_TEST_FILTER=<substring>` to limit the build to matching case files.
+
 ```sh
-tests/run_tests.sh rust layout     # Filter by name
+tests/run_tests.sh rust layout                 # Filter by name via the helper script
 ```
 
+Only drop the filter for a final full-suite run before committing.
+
+### Writing Slint Test Cases
+
+The `test` property in `tests/cases/*.slint` must be declared `out property<bool> test: ...;`.
+Without `out`, the compiler treats it as private and the driver passes the test vacuously.
+
 ### Syntax Tests (Compiler Errors)
 ```sh
 cargo test -p i-slint-compiler --features display-diagnostics --test syntax_tests
@@ -89,7 +99,7 @@ SLINT_CREATE_SCREENSHOTS=1 cargo test -p test-driver-screenshots  # Generate ref
   - `android-activity/` - Android platform support
   - `linuxkms/` - Linux KMS/DRM direct rendering
   - `selector/` - Runtime backend selection
-  - `testing/` - Testing backend for automated tests
+  - `testing/` - Testing backend for automated tests, system testing (protobuf/TCP), and embedded MCP server for AI-assisted UI introspection
 
 - **`internal/renderers/`** - Rendering engines:
   - `femtovg/` - OpenGL ES 2.0
@@ -98,31 +108,15 @@ SLINT_CREATE_SCREENSHOTS=1 cargo test -p test-driver-screenshots  # Generate ref
 
 ### Language APIs (`api/`)
 
-- `rs/slint/` - Rust public crate
-- `rs/macros/` - `slint!` procedural macro
-- `rs/build/` - Build script support
-- `cpp/` - C++ API with CMake integration
-- `node/` - Node.js bindings (Neon)
-- `python/` - Python bindings (PyO3)
-- `wasm-interpreter/` - WebAssembly bindings for browser use
+Rust (`rs/slint/`, `rs/macros/` for `slint!`, `rs/build/`), C++ (`cpp/`, CMake), Node.js (`node/`, Neon), Python (`python/`, PyO3), WebAssembly (`wasm-interpreter/`).
 
-### Tools
+### Tools (`tools/`)
 
-- `tools/lsp/` - Language Server Protocol for editor integration
-- `tools/compiler/` - CLI compiler
-- `tools/viewer/` - .slint file viewer with hot reload
-- `tools/slintpad/` - Web-based Slint editor/playground
-- `tools/figma_import/` - Import designs from Figma
-- `tools/tr-extractor/` - Translation string extractor for i18n
-- `tools/updater/` - Migration tool for Slint version updates
+`lsp/` (LSP server), `compiler/` (CLI), `viewer/` (hot-reload `.slint` viewer), `slintpad/` (web playground), `figma_import/`, `tr-extractor/` (i18n), `updater/` (version migration).
 
 ### Editor Support (`editors/`)
 
-- `vscode/` - Visual Studio Code extension
-- `zed/` - Zed editor integration
-- `kate/` - Kate editor syntax highlighting
-- `sublime/` - Sublime Text support
-- `tree-sitter-slint/` - Tree-sitter grammar for syntax highlighting
+`vscode/`, `zed/`, `kate/`, `sublime/`, `tree-sitter-slint/`.
 
 ### Key Patterns
 
@@ -133,50 +127,39 @@ SLINT_CREATE_SCREENSHOTS=1 cargo test -p test-driver-screenshots  # Generate ref
 
 ## Version Control (Git)
 
-- The default git branch is `master`
+- The default git branch is `master`.
+- Prefer linear history — rebase or squash on merge.
 
 ## Code Style
 
-- Rust: `rustfmt` enforced in CI
-- C++: `clang-format` enforced in CI
-- Linear git history preferred (rebase/squash merges)
+- Rust: `rustfmt` enforced in CI.
+- C++: `clang-format` enforced in CI.
 
-## Platform Prerequisites
+### Comments and Docs
 
-### Linux
-```sh
-# Debian/Ubuntu
-sudo apt install libxcb-shape0-dev libxcb-xfixes0-dev libxkbcommon-dev \
-  libfontconfig-dev libssl-dev clang libavcodec-dev libavformat-dev \
-  libavutil-dev libavfilter-dev libavdevice-dev libasound2-dev pkg-config
-```
+- Follow `docs/astro/writing-style-guide.md` when writing *new* comments, doc comments, commit messages, or markdown.
+- But don't reformat existing prose to match the style.
 
-### macOS
-```sh
-xcode-select --install
-brew install pkg-config ffmpeg
-```
+## Platform Prerequisites
 
-### Windows
-- Enable symlinks: `git clone -c core.symlinks=true https://github.com/slint-ui/slint`
-- Install MSVC Build Tools
-- FFMPEG via vcpkg or manual installation
+See [`docs/building.md`](docs/building.md) for Linux/macOS/Windows system packages, FFMPEG setup, and the Windows symlink `git clone` flag.
 
 ## Deep Dive Documentation
 
-For tasks requiring deeper architectural understanding, see:
-
-- **`docs/development/compiler-internals.md`** - Compiler pipeline, passes, LLR, code generation. Load when working on `internal/compiler/`.
-- **`docs/development/type-system.md`** - Type definitions, unit types, type conversions, name resolution, type register. Load when working on `langtype.rs`, `lookup.rs`, or type checking.
-- **`docs/development/property-binding-deep-dive.md`** - Reactive property system, dependency tracking, two-way bindings, PropertyTracker, ChangeTracker. Load when working on `internal/core/properties.rs` or debugging binding issues.
-- **`docs/development/custom-renderer.md`** - Renderer traits, drawing API, backend integration, testing. Load when working on `internal/renderers/` or fixing drawing bugs.
-- **`docs/development/animation-internals.md`** - Animation timing, easing curves, performance, debugging. Load when working on `internal/core/animations.rs` or animation-related issues.
-- **`docs/development/layout-system.md`** - Layout solving, constraints, GridLayout/BoxLayout, compile-time lowering. Load when working on `internal/core/layout.rs` or sizing/positioning bugs.
-- **`docs/development/python-tests.md`** - Python test infrastructure: pytest tests, Rust test driver, rebuilding slint-python, debugging compilation vs runtime issues. Load when working on Python tests or debugging `test-driver-python` failures.
-- **`docs/development/item-tree.md`** - Item tree structure, component instantiation, traversal, focus. Load when working on `internal/core/item_tree.rs`, event handling, or runtime component model.
-- **`docs/development/model-repeater-system.md`** - Model trait, VecModel, adapters (map/filter/sort), Repeater, ListView virtualization. Load when working on `internal/core/model.rs` or data binding in `for` loops.
-- **`docs/development/input-event-system.md`** - Mouse/touch/keyboard events, event routing, focus management, drag-drop, shortcuts. Load when working on `internal/core/input.rs` or event handling.
-- **`docs/development/text-layout.md`** - Text shaping, line breaking, paragraph layout, styled text parsing. Load when working on `internal/core/textlayout/` or text rendering.
-- **`docs/development/window-backend-integration.md`** - WindowAdapter trait, Platform trait, WindowEvent, popup management, backend implementations. Load when working on `internal/core/window.rs` or `internal/backends/`.
-- **`docs/development/lsp-architecture.md`** - LSP server, code completion, hover, semantic tokens, live preview. Load when working on `tools/lsp/` or IDE tooling.
-- **`docs/development/ffi-language-bindings.md`** - C++/Node.js/Python bindings, cbindgen, FFI patterns, adding new cross-language APIs. Load when working on `api/` or internal FFI modules.
+Load the relevant file under `docs/development/` when working in the listed area:
+
+- `compiler-internals.md` — `internal/compiler/`: pipeline, passes, LLR, codegen.
+- `type-system.md` — `langtype.rs`, `lookup.rs`, type checking: unit types, conversions, name resolution, type register.
+- `property-binding-deep-dive.md` — `internal/core/properties.rs`, binding bugs: reactivity, dependency tracking, two-way bindings, PropertyTracker, ChangeTracker.
+- `custom-renderer.md` — `internal/renderers/`, drawing bugs: renderer traits, drawing API, backend integration.
+- `animation-internals.md` — `internal/core/animations.rs`: timing, easing curves, debugging.
+- `layout-system.md` — `internal/core/layout.rs`, sizing bugs: constraints, GridLayout/BoxLayout, compile-time lowering.
+- `python-tests.md` — Python tests, `test-driver-python`: pytest setup, rebuilding slint-python, compile vs runtime issues.
+- `item-tree.md` — `internal/core/item_tree.rs`, event handling, component model: item tree, instantiation, traversal, focus.
+- `model-repeater-system.md` — `internal/core/model.rs`, `for` loops: Model trait, VecModel, adapters, Repeater, ListView virtualization.
+- `input-event-system.md` — `internal/core/input.rs`, event handling: routing, focus, drag-drop, shortcuts.
+- `text-layout.md` — `internal/core/textlayout/`, text rendering: shaping, line breaking, styled text.
+- `window-backend-integration.md` — `internal/core/window.rs`, `internal/backends/`: WindowAdapter, Platform, WindowEvent, popups.
+- `lsp-architecture.md` — `tools/lsp/`, IDE tooling: completion, hover, semantic tokens, live preview.
+- `mcp-server.md` — `internal/backends/testing/mcp_server.rs`, `introspection.rs`: shared introspection layer, handle/arena, HTTP transport, adding tools.
+- `ffi-language-bindings.md` — `api/`, internal FFI: cbindgen, FFI patterns, adding cross-language APIs.