@get-bb/plugin-sdk 0.5.9 → 0.5.16

package/dist/app.js

@@ -1,45 +1,139 @@
 // src/app.ts
-var runtime = globalThis.__bbPluginRuntime?.pluginSdkApp ?? {};
-var experimental_Icon = runtime.experimental_Icon;
-var experimental_ProviderIcon = runtime.experimental_ProviderIcon;
-var definePluginApp = runtime.definePluginApp;
-var ThreadChat = runtime.ThreadChat;
-var Markdown = runtime.Markdown;
-var experimental_FileLink = runtime.experimental_FileLink;
-var UrlLink = runtime.UrlLink;
-var experimental_NewThreadComposer = runtime.experimental_NewThreadComposer;
-var experimental_ProviderModelPicker = runtime.experimental_ProviderModelPicker;
-var experimental_PermissionModePicker = runtime.experimental_PermissionModePicker;
-var experimental_BranchPicker = runtime.experimental_BranchPicker;
-var experimental_useBranches = runtime.experimental_useBranches;
-var experimental_useCheckoutState = runtime.experimental_useCheckoutState;
-var experimental_SourceCode = runtime.experimental_SourceCode;
-var experimental_Diff = runtime.experimental_Diff;
-var useRpc = runtime.useRpc;
-var useRealtime = runtime.useRealtime;
-var useRealtimeConnectionState = runtime.useRealtimeConnectionState;
-var useSettings = runtime.useSettings;
-var useBbContext = runtime.useBbContext;
-var useBbNavigate = runtime.useBbNavigate;
-var experimental_useAppPanel = runtime.experimental_useAppPanel;
-var experimental_useFixedTabTarget = runtime.experimental_useFixedTabTarget;
-var useComposer = runtime.useComposer;
-var useComposerView = runtime.useComposerView;
-var experimental_useSidebarThreads = runtime.experimental_useSidebarThreads;
-var experimental_useSidebarThreadActions = runtime.experimental_useSidebarThreadActions;
-var experimental_useSidebarThreadPullRequest = runtime.experimental_useSidebarThreadPullRequest;
-var experimental_useSidebarThreadSplit = runtime.experimental_useSidebarThreadSplit;
-var useSidebarThreadDraft = runtime.useSidebarThreadDraft;
-var useSidebarThreadDraftIds = runtime.useSidebarThreadDraftIds;
-var useSidebarThreadRowStatus = runtime.useSidebarThreadRowStatus;
-var useSidebarThreadRowStatuses = runtime.useSidebarThreadRowStatuses;
-var useSidebarSplitLayout = runtime.useSidebarSplitLayout;
-var useSidebarThreadShortcut = runtime.useSidebarThreadShortcut;
-var ThreadTitle = runtime.ThreadTitle;
-var useEnvironmentProviders = runtime.useEnvironmentProviders;
-var useSdk = runtime.useSdk;
-var experimental_useProviders = runtime.experimental_useProviders;
-var experimental_useCodeTheme = runtime.experimental_useCodeTheme;
+function runtimeHost() {
+  return globalThis.__bbPluginRuntime;
+}
+function installedApp() {
+  return runtimeHost()?.pluginSdkApp;
+}
+function runtimeMember(name) {
+  const member = installedApp()?.[name];
+  if (member === void 0) {
+    throw new Error(
+      `@get-bb/plugin-sdk/app: ${name} needs the bb app's plugin runtime. In tests, call installTestPluginRuntime() from @get-bb/plugin-sdk/testing/app first.`
+    );
+  }
+  return member;
+}
+function runtimeFunction(name) {
+  const forward = (...args) => runtimeMember(name)(...args);
+  return forward;
+}
+function runtimeComponent(name) {
+  function RuntimeComponent(props) {
+    const react = runtimeHost()?.react;
+    if (react === void 0) {
+      throw new Error(
+        `@get-bb/plugin-sdk/app: ${name} needs React on the bb plugin runtime. In tests, call installTestPluginRuntime() from @get-bb/plugin-sdk/testing/app first.`
+      );
+    }
+    return react.createElement(runtimeMember(name), props);
+  }
+  RuntimeComponent.displayName = name;
+  return RuntimeComponent;
+}
+var experimental_Icon = runtimeComponent("experimental_Icon");
+var experimental_ProviderIcon = runtimeComponent(
+  "experimental_ProviderIcon"
+);
+var definePluginApp = (setup) => {
+  const app = installedApp();
+  if (app?.definePluginApp !== void 0) return app.definePluginApp(setup);
+  if (typeof setup !== "function") {
+    throw new Error("definePluginApp expects a setup function");
+  }
+  return Object.freeze({ __bbPluginApp: true, setup });
+};
+var ThreadChat = runtimeComponent("ThreadChat");
+var Markdown = runtimeComponent("Markdown");
+var experimental_FileLink = runtimeComponent("experimental_FileLink");
+var UrlLink = runtimeComponent("UrlLink");
+var experimental_NewThreadComposer = runtimeComponent(
+  "experimental_NewThreadComposer"
+);
+var experimental_ProviderModelPicker = runtimeComponent(
+  "experimental_ProviderModelPicker"
+);
+var experimental_PermissionModePicker = runtimeComponent(
+  "experimental_PermissionModePicker"
+);
+var experimental_BranchPicker = runtimeComponent(
+  "experimental_BranchPicker"
+);
+var experimental_useBranches = runtimeFunction(
+  "experimental_useBranches"
+);
+var experimental_useCheckoutState = runtimeFunction(
+  "experimental_useCheckoutState"
+);
+var experimental_SourceCode = runtimeComponent(
+  "experimental_SourceCode"
+);
+var experimental_Diff = runtimeComponent("experimental_Diff");
+var useRpc = runtimeFunction("useRpc");
+var useRealtime = runtimeFunction("useRealtime");
+var useRealtimeConnectionState = runtimeFunction(
+  "useRealtimeConnectionState"
+);
+var useSettings = runtimeFunction("useSettings");
+var useBbContext = runtimeFunction("useBbContext");
+var experimental_usePluginId = runtimeFunction(
+  "experimental_usePluginId"
+);
+var useBbNavigate = runtimeFunction("useBbNavigate");
+var experimental_useAppPanel = runtimeFunction(
+  "experimental_useAppPanel"
+);
+var experimental_useFixedTabTarget = runtimeFunction(
+  "experimental_useFixedTabTarget"
+);
+var useComposer = runtimeFunction("useComposer");
+var useComposerView = runtimeFunction("useComposerView");
+var experimental_useSidebarThreads = runtimeFunction(
+  "experimental_useSidebarThreads"
+);
+var experimental_useSidebarThreadActions = runtimeFunction(
+  "experimental_useSidebarThreadActions"
+);
+var experimental_useSidebarThreadPullRequest = runtimeFunction(
+  "experimental_useSidebarThreadPullRequest"
+);
+var experimental_useSidebarThreadSplit = runtimeFunction(
+  "experimental_useSidebarThreadSplit"
+);
+var experimental_useSidebarNavigation = runtimeFunction(
+  "experimental_useSidebarNavigation"
+);
+var experimental_useSidebarNavigationSplit = runtimeFunction(
+  "experimental_useSidebarNavigationSplit"
+);
+var experimental_SidebarNavigationIcon = runtimeComponent(
+  "experimental_SidebarNavigationIcon"
+);
+var useSidebarThreadDraft = runtimeFunction("useSidebarThreadDraft");
+var useSidebarThreadDraftIds = runtimeFunction(
+  "useSidebarThreadDraftIds"
+);
+var useSidebarThreadRowStatus = runtimeFunction(
+  "useSidebarThreadRowStatus"
+);
+var useSidebarThreadRowStatuses = runtimeFunction(
+  "useSidebarThreadRowStatuses"
+);
+var useSidebarSplitLayout = runtimeFunction("useSidebarSplitLayout");
+var useSidebarThreadShortcut = runtimeFunction(
+  "useSidebarThreadShortcut"
+);
+var ThreadTitle = runtimeComponent("ThreadTitle");
+var useEnvironmentProviders = runtimeFunction(
+  "useEnvironmentProviders"
+);
+var useSdk = runtimeFunction("useSdk");
+var experimental_useProviders = runtimeFunction(
+  "experimental_useProviders"
+);
+var experimental_useCodeTheme = runtimeFunction(
+  "experimental_useCodeTheme"
+);
 export {
   Markdown,
   ThreadChat,
@@ -54,13 +148,17 @@ export {
   experimental_PermissionModePicker,
   experimental_ProviderIcon,
   experimental_ProviderModelPicker,
+  experimental_SidebarNavigationIcon,
   experimental_SourceCode,
   experimental_useAppPanel,
   experimental_useBranches,
   experimental_useCheckoutState,
   experimental_useCodeTheme,
   experimental_useFixedTabTarget,
+  experimental_usePluginId,
   experimental_useProviders,
+  experimental_useSidebarNavigation,
+  experimental_useSidebarNavigationSplit,
   experimental_useSidebarThreadActions,
   experimental_useSidebarThreadPullRequest,
   experimental_useSidebarThreadSplit,

package/dist/internal/plugin-app-collector.js

@@ -446,6 +446,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     sidebarFooterActions: [],
     experimentalSidebarFooterItems: [],
     experimentalSidebarNavigations: [],
+    experimentalSidebarHeaders: [],
     threadLists: [],
     threadHeaderActions: [],
     browserToolbarActions: [],
@@ -474,6 +475,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     pendingInteraction: /* @__PURE__ */ new Set(),
     sidebarFooterItem: /* @__PURE__ */ new Set(),
     sidebarNavigation: /* @__PURE__ */ new Set(),
+    sidebarHeader: /* @__PURE__ */ new Set(),
     threadList: /* @__PURE__ */ new Set(),
     threadHeaderAction: /* @__PURE__ */ new Set(),
     browserToolbarAction: /* @__PURE__ */ new Set(),
@@ -683,6 +685,15 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
           )
         );
       },
