feat(build): cross-platform build-and-install with Windows shell integration

Add scripts/build_and_install.py as the shared macOS/Windows entry point with PyInstaller build and platform-default install. Register Windows installs via Start Menu shortcut, Apps and Features uninstall key, and an uninstall script. Require explicit MOUSER_SIGN_IDENTITY or MOUSER_TEAM_ID for macOS signing with no hardcoded team defaults. Fix packaged QML on Windows (pageHost layout, ScrollView sizing, Qt plugin paths, QML warning logs). Add unit tests that pass on Linux CI.

Author: hughesyadaddy

.gitignore

@@ -13,7 +13,6 @@ build/
 *.egg
 
 # IDE
-.vscode/
 .idea/
 .cursor/
 *.swp
@@ -37,5 +36,8 @@ Desktop.ini
 # Build artifacts
 build_icon.py
 
+# Local diagnostics (machine-specific install paths)
+tools/probe_frozen_qml.py
+
 # Shortcuts (user-specific paths)
 *.lnk

.vscode/tasks.json

@@ -0,0 +1,32 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Build Mouser and Install",
+      "type": "shell",
+      "windows": {
+        "command": "python",
+        "args": ["${workspaceFolder}/scripts/build_and_install.py"]
+      },
+      "osx": {
+        "command": "python3",
+        "args": ["${workspaceFolder}/scripts/build_and_install.py"]
+      },
+      "linux": {
+        "command": "python3",
+        "args": ["${workspaceFolder}/scripts/build_and_install.py"]
+      },
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      },
+      "presentation": {
+        "reveal": "always",
+        "panel": "shared",
+        "focus": true,
+        "clear": true
+      },
+      "problemMatcher": []
+    }
+  ]
+}

main_qml.py

@@ -58,8 +58,12 @@ def _resolve_root_dir():
 # Ensure PySide6 QML plugins are found
 import PySide6
 _pyside_dir = os.path.dirname(PySide6.__file__)
-os.environ.setdefault("QML2_IMPORT_PATH", os.path.join(_pyside_dir, "qml"))
-os.environ.setdefault("QT_PLUGIN_PATH", os.path.join(_pyside_dir, "plugins"))
+_qml_dir = os.path.join(_pyside_dir, "qml")
+_plugin_dir = os.path.join(_pyside_dir, "plugins")
+os.environ.setdefault("QML2_IMPORT_PATH", _qml_dir)
+os.environ.setdefault("QT_PLUGIN_PATH", _plugin_dir)
+QCoreApplication.addLibraryPath(_plugin_dir)
+QCoreApplication.addLibraryPath(_qml_dir)
 
 _t3 = _time.perf_counter()
 from core.config import load_config, save_config
@@ -1018,6 +1022,12 @@ def _dump_threads(sig, frame):
 
     # ── QML Engine ─────────────────────────────────────────────
     qml_engine = QQmlApplicationEngine()
+
+    def _log_qml_warnings(warnings):
+        for warning in warnings:
+            print(f"[QML] {warning.toString()}")
+
+    qml_engine.warnings.connect(_log_qml_warnings)
     qml_engine.addImageProvider("appicons", AppIconProvider(ROOT))
     qml_engine.addImageProvider("systemicons", SystemIconProvider())
     qml_engine.rootContext().setContextProperty("backend", backend)

scripts/build_and_install.bat

@@ -0,0 +1,5 @@
+@echo off
+setlocal
+cd /d "%~dp0\.."
+python "%~dp0build_and_install.py"
+if errorlevel 1 exit /b 1