dsh-scrollbar-edge-hit 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agoudbg
+
+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,48 @@
-# Temporary Holding Version
+# dsh-scrollbar-edge-hit
 
-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.
+Makes the **right-edge scrollbars** of the DSH Web UI reachable at the window edge.
+
+## The problem
+
+The theme draws a 5px custom scrollbar (`--dsh-scrollbar-width: 5px`), and the scroll containers that touch the window's right edge — the conversation page (`.scrollBody`) and the Files side panel (`.body`) — carry `margin-right: 2px`. The scrollbar's draggable strip therefore ends 2px before the window edge, and that strip belongs to the parent column. With the mouse pushed fully against the right edge of the window, the scrollbar cannot be grabbed; you have to back off a pixel or two first.
+
+## The fix
+
+The plugin re-uses the scrollbar pattern the shipped Schedule page already uses: a **9px scrollbar whose thumb carries a 2px transparent border** (`background-clip: content-box`):
+
+- The visible thumb stays a 5px bar floating 2px in from the edge — pixel-for-pixel where it is today.
+- The draggable strip becomes the full 9px and now reaches the window edge, so the mouse slammed to the right edge lands on the scrollbar.
+- `margin-right: 2px` is removed from both containers so the scrollbar sits flush at the edge; `scrollbar-gutter: stable` just reserves 9px instead of 5px.
+
+Scope: `[data-conversation-scroll]` (conversation page) and `[data-files-body]` (Files panel) — the two containers whose scrollbar sits at the window's right edge. The sidebar session list, the composer textarea, and dialog scrollers keep their shipped geometry. Those attributes are the stable public hooks the shipped code itself queries, so CSS-module hash changes on rebuild do not break the selectors.
+
+A DSH update that changes the scrollbar custom properties (`--dsh-scrollbar-width`, `--dsh-scrollbar-thumb-border`) or the 2px edge offset needs this sheet revisited.
+
+## Requirements
+
+- DSH `>=0.2.1-rc.5`
+- The DSH Web UI (the plugin's client half targets the `web` platform)
+
+## Install
+
+From npm, into the profile you boot:
+
+```sh
+dsh plugin --profile <profile> add dsh-scrollbar-edge-hit
+```
+
+Remove it the same way:
+
+```sh
+dsh plugin --profile <profile> remove dsh-scrollbar-edge-hit
+```
+
+From a local clone of [agou-dsh-plugins](https://github.com/agoudbg/agou-dsh-plugins), install this package directory through the DSH Plugin Manager instead:
+
+```
+R:\path\to\agou-dsh-plugins\packages\dsh-scrollbar-edge-hit
+```
+
+## License
+
+[MIT](./LICENSE)

package/client.js

@@ -0,0 +1,62 @@
+window.__ModuleLoader__.load({
+  id: 'dsh-scrollbar-edge-hit',
+  factory(require) {
+    const React = require('react');
+    const h = React.createElement;
+
+    /**
+     * Scrollbar edge hit-area fix.
+     *
+     * Shipped geometry (ui-conversation `.scrollBody`, ui-sidebar-files
+     * `.body`): the scroll container keeps `margin-right: 2px` with the theme
+     * default `--dsh-scrollbar-width: 5px`, so the scrollbar's hit strip ends
+     * 2px before the window edge. Pushing the mouse fully against the right
+     * edge lands on the parent column instead of the scrollbar, and the bar
+     * cannot be grabbed there.
+     *
+     * This sheet re-uses the pattern the shipped Schedule page already uses
+     * (`.pageScroll`): a 9px scrollbar whose thumb carries a 2px transparent
+     * border. The visible thumb stays a 5px bar floating 2px in from the edge,
+     * pixel-for-pixel where it is today, while the draggable strip becomes the
+     * full 9px and reaches the window edge. The margin-right is dropped so the
+     * scrollbar itself sits flush at the edge.
+     *
+     * Selectors anchor on the public `data-conversation-scroll` and
+     * `data-files-body` attributes the shipped code itself queries, so
+     * rebuilds that change CSS-module hashes keep working.
+     */
+    const CSS = [
+      /* Main conversation scroll: hit area to the window edge. */
+      '[data-conversation-scroll] {',
+      '  --dsh-scrollbar-width: 9px;',
+      '  --dsh-scrollbar-thumb-border: 2px;',
+      '  margin-right: 0 !important;',
+      '}',
+      /* Files side panel: the same dead strip at the window edge. */
+      '[data-files-body] {',
+      '  --dsh-scrollbar-width: 9px;',
+      '  --dsh-scrollbar-thumb-border: 2px;',
+      '  margin-right: 0 !important;',
+      '}',
+    ].join('\n');
+
+    /** Renders only a stylesheet; unmounting the slot entry removes it. */
+    function ScrollbarEdgeHitStyle() {
+      return h('style', {
+        'data-plugin': 'dsh-scrollbar-edge-hit',
+        'data-plugin-css': 'dsh-scrollbar-edge-hit/scrollbar.css',
+      }, CSS);
+    }
+
+    return {
+      inject: ['slots'],
+      apply(ctx) {
+        ctx.slots.inject('shell.overlay', () => ctx.slots.register({
+          name: 'shell.overlay',
+          id: 'scrollbar-edge-hit',
+          order: 1000,
+        }, ScrollbarEdgeHitStyle));
+      },
+    };
+  },
+});

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# Insert the scrollbar-edge-hit Client plugin (style-only web overlay).
+- insert:
+    - id: scrollbar-edge-hit
+      name: dsh-scrollbar-edge-hit
+      config: {}

package/icon.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
+  <rect x="8" y="8" width="48" height="48" rx="10" fill="none" stroke="#5b6472" stroke-width="3"/>
+  <line x1="47" y1="14" x2="47" y2="50" stroke="#5b6472" stroke-width="3"/>
+  <line x1="47" y1="23" x2="47" y2="37" stroke="#247bbf" stroke-width="6" stroke-linecap="round"/>
+  <path d="M18 30h22m0 0-7-7m7 7-7 7" fill="none" stroke="#247bbf" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/index.js

@@ -0,0 +1,2 @@
+/** Host half of the bundle; the Client module owns the page-side style injection. */
+export function apply() {}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Edge-Reachable Scrollbar",
+    "description": "Makes the scrollbar usable with the mouse at the screen edge."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "滚动条贴边可用",
+    "description": "让滚动条在鼠标位于屏幕边缘时可用。"
+  }
+}

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "dsh-scrollbar-edge-hit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Makes the DSH Web UI scrollbar usable with the mouse at the screen edge.",
+  "type": "module",
+  "license": "MIT",
+  "author": "agoudbg",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agoudbg/agou-dsh-plugins.git",
+    "directory": "packages/dsh-scrollbar-edge-hit"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "web-ui",
+    "scrollbar"
+  ],
+  "engines": {
+    "dsh": ">=0.2.1-rc.5"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": ["@deepseek-ai/dsh-client-ui-layout"]
+    }
+  }
+}