@qzsy/dsh-workspace-combobox 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 qzsy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,76 @@
-# Temporary Holding Version
+# @qzsy/dsh-workspace-combobox
 
-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.
+> Packaged from the local DSH plugin dsh-workspace-combobox; published under the @qzsy scope.
+
+## Install
+
+~~~bash
+dsh plugin add @qzsy/dsh-workspace-combobox
+~~~
+
+## Upstream README
+
+# Workspace Combobox for DSH
+
+A persistent DeepSeek Harness Client plugin that upgrades the workspace chooser
+above the New Session composer:
+
+- **The picker becomes a combobox.** The dropdown that opens from the workspace
+  chip is replaced by a focused search field plus a keyboard-driven list. It
+  matches workspace **names and full paths** with one mixed-script query:
+  Han characters (`群星`), full pinyin (`qunxing`), pinyin initials (`qx`),
+  English subsequences (`flut`), and mixed forms (`qunxing-erp`, `群erp`).
+  Matched characters are highlighted; arrows move, Enter picks, Escape closes.
+- **`Ctrl+.` switches workspace from anywhere.** A frame-wide switcher opens
+  over the current surface — including sessions where the New Session picker is
+  not rendered — with the same search, in the roomier dialog layout. Enter
+  **starts a new conversation in that Workspace** (`uiWorkspace.startSession`)
+  instead of reopening the Workspace's latest session. The binding is a normal
+  editable command (`workspace.combobox`) in Settings → Keyboard shortcuts.
+
+Sizing is deliberately split: the picker above the composer stays compact
+(single-line rows, 380 px wide), while the frame-wide dialog keeps the larger
+palette dimensions and full paths.
+
+## Where it plugs in
+
+| Surface | Mechanism |
+| --- | --- |
+| New Session workspace dropdown | A `conversation.hero.workspace` occupant registered at `priority: -1`. The slot registry renders the lowest priority, so it shadows the shipped picker panel registered at 0. The trigger chip, open/close state, `selectedId`, and `onPick` still come from the conversation owner. The panel renders through a React portal on `document.body`, like the shipped menu, so no transformed or clipped ancestor can displace it. |
+| Frame-wide switcher | A `shell.overlay` entry (`workspace-combobox.switcher`) driven by the `workspace.combobox` shortcut command. |
+| Search | The MIT [`text-search-engine`](https://github.com/cjinhuo/text-search-engine) browser build is vendored and injected into the client module, because the client module table cannot resolve npm packages at runtime. |
+
+Replacing the picker panel removes the shipped `conversation.hero.workspace.directoryFlow`
+hole, so this plugin also renders its own **Add workspace…** row: it calls
+`uiWorkspace.pickDirectory()`, registers the path through `workspaces.create()`,
+and then picks the new workspace.
+
+## Install
+
+Installed into the current profile with `plugin_manager install_bundle` and the
+absolute package directory. No build step is needed at install time: `client.js`
+is a plain-JS `__ModuleLoader__` module that only requires `react`, with the
+vendored engine already inlined.
+
+## Files
+
+- `package.json` — bundle manifest (`dsh.bundle.patch`, `dsh.client`, display resources)
+- `cordis.patch.yml` — inserts the Host row
+- `index.js` — Host half (no-op; everything is client-side)
+- `client.js` — the combobox, the frame-wide switcher, the shortcut, and the
+  vendored-engine region
+- `vendor/` — vendored engine build and its MIT license
+- `scripts/sync-vendor-engine.mjs` — regenerates the engine region after a
+  vendor update
+- `locale/en.json`, `locale/zh.json` — Plugin Manager title/description
+- `icon.svg` — original artwork
+
+## Limits
+
+- The trigger chip above the composer belongs to the conversation owner and is
+  not replaceable by a slot occupant, so the typing happens inside the opened
+  panel (a true combobox), not in the chip itself.
+- Workspaces are ordered by latest session activity; the search ranking prefers
+  title hits over path hits.
+- The picker replacement shadows shipped UI. Uninstalling the bundle restores the
+  shipped picker immediately.

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: workspace-combobox
+      name: '@qzsy/dsh-workspace-combobox'