@linkdesk/plugin-docs 0.1.17 → 0.1.18

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.
@@ -565,6 +565,17 @@ both stylesheets land on the same element.
565
565
  | `ldk-notif-icon-spin` | the notification icon's spin |
566
566
  | `ldk-notif-progress-scan` | the notification progress scan |
567
567
 
568
+ **The name you reference has to exist somewhere**—rule 2 above says "when you rename, change the reference in
569
+ the same commit"; this is the other half, and **the machine checks it**: the name you write in
570
+ `animation` / `animation-name` must either be defined by an `@keyframes` **in your own CSS** or be one of the
571
+ names in **the reserved table above** (referencing the host's animations is **legitimate consumption**—you will
572
+ not be flagged). Reference a name **nobody defined** and the animation **reports nothing, warns nothing, it
573
+ just does not run**—the symptom is "why isn't my animation working", while the console stays silent (other
574
+ plugins and the host are running in the same window, so it is hard to spot at a glance).
575
+ From `@linkdesk/plugin-sdk` **≥ 0.1.37**, the plugin lint reports these **dangling references** one by one
576
+ (**file name + line number + the name**); if you genuinely need a name the gate cannot see (say the animation
577
+ is injected at runtime), use a standard `eslint-disable` comment stating why.
578
+
568
579
  > 🔧 **Maintainer note (authors can skip this)**—the **Reserved names** and **Reserved keyframe names** columns in the two tables above are **machine-read**: the gate
569
580
  > in `npm run check` (`scripts/check-reserved-names-doc-sync.mjs`) cross-checks them **both ways** against the
570
581
  > registry `packages/plugin-sdk/schemas/reserved-class-names.json`—every registry name must appear here, and
@@ -744,7 +755,7 @@ button { border: none; }
744
755
 
745
756
  **Migration**: **zero instances today**—a full re-check of the 18 official plugins plus the in-repo fixtures (the "anchorless S2 / cross-party S3" columns of `npm run audit:plugin-prefix -- --all`) is **0** ⇒ **you have nothing to change**; this rule is **preventive**.
746
757
 
747
- > 🔧 **Maintainer note (authors may skip)**: the rule text (R0 scope / R1 host baseline / R2 / R3) plus the decision formulas and negative controls live in `docs/02-Electron架构/E6_插件生态与发布/01-插件独立构建/样式命名空间归一化/32-任务-选择器形态轴门禁与落地.md`; the host side is guarded by criteria ⑩⑪ of `scripts/check-css-namespace.mjs` (plus the runtime mirror on axis ④ of the probe), and the plugin side by the **fourth criterion** of the SDK's `check-css-namespace` leg (`checks/selector-form.ts`, S2/S3).
758
+ > 🔧 **Maintainer note (authors may skip)**: the rule text (R0 scope / R1 host baseline / R2 / R3) plus the decision formulas and negative controls live in `docs/02-Electron架构/E6_插件生态与发布/01-插件独立构建/样式命名空间归一化/32-任务-选择器形态轴门禁与落地.md`; the host side is guarded by criteria ⑩⑪ of `scripts/check-css-namespace.mjs` (plus the runtime mirror on axis ④ of the probe), and the plugin side by the **fourth and fifth criteria** of the SDK's `check-css-namespace` leg (`checks/selector-form.ts` for S2/S3, and `checks/keyframe-refs.ts` for dangling keyframe references—the latter in place since **2026-09-18**, SDK `≥ 0.1.37`).
748
759
 
749
760
  ---
750
761
 
@@ -752,7 +752,7 @@ button { border: none; }
752
752
  > `docs/02-Electron架构/E6_插件生态与发布/01-插件独立构建/样式命名空间归一化/32-任务-选择器形态轴门禁与落地.md`;
753
753
  > 宿主侧由 `scripts/check-css-namespace.mjs` 的判据⑩⑪(+ 探针轴 ④ 的运行时镜像)守着,
754
754
  > 插件侧由 SDK 的 `check-css-namespace` 腿的**第四、第五条判据**守着(`checks/selector-form.ts` 的 S2/S3,
755
- > 与 `checks/keyframe-refs.ts` 的关键帧引用悬空 —— 后者 **1.50 起**在位,SDK `≥ 0.1.37`)。
755
+ > 与 `checks/keyframe-refs.ts` 的关键帧引用悬空 —— 后者 **2026-09-18 起**在位,SDK `≥ 0.1.37`)。
756
756
 
757
757
  ---
758
758
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@linkdesk/plugin-docs",
3
- "version": "0.1.17",
3
+ "version": "0.1.18",
4
4
  "description": "LinkDesk 插件作者文档(离线包)——`docs/03-插件制造` 的发布产物:从零学会做一个插件(导览 / 三档动线 / 区域地图 / 组件速查 / 主题 / API 入口)。",
5
5
  "type": "module",
6
6
  "files": [