@seekbuddy/dsh-ui 0.2.0-beta.0 → 0.2.0-beta.1

package/CHANGELOG.md

@@ -8,6 +8,39 @@ breaking changes; they are listed under **Breaking**.
 Upstream DSH synchronizations are recorded with the DSH tag they move to; the full list of local
 changes to the DSH layer lives in [UPSTREAM.md](UPSTREAM.md).
 
+## [0.2.0-beta.1] - 2026-11-05
+
+DSH layer synchronized with `dsh-v0.2.2-rc.1` (from `dsh-v0.2.0-rc.2`).
+
+### Breaking
+
+- `projectUserText` and `UserTextReferences` are removed upstream. Split the text yourself and render
+  the pieces with the new `UserTextRun` and `ReferenceChip`.
+- `TerminalBlockLabels` requires `commandLine: (line: number) => string`, the accessible name of a
+  command line that overflows horizontally.
+- `MarkdownDelegate.fileImages` requires `fileDrag: FileDragActions`.
+- `Tooltip` now injects `onPointerEnter` / `onPointerLeave` / `onPointerDown` into its trigger child
+  instead of `onMouseEnter` / `onMouseLeave`.
+- The token `--dsw-specific-sidebar-nav-item-hover` is removed.
+
+### Added
+
+- From upstream, on the root entry: `UserMessageBubble`, `UserTextRun`, `ReferenceChip`, `AnimatedRows`,
+  `useRowDragPreview`, `ZoomControls`, `DOCUMENT_ZOOM`, `InlineEditor`, `HoverCardGroup`,
+  `DraggableImage` and the `FileDragActions` types, `useClipboardCopy`, `QuotePreview`,
+  `isMobileDevice`, `MENU_TRANSITION_MS`. On `/blocks`: `CommandText`. On `/markdown`:
+  `DetailDocument`, `detailDocumentState`, `useDetailDocumentLabels`, `useMarkdownDelegate`,
+  `MarkdownMenuTarget`, `formatQuoteText`. On `/icons`: `ICON_SYMBOLS`, `IconAppsAdd*`,
+  `IconDragHandle*`, `IconSave*`, `PermissionIconAutoReview*`.
+- New optional props from upstream on `Menu`, `HoverCard`, `SegmentedTabs`, `TerminalBlock`, `Tooltip`,
+  `MarkdownText`, `DisclosureRow`, `ImageLightbox` and `MarkdownDelegateProvider`; see UPSTREAM.md.
+- Tokens `--dsw-alias-illustration-*` (six) and `--dsw-alias-state-done-primary`.
+- Storybook pages for every new export.
+
+### Changed
+
+- `@deepseek-ai/dsh-util-code-language` is pinned to `0.2.2-rc.1`.
+
 ## [0.2.0-beta.0] - 2026-10-09
 
 First release under the name `@seekbuddy/dsh-ui`. DSH layer synchronized with `dsh-v0.2.0-rc.2`.
@@ -46,4 +79,5 @@ First release under the name `@seekbuddy/dsh-ui`. DSH layer synchronized with `d
   server` warning during React 18 server rendering. The markup is correct; the popover position is
   computed on the client.
 
+[0.2.0-beta.1]: https://github.com/seekbuddy/dsh-ui/releases/tag/v0.2.0-beta.1
 [0.2.0-beta.0]: https://github.com/seekbuddy/dsh-ui/releases/tag/v0.2.0-beta.0

package/README.md

@@ -77,7 +77,7 @@ Import only from these entries; anything else under `dist/` is internal.
 | `@seekbuddy/dsh-ui` | Lightweight controls and utilities: `Button`, `Input`, `Pill`, `Tag`, `Switch`, `Checkbox`, `Menu`, `MenuSurface`, `Modal`, `Tooltip`, `Toast`, `HoverCard`, `SegmentedControl`, `SegmentedTabs`, positioning / modal hooks, and helpers such as `relativeTime`, `fileSizeText`, `rankByName` |
 | `@seekbuddy/dsh-ui/blocks` | Tool-output renderers `TerminalBlock`, `ReadBlock`, `DiffBlock`, `SearchBlock`, `WebBlock`, `JsonTree`; file / link icons `FileTypeIcon`, `LinkIconRegular` / `LinkIconMedium`; code highlighting `languageForPath`, `useCodeHighlighter` (loads Shiki) |
 | `@seekbuddy/dsh-ui/markdown` | `MarkdownText`, `CodeBlock`, `JsonBlock`, `MarkdownDelegateProvider`, `extractMarkdownPlainText` |
