npm - @jaychang1989/dsh-webchat - Versions diffs - 0.3.0 - Mend

@jaychang1989/dsh-webchat 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (45) hide show

package/LICENSE +201 -0
package/NOTICE +18 -0
package/README.md +78 -0
package/README.zh.md +83 -0
package/cordis.patch.yml +22 -0
package/lib/client.js +1725 -0
package/lib/client.js.map +1 -0
package/lib/index.js +3887 -0
package/lib/types/client/api.d.ts +74 -0
package/lib/types/client/controller.d.ts +19 -0
package/lib/types/client/index.d.ts +30 -0
package/lib/types/client/locales.d.ts +169 -0
package/lib/types/client/mount.d.ts +23 -0
package/lib/types/client/panel/Markdown.d.ts +15 -0
package/lib/types/client/panel/WebChatPanel.d.ts +28 -0
package/lib/types/client/sidebar-entry-core.d.ts +60 -0
package/lib/types/client/sidebar-entry.d.ts +22 -0
package/lib/types/engine/engine.d.ts +247 -0
package/lib/types/engine/html-md.d.ts +23 -0
package/lib/types/index.d.ts +63 -0
package/lib/types/protocol.d.ts +107 -0
package/lib/types/routes.d.ts +22 -0
package/lib/types/store.d.ts +69 -0
package/lib/types/tools.d.ts +27 -0
package/lib/types/transfer.d.ts +138 -0
package/package.json +96 -0
package/src/client/api.ts +90 -0
package/src/client/controller.ts +43 -0
package/src/client/css-modules.d.ts +5 -0
package/src/client/index.ts +75 -0
package/src/client/locales.ts +172 -0
package/src/client/mount.tsx +125 -0
package/src/client/panel/Markdown.tsx +251 -0
package/src/client/panel/WebChatPanel.tsx +760 -0
package/src/client/panel/panel.module.css +936 -0
package/src/client/sidebar-entry-core.ts +207 -0
package/src/client/sidebar-entry.ts +49 -0
package/src/engine/engine.ts +1385 -0
package/src/engine/html-md.ts +126 -0
package/src/index.ts +212 -0
package/src/protocol.ts +116 -0
package/src/routes.ts +307 -0
package/src/store.ts +217 -0
package/src/tools.ts +257 -0
package/src/transfer.ts +602 -0

package/src/client/mount.tsx ADDED Viewed

