dsh-mini-utility-dock 0.5.0 → 0.5.1

package/CHANGELOG.en.md

@@ -3,6 +3,10 @@
 Release notes are generated from the matching version section; newest first.
 For Chinese, see [CHANGELOG.md](CHANGELOG.md).
 
+## 0.5.1 - 2026-09-25
+
+- Fix the launcher disappearing after a hot reload: the claim is released with its owner, which wakes the other copies to register again instead of requiring a full page reload.
+
 ## 0.5.0 - 2026-09-24
 
 - New `dist/launcher.js` (marker `dsh-utility-launcher`): the family's shared entry point — one icon at the bottom-left that opens a menu of the family's panels. It goes through slots rather than a page-local protocol: one copy of the assembly runs per page (the first plugin to load wins the `window` mutex and declares the menu seat `createhelper.utility.item`), and every other plugin contributes one row to that seat. Consumers maintain it with `launcher:sync` / `launcher:check`, so the three client halves no longer each carry their own copy.

package/CHANGELOG.md

@@ -3,6 +3,10 @@
 Release Notes 由对应版本段生成；最新版本在前。
 英文版见 [CHANGELOG.en.md](CHANGELOG.en.md)。
 
+## 0.5.1 - 2026-09-25
+
+- 修复 launcher 热重载后消失：归属从一次性闩锁改为可释放的认领，owner 被销毁时唤醒其余副本重新注册，不再需要刷新整页。
+
 ## 0.5.0 - 2026-09-24
 
 - 新增 `dist/launcher.js`（片段标记 `dsh-utility-launcher`）：族的共享入口——左下角一个图标，点开一个列出各插件面板的菜单。它走槽位而不是页面级协议：每页只有一份装配（先加载的插件赢得 `window` 互斥并声明菜单座位 `createhelper.utility.item`），其余插件各往那个座位投一行。消费插件用 `launcher:sync` / `launcher:check` 维护，三个 client 半从此不再各写一份。

package/bin/dsh-mini-utility-dock.js

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 // Embed a canonical fragment from this package into a consumer file.
 //
-// Two fragments are maintained the same way, because both have the same shape
-// of problem: the consumer must ship the code standalone (a browser classic
+// Three fragments are maintained the same way, because all three have the same
+// shape of problem: the consumer must ship the code standalone (a browser classic
 // script cannot `import`, and a host half must not depend on the dock being
 // installed), so the code is embedded at build time and drift is a build error.
 //
-//   dsh-mini-utility-dock  -> <dsh-mini-utility-dock> ... </dsh-mini-utility-dock>
-//     the Mini Utility Dock bootstrap, embedded into a plugin's lib/client.js
+//   dsh-utility-launcher   -> <dsh-utility-launcher> ... </dsh-utility-launcher>
+//     the family launcher (one icon plus the menu of family panels it opens),
+//     embedded into a plugin's lib/client.js
 //
 //   dsh-loopback-helpers   -> <dsh-loopback-helpers> ... </dsh-loopback-helpers>
 //     the loopback predicates, embedded into a plugin's lib/shared.js
@@ -21,8 +22,9 @@
 // embed just those.
 //
 // The fragment is selected by the marker already present in the target file, so
-// one command serves either target. A consumer calls this through its own
-// `dock:sync` / `guard:sync` script; the paired `check` mode is what CI runs.
+// one command serves every target and only a named block is ever touched. A
+// consumer calls this through its own `launcher:sync` / `guard:sync` /
+// `loopback:sync` script; the paired `check` mode is what CI runs.
 
 import { readFile, writeFile, stat } from 'node:fs/promises'
 import { resolve } from 'node:path'

package/dist/launcher.js

@@ -155,9 +155,39 @@ function UtilityLauncher (props) {
 // The seat belongs to the shell, so it is reached through inject: registering
 // into it directly throws while that declaration is still pending, and a
 // launcher must never cost the caller the surfaces it registers afterwards.
+//
+// The claim lives on the page and is released with its owner. Every family
+// client half carries this assembly, so without the release a hot reload of the
+// owner would dispose its registration while the claim stayed taken, and the
+// launcher would stay missing until the page was reloaded. A released claim
+// wakes the other copies, which re-register immediately.
+const utilityClaim = () => {
+  if (typeof window === 'undefined') return null
+  const existing = window[UTILITY_MUTEX_KEY]
+  if (existing !== null && typeof existing === 'object') return existing
+  const claim = { owner: null, waiters: new Set() }
+  window[UTILITY_MUTEX_KEY] = claim
+  return claim
+}
 const registerUtilityLauncher = (scope) => {
-  if (typeof window === 'undefined' || window[UTILITY_MUTEX_KEY] === true) return
-  window[UTILITY_MUTEX_KEY] = true
+  const claim = utilityClaim()
+  if (claim === null) return
+  if (claim.owner !== null) {
+    claim.waiters.add(() => registerUtilityLauncher(scope))
+    return
+  }
+  claim.owner = scope
+  let released = false
+  const release = () => {
+    if (released) return
+    released = true
+    if (claim.owner === scope) claim.owner = null
+    if (window[UTILITY_MUTEX_KEY] !== claim) return
+    const waiters = [...claim.waiters]
+    claim.waiters.clear()
+    for (const wake of waiters) wake()
+  }
+  scope.on('dispose', release)
   scope.slots.inject('shell.overlay', () => {
     try {
       scope.slots.register({
@@ -167,7 +197,7 @@ const registerUtilityLauncher = (scope) => {
         children: { [UTILITY_ITEM_SLOT]: { kind: 'list', scope: 'root' } }
       }, UtilityLauncher)
     } catch (error) {
-      window[UTILITY_MUTEX_KEY] = false
+      release()
       if (typeof console !== 'undefined' && typeof console.error === 'function') {
         console.error('[utility-launcher] could not register the family launcher', error)
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mini-utility-dock",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "The DSH plugin family's shared assets: source fragments (the loopback predicates and host request guard for host halves, the utility launcher for client halves), the embedding CLI, and the family diagnostics — cross-repo drift check and bilingual docs structure check.",
   "type": "module",
   "bin": {