@linkdesk/plugin-docs 0.1.24 → 0.1.26

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.
@@ -104,6 +104,7 @@ Wording discipline (hard constraint 11): don't frame it as two categories "built
104
104
  All three are declared in the schema (see [03-contributes](03-contributes-spec.md)) and none is enforced at install time—their semantics align with [02 Lifecycle §9](02-plugin-lifecycle.md):
105
105
 
106
106
  - `minAppVersion` — checked at load time (not satisfied → toast + skip)
107
+ - **Mechanical gate (SDK lint, E6#129)**: consuming `@linkdesk/ui` at runtime ⇒ `plugin.json` must declare `minAppVersion` ≥ `0.2.13` (the UI re-anchor version — vendor supply of shared components exists only from that shell onward; `import type` is exempt as compile-time-erased). Enforced by `linkdesk-plugin-sdk lint` (`check-ui-min-app-version`), no disable exit
107
108
  - `requires` — runtime dependency orchestration applies (missing dependency → suspend as PENDING + cycle fail-loud + cascading uninstall in reverse topological order, see [02 §4](02-plugin-lifecycle.md))
108
109
  - `permissions` — declaring them informs the user; the authorization model is still pending
109
110
 
@@ -104,6 +104,7 @@ my-plugin/
104
104
  三者 schema 均已声明(见 [03-contributes](03-插件contributes规范.md)),安装期不强制——语义与 [02 生命周期 §九](02-插件生命周期.md) 对齐:
105
105
 
106
106
  - `minAppVersion` —— 加载期校验(不满足 → toast + 跳过)
107
+ - **机械门禁(SDK lint,E6#129)**:运行时消费 `@linkdesk/ui` ⇒ `plugin.json` 必须声明 `minAppVersion` ≥ `0.2.13`(重锚号——共享组件的集中供给自这一版才存在;`import type` 编译期擦除、豁免)。由 `linkdesk-plugin-sdk lint` 判红(`check-ui-min-app-version`),无豁免出口
107
108
  - `requires` —— 运行期依赖编排生效(缺依赖挂起 PENDING + 环 fail-loud + 连带卸载逆拓扑,见 [02 §四](02-插件生命周期.md))
108
109
  - `permissions` —— 声明即用户知情,授权模型待 E6
109
110
 
@@ -589,6 +589,12 @@ lint 会把这种**悬空引用**逐条报出来(**文件名 + 行号 +
589
589
  **反例(真实踩过)**:把宿主保留名当成「随手可用的样式名」套到自己的元素上,结果底色和文字被涂成
590
590
  同一个颜色、文字被背景吞掉,界面上看着就是「一块纯色」——**不报错**,只是长得不对,很难查。
591
591
 
592
+ **删组件时,同笔删它的 CSS 规则**——被壳的共享组件(`SidePanel` / `SidebarSection`)接管了的节点,
593
+ 插件侧**不要留孤儿规则**:规则还在、节点没了,它就成了一个**静默吃掉样式**的挂载点——谁哪天往那个
594
+ 类上挂样式(比如一个本地 token),都会**静默失效**(1.24 真实事故:官方 `serial-monitor` 的侧栏状态点
595
+ 颜色被静默丢掉,v1.0.17 当场修正)。拿不准有没有孤儿规则,跑壳仓的
596
+ `npm run audit:plugin-dead-css`——它把「定义了、源码没人用」的自有前缀类逐条列出来(只报不拦)。
597
+
592
598
  ### 12.1 从旧版 `@linkdesk/ui` 升上来——一件要你自己改的事
593
599
 
594
600
  共享组件的类名带上了 `ldk-` 前缀(`@linkdesk/ui` **0.2.0** 起)。这件事**只影响一种写法**:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@linkdesk/plugin-docs",
3
- "version": "0.1.24",
3
+ "version": "0.1.26",
4
4
  "description": "LinkDesk 插件作者文档(离线包)——`docs/03-插件制造` 的发布产物:从零学会做一个插件(导览 / 三档动线 / 区域地图 / 组件速查 / 主题 / API 入口)。",
5
5
  "type": "module",
6
6
  "files": [