@signalsandsorcery/plugin-sdk 2.35.6 → 2.35.7

package/dist/index.d.mts

@@ -4922,6 +4922,13 @@ interface PanelTransitionGroupAdapter {
     /** Group-fade row header label, e.g. `Bassline (3 voices)`. Default `Group (N tracks)`. */
     groupRowLabel?(memberCount: number): string;
 }
+/** What `onTrackCreated` gets to work with (Add Track is scene-gated, so the scene is non-null). */
+interface TrackCreatedContext {
+    /** Scene the track was created in. */
+    activeSceneId: string;
+    /** The ONE scene-data key builder (always dbId-based). */
+    trackDataKey: (dbId: string, suffix: string) => string;
+}
 interface GeneratorPanelAdapter<M = unknown> {
     identity: PanelIdentity;
     features: PanelFeatureFlags;
@@ -4932,6 +4939,18 @@ interface GeneratorPanelAdapter<M = unknown> {
      * Synth: `host.shufflePreset(handle.id)` non-fatal.
      */
     applyPortedTrackSound(handle: PluginTrackHandle, role?: string): Promise<void>;
+    /**
+     * Optional hook run right after a track is born (Add Track / Import Track).
+     * Lets a family stamp per-track scene-data on the newborn — e.g. the arp
+     * panel anchors every new track as a voice-group of ONE so the group
+     * header's intent controls (voice count / rate / split) exist BEFORE the
+     * first generation instead of appearing only after it (which wasted a
+     * throwaway generation on defaults). The core reloads tracks after the hook
+     * so stamped group metas resolve immediately. Failures are non-fatal — the
+     * track lands as a plain row.
+     * @since SDK 2.43.0
+     */
+    onTrackCreated?(handle: PluginTrackHandle, ctx: TrackCreatedContext): Promise<void>;
     /** System prompt for the family's LLM calls (incl. core-owned crossfade/fade generation). */
     buildSystemPrompt(validRoles: readonly string[]): string;
     /** Parse the family's LLM note responses (crossfade/fade flows). */
@@ -5476,7 +5495,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.42.0";
+declare const PLUGIN_SDK_VERSION = "2.43.0";
 
 /**
  * FX Preset Definitions

package/dist/index.d.ts

@@ -4922,6 +4922,13 @@ interface PanelTransitionGroupAdapter {
     /** Group-fade row header label, e.g. `Bassline (3 voices)`. Default `Group (N tracks)`. */
     groupRowLabel?(memberCount: number): string;
 }
+/** What `onTrackCreated` gets to work with (Add Track is scene-gated, so the scene is non-null). */
+interface TrackCreatedContext {
+    /** Scene the track was created in. */
+    activeSceneId: string;
+    /** The ONE scene-data key builder (always dbId-based). */
+    trackDataKey: (dbId: string, suffix: string) => string;
+}
 interface GeneratorPanelAdapter<M = unknown> {
     identity: PanelIdentity;
     features: PanelFeatureFlags;
@@ -4932,6 +4939,18 @@ interface GeneratorPanelAdapter<M = unknown> {
      * Synth: `host.shufflePreset(handle.id)` non-fatal.
      */
     applyPortedTrackSound(handle: PluginTrackHandle, role?: string): Promise<void>;
+    /**
+     * Optional hook run right after a track is born (Add Track / Import Track).
+     * Lets a family stamp per-track scene-data on the newborn — e.g. the arp
+     * panel anchors every new track as a voice-group of ONE so the group
+     * header's intent controls (voice count / rate / split) exist BEFORE the
+     * first generation instead of appearing only after it (which wasted a
+     * throwaway generation on defaults). The core reloads tracks after the hook
+     * so stamped group metas resolve immediately. Failures are non-fatal — the
+     * track lands as a plain row.
+     * @since SDK 2.43.0
+     */
+    onTrackCreated?(handle: PluginTrackHandle, ctx: TrackCreatedContext): Promise<void>;
     /** System prompt for the family's LLM calls (incl. core-owned crossfade/fade generation). */
     buildSystemPrompt(validRoles: readonly string[]): string;
     /** Parse the family's LLM note responses (crossfade/fade flows). */
@@ -5476,7 +5495,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.42.0";
+declare const PLUGIN_SDK_VERSION = "2.43.0";
 
 /**
  * FX Preset Definitions

package/dist/index.js

@@ -7178,6 +7178,14 @@ function useGeneratorPanelCore({
         ...adapter.createTrackOptions()
       });
       setTracks((prev) => [...prev, newTrackState(handle)]);
+      if (adapter.onTrackCreated) {
+        try {
+          await adapter.onTrackCreated(handle, { activeSceneId, trackDataKey });
+        } catch (err) {
+          console.warn(`[${logTag}] onTrackCreated failed (non-fatal):`, err);
+        }
+        await loadTracks(true);
+      }
       onExpandSelf?.();
       setTimeout(() => {
         const inputs = document.querySelectorAll(
@@ -7194,7 +7202,7 @@ function useGeneratorPanelCore({
       isAddingTrackRef.current = false;
       setIsAddingTrack(false);
     }
-  }, [host, adapter, identity, activeSceneId, isConnected, isAuthenticated, tracks.length, onExpandSelf]);
+  }, [host, adapter, identity, activeSceneId, isConnected, isAuthenticated, tracks.length, onExpandSelf, loadTracks, logTag]);
   const handlePortTrack = (0, import_react30.useCallback)(
     async (sel) => {
       if (!activeSceneId) {
@@ -7234,6 +7242,12 @@ function useGeneratorPanelCore({
           });
         }
         await adapter.applyPortedTrackSound(handle, sel.role);
+        if (adapter.onTrackCreated) {
+          try {
+            await adapter.onTrackCreated(handle, { activeSceneId, trackDataKey });
+          } catch {
+          }
+        }
         host.showToast(
           "success",
           `Imported to ${identity.familyKey}`,
@@ -9034,7 +9048,7 @@ Your previous ensemble had these problems \u2014 fix them while keeping everythi
 }
 
 // src/constants/sdk-version.ts
-var PLUGIN_SDK_VERSION = "2.42.0";
+var PLUGIN_SDK_VERSION = "2.43.0";
 
 // src/utils/format-concurrent-tracks.ts
 function formatConcurrentTracks(ctx) {