@rs-dsh/dsh-core 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 0.1.1
+
+- **Chinese wording** reviewed: messages follow DSH's own terms (指令 for commands) and end with 。.
+- **Triple-click selections** now get the Comment button. A triple-click on a message's last paragraph runs on to the start of the next message, so the selection belonged to no message; it is now trimmed to the text it covers.
+- **Cards focus their text field** when they open, so you can type a comment or a quote note right away.
+- **The selected passage stays highlighted** while its comment or quote card is open, though focusing the field clears the page selection.
+
+## 0.1.0
+
+The first release. dsh-threads 0.2.0 and dsh-quote 0.2.0 are built on it.
+
+- **One selection toolbar** for every rs-dsh plugin's actions. A button shows only where its action applies.
+- **Cards drawn with DSH's own components** (`MenuSurface`, `Button`, `InlineEditor`, `MarkdownText`, `TextShimmer`), closing on **Esc** or a click outside, one at a time.
+- **A namespace per plugin** and a repository-wide test that keeps their styles apart.
+- **Requires** DSH 0.2.1-rc.2 or later with the web GUI.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Romany Saad
+
+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,36 @@
-# Temporary Holding Version
+# @rs-dsh/dsh-core
 
-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.
+The shared base of the rs-dsh plugins for DeepSeek Harness. It gives them one selection toolbar, so their buttons share one box, and draws their boxes with DSH's own components. You don't install it yourself: [dsh-threads](https://github.com/romany-saad/dsh-plugins/tree/main/packages/dsh-threads) and [dsh-quote](https://github.com/romany-saad/dsh-plugins/tree/main/packages/dsh-quote) bring it with them.
+
+![Quote and Comment side by side in one toolbar above a selected sentence](https://raw.githubusercontent.com/romany-saad/dsh-plugins/main/packages/dsh-core/docs/images/one-toolbar.png)
+
+## Install
+
+Install the plugins you want. Each one brings this package and adds it to the profile:
+
+```sh
+dsh plugin --profile <name> add @rs-dsh/dsh-threads@0.3.0 @rs-dsh/dsh-quote@0.2.1
+```
+
+Then reload the DSH web page. However many rs-dsh plugins you install, the core runs once.
+
+## Requirements
+
+- DSH 0.2.1-rc.2 or later. It is tested with 0.2.1-rc.2.
+- A profile with the web GUI (`@deepseek-ai/dsh-web-app`), such as `web`.
+
+## What you see
+
+- **One selection toolbar.** Select text in a conversation and the actions of every installed rs-dsh plugin show in one box, such as **Quote** and **Comment**. An action only shows where it applies: for example, there's no **Comment** on tool output.
+- **Boxes that look like DSH.** Buttons, text boxes, menus and replies are DSH's own components, so they follow DSH's theme and its updates. A box closes with **Esc** or a click outside it, and only one is open at a time.
+
+## Limits
+
+- **Web GUI only.**
+- **Needs DSH's UI library.** The core uses `@deepseek-ai/dsh-client-ui-primitives`, which DSH's web app ships. If a DSH release drops it or renames a part the core uses, the rs-dsh plugins stop at start with a message saying so, until they're updated.
+
+## More
+
+- [CHANGELOG.md](https://github.com/romany-saad/dsh-plugins/blob/main/packages/dsh-core/CHANGELOG.md)
+- [MIT License](https://github.com/romany-saad/dsh-plugins/blob/main/packages/dsh-core/LICENSE)
+- For maintainers, and for writing a plugin on the core: [DEVELOPING.md](https://github.com/romany-saad/dsh-plugins/blob/main/packages/dsh-core/DEVELOPING.md)

package/client.js

@@ -0,0 +1,566 @@
+// @rs-dsh/dsh-core: browser half (hand-written, no build step).
+//
+// The shared UI layer for rs-dsh plugins, built on DSH's own UI library
+// (@deepseek-ai/dsh-client-ui-primitives) so the plugins look like DSH and
+// follow its updates. It provides one service, `rsDshCore`:
+//
+//   ui                     the DSH components and icons the plugins use
+//   selection.register()   a button in the one selection toolbar
+//   popover.open()         an anchored card (React) with outside-click and Escape
+//   style(plugin, css)     one stylesheet per plugin, scoped by convention
+//   scope(plugin)          the root attribute a plugin's elements carry
+//   selectionContext()     what the current selection is over
+//
+// The library is assumed present: DSH's web shell ships it in its shared
+// module table. If it is ever missing, the core fails loudly at start with
+// one message instead of drawing look-alikes (see README "Limits").
+window.__ModuleLoader__.load({
+  id: '@rs-dsh/dsh-core',
+  factory: (require) => {
+    'use strict'
+    const module = { exports: {} }
+
+    const NS = 'dsh-core'
+    const ROOT = 'data-rs-dsh'
+    const PRIMITIVES = '@deepseek-ai/dsh-client-ui-primitives'
+
+    // The components and icons the rs-dsh plugins use. A test checks every
+    // name against the real library at the pinned DSH version.
+    const UI_EXPORTS = [
+      'Button', 'MenuSurface', 'InlineEditor', 'TextShimmer', 'MarkdownText', 'Tooltip', 'Toast',
+      'IconTrashOutlineRegular', 'IconSendOutlineRegular', 'IconCopyOutlineRegular', 'IconCloseOutlineRegular',
+      'IconNewChatOutlineRegular', 'IconEditOutlineRegular', 'IconCheckOutlineRegular', 'IconRefreshOutlineRegular',
+      'IconWarningOutlineRegular', 'IconChevronDownOutlineRegular', 'IconChevronUpOutlineRegular',
+    ]
+
+    // ------------------------------------------------------------ pure logic
+
+    /** The library's exports the plugins use; throws one clear error if any is gone. */
+    function pickUi(lib) {
+      if (lib === null || typeof lib !== 'object') {
+        throw new Error(`dsh-core: ${PRIMITIVES} is not available in this DSH build; the rs-dsh plugins need it`)
+      }
+      const missing = UI_EXPORTS.filter((name) => lib[name] === undefined)
+      if (missing.length > 0) {
+        throw new Error(`dsh-core: this DSH build's ${PRIMITIVES} lacks ${missing.join(', ')}; update the rs-dsh plugins`)
+      }
+      const ui = {}
+      for (const name of UI_EXPORTS) ui[name] = lib[name]
+      return ui
+    }
+
+    /** A plugin name usable in an attribute value and a CSS selector. */
+    function checkPlugin(plugin) {
+      if (typeof plugin !== 'string' || !/^[a-z][a-z0-9-]*$/.test(plugin)) {
+        throw new Error('dsh-core: plugin names are lowercase letters, digits and dashes: ' + JSON.stringify(plugin))
+      }
+      return plugin
+    }
+
+    /**
+     * Where to put a floating card of `size` next to `rect`, inside the
+     * viewport: above when it fits there (`prefer: 'above'`), else below.
+     */
+    function placeNear(rect, size, viewport, { prefer = 'below', gap = 8, align = 'start' } = {}) {
+      const margin = 8
+      const fitsBelow = rect.bottom + gap + size.height <= viewport.height - margin
+      const fitsAbove = rect.top - gap - size.height >= margin
+      const above = prefer === 'above' ? fitsAbove || !fitsBelow : !fitsBelow && fitsAbove
+      let top = above ? rect.top - gap - size.height : rect.bottom + gap
+      top = Math.max(margin, Math.min(top, viewport.height - size.height - margin))
+      let left = align === 'center' ? rect.left + rect.width / 2 - size.width / 2 : rect.left
+      left = Math.max(margin, Math.min(left, viewport.width - size.width - margin))
+      return { top: Math.round(top), left: Math.round(left), above }
+    }
+
+    /** Collapse whitespace and cut to n code points with an ellipsis; never forges editor placeholders. */
+    function oneLine(s, n) {
+      const flat = String(s).replace(/[\uE100-\uE11D\uFFFC]/gu, '').replace(/\s+/g, ' ').trim()
+      const chars = Array.from(flat)
+      return chars.length <= n ? flat : chars.slice(0, n - 1).join('') + '\u2026'
+    }
+
+    /**
+     * Insert one chip into a draft snapshot, after the chips already stacked
+     * at the top whose source is in `stackAfter` (by default its own), each on
+     * its own line, so chips keep the order they were added in. Other chips
+     * shift; text is kept. Returns the next snapshot (the shape DSH persists).
+     */
+    function stackChip(snapshot, insert, stackAfter = [insert.source]) {
+      const text = snapshot.text
+      const refs = snapshot.references.slice().sort((a, b) => a.offset - b.offset)
+      let at = 0
+      for (;;) {
+        const head = refs.find((r) => r.offset === at && stackAfter.includes(r.source))
+        if (head === undefined) break
+        at = head.offset + head.length
+        if (text.charAt(at) === '\n') at += 1
+        else break
+      }
+      const lead = at > 0 && text.charAt(at - 1) !== '\n' ? '\n' : ''
+      const added = lead + insert.clipboardText + '\n'
+      const offset = at + lead.length
+      const shifted = refs.map((r) => (r.offset >= at ? { ...r, offset: r.offset + added.length } : r))
+      const chip = {
+        source: insert.source,
+        ref: insert.ref,
+        offset,
+        length: insert.clipboardText.length,
+        label: insert.label,
+        clipboardText: insert.clipboardText,
+      }
+      const references = shifted.concat([chip]).sort((a, b) => a.offset - b.offset)
+      const next = { text: text.slice(0, at) + added + text.slice(at), references }
+      if (snapshot.command !== undefined) next.command = snapshot.command
+      return next
+    }
+
+    /** Toolbar buttons in order: by `order`, then by registration. */
+    function sortButtons(buttons) {
+      return buttons.slice().sort((a, b) => a.order - b.order || a.seq - b.seq)
+    }
+
+    /** Normalize a raw DOM selection string. */
+    function cleanSelection(raw) {
+      return String(raw).replace(/\r\n?/g, '\n').replace(/[ \t]+\n/g, '\n').replace(/\n{3,}/g, '\n\n').trim()
+    }
+
+    /** Whether a pointer or key event happened inside `el`, across portals that keep a DOM path. */
+    function eventInside(event, el) {
+      if (el === null || el === undefined) return false
+      const path = typeof event.composedPath === 'function' ? event.composedPath() : []
+      if (path.includes(el)) return true
+      return event.target instanceof Node && el.contains(event.target)
+    }
+
+    // ------------------------------------------------------------ strings
+
+    const en = {
+      actions: 'Selection actions',
+      busy: 'The composer is busy; try again in a moment',
+      command: 'This cannot go into a command draft',
+      noSession: 'No composer found for this conversation',
+    }
+    const zh = {
+      actions: '选中文本操作',
+      busy: '输入框暂时无法编辑，请稍后再试。',
+      command: '输入指令时无法插入内容。',
+      noSession: '找不到该会话的输入框。',
+    }
+
+    // The only stylesheet the core owns: positioning of its two floating hosts.
+    // Everything visible inside them is DSH's own components and tokens. The
+    // toolbar keeps the menu's translucent material; text-heavy cards take the
+    // solid layer of DSH's preview cards, so the page never shows through.
+    // The passage a toolbar action was taken on, painted while its card is open.
+    const HELD = 'dsh-core-held'
+    const STYLE = `
+[${ROOT}="dsh-core"][data-part]{position:fixed;z-index:1200;max-width:calc(100vw - 16px)}
+[${ROOT}="dsh-core"][data-part][hidden]{display:none}
+[${ROOT}="dsh-core"] [data-part-card]{box-sizing:border-box;padding:4px;--dsw-elevation-stroke-color:var(--dsw-alias-border-l1);
+  box-shadow:var(--dsw-elevation-prominent);color:var(--dsw-alias-label-primary);
+  --dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2)}
+[${ROOT}="dsh-core"][data-part="toolbar"] [data-part-card]{display:flex;gap:2px}
+[${ROOT}="dsh-core"][data-part="popover"] [data-part-card]{padding:10px;display:flex;flex-direction:column;max-height:min(70vh,560px);
+  background:var(--dsw-alias-bg-layer-1);box-shadow:var(--dsw-elevation-panel)}
+[${ROOT}="dsh-core"][data-part="popover"] [data-part-card]>[aria-hidden="true"]:first-child{display:none}
+::highlight(${HELD}){background-color:Highlight;color:HighlightText}
+`
+    // ------------------------------------------------------------ plugin body
+
+    function apply(ctx) {
+      const React = require('react')
+      const { jsx, jsxs } = require('react/jsx-runtime')
+      const { createRoot } = require('react-dom/client')
+      let lib
+      try { lib = require(PRIMITIVES) } catch (_) { lib = null }
+      const ui = pickUi(lib)
+
+      ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'dsh-core: dictionaries')
+      const t = ctx.locale.bind(NS)
+
+      // -------------------------------------------------- styles
+
+      const sheets = new Map() // plugin → <style>
+      /** One stylesheet per plugin; returns a disposer. A second call replaces the text. */
+      function style(plugin, css) {
+        checkPlugin(plugin)
+        let el = sheets.get(plugin)
+        if (el === undefined) {
+          el = document.createElement('style')
+          el.setAttribute('data-rs-dsh-style', plugin)
+          document.head.appendChild(el)
+          sheets.set(plugin, el)
+        }
+        el.textContent = css
+        return () => {
+          if (sheets.get(plugin) === el) { el.remove(); sheets.delete(plugin) }
+        }
+      }
+      const scope = (plugin) => ({ [ROOT]: checkPlugin(plugin) })
+      const selector = (plugin) => `[${ROOT}="${checkPlugin(plugin)}"]`
+
+      // -------------------------------------------------- composer
+
+      /** A session's composer when it can take a chip, or { error } in the user's language. */
+      function editableInput(sessionId) {
+        if (ctx.sessions === undefined || ctx.conversation === undefined) return { error: t('noSession') }
+        const actx = ctx.sessions.scope(sessionId)
+        if (actx === undefined) return { error: t('noSession') }
+        const input = ctx.conversation.input.for(actx)
+        const phase = input.state.getSnapshot().phase
+        if (phase === 'claimed') return { error: t('command') }
+        if (phase !== 'plain') return { error: t('busy') }
+        return { actx, input }
+      }
+
+      // Chip sources of the rs-dsh plugins; a new chip stacks after all of them.
+      const chipSources = new Set()
+      /** Declare a chip source as an rs-dsh one; returns a disposer. */
+      function claimChipSource(source) {
+        chipSources.add(source)
+        return () => chipSources.delete(source)
+      }
+
+      /** Stack a chip at the top of a session's draft. Returns null, or the reason it could not. */
+      function insertChip(sessionId, insert) {
+        const { actx, input, error } = editableInput(sessionId)
+        if (error !== undefined) return error
+        const snapshot = input.draftSnapshot
+        if (snapshot !== undefined && snapshot !== null && Array.isArray(snapshot.references)) {
+          if (snapshot.command !== undefined) return t('command')
+          input.setDraft(stackChip(snapshot, insert, [...chipSources, insert.source]))
+        } else {
+          const span = input.actions.captureInsertion()
+          if (actx.bail(actx, 'slash/input-insert-reference', { reference: insert, span }) !== true) return t('busy')
+        }
+        input.focus()
+        return null
+      }
+
+      /** Show a notice under a session's composer. */
+      function notify(sessionId, text, level = 'error') {
+        const actx = ctx.sessions?.scope(sessionId)
+        if (actx !== undefined) ctx.conversation.input.for(actx).notify(level, text)
+      }
+
+      // -------------------------------------------------- selection context
+
+      /**
+       * What the current selection is over, or null: the conversation it is
+       * in, the chat row, the range and its rectangle, and the cleaned text.
+       * Selections in the composer, in inputs or in rs-dsh's own UI are none.
+       */
+      /**
+       * The range shrunk to the text it actually covers. A triple-click on
+       * the last paragraph of a message ends the range at offset 0 of the
+       * next message, so its common ancestor would be the whole chat and the
+       * selection would belong to no row.
+       */
+      function trimRange(range) {
+        const root = range.commonAncestorContainer
+        if (root.nodeType === 3 || typeof document.createTreeWalker !== 'function') return range
+        const walker = document.createTreeWalker(root, 4 /* NodeFilter.SHOW_TEXT */)
+        let first = null, last = null
+        for (let n = walker.nextNode(); n !== null; n = walker.nextNode()) {
+          if (!range.intersectsNode(n)) continue
+          const start = n === range.startContainer ? range.startOffset : 0
+          const end = n === range.endContainer ? range.endOffset : n.data.length
+          if (start >= end || n.data.slice(start, end).trim() === '') continue
+          if (first === null) first = { n, start }
+          last = { n, end }
+        }
+        if (first === null) return range
+        const trimmed = range.cloneRange()
+        trimmed.setStart(first.n, first.start)
+        trimmed.setEnd(last.n, last.end)
+        return trimmed
+      }
+
+      function selectionContext() {
+        const sel = window.getSelection()
+        if (sel === null || sel.isCollapsed || sel.rangeCount === 0) return null
+        const range = trimRange(sel.getRangeAt(0))
+        const node = range.commonAncestorContainer
+        const el = node instanceof Element ? node : node.parentElement
+        if (el === null) return null
+        const region = el.closest('[data-conversation-region="chat"][data-conversation-session]')
+        if (region === null) return null
+        if (el.closest(`[data-composer-card],[${ROOT}],input,textarea,[contenteditable="true"]`) !== null) return null
+        const text = cleanSelection(sel.toString())
+        if (text === '') return null
+        const rect = range.getBoundingClientRect()
+        if (rect.width === 0 && rect.height === 0) return null
+        return {
+          sessionId: region.getAttribute('data-conversation-session'),
+          region,
+          element: el,
+          row: el.closest('[data-chat-node-key]'),
+          range: range.cloneRange(),
+          rect,
+          text,
+        }
+      }
+
+      // -------------------------------------------------- popover host
+
+      // One anchored card at a time, rendered with React into a host of its
+      // own on <body>. Opening another closes the current one.
+      let current = null // { host, root, onClose, anchor }
+
+      function closePopover(reason = 'api') {
+        const open = current
+        if (open === null) return
+        current = null
+        if (open.held) releaseSelection()
+        // Close is often called from inside the card's own React event (Enter
+        // in an editor, a button). Detach now; unmount once React has finished
+        // that event, never during it.
+        open.host.remove()
+        setTimeout(() => open.root.unmount(), 0)
+        try { open.onClose?.(reason) } catch (error) { console.error(error) }
+      }
+
+      /**
+       * Open a card next to `anchor` (a DOMRect or () => DOMRect).
+       * `render(close)` returns the React content. Returns { close, update }.
+       */
+      function openPopover({ plugin, anchor, render, width = 360, prefer = 'below', align = 'start', onClose, label }) {
+        checkPlugin(plugin)
+        closePopover('replaced')
+        hideToolbar()
+        const host = document.createElement('div')
+        host.setAttribute(ROOT, 'dsh-core')
+        host.setAttribute('data-part', 'popover')
+        host.setAttribute('data-plugin', plugin)
+        host.setAttribute('role', 'dialog')
+        if (label) host.setAttribute('aria-label', label)
+        host.style.width = width + 'px'
+        host.style.visibility = 'hidden'
+        document.body.appendChild(host)
+        const root = createRoot(host)
+        const entry = { host, root, onClose, anchor, prefer, align }
+        current = entry
+        const close = (reason = 'api') => { if (current === entry) closePopover(reason) }
+        const place = () => {
+          if (current !== entry) return
+          const rect = typeof entry.anchor === 'function' ? entry.anchor() : entry.anchor
+          if (!rect) return
+          const box = host.getBoundingClientRect()
+          const at = placeNear(rect, { width: box.width || width, height: box.height || 200 }, { width: window.innerWidth, height: window.innerHeight }, { prefer: entry.prefer, align: entry.align })
+          host.style.left = at.left + 'px'
+          host.style.top = at.top + 'px'
+          host.style.visibility = ''
+          // The card mounts hidden until placed, so a field's autoFocus fires
+          // while it cannot take focus. Focus its first field once it shows.
+          if (!entry.focused) {
+            entry.focused = true
+            if (!host.contains(document.activeElement)) {
+              const field = host.querySelector('textarea,input:not([type="hidden"]),[contenteditable="true"]')
+              if (field !== null) {
+                field.focus({ preventScroll: true })
+                if (typeof field.setSelectionRange === 'function') field.setSelectionRange(field.value.length, field.value.length)
+              }
+            }
+          }
+        }
+        const draw = () => {
+          root.render(jsx(ui.MenuSurface, { 'data-part-card': '', children: jsx(PopoverBody, { render, close, place }) }))
+        }
+        draw()
+        return { close, update: draw, place }
+      }
+
+      /** Re-places the card after each render, so it follows its content's size. */
+      function PopoverBody({ render, close, place }) {
+        React.useLayoutEffect(() => { place() })
+        return render(close)
+      }
+
+      // -------------------------------------------------- held selection
+      //
+      // Focusing the card's field takes the page selection away. So when a
+      // toolbar action opens a card, the passage stays painted with a CSS
+      // highlight, in the selection's colours, until the card closes.
+
+      const canHold = typeof Highlight === 'function' && window.CSS !== undefined && window.CSS.highlights !== undefined
+
+      function holdSelection(range) {
+        if (!canHold || !range) return false
+        window.CSS.highlights.set(HELD, new Highlight(range))
+        return true
+      }
+
+      function releaseSelection() {
+        if (canHold) window.CSS.highlights.delete(HELD)
+      }
+
+      // -------------------------------------------------- selection toolbar
+
+      const buttons = [] // { id, plugin, label, icon, order, seq, when, onSelect }
+      let seq = 0
+      let pending = null // selectionContext() the toolbar shows for
+      const toolbar = document.createElement('div')
+      toolbar.setAttribute(ROOT, 'dsh-core')
+      toolbar.setAttribute('data-part', 'toolbar')
+      toolbar.setAttribute('role', 'toolbar')
+      toolbar.hidden = true
+      const toolbarRoot = createRoot(toolbar)
+
+      /**
+       * Add a button to the selection toolbar.
+       * @param spec.id        unique within the plugin
+       * @param spec.label     text on the button
+       * @param spec.onSelect  (selection) => void, with selectionContext()'s value
+       * @param spec.when      optional (selection) => boolean; hidden when false
+       * @param spec.icon      optional React node
+       * @param spec.order     optional number, lower first (default 100)
+       * @returns a disposer
+       */
+      function registerButton(spec) {
+        const plugin = checkPlugin(spec.plugin)
+        if (typeof spec.id !== 'string' || spec.id === '' || typeof spec.onSelect !== 'function') {
+          throw new Error('dsh-core: a selection button needs plugin, id, label and onSelect')
+        }
+        if (buttons.some((b) => b.plugin === plugin && b.id === spec.id)) throw new Error(`dsh-core: ${plugin}/${spec.id} is already registered`)
+        const entry = { order: 100, ...spec, plugin, seq: seq++ }
+        buttons.push(entry)
+        if (pending !== null) showToolbar(pending)
+        return () => {
+          const at = buttons.indexOf(entry)
+          if (at !== -1) buttons.splice(at, 1)
+          if (pending !== null) showToolbar(pending)
+        }
+      }
+
+      function visibleButtons(target) {
+        return sortButtons(buttons).filter((b) => {
+          if (typeof b.when !== 'function') return true
+          try { return b.when(target) === true } catch (error) { console.error(error); return false }
+        })
+      }
+
+      function Toolbar({ target, items }) {
+        return jsx(React.Fragment, {
+          children: items.map((b) => jsx(ui.Button, {
+            variant: 'ghost',
+            size: 'sm',
+            icon: b.icon,
+            'data-plugin': b.plugin,
+            'data-action': b.id,
+            onMouseDown: (e) => e.preventDefault(),
+            onClick: () => {
+              hideToolbar()
+              const before = current
+              try { b.onSelect(target) } catch (error) { console.error(error) }
+              // The action opened a card: keep its passage painted while it is open.
+              if (current !== null && current !== before) current.held = holdSelection(target.range)
+            },
+            children: typeof b.label === 'function' ? b.label() : b.label,
+          }, b.plugin + '/' + b.id)),
+        })
+      }
+
+      function showToolbar(target) {
+        const items = visibleButtons(target)
+        if (items.length === 0) { hideToolbar(); return }
+        pending = target
+        toolbar.setAttribute('aria-label', t('actions'))
+        toolbarRoot.render(jsx(ui.MenuSurface, { compact: true, 'data-part-card': '', children: jsx(Toolbar, { target, items }) }))
+        toolbar.hidden = false
+        requestAnimationFrame(() => {
+          if (pending !== target) return
+          const box = toolbar.getBoundingClientRect()
+          const at = placeNear(target.rect, { width: box.width || 120, height: box.height || 36 }, { width: window.innerWidth, height: window.innerHeight }, { prefer: 'above', align: 'center' })
+          toolbar.style.left = at.left + 'px'
+          toolbar.style.top = at.top + 'px'
+        })
+      }
+
+      function hideToolbar() {
+        toolbar.hidden = true
+        pending = null
+      }
+
+      function refresh() {
+        if (current !== null) { hideToolbar(); return }
+        const target = selectionContext()
+        if (target === null) { hideToolbar(); return }
+        showToolbar(target)
+      }
+
+      let timer = null
+      const onSelectionChange = () => {
+        if (timer !== null) clearTimeout(timer)
+        timer = setTimeout(() => { timer = null; refresh() }, 120)
+      }
+      const onPointerDown = (e) => {
+        if (current !== null && !eventInside(e, current.host)) closePopover('outside')
+      }
+      const onKeyDown = (e) => {
+        if (e.key !== 'Escape') return
+        if (current !== null) { e.stopPropagation(); closePopover('escape'); return }
+        if (!toolbar.hidden) hideToolbar()
+      }
+      const onScroll = (e) => {
+        if (!toolbar.hidden) hideToolbar()
+        if (current !== null && !eventInside(e, current.host)) {
+          const rect = typeof current.anchor === 'function' ? current.anchor() : null
+          if (rect) {
+            const box = current.host.getBoundingClientRect()
+            const at = placeNear(rect, { width: box.width, height: box.height }, { width: window.innerWidth, height: window.innerHeight }, { prefer: current.prefer, align: current.align })
+            current.host.style.left = at.left + 'px'
+            current.host.style.top = at.top + 'px'
+          }
+        }
+      }
+
+      ctx.effect(() => {
+        const disposeStyle = style('dsh-core', STYLE)
+        document.body.appendChild(toolbar)
+        document.addEventListener('selectionchange', onSelectionChange)
+        document.addEventListener('pointerdown', onPointerDown, true)
+        document.addEventListener('keydown', onKeyDown, true)
+        window.addEventListener('scroll', onScroll, true)
+        window.addEventListener('resize', onScroll)
+        return () => {
+          if (timer !== null) clearTimeout(timer)
+          document.removeEventListener('selectionchange', onSelectionChange)
+          document.removeEventListener('pointerdown', onPointerDown, true)
+          document.removeEventListener('keydown', onKeyDown, true)
+          window.removeEventListener('scroll', onScroll, true)
+          window.removeEventListener('resize', onScroll)
+          closePopover('dispose')
+          toolbarRoot.unmount()
+          toolbar.remove()
+          disposeStyle()
+        }
+      }, 'dsh-core: selection toolbar and popover host')
+
+      const api = {
+        version: 1,
+        ui,
+        React,
+        jsx,
+        jsxs,
+        style,
+        scope,
+        selector,
+        selectionContext,
+        oneLine,
+        stackChip,
+        composer: { editable: editableInput, insertChip, notify, claimChipSource },
+        selection: { register: registerButton, hide: hideToolbar },
+        popover: { open: openPopover, close: () => closePopover('api'), isOpen: () => current !== null },
+      }
+      ctx.provide('rsDshCore', api)
+    }
+
+    module.exports.name = '@rs-dsh/dsh-core'
+    module.exports.inject = ['conversation', 'locale', 'sessions']
+    module.exports.apply = apply
+    // Pure helpers, exported for tests only.
+    module.exports._internals = { UI_EXPORTS, pickUi, checkPlugin, placeNear, sortButtons, cleanSelection, eventInside, oneLine, stackChip, ROOT }
+    return module.exports
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# Insert the core into the profile roster. Every rs-dsh plugin that uses the
+# core inserts this same row; the loader starts it once.
+- insert:
+    - id: dsh-core
+      name: '@rs-dsh/dsh-core'

package/index.js

@@ -0,0 +1,6 @@
+// @rs-dsh/dsh-core: Node half. Everything runs in the browser bundle
+// (client.js); the host side has nothing to do. The row exists so the
+// client half loads once, however many rs-dsh plugins insert it.
+export const name = 'dsh-core'
+
+export function apply() {}

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "@rs-dsh/dsh-core",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Shared UI layer for the rs-dsh DSH plugins: one selection toolbar, anchored cards and DSH's own components, so the plugins look like DSH and stay small.",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/romany-saad/dsh-plugins.git",
+    "directory": "packages/dsh-core"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness"
+  ],
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.2.1-rc.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.2",
+    "jsdom": "26.1.0",
+    "react": "19.2.0",
+    "react-dom": "19.2.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "test": "node --check client.js && node --import ./test/no-network.mjs --test test/*.test.js"
+  }
 }