+      experimental_sidebarHeader(registration) {
+        collected.experimentalSidebarHeaders.push(
+          collectTitledComponent(
+            "slots.experimental_sidebarHeader",
+            seenIds.sidebarHeader,
+            registration
+          )
+        );
+      },
       experimental_threadList(registration) {
         collected.threadLists.push(
           collectTitledComponent(

package/dist/testing/app.js

@@ -1,4 +1,5 @@
 // src/testing/app.tsx
+import * as React from "react";
 import {
   createContext,
   useContext,
@@ -620,6 +621,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     sidebarFooterActions: [],
     experimentalSidebarFooterItems: [],
     experimentalSidebarNavigations: [],
+    experimentalSidebarHeaders: [],
     threadLists: [],
     threadHeaderActions: [],
     browserToolbarActions: [],
@@ -648,6 +650,7 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
     pendingInteraction: /* @__PURE__ */ new Set(),
     sidebarFooterItem: /* @__PURE__ */ new Set(),
     sidebarNavigation: /* @__PURE__ */ new Set(),
+    sidebarHeader: /* @__PURE__ */ new Set(),
     threadList: /* @__PURE__ */ new Set(),
     threadHeaderAction: /* @__PURE__ */ new Set(),
     browserToolbarAction: /* @__PURE__ */ new Set(),
@@ -857,6 +860,15 @@ function collectPluginAppRegistrations(definition, onComposerCustomizationReject
           )
         );
       },
+      experimental_sidebarHeader(registration) {
+        collected.experimentalSidebarHeaders.push(
+          collectTitledComponent(
+            "slots.experimental_sidebarHeader",
+            seenIds.sidebarHeader,
+            registration
+          )
+        );
+      },
       experimental_threadList(registration) {
         collected.threadLists.push(
           collectTitledComponent(
@@ -1100,6 +1112,19 @@ function TestThreadTitle({ threadId }) {
   if (thread === void 0) return null;
   return /* @__PURE__ */ jsx("span", { "data-thread-title": threadId, children: thread.displayTitle });
 }
+function TestSidebarNavigationIcon({
+  icon,
+  className
+}) {
+  return /* @__PURE__ */ jsx(
+    "span",
+    {
+      "aria-hidden": "true",
+      className,
+      "data-sidebar-navigation-icon": icon.kind === "host" ? icon.name : `${icon.pluginId}/${icon.icon ?? ""}`
+    }
+  );
+}
 function SlotLifecycleGuard({
   children,
   onUnmount
@@ -1550,6 +1575,9 @@ var testPluginSdkApp = {
   useBbContext() {
     return useSlotEnv("useBbContext").bbContext;
   },
+  experimental_usePluginId() {
+    return useSlotEnv("experimental_usePluginId").pluginId;
+  },
   useBbNavigate() {
     return useSlotEnv("useBbNavigate").navigate;
   },
@@ -1679,6 +1707,28 @@ var testPluginSdkApp = {
     return env.sidebarShortcuts.get(threadId) ?? null;
   },
   ThreadTitle: TestThreadTitle,
+  experimental_useSidebarNavigation() {
+    return useSlotEnv("experimental_useSidebarNavigation").sidebarNavigation;
+  },
+  experimental_useSidebarNavigationSplit(itemId, _options) {
+    const env = useSlotEnv("experimental_useSidebarNavigationSplit");
+    return useMemo(
+      () => ({
+        splitProps: {
+          onPointerDown: () => {
+            env.sidebarNavigationCalls.push({
+              method: "beginSplitDrag",
+              itemId
+            });
+          }
+        },
+        isAvailable: true,
+        layout: null
+      }),
+      [env, itemId]
+    );
+  },
+  experimental_SidebarNavigationIcon: TestSidebarNavigationIcon,
   useEnvironmentProviders() {
     return useSlotEnv("useEnvironmentProviders").environmentProviders;
   },
@@ -1722,6 +1772,7 @@ function installTestPluginRuntime() {
   const host = globalThis;
   host.__bbPluginRuntime = {
     ...host.__bbPluginRuntime,
+    react: host.__bbPluginRuntime?.react ?? React,
     pluginSdkApp: testPluginSdkApp
   };
 }
@@ -1868,6 +1919,7 @@ function strictJsonRoundTrip(value, label) {
   return JSON.parse(JSON.stringify(value));
 }
 function renderSlot(registration, props, options = {}) {
+  installTestPluginRuntime();
   const rpcCalls = [];
   const rpcHandlers = options.rpc ?? {};
   const rpcClient = {
@@ -1965,6 +2017,43 @@ function renderSlot(registration, props, options = {}) {
     }
   };
   const sidebarActionCalls = [];
+  const sidebarNavigationCalls = [];
+  const sidebarNavigation = {
+    items: options.sidebarNavigation?.items ?? [],
+    activeItemId: options.sidebarNavigation?.activeItemId ?? null,
+    isShortcutModifierHeld: options.sidebarNavigation?.isShortcutModifierHeld ?? false,
+    actions: {
+      activate(itemId, activationOptions) {
+        sidebarNavigationCalls.push({
+          method: "activate",
+          itemId,
+          openInSplit: activationOptions.openInSplit
+        });
+      },
+      setVisible(itemId, isVisible) {
+        sidebarNavigationCalls.push({
+          method: "setVisible",
+          itemId,
+          isVisible
+        });
+      },
+      setOrder(itemIds) {
+        sidebarNavigationCalls.push({
+          method: "setOrder",
+          itemIds: [...itemIds]
+        });
+      },
+      openCustomize() {
+        sidebarNavigationCalls.push({ method: "openCustomize" });
+      },
+      openDetails(itemId) {
+        sidebarNavigationCalls.push({ method: "openDetails", itemId });
+      },
+      async disablePlugin(itemId) {
+        sidebarNavigationCalls.push({ method: "disablePlugin", itemId });
+      }
+    }
+  };
   const sidebarPullRequests = new Map(
     Object.entries(options.sidebarPullRequests ?? {})
   );
@@ -2220,6 +2309,7 @@ ${block}
     realtimeConnection,
     settingsState: { values: options.settings, isLoading: false },
     bbContext: { projectId, threadId },
+    pluginId: options.pluginId ?? "test-plugin",
     navigate,
     navigateCalls,
     appPanel,
@@ -2235,6 +2325,8 @@ ${block}
     sidebarRowStatuses,
     sidebarShortcuts,
     sidebarSplitLayout: options.sidebarSplitLayout ?? null,
+    sidebarNavigation,
+    sidebarNavigationCalls,
     environmentProviders,
     sdk,
     sdkCalls,
@@ -2306,6 +2398,7 @@ ${block}
     navigateCalls,
     experimental_fixedTabOpenCalls,
     sidebarActionCalls,
+    sidebarNavigationCalls,
     sdkCalls,
     composer: composerLog,
     behavior: {
@@ -2319,6 +2412,7 @@ ${block}
       navigateCalls,
       experimental_fixedTabOpenCalls,
       sidebarActionCalls,
+      sidebarNavigationCalls,
       sdkCalls,
       composer: composerLog
     },

package/dist/testing/index.js

@@ -3360,6 +3360,7 @@ function createFakePluginHostInternal(options, sharedState) {
   const machineProviders = /* @__PURE__ */ new Map();
   const serverAccessProviders = /* @__PURE__ */ new Map();
   const disposeHooks = [];
+  const installHandlers = [];
   const serviceControllers = [];
   let nextInteractionId = 1;
   const pendingInteractions = /* @__PURE__ */ new Map();
@@ -3685,6 +3686,13 @@ function createFakePluginHostInternal(options, sharedState) {
     onDispose(hook) {
       assertLive();
       disposeHooks.push(hook);
+    },
+    onInstall(handler) {
+      assertLive();
+      if (typeof handler !== "function") {
+        throw new Error("onInstall expects a function");
+      }
+      installHandlers.push(handler);
     }
   };
   async function disposeHost(cleanupStorage) {
@@ -4223,6 +4231,16 @@ function createFakePluginHostInternal(options, sharedState) {
     },
     async dispose() {
       await disposeHost(true);
+    },
+    async install() {
+      assertLive();
+      for (const handler of [...installHandlers]) {
+        try {
+          await handler();
+        } catch (error) {
+          emitLog("warn", `install handler failed: ${errorMessage(error)}`);
+        }
+      }
     }
   };
   fakeHostDisposers.set(harness, disposeHost);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@get-bb/plugin-sdk",
-  "version": "0.5.9",
+  "version": "0.5.16",
   "homepage": "https://github.com/get-bb/bb#readme",
   "bugs": {
     "url": "https://github.com/get-bb/bb/issues"