@zongcn/dsh-next-steps 0.1.1 → 0.1.3

package/README.md

@@ -18,7 +18,7 @@ It costs one short model call per qualifying turn. It never sends anything on yo
 
 **Main features.**
 
-- **Chips above the composer.** Three numbered prompts, one click away. Clicking one writes it into the composer as a draft — edit it, then press Enter yourself. Regenerate the row in place for a fresh set, or dismiss it when it is not what you wanted.
+- **Chips above the composer.** Three numbered prompts, one click away. Hover or keyboard-focus a chip to read its full prompt in a tooltip; clicking one writes it into the composer as a draft — edit it, then press Enter yourself. Regenerate the row in place for a fresh set, or dismiss it when it is not what you wanted.
 - **Suggestions that know the session.** The model sees the last ten human and model messages, and — when enabled — the session's skill catalog, so a suggestion can be a real `/skill` prompt rather than generic advice. Prompts come back in the language you were already using.
 - **No provider to set up.** Suggestions run on whatever model route the session already uses, so there is no second API key and no extra bill to reconcile.
 
@@ -77,7 +77,7 @@ Options live in `cordis.patch.yml`, under the bundle row's `config`:
 
 ```yaml
 - insert:
-    - id: next-steps
+    - id: dsh-next-steps
       name: '@zongcn/dsh-next-steps'
       config:
         maxSuggestions: 3
@@ -125,12 +125,14 @@ The plugin serves only the two local state routes it needs, and it never submits
 ## Development
 
 ```sh
-npm test                      # 33 host checks + 10 dock checks, no dependencies, no browser
+npm test                      # 33 host checks + 13 dock checks, no dependencies, no browser
 node scripts/selftest.mjs     # host half only
 node scripts/verify-dock.mjs  # browser half: the composer band, driven by a React stub
 node scripts/verify-ui.mjs    # optional Playwright run against a live GUI (see the script header)
 ```
 
+**Releasing.** The full release checklist — version bump, CI, npm publish, GitHub Release, and clean-profile verification — lives in [English](RELEASING.md) and [简体中文](RELEASING.zh-CN.md).
+
 The source is small enough to read in one sitting:
 
 ```text

package/README.zh-CN.md

@@ -18,7 +18,7 @@ Next steps 是 DeepSeek Harness（DSH）的一个插件。每轮回答结束，
 
 **主要功能。**
 
-- **输入框上方的建议 chips。** 三条带编号的提示，点一下就写进输入框变成草稿——改完自己按回车；想换一批可以原地重新生成，不需要时点 dismiss 收起。
+- **输入框上方的建议 chips。** 三条带编号的提示；悬停或键盘聚焦会显示完整提示，点一下就写进输入框变成草稿——改完自己按回车；想换一批可以原地重新生成，不需要时点 dismiss 收起。
 - **懂这段对话的建议。** 模型看到最近十条人和模型的消息，以及（默认开启的）本会话技能清单，所以建议可以是一个真正的 `/skill` 提示，而不是泛泛而谈；建议会沿用你刚才使用的语言。
 - **不用再配一个 provider。** 建议跑在会话本来就在用的模型路由上，不需要第二把 API key，也不会多出一份账单。
 
@@ -77,7 +77,7 @@ dsh plugin --profile web add "$PWD/dsh-next-steps"
 
 ```yaml
 - insert:
-    - id: next-steps
+    - id: dsh-next-steps
       name: '@zongcn/dsh-next-steps'
       config:
         maxSuggestions: 3
@@ -125,12 +125,14 @@ dsh plugin --profile web add "$PWD/dsh-next-steps"
 ## 开发
 
 ```sh
-npm test                      # 33 项宿主检查 + 10 项横条检查，零依赖、无浏览器
+npm test                      # 33 项宿主检查 + 13 项横条检查，零依赖、无浏览器
 node scripts/selftest.mjs     # 仅宿主半
 node scripts/verify-dock.mjs  # 浏览器半：用 React 桩驱动输入框横条
 node scripts/verify-ui.mjs    # 可选：对一个真实 GUI 跑 Playwright（见脚本头部说明）
 ```
 
+**发布。** 完整发布清单（改版本、CI、npm publish、GitHub Release、干净 profile 验证）见 [简体中文](RELEASING.zh-CN.md) 与 [English](RELEASING.md)。
+
 源码很少，一口气能读完：
 
 ```text

package/client.js

