dsh-mini-utility-dock 0.1.1 → 0.1.2

package/CHANGELOG.en.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.1.2 - 2026-09-06
+
+- Fix the README `npm run dock:embed` examples: add the previously missing `dock:embed` script to `package.json` and switch the usage to `npm run dock:embed -- check|sync path/to/client.js` (npm argument passing needs the `--` separator, and the CLI takes `sync|check` subcommands, not `--check`). A new smoke test extracts the documented commands from both READMEs and runs them, preventing docs/script drift.
+
 ## 0.1.1 - 2026-09-04
 
 - Normalize `label` in `register()`: a missing, blank, or non-string label falls back to `id`, so no item renders `aria-label="undefined"`.

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.1.2 - 2026-09-06
+
+- 修正 README 的 `npm run dock:embed` 示例：补上 `package.json` 缺失的 `dock:embed` 脚本，用法改为 `npm run dock:embed -- check|sync path/to/client.js`（npm 传参需要 `--` 分隔符，CLI 接受 `sync|check` 子命令而非 `--check`）。新增从双语 README 提取命令逐条执行的 smoke test，防止文档与脚本漂移。
+
 ## 0.1.1 - 2026-09-04
 
 - 归一化 `register()` 的 `label`：缺省、空白或非字符串的 `label` 回退为 `id`，避免渲染出 `aria-label="undefined"`。

package/README.en.md

@@ -14,8 +14,8 @@ Run `npx dsh-mini-utility-dock sync path/to/client.js` to embed the current frag
 You can also embed from this repo's own script (it never hard-codes a consumer path; the target is passed by the caller):
 
 ```sh
-npm run dock:embed --check path/to/client.js   # verify only, non-zero on drift
-npm run dock:embed path/to/client.js           # write between the markers
+npm run dock:embed -- check path/to/client.js  # verify only, non-zero on drift
+npm run dock:embed -- sync path/to/client.js   # write between the markers
 ```
 
 When registering, a missing, blank, or non-string `label` falls back to `id` as the accessible name, avoiding `aria-label="undefined"`.

package/README.md

@@ -23,8 +23,8 @@ npx dsh-mini-utility-dock check path/to/client.js
 也可用本仓库脚本同步（不硬编码任何消费仓路径，目标由调用方传入）：
 
 ```sh
-npm run dock:embed --check path/to/client.js   # 仅校验，漂移时非零退出
-npm run dock:embed path/to/client.js           # 写入标记之间
+npm run dock:embed -- check path/to/client.js  # 仅校验，漂移时非零退出
+npm run dock:embed -- sync path/to/client.js   # 写入标记之间
 ```
 
 注册时若 `label` 缺省、空白或非字符串，会回退为 `id` 作为可访问名称，避免 `aria-label="undefined"`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mini-utility-dock",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Shared classic-script utility dock protocol for DSH plugins.",
   "type": "module",
   "bin": {
@@ -16,6 +16,7 @@
     "CHANGELOG.en.md"
   ],
   "scripts": {
+    "dock:embed": "node bin/dsh-mini-utility-dock.js",
     "test": "node --test test/*.test.js"
   },
   "engines": {