dsh-conversation-navigator 0.2.10 → 0.2.11

package/README.en.md

@@ -102,12 +102,13 @@ Official v0.1.2-rc.1 made a breaking change to the conversation data layer (conv
 
 | Host `dsh-client-ui-conversation` | Matching plugin version | npm tag |
 |---|---|---|
-| **≥ 0.1.2-rc.1** (has the `uiConversation` service) | **0.2.6 and later** (currently 0.2.10) | `latest` (default) |
+| **≥ 0.1.2-rc.1** (has the `uiConversation` service) | **0.2.6 and later** (currently 0.2.11) | `latest` (default) |
 | **≤ 0.1.1-rc.2** (no `uiConversation`, legacy `session.chat` snapshot) | **0.2.5 and earlier** | `legacy` |
 
 - New hosts can install the latest normally (`dsh plugin --profile web add dsh-conversation-navigator`).
 - Legacy hosts should pin the legacy tag: `npm i dsh-conversation-navigator@legacy` (= 0.2.5).
-- From 0.2.6 the `peerDependencies` range is `>=0.1.2-rc.1 <0.2.0` (new host only); 0.2.5 and earlier declare no such range.
+- From 0.2.6 the `peerDependencies` range is `>=0.1.2-rc.1 <0.3.0` (both the conversation data layer and the UI primitives package).
+- Icon export compatibility: DSH **0.1.7** silently renamed `IconXxxOutline16` to `IconXxxOutlineRegular / Medium` (0.1.2–0.1.6 only ship the old names). From 0.2.11 the plugin resolves them in one place, preferring the new names and falling back to the old ones, and degrades to placeholder components with a diagnostic error instead of letting the whole slot die on minified React error #130. CI checks the host export contract against released DSH versions (`scripts/check-host-exports.mjs`).
 
 ## Structure
 
@@ -117,6 +118,8 @@ lib/
   client.js  # full browser implementation (window.__ModuleLoader__ module format)
 assets/
   screenshots/   # screenshots (README hero + market gallery)
+scripts/
+  check-host-exports.mjs   # CI: host export contract check (silent removals like icon renames)
 cordis.patch.yml     # bundle patch layer (inserts the plugin row)
 example.patch.yml    # patch example for manual installs
 ```

package/README.md

@@ -99,12 +99,13 @@ dsh plugin --profile web add ./dsh-conversation-navigator-<version>.tgz
 
 | 宿主 `dsh-client-ui-conversation` | 对应插件版本 | npm 标签 |
 |---|---|---|
-| **≥ 0.1.2-rc.1**（有 `uiConversation` 服务） | **0.2.6 及以后**（当前 0.2.10） | `latest`（默认） |
+| **≥ 0.1.2-rc.1**（有 `uiConversation` 服务） | **0.2.6 及以后**（当前 0.2.11） | `latest`（默认） |
 | **≤ 0.1.1-rc.2**（无 `uiConversation`，旧 `session.chat` 快照） | **0.2.5 及以前** | `legacy` |
 
 - 新宿主直接安装最新版即可（`dsh plugin --profile web add dsh-conversation-navigator`）。
 - 旧宿主请指定旧标签：`npm i dsh-conversation-navigator@legacy`（= 0.2.5）。
-- 0.2.6 起 `peerDependencies` 声明为 `>=0.1.2-rc.1 <0.2.0`（仅新宿主）；0.2.5 及以前不声明该范围。
+- 0.2.6 起 `peerDependencies` 声明 `>=0.1.2-rc.1 <0.3.0`（会话数据层与 UI primitives 两个包）。
+- 图标导出兼容:官方 **0.1.7** 起把 `IconXxxOutline16` 静默改为 `IconXxxOutlineRegular / Medium`(0.1.2~0.1.6 只有旧名)。0.2.11 起插件在**一处集中解析**、新名优先 → 旧名回退,缺失时打印可诊断的报错并退化为占位组件,不再让整个 slot 因 minified React error #130 被判崩溃;CI 对已发布 DSH 版本做宿主导出契约检查(`scripts/check-host-exports.mjs`)。
 
 ## 目录结构
 
@@ -114,6 +115,8 @@ lib/
   client.js  # 浏览器端完整实现(window.__ModuleLoader__ 模块格式)
 assets/
   screenshots/   # 截图(README 主图 + 市场截图墙)
+scripts/
+  check-host-exports.mjs   # CI: 宿主导出契约检查(图标改名这类静默移除)
 cordis.patch.yml     # 组合包补丁层(插入插件行)
 example.patch.yml    # 手动安装时的补丁示例
 ```

package/lib/client.js

@@ -5,7 +5,43 @@ window.__ModuleLoader__.load({
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 		const React = require("react");
-		const { Button, Tooltip, IconCloseOutline16, IconSearchOutline16 } = require("@deepseek-ai/dsh-client-ui-primitives");
+		/* ---------- 宿主导出集中取用（唯一引入点, 便于随 DSH 升级核对） ----------
+		   DSH 0.1.7 起把图标导出从「尺寸后缀」(IconXxxOutline16) 静默改为「字重后缀」
+		   (IconXxxOutlineRegular / Medium, 旧名被直接移除)。解构出 undefined 再交给 React
+		   渲染会抛 minified error #130, 并让整个 slot 被判为崩溃, 故这里按 新名 → 旧名
+		   依次解析; 缺失时打印可诊断的报错并退化为占位组件, 保证面板本体仍能渲染。 */
+		const primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		function MissingIcon() {
+			return React.createElement("span", { className: "cnvnav-icon-missing", "aria-hidden": "true" });
+		}
+		function MissingButton(props) {
+			return React.createElement("button", {
+				type: "button", className: props.className, onClick: props.onClick,
+				disabled: props.disabled, title: props.title,
+			}, props.icon === undefined ? null : props.icon, props.children === undefined ? null : props.children);
+		}
+		function MissingTooltip(props) {
+			return React.createElement(React.Fragment, null, props.children === undefined ? null : props.children);
+		}
+		const pickHostExport = (names, fallback) => {
+			for (const name of names) if (primitives[name] !== undefined) return primitives[name];
+			return fallback;
+		};
+		const Button = pickHostExport(["Button"], MissingButton);
+		const Tooltip = pickHostExport(["Tooltip"], MissingTooltip);
+		/* 图标: Regular(描边 1, DSH 自家插件主用) → Medium(描边 1.3) → 无后缀 → 旧数字后缀 */
+		const IconCloseOutline = pickHostExport(["IconCloseOutlineRegular", "IconCloseOutlineMedium", "IconCloseOutline", "IconCloseOutline16"], MissingIcon);
+		const IconSearchOutline = pickHostExport(["IconSearchOutlineRegular", "IconSearchOutlineMedium", "IconSearchOutline", "IconSearchOutline16"], MissingIcon);
+		/* 缺导出时给出可诊断的报错(而不是渲染期 minified React #130) */
+		const missingHostExports = [];
+		if (primitives.Button === undefined) missingHostExports.push("Button");
+		if (primitives.Tooltip === undefined) missingHostExports.push("Tooltip");
+		if (IconCloseOutline === MissingIcon) missingHostExports.push("IconCloseOutline{Regular|Medium|16}");
+		if (IconSearchOutline === MissingIcon) missingHostExports.push("IconSearchOutline{Regular|Medium|16}");
+		if (missingHostExports.length > 0) {
+			console.error("[dsh-conversation-navigator] @deepseek-ai/dsh-client-ui-primitives 缺少导出: " + missingHostExports.join(", ")
+				+ " —— 已退化为占位组件渲染; 请核对 DSH 版本与本插件的 peerDependencies。");
+		}
 
 /* ---------- 自绘图标: Lucide (ISC License, https://lucide.dev)
 		   24px 网格 / 2px 描边 / 圆角线帽, 与 DSH 官方描边图标同一视觉语言 ---------- */
@@ -1886,7 +1922,7 @@ window.__ModuleLoader__.load({
 								React.createElement(Button, {
 									variant: "ghost",
 									size: "sm",
-									icon: React.createElement(IconSearchOutline16, { size: 14 }),
+									icon: React.createElement(IconSearchOutline, { size: 14 }),
 									onClick: () => toggleSearch(),
 								}),
 							),
@@ -1955,7 +1991,7 @@ window.__ModuleLoader__.load({
 								React.createElement(Button, {
 									variant: "ghost",
 									size: "sm",
-									icon: React.createElement(IconCloseOutline16, { size: 14 }),
+									icon: React.createElement(IconCloseOutline, { size: 14 }),
 									onClick: () => setState({ open: false }),
 								}),
 							),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-conversation-navigator",
-  "version": "0.2.10",
+  "version": "0.2.11",
   "description": "DSH(DeepSeek Harness)会话导航插件:按轮折叠的对话大纲面板,支持节点点击跳转、滚动位置高亮与轨迹视图同款配色。",
   "keywords": [
     "dsh",
@@ -33,7 +33,8 @@
     "node": ">=18"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.2-rc.1 <0.2.0"
+    "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.2-rc.1 <0.3.0",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.2-rc.1 <0.3.0"
   },
   "dsh": {
     "bundle": {