@linkdesk/plugin-docs 0.1.26 → 0.1.28

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,8 +104,9 @@ 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
+ - **Mechanical gate (SDK lint)**: 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
108
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))
109
+ - **Auto-install at install time (shell-side, opt-in via the request)**: when the install request carries a catalog source URL (the marketplace passes the listing's source), missing `requires` dependencies are installed automatically **inside the same install job** — inline and recursive, no second concurrency slot; a failing dependency fails the parent job (naming the dependency) and rolls back the parent's extracted files so a retry starts clean. Already-installed dependencies are skipped; disabled ones are never auto-enabled. Declaring `requires` is all an author does — no shell changes needed
109
110
  - `permissions` — declaring them informs the user; the authorization model is still pending
110
111
 
111
112
  ---
@@ -104,8 +104,9 @@ 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
+ - **机械门禁(SDK lint)**:运行时消费 `@linkdesk/ui` ⇒ `plugin.json` 必须声明 `minAppVersion` ≥ `0.2.13`(重锚号——共享组件的集中供给自这一版才存在;`import type` 编译期擦除、豁免)。由 `linkdesk-plugin-sdk lint` 判红(`check-ui-min-app-version`),无豁免出口
108
108
  - `requires` —— 运行期依赖编排生效(缺依赖挂起 PENDING + 环 fail-loud + 连带卸载逆拓扑,见 [02 §四](02-插件生命周期.md))
109
+ - **安装期自动装依赖(壳侧,随请求启用)**:安装请求携带来源市场目录时(市场插件随请求带条目来源 URL),`requires` 里缺失的依赖会在**同一个安装任务内**自动先装——内联递归、不占第二个并发槽;某个依赖失败 ⇒ 父任务失败并指名依赖,且父插件本次解压产物自动回滚、重试干净可用。已装的依赖跳过;禁用的**不自动启用**。作者只需声明 `requires`,无需为壳做任何适配
109
110
  - `permissions` —— 声明即用户知情,授权模型待 E6
110
111
 
111
112
  ---
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@linkdesk/plugin-docs",
3
- "version": "0.1.26",
3
+ "version": "0.1.28",
4
4
  "description": "LinkDesk 插件作者文档(离线包)——`docs/03-插件制造` 的发布产物:从零学会做一个插件(导览 / 三档动线 / 区域地图 / 组件速查 / 主题 / API 入口)。",
5
5
  "type": "module",
6
6
  "files": [