@pie-players/pie-section-player-tools-shared 0.3.66 → 0.3.68

package/dist/section-controller-subscription.d.ts

@@ -0,0 +1,29 @@
+import { SectionControllerLifecycleEventLike } from './section-controller.js';
+export interface SectionControllerSubscriptionHandlers<TController> {
+    /** Look up the current controller for the caller's active sectionId/attemptId. */
+    getController: () => TController | null | undefined;
+    /** Attach whatever event listeners this caller needs; return their combined teardown. */
+    subscribe: (controller: TController) => () => void;
+    /** Called once right after a fresh subscribe (not on an already-current target). */
+    onSubscribed?: (controller: TController) => void;
+    /** Called when no controller is available for the current target. */
+    onControllerUnavailable?: () => void;
+}
+/**
+ * Tracks the controller subscription + lifecycle-driven resubscribe queue
+ * shared by every debugger panel that follows a section controller across
+ * `sectionId`/`attemptId` and coordinator-republish changes. Callers wire
+ * this from inside a Svelte `$effect`; see `bindLifecycle`'s doc comment for
+ * the untrack requirement from this repo's Svelte Subscription Safety rule.
+ */
+export declare function createSectionControllerSubscriptionManager<TController>(handlers: SectionControllerSubscriptionHandlers<TController>): {
+    ensure: (sectionId: string, attemptId?: string) => void;
+    queueEnsure: (sectionId: string, attemptId?: string) => void;
+    isActiveTarget: (sectionId: string, attemptId?: string) => boolean;
+    bindLifecycle: (coordinator: {
+        onSectionControllerLifecycle?: (listener: (event: SectionControllerLifecycleEventLike) => void) => () => void;
+    } | null | undefined, sectionId: string, attemptId: string | undefined, onMatchingEvent?: (event: SectionControllerLifecycleEventLike) => void) => void;
+    detachController: () => void;
+    detachLifecycle: () => void;
+    detachAll: () => void;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@pie-players/pie-section-player-tools-shared",
-	"version": "0.3.66",
+	"version": "0.3.68",
 	"type": "module",
 	"description": "Shared UI and helpers for PIE section-player debug tools",
 	"repository": {
@@ -32,21 +32,25 @@
 	],
 	"license": "MIT",
 	"dependencies": {
-		"@pie-players/pie-theme": "0.3.66"
+		"@pie-players/pie-players-shared": "0.3.68",
+		"@pie-players/pie-theme": "0.3.68"
 	},
 	"types": "./dist/index.types.d.ts",
 	"scripts": {
 		"build": "vite build",
 		"dev": "vite build --watch",
 		"typecheck": "tsc --noEmit",
-		"lint": "biome check PanelWindowControls.svelte PanelResizeHandle.svelte SharedFloatingPanel.svelte SessionDbPanel.svelte DebugPanelToggles.svelte floating-panel.ts section-controller.ts index.ts vite.config.ts package.json"
+		"check": "svelte-check --tsconfig ./tsconfig.json --compiler-warnings options_missing_custom_element:ignore",
+		"test": "bun test tests",
+		"lint": "biome check PanelWindowControls.svelte PanelResizeHandle.svelte SharedFloatingPanel.svelte SessionDbPanel.svelte DebugPanelToggles.svelte floating-panel.ts section-controller.ts index.ts vite.config.ts package.json tests"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.5.7",
+		"@biomejs/biome": "^2.5.8",
 		"@sveltejs/vite-plugin-svelte": "^7.2.0",
 		"svelte": "^5.56.8",
+		"svelte-check": "^4.7.5",
 		"typescript": "^5.9.3",
-		"vite": "^8.0.10",
+		"vite": "^8.2.1",
 		"vite-plugin-dts": "^5.0.3"
 	},
 	"homepage": "https://github.com/pie-framework/pie-players/tree/master/packages/section-player-tools-shared#readme",