dsh-tidy-display 0.1.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 (402) hide show
  1. package/CHANGELOG.md +270 -0
  2. package/DESIGN.md +72 -0
  3. package/LICENSE +24 -0
  4. package/README.en.md +118 -0
  5. package/README.md +118 -0
  6. package/THIRD_PARTY_NOTICES.md +65 -0
  7. package/compat/harness-rc2.json +99 -0
  8. package/cordis.patch.yml +5 -0
  9. package/cordis.yml +4 -0
  10. package/docs/official-rendering-bridge.md +65 -0
  11. package/docs/plans/2026-09-28-merge/checklist.md +21 -0
  12. package/docs/plans/2026-09-28-merge/findings.md +24 -0
  13. package/docs/plans/2026-09-28-merge/spec.md +61 -0
  14. package/docs/plans/2026-09-28-merge/tasks.md +34 -0
  15. package/dshx.yml +5 -0
  16. package/lib/client.js +50207 -0
  17. package/lib/client.js.map +1 -0
  18. package/lib/dsh-tidy-display.js +254 -0
  19. package/lib/types/client/Blocks.d.ts +49 -0
  20. package/lib/types/client/Blocks.d.ts.map +1 -0
  21. package/lib/types/client/Blocks.js +143 -0
  22. package/lib/types/client/Blocks.js.map +1 -0
  23. package/lib/types/client/ChoreographedFlow.d.ts +22 -0
  24. package/lib/types/client/ChoreographedFlow.d.ts.map +1 -0
  25. package/lib/types/client/ChoreographedFlow.js +218 -0
  26. package/lib/types/client/ChoreographedFlow.js.map +1 -0
  27. package/lib/types/client/ClosedProcessSummary.d.ts +9 -0
  28. package/lib/types/client/ClosedProcessSummary.d.ts.map +1 -0
  29. package/lib/types/client/ClosedProcessSummary.js +16 -0
  30. package/lib/types/client/ClosedProcessSummary.js.map +1 -0
  31. package/lib/types/client/DiffPanel.d.ts +13 -0
  32. package/lib/types/client/DiffPanel.d.ts.map +1 -0
  33. package/lib/types/client/DiffPanel.js +115 -0
  34. package/lib/types/client/DiffPanel.js.map +1 -0
  35. package/lib/types/client/LiveFold.d.ts +10 -0
  36. package/lib/types/client/LiveFold.d.ts.map +1 -0
  37. package/lib/types/client/LiveFold.js +39 -0
  38. package/lib/types/client/LiveFold.js.map +1 -0
  39. package/lib/types/client/McpAppFrame.d.ts +32 -0
  40. package/lib/types/client/McpAppFrame.d.ts.map +1 -0
  41. package/lib/types/client/McpAppFrame.js +193 -0
  42. package/lib/types/client/McpAppFrame.js.map +1 -0
  43. package/lib/types/client/OfficialContent.d.ts +25 -0
  44. package/lib/types/client/OfficialContent.d.ts.map +1 -0
  45. package/lib/types/client/OfficialContent.js +53 -0
  46. package/lib/types/client/OfficialContent.js.map +1 -0
  47. package/lib/types/client/Reader.d.ts +3 -0
  48. package/lib/types/client/Reader.d.ts.map +1 -0
  49. package/lib/types/client/Reader.js +508 -0
  50. package/lib/types/client/Reader.js.map +1 -0
  51. package/lib/types/client/ReasoningCard.d.ts +11 -0
  52. package/lib/types/client/ReasoningCard.d.ts.map +1 -0
  53. package/lib/types/client/ReasoningCard.js +322 -0
  54. package/lib/types/client/ReasoningCard.js.map +1 -0
  55. package/lib/types/client/SettingsSection.d.ts +59 -0
  56. package/lib/types/client/SettingsSection.d.ts.map +1 -0
  57. package/lib/types/client/SettingsSection.js +93 -0
  58. package/lib/types/client/SettingsSection.js.map +1 -0
  59. package/lib/types/client/StickyLane.d.ts +8 -0
  60. package/lib/types/client/StickyLane.d.ts.map +1 -0
  61. package/lib/types/client/StickyLane.js +39 -0
  62. package/lib/types/client/StickyLane.js.map +1 -0
  63. package/lib/types/client/TimelineRail.d.ts +10 -0
  64. package/lib/types/client/TimelineRail.d.ts.map +1 -0
  65. package/lib/types/client/TimelineRail.js +168 -0
  66. package/lib/types/client/TimelineRail.js.map +1 -0
  67. package/lib/types/client/ToolActivity.d.ts +17 -0
  68. package/lib/types/client/ToolActivity.d.ts.map +1 -0
  69. package/lib/types/client/ToolActivity.js +244 -0
  70. package/lib/types/client/ToolActivity.js.map +1 -0
  71. package/lib/types/client/TurnMetrics.d.ts +11 -0
  72. package/lib/types/client/TurnMetrics.d.ts.map +1 -0
  73. package/lib/types/client/TurnMetrics.js +44 -0
  74. package/lib/types/client/TurnMetrics.js.map +1 -0
  75. package/lib/types/client/WaitClock.d.ts +16 -0
  76. package/lib/types/client/WaitClock.d.ts.map +1 -0
  77. package/lib/types/client/WaitClock.js +29 -0
  78. package/lib/types/client/WaitClock.js.map +1 -0
  79. package/lib/types/client/WaitingClock.d.ts +15 -0
  80. package/lib/types/client/WaitingClock.d.ts.map +1 -0
  81. package/lib/types/client/WaitingClock.js +30 -0
  82. package/lib/types/client/WaitingClock.js.map +1 -0
  83. package/lib/types/client/WaitingStatus.d.ts +6 -0
  84. package/lib/types/client/WaitingStatus.d.ts.map +1 -0
  85. package/lib/types/client/WaitingStatus.js +9 -0
  86. package/lib/types/client/WaitingStatus.js.map +1 -0
  87. package/lib/types/client/conversation-scroll.d.ts +19 -0
  88. package/lib/types/client/conversation-scroll.d.ts.map +1 -0
  89. package/lib/types/client/conversation-scroll.js +25 -0
  90. package/lib/types/client/conversation-scroll.js.map +1 -0
  91. package/lib/types/client/deliverables.d.ts +24 -0
  92. package/lib/types/client/deliverables.d.ts.map +1 -0
  93. package/lib/types/client/deliverables.js +104 -0
  94. package/lib/types/client/deliverables.js.map +1 -0
  95. package/lib/types/client/entry-policy.d.ts +10 -0
  96. package/lib/types/client/entry-policy.d.ts.map +1 -0
  97. package/lib/types/client/entry-policy.js +24 -0
  98. package/lib/types/client/entry-policy.js.map +1 -0
  99. package/lib/types/client/entry.d.ts +4 -0
  100. package/lib/types/client/entry.d.ts.map +1 -0
  101. package/lib/types/client/entry.js +34 -0
  102. package/lib/types/client/entry.js.map +1 -0
  103. package/lib/types/client/fold-choreography.d.ts +40 -0
  104. package/lib/types/client/fold-choreography.d.ts.map +1 -0
  105. package/lib/types/client/fold-choreography.js +48 -0
  106. package/lib/types/client/fold-choreography.js.map +1 -0
  107. package/lib/types/client/fold-intensity.d.ts +11 -0
  108. package/lib/types/client/fold-intensity.d.ts.map +1 -0
  109. package/lib/types/client/fold-intensity.js +32 -0
  110. package/lib/types/client/fold-intensity.js.map +1 -0
  111. package/lib/types/client/index.d.ts +7 -0
  112. package/lib/types/client/index.d.ts.map +1 -0
  113. package/lib/types/client/index.js +234 -0
  114. package/lib/types/client/index.js.map +1 -0
  115. package/lib/types/client/live-turn.d.ts +58 -0
  116. package/lib/types/client/live-turn.d.ts.map +1 -0
  117. package/lib/types/client/live-turn.js +144 -0
  118. package/lib/types/client/live-turn.js.map +1 -0
  119. package/lib/types/client/markdown/MarkdownText.d.ts +41 -0
  120. package/lib/types/client/markdown/MarkdownText.d.ts.map +1 -0
  121. package/lib/types/client/markdown/MarkdownText.js +178 -0
  122. package/lib/types/client/markdown/MarkdownText.js.map +1 -0
  123. package/lib/types/client/markdown/cjkFriendlyStrong.d.ts +9 -0
  124. package/lib/types/client/markdown/cjkFriendlyStrong.d.ts.map +1 -0
  125. package/lib/types/client/markdown/cjkFriendlyStrong.js +73 -0
  126. package/lib/types/client/markdown/cjkFriendlyStrong.js.map +1 -0
  127. package/lib/types/client/markdown/incremental.d.ts +69 -0
  128. package/lib/types/client/markdown/incremental.d.ts.map +1 -0
  129. package/lib/types/client/markdown/incremental.js +108 -0
  130. package/lib/types/client/markdown/incremental.js.map +1 -0
  131. package/lib/types/client/markdown/katex.d.ts +27 -0
  132. package/lib/types/client/markdown/katex.d.ts.map +1 -0
  133. package/lib/types/client/markdown/katex.js +88 -0
  134. package/lib/types/client/markdown/katex.js.map +1 -0
  135. package/lib/types/client/markdown/mathCompatibility.d.ts +11 -0
  136. package/lib/types/client/markdown/mathCompatibility.d.ts.map +1 -0
  137. package/lib/types/client/markdown/mathCompatibility.js +295 -0
  138. package/lib/types/client/markdown/mathCompatibility.js.map +1 -0
  139. package/lib/types/client/markdown/parse.d.ts +25 -0
  140. package/lib/types/client/markdown/parse.d.ts.map +1 -0
  141. package/lib/types/client/markdown/parse.js +42 -0
  142. package/lib/types/client/markdown/parse.js.map +1 -0
  143. package/lib/types/client/markdown/render.d.ts +121 -0
  144. package/lib/types/client/markdown/render.d.ts.map +1 -0
  145. package/lib/types/client/markdown/render.js +452 -0
  146. package/lib/types/client/markdown/render.js.map +1 -0
  147. package/lib/types/client/mcp-app.d.ts +50 -0
  148. package/lib/types/client/mcp-app.d.ts.map +1 -0
  149. package/lib/types/client/mcp-app.js +328 -0
  150. package/lib/types/client/mcp-app.js.map +1 -0
  151. package/lib/types/client/message-chrome.d.ts +19 -0
  152. package/lib/types/client/message-chrome.d.ts.map +1 -0
  153. package/lib/types/client/message-chrome.js +42 -0
  154. package/lib/types/client/message-chrome.js.map +1 -0
  155. package/lib/types/client/motion.d.ts +38 -0
  156. package/lib/types/client/motion.d.ts.map +1 -0
  157. package/lib/types/client/motion.js +453 -0
  158. package/lib/types/client/motion.js.map +1 -0
  159. package/lib/types/client/native/ContextBody.d.ts +130 -0
  160. package/lib/types/client/native/ContextBody.d.ts.map +1 -0
  161. package/lib/types/client/native/ContextBody.js +398 -0
  162. package/lib/types/client/native/ContextBody.js.map +1 -0
  163. package/lib/types/client/native/ContextInjectionRow.d.ts +35 -0
  164. package/lib/types/client/native/ContextInjectionRow.d.ts.map +1 -0
  165. package/lib/types/client/native/ContextInjectionRow.js +42 -0
  166. package/lib/types/client/native/ContextInjectionRow.js.map +1 -0
  167. package/lib/types/client/native/ReferenceIcon.d.ts +16 -0
  168. package/lib/types/client/native/ReferenceIcon.d.ts.map +1 -0
  169. package/lib/types/client/native/ReferenceIcon.js +16 -0
  170. package/lib/types/client/native/ReferenceIcon.js.map +1 -0
  171. package/lib/types/client/native/tool-call-model.d.ts +58 -0
  172. package/lib/types/client/native/tool-call-model.d.ts.map +1 -0
  173. package/lib/types/client/native/tool-call-model.js +219 -0
  174. package/lib/types/client/native/tool-call-model.js.map +1 -0
  175. package/lib/types/client/native/tool-update.d.ts +23 -0
  176. package/lib/types/client/native/tool-update.d.ts.map +1 -0
  177. package/lib/types/client/native/tool-update.js +22 -0
  178. package/lib/types/client/native/tool-update.js.map +1 -0
  179. package/lib/types/client/official-slots.d.ts +71 -0
  180. package/lib/types/client/official-slots.d.ts.map +1 -0
  181. package/lib/types/client/official-slots.js +183 -0
  182. package/lib/types/client/official-slots.js.map +1 -0
  183. package/lib/types/client/open-file.d.ts +29 -0
  184. package/lib/types/client/open-file.d.ts.map +1 -0
  185. package/lib/types/client/open-file.js +71 -0
  186. package/lib/types/client/open-file.js.map +1 -0
  187. package/lib/types/client/pending-submission.d.ts +28 -0
  188. package/lib/types/client/pending-submission.d.ts.map +1 -0
  189. package/lib/types/client/pending-submission.js +28 -0
  190. package/lib/types/client/pending-submission.js.map +1 -0
  191. package/lib/types/client/platform-media.d.ts +6 -0
  192. package/lib/types/client/platform-media.d.ts.map +1 -0
  193. package/lib/types/client/platform-media.js +18 -0
  194. package/lib/types/client/platform-media.js.map +1 -0
  195. package/lib/types/client/primitive-labels.d.ts +10 -0
  196. package/lib/types/client/primitive-labels.d.ts.map +1 -0
  197. package/lib/types/client/primitive-labels.js +38 -0
  198. package/lib/types/client/primitive-labels.js.map +1 -0
  199. package/lib/types/client/projection.d.ts +41 -0
  200. package/lib/types/client/projection.d.ts.map +1 -0
  201. package/lib/types/client/projection.js +112 -0
  202. package/lib/types/client/projection.js.map +1 -0
  203. package/lib/types/client/rail/RailView.d.ts +24 -0
  204. package/lib/types/client/rail/RailView.d.ts.map +1 -0
  205. package/lib/types/client/rail/RailView.js +540 -0
  206. package/lib/types/client/rail/RailView.js.map +1 -0
  207. package/lib/types/client/rail/colors.d.ts +43 -0
  208. package/lib/types/client/rail/colors.d.ts.map +1 -0
  209. package/lib/types/client/rail/colors.js +223 -0
  210. package/lib/types/client/rail/colors.js.map +1 -0
  211. package/lib/types/client/reasoning-follow.d.ts +10 -0
  212. package/lib/types/client/reasoning-follow.d.ts.map +1 -0
  213. package/lib/types/client/reasoning-follow.js +21 -0
  214. package/lib/types/client/reasoning-follow.js.map +1 -0
  215. package/lib/types/client/resource-address.d.ts +3 -0
  216. package/lib/types/client/resource-address.d.ts.map +1 -0
  217. package/lib/types/client/resource-address.js +33 -0
  218. package/lib/types/client/resource-address.js.map +1 -0
  219. package/lib/types/client/settings-copy.d.ts +7 -0
  220. package/lib/types/client/settings-copy.d.ts.map +1 -0
  221. package/lib/types/client/settings-copy.js +85 -0
  222. package/lib/types/client/settings-copy.js.map +1 -0
  223. package/lib/types/client/settings-slots.d.ts +34 -0
  224. package/lib/types/client/settings-slots.d.ts.map +1 -0
  225. package/lib/types/client/settings-slots.js +2 -0
  226. package/lib/types/client/settings-slots.js.map +1 -0
  227. package/lib/types/client/settings.d.ts +4 -0
  228. package/lib/types/client/settings.d.ts.map +1 -0
  229. package/lib/types/client/settings.js +60 -0
  230. package/lib/types/client/settings.js.map +1 -0
  231. package/lib/types/client/skill-status.d.ts +25 -0
  232. package/lib/types/client/skill-status.d.ts.map +1 -0
  233. package/lib/types/client/skill-status.js +44 -0
  234. package/lib/types/client/skill-status.js.map +1 -0
  235. package/lib/types/client/store.d.ts +66 -0
  236. package/lib/types/client/store.d.ts.map +1 -0
  237. package/lib/types/client/store.js +61 -0
  238. package/lib/types/client/store.js.map +1 -0
  239. package/lib/types/client/stream-buffer.d.ts +37 -0
  240. package/lib/types/client/stream-buffer.d.ts.map +1 -0
  241. package/lib/types/client/stream-buffer.js +150 -0
  242. package/lib/types/client/stream-buffer.js.map +1 -0
  243. package/lib/types/client/streaming.d.ts +18 -0
  244. package/lib/types/client/streaming.d.ts.map +1 -0
  245. package/lib/types/client/streaming.js +84 -0
  246. package/lib/types/client/streaming.js.map +1 -0
  247. package/lib/types/client/timeline.d.ts +26 -0
  248. package/lib/types/client/timeline.d.ts.map +1 -0
  249. package/lib/types/client/timeline.js +48 -0
  250. package/lib/types/client/timeline.js.map +1 -0
  251. package/lib/types/client/tool-activity.d.ts +98 -0
  252. package/lib/types/client/tool-activity.d.ts.map +1 -0
  253. package/lib/types/client/tool-activity.js +301 -0
  254. package/lib/types/client/tool-activity.js.map +1 -0
  255. package/lib/types/client/types.d.ts +91 -0
  256. package/lib/types/client/types.d.ts.map +1 -0
  257. package/lib/types/client/types.js +2 -0
  258. package/lib/types/client/types.js.map +1 -0
  259. package/lib/types/client/waiting-clock.d.ts +49 -0
  260. package/lib/types/client/waiting-clock.d.ts.map +1 -0
  261. package/lib/types/client/waiting-clock.js +80 -0
  262. package/lib/types/client/waiting-clock.js.map +1 -0
  263. package/lib/types/client/word-motion.d.ts +16 -0
  264. package/lib/types/client/word-motion.d.ts.map +1 -0
  265. package/lib/types/client/word-motion.js +90 -0
  266. package/lib/types/client/word-motion.js.map +1 -0
  267. package/lib/types/client/word-timeline.d.ts +32 -0
  268. package/lib/types/client/word-timeline.d.ts.map +1 -0
  269. package/lib/types/client/word-timeline.js +119 -0
  270. package/lib/types/client/word-timeline.js.map +1 -0
  271. package/lib/types/dsh-tidy-display.d.ts +17 -0
  272. package/lib/types/dsh-tidy-display.d.ts.map +1 -0
  273. package/lib/types/dsh-tidy-display.js +97 -0
  274. package/lib/types/dsh-tidy-display.js.map +1 -0
  275. package/lib/types/skill-roots.d.ts +22 -0
  276. package/lib/types/skill-roots.d.ts.map +1 -0
  277. package/lib/types/skill-roots.js +126 -0
  278. package/lib/types/skill-roots.js.map +1 -0
  279. package/lib/types/skill-status.d.ts +36 -0
  280. package/lib/types/skill-status.d.ts.map +1 -0
  281. package/lib/types/skill-status.js +51 -0
  282. package/lib/types/skill-status.js.map +1 -0
  283. package/package.json +141 -0
  284. package/scripts/build-motion-fixture.mjs +26 -0
  285. package/scripts/check-harness-compat.mjs +75 -0
  286. package/scripts/link-harness-dependencies.mjs +54 -0
  287. package/scripts/verify-auto-fold.mjs +114 -0
  288. package/scripts/verify-official-bridge.mjs +121 -0
  289. package/scripts/verify-tool-shimmer.mjs +62 -0
  290. package/skills/generative-mcpapps/SKILL.md +47 -0
  291. package/skills/generative-mcpapps/examples/interactive_quiz.html +153 -0
  292. package/skills/generative-mcpapps/references/html_boilerplate.md +122 -0
  293. package/skills/generative-mcpapps/references/sep1865_protocol.md +54 -0
  294. package/src/client/Blocks.tsx +213 -0
  295. package/src/client/ChoreographedFlow.tsx +232 -0
  296. package/src/client/ClosedProcessSummary.tsx +23 -0
  297. package/src/client/DiffPanel.tsx +124 -0
  298. package/src/client/LiveFold.tsx +43 -0
  299. package/src/client/McpAppFrame.module.css +210 -0
  300. package/src/client/McpAppFrame.tsx +317 -0
  301. package/src/client/OfficialContent.tsx +69 -0
  302. package/src/client/Reader.module.css +714 -0
  303. package/src/client/Reader.tsx +783 -0
  304. package/src/client/ReasoningCard.tsx +306 -0
  305. package/src/client/SettingsSection.module.css +184 -0
  306. package/src/client/SettingsSection.tsx +391 -0
  307. package/src/client/StickyLane.tsx +34 -0
  308. package/src/client/ToolActivity.tsx +274 -0
  309. package/src/client/TurnMetrics.module.css +139 -0
  310. package/src/client/TurnMetrics.tsx +160 -0
  311. package/src/client/WaitClock.tsx +33 -0
  312. package/src/client/WaitingStatus.tsx +13 -0
  313. package/src/client/conversation-scroll.ts +28 -0
  314. package/src/client/deliverables.ts +122 -0
  315. package/src/client/entry-policy.ts +20 -0
  316. package/src/client/entry.tsx +40 -0
  317. package/src/client/fold-choreography.ts +55 -0
  318. package/src/client/fold-intensity.ts +36 -0
  319. package/src/client/index.tsx +268 -0
  320. package/src/client/live-turn.ts +155 -0
  321. package/src/client/markdown/MarkdownText.module.css +304 -0
  322. package/src/client/markdown/MarkdownText.tsx +195 -0
  323. package/src/client/markdown/cjkFriendlyStrong.ts +84 -0
  324. package/src/client/markdown/incremental.ts +131 -0
  325. package/src/client/markdown/katex.tsx +91 -0
  326. package/src/client/markdown/mathCompatibility.ts +352 -0
  327. package/src/client/markdown/parse.ts +45 -0
  328. package/src/client/markdown/render.tsx +647 -0
  329. package/src/client/markdown/upstream.json +14 -0
  330. package/src/client/mcp-app.ts +323 -0
  331. package/src/client/message-chrome.ts +47 -0
  332. package/src/client/motion.tsx +410 -0
  333. package/src/client/native/ContextBody.module.css +161 -0
  334. package/src/client/native/ContextBody.tsx +591 -0
  335. package/src/client/native/ContextInjectionRow.module.css +66 -0
  336. package/src/client/native/ContextInjectionRow.tsx +106 -0
  337. package/src/client/native/ReferenceIcon.tsx +35 -0
  338. package/src/client/native/tool-call-model.ts +248 -0
  339. package/src/client/native/tool-update.ts +32 -0
  340. package/src/client/native/upstream.json +41 -0
  341. package/src/client/official-slots.tsx +211 -0
  342. package/src/client/open-file.ts +94 -0
  343. package/src/client/pending-submission.ts +49 -0
  344. package/src/client/platform-media.ts +17 -0
  345. package/src/client/primitive-labels.ts +54 -0
  346. package/src/client/projection.ts +118 -0
  347. package/src/client/rail/RailView.tsx +508 -0
  348. package/src/client/rail/colors.ts +212 -0
  349. package/src/client/reasoning-follow.ts +28 -0
  350. package/src/client/settings-copy.ts +128 -0
  351. package/src/client/settings-slots.ts +27 -0
  352. package/src/client/settings.tsx +73 -0
  353. package/src/client/skill-status.ts +78 -0
  354. package/src/client/store.ts +130 -0
  355. package/src/client/stream-buffer.ts +136 -0
  356. package/src/client/streaming.tsx +70 -0
  357. package/src/client/style.d.ts +4 -0
  358. package/src/client/timeline.ts +75 -0
  359. package/src/client/tool-activity.ts +298 -0
  360. package/src/client/types.ts +89 -0
  361. package/src/client/waiting-clock.ts +83 -0
  362. package/src/client/word-motion.tsx +92 -0
  363. package/src/client/word-timeline.ts +113 -0
  364. package/src/dsh-tidy-display.ts +112 -0
  365. package/src/skill-roots.ts +138 -0
  366. package/src/skill-status.ts +81 -0
  367. package/tests/browser-auto-fold.tsx +64 -0
  368. package/tests/browser-closed-gap.tsx +20 -0
  369. package/tests/browser-motion.tsx +65 -0
  370. package/tests/browser-official-bridge.tsx +152 -0
  371. package/tests/browser-sticky-lanes.tsx +22 -0
  372. package/tests/browser-waiting-clock.tsx +14 -0
  373. package/tests/chat-flow-hook.test.ts +66 -0
  374. package/tests/cloud-gate.test.ts +34 -0
  375. package/tests/context-tool-update.test.ts +33 -0
  376. package/tests/conversation-scroll.test.ts +47 -0
  377. package/tests/deliverables.test.ts +128 -0
  378. package/tests/entry.test.ts +42 -0
  379. package/tests/fixtures/maid-composer-hide.html +31 -0
  380. package/tests/fold-choreography.test.ts +54 -0
  381. package/tests/fold-intensity.test.ts +93 -0
  382. package/tests/footer-precedence.test.ts +129 -0
  383. package/tests/history-word-regression.test.ts +16 -0
  384. package/tests/live-turn.test.ts +218 -0
  385. package/tests/mcp-apps.test.ts +157 -0
  386. package/tests/message-chrome.test.ts +29 -0
  387. package/tests/official-slots.test.ts +112 -0
  388. package/tests/open-file.test.ts +114 -0
  389. package/tests/pending-submission.test.ts +45 -0
  390. package/tests/platform-media.test.ts +23 -0
  391. package/tests/projection.test.ts +184 -0
  392. package/tests/reasoning-follow.test.ts +34 -0
  393. package/tests/settings-copy.test.ts +63 -0
  394. package/tests/skill-status.test.ts +140 -0
  395. package/tests/stock-install.test.ts +58 -0
  396. package/tests/stream-buffer.test.ts +102 -0
  397. package/tests/timeline.test.ts +59 -0
  398. package/tests/tool-diff.test.ts +57 -0
  399. package/tests/waiting-clock.test.ts +83 -0
  400. package/tests/word-timeline.test.ts +146 -0
  401. package/tsconfig.json +11 -0
  402. package/tsdown.config.ts +51 -0
