@linkdesk/plugin-docs 0.1.16 → 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
|
|
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
|
|
package/docs/zh/05-/346/217/222/344/273/266UI/345/206/231/346/263/225/350/247/204/347/272/246.md
CHANGED
|
@@ -751,7 +751,8 @@ button { border: none; }
|
|
|
751
751
|
> 🔧 **维护者注(作者可跳过)**:规则正文(R0 口径 / R1 宿主基线 / R2 / R3)与判定式、负控见
|
|
752
752
|
> `docs/02-Electron架构/E6_插件生态与发布/01-插件独立构建/样式命名空间归一化/32-任务-选择器形态轴门禁与落地.md`;
|
|
753
753
|
> 宿主侧由 `scripts/check-css-namespace.mjs` 的判据⑩⑪(+ 探针轴 ④ 的运行时镜像)守着,
|
|
754
|
-
> 插件侧由 SDK 的 `check-css-namespace`
|
|
754
|
+
> 插件侧由 SDK 的 `check-css-namespace` 腿的**第四、第五条判据**守着(`checks/selector-form.ts` 的 S2/S3,
|
|
755
|
+
> 与 `checks/keyframe-refs.ts` 的关键帧引用悬空 —— 后者 **2026-09-18 起**在位,SDK `≥ 0.1.37`)。
|
|
755
756
|
|
|
756
757
|
---
|
|
757
758
|
|