/*
    SPDX-FileCopyrightText: 2017 Marco Martin <notmart@gmail.com>
    SPDX-FileCopyrightText: 2021 Vlad Zahorodnii <vlad.zahorodnii@kde.org>

    SPDX-License-Identifier: LGPL-2.1-only OR LGPL-3.0-only OR LicenseRef-KDE-Accepted-LGPL
*/
#pragma once

#include "kwin_export.h"

#include <QObject>

namespace KWin
{

class Display;
class SurfaceInterface;
class XdgForeignV2InterfacePrivate;

class KWIN_EXPORT XdgExportedSurface : public QObject
{
    Q_OBJECT

public:
    XdgExportedSurface(SurfaceInterface *surface);

    QString handle() const;
    SurfaceInterface *surface() const;

private:
    void handleSurfaceDestroyed();

    const QString m_handle;
    SurfaceInterface *m_surface;
};

/**
 * This class encapsulates the server side logic of the XdgForeign protocol.
 * a process can export a surface to be identifiable by a server-wide unique
 * string handle, and another process can in turn import that surface, and set it
 * as transient parent for one of its own surfaces.
 * This parent relationship is traced by the transientChanged signal and the
 * transientFor method.
 */
class KWIN_EXPORT XdgForeignV2Interface : public QObject
{
    Q_OBJECT

public:
    XdgForeignV2Interface(Display *display, QObject *parent = nullptr);
    ~XdgForeignV2Interface() override;

    /**
     * If a client did import a surface and set one of its own as child of the
     * imported one, this returns the mapping.
     * @param surface the child surface we want to search an imported transientParent for.
     * @returns the transient parent of the surface, if found, nullptr otherwise.
     */
    SurfaceInterface *transientFor(SurfaceInterface *surface);

    /**
     * Exports the given surface without creating a Wayland interface object.
     * @param surface The surface to export
     * @return The handle, this can then be passed to other clients.
     */
    XdgExportedSurface *exportSurface(SurfaceInterface *surface);

Q_SIGNALS:
    /**
     * A surface got a new imported transient parent
     * @param parent is the surface exported by one client and imported into another, which will act as parent.
     * @param child is the surface that the importer client did set as child of the surface
     * that it imported.
     * If one of the two parameters is nullptr, it means that a previously relation is not
     * valid anymore and either one of the surfaces has been unmapped, or the parent surface
     * is not exported anymore.
     */
    void transientChanged(KWin::SurfaceInterface *child, KWin::SurfaceInterface *parent);

private:
    friend class XdgExporterV2Interface;
    friend class XdgImporterV2Interface;
    std::unique_ptr<XdgForeignV2InterfacePrivate> d;
};

}
