dsh-sidebar-row-menu 1.7.0 → 1.8.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 1.8.0 — 2026-11-05
+
+### Added
+
+- **Custom settings icon on DSH 0.2.2 and later.** The settings section now
+  registers a navigation icon through the host's `settings.section.icon` slot
+  instead of falling back to the default gear: three rows with a trailing
+  submenu chevron, drawn on the host's 16px grid with a 1.5px rounded stroke and
+  `currentColor`, so it follows the selected/unselected state on its own. On
+  hosts without the slot (0.2.1 and below) the registration is skipped and the
+  settings section keeps working with the host's own glyph.
+
 ## 1.7.0 — 2026-11-05
 
 ### Added

package/README.md

@@ -441,6 +441,10 @@ DSH 宿主按该范围拒绝安装不兼容的宿主，插件市场也按它显
 - **0.2.1**：没有 `contextMenus` 服务，保持原来的自绘工作区菜单；会话右键仍由插件把
   行尾「…」菜单搬到指针。
 
+设置页的导航图标走宿主的 `settings.section.icon` slot（0.2.2 新增）：图标只接收
+`{ size, active }`，用 16px 网格、1.5 描边和 `currentColor` 跟宿主自绘图标保持同一套笔触。
+0.2.1 没有这个 slot，注册被跳过，设置页照常注册并保留宿主默认的齿轮图标。
+
 DSH 升级若改动行组件或菜单定位实现：
 
 - 工作区右键会退回自绘菜单（0.2.1 路径），或静默不弹（不会报错、不影响原界面）；

package/lib/client.js

@@ -1520,6 +1520,33 @@ window.__ModuleLoader__.load({
       ]],
     ];
 
+    /**
+     * 设置导航图标（DSH 0.2.2 的 `settings.section.icon`）。
+     * 宿主只给 { size, active }，颜色由导航按钮的 currentColor 决定；
+     * 16px 网格、1.5 描边、圆头，跟宿主自绘图标同一套笔触。
+     * 造型是三行条目 + 行尾子菜单箭头：一眼看出「行 → 弹出菜单」。
+     */
+    function SettingsNavIcon({ size = 16 } = {}) {
+      return h('svg', {
+        className: 'dsrm-settings-nav',
+        width: size,
+        height: size,
+        viewBox: '0 0 16 16',
+        fill: 'none',
+        stroke: 'currentColor',
+        strokeWidth: 1.5,
+        strokeLinecap: 'round',
+        strokeLinejoin: 'round',
+        'aria-hidden': 'true',
+        focusable: 'false',
+      }, [
+        h('path', { d: 'M2.75 4.5h8.35' }),
+        h('path', { d: 'M2.75 8h8.35' }),
+        h('path', { d: 'M2.75 11.5h5.6' }),
+        h('path', { d: 'M12.1 6.5 13.6 8l-1.5 1.5' }),
+      ]);
+    }
+
     function SettingsSection({ t }) {
       const items = useItems();
       const ellipsis = useEllipsis();
@@ -2646,7 +2673,7 @@ window.__ModuleLoader__.load({
 
     /** 设置页：所有新增项都能在这里关掉。 */
     function registerSettings(ctx) {
-      return ctx.slots.inject('settings.section', function* () {
+      const stopSection = ctx.slots.inject('settings.section', function* () {
         yield ctx.slots.register({
           name: 'settings.section',
           id: 'sidebar-row-menu',
@@ -2655,6 +2682,21 @@ window.__ModuleLoader__.load({
           locale: NS,
         }, SettingsSection);
       });
+      // 0.2.2 起导航栏按 section id 取自定义图标（settings.section.icon，
+      // owner 传 { size, active }）。0.2.1 没有这个 slot，对未声明的 key
+      // 调 inject 可能直接抛错，吞掉即可——两个版本共用同一份客户端代码。
+      try {
+        ctx.slots.inject('settings.section.icon', function* () {
+          yield ctx.slots.register({
+            name: 'settings.section.icon',
+            id: 'sidebar-row-menu',
+            order: 32,
+          }, SettingsNavIcon);
+        });
+      } catch (error) {
+        console.warn('[dsh-sidebar-row-menu] settings.section.icon is unavailable:', error);
+      }
+      return stopSection;
     }
 
     /* -------------------------------------------- 会话行：展开官方菜单 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-sidebar-row-menu",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "type": "module",
   "description": "Adds open-with and cleanup entries to the DSH sidebar context menus: interleaved with the built-in workspace menu and extending the session menu at the pointer on DSH 0.2.2+, with a self-drawn workspace menu on 0.2.1.",
   "keywords": [