qohosqabilityinstancesmanager.h

Enable keyboard shortcuts

// Copyright (C) 2025 The Qt Company Ltd.

// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only

#ifndef QOHOSQABILITYINSTANCESMANAGER_H

#define QOHOSQABILITYINSTANCESMANAGER_H

#include <QtCore/private/qnapi_p.h>

#include <QtCore/qobject.h>

#include <cstdint>

#include <functional>

#include <map>

#include <memory>

#include <optional>

#include <qohosplugincore.h>

#include <string>

QT_BEGIN_NAMESPACE

namespace QtOhos {

class QUiAbilityPeerBackend

public:

    enum class CloseAbilityRequestSource

        OnPrepareToTerminate,

        WindowWillClose,

};

    enum class CloseAbilityRequestResolution

        Close,

        DontClose,

};

    virtual QNapi::Promise handleCloseRequestFromSystem(

        QOhosJsState &jsState, const std::string &logContextStr, CloseAbilityRequestSource requestSource,

        std::function<QNapi::Value(QOhosJsState &, CloseAbilityRequestResolution)> promiseValueFactory) = 0;

    virtual void handleOnContinueRequestFromSystem(

        JsState &jsState, QNapi::Object wantParamsObj,

        QOhosConsumer<JsState &, QOhosAbilityOnContinueResult> resultConsumer) = 0;

protected:

    QUiAbilityPeerBackend();

};

struct QAbilityInfo

    std::string name;

    std::string bundleName;

    std::string moduleName;

};

struct QAbilityInstancesManager

public:

    virtual ~QAbilityInstancesManager();

    static bool isQtInternalWantFromThisProcess(QNapi::Object want);

    static void setLaunchParamOnAbilityObject(JsState &jsState, QNapi::Object ability, QNapi::Object launchParam);

    static QAbilityInfo readAbilityInfo(const QNapi::Object &ability);

    virtual bool isWantFromThisApp(QNapi::Object appQAbility, QNapi::Object want) const = 0;

    virtual std::optional<std::string> tryGetQAbilityInstanceIdFromWant(QNapi::Object appQAbility, QNapi::Object want) const = 0;

    virtual std::string getQAbilityInstanceIdOrPendingAutoStartedId(QNapi::Object qAbility) const = 0;

    virtual std::optional<std::string> pendingAutoStartedInstanceId() const = 0;

    virtual void registerPendingAutoStartedInstance() = 0;

    virtual void startNewInstance(

        QNapi::Object baseQAbility, QObjectThreadSafeRef qwindow,

        QNapi::Object optStartOptions,

        std::function<void(JsState &, std::shared_ptr<QAbilityPeer>)> startupNotifyFunc) = 0;

    virtual void handleStartedUiInstance(JsState &jsState, QNapi::Object qAbility, QNapi::Object windowStage) = 0;

    virtual std::shared_ptr<QUiAbilityPeerBackend> getAbilityPeerBackend(std::shared_ptr<QUiAbilityPeer> uiAbilityPeer) = 0;

protected:

    QAbilityInstancesManager();

};

std::shared_ptr<QAbilityInstancesManager> makeQAbilityInstancesManager(

    std::function<void(JsState &, std::shared_ptr<QAbilityPeer>)> autoStartedInstanceStartupNotifyFunc);

QT_END_NAMESPACE

#endif // QOHOSQABILITYINSTANCESMANAGER_H