// Copyright 2000-2020 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license that can be found in the LICENSE file.
package com.intellij.openapi.wm.ex;

import com.intellij.openapi.wm.ToolWindow;
import com.intellij.openapi.wm.ToolWindowManager;
import com.intellij.util.messages.Topic;
import org.jetbrains.annotations.ApiStatus;
import org.jetbrains.annotations.NotNull;

import java.util.EventListener;
import java.util.List;

public interface ToolWindowManagerListener extends EventListener {
  Topic<ToolWindowManagerListener> TOPIC = new Topic<>("tool window events", ToolWindowManagerListener.class);

  /**
   * @deprecated Use {@link #toolWindowsRegistered(List)}
   */
  @Deprecated
  default void toolWindowRegistered(@NotNull String id) {
  }

  default void toolWindowsRegistered(@NotNull List<String> ids) {
    for (String id : ids) {
      toolWindowRegistered(id);
    }
  }

  /**
   * Invoked when tool window with specified {@code id} is unregistered in {@link ToolWindowManager}.
   */
  default void toolWindowUnregistered(@NotNull String id, @NotNull ToolWindow toolWindow) {
  }

  /**
   * Not fired on tool window registered and unregistered.
   */
  default void stateChanged(@NotNull ToolWindowManager toolWindowManager) {
    stateChanged();
  }

  /**
   * Invoked when tool window is shown.
   *
   * @param toolWindow shown tool window
   */
  default void toolWindowShown(@NotNull ToolWindow toolWindow) {
  }

  /**
   * @deprecated use {@link #toolWindowShown(ToolWindow)} instead
   */
  @ApiStatus.ScheduledForRemoval(inVersion = "2021.2")
  @Deprecated
  default void toolWindowShown(@NotNull String id, @NotNull ToolWindow toolWindow) {
  }

  /**
   * @deprecated Use {{@link #stateChanged(ToolWindowManager)}}
   */
  @Deprecated
  default void stateChanged() {
  }
}
@@ -1449,32 +1449,85 @@
 w toolWindow) %7B%0A
+    toolWindowShown(toolWindow.getId(), toolWindow);%0A
   %7D%0A%0A  /**%0A   * 
@@ -1593,16 +1593,46 @@
 d%0A   */%0A
+  @SuppressWarnings(%22unused%22)%0A
   @ApiSt

call ToolWindowManagerListener.toolWindowShown(id, toolWindow) to not break usages in exising plugins (IDEA-CR-64152)