dsh-plugin-toolkit 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.3.1
+
+- `unmount()` now waits one macrotask before the DOM goes away. React schedules work during its own unmount, and closing jsdom first turned that into `ReferenceError: window is not defined` after a passing test. Found by the example plugin's second test.
+- The README links `dsh-plugin-example` and documents that `unmount()` is async.
+
 ## 0.3.0
 
 - `dsh-plugin dev`: copy a rebuilt bundle into the installed plugin, then confirm the reload from the host's `/plugins/events` stream. Subscribing happens *before* the write, because a copy made first is reported to nobody.

package/README.md

@@ -49,6 +49,8 @@ console.assert(panel.must('[role="status"]').textContent.includes('92'));
 await panel.unmount();
 ```
 
+`unmount()` is async: it lets React finish the work its own unmount schedules before the DOM goes away. Skipping the `await` surfaces as `ReferenceError: window is not defined` *after* the test has already passed, which is a confusing way to learn it.
+
 What you get back: `text()`, `html()`, `query(selector)`, `must(selector)` (throws with the rendered HTML when it misses), `click(selector)`, `type(selector, value)`, `press(selector, key)`, `focus`, `attributes(selector)`, `snapshot(dir, name)` for a normalised DOM baseline, and `host` for assertions about what the bundle registered.
 
 To look at a bundle by hand:
@@ -65,6 +67,14 @@ $ npx dsh-plugin mount ../ai-context-doctor/plugin/client.js
 AIignore No workspace yet Could not read the report …
 ```
 
+## Start from the example
+
+[`dsh-plugin-example`](https://github.com/WJDdidi-1/dsh-plugin-example) is a ~70-line plugin: one sidebar tab, two languages, one behaviour test, CI that runs `doctor` through the composite action. It is the shape this toolkit expects, so it is also the fastest way to see whether the toolkit fits your plugin.
+
+```sh
+dsh plugin add dsh-plugin-example
+```
+
 ## Edit a plugin that is already installed
 
 The host already swaps a rebuilt bundle without a page reload: it watches each plugin's entry artifact and reports a `rebuilt` frame on `/plugins/events`. `dev` puts the new file where the host is looking, then **proves** the frame arrived instead of asking you to check by eye.

package/lib/testkit/mount.mjs

@@ -184,7 +184,14 @@ export async function mountClient(options) {
     },
     writeSnapshot: (dir, name) => write(dir, name, root.innerHTML),
     unmount: async () => {
-      await act(async () => clientRoot.unmount());
+      await act(async () => {
+        clientRoot.unmount();
+        // React schedules follow-up work, and a polling panel schedules timers.
+        // One macrotask lets that land while the DOM is still alive; closing the
+        // window first turns it into "ReferenceError: window is not defined"
+        // after the test has already passed.
+        await new Promise((resolve) => setTimeout(resolve, 0));
+      });
       globalThis.fetch = previousFetch;
       restoreGlobals();
       // A panel polls; jsdom's timers and rAF would keep the test process alive

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-toolkit",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Preflight, release and test DeepSeek Harness plugins: checks what the host needs, waits for npm to actually serve the version, and keeps the market index honest.",
   "type": "module",
   "bin": {