dsh-qr-share 0.1.0 → 0.3.1

package/CHANGELOG.md

@@ -7,6 +7,103 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.1] — 2026-09-01
+
+### Changed
+
+- **Trimmed `dsh.client.inject` peer-module list** — dropped
+  `@deepseek-ai/dsh-client-runtime` and `@deepseek-ai/dsh-client-ui-slots`
+  from the package.json manifest. The plugin's runtime only consumes
+  three services from the dsh host (`slots`, `locale`, `connection`),
+  and these are still provided by the remaining two peer modules
+  (`@deepseek-ai/dsh-client-locale` and
+  `@deepseek-ai/dsh-client-ui-sidebar`). Boot-time module manifest
+  shrinks and `__DSH_BOOT__.clientModules` reflects the smaller
+  surface; user-visible behavior (sidebar footer button, QR dialog,
+  copy-link, six extra locales) is unchanged.
+
+## [0.3.0] — 2026-08-30
+
+### Added
+
+- **Copy link button in the dialog** — a second footer action next to
+  Close. Clicking it copies `${window.location.origin}/?token=…` to
+  the clipboard; the label flips to a localized "已复制 / Copied"
+  confirmation for 1.5 s, then back. Falls back from the async
+  Clipboard API to `document.execCommand('copy')` when the secure-
+  context path is unavailable (older WebViews, non-HTTPS previews),
+  and surfaces "复制失败 / Copy failed" if both paths reject.
+- **Extra locale dictionaries** — beyond the built-in `zh` and `en`,
+  six more locales are registered via the single-locale
+  `ctx.locale.register(ns, locale, dict)` overload: `zh-Hant` (繁體),
+  `ja`, `ko`, `fr`, `de`, `ru`. They activate only when a matching
+  language-pack plugin sets the DSH preference; without a language
+  pack, the existing fallback chain (`zh` → `en`) still resolves.
+- **Dialog keys for the copy flow** — `dialog.copy`, `dialog.copied`,
+  and `dialog.copyFailed` added to the `QrShareKey` interface and
+  every dictionary.
+- **Two QrDialog tests** — clipboard write is asserted with a
+  stubbed `navigator.clipboard.writeText` (success + reject path).
+
+### Changed
+
+- **Footer action row** in `QrDialog` now holds two buttons
+  ("Copy link" + "Close") in a flex row (`.actions`) instead of a
+  single Close button. The `.close` class is generalized to `.action`;
+  the dialog's visual rhythm is unchanged.
+
+## [0.2.0] — 2026-08-30
+
+### Added
+
+- **Test infrastructure** — vitest 2 + @testing-library/react, configured
+  for happy-dom. `pnpm test` runs 27 specs covering `config`,
+  `client/api` and `client/QrDialog`. `tsconfig.build.json` now
+  excludes `src/**/*.test.ts(x)` and `src/test/**` so the tests never
+  reach the published `.d.ts` output.
+- **Ambient CSS module declaration** — `src/client/styles.module.css.d.ts`
+  gives `tsc` the default-export shape that `lightningcss` produces at
+  build time, unblocking `import styles from './styles.module.css'`
+  in `QrButton.tsx` and `QrDialog.tsx` without weakening the type
+  checker.
+
+### Changed
+
+- **Dialog now renders into `document.body` via `createPortal`** —
+  the sidebar's `transform`/`filter` would otherwise trap
+  `position: fixed` inside the sidebar's box; portalling escapes every
+  ancestor's containing block so the backdrop covers the viewport and
+  the dialog is centered on screen.
+- **Dialog surface is theme-aware and fully opaque** — background
+  resolves to the DSH shell's `--dsw-alias-bg-layer-1` token (alpha = 1),
+  with a `currentColor 12%` hairline border and a soft shadow. A
+  `--dsh-qr-share-dialog-bg` override hook is exposed for power users.
+- **QR code canvas wrapped in a white card** — 8px padding + `#fff`
+  background guarantees the black modules stay scannable against
+  either light or dark DSH surface.
+- **Sidebar action is now a labeled icon** — wide mode renders both
+  the `HiOutlineQrCode` icon and the `button.label` text; rail mode
+  keeps the icon only.
+- **Copy localized** — `button.label` is now "分享" (zh) / "Share"
+  (en); `button.tooltip` and `dialog.title` were rewritten in the
+  same voice ("扫码把当前会话分享到手机" / "Scan to share"). The host
+  handshake's semantics are unchanged.
+
+### Fixed
+
+- **QR canvas was blank on first render** — the `useEffect` that
+  calls `qrcode.toCanvas` ran once before the portal-mounted `<canvas>`
+  was in the DOM. Adding `portalTarget` to the effect's dependency
+  list gives the canvas a second pass after the portal resolves.
+- **CSS Module class names were hardcoded** — `QrDialog.tsx` and
+  `QrButton.tsx` used the literal `'dsh-qr-share-backdrop'`
+  strings, but tsdown's `lightningcss` compiles them under the
+  `[hash]_[local]` pattern (`i2jIGq_backdrop`). The two forms never
+  matched, so the dialog had no styles at all and fell back to
+  `position: static`. Both files now consume the `styles.*` import
+  map; the bundle ships the hashed class names in the inline
+  `<style data-plugin>` tag.
+
 ## [0.1.0] — 2026-08-29
 
 ### Added