-| `@seekbuddy/dsh-ui/icons` | 188 `Icon*` components (94 glyphs × `Regular` / `Medium` stroke), `PermissionIcon*`, `ReferenceIcon*`, `PluginArtwork*`, `GuideArtwork*` |
+| `@seekbuddy/dsh-ui/icons` | 194 `Icon*` components (97 glyphs × `Regular` / `Medium` stroke), `PermissionIcon*`, `ReferenceIcon*`, `PluginArtwork*`, `GuideArtwork*` |
 | `@seekbuddy/dsh-ui/theme` | Theme state, DOM application and React hooks |
 | `@seekbuddy/dsh-ui/theme/bootstrap` | `THEME_BOOTSTRAP_SCRIPT`, an inline script with no React dependency |
 | `@seekbuddy/dsh-ui/seekbuddy` | Extra components ([docs](docs/components/README.md)); the whole entry is a Client Component |

package/README.zh.md

@@ -77,7 +77,7 @@ export function Example() {
 | `@seekbuddy/dsh-ui` | 轻量控件与工具：`Button`、`Input`、`Pill`、`Tag`、`Switch`、`Checkbox`、`Menu`、`MenuSurface`、`Modal`、`Tooltip`、`Toast`、`HoverCard`、`SegmentedControl`、`SegmentedTabs`、定位与模态 Hooks，以及 `relativeTime`、`fileSizeText`、`rankByName` 等工具函数 |
 | `@seekbuddy/dsh-ui/blocks` | 工具输出渲染器 `TerminalBlock`、`ReadBlock`、`DiffBlock`、`SearchBlock`、`WebBlock`、`JsonTree`；文件 / 链接图标 `FileTypeIcon`、`LinkIconRegular` / `LinkIconMedium`；代码高亮 `languageForPath`、`useCodeHighlighter`（会加载 Shiki） |
 | `@seekbuddy/dsh-ui/markdown` | `MarkdownText`、`CodeBlock`、`JsonBlock`、`MarkdownDelegateProvider`、`extractMarkdownPlainText` |
-| `@seekbuddy/dsh-ui/icons` | 188 个 `Icon*`（94 个图形 × `Regular` / `Medium` 两档描边）、`PermissionIcon*`、`ReferenceIcon*`、`PluginArtwork*`、`GuideArtwork*` |
+| `@seekbuddy/dsh-ui/icons` | 194 个 `Icon*`（97 个图形 × `Regular` / `Medium` 两档描边）、`PermissionIcon*`、`ReferenceIcon*`、`PluginArtwork*`、`GuideArtwork*` |
 | `@seekbuddy/dsh-ui/theme` | 主题状态、DOM 应用函数与 React Hooks |
 | `@seekbuddy/dsh-ui/theme/bootstrap` | `THEME_BOOTSTRAP_SCRIPT`，不依赖 React 的首屏内联脚本 |
 | `@seekbuddy/dsh-ui/seekbuddy` | 扩展组件（[文档](docs/components/README.zh.md)）；整个入口是 Client Component |

package/THIRD_PARTY_NOTICES.md

@@ -10,7 +10,7 @@ Everything under `src/` except `src/seekbuddy/` is a copy of the DeepSeek Harnes
 theme sheets, with the local adaptations listed in `UPSTREAM.md`.
 
 - Upstream repository: https://github.com/deepseek-ai/deepseek-harness
-- Tag: `dsh-v0.2.0-rc.2`, commit `639ed015397290b3745d163aafe02ffee4aa3f84`
+- Tag: `dsh-v0.2.2-rc.1`, commit `66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db`
 - `packages/client/ui-primitives/src` → `src/` (components, CSS Modules, icons, Markdown renderer)
 - `packages/client/ui-theme/src/styles` → `src/styles/` (`base.css`, `corner-shape.css`,
   `design-platform.css`, `focus.css`, `onboarding.css`, `scrollbar.css`, `gradient-shadow-text.css`,

package/UPSTREAM.md

@@ -1,12 +1,14 @@
 # Upstream synchronization
 
-- Tag: `dsh-v0.2.0-rc.2`
-- Commit: `639ed015397290b3745d163aafe02ffee4aa3f84`
+- Tag: `dsh-v0.2.2-rc.1`
+- Commit: `66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db`
 - Primitives source: `packages/client/ui-primitives/src`
 - Theme source: `packages/client/ui-theme/src/styles`
 
 The TypeScript, CSS Modules, and eight theme sheets are synchronized from those paths. No `src/invariant.ts` is copied because the upstream no longer publishes a Cordis invariant companion.
 
+> Baseline advanced `dsh-v0.2.0-rc.2` → `dsh-v0.2.2-rc.1` (2026-11-05), after the host moved to dsh `0.2.2-rc.1`. Upstream changed 82 mirrored files (26 added, `use-copy-feedback.ts` removed, 55 modified) and four theme sheets (`base.css`, `design-platform.css`, `gradient-shadow-text.css`, `scrollbar.css`). Breaking: `projectUserText` / `UserTextReferences` are removed in favour of caller-split `UserTextRun` + `ReferenceChip`; `TerminalBlockLabels` requires `commandLine(line)`; `MarkdownDelegate.fileImages` requires `fileDrag: FileDragActions`; the props `Tooltip` injects into its trigger child are now `onPointerEnter` / `onPointerLeave` / `onPointerDown` instead of `onMouseEnter` / `onMouseLeave`; `--dsw-specific-sidebar-nav-item-hover` is gone. New: `UserMessageBubble`, `AnimatedRows`, `useRowDragPreview`, `ZoomControls` + `DOCUMENT_ZOOM`, `InlineEditor`, `HoverCardGroup` (with `HoverCard` `grouped` / `fitContent`), `DraggableImage` + the `FileDragActions` types, `useClipboardCopy`, `QuotePreview`, `isMobileDevice`, `MENU_TRANSITION_MS`, `CommandText`, `DetailDocument` + `detailDocumentState` / `useDetailDocumentLabels`, `useMarkdownDelegate`, `MarkdownMenuTarget`, `formatQuoteText`, `ICON_SYMBOLS`, glyphs `IconAppsAdd*` / `IconDragHandle*` / `IconSave*`, `PermissionIconAutoReview*` (215 icon-entry exports); `Menu` gains `contextual` / `exiting` / `returnFocus` / `minWidthFromAnchor` and items `current` / `disabledReason`, `SegmentedTabs` `size`, `TerminalBlock` `background`, `Tooltip` `onlyWhenClipped`, `MarkdownText` `omitHtml` / `textInteractionSource`, `DisclosureRow` `headerAccessory`, `ImageLightbox` `contextMenuProps`, `MarkdownDelegateProvider` `getTriggerProps`. Tokens: +7 `--dsw-alias-*` (six `illustration-*` and `state-done-primary`), +5 static steps. Merged three-way as before (Prettier `printWidth: 120`, no semicolons, single quotes, trailing commas normalised rc.2 → 0.2.2-rc.1 applied onto the local copy); the only conflicts were `index.ts` (our entry split) and `Tooltip.tsx`'s import line (our context guard).
+>
 > Baseline advanced `dsh-v0.1.7-rc.2` → `dsh-v0.2.0-rc.2` (2026-10-01), after the host's `@deepseek-ai/dsh-client-ui-primitives` moved to `0.2.0-rc.2`. A small step: 18 mirrored files changed, 2 added (`MenuGroup.*`), none removed; the eight theme sheets keep their order. New: `MenuGroup` + `observeStickyMenuGroups` (named menu sections with sticky headings) and the root export of `pointerModality`. Changed: `TextShimmer` is re-implemented as a masked decorative copy tinted by `--dsw-alias-label-shimmer` — `children` widens from `string` to `ReactNode`, `active` becomes optional, `contentClassName` is new, and nested instances share the outer sweep; `DisclosureRow` wraps its title and collapsed content in one shimmer (new `contentClassName` / `contentLayoutClassName`) and its row colour now drives the title (tertiary, secondary on hover); `Input` forwards its ref; `Tooltip` gains `openOnClick` (pinned, pointer-enterable bubble, outside-pointer dismissal), `focusDelayMs` and `aria-describedby` wiring; `useAnchoredPosition` and `overlay-top-margin` clear the frame strip by 20px and ignore it in fullscreen; `Menu` / `Modal` read `--dsh-frame-overlay-top` instead of `--dsh-frame-top-clearance` and the Modal mask starts below `--dsh-frame-chrome-top`; the unchecked upstream `Switch` thumb takes `--dsw-alias-switch-thumb`; two plugin-artwork colours changed. Tokens: +8 `--dsw-alias-*` (107 total: `bg-document-selection`, `label-deep-diving`, `label-deep-diving-shimmer`, `label-shimmer`, `switch-thumb`, `turn-trigger-bg`, `turn-trigger-bg-hover`, `menu-group-header-fill`); content font size range widens to 10–22px (comment only). Merged three-way as before; the only conflict was `Tooltip.tsx`'s import line (our context guard).
 >
 > Baseline advanced `dsh-v0.1.7-rc.1` → `dsh-v0.1.7-rc.2` (2026-09-25), the day after the host's `@deepseek-ai/dsh-client-ui-primitives` moved to `0.1.7-rc.2`. Upstream changed 46 mirrored files (9 primitives added, `OnboardingSurface.*` removed) and the theme sheets, which grew from six to eight (`focus.css`, `onboarding.css`). Visual: every hard-coded radius became a `--dsw-radius-xs/sm/md/lg/xl/panel` token (Button 18px → 12px, Toast 14 → 16, Modal 24 → 28), focus rings read `--dsw-focus-ring-width/color` and hide under `html[data-input-modality='pointer']`, `--dsw-mask-blur` is `none`, and menus paint through the new `MenuSurface` (`--dsw-menu-surface-fill`, opaque backing on macOS). New: `MenuSurface`, `ShortcutKeys` (also `Menu` item `shortcut` and `Tooltip` `shortcutKeys`), `useModalLayer` + `closeTopModal` / `isBehindModal` / `modalSelector` (now inside `Modal`: focus trap, `data-modal-autofocus`, return focus, `backdropBlur`), `focusWithoutRing`, `observeComposition`, `GuideArtworkBrowser` / `GuideArtworkFiles`, glyph `IconArchiveOff*` (188 icon exports). Tokens: +9 `--dsw-alias-*` (99 total). The mirror was merged three-way (Prettier-normalised rc.1 → rc.2 applied onto the local copy); the only conflicts were `index.ts` (our entry split) and `Tooltip.tsx` (our context guard), resolved below. The extension layer's own hard-coded radii were replaced with the same `--dsw-radius-*` tokens in the same wave, and its focus rings now declare only `outline-style: solid`, taking width and colour from `focus.css`'s global `:focus-visible` rule (so pointer-modality hiding applies to them too), so it keeps tracking the host.
@@ -30,12 +32,13 @@ Local packaging adaptations:
 - `MessageText` was removed upstream in rc.2 (`d0da8ccf40`); the `markdown` entry drops it too — a breaking change for 0.2.0 consumers of the standalone package.
 - `code-file-icon-artwork.manifest.json` is copied as the upstream design record; no source imports it.
 - `Tooltip` creates its suppression context only where React provides `createContext` (0.1.7): the `react-server` build has none, and a Server Component evaluates `Tooltip.tsx` through the root entry because the server-safe `Empty` imports `Button` from it. Upstream's module-level `createContext` call failed the `next16` fixture with `createContext is not a function`. Tooltip only renders on the client, so behaviour is unchanged. Since rc.2 upstream exports `TooltipSuppression` (HoverCard consumes it); the export is kept, still behind the guard. `TextShimmer`'s `DecorativeCopy` context (0.2.0) is created behind the same guard for the same reason: `DisclosureRow` pulls it into the root entry.
-- Upstream exports `CodeToolbarLabels`, `CODE_HIGHLIGHT_EXTENSIONS`, `languageForPath`, `useCodeHighlighter` (and their types) from its root; they live in `blocks` here because they reach the Shiki highlighter, which `assertLightweightRoot` keeps off the root. `MarkdownDelegateProvider` and its types go to `markdown`; `PermissionIcon*`, `ReferenceIcon*`, `PluginArtwork*` and (rc.2) `GuideArtwork*` go to `icons`; `LinkIcon*` stays in `blocks` with the rest of the file/link family. `MenuSurface`, `ShortcutKeys`, `useModalLayer` and the focus / composition helpers stay on the root as upstream has them.
+- Upstream exports `CodeToolbarLabels`, `CODE_HIGHLIGHT_EXTENSIONS`, `languageForPath`, `useCodeHighlighter` (and their types) from its root; they live in `blocks` here because they reach the Shiki highlighter, which `assertLightweightRoot` keeps off the root. `MarkdownDelegateProvider` and its types go to `markdown`; `PermissionIcon*`, `ReferenceIcon*`, `PluginArtwork*` and (rc.2) `GuideArtwork*` go to `icons`; `LinkIcon*` stays in `blocks` with the rest of the file/link family. `MenuSurface`, `ShortcutKeys`, `useModalLayer` and the focus / composition helpers stay on the root as upstream has them. Since 0.2.2-rc.1: `CommandText` goes to `blocks` with `TerminalBlock`; `DetailDocument` (it renders `MarkdownText`), `detailDocumentState`, `useDetailDocumentLabels`, `useMarkdownDelegate`, `MarkdownMenuTarget` and `formatQuoteText` (it lives under `src/markdown/`, which `assertLightweightRoot` keeps off the root) go to `markdown`; `PermissionIconAutoReview*` goes to `icons`; the other new exports stay on the root.
 - Not mirrored: `PathLabel.*` and `settings-form/` (`SettingsForm`, `SettingsSecretField`, `SettingsValueField`, `SettingsFormModel`, `settingsNumberField`, `settingsTextField` and their types). They import `@deepseek-ai/dsh-util-workspace-path` and `@deepseek-ai/dsh-client-store` (zustand + immer, Cordis peer), which this Cordis-free standalone package does not take on; nothing here consumes them. Revisit when a consumer appears.
 - Not mirrored: `ui-theme`'s opt-in `brand-font.css` with its three Montserrat woff2 files and OFL text. It is not one of the six theme sheets (upstream's `installThemeStyles` does not load it either); only the desktop welcome page uses it.
 - Not mirrored: `BrandWordmark.tsx` and `FishLogo.tsx` (with `FISH_LOGO_PATH` / `FISH_LOGO_VIEWBOX`). They draw DeepSeek's wordmark and logo; MIT licenses the code, not the trademarks, so this public package ships no DeepSeek brand assets. Drop both files again on every sync.
+- `file-drag-actions.ts` declares `DragFileName` itself instead of `import type`-ing it from `@deepseek-ai/dsh-util-file-drag` (0.2.2-rc.1), which has a Cordis peer this package does not take on. The three fields are copied verbatim; re-check them on every sync.
 - `simple-icons` (pinned `16.31.0`, same as upstream) is a runtime dependency: `LinkIcon*` draws known sites' marks through `SiteGlyph.tsx`.
-- Type / lint-only edits, re-applied on every sync: `useRef<T | undefined>(undefined)` in `JsonTree.tsx` and `RefObject<… | null>` in `useAnchoredMaxHeight.ts` / `markdown/useViewportHighlighting.ts` (React 19 `@types/react`); `catch {}` without the unused binding in `markdown/file-link.ts` (root oxlint `no-unused-vars` is an error).
+- Type / lint-only edits, re-applied on every sync: `useRef<T | undefined>(undefined)` in `JsonTree.tsx` and `RefObject<… | null>` in `useAnchoredMaxHeight.ts` / `markdown/useViewportHighlighting.ts` (React 19 `@types/react`); `catch {}` without the unused binding in `markdown/file-link.ts` (root oxlint `no-unused-vars` is an error); `useRef<number | null>` for the `window.setTimeout` handle in `use-clipboard-copy.ts` (upstream's `ReturnType<typeof setTimeout>` is Node's `Timeout` when `@types/node` is loaded, as in Storybook).
 
 ## SeekBuddy extension layer (not synchronized)