@linkdesk/plugin-sdk 0.1.16 → 0.1.17
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.
- package/README.md +19 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -158,3 +158,22 @@ export default function MyView({ isActive }: { isActive: boolean }) {
|
|
|
158
158
|
|
|
159
159
|
- **dev preview** (source glob loading inside the shell) parses plugin.json as strict JSON; this SDK's validate tolerating comments/trailing commas is a publish-time capability — if a plugin needs to run in dev preview, keep plugin.json free of comments.
|
|
160
160
|
- Dropping a commented plugin.json straight into the shell's `plugins/` dev directory breaks preview loading (jsonc support on the shell side is still to come).
|
|
161
|
+
|
|
162
|
+
## Maintaining this package (LinkDesk maintainers)
|
|
163
|
+
|
|
164
|
+
This package is **one of the five author axes** (the others: `@linkdesk/contracts` / `create-linkdesk-plugin` / `@linkdesk/ui` / `@linkdesk/plugin-docs`) and has its own version axis — **publishing it does not bump the application, and the application does not bump it**.
|
|
165
|
+
|
|
166
|
+
Its surface is `src/**` + `schemas/**` + `dev-host/**` + this README: change any of them and the version must be bumped and published, otherwise plugin authors keep building against the old CLI/schemas.
|
|
167
|
+
|
|
168
|
+
```bash
|
|
169
|
+
# 1. bump packages/plugin-sdk/package.json version (0.x backward-compatible → patch)
|
|
170
|
+
# 2. build the dist the publish channel ships (npm run build, inside the package)
|
|
171
|
+
# 3. publish
|
|
172
|
+
npm publish --registry=https://registry.npmjs.org # 🔴 the registry flag is mandatory — the machine default is a read-only mirror
|
|
173
|
+
# 4. record the baseline (run in the LinkDesk repo root)
|
|
174
|
+
npm run release:mark
|
|
175
|
+
```
|
|
176
|
+
|
|
177
|
+
> 🔴 The shelf read has a **~3 minute replication delay** (`contracts` is visible within seconds, `plugin-sdk` takes minutes) — do **not** re-publish on a 404, npm will reject the duplicate version.
|
|
178
|
+
> Full procedure + all three measured pitfalls → **`docs/06-发布管理/作者轴npm发版.md`** in the LinkDesk repository.
|
|
179
|
+
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@linkdesk/plugin-sdk",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.17",
|
|
4
4
|
"description": "@linkdesk/plugin-sdk——LinkDesk 插件作者 SDK（对标 @types/vscode）：window.linkdesk.* 类型 + 一键 build(.linkdesk-plugin) + dev 宿主 + plugin.json 验证 + eslint 门禁（E6#54d）。作者 npm i 后零壳源码依赖。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|