Add generic picker API

packages/ui-extensions/src/surfaces/admin/api/picker/picker.ts

@@ -0,0 +1,36 @@
+import {Tone} from "../../components/shared";
+
+interface Picker {
+  update: (options: PickerOptions) => Promise<void>;
+  selectedItems: Item[];
+}
+
+interface PickerOptions {
+  heading?: string;
+  description?: string;
+  multiple?: boolean | number;
+  loading?: boolean;
+  items: Item[];
+  onSelect?(event: any): void;
+  onCancel?(): void;
+}
+
+interface Item {
+  thumbnail?: {url: string};
+  heading?: string;
+  subheading?: string;
+  action?: {
+    content: string;
+    tone?: Tone;
+  }
+  tags?: {
+    content: string;
+  }[];
+  data?: [string] | [string, string] | [string, string, string];
+  items?: NestedItem[];
+}
+
+interface NestedItem extends Pick<Item, 'thumbnail' | 'heading' | 'data' | 'items'> {
+}
+
+export type PickerApi = (options: PickerOptions) => Promise<Picker>;

packages/ui-extensions/src/surfaces/admin/api/standard/standard.ts

@@ -1,6 +1,7 @@
 import type {I18n} from '../../../../api';
 import {ApiVersion} from '../../../../shared';
 import type {ExtensionTarget as AnyExtensionTarget} from '../../extension-targets';
+import {PickerApi} from '../picker/picker';
 
 export interface Intents {
   /**
@@ -49,4 +50,9 @@ export interface StandardApi<ExtensionTarget extends AnyExtensionTarget> {
     query: string,
     options?: {variables?: Variables; version?: Omit<ApiVersion, '2023-04'>},
   ) => Promise<{data?: Data; errors?: GraphQLError[]}>;
+
+  /**
+   * Renders the [Picker](/docs/api/app-bridge-library/apis/picker), allowing users to select a resource for the extension to use as part of its flow.
+   */
+  picker: PickerApi;
 }