@linkdesk/plugin-docs 0.1.58 → 0.1.59

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.
@@ -117,7 +117,7 @@ The table below is **reconciled name by name** against it (gate `scripts/check-r
117
117
  | Host icon theme id | `default` | The fallback value of `app.iconTheme` |
118
118
  | Host appearance sentinel | `followTheme` | The "follow the theme" sentinel of a mix source — **it is not an id**, so don't try to shadow it with a plugin id |
119
119
  | Host-only context key (plugins **must not** set) | `activeEditor`、`editorCount`、`editorHasSelection`、`inputFocus`、`settingsActiveIsBuiltin`、`settingsSlotFilled`、`sidebarPosition`、`updateActionable`、`updateButtonLabel` | Set one of these at runtime over IPC and the host logs a `console.error` **naming you** (the value is still written: these are state, not registrations, so the runtime cannot tell who came first) |
120
- | Shared-contract context key (plugins **may** set) | `settingKey`、`settingFollowTheme`、`settingModified`、`settingResetsToDefault` | These four are a **public contract**: the official `settings` plugin writes them, host commands read them in `when` clauses — use them as specified, don't change their meaning |
120
+ | Shared-contract context key (plugins **may** set) | `settingKey`、`settingFollowTheme`、`settingModified`、`settingResetsToDefault`、`settingHasTitle` | These five are a **public contract**: the official `settings` plugin writes them, host commands read them in `when` clauses — use them as specified, don't change their meaning (`settingHasTitle` = the row declared a `title`; it gates the gear item "copy setting name") |
121
121
 
122
122
  **How to check yourself** (from your own repo): once `@linkdesk/plugin-sdk` is installed, your repo's `verify` runs four ownership legs (command ids / config keys / appearance ids / context keys); whichever one you violate is reported with its location plus the suggested fix, **"should start with `<pluginId>.`"**.
123
123
 
@@ -119,7 +119,7 @@ node_modules/@linkdesk/plugin-sdk/schemas/host-reserved.json
119
119
  | 宿主图标主题 id | `default` | `app.iconTheme` 的保底取值 |
120
120
  | 宿主外观哨兵值 | `followTheme` | 混搭来源的「跟随主题」哨兵——**它不是 id**,别拿一个插件 id 去顶它 |
121
121
  | 宿主专用旗子(插件**禁设**) | `activeEditor`、`editorCount`、`editorHasSelection`、`inputFocus`、`settingsActiveIsBuiltin`、`settingsSlotFilled`、`sidebarPosition`、`updateActionable`、`updateButtonLabel` | 你在运行时经 IPC 设它,宿主会 `console.error` **点名你**(值照写:旗子是状态不是注册,运行时拿不到「谁是先者」) |
122
- | 宿主公开约定旗子(插件**可设**) | `settingKey`、`settingFollowTheme`、`settingModified`、`settingResetsToDefault` | 这 4 个是**公开约定面**:官方 `settings` 插件写、宿主命令的 `when` 读——照约定用,别改语义 |
122
+ | 宿主公开约定旗子(插件**可设**) | `settingKey`、`settingFollowTheme`、`settingModified`、`settingResetsToDefault`、`settingHasTitle` | 这 5 个是**公开约定面**:官方 `settings` 插件写、宿主命令的 `when` 读——照约定用,别改语义(`settingHasTitle` = 该行声明了 `title`,门控齿轮「复制设置名称」) |
123
123
 
124
124
  **怎么自查**(你自己的仓里就能跑):装上 `@linkdesk/plugin-sdk` 后,你仓里的 `verify` 会跑四条归属腿
125
125
  (命令 id / 配置键 / 外观 id / 上下文旗子);哪条犯了会直接报点并给出**「应以 `<pluginId>.` 开头」**的改法。
package/package.json CHANGED
@@ -1,20 +1,20 @@
1
- {
2
- "name": "@linkdesk/plugin-docs",
3
- "version": "0.1.58",
4
- "description": "LinkDesk 插件作者文档(离线包)——作者面文档树的发布产物(英文 `docs/03-plugin-authoring` 在包根、中文 `docs/03-插件制造` 在 `zh/`):从零学会做一个插件(导览 / 三档动线 / 区域地图 / 组件速查 / 主题 / API 入口)。",
5
- "type": "module",
6
- "files": [
7
- "docs",
8
- "README.md"
9
- ],
10
- "engines": {
11
- "node": ">=18.0.0"
12
- },
13
- "keywords": [
14
- "linkdesk",
15
- "plugin",
16
- "docs",
17
- "authoring"
18
- ],
19
- "license": "MIT"
20
- }
1
+ {
2
+ "name": "@linkdesk/plugin-docs",
3
+ "version": "0.1.59",
4
+ "description": "LinkDesk 插件作者文档(离线包)——作者面文档树的发布产物(英文 `docs/03-plugin-authoring` 在包根、中文 `docs/03-插件制造` 在 `zh/`):从零学会做一个插件(导览 / 三档动线 / 区域地图 / 组件速查 / 主题 / API 入口)。",
5
+ "type": "module",
6
+ "files": [
7
+ "docs",
8
+ "README.md"
9
+ ],
10
+ "engines": {
11
+ "node": ">=18.0.0"
12
+ },
13
+ "keywords": [
14
+ "linkdesk",
15
+ "plugin",
16
+ "docs",
17
+ "authoring"
18
+ ],
19
+ "license": "MIT"
20
+ }