@@ -0,0 +1,125 @@
+/**
+ * Panel view mounting. The conversation slot is single-occupant and external
+ * plugins cannot declare slots, so the panel takes over the center column at
+ * the DOM level (same strategy as dsh-ssh / dsh-task-board): a container is
+ * appended inside the center column as an extra trailing child React never
+ * manages, and a stylesheet rule hides the conversation content while the
+ * panel is active. Toggling is a data attribute on <html> — no React
+ * involvement, so the conversation subtree underneath stays mounted and
+ * stateful.
+ */
+import { createRoot, type Root } from 'react-dom/client'
+import type { ISessions, IWorkspaces } from '@deepseek-ai/dsh-client-runtime/client'
+import type { WebChatApi } from './api.ts'
+import type { PanelController } from './controller.ts'
+import type { WebChatKey } from './locales.ts'
+import { WebChatPanel } from './panel/WebChatPanel.tsx'
+import css from './panel/panel.module.css'
+/** The injected panel container (kept in the DOM, hidden when inactive). */
+export const PANEL_VIEW_SELECTOR = '[data-dsh-webchat-view]'
+const CONVERSATION_COLUMN_SELECTOR = '[data-pane="conversation"], [class*="centerCol"]'
+const ACTIVE_ATTR = 'data-dsh-webchat-active'
+/** The sibling panels' activation attributes, removed when this panel opens. */
+const OTHER_ACTIVE_ATTRS = ['data-dsh-taskboard-active', 'data-dsh-ssh-active']
+/** Cross-plugin activation event; detail is the activating panel name. */
+const ACTIVATE_EVENT = 'dsh-panel-activate'
+const PANEL_NAME = 'webchat'
+/** Find the center column, or undefined while the frame is not mounted. */
+function conversationColumn(): HTMLElement | undefined {
+  return document.querySelector<HTMLElement>(CONVERSATION_COLUMN_SELECTOR) ?? undefined
+}
+export interface MountPanelDeps {
+  sessions: ISessions
+  workspaces: IWorkspaces
+  api: WebChatApi
+  controller: PanelController
+  /** Locale accessor bound to the plugin's registered dictionaries. */
+  tt: (key: WebChatKey) => string
+  /** Resolve the current session's cwd (for transfers / exports). */
+  currentCwd: () => string | undefined
+}
+/**
+ * Mount the panel React tree into the center column and bind its visibility
+ * to the controller's panelOpen state.
+ * @param deps - sessions, api, controller, locale accessor.
+ * @returns disposer unmounting the tree and restoring the column.
+ */
+export function mountPanel(deps: MountPanelDeps): () => void {
+  const { sessions, workspaces, api, controller, tt, currentCwd } = deps
+  let root: Root | undefined
+  let container: HTMLDivElement | undefined
+  const ensure = (): void => {
+    if (container !== undefined) {
+      if (container.isConnected) return
+      // The conversation pane was replaced; drop the stale tree and remount.
+      root?.unmount()
+      root = undefined
+      container.remove()
+      container = undefined
+    }
+    const column = conversationColumn()
+    if (column === undefined) return
+    container = document.createElement('div')
+    container.dataset.dshWebchatView = ''
+    container.dataset.dshPlugin = 'webchat'
+    container.className = css.view
+    column.appendChild(container)
+    root = createRoot(container)
+    root.render(<WebChatPanel api={api} tt={tt} sessions={sessions} workspaces={workspaces} currentCwd={currentCwd} />)
+  }
+  // The frame mounts after boot settlement; watch for the column's arrival.
+  const waitObserver = new MutationObserver(() => { ensure() })
+  waitObserver.observe(document.body, { childList: true, subtree: true })
+  const applyActive = (): void => {
+    if (controller.getSnapshot().panelOpen) {
+      // Single-occupant center column: opening this panel must evict sibling
+      // panels (task board / ssh), both their html attributes and their
+      // controller state, otherwise visibility rules fight.
+      for (const attr of OTHER_ACTIVE_ATTRS) document.documentElement.removeAttribute(attr)
+      document.documentElement.setAttribute(ACTIVE_ATTR, '')
+      document.dispatchEvent(new CustomEvent(ACTIVATE_EVENT, { detail: PANEL_NAME }))
+    } else {
+      document.documentElement.removeAttribute(ACTIVE_ATTR)
+    }
+  }
+  const onOtherActivate = (event: Event): void => {
+    const detail = (event as CustomEvent).detail
+    if ((detail === 'taskboard' || detail === 'ssh') && controller.getSnapshot().panelOpen) {
+      controller.close()
+    }
+  }
+  // Jump out on sidebar context clicks: clicking a session/workspace row
+  // hands the center column back to the conversation. Capture phase.
+  const SIDEBAR_ROW_SELECTOR = '[class*="sessionRow"], [class*="projectRow"], [class*="searchResultRow"], [class*="searchResultWorkspace"], [class*="newSession"]'
+  const onClickSidebarRow = (event: MouseEvent): void => {
+    if (!controller.getSnapshot().panelOpen) return
+    const target = event.target as HTMLElement | null
+    if (target === null) return
+    if (target.closest(SIDEBAR_ROW_SELECTOR) !== null) controller.close()
+  }
+  document.addEventListener('click', onClickSidebarRow, true)
+  document.addEventListener(ACTIVATE_EVENT, onOtherActivate)
+  const unsubscribe = controller.subscribe(applyActive)
+  applyActive()
+  ensure()
+  return () => {
+    document.removeEventListener('click', onClickSidebarRow, true)
+    document.removeEventListener(ACTIVATE_EVENT, onOtherActivate)
+    waitObserver.disconnect()
+    unsubscribe()
+    document.documentElement.removeAttribute(ACTIVE_ATTR)
+    root?.unmount()
+    root = undefined
+    container?.remove()
+    container = undefined
+  }
+}

package/src/client/panel/Markdown.tsx ADDED Viewed

