/*
 * Copyright (C) 2024 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.android.systemui.statusbar.phone

import android.app.ActivityOptions
import android.app.PendingIntent
import android.content.ComponentName
import android.content.Intent
import android.os.Bundle
import android.os.UserHandle
import android.view.View
import com.android.systemui.ActivityIntentHelper
import com.android.systemui.animation.ActivityTransitionAnimator
import com.android.systemui.plugins.ActivityStartOptions
import com.android.systemui.plugins.ActivityStarter
import kotlinx.coroutines.CoroutineScope

interface ActivityStarterInternal {
    /**
     * Registers the given [controllerFactory] for launching and closing transitions matching the
     * [cookie] and the [ComponentName] that it contains, within the given [scope].
     */
    fun registerTransition(
        cookie: ActivityTransitionAnimator.TransitionCookie,
        controllerFactory: ActivityTransitionAnimator.ControllerFactory,
        scope: CoroutineScope,
    )

    /**
     * Unregisters the [ActivityTransitionAnimator.Controller] previously registered containing the
     * given [cookie]. If no such registration exists, this is a no-op.
     */
    fun unregisterTransition(cookie: ActivityTransitionAnimator.TransitionCookie)

    /**
     * Starts a pending intent after dismissing keyguard.
     *
     * This can be called in a background thread (to prevent calls in [ActivityIntentHelper] in the
     * main thread).
     */
    fun startPendingIntentDismissingKeyguard(
        intent: PendingIntent,
        dismissShade: Boolean,
        intentSentUiThreadCallback: Runnable? = null,
        associatedView: View? = null,
        animationController: ActivityTransitionAnimator.Controller? = null,
        showOverLockscreen: Boolean = false,
        skipLockscreenChecks: Boolean = false,
        fillInIntent: Intent? = null,
        extraOptions: Bundle? = null,
        customMessage: String? = null,
    )

    /** Starts an activity after dismissing keyguard. */
    @Deprecated("Use startActivityDismissingKeyguard(options: ActivityStartOptions) instead")
    fun startActivityDismissingKeyguard(
        intent: Intent,
        dismissShade: Boolean,
        onlyProvisioned: Boolean = false,
        callback: ActivityStarter.Callback? = null,
        flags: Int = 0,
        animationController: ActivityTransitionAnimator.Controller? = null,
        customMessage: String? = null,
        disallowEnterPictureInPictureWhileLaunching: Boolean = false,
        userHandle: UserHandle? = null,
        activityOptions: ActivityOptions? = null,
    )

    /** Starts an activity after dismissing keyguard. */
    fun startActivityDismissingKeyguard(options: ActivityStartOptions)

    /** Starts an Activity. */
    fun startActivity(
        intent: Intent,
        dismissShade: Boolean,
        animationController: ActivityTransitionAnimator.Controller?,
        showOverLockscreenWhenLocked: Boolean,
        userHandle: UserHandle? = null,
    )

    /** Executes an action after dismissing keyguard. */
    fun dismissKeyguardThenExecute(
        action: ActivityStarter.OnDismissAction,
        cancel: Runnable?,
        afterKeyguardGone: Boolean,
        customMessage: String? = null,
    )

    /** Executes an action after dismissing keyguard. */
    fun executeRunnableDismissingKeyguard(
        runnable: Runnable?,
        cancelAction: Runnable? = null,
        dismissShade: Boolean = false,
        afterKeyguardGone: Boolean = false,
        deferred: Boolean = false,
        willAnimateOnKeyguard: Boolean = false,
        customMessage: String? = null,
    )

    /** Whether we should animate an activity launch. */
    fun shouldAnimateLaunch(isActivityIntent: Boolean): Boolean
}