@@ -0,0 +1,65 @@
1
+ # Third-party notices
2
+
3
+ The MIT license in this repository covers original plugin code. It does not
4
+ replace third-party licenses or the Transitions.dev recipe terms below.
5
+
6
+ ## Transitions.dev product-use terms
7
+
8
+ The three free recipes used in this DSH-specific display are Streaming text,
9
+ Thinking states and Reasoning stream, by Jakub Antalik / Transitions.dev.
10
+ They are incorporated into the actual conversation UI, not redistributed as a
11
+ standalone effects collection, template pack or component kit. No Pro assets,
12
+ website fonts, stock images, demo transcript or upstream CLI are included.
13
+
14
+ The upstream [Terms & License](https://transitions.dev/terms.html), last updated
15
+ July 2026 and checked on 2026-08-28, permit use, modification and shipment of
16
+ accessible recipes within personal or commercial products. They prohibit
17
+ republishing the collection or a substantial part as a competing effects
18
+ library, template pack or component kit. The upstream MIT license applies to
19
+ its tooling, **not** to the transition recipes. Retain this notice and consult
20
+ the upstream terms when redistributing or adapting the corresponding motion
21
+ portions of `Reader.module.css`, `motion.tsx` and `word-timeline.ts`.
22
+
23
+ ## DeepSeek Harness native process presentation
24
+
25
+ `src/client/native` copies the native context rows, form-specific context bodies, reference icon and pure tool summary model. `upstream.json` records the source commit and each original hash. The only adaptations are public type imports, relative ESM suffixes and a local icon path. The MIT license below covers these files. No Host, model, SDK, Agent or tool execution source is included or modified.
26
+
27
+ ## DeepSeek Harness Markdown renderer
28
+
29
+ `src/client/markdown` derives from DeepSeek Harness commit `b150a551b8d465e31e418e1b2eaf5e79bbb7d28e`. Changes add source-offset hooks for text leaves, literal HTML, inline code and atomic code-block entry, and keep source-offset keys on finalization. Native CodeBlock is reused through the public package API without changing its content renderer. Original file hashes are recorded in `upstream.json`.
30
+
31
+ MIT License
32
+
33
+ Copyright (c) 2026 DeepSeek
34
+
35
+ Permission is hereby granted, free of charge, to any person obtaining a copy
36
+ of this software and associated documentation files (the "Software"), to deal
37
+ in the Software without restriction, including without limitation the rights
38
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
39
+ copies of the Software, and to permit persons to whom the Software is
40
+ furnished to do so, subject to the following conditions:
41
+
42
+ The above copyright notice and this permission notice shall be included in all
43
+ copies or substantial portions of the Software.
44
+
45
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
46
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
47
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
48
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
49
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
50
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
51
+ SOFTWARE.
52
+
53
+ ## Transitions.dev Streaming text
54
+
55
+ Motion recipe: https://github.com/Jakubantalik/transitions.dev/blob/ef497bb64867ce569689730198fc66f49db56317/cli/free/streaming-text.md
56
+
57
+ Author: Jakub Antalik. The public free recipe is presented for copying into projects. Opacity 0 to 1, blur 1px to 0, 350ms, 60ms gap and cubic-bezier(0.22,1,0.36,1) are used here. The live adapter animates only appended words rather than replaying existing paragraphs. No protected recipes were retrieved and no license for the entire upstream repository is asserted.
58
+
59
+ ## Transitions.dev Thinking states
60
+
61
+ Author: Jakub Antalik. Source: the public [Thinking states recipe](https://github.com/Jakubantalik/transitions.dev/blob/ef497bb64867ce569689730198fc66f49db56317/cli/free/thinking-states.md). The scoped implementation retains its glyph-only `::before` sweep (2 seconds, 400% background), 150ms state transition, 50ms entry gap, 8px travel and 2px blur. DSH semantic colors replace fixed colors; real Host events replace the demo's timed state carousel. Hidden visual copies are excluded from accessibility, and interrupted/off/reduced/background states settle to the current label.
62
+
63
+ ## Transitions.dev Reasoning stream
64
+
65
+ Author: Jakub Antalik. Source: the public [Reasoning stream recipe](https://github.com/Jakubantalik/transitions.dev/blob/ef497bb64867ce569689730198fc66f49db56317/cli/free/reasoning-stream.md). This adaptation retains the 28px viewport mask, 840ms cadence, 500ms cubic-bezier(0.22,1,0.36,1) CSS transform and fixed two-line steps, clamped only at the real transcript's current end. One real text tree replaces the demo's cloned loop. Body and tool phases do not prematurely stop the current step's motion; manual reading receives the painted offset through native scrolling, preserving selection and keyboard access. Bursts never increase the step distance. Reduced motion and closed historical turns remain static.
@@ -0,0 +1,99 @@
1
+ {
2
+ "harnessVersion": "0.1.7-rc.2",
3
+ "hashes": {
4
+ "packages/client/ui-slots/src/index.ts": "27a453937cdcc28923c37ad90cd01489e458e205dc03032629183087b5b585d0",
5
+ "packages/client/ui-slots/src/renderer.ts": "ee834aafc19367922c139d41f677233fbdfcc042b4deff9f616aa43220ee09ee",
6
+ "packages/client/ui-renderer/src/client/registry.ts": "6b8b6b969d8bcf0314ea20438a223f3a90e1bd516571faecae5c3c01008ecf21",
7
+ "packages/client/ui-renderer/src/client/scoped-slots.tsx": "082ebd62a6d287704d116fa1b233f12ab62a91bc6ccccf99d8137b1f33b8d02b",
8
+ "packages/client/ui-chat/src/client/contract/slots.ts": "99071c39ccc88d63505acf4cce7b2cf2a8b4cf5a9856b473e3ef11f8c7c52a7e",
9
+ "packages/client/ui-tool/src/client/contract/slots.ts": "4ae6334ebb0c6a267c13e8b6b504a614d302e77b4080a63408b97f4d25b22a3f",
10
+ "packages/client/ui-deliverables/src/client/Deliverables.tsx": "b8d0a19dc208af7f8f44459adba9afe648cd3c398d75917ccfaf2f8c730cfe74",
11
+ "packages/client/ui-chat/src/client/chat/AssistantMarkdown.tsx": "ac98e943bde17e8f5e7ace6d16d0343297e7cb86da14d066eb6a856cf8363f07",
12
+ "packages/client/ui-chat/src/client/chat/MessageItem.tsx": "ae4f777114bfd175bc7655acdfc0a6356f3de5bf5f4c9df3b1d2d0b27073598d",
13
+ "packages/client/ui-chat/src/client/chat/AssistantNodeView.tsx": "239c8fe1305ede17d3786bfdd61e7e52f3cab30ae548befe172867c52deef388",
14
+ "packages/client/ui-chat/src/client/chat/TurnTailNodeView.tsx": "4b493845e7d28b93a2db2198e70deffcf4b290c31218923fc7c945af737b56d1",
15
+ "packages/client/ui-chat/src/client/chat/TurnProcessNodeView.tsx": "731a879e517c9ff28c7d833863e774745666cffe3a2fd2f9aa3fff1adcbc4a17",
16
+ "packages/client/ui-tool/src/client/tool/models/tool-call-model.ts": "f3d71d4453ba56ba73812126f39f4a720b5fd7bab7ce9ac40c74c15860bb2556",
17
+ "packages/client/ui-primitives/src/markdown/MarkdownText.tsx": "ff500ab71ac6a55df416f84cc1f5900327b9908c5180c4e2b3888377bd417a97",
18
+ "packages/client/ui-primitives/src/markdown/render.tsx": "6e4af631d34ae8c8ea1dbeabd1b4593ee9ff23c3470d2855708b3cf8b84bbca2",
19
+ "packages/client/ui-primitives/src/markdown/parse.ts": "e281b4120306987cce9cf6d8bccfeddec2fe0c7b7b1cc190966f6dcbfd320b1b",
20
+ "packages/client/ui-primitives/src/markdown/incremental.ts": "eaa266bb77dfb646738d0fdd79be4f1c4bc5490f7bf3f4127f9ffb72ef741ff8",
21
+ "packages/client/ui-primitives/src/markdown/katex.tsx": "8227e04d29333d2568021ed012143237b457852bce25d82cf394d72b941e74a5"
22
+ },
23
+ "registrations": [
24
+ "conversation.chat.assistant-actions | feedback | packages/client/ui-message-feedback/src/client/index.ts",
25
+ "conversation.chat.node | assistant-step | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
26
+ "conversation.chat.node | command | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
27
+ "conversation.chat.node | command-input | packages/client/ui-goal/src/client/index.ts",
28
+ "conversation.chat.node | compaction | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
29
+ "conversation.chat.node | context | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
30
+ "conversation.chat.node | manual-compaction | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
31
+ "conversation.chat.node | model-retry | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
32
+ "conversation.chat.node | steering | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
33
+ "conversation.chat.node | system-prompt | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
34
+ "conversation.chat.node | tool-call | packages/client/ui-tool/src/client/apply.ts",
35
+ "conversation.chat.node | turn-error | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
36
+ "conversation.chat.node | turn-max-tokens | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
37
+ "conversation.chat.node | turn-process | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
38
+ "conversation.chat.node | turn-tail | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
39
+ "conversation.chat.node | turn-trigger | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
40
+ "conversation.chat.node | unknown | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
41
+ "conversation.chat.node | user | packages/client/ui-chat/src/client/chat/register-node-renderers.ts",
42
+ "conversation.chat.node | workflow-run | packages/client/ui-workflow-run/src/client/index.ts",
43
+ "conversation.chat.turnTail | (chain/single) | packages/client/ui-plan/src/client/index.ts",
44
+ "conversation.chat.turnTail | @deepseek-ai/dsh-client-ui-deliverables | packages/client/ui-deliverables/src/client/index.ts",
45
+ "conversation.chat.turnTail | schedule-created | packages/client/ui-schedule/src/client/index.ts",
46
+ "conversation.message.images | (chain/single) | packages/client/ui-attachment/src/client/index.ts",
47
+ "tool.call.images | (chain/single) | packages/client/ui-attachment/src/client/index.ts",
48
+ "tool.call.toolview | ask_user_question | packages/client/ui-tool/src/client/tool/toolviews/ask-question-row.tsx",
49
+ "tool.call.toolview | bash | packages/client/ui-tool/src/client/tool/toolviews/bash-sample.tsx",
50
+ "tool.call.toolview | cordis_inspect_list | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
51
+ "tool.call.toolview | cordis_inspect_query | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
52
+ "tool.call.toolview | cordis_inspect_self | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
53
+ "tool.call.toolview | create_goal | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
54
+ "tool.call.toolview | edit | packages/client/ui-tool/src/client/tool/toolviews/file-mutation-row.tsx",
55
+ "tool.call.toolview | get_goal | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
56
+ "tool.call.toolview | glob | packages/client/ui-tool/src/client/tool/toolviews/search-row.tsx",
57
+ "tool.call.toolview | grep | packages/client/ui-tool/src/client/tool/toolviews/search-row.tsx",
58
+ "tool.call.toolview | interrupt_agent | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
59
+ "tool.call.toolview | job_kill | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
60
+ "tool.call.toolview | job_list | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
61
+ "tool.call.toolview | job_output | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
62
+ "tool.call.toolview | list_agents | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
63
+ "tool.call.toolview | list_subagent_models | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
64
+ "tool.call.toolview | lsp | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
65
+ "tool.call.toolview | present | packages/client/ui-deliverables/src/client/index.ts",
66
+ "tool.call.toolview | ralph | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
67
+ "tool.call.toolview | read | packages/client/ui-tool/src/client/tool/toolviews/read-row.tsx",
68
+ "tool.call.toolview | read_image | packages/client/ui-tool/src/client/tool/toolviews/read-image-row.tsx",
69
+ "tool.call.toolview | schedule_create | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
70
+ "tool.call.toolview | schedule_delete | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
71
+ "tool.call.toolview | schedule_list | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
72
+ "tool.call.toolview | schedule_update | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
73
+ "tool.call.toolview | send_message | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
74
+ "tool.call.toolview | session_event_read | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
75
+ "tool.call.toolview | session_event_search | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
76
+ "tool.call.toolview | session_event_trace | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
77
+ "tool.call.toolview | session_search | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
78
+ "tool.call.toolview | session_trace | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
79
+ "tool.call.toolview | skill | packages/client/ui-skill/src/client/index.ts",
80
+ "tool.call.toolview | spawn_teammate | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
81
+ "tool.call.toolview | subagent | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
82
+ "tool.call.toolview | team_task_create | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
83
+ "tool.call.toolview | team_task_get | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
84
+ "tool.call.toolview | team_task_list | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
85
+ "tool.call.toolview | team_task_update | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
86
+ "tool.call.toolview | terminal_close | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
87
+ "tool.call.toolview | terminal_list | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
88
+ "tool.call.toolview | terminal_open | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
89
+ "tool.call.toolview | terminal_read | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
90
+ "tool.call.toolview | terminal_signal | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
91
+ "tool.call.toolview | todo_write | packages/client/ui-tool/src/client/tool/toolviews/todo-row.tsx",
92
+ "tool.call.toolview | update_goal | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
93
+ "tool.call.toolview | wait_agent | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
94
+ "tool.call.toolview | web_fetch | packages/client/ui-tool/src/client/tool/toolviews/web-row.tsx",
95
+ "tool.call.toolview | web_search | packages/client/ui-tool/src/client/tool/toolviews/web-row.tsx",
96
+ "tool.call.toolview | workflow | packages/client/ui-tool/src/client/tool/toolviews/details-row.tsx",
97
+ "tool.call.toolview | write | packages/client/ui-tool/src/client/tool/toolviews/file-mutation-row.tsx"
98
+ ]
99
+ }
@@ -0,0 +1,5 @@
1
+ # Official bundle layer. `dsh plugin add` applies this into the profile.
2
+ # Rows resolve by package name so the installed copy is what boots.
3
+ - insert:
4
+ - id: tidy-display
5
+ name: "dsh-tidy-display"
package/cordis.yml ADDED
@@ -0,0 +1,4 @@
1
+ # Source overlay for local --patch work. Stock install uses cordis.patch.yml.
2
+ - insert:
3
+ - id: tidy-display
4
+ name: './src/dsh-tidy-display.ts'
@@ -0,0 +1,65 @@
1
+ # 官方能力接入说明
2
+
3
+ `0.3.0` 在 `v0.2.1` 的阅读布局上接入官方内容和控件,经过试用验收后发布。当前验收目标是 Harness `0.1.7-rc.2`。`conversation.chat.turnTail` 仍是 `list`。`0.1.7-rc.2` 在这条 list 上新增 `schedule-created`,并新增 `schedule_update` 工具视图;Reader 继续镜像官方注册,不另写这两张卡片。开发者消息里的工具增减行用官方标题和计数,本地 Markdown 图片接受 Desktop 文件路由 `dsh-app://app/api/file`。后续仍需维护的自有展示逻辑和升级边界见下文。
4
+
5
+ ## 一个具体例子
6
+
7
+ 一条回答的持久化 `messageId` 进入 `OfficialActions`,随后进入 Reader 自己的回答操作插槽。里面的反馈组件、状态注入和弹窗控制器来自当前已加载的官方反馈插件。点击按钮后,由官方控制器打开原来的官方弹窗;Reader 不实现反馈请求、类别或状态管理。
8
+
9
+ 工具详情同理:传递 `callId`、原始 `block`、工作目录、Host home、图片加载器、带行号的文件打开操作和轨迹入口,再由官方工具组件呈现。原来只取函数组件、手工传四个参数并模拟点击展开的路径已经移除。
10
+
11
+ ## 代码归属
12
+
13
+ | 模块 | 负责什么 |
14
+ | --- | --- |
15
+ | `official-slots.tsx` | 用公开注册表 API 将官方注册信息映射到 Reader 的独立插槽;保留注入、locale、store、selector 和子插槽。监听贡献增删,逐条挂载和释放。 |
16
+ | `OfficialContent.tsx` | 将回答身份、工具、节点和产物上下文传给官方控件。这里只组合,不处理业务请求。 |
17
+ | `Reader.tsx`、`ToolActivity.tsx` | 原有阅读布局、过程组织、摘要和交互。工具详情里的控件采用官方形式。 |
18
+ | `platform-media.ts` | RC2 的本地媒体 URL 约定;读取授权仍由 Host 文件 API 负责。 |
19
+ | `compat/harness-rc2.json` | 已验收的官方接口、被自有展示覆盖的实现和注册清单基线。 |
20
+
21
+ ## 为什么有插槽映射
22
+
23
+ RC2 的一个子插槽只能有一个声明者,只有声明它的组件能获得相应 `renderSlot` 权限。Reader 不能把官方插槽再声明一次,也不能从 `ctx.slots` 任意渲染子插槽。
24
+
25
+ 本适配用 `spec`、`entriesOfSlot`、`register`、`inject`、`subscribe` 建立 Reader 自己的名字空间,交给同一个官方渲染器运行。组件声明的子插槽名称在一层薄包装中转换,其余属性原样传递。没有私有源码导入,没有修改官方注册对象或官方 DOM,没有复制官方渲染器。现有控件保持组件和注入身份;增加别的控件不会重挂它们。
26
+
27
+ 这仍是 RC2 的受限适配方案。若官方将来提供可直接组合的共享渲染入口,应优先替换这层映射。
28
+
29
+ ## 这版覆盖的能力
30
+
31
+ | 能力 | 处理方式 |
32
+ | --- | --- |
33
+ | 回答操作、反馈 | 官方 `conversation.chat.assistant-actions`,使用持久化 messageId;中断的临时片段不伪造身份。 |
34
+ | 工具详情 | 官方 `tool.call.toolview`,包括 memo、注入状态、翻译和递归子插槽;未注册的工具保留原有结果预览。 |
35
+ | 显式 `present` 产物 | 官方 turnTail 中的文件卡片和菜单,保留官方状态和打开操作。 |
36
+ | 已修改文件快捷操作 | 保持原 Reader 的复制、定位和打开模式;仅从 Reader 的官方 tail 展示参数中排除重复的 produced chips,不改变官方源数据。未知匹配结构原样呈现。 |
37
+ | 文件行号和正文文件链接 | 保留工具传来的行号;正文优先采用官方 file-mention 服务,现有路径匹配作为补充。 |
38
+ | 本地 Markdown 图片 | 和 RC2 相同的同源文件 API,加载失败保留替代文本,危险协议不直接渲染。 |
39
+ | 命令、新节点类型 | 接入官方节点渲染及其子插槽;无可用渲染器时保留记录并提供“在对话中查看”。 |
40
+
41
+ 阅读布局、折叠、逐字动效、阅读速度、默认设置保持现版。移除了未被使用的全局 `body.dataset.readerFolding` 写入。
42
+
43
+ ## 验证与升级
44
+
45
+ 在选定 Harness 运行时上执行:
46
+
47
+ ```sh
48
+ node scripts/link-harness-dependencies.mjs "$DSHX_HARNESS"
49
+ npm run build
50
+ npm test
51
+ npm run test:official
52
+ npm run test:auto-fold
53
+ ```
54
+
55
+ `test:official` 使用测试目标里的真实官方 SlotRegistry、React renderer、反馈插件、ReadRow 和 Deliverables,只有远程业务服务使用内存替身。测试私有源码仅用于验证,不进入交付 bundle。浏览器验证使用本机固定的 Codex Playwright runtime,不附着用户会话。
56
+
57
+ `test:auto-fold` 使用真实 Reader 和独立的全局、会话 store,验证关闭后阅读再开启、此前步骤、设置同步、文本选择及连续切换;分别覆盖普通动画和减少动态效果。
58
+
59
+ `build` 先检查兼容基线。Harness 版本、敏感接口、尚未收敛的官方实现或相关注册清单改变时,构建明确要求审查。审查差异并通过功能与视觉测试后,才可运行 `check-harness-compat.mjs --record` 记录新基线。记录本身不构成兼容证明。
60
+
61
+ ## 后续仍需完成
62
+
63
+ Markdown 定制仍保留逐字动效和 MCP 展示钩子,官方公共组件还没有对应的注入接口。上下文行、部分过程展示和工具摘要也仍有自有实现。本分支先建立官方能力的完整运行路径,后续按视觉基线逐模块收敛这些副本,并拆分 Reader 的阅读策略与动画执行。不能据此承诺所有未来版本零维护,也不承诺任意第三方插件兼容。
64
+
65
+ 已有客户端通过 HMR 更新时,无需新增 Host 或改写会话数据;应先核对实际安装来源、构建产物和同页行为。正式版本保留 Git 标签及发布包,便于按版本安装和回退。
@@ -0,0 +1,21 @@
1
+ # Checklist
2
+
3
+ ## Must Pass
4
+ - [ ] `pnpm typecheck` 零错误;`npm run build` 产物齐全(lib/dsh-tidy-display.js + lib/client.js)
5
+ - [ ] 宿主 0.1.7-rc.2 激活:设置 → 插件出现「Tidy Display」卡(模块 id 三处一致,不重蹈 fork.4 静默失活)
6
+ - [ ] 阅读视图全功能回归:过程/思考/回答渲染、自动折叠、思考衬底、消息气泡、玻璃模式、交付物行、等待时钟、官方工具桥接
7
+ - [ ] 消息轨(阅读视图):横线/圆点两样式渲染正常;鱼眼悬停 + 摘要卡 + 点击跳转 + 滚动当前轮高亮
8
+ - [ ] 消息轨(原生对话视图,如保留):经 `conversation.session.header.utilities` 槽正常渲染
9
+ - [ ] 白色柔光外圈:横线胶囊光斑 / 圆点正圆光斑,当前轮浓悬停轮淡,开关生效
10
+ - [ ] 未加载轮次占位:长会话新开时轨显示 outline 全覆盖占位,点击经 loadThrough 加载后落位为实点,无错位
11
+ - [ ] 末尾插队(steering)会话:圆点数 = DOM 行数,尾部点击不失效
12
+ - [ ] 智能加载更早历史:空闲期自动逐页加载、响应下降自动暂停、手动可续
13
+ - [ ] 诊断报告:轮数口径与轨一致,能生成报告
14
+ - [ ] 官方 TurnNavigator 不再出现(阅读视图),无"双轨并存"
15
+ - [ ] 明暗主题 × 玻璃皮肤:轨配色 auto 跟随正确,柔光在明暗壁纸下均为"半透明光泽"而非硬框
16
+
17
+ ## Should Pass
18
+ - [ ] 长会话(50+ 轮)滚动性能与内存对比双插件方案不劣化(canvas 单轨应更优)
19
+ - [ ] 设置卡:轨配置与 bd 原配置同卡分区展示,volatile 表单即时生效
20
+ - [ ] 老用户迁移:装有 tidychat 的 settings.yaml 键被新插件直接读取(键名未改)
21
+ - [ ] `npm pack` 产物 files 白名单正确,`prepublishOnly` 构建通过
@@ -0,0 +1,24 @@
1
+ # Findings
2
+
3
+ ## 架构决策
4
+ - **底座选 bd fork 的量化依据**:bd client ~6.5k 行(reader/编排/桥接/流式动效),tidychat 需移植面 ~800 行(RailView + 配色链 + autoLoad + 诊断,且彼此独立可整体搬)。反向合并(bd reader 搬进 tidychat)要动 bd 几乎每个文件的 import 与模块缝,工作量 5-10 倍且每步都在拆散 bd 的内聚结构。
5
+ - **单轨融合的数据源分工**:tidychat 轨的「DOM 单一事实源」原则(0.3.1 确立)解决"已加载窗口的精确几何",bd TimelineRail 的「全会话大纲投影」(turnNavigationItems + turnOutline)解决"未加载轮次的可见性与可达性"。两者恰好互补不重叠:身份/几何 = DOM 行;覆盖范围 = outline;未加载占位点击 = bd `loadThrough(seq)`。融合后_tidychat 0.3.1 的"更早历史提示带"升级为完整占位轨。
6
+ - **冲突消除机制(相对双插件方案的构造性差异)**:轨与行渲染同仓库同模块,行数据可直接走 React props/store(bd 的 `useChat` 快照),不必再依赖 DOM 查询做主链路——DOM 锚点降级为「对外兼容面」而非「自己的事实源」。这是缝合比契约修复更彻底的根本原因。
7
+ - **drop 首次引导/接管开关的连带简化**:tidychat 的 `applyOfficialNavTakeover`、`navGuideSeen`、官方轨探测(officialRailPresent)全部可删;CSS 里接管规则段删除;`navGuideSeen` 配置键废弃(保留无害,直接不注册)。
8
+
9
+ ## 技术选型
10
+ - **轨组件移植方式 = 文件级搬运 + 依赖注入**:RailView 的依赖面是 `railRows()`、`config`、`jumpTo` 的滚动实现、`props.sessionId`。搬进 bd 后:行采集用 bd 已有的锚点契约 DOM 查询(原生视图)/直接 props(阅读视图);滚动跳转在阅读视图改用 bd 的 `landTurn/scrollerOf`(已处理吸底 composer 的边界),原生视图保留 tidychat 原 `smoothScrollTo`。
11
+ - **配置注册**:0.1.7 declarative volatile schema(schemastery `.volatile()`)+ `configForms.get('tidy-display')` 客户端缝,模式照抄 tidychat release/0.1.7 的 ac6dc59 实现(已验证可用);bd 的 `dsh.reader.v1` store 不动(气泡/玻璃/autoFold 继续走它),两套配置各管各域,设置卡 UI 合并展示。
12
+ - **autoLoad Governor**:tidychat 的软预算时间制(isGovernorBusy/scheduleNext/loadOnePage)整体搬,`loadOnePage` 改调 bd reader 的 `props.loadOlder()`;"轨道刷新"通知改为 React state 而非自研 notify。
13
+
14
+ ## 约束与依赖
15
+ - `refer-dsh-tidy-display` 工作区有未提交改动(锚点+衬底+模块 id+泡泡基线)——Phase A 第一步是把它 commit 到 `feat/message-bubbles` 或新分支,合并项目的拷贝以该提交为起点
16
+ - bd 的 `check-harness-compat` 升级门需要 Harness 源码检出(`~/.config/dshx/harness` 或 `DSHX_HARNESS`)——本机没有,构建时跳过该门(与本次部署同策略),但 CI/发版机需要配
17
+ - tidychat 仓库 node_modules 曾因跨机拷贝损坏(软链拍平、ansis 解析失败)——新项目一律 `git clone`/`pnpm install` 全新生成,禁止拷贝 node_modules
18
+ - npm 名 `@drscrewdriver/dsh-tidy-display` 未被占用(与本决策相关的生态名可用性已按命名习惯判断,发布前 `npm view` 复核一次)
19
+
20
+ ## 风险识别
21
+ - **上游漂移**:aa2246740 的 bd 每个 Harness rc 都在快速迭代(0.3.0→0.3.3 四天)。合并项目以后每个 rc 需自行适配——这是本方案最大的长期成本(用户已知情并选择)。缓解:保持 bd 源文件结构不重排,方便 `git diff` 式跟进上游。
22
+ - **outline 占位与 DOM 行的双源一致性**:占位(未加载)与实点(已加载)在同一轨上共存,切换会话/加载后需要精确对账——采用「outline 只提供覆盖范围与 turn 序号,实点身份永远以 DOM 行为准,占位数量 = outline 总数 − DOM 行数」的派生式对账,避免重蹈 0.3.1 前的"双源错位"覆辙(RAIL-ROOT-CAUSE §6/§7)。
23
+ - **原生对话视图的轨去留**:合并项目主路径是阅读视图;若保留原生视图可达(宿主切换),轨的双挂载点都要维护。Phase B 完成后实测决定:若原生视图轨维护成本高,可降级为「阅读视图专精」,原生视图不渲染轨(删 utilities 槽注册)。
24
+ - **工作量**:Phase B 的 outline 融合是最大不确定点(需要动 useChat 投影层),预留了独立 phase;总体估 3-5 个工作日。
@@ -0,0 +1,61 @@
1
+ # Spec: dsh-tidy-display —— tidychat × tidy-display 合并项目(DSH 0.1.7 基准)
2
+
3
+ ## 需求
4
+
5
+ 以 **DSH 0.1.7-rc.2** 为唯一目标宿主,把 `dsh-tidychat` 与 `dsh-tidy-display`(fork)缝合为一个插件 **`dsh-tidy-display`**(npm: `@drscrewdriver/dsh-tidy-display`),整合双方 UI 优点,构造性消除两插件的 DOM 契约冲突。
6
+
7
+ **保留的功能(合并后全量)**:
8
+ - 来自 tidy-display(主体):阅读视图(过程/思考/最终回答渲染)、自动折叠与过程编排、消息气泡(半透明底)+ 玻璃模式、推理思考衬底(本轮新增)、交付物行、官方桥接(工具/反馈/turnTail)、设置分区、mcp-app、等待时钟等全部现有能力
9
+ - 来自 tidychat(移植):canvas 消息轨(鱼眼悬停、拖动预览、点击跳转、当前轮高亮、摘要卡)、白色柔光外圈(navRing)、横线/圆点样式、左/右贴边镜像、配色链(自动/调色盘)、智能加载更早历史(autoLoad Governor)、诊断报告
10
+ - 锚点契约修复(PR aa2246740/dsh-tidy-display#41 的等价改动)作为内部事实随合并携带
11
+
12
+ **明确丢弃(及理由)**:
13
+ - tidychat 折叠 / 分隔线手术 → bd auto-fold 已覆盖且更优;两套 DOM 手术必然打架
14
+ - 首次引导(双轨二选一向导)→ 单插件无双轨困惑
15
+ - 「接管官方消息轨」开关 → 阅读视图不渲染官方 TurnNavigator,接管语义自然消失;原生对话视图兼容问题随之不存在(合并后只走阅读视图一条渲染路径)
16
+ - tidychat 的 0.1.2~0.1.6 兼容层(installSettingsSection 双路径、legacy 线)→ 锁定 0.1.7
17
+
18
+ ## 技术方案
19
+
20
+ ### 底座与代码起点
21
+ - **底座 = tidy-display fork**(`refer-dsh-tidy-display` @ `feat/message-bubbles`,含锚点修复、思考衬底、模块 id 钉死)。理由:reader 6.5k 行是复杂度主体且持续跟 rc 演化;tidychat 需要移植的只有 ~800 行(轨组件+配色链+autoLoad+诊断)
22
+ - tidychat 侧以 `release/0.1.7`(b38c26e + 白色柔光改动)为移植源
23
+
24
+ ### 架构
25
+ ```
26
+ dsh-tidy-display/
27
+ ├─ src/dsh-tidy-display.ts # host 半(bd 原 host 半 + 声明式 volatile schema 并入轨配置)
28
+ ├─ src/client/
29
+ │ ├─ index.tsx # bd 客户端入口(原样)
30
+ │ ├─ Reader.tsx / Blocks / ... # 阅读视图全家(原样,含锚点契约行)
31
+ │ ├─ TimelineRail.tsx # 【移除】——由移植的 canvas 轨接替(见下)
32
+ │ ├─ rail/ # 【新】tidychat 轨移植包
33
+ │ │ ├─ RailView.tsx # canvas 轨组件(鱼眼/命中/跳转/tip/柔光外圈)
34
+ │ │ ├─ colors.ts # 配色链(parseRgba/contrastRatio/resolveNavColors/applyNavColors)
35
+ │ │ └─ outline.ts # 【新】bd 大纲数据 → 轨数据源适配(含未加载轮占位)
36
+ │ ├─ autoload.ts # autoLoad Governor(对接 reader 的 loadOlder/loadThrough)
37
+ │ └─ diagnostics.ts # 诊断报告(口径统一走行采集 helper)
38
+ └─ ...
39
+ ```
40
+
41
+ ### 关键设计
42
+ 1. **单轨融合**:tidychat canvas 轨为唯一轨渲染器;吸收 bd `TimelineRail` 的数据源 `mergeTimelineItems(turnNavigationItems, turnOutline, turnsWithDeliverables)`——已加载窗口用 DOM 行(DOM 单一事实源,精确几何/跳转),未加载轮次用 outline 占位标记(点击走 `loadThrough` 加载后落位)。bd TimelineRail 组件移除。
43
+ 2. **双视图下轨都可用**:阅读视图内轨挂 reader 内部(替代 TimelineRail 位);保留原生对话视图路径时轨继续走 `conversation.session.header.utilities` 槽(现有代码原样)。
44
+ 3. **配置合并**:轨配置(navigator/navSide/navStyle/navRing/配色五项/autoLoad)以声明式 volatile schema 并入(0.1.7 configForms 自动成表),与 bd 的 `dsh.reader.v1` prefs 并存但统一进一张「Tidy Display」设置卡;键名沿用 tidychat 已发布键,老用户 settings.yaml 迁移零成本。
45
+ 4. **锚点契约**:行级 `data-chat-anchor-key`/`data-chat-flow-kind` 内部自带(本会话已改);对外仍保留——将来第三方插件同样受益。
46
+
47
+ ## 决策记录
48
+ | 选项 | 选择 | 理由 |
49
+ |---|---|---|
50
+ | 底座 bd vs tidychat | bd fork | reader 是复杂度主体(6.5k vs 2k)且需持续跟宿主 rc;tidychat 移植面小且功能独立(轨/配色/自动加载可整体搬) |
51
+ | 单轨 vs 双轨 | 单轨融合 | 合并的初衷就是消冲突;canvas 轨渲染能力(鱼眼/命中/柔光)+ bd 大纲数据(全会话覆盖含未加载)互补,TimelineRail 无存在必要 |
52
+ | tidychat 折叠/分隔线 | 丢弃 | bd auto-fold 覆盖;双手术必打架(会话内已论证) |
53
+ | 0.1.7 以下兼容 | 丢弃 | 用户明确以 0.1.7 为基准;砍掉双 API 注册/legacy 线减一半维护面 |
54
+ | 与 PR #41 的关系 | 不阻塞 | 上游合并→fork 基更干净;不合并→合并项目内部已自带修复,无影响 |
55
+
56
+ ## 约束
57
+ - 禁止硬编码 CSS Module hash 类名(两边共同的设计红线)
58
+ - 模块 id / bundle id / 包名三处必须一致为 `@drscrewdriver/dsh-tidy-display`(本轮部署踩过的坑,源码钉死)
59
+ - peer range 锁 `>=0.1.7-rc.1 <0.1.8`;`compat/harness-rc2.json` 升级门保留
60
+ - 主题颜色只跟随 DSW 语义 token + 保守兜底原则(tidychat HANDOVER 原则 1)继续有效
61
+ - lib/ 产物照旧入库(bd 既有约定)
@@ -0,0 +1,34 @@
1
+ # Tasks
2
+
3
+ ## Phase 0: 前置收口(依赖当前会话工作)
4
+ - [ ] task_0.1: `refer-dsh-tidy-display` 工作区改动(锚点+思考衬底+模块 id)commit 到 `feat/message-bubbles`;spec/findings/checklist/tasks 四件套一并入库或按用户意愿忽略
5
+ - [ ] task_0.2: 确认 tidychat 白色柔光改动 commit 到 `release/0.1.7`(移植源需可检出)
6
+
7
+ ## Phase 1: 项目骨架与身份(约半天)
8
+ - [ ] task_1.1: `git clone` 方式初始化 `dsh-tidy-display/`(拷贝 refer-dsh-tidy-display 内容,**排除** node_modules、lib.backup-*、*.md 规划件);`git init` + 首提交
9
+ - [ ] task_1.2: 全局改名 `dsh-tidy-display` → `dsh-tidy-display`:package.json(name `@drscrewdriver/dsh-tidy-display`、version 0.3.3-fork.6 起线)、`src/dsh-tidy-display.ts`(原 dsh-tidy-display.ts)的 `export const name`、tsdown.config.ts 入口名与 config.name 匹配串、cordis.yml/cordis.patch.yml、settings 分区 id 与标题「Tidy Display」
10
+ - [ ] task_1.3: `pnpm install`(全新生成 node_modules,禁止拷贝);typecheck + build 通过
11
+ - [ ] task_1.4: 部署 profile 冒烟:宿主激活、设置分区出现、阅读页签正常(模块 id 链无断裂)
12
+
13
+ ## Phase 2: 移植 canvas 消息轨(1-2 天,核心)
14
+ - [ ] task_2.1: 从 tidychat `release/0.1.7` 提取 RailView 组件整体(measurePos/layoutPositions/indexAt/jumpTo/detectCurrent/tip/指针 rAF 节流/whiteSheen 柔光外圈/横线圆点分支)→ `src/client/rail/RailView.tsx`,依赖注入化(config、rowsProvider、scrollJump、sessionId 由 props 传入)
15
+ - [ ] task_2.2: 提取颜色链(parseRgba/parseRgb/findBackgroundRgb/isDarkBackground/contrastRatio/resolveNavColors/applyNavColors/applyTipContrast)→ `src/client/rail/colors.ts`(保留 DSW token 跟随 + 保守兜底原则)
16
+ - [ ] task_2.3: 行事实源对接:阅读视图直接用组件内 DOM 查询(锚点契约已在行上);`railRows()` 保留 user+steering 同视与 data-reader-key 回退(健壮性)
17
+ - [ ] task_2.4: 跳转对接:阅读视图跳转改用 bd `landTurn/scrollerOf`;原生对话视图保留原 `smoothScrollTo`
18
+ - [ ] task_2.5: 原生视图挂载点:utilities 槽注册原样保留(RailView 复用);阅读视图挂载:Reader.tsx 移除 `<TimelineRail>` 挂 `<RailView>`
19
+ - [ ] task_2.6: `rail/outline.ts`:移植 bd TimelineRail 的 `mergeTimelineItems(turnNavigationItems, turnOutline, turnsWithDeliverables)` 数据源;派生式对账(占位数 = outline 总数 − DOM 行数;占位点击 → `props.loadThrough(seq)`;实点身份永远以 DOM 行为准)
20
+ - [ ] task_2.7: 移除 TimelineRail.tsx 及其 CSS/preview 逻辑;轨布局让位(reader 列右缘 padding 调整)
21
+ - [ ] task_2.8: 部署实测:两视图轨渲染、样式矩阵(横线/圆点 × 左/右 × 柔光开关)目检
22
+
23
+ ## Phase 3: 其余 tidychat 功能(约 1 天)
24
+ - [ ] task_3.1: `src/client/autoload.ts`:移植 autoLoad Governor(isGovernorBusy/scheduleNext/loadOnePage 软预算时间制),loadOnePage 对接 reader `props.loadOlder()`;设置开关并入声明式 schema
25
+ - [ ] task_3.2: `src/client/diagnostics.ts`:移植 detectIssues/buildReport/一键 issue;口径改走统一行采集 helper;现象标签裁剪为「定位条异常/自动加载异常」
26
+ - [ ] task_3.3: 声明式配置 schema:navigator/navSide/navStyle/navRing/navColor*/navAccent*/autoLoad 以 `.volatile()` 注册(键名沿用 tidychat 已发布键,老 settings.yaml 零迁移);与 bd prefs 在设置卡合并分区展示
27
+ - [ ] task_3.4: 删除 tidychat 遗留:fold/divider 手术、首次引导(navGuideSeen)、applyOfficialNavTakeover 及接管 CSS 段、legacy settings API 路径
28
+
29
+ ## Phase 4: 验证与发布(约 1 天)
30
+ - [ ] task_4.1: checklist.md Must Pass 全量过(两视图 × 样式矩阵 × 明暗 × 玻璃皮肤)
31
+ - [ ] task_4.2: 长会话性能三态对比(确认单轨优于双插件)
32
+ - [ ] task_4.3: README/README.en/CHANGELOG 新写(新身份、0.1.7 基准、与 tidychat/bd 的关系与致谢)
33
+ - [ ] task_4.4: `npm view @drscrewdriver/dsh-tidy-display` 确认名字可用 → version 0.1.0 → tag → GitHub release → `npm publish --access public`
34
+ - [ ] task_4.5: tidychat 与 bd fork 的 README 互加「已合并至 dsh-tidy-display」指引;PR #41 保持跟踪(上游合并后可减一条内部差异)
package/dshx.yml ADDED
@@ -0,0 +1,5 @@
1
+ id: dsh-tidy-display
2
+ entry: src/dsh-tidy-display.ts
3
+ marker: '[my-plugins/dsh-tidy-display] loaded'
4
+ kind: client
5
+ profile: web