@happyvertical/smrt-playground 0.42.7 → 0.43.1

package/README.md

@@ -35,6 +35,11 @@ That module should:
 
 The shared host discovers these modules and renders them. Package pages do not need to be mounted into the shared playground.
 
+`PlaygroundHost` accepts a qualified entry ID through `selectedEntryId`. When a
+parent changes a non-null controlled selection to `null`, the host restores its
+default module and entry. This keeps reactive route state aligned in both
+directions without remounting the host.
+
 ## Relationship To `smrt playground`
 
 The `smrt playground` CLI commands are the public entry point.

package/dist/svelte/PlaygroundHost.svelte

@@ -20,6 +20,10 @@ export interface Props {
   title?: string;
   subtitle?: string;
   embedded?: boolean;
+  /**
+   * Qualified entry ID controlled by the parent. Clearing a previously
+   * controlled selection restores the playground's default selection.
+   */
   selectedEntryId?: string | null;
   hideEntryList?: boolean;
 }
@@ -45,6 +49,7 @@ let selectedModuleName = $state<string | null>(null);
 let selectedEntryId = $state<string | null>(null);
 let selectedMode = $state<SmrtPlaygroundMode>('mock');
 let isHydrated = $state(false);
+let previousControlledSelectedEntryId: string | null = null;
 const inheritedThemeContext = tryGetThemeContext();
 
 onMount(() => {
@@ -133,6 +138,11 @@ const foundationGroups = $derived.by(() => {
 });
 
 $effect(() => {
+  const controlledSelectionWasCleared =
+    previousControlledSelectedEntryId !== null &&
+    controlledSelectedEntryId === null;
+  previousControlledSelectedEntryId = controlledSelectedEntryId;
+
   const controlledModule = controlledSelectedEntryId
     ? (orderedModules.find((module) =>
         module.entries.some(
@@ -147,6 +157,16 @@ $effect(() => {
     return;
   }
 
+  if (controlledSelectionWasCleared) {
+    selectedModuleName = firstModule.packageName;
+    selectedEntryId =
+      firstModule.packageName === foundationPackageName || hideEntryList
+        ? (firstModule.entries[0]?.qualifiedId ?? null)
+        : null;
+    selectedMode = firstModule.entries[0]?.availableModes[0] ?? 'mock';
+    return;
+  }
+
   const activeModule =
     controlledModule ??
     orderedModules.find(

package/dist/svelte/PlaygroundHost.svelte.d.ts

@@ -5,6 +5,10 @@ export interface Props {
     title?: string;
     subtitle?: string;
     embedded?: boolean;
+    /**
+     * Qualified entry ID controlled by the parent. Clearing a previously
+     * controlled selection restores the playground's default selection.
+     */
     selectedEntryId?: string | null;
     hideEntryList?: boolean;
 }

package/dist/svelte/PlaygroundHost.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlaygroundHost.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/PlaygroundHost.svelte.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGxC,OAAO,KAAK,EAIV,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,KAAK;IACpB,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAodD,QAAA,MAAM,cAAc,0BAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"PlaygroundHost.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/PlaygroundHost.svelte.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGxC,OAAO,KAAK,EAIV,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAGpB,MAAM,WAAW,KAAK;IACpB,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAoeD,QAAA,MAAM,cAAc,0BAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-playground",
-  "version": "0.42.7",
+  "version": "0.43.1",
   "description": "Shared playground discovery, runtime, and host components for SMRT UI packages",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,7 +29,7 @@
   "dependencies": {
     "fast-glob": "3.3.3",
     "tsx": "^4.23.0",
-    "@happyvertical/smrt-ui": "0.42.7"
+    "@happyvertical/smrt-ui": "0.43.1"
   },
   "peerDependencies": {
     "svelte": "^5.56.4",