dsh-float-window

Shared floating-window shell for DSH web plugins — one React component giving every DeepSeek Harness plugin the same window behavior: dsh-shorts-wall and dsh-deepsea both render through it.

中文 | English

Features

Usage

Source package (consumers inline it with tsdown; react is a peerDependency):

import { FloatWindow } from 'dsh-float-window'

<FloatWindow
  storageKey="my-plugin:shell"   // geometry/mode persistence key
  title="My Window"
  accent="#7fc4ff"
  launcherGlyph="🪟"
  labels={{
    openTitle: 'Open window',
    expandTitle: 'Expand',
    minimizeTitle: 'Minimize (boss key restores)',
    modeToggleTip: 'Toggle float / dock',
    floatText: 'float',
    bossKeyText: 'Boss key {key}',  // optional; {key} substitutes the live combo
  }}
>
  {(visible, ctx) => <YourContent visible={visible} bossKey={ctx.bossKey} />}
</FloatWindow>

Requires React 18+ (peer) and a bundler-style TypeScript resolution (tsdown/vite/tsc moduleResolution: bundler).

Multi-window detection & boss-key assignment (≥0.2)

Every plugin client bundles its own copy of this component, so coordination rides the window.__dshFloatWindows global registry:

• Detection: floatWindowSnapshot() lists the windows mounted in the document and the combo each answers to; the same registry drives z stacking and the bottom-right launcher offsets (bottom: 18 + n×52).
• Auto-assignment: windows without a declared key take combos from the pool Alt+S → Alt+X → Alt+Z → Alt+C → Alt+V → Alt+B → Alt+Q → Alt+W in mount order (Alt+D/E/F are skipped — Chrome reserves them), then Alt+Shift+1…. A lone window behaves exactly like 0.1 (Alt+S).
• Declared keys: a bossKey="Alt+D" combo is reserved — auto windows never land on it, and an auto window sitting on it yields and refreshes its hints. Two windows declaring the same combo both respond, as asked.
• Full control: an isBossKey predicate without a bossKey keeps the anonymous 0.1 behaviour — no coordination, hint degrades to "Boss key".
• Live hints: launcher and dock-rail tooltips, plus the bossKeyText label (supports the {key} placeholder), always show the combo the window currently answers to.

Note: coordination requires every window in the page to run ≥0.2 (0.1 instances do not register and keep defaulting to Alt+S).

License

MIT