dsh-open-in-dsh 0.2.0 → 0.3.0

package/README.md

@@ -33,7 +33,7 @@ dsh plugin --profile <profile> add dsh-open-in-dsh
 把 `<profile>` 换成目标 profile（桌面版 `desktop`、`dsh web` 用 `web`）。
 从源码安装时把最后一项换成 checkout 里的 `packages/dsh-open-in-dsh` 路径。
 
-装完刷新页面；**改宿主半边（`lib/index.js`）后必须重启宿主**——桌面版要完全退出应用再打开
+装完刷新页面；**改宿主半边（`src/index.ts`，重新 `npm run build` 后）必须重启宿主**——桌面版要完全退出应用再打开
 （关窗口只是缩进托盘），否则运行中的进程还在用模块缓存里的旧代码。
 
 ### 2. 注册系统右键菜单
@@ -202,7 +202,7 @@ Chrome 会把后台页面的定时器节流到每分钟一次，而刚点完右
 
 ```sh
 npm test                            # 82 个测试（含客户端构建与语法检查）
-node --test test/macos.test.mjs     # macOS 启动器/安装器 17 个测试
+node --test test/macos.test.ts     # macOS 启动器/安装器 17 个测试
 ```
 
 `npm test` 覆盖宿主路由与回放、`%V` 的各种形态、脚本镜像（路由路径/端口/`-Probe` 一致）、

package/client/globals.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Ambient browser globals for the DSH client bundle.
+ *
+ * `client/index.ts` is a classic script, not a module: it has no import/export,
+ * so `tsc` emits it as-is and `scripts/build-client.mts` splices the emitted
+ * text into the body of the factory `window.__ModuleLoader__.load({ id,
+ * factory })` registers. This file only describes the globals that contract
+ * itself puts on `window`; DOM types come from the `DOM` lib.
+ */
+
+/** One lazy module registration accepted by `window.__ModuleLoader__.load`. */
+interface DshModuleLoaderRegistration {
+  /** Package name the bundle registers under (`dsh-open-in-dsh`). */
+  id: string
+  /** Runs once on first require; its return value is the module's exports. */
+  factory: (require: (id: string) => unknown) => unknown
+}
+
+/** The devtools/console surface the browser half exposes for troubleshooting. */
+interface DshOpenInDebug {
+  /** The Host route the stream follows. */
+  route: string
+  /** Make one folder the current Workspace (and land in a blank Session). */
+  open: (path: string) => Promise<void>
+  /** Ask the Host to launch one allowlisted app on a path. */
+  openWith: (app: string, path: string) => Promise<void>
+  /** A snapshot of the stream state, for `console.log(__dshOpenIn.status())`. */
+  status: () => {
+    lastSeq: number
+    settings: { alwaysNewSession: boolean }
+    uiWorkspace: boolean
+    readyState: number | null
+  }
+}
+
+interface Window {
+  /** The DSH client module system: executes plugin bundles as classic scripts. */
+  __ModuleLoader__: {
+    load(registration: DshModuleLoaderRegistration): void
+  }
+  /** Troubleshooting hook, callable from the devtools console. */
+  __dshOpenIn: DshOpenInDebug
+}

package/client/{index.js → index.ts}

@@ -41,7 +41,7 @@ function parseFrame(text) {
 const NS = 'dsh-open-in-dsh'
 
 /**
- * Menu labels. scripts/build-client.mjs replaces the marker below with the
+ * Menu labels. scripts/build-client.mts replaces the marker below with the
  * "menu" objects from locale/zh.json and locale/en.json, so the shipped bundle
  * and the package's locale files cannot drift.
  */
@@ -186,7 +186,7 @@ const QSPACE_BUTTON_STYLE = Object.freeze({
 function createAvailability(read) {
   let state = null
   let loading = null
-  const listeners = new Set()
+  const listeners = new Set<() => void>()
   const publish = (next) => {
     if (next === state) return
     state = next