dsh-plugin-workspace-move-top 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# 工作区移到最上面
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+在 DSH 工作区 `…` 菜单中添加“移到最上面”。点击只调整一次顺序，随后仍可自由拖动；顺序由 Host 的 `workspaceRegistry.insertBefore` 保存。插件不保存运行时排序或收藏状态，启动与同步时不重新排序。
+
+仅支持 **DSH 0.2.1-rc.5**。
+
+安装：
+
+```sh
+dsh plugin --profile desktop add dsh-plugin-workspace-move-top@0.2.0
+```
+
+当前 Host 没有工作区菜单扩展 slot。客户端依赖工作区行和菜单的 DOM 结构；宿主改变 DOM 后，菜单项可能不出现。Node 测试不能代替真实 Electron DOM 验证。
+
+验证：`npm run check`。

package/client/client.js

@@ -0,0 +1,133 @@
+// One-shot workspace reorder. No favorites, pins, persistent state or row icons.
+window.__ModuleLoader__.load({
+  id: 'dsh-plugin-workspace-move-top',
+  factory: function (require) {
+    var module = { exports: {} }
+    var exports = module.exports
+    var MENU_ITEM = 'data-wshub-move-top'
+    var API_PATH = 'api/plugins/wshub-workspace-move-top/move'
+
+    function apply(ctx) {
+      ctx.effect(function () {
+        var workspaceId = null
+        var busy = false
+        var observer = null
+        var timer = null
+        var buttons = new Set()
+
+        function rowId(target) {
+          var row = target && target.closest && target.closest('[data-row-key^="workspace:"]')
+          if (!row) return null
+          var key = row.getAttribute('data-row-key') || ''
+          return key.slice(10) || null
+        }
+
+        // Capture the row whose native workspace action button opened this menu.
+        function onPointerDown(event) {
+          if (!(event.target instanceof Element)) return
+          var button = event.target.closest('button[aria-label]')
+          if (event.target.closest('[role="menu"]')) return
+          if (!button || button.hasAttribute('aria-keyshortcuts')) {
+            workspaceId = null
+            return
+          }
+          var row = button.closest('[data-row-key^="workspace:"]')
+          workspaceId = row && row.querySelector('button[aria-label]') === button ? rowId(button) : null
+        }
+
+        async function moveToTop(button) {
+          var id = button.dataset.wshubWorkspaceId
+          if (!id || busy) return
+          busy = true
+          button.disabled = true
+          button.title = '正在调整顺序…'
+          try {
+            var response = await fetch(API_PATH, {
+              method: 'POST',
+              headers: { 'content-type': 'application/json' },
+              body: JSON.stringify({ workspaceId: id, action: 'move-to-top' }),
+            })
+            var result = await response.json().catch(function () { return null })
+            if (!response.ok || !result || result.ok !== true) throw new Error((result && result.message) || ('HTTP ' + response.status))
+            button.title = '已移到最上面'
+            // Closing the native menu removes the extension row with it.
+            var trigger = document.activeElement
+            if (trigger && trigger.closest && trigger.closest('[data-row-key^="workspace:"]')) trigger.click()
+            var event = new KeyboardEvent('keydown', { key: 'Escape', bubbles: true })
+            document.dispatchEvent(event)
+            // DOM teardown is authoritative; the Host publishes the new order.
+          } catch (error) {
+            button.disabled = false
+            button.title = '调整失败：' + (error instanceof Error ? error.message : String(error))
+            button.setAttribute('aria-label', button.title)
+          } finally {
+            busy = false
+          }
+        }
+
+        function decorate() {
+          observer.disconnect()
+          try {
+            var menus = document.querySelectorAll('[role="menu"][data-menu-material="translucent"]')
+            for (var i = 0; i < menus.length; i++) {
+              var menu = menus[i]
+              if (!workspaceId || menu.querySelector('[' + MENU_ITEM + ']')) continue
+              var viewport = menu.querySelector('[role="presentation"]')
+              var template = viewport && viewport.querySelector('button[role="menuitem"]')
+              if (!template) continue
+              // Clone only native menu classes/row structure; do not copy its actions.
+              var wrapper = template.parentElement.cloneNode(false)
+              var button = template.cloneNode(false)
+              button.setAttribute(MENU_ITEM, '1')
+              button.dataset.wshubWorkspaceId = workspaceId
+              button.removeAttribute('class')
+              button.className = template.className
+              button.setAttribute('aria-label', '移到最上面')
+              button.title = '只调整一次顺序，之后仍可自由拖动'
+              var spans = template.querySelectorAll('span')
+              if (spans[0]) {
+                var icon = document.createElement('span')
+                icon.className = spans[0].className
+                icon.textContent = '↑'
+                button.appendChild(icon)
+              }
+              var label = document.createElement('span')
+              var labelTemplate = spans[1] || spans[0]
+              if (labelTemplate) label.className = labelTemplate.className
+              label.textContent = '移到最上面'
+              button.appendChild(label)
+              button.addEventListener('click', function (event) {
+                event.preventDefault()
+                event.stopPropagation()
+                void moveToTop(event.currentTarget)
+              })
+              wrapper.appendChild(button)
+              viewport.insertBefore(wrapper, viewport.firstChild)
+              buttons.add(button)
+            }
+          } finally {
+            observer.observe(document.documentElement, { childList: true, subtree: true })
+          }
+        }
+        function schedule() {
+          if (timer !== null) return
+          timer = setTimeout(function () { timer = null; decorate() }, 40)
+        }
+        observer = new MutationObserver(schedule)
+        observer.observe(document.documentElement, { childList: true, subtree: true })
+        document.addEventListener('pointerdown', onPointerDown, true)
+        document.addEventListener('keydown', onPointerDown, true)
+        return function () {
+          document.removeEventListener('pointerdown', onPointerDown, true)
+          document.removeEventListener('keydown', onPointerDown, true)
+          observer.disconnect()
+          if (timer !== null) clearTimeout(timer)
+          buttons.forEach(function (button) { button.remove() })
+          buttons.clear()
+        }
+      })
+    }
+    exports.apply = apply
+    return module.exports
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+- insert:
+    - id: wshub-workspace-move-top
+      name: dsh-plugin-workspace-move-top
+      # Stateless one-shot ordering; no favorites or saved plugin state.

package/dsh-plugin.naming.json

@@ -0,0 +1,33 @@
+{
+  "schemaVersion": 1,
+  "policy": "dsh-plugin-naming/v1",
+  "plugin": {
+    "namespace": "wshub",
+    "name": "workspace-move-top",
+    "coordinate": "wshub/workspace-move-top",
+    "packageName": "dsh-plugin-workspace-move-top"
+  },
+  "names": {
+    "pluginNames": [
+      "workspace-move-top"
+    ],
+    "loaderIds": [
+      "wshub-workspace-move-top"
+    ],
+    "services": [
+      "wshubWorkspaceMoveTop"
+    ],
+    "tools": [],
+    "commands": [],
+    "skills": [],
+    "skillProviders": [],
+    "events": [],
+    "settingsNamespaces": [],
+    "routes": [
+      {
+        "kind": "exact",
+        "path": "/api/plugins/wshub-workspace-move-top/move"
+      }
+    ]
+  }
+}

package/lib/index.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare const name = "workspace-move-top";
+export declare const inject: string[];
+export { WorkspaceMoveTopService, SERVICE_NAME } from './service.js';
+export { MOVE_ROUTE, handleMoveRequest } from './move-route.js';
+/** Activate the stateless move-to-top service. No startup reordering: the
+ * host's durable registry order is left untouched until a client asks to move
+ * one workspace to the top.
+ * @param ctx injected plugin scope
+ */
+export declare function apply(ctx: Context): Promise<void>;

package/lib/index.js

@@ -0,0 +1,15 @@
+import { WorkspaceMoveTopService } from './service.js';
+import { installMoveRoute } from './move-route.js';
+export const name = 'workspace-move-top';
+export const inject = ['workspaceRegistry'];
+export { WorkspaceMoveTopService, SERVICE_NAME } from './service.js';
+export { MOVE_ROUTE, handleMoveRequest } from './move-route.js';
+/** Activate the stateless move-to-top service. No startup reordering: the
+ * host's durable registry order is left untouched until a client asks to move
+ * one workspace to the top.
+ * @param ctx injected plugin scope
+ */
+export async function apply(ctx) {
+    const moveTop = new WorkspaceMoveTopService(ctx);
+    installMoveRoute(ctx, moveTop);
+}

package/lib/move-route.d.ts

@@ -0,0 +1,17 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { WorkspaceMoveTopService } from './service.js';
+/** Exact connection route the client calls for a one-shot move. */
+export declare const MOVE_ROUTE = "/api/plugins/wshub-workspace-move-top/move";
+export declare const MOVE_ACTION = "move-to-top";
+/** Handle an authenticated request.
+ * @param moveTop serialized service
+ * @param request owner authenticated request
+ * @returns JSON response
+ */
+export declare function handleMoveRequest(moveTop: WorkspaceMoveTopService, request: Request): Promise<Response>;
+/** Register the optional connection route with an effect disposer.
+ * @param ctx plugin context
+ * @param moveTop serialized service
+ * @returns nothing
+ */
+export declare function installMoveRoute(ctx: Context, moveTop: WorkspaceMoveTopService): void;

package/lib/move-route.js

@@ -0,0 +1,40 @@
+/** Exact connection route the client calls for a one-shot move. */
+export const MOVE_ROUTE = '/api/plugins/wshub-workspace-move-top/move';
+export const MOVE_ACTION = 'move-to-top';
+/** Handle an authenticated request.
+ * @param moveTop serialized service
+ * @param request owner authenticated request
+ * @returns JSON response
+ */
+export async function handleMoveRequest(moveTop, request) {
+    const headers = { 'cache-control': 'no-store' };
+    try {
+        if (request.method !== 'POST')
+            return Response.json({ ok: false, message: '不支持的请求方式' }, { status: 405, headers });
+        let body;
+        try {
+            body = await request.json();
+        }
+        catch {
+            return Response.json({ ok: false, message: '请求不是合法 JSON' }, { status: 400, headers });
+        }
+        if (!body || typeof body !== 'object' || Array.isArray(body) || !('workspaceId' in body) || typeof body.workspaceId !== 'string' || !body.workspaceId.trim() || !('action' in body) || body.action !== MOVE_ACTION) {
+            return Response.json({ ok: false, message: `需要工作区 ID 与 action: '${MOVE_ACTION}'` }, { status: 400, headers });
+        }
+        const result = await moveTop.moveToTop(body.workspaceId);
+        return Response.json(result, { status: result.ok ? 200 : 409, headers });
+    }
+    catch {
+        return Response.json({ ok: false, message: '移动未完成，请刷新后重试' }, { status: 500, headers });
+    }
+}
+/** Register the optional connection route with an effect disposer.
+ * @param ctx plugin context
+ * @param moveTop serialized service
+ * @returns nothing
+ */
+export function installMoveRoute(ctx, moveTop) {
+    ctx.inject(['connection'], scope => {
+        scope.effect(() => scope.connection.fetch.register({ path: MOVE_ROUTE, methods: ['POST'], requestBody: 'buffered', fetch: request => handleMoveRequest(moveTop, request) }));
+    });
+}

package/lib/service.d.ts

@@ -0,0 +1,47 @@
+import { Service, type Context } from '@deepseek-ai/cordis';
+export declare const SERVICE_NAME = "wshubWorkspaceMoveTop";
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        wshubWorkspaceMoveTop: WorkspaceMoveTopService;
+    }
+}
+/** Registry projection needed for ordering and the route payload. */
+export interface WorkspaceEntryView {
+    readonly id: string;
+    readonly path: string;
+    readonly title: string;
+}
+/** One successful move-to-top result. */
+export interface MoveToTopResult {
+    readonly ok: true;
+    /** Whether an `insertBefore` actually moved the workspace. */
+    readonly moved: boolean;
+    /** The complete durable order after the operation (top first). */
+    readonly order: readonly string[];
+    readonly workspaces: readonly WorkspaceEntryView[];
+}
+/** Failure result for an empty registry or an unknown workspace. */
+export interface MoveToTopError {
+    readonly ok: false;
+    readonly reason: 'none';
+    readonly message: string;
+}
+/** Stateless "move to top" service. Owns the registry ordering queue but no
+ * file or saved state: it never reorders on activation and keeps no ordering
+ * or favorites state. */
+export declare class WorkspaceMoveTopService extends Service {
+    private queue;
+    constructor(ctx: Context);
+    private enqueue;
+    private list;
+    /** Move one workspace to the top of the durable display order, exactly once.
+     *
+     * Reads the real registry order; an already-first workspace is a no-op and an
+     * unknown workspace is rejected without touching the order. Otherwise it asks
+     * the host for `insertBefore(id, firstId)` — the same durable write the
+     * official sidebar drag uses — so the result survives restart and no plugin
+     * startup pass re-applies it.
+     * @param workspaceId exact registry ID
+     */
+    moveToTop(workspaceId: string): Promise<MoveToTopResult | MoveToTopError>;
+}

package/lib/service.js

@@ -0,0 +1,48 @@
+import { Service } from '@deepseek-ai/cordis';
+export const SERVICE_NAME = 'wshubWorkspaceMoveTop';
+function toEntryView(entry) {
+    return { id: String(entry.id), path: entry.path, title: entry.title };
+}
+/** Stateless "move to top" service. Owns the registry ordering queue but no
+ * file or saved state: it never reorders on activation and keeps no ordering
+ * or favorites state. */
+export class WorkspaceMoveTopService extends Service {
+    queue = Promise.resolve();
+    constructor(ctx) {
+        super(ctx, SERVICE_NAME);
+    }
+    enqueue(action) {
+        const run = this.queue.then(action);
+        this.queue = run.then(() => undefined, () => undefined);
+        return run;
+    }
+    list() {
+        return this.ctx.workspaceRegistry.list().map(toEntryView);
+    }
+    /** Move one workspace to the top of the durable display order, exactly once.
+     *
+     * Reads the real registry order; an already-first workspace is a no-op and an
+     * unknown workspace is rejected without touching the order. Otherwise it asks
+     * the host for `insertBefore(id, firstId)` — the same durable write the
+     * official sidebar drag uses — so the result survives restart and no plugin
+     * startup pass re-applies it.
+     * @param workspaceId exact registry ID
+     */
+    moveToTop(workspaceId) {
+        return this.enqueue(async () => {
+            const registry = this.ctx.workspaceRegistry;
+            const order = registry.list();
+            const first = order[0];
+            if (first === undefined)
+                return { ok: false, reason: 'none', message: '工作区列表为空' };
+            if (first.id === workspaceId) {
+                return { ok: true, moved: false, order: order.map(entry => String(entry.id)), workspaces: order.map(toEntryView) };
+            }
+            if (!order.some(entry => entry.id === workspaceId)) {
+                return { ok: false, reason: 'none', message: '工作区已不存在，请刷新列表' };
+            }
+            const next = await registry.insertBefore(workspaceId, first.id);
+            return { ok: true, moved: true, order: next.map(id => String(id)), workspaces: this.list() };
+        });
+    }
+}

package/package.json

@@ -1,6 +1,69 @@
 {
   "name": "dsh-plugin-workspace-move-top",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "DSH 工作区菜单：移到最上面。一次调整顺序，保留自由拖动，无收藏或固定置顶。",
+  "license": "MIT",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./client/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/",
+    "client/",
+    "cordis.patch.yml",
+    "README.md",
+    "dsh-plugin.naming.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dongsheng123132/workspace-hub.git",
+    "directory": "plugins/dsh-workspace-move-top"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": { "platform": "web" }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test test/{client,composition}.test.mjs",
+    "check": "npm run typecheck && npm run build && npm test",
+    "prepack": "npm run build",
+    "pretest": "npm run build"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "4.0.5",
+    "@deepseek-ai/dsh-workspace": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-rc.5"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.5",
+    "@deepseek-ai/dsh-workspace": "0.2.1-rc.5",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-rc.5",
+    "@types/node": "24.10.1",
+    "typescript": "5.9.3"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "dsh-plugin",
+    "workspace",
+    "move-top",
+    "ordering"
+  ],
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-client-connection": {
+      "optional": true
+    }
+  }
+}