@linkdesk/plugin-docs 0.1.52 → 0.1.53
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.
|
@@ -40,13 +40,14 @@ import { Button, Toggle, ContextMenu } from "@linkdesk/ui";
|
|
|
40
40
|
|
|
41
41
|
> The package is the build artifact of a **single-source, anti-drift** setup: the shell changes a component → the package changes with it, so "same as the built-ins" is literally the same implementation. It also **does not go into** your `.linkdesk-plugin` bundle (externalized at build time), and at **runtime the shell pool supplies that one instance** — nothing to worry about in terms of size or duplicate copies.
|
|
42
42
|
|
|
43
|
-
### 2.1
|
|
43
|
+
### 2.1 Self-driven versioning (no lookup table)
|
|
44
44
|
|
|
45
|
-
The version of `@linkdesk/ui` **
|
|
45
|
+
The version of `@linkdesk/ui` **moves on its own** (patch +1 per publish) and is unrelated to the shell version (🟢 since 2026-10-01, E6#166).
|
|
46
46
|
|
|
47
|
-
- **Which one to install**:
|
|
48
|
-
- **No need to chase upgrades**:
|
|
49
|
-
- **When you do have to move**: only when a **new component you want** appears in a higher version — that's a deliberate upgrade on your side, not something you're forced into.
|
|
47
|
+
- **Which one to install**: `npm i @linkdesk/ui@latest` gets you the newest. A new package is published only when the shared components actually change (checked at every shell release by the publish gate), so "latest package = the components inside the latest shell" holds by construction — nothing to look up.
|
|
48
|
+
- **No need to chase upgrades**: styles and behavior are **served at runtime by the shell pool** — a shell upgrade refreshes your plugin's UI automatically, no matter which package version you installed.
|
|
49
|
+
- **When you do have to move**: only when a **new component / new prop you want** appears in a higher version — that's a deliberate upgrade on your side, not something you're forced into.
|
|
50
|
+
- **Curious which shell a package was cut from**: check `dist/shell-provenance.json` inside the package (shell version + short commit + date).
|
|
50
51
|
|
|
51
52
|
### 2.2 Three promises the shell makes to authors (each backed by a mechanical gate)
|
|
52
53
|
|
|
@@ -41,13 +41,14 @@ import { Button, Toggle, ContextMenu } from "@linkdesk/ui";
|
|
|
41
41
|
> 包是**单源码防漂移**的编译产物:壳改组件 → 包跟着变,所以"内置同款"是字面意义上的同一份实现。
|
|
42
42
|
> 它也**不进**你的 `.linkdesk-plugin` bundle(构建时 external),**运行时由壳池供给同一份实例**——不必担心体积,也不必担心装了两份。
|
|
43
43
|
|
|
44
|
-
### 2.1
|
|
44
|
+
### 2.1 版本自走(没有对照表)
|
|
45
45
|
|
|
46
|
-
`@linkdesk/ui`
|
|
46
|
+
`@linkdesk/ui` 的版本号**自己走**(每次发布 patch +1),与壳版本号无关(🟢 2026-10-01 起,E6#166)。
|
|
47
47
|
|
|
48
|
-
-
|
|
49
|
-
-
|
|
50
|
-
-
|
|
48
|
+
- **该装哪个**:`npm i @linkdesk/ui@latest` 拿到的就是最新——壳发版时只有共享组件**真变了**才发新包,所以「最新包 = 最新壳里的那套组件」由发布门禁保证,你不用对照任何表。
|
|
49
|
+
- **不用追着升**:样式与行为**运行时由壳池统一供给**——壳升级,你的插件界面自动跟着新,装哪版包都不影响长相。
|
|
50
|
+
- **什么时候必须动**:只有当你**要用的新组件 / 新 prop** 出现在更高版本时——那是你主动升,不是被迫跟。
|
|
51
|
+
- **想知道手里的包剪自哪个壳**:看包里 `dist/shell-provenance.json`(壳版号 + 短 hash + 日期)。
|
|
51
52
|
|
|
52
53
|
### 2.2 壳对作者的三条承诺(都有机械兜底)
|
|
53
54
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@linkdesk/plugin-docs",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.53",
|
|
4
4
|
"description": "LinkDesk 插件作者文档(离线包)——作者面文档树的发布产物(英文 `docs/03-plugin-authoring` 在包根、中文 `docs/03-插件制造` 在 `zh/`):从零学会做一个插件(导览 / 三档动线 / 区域地图 / 组件速查 / 主题 / API 入口)。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"files": [
|