@@ -0,0 +1,251 @@
+/**
+ * Minimal markdown renderer for the web-chat panel. Deliberately small and
+ * dependency-free: headings, paragraphs, bold/italic, inline + fenced code,
+ * links, DeepSeek `[citation:N]` markers (rendered as superscript badges),
+ * unordered/ordered lists, blockquotes, GFM tables, horizontal rules, and
+ * <details> passthrough (used for DeepSeek R1 thinking blocks). Anything
+ * unrecognized renders as plain text — never raw HTML.
+ */
+import { createElement, type ReactNode } from 'react'
+import css from './panel.module.css'
+/** Escape text for safe rendering (no dangerouslySetInnerHTML anywhere). */
+function esc(text: string): string {
+  return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+}
+/**
+ * Inline markdown → React nodes. Single tokenizer pass over the string:
+ * code spans win, then links, then `[citation:…]` markers, then bold, then
+ * italic — each non-token run is escaped text. Bold/italic recurse so a
+ * strong span can contain a citation or link.
+ */
+function inline(text: string, keyBase = 'i'): ReactNode[] {
+  const nodes: ReactNode[] = []
+  // eslint-disable-next-line no-useless-escape
+  const re = /(`[^`]+`)|(\[[^\]]+\]\([^)\s]+\))|(\[citation:[^\]]+\])|(\*\*[^*]+\*\*|__[^_]+__)|(\*[^*\n]+\*|_[^_\n]+_)/g
+  let last = 0
+  let index = 0
+  let match: RegExpExecArray | null
+  while ((match = re.exec(text)) !== null) {
+    if (match.index > last) nodes.push(esc(text.slice(last, match.index)))
+    const key = `${keyBase}-${index}`
+    if (match[1] !== undefined) {
+      // `code`
+      nodes.push(createElement('code', { key: `${key}-code` }, match[1].slice(1, -1)))
+    } else if (match[2] !== undefined) {
+      // [label](url)
+      const link = /^\[([^\]]+)\]\(([^)\s]+)\)$/.exec(match[2])
+      nodes.push(createElement('a', { key: `${key}-a`, href: link![2], target: '_blank', rel: 'noreferrer' }, link![1]))
+    } else if (match[3] !== undefined) {
+      // [citation:N] / [citation:N1,N2] — DeepSeek web search markers.
+      const nums = match[3].slice('[citation:'.length, -1).trim()
+      nodes.push(createElement('sup', { key: `${key}-cite`, className: css.citation }, nums))
+    } else if (match[4] !== undefined) {
+      // **bold** / __bold__
+      const inner = match[4].slice(2, -2)
+      nodes.push(createElement('strong', { key: `${key}-b` }, ...inline(inner, `${key}-b`)))
+    } else if (match[5] !== undefined) {
+      // *italic* / _italic_
+      const inner = match[5].slice(1, -1)
+      nodes.push(createElement('em', { key: `${key}-i` }, ...inline(inner, `${key}-i`)))
+    }
+    last = re.lastIndex
+    index++
+  }
+  if (last < text.length) nodes.push(esc(text.slice(last)))
+  return nodes
+}
+/** One fenced code block → <pre><code>. */
+function codeBlock(language: string, body: string, key: string): ReactNode {
+  return createElement(
+    'pre',
+    { key },
+    createElement('code', { className: language === '' ? undefined : `language-${language}` }, body),
+  )
+}
+/** Split a table row into cells, honoring escaped pipes (\|). */
+function splitCells(line: string): string[] {
+  const cells: string[] = []
+  let current = ''
+  let escaped = false
+  for (const ch of line) {
+    if (escaped) { current += ch; escaped = false }
+    else if (ch === '\\') { escaped = true }
+    else if (ch === '|') { cells.push(current); current = '' }
+    else { current += ch }
+  }
+  cells.push(current)
+  // Drop the leading/trailing empty artifacts produced by a leading/trailing
+  // pipe, so `| a | b |` and `a | b` both yield ['a','b'].
+  let start = 0
+  let end = cells.length
+  while (start < end && cells[start].trim() === '') start++
+  while (end > start && cells[end - 1].trim() === '') end--
+  return cells.slice(start, end).map(cell => cell.trim())
+}
+/** True when a line is a GFM table delimiter row (`:---`, `---:`, `:---:`, …). */
+function isDelimiterRow(line: string): boolean {
+  const cells = splitCells(line)
+  return cells.length > 0 && cells.every(cell => /^:?-{3,}:?$/.test(cell))
+}
+/** Render one block of markdown text into React nodes. */
+export function renderMarkdown(source: string): ReactNode[] {
+  const raw = source.replace(/\r\n/g, '\n').trim()
+  if (raw === '') return []
+  const blocks: ReactNode[] = []
+  const lines = raw.split('\n')
+  let index = 0
+  let blockIndex = 0
+  const push = (node: ReactNode): void => {
+    blocks.push(createElement('div', { key: `b${blockIndex++}` }, node))
+  }
+  while (index < lines.length) {
+    const line = lines[index]
+    const trimmed = line.trim()
+    // fenced code
+    const fence = /^```([\w+-]*)\s*$/.exec(trimmed)
+    if (fence !== null) {
+      const language = fence[1] ?? ''
+      const body: string[] = []
+      index++
+      while (index < lines.length && !/^```\s*$/.test(lines[index].trim())) {
+        body.push(lines[index])
+        index++
+      }
+      index++ // closing fence
+      push(codeBlock(language, body.join('\n'), `code${blockIndex}`))
+      continue
+    }
+    // headings
+    const heading = /^(#{1,6})\s+(.*)$/.exec(trimmed)
+    if (heading !== null) {
+      const level = heading[1].length
+      push(createElement(`h${level}` as 'h1', null, ...inline(heading[2], `h${blockIndex}`)))
+      index++
+      continue
+    }
+    // GFM table (header row containing '|' immediately followed by a delimiter
+    // row). Checked before the horizontal-rule branch so a delimiter like
+    // `--- | ---` is never mistaken for an hr.
+    if (line.includes('|') && lines[index + 1] !== undefined && isDelimiterRow(lines[index + 1])) {
+      const header = splitCells(line)
+      index += 2
+      const rows: string[][] = []
+      while (index < lines.length) {
+        const row = lines[index]
+        if (row.trim() === '' || !row.includes('|')) break
+        rows.push(splitCells(row))
+        index++
+      }
+      const width = Math.max(header.length, ...rows.map(row => row.length))
+      const rowNode = (cells: string[], rowIndex: number): ReactNode =>
+        createElement('tr', { key: rowIndex }, Array.from({ length: width }, (_, col) =>
+          createElement('td', { key: col }, ...inline(cells[col] ?? '', `t${blockIndex}-${rowIndex}-${col}`))))
+      blocks.push(createElement(
+        'div',
+        { key: `tw${blockIndex}`, className: css.tableWrap },
+        createElement('table', { key: `t${blockIndex}` },
+          createElement('thead', null, createElement('tr', null, header.map((cell, col) =>
+            createElement('th', { key: col }, ...inline(cell, `th${blockIndex}-${col}`))))),
+          createElement('tbody', null, rows.map(rowNode))),
+      ))
+      blockIndex++
+      continue
+    }
+    // horizontal rule
+    if (/^(-{3,}|\*{3,}|_{3,})$/.test(trimmed)) {
+      push(createElement('hr', { key: `hr${blockIndex}` }))
+      index++
+      continue
+    }
+    // blockquote (collect consecutive quote lines)
+    if (trimmed.startsWith('>')) {
+      const quote: string[] = []
+      while (index < lines.length && lines[index].trim().startsWith('>')) {
+        quote.push(lines[index].trim().replace(/^>\s?/, ''))
+        index++
+      }
+      push(createElement('blockquote', { key: `q${blockIndex}` }, ...renderMarkdown(quote.join('\n'))))
+      continue
+    }
+    // details (DeepSeek R1 thinking)
+    if (/^<details>/.test(trimmed)) {
+      const body: string[] = []
+      const summaryMatch = /^<summary>\s*(.*?)\s*<\/summary>/.exec(trimmed)
+      index++
+      while (index < lines.length && !/^<\/details>/.test(lines[index].trim())) {
+        body.push(lines[index])
+        index++
+      }
+      index++ // </details>
+      push(createElement(
+        'details',
+        { key: `d${blockIndex}` },
+        createElement('summary', null, summaryMatch?.[1] ?? '详情'),
+        ...renderMarkdown(body.join('\n')),
+      ))
+      continue
+    }
+    // unordered list
+    if (/^[-*+]\s+/.test(trimmed)) {
+      const items: string[] = []
+      while (index < lines.length && /^[-*+]\s+/.test(lines[index].trim())) {
+        items.push(lines[index].trim().replace(/^[-*+]\s+/, ''))
+        index++
+      }
+      push(createElement('ul', { key: `ul${blockIndex}` }, items.map((item, itemIndex) =>
+        createElement('li', { key: itemIndex }, ...inline(item, `uli${blockIndex}-${itemIndex}`)))))
+      continue
+    }
+    // ordered list
+    if (/^\d+[.)]\s+/.test(trimmed)) {
+      const items: string[] = []
+      while (index < lines.length && /^\d+[.)]\s+/.test(lines[index].trim())) {
+        items.push(lines[index].trim().replace(/^\d+[.)]\s+/, ''))
+        index++
+      }
+      push(createElement('ol', { key: `ol${blockIndex}` }, items.map((item, itemIndex) =>
+        createElement('li', { key: itemIndex }, ...inline(item, `oli${blockIndex}-${itemIndex}`)))))
+      continue
+    }
+    // plain paragraph: collect consecutive non-empty, non-special lines
+    const paragraph: string[] = []
+    while (index < lines.length) {
+      const current = lines[index].trim()
+      if (current === '') break
+      if (/^(```|#{1,6}\s|[-*+]\s|\d+[.)]\s|>\s|<\/(details|table)>)/.test(current)) break
+      if (current.includes('|') && lines[index + 1] !== undefined && isDelimiterRow(lines[index + 1])) break
+      paragraph.push(current)
+      index++
+    }
+    if (paragraph.length === 0) {
+      index++
+      continue
+    }
+    push(createElement('p', { key: `p${blockIndex}` }, ...inline(paragraph.join(' '), `p${blockIndex}`)))
+  }
+  return blocks
+}
+/** The markdown renderer component. */
+export function Markdown({ source }: { source: string }): ReactNode {
+  return createElement('div', { className: css.markdown }, ...renderMarkdown(source))
+}