Advance Wayland and KDE package bring-up

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
2026-04-14 10:51:06 +01:00
parent 51f3c21121
commit cf12defd28
15214 changed files with 20594243 additions and 269 deletions
@@ -0,0 +1,90 @@
+/*
+    This file is part of the KDE libraries
+    SPDX-FileCopyrightText: 2021 Aleix Pol <aleixpol@kde.org>
+    SPDX-FileCopyrightText: 2023 Nicolas Fella <nicolas.fella@gmx.de>
+
+    SPDX-License-Identifier: LGPL-2.1-or-later
+*/
+
+#ifndef KWAYLANDEXTRAS_H
+#define KWAYLANDEXTRAS_H
+
+#include <QObject>
+#include <QWindow>
+
+#include <kwindowsystem_export.h>
+
+/**
+ * A collection of functions to do Wayland things
+ * @since 6.0
+ */
+class KWINDOWSYSTEM_EXPORT KWaylandExtras : public QObject
+{
+    Q_OBJECT
+
+public:
+    static KWaylandExtras *self();
+
+    /**
+     * Requests an xdg_activation_v1 token for a specific window.
+     *
+     * @param win window in behalf this request is made
+     * @param serial of the event that triggered the request
+     * @param app_id identifier of the application that we are launching
+     *
+     * @see lastInputSerial
+     */
+    Q_INVOKABLE static void requestXdgActivationToken(QWindow *win, uint32_t serial, const QString &app_id);
+
+    /**
+     * Offers the seat's current serial
+     */
+    Q_INVOKABLE static quint32 lastInputSerial(QWindow *window);
+
+    /**
+     * Requests to export the given window using xdg_foreign_v2.
+     *
+     * @param window The window to export.
+     *
+     * @see windowExported
+     * @since 6.0
+     */
+    Q_INVOKABLE static void exportWindow(QWindow *window);
+
+    /**
+     * Unexport the window previously exported using xdg_foreign_v2.
+     *
+     * Asks the compositor to revoke the handle.
+     *
+     * @param window The window to unexport.
+     * @since 6.0
+     */
+    Q_INVOKABLE static void unexportWindow(QWindow *window);
+
+Q_SIGNALS:
+    /**
+     * Activation @p token to pass to the client.
+     *
+     * @see requestXdgActivationToken
+     */
+    void xdgActivationTokenArrived(int serial, const QString &token);
+
+    /**
+     * Window @p handle to pass to the client.
+     *
+     * @param window The window that requested the handle.
+     * @param handle The handle.
+     *
+     * @see exportWindow
+     * @since 6.0
+     */
+    void windowExported(QWindow *window, const QString &handle);
+
+private:
+    KWaylandExtras();
+    ~KWaylandExtras();
+
+    void *d;
+};
+
+#endif