@signalsandsorcery/plugin-sdk 2.35.3 → 2.35.4

package/dist/index.d.mts

@@ -637,6 +637,16 @@ interface PluginHost {
      * picker components consume one type.
      */
     getAvailableFx?(): Promise<InstrumentDescriptor[]>;
+    /**
+     * Force a plugin re-scan and return the refreshed FX list. Unlike
+     * `getAvailableFx` (served from a cache), this re-walks the plugin
+     * directories AND clears the engine's failed-probe blacklist, so a plugin
+     * installed mid-session, or one that crashed a previous scan and was
+     * blacklisted, reappears without an app restart. Backs the FX picker's
+     * "Rescan" button. Slow (20-60s). Absent on pre-2.40 hosts — callers should
+     * fall back to `getAvailableFx`. @since SDK 2.40.0
+     */
+    rescanAvailableFx?(): Promise<InstrumentDescriptor[]>;
     /**
      * The panel's bus state for a scene. `{ engaged: false, … }` when the
      * panel has no bus there — reading NEVER creates one. When engaged, this
@@ -4944,7 +4954,7 @@ declare function useAnySolo(host: Pick<PluginHost, 'isAnySoloActive' | 'onTrackS
  * Registry checks semver.gte(PLUGIN_SDK_VERSION, manifest.minHostVersion)
  * during activation and marks incompatible plugins accordingly.
  */
-declare const PLUGIN_SDK_VERSION = "2.39.0";
+declare const PLUGIN_SDK_VERSION = "2.40.0";
 
 /**
  * FX Preset Definitions

package/dist/index.d.ts

@@ -637,6 +637,16 @@ interface PluginHost {
      * picker components consume one type.
      */
     getAvailableFx?(): Promise<InstrumentDescriptor[]>;
+    /**
+     * Force a plugin re-scan and return the refreshed FX list. Unlike
+     * `getAvailableFx` (served from a cache), this re-walks the plugin
+     * directories AND clears the engine's failed-probe blacklist, so a plugin
+     * installed mid-session, or one that crashed a previous scan and was
+     * blacklisted, reappears without an app restart. Backs the FX picker's
+     * "Rescan" button. Slow (20-60s). Absent on pre-2.40 hosts — callers should
+     * fall back to `getAvailableFx`. @since SDK 2.40.0
+     */
+    rescanAvailableFx?(): Promise<InstrumentDescriptor[]>;
     /**
      * The panel's bus state for a scene. `{ engaged: false, … }` when the
      * panel has no bus there — reading NEVER creates one. When engaged, this
@@ -4944,7 +4954,7 @@ declare function useAnySolo(host: Pick<PluginHost, 'isAnySoloActive' | 'onTrackS
  * Registry checks semver.gte(PLUGIN_SDK_VERSION, manifest.minHostVersion)
  * during activation and marks incompatible plugins accordingly.
  */
-declare const PLUGIN_SDK_VERSION = "2.39.0";
+declare const PLUGIN_SDK_VERSION = "2.40.0";
 
 /**
  * FX Preset Definitions

package/dist/index.js

@@ -963,12 +963,12 @@ function useTrackExternalFx(host, trackId) {
     void reload();
   }, [reload]);
   const loadFxList = (0, import_react2.useCallback)(
-    async (force) => {
+    async (opts) => {
       if (!supported || !host.getAvailableFx) return;
-      if (fxLoadedRef.current && !force) return;
+      if (fxLoadedRef.current && !opts.force && !opts.rescan) return;
       setFxLoading(true);
       try {
-        const list = await host.getAvailableFx();
+        const list = opts.rescan && host.rescanAvailableFx ? await host.rescanAvailableFx() : await host.getAvailableFx();
         setAvailableFx(list);
         fxLoadedRef.current = true;
       } catch {
@@ -981,7 +981,7 @@ function useTrackExternalFx(host, trackId) {
   const openPicker = (0, import_react2.useCallback)(
     (open) => {
       setPickerOpen(open);
-      if (open) void loadFxList(false);
+      if (open) void loadFxList({});
     },
     [loadFxList]
   );
@@ -1005,7 +1005,7 @@ function useTrackExternalFx(host, trackId) {
     fxLoading,
     pickerOpen,
     setPickerOpen: openPicker,
-    refreshFx: () => void loadFxList(true),
+    refreshFx: () => void loadFxList({ rescan: true }),
     reload,
     onAddFx: (pluginId) => mutate(host.loadTrackExternalFx && (async () => {
       await host.loadTrackExternalFx(trackId, pluginId);
@@ -1142,7 +1142,7 @@ function TrackExternalFxSection({
                 onClick: () => refreshFx(),
                 disabled: fxLoading,
                 className: "px-2 py-1 text-xs rounded-sm border border-sas-border text-sas-muted hover:text-sas-accent hover:border-sas-accent transition-colors disabled:opacity-50",
-                title: "Re-scan plugins",
+                title: "Re-scan plugins \u2014 picks up newly installed FX and retries any that failed a previous scan",
                 children: fxLoading ? "..." : "Refresh"
               }
             )
@@ -4686,7 +4686,7 @@ function PanelMasterStrip({
                 onClick: () => onRefreshFx(),
                 disabled: fxLoading,
                 className: "px-2 py-1 text-xs rounded-sm border border-sas-border text-sas-muted hover:text-sas-accent hover:border-sas-accent transition-colors disabled:opacity-50",
-                title: "Re-scan plugins",
+                title: "Re-scan plugins \u2014 picks up newly installed FX and retries any that failed a previous scan",
                 children: fxLoading ? "..." : "Refresh"
               }
             )
@@ -4766,12 +4766,12 @@ function usePanelBus(host, activeSceneId) {
     };
   }, [supported, activeSceneId, bus?.engaged, host]);
   const loadFxList = (0, import_react20.useCallback)(
-    async (force) => {
+    async (opts) => {
       if (!supported || !host.getAvailableFx) return;
-      if (fxLoadedRef.current && !force) return;
+      if (fxLoadedRef.current && !opts.force && !opts.rescan) return;
       setFxLoading(true);
       try {
-        const list = await host.getAvailableFx();
+        const list = opts.rescan && host.rescanAvailableFx ? await host.rescanAvailableFx() : await host.getAvailableFx();
         setAvailableFx(list);
         fxLoadedRef.current = true;
       } catch {
@@ -4784,7 +4784,7 @@ function usePanelBus(host, activeSceneId) {
   const openPicker = (0, import_react20.useCallback)(
     (open) => {
       setFxPickerOpen(open);
-      if (open) void loadFxList(false);
+      if (open) void loadFxList({});
     },
     [loadFxList]
   );
@@ -4809,7 +4809,7 @@ function usePanelBus(host, activeSceneId) {
     fxLoading,
     fxPickerOpen,
     setFxPickerOpen: openPicker,
-    refreshFx: () => void loadFxList(true),
+    refreshFx: () => void loadFxList({ rescan: true }),
     reload,
     onVolumeChange: (volumeDb) => mutate(host.setPanelBusVolume && (() => host.setPanelBusVolume(activeSceneId, volumeDb))),
     onMuteToggle: () => mutate(
@@ -7963,7 +7963,7 @@ function createSurgeSoundAdapter(host, overrides = {}) {
 }
 
 // src/constants/sdk-version.ts
-var PLUGIN_SDK_VERSION = "2.39.0";
+var PLUGIN_SDK_VERSION = "2.40.0";
 
 // src/utils/format-concurrent-tracks.ts
 function formatConcurrentTracks(ctx) {