@@ -50,5 +147,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   preventing cross-site frames from reaching the route and stopping
   intermediary caches from storing the token.
 
-[Unreleased]: https://github.com/xiaoguomeiyitian/dsh-qr-share/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/xiaoguomeiyitian/dsh-qr-share/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/xiaoguomeiyitian/dsh-qr-share/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/xiaoguomeiyitian/dsh-qr-share/releases/tag/v0.1.0

package/README.md

@@ -99,12 +99,24 @@ layout needs a symlink — see `manual` install below).
 ## Build
 
 ```bash
+# Recommended: pnpm (matches the project lockfile-less layout)
 pnpm install
 pnpm build       # tsc declarations + tsdown bundles
 pnpm typecheck   # strict check
 pnpm pack        # produce dsh-qr-share-<version>.tgz (used by the install commands above)
+
+# Also supported: npm (any Node >= 20, no extra install)
+npm install
+npm run build    # same tsc + tsdown pipeline
+npm run typecheck
+npm pack
 ```
 
+> For npm publishing we ship [`./npm_publish.sh`](npm_publish.sh) — a
+> single-file mirror of the [core_ts](https://github.com/xiaoguomeiyitian/core_ts)
+> release flow (`npm login` → `npm install` → `npm run build` →
+> `npm pack --dry-run` review → `npm publish --access public`).
+
 Outputs:
 
 - `lib/index.js` — Node host half (the `/_qr/share` route)

package/README.zh.md

@@ -74,12 +74,21 @@ pnpm add dsh-qr-share
 ## 构建
 
 ```bash
+# 推荐:pnpm(与项目无 lockfile 的设计一致)
 pnpm install
 pnpm build       # tsc 声明 + tsdown bundle
 pnpm typecheck   # 严格检查
 pnpm pack        # 产出 dsh-qr-share-<version>.tgz
+
+# 也支持:npm(任意 Node >= 20, 无需额外安装)
+npm install
+npm run build    # 同样的 tsc + tsdown 管线
+npm run typecheck
+npm pack
 ```
 
+> 发版用 [`./npm_publish.sh`](npm_publish.sh)——单文件脚本,照搬 [core_ts](https://github.com/xiaoguomeiyitian/core_ts) 的发布流程(`npm login` → `npm install` → `npm run build` → `npm pack --dry-run` 预检 → `npm publish --access public`)。
+
 产物：
 
 - `lib/index.js` — Node 宿主半（`/_qr/share` 路由）

package/cordis.patch.yml

@@ -14,9 +14,11 @@
 # modules resolves `<name>/package.json` from the profile dir to
 # discover the client half and compose window.__DSH_BOOT__.
 #
-# To disable the plugin without uninstalling, swap this row's `name`
-# to a `!!js` expression returning a disabled placeholder (see
-# dsh-better-sidebar's cordis.patch.yml for the pattern).
+# `id` MUST match the bundle's own `window.__ModuleLoader__.load({id,
+# …})` argument (set by `tsdown.config.ts#clientBundle(pluginId)`.).
+# An id mismatch breaks dsh-client-modules' module graph: the loader
+# entry path and the bundle's required id diverge, so the browser
+# never resolves the plugin and shows nothing on screen.
 - insert:
-    - id: qr-share
+    - id: dsh-qr-share
       name: 'dsh-qr-share'