@@ -13,7 +13,8 @@
  */
 
 window.__ModuleLoader__.load({
-  id: 'dsh-next-steps',
+  // The graph row id is the package name (client-modules requires them to match).
+  id: '@zongcn/dsh-next-steps',
   factory(require) {
     const React = require('react')
     const h = React.createElement
@@ -112,6 +113,10 @@ window.__ModuleLoader__.load({
       '.nsx-band-label{font-size:11px;color:var(--dsw-alias-label-secondary);padding:0 2px;flex:none}',
       '.nsx-band-error{flex:1 1 100%;min-width:0;white-space:normal;overflow-wrap:anywhere;line-height:1.5;color:var(--dsw-alias-state-error-primary)}',
       '.nsx-chips{display:flex;gap:6px;flex-wrap:wrap;flex:1;min-width:0}',
+      '.nsx-chip-wrap{position:relative;display:inline-flex;max-width:100%}',
+      '.nsx-tip{position:absolute;left:0;bottom:calc(100% + 8px);z-index:30;box-sizing:border-box;width:max-content;max-width:min(420px, calc(100vw - 48px));padding:8px 10px;border-radius:var(--dsw-radius-lg);background:var(--dsw-alias-bg-layer-1);color:var(--dsw-alias-label-primary);box-shadow:var(--dsw-elevation-panel);font-size:11.5px;line-height:1.5;white-space:normal;overflow-wrap:anywhere;pointer-events:none;animation:nsx-tip-in .12s ease-out}',
+      '@keyframes nsx-tip-in{from{opacity:0;transform:translateY(2px)}to{opacity:1;transform:none}}',
+      '@media (prefers-reduced-motion:reduce){.nsx-tip{animation:none}}',
       '.nsx-chip{font:inherit;display:inline-flex;align-items:center;gap:7px;max-width:100%;height:28px;padding:0 10px 0 6px;border-radius:7px;border:1px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary);cursor:pointer;box-sizing:border-box}',
       '.nsx-chip:hover:enabled{border-color:var(--dsw-alias-brand-primary)}',
       '.nsx-chip:disabled{opacity:.55;cursor:default}',
@@ -391,6 +396,41 @@ window.__ModuleLoader__.load({
         const [pendingFill, setPendingFill] = React.useState(null)
         const [regenerating, setRegenerating] = React.useState(false)
         const [refreshError, setRefreshError] = React.useState('')
+        // A chip shows a short label, so hover and focus preview the full prompt
+        // in a tooltip the plugin renders itself. The window does not surface a
+        // native `title` hint, so the affordance has to exist in the DOM.
+        const [tip, setTip] = React.useState(null)
+        const tipTimer = React.useRef(null)
+        const hideTip = () => {
+          if (tipTimer.current !== null) {
+            clearTimeout(tipTimer.current)
+            tipTimer.current = null
+          }
+          setTip(null)
+        }
+        const showTip = (index, delay) => {
+          if (tipTimer.current !== null) {
+            clearTimeout(tipTimer.current)
+            tipTimer.current = null
+          }
+          if (delay <= 0) {
+            setTip(index)
+            return
+          }
+          tipTimer.current = setTimeout(() => {
+            tipTimer.current = null
+            setTip(index)
+          }, delay)
+        }
+        React.useEffect(
+          () => () => {
+            if (tipTimer.current !== null) clearTimeout(tipTimer.current)
+          },
+          [],
+        )
+        React.useEffect(() => {
+          hideTip()
+        }, [at, status])
         // A fresh round or any edit to the draft invalidates a pending replace;
         // the regenerate spinner and its error keep their own reset trigger.
         React.useEffect(() => {
@@ -525,11 +565,32 @@ window.__ModuleLoader__.load({
             items.map((item, index) => {
               const prompt = item !== null && typeof item === 'object' && typeof item.prompt === 'string' ? item.prompt : ''
               const label = item !== null && typeof item === 'object' && typeof item.label === 'string' && item.label !== '' ? item.label : prompt
+              const tipId = `nsx-tip-${at}-${index}`
               return h(
-                'button',
-                { key: index, type: 'button', className: 'nsx-chip', title: prompt, onClick: () => fill(prompt) },
-                h('span', { className: 'nsx-chip-n' }, String(index + 1)),
-                h('span', { className: 'nsx-chip-text' }, label),
+                'span',
+                {
+                  key: index,
+                  className: 'nsx-chip-wrap',
+                  onPointerEnter: () => showTip(index, 260),
+                  onPointerLeave: hideTip,
+                },
+                h(
+                  'button',
+                  {
+                    type: 'button',
+                    className: 'nsx-chip',
+                    'aria-describedby': tip === index ? tipId : undefined,
+                    onClick: () => {
+                      hideTip()
+                      fill(prompt)
+                    },
+                    onFocus: () => showTip(index, 0),
+                    onBlur: hideTip,
+                  },
+                  h('span', { className: 'nsx-chip-n' }, String(index + 1)),
+                  h('span', { className: 'nsx-chip-text' }, label),
+                ),
+                tip === index ? h('span', { id: tipId, role: 'tooltip', className: 'nsx-tip' }, prompt) : null,
               )
             }),
           ),

package/cordis.patch.yml

@@ -2,7 +2,7 @@
 # plugin); the `dsh.client` declaration in package.json makes the Web app load
 # ./client.js as the browser half.
 - insert:
-    - id: next-steps
+    - id: dsh-next-steps
       name: '@zongcn/dsh-next-steps'
       config:
         enabled: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zongcn/dsh-next-steps",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Suggests up to three prompts to send next after each finished turn, right above the composer.",
   "keywords": [
     "deepseek-harness",

package/scripts/verify-dock.mjs

@@ -14,6 +14,7 @@
  * Exits non-zero when a check fails.
  */
 import assert from 'node:assert/strict'
+import { readFile } from 'node:fs/promises'
 
 // ---- Minimal React -------------------------------------------------------
 // Only the four hooks the bundle calls, with the same observable rules:
@@ -71,6 +72,14 @@ globalThis.window = {
 await import(new URL('../client.js', import.meta.url).href)
 assert.ok(captured, 'client.js registered a module definition')
 
+// client-modules keys each bundle factory by its boot row id, which is the
+// package name. When the literal differs the loader believes the batch "loaded
+// without registering", refetches the bundle by its own URL, and the second
+// load() throws "duplicate factory registration" — the browser half then never
+// mounts. Keep the literal pinned to package.json.
+const pkg = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'))
+assert.equal(captured.id, pkg.name, 'client.js registers the loader id matching the package name')
+
 const EN = {}
 const seats = {}
 const ctx = {
@@ -212,6 +221,8 @@ async function mount(sessions, draft) {
 
 /** The Host poll runs every 2 s; one round of it settles a scripted change. */
 const nextPoll = () => new Promise((resolve) => setTimeout(resolve, 2200))
+const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms))
+const tooltipNode = () => visible().find((node) => node.props !== undefined && node.props.role === 'tooltip')
 
 // ---- Checks --------------------------------------------------------------
 let passed = 0
@@ -353,6 +364,47 @@ await check('typing during an in-flight regenerate keeps the spinner', async ()
   assert.ok(texts().includes('Regenerating…'), 'success alone does not unlock before the poll')
 })
 
+await check('hovering a suggestion chip shows its full prompt in a tooltip', async () => {
+  await mount(ready(1200), '')
+  assert.equal(tooltipNode(), undefined, 'no tooltip before hovering')
+  const wrap = visible().find((node) => String(node.props.className).includes('nsx-chip-wrap'))
+  assert.ok(wrap, 'each chip is wrapped so its tooltip can be placed above it')
+  wrap.props.onPointerEnter()
+  await flush()
+  await wait(400)
+  await flush()
+  const tip = tooltipNode()
+  assert.ok(tip, 'a tooltip appears on hover: ' + texts())
+  assert.equal(textOf(tip), 'run the tests', 'the tooltip carries the full prompt')
+  wrap.props.onPointerLeave()
+  await flush()
+  assert.equal(tooltipNode(), undefined, 'the tooltip hides when the pointer leaves')
+})
+
+await check('focusing a suggestion chip shows its tooltip without waiting', async () => {
+  await mount(ready(1300), '')
+  const chip = suggestionChips()[0]
+  assert.ok(chip, 'a suggestion chip is rendered')
+  chip.props.onFocus()
+  await flush()
+  const tip = tooltipNode()
+  assert.ok(tip, 'a tooltip appears on keyboard focus')
+  assert.equal(textOf(tip), 'run the tests', 'the tooltip carries the full prompt')
+})
+
+await check('a tooltip does not survive the next round', async () => {
+  await mount(ready(1400), '')
+  visible().find((node) => String(node.props.className).includes('nsx-chip-wrap')).props.onPointerEnter()
+  await flush()
+  await wait(400)
+  await flush()
+  assert.ok(tooltipNode(), 'tooltip visible before the next round')
+  payload = baseValue(ready(1500, [{ label: 'Fresh', prompt: 'fresh prompt' }]))
+  await nextPoll()
+  await flush()
+  assert.equal(tooltipNode(), undefined, 'the old tooltip is gone after the round changes')
+})
+
 dispose()
 
 if (failures.length > 0) {

package/scripts/verify-ui.mjs

@@ -125,9 +125,21 @@ try {
         check('regenerate control is enabled', await regenerate.isEnabled())
       }
       await shot(page, '02-band-light')
-      // A press writes the draft and must not submit it.
-      const firstPrompt = await chips.first().getAttribute('title')
-      await chips.first().click()
+      // Hovering a chip previews the full prompt in the plugin's own tooltip; a
+      // press then writes that prompt as a draft and must not submit it.
+      const firstChip = chips.first()
+      await firstChip.hover()
+      let firstPrompt = null
+      try {
+        const tooltip = band.locator('.nsx-tip')
+        await tooltip.waitFor({ state: 'visible', timeout: 5000 })
+        firstPrompt = (await tooltip.innerText()).trim()
+        check('hovering a chip previews its full prompt', firstPrompt.length > 0, firstPrompt.slice(0, 60))
+        await shot(page, '02b-chip-tooltip')
+      } catch {
+        check('hovering a chip previews its full prompt', false, 'no .nsx-tip appeared on hover')
+      }
+      await firstChip.click()
       await page.waitForTimeout(400)
       const editor = page.locator('[contenteditable="true"]').first()
       let draft = ''