feat(ui-commands): allow plugins to open a core panel or a specific sidekick panel

README.md

@@ -783,6 +783,9 @@ One other thing is that the type of the return is precisely the same type requir
     - panel:
       - open: this function will open the sidekick options panel automatically;
       - close: this function will close the sidekick options panel automatically (and also the sidebar content if open, to avoid inconsistencies in ui);
+  - panel:
+    - open: this function will open a panel in the sidekick area. It takes the ID of a generic content sidekick area (as returned by `setGenericContentItems`), or one of the `SidekickAreaCorePanelEnum` core panels, as its only argument. Core panels the user could not open from the sidebar navigation themselves, such as Polls for a viewer, are ignored;
+    - close: this function will close a panel in the sidekick area. It takes the same argument as `open`, and then only closes the panel if it is the one on display, so a plugin does not close a panel it does not own. Passing no argument closes the sidekick area altogether;
 - sidekick-options-container:
   - open: this function will open the sidekick options panel automatically;
   - close: this function will close the sidekick options panel automatically (and also the sidebar content if open, to avoid inconsistencies in ui);
@@ -837,6 +840,15 @@ One other thing is that the type of the return is precisely the same type requir
       'New Section Name'
     );
 
+    // Open the plugin's own sidekick panel
+    pluginApi.uiCommands.sidekickArea.panel.open('my-content-id');
+
+    // Open a core panel
+    pluginApi.uiCommands.sidekickArea.panel.open(SidekickAreaCorePanelEnum.POLL);
+
+    // Close it again, but only if it is still the one on display
+    pluginApi.uiCommands.sidekickArea.panel.close('my-content-id');
+
     // Camera commands
     pluginApi.uiCommands.camera.setSelfViewDisableAllDevices(true);
     pluginApi.uiCommands.camera.setSelfViewDisable('camera-stream-id', false);

src/ui-commands/index.ts

@@ -3,3 +3,4 @@ export { ChangeEnforcedLayoutTypeEnum, EnforcedLayoutTypeEnum } from './layout/e
 export { CaptionsLanguageEnum } from './captions/enums';
 export { ChatUiCommandsEnum } from './chat/enums';
 export { ScreenshareCommandsEnum } from './screenshare/enums';
+export { SidekickAreaCorePanelEnum } from './sidekick-area/panel/enums';

src/ui-commands/sidekick-area/commands.ts

@@ -1,6 +1,8 @@
 import { sidekickAreaOptions } from './options/commands';
+import { sidekickAreaPanel } from './panel/commands';
 import { UiCommandsSidekickArea } from './types';
 
 export const sidekickArea: UiCommandsSidekickArea = {
   options: sidekickAreaOptions,
+  panel: sidekickAreaPanel,
 };

src/ui-commands/sidekick-area/panel/commands.ts

@@ -0,0 +1,44 @@
+import { SidekickAreaCorePanelEnum, SidekickAreaPanelEnum } from './enums';
+import {
+  SidekickAreaPanelCommandArguments,
+  UiCommandsSidekickAreaPanelObject,
+} from './types';
+
+const dispatch = (
+  command: SidekickAreaPanelEnum,
+  id?: string | SidekickAreaCorePanelEnum,
+) => {
+  window.dispatchEvent(new CustomEvent<SidekickAreaPanelCommandArguments>(
+    command,
+    {
+      detail: {
+        id,
+      },
+    },
+  ));
+};
+
+export const sidekickAreaPanel: UiCommandsSidekickAreaPanelObject = {
+  /**
+   * Opens a panel in the sidekick area.
+   *
+   * @param id Id of a generic content sidekick area, as returned by
+   * `pluginApi.setGenericContentItems`, or a core panel from `SidekickAreaCorePanelEnum`.
+   * Core panels the user could not open themselves, such as Polls for a viewer, are ignored.
+   */
+  open: (id: string | SidekickAreaCorePanelEnum) => {
+    dispatch(SidekickAreaPanelEnum.OPEN, id);
+  },
+
+  /**
+   * Closes a panel in the sidekick area, but only if it is on display, so a plugin
+   * does not close a panel it does not own. Passing no argument closes the
+   * sidekick area altogether.
+   *
+   * @param id Id of a generic content sidekick area, or a core panel from
+   * `SidekickAreaCorePanelEnum`.
+   */
+  close: (id?: string | SidekickAreaCorePanelEnum) => {
+    dispatch(SidekickAreaPanelEnum.CLOSE, id);
+  },
+};

src/ui-commands/sidekick-area/panel/enums.ts

@@ -0,0 +1,18 @@
+export enum SidekickAreaPanelEnum {
+  OPEN = 'OPEN_SIDEKICK_AREA_PANEL_COMMAND',
+  CLOSE = 'CLOSE_SIDEKICK_AREA_PANEL_COMMAND',
+}
+
+/**
+ * Core panels a plugin is allowed to open. Polls, Timer and Breakout only open when
+ * the user could already open them from the sidebar navigation.
+ */
+export enum SidekickAreaCorePanelEnum {
+  CHAT = 'chat',
+  USER_LIST = 'userlist',
+  SHARED_NOTES = 'shared-notes',
+  APPS_GALLERY = 'apps-gallery',
+  POLL = 'poll',
+  TIMER = 'timer',
+  BREAKOUT = 'breakoutroom',
+}

src/ui-commands/sidekick-area/panel/types.ts

@@ -0,0 +1,10 @@
+import { SidekickAreaCorePanelEnum } from './enums';
+
+export interface UiCommandsSidekickAreaPanelObject {
+  open: (id: string | SidekickAreaCorePanelEnum) => void;
+  close: (id?: string | SidekickAreaCorePanelEnum) => void;
+}
+
+export interface SidekickAreaPanelCommandArguments {
+  id?: string | SidekickAreaCorePanelEnum;
+}

src/ui-commands/sidekick-area/types.ts

@@ -1,5 +1,7 @@
 import { UiCommandsSidekickAreaOptionsObject } from './options/types';
+import { UiCommandsSidekickAreaPanelObject } from './panel/types';
 
 export interface UiCommandsSidekickArea {
   options: UiCommandsSidekickAreaOptionsObject;
+  panel: UiCommandsSidekickAreaPanelObject;
 }