@dp-bohrium/widget-sdk 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 本文件只记录影响使用者的变更：运行时 API、事件订阅、Manifest 要求。
 
+## 0.4.1
+
+### 修复
+
+**1. 解除已释放监听与资源的强引用**
+
+- 手动释放 render、event 或第三方资源登记后，生命周期不再持续强引用原资源及其闭包；调用方继续持有释放句柄时，也不会因此保留已释放资源，避免长期运行的 Widget 反复切换监听器后累积内存。
+- 重复登记和重复释放继续保持幂等，活动资源仍在 Widget 停用时清理；公开 API、回调与释放语义不变。
+
+**2. 对齐 Panel 文件保存指南与授权边界**
+
+- npm 包首页指向官方文档站，便于从包元数据发现教程与 API 参考。
+- README 与 Agent 索引明确：file-preview 使用当前文件引用，获独立 `files.write` grant 的 Panel 使用 Host 签发的工作区文件引用；SDK 仍通过既有 `context.files.read/write` 接口传递字节，不新增文件操作。
+- [文件能力指南](https://dev.dp.tech/bohrium-widget-sdk/guides/capabilities/files) 补充 Panel 编辑示例，覆盖同文件 render 保留草稿、Session 切换、保存快照与冲突／未知结果；缺少授权、完整内容或读取版本时保持只读。
+- SDK 与 contracts 同步为 `0.4.1`，保持文件请求、回执与公开类型兼容。
+
 ## 0.4.0
 
 ### 新增

package/README.md

@@ -236,8 +236,9 @@ if (result.ok) {
 ### 读取和保存当前文件
 
 作者 Manifest 申请 `"capabilities": { "files": { "read": true, "write": true } }`，Host 仍需独立
-授权两个能力。`files.write` 对当前 `file-preview` 绑定的已有文件作整文件条件替换；引用来自
-`request.content.file`，不能传路径、URL、别的文件 id 或指定另存位置。Host 校验引用、作用域、
+授权两个能力。`files.write` 对 Host 签发引用指向的已有文件作整文件条件替换：在 `file-preview`
+中引用来自 `request.content.file`；在获得写 grant 的 Panel 中引用来自 `data.root` 或 `files.list`
+的结果。不能传路径、URL、自造的文件 id 或指定另存位置。Host 校验引用、作用域、
 写权限和实际字节预算，成功回执表示执行端已确认持久化。SDK 不负责 ASE、晶格或文件格式转换，
 插件应使用自己的序列化器生成最终字节。
 

package/dist/index.js

@@ -1,4 +1,4 @@
-import { i as createWidgetClient, l as WIDGET_SDK_VERSION } from "./runtime-8ppcE14g.js";
+import { i as createWidgetClient, l as WIDGET_SDK_VERSION } from "./runtime-RyAEhkyn.js";
 import { WIDGET_ACTIVATION_EVENTS, WIDGET_EVENT_NAMES, isWidgetActivationEvent, isWidgetEventName } from "@dp-bohrium/widget-contracts";
 //#region src/manifest.ts
 function compiledContribution(contribution) {
@@ -46,7 +46,8 @@ function compileWidgetPluginManifest(manifest, options = {}) {
 //#region src/lifetime.ts
 function createWidgetLifetime(onError) {
 	const controller = new AbortController();
-	const resources = /* @__PURE__ */ new Map();
+	const registrations = /* @__PURE__ */ new WeakMap();
+	const resources = /* @__PURE__ */ new Set();
 	const pending = /* @__PURE__ */ new Set();
 	let closePromise;
 	function run(callback) {
@@ -60,15 +61,20 @@ function createWidgetLifetime(onError) {
 		return task;
 	}
 	function add(resource) {
-		const existing = resources.get(resource);
+		const existing = registrations.get(resource);
 		if (existing) return existing;
+		let retained = resource;
 		let disposed;
 		const handle = { dispose() {
 			if (disposed) return disposed;
-			disposed = run(() => typeof resource === "function" ? resource() : resource.dispose());
+			const current = retained;
+			retained = void 0;
+			resources.delete(handle);
+			disposed = run(() => typeof current === "function" ? current() : current?.dispose());
 			return disposed;
 		} };
-		resources.set(resource, handle);
+		registrations.set(resource, handle);
+		resources.add(handle);
 		if (controller.signal.aborted) handle.dispose();
 		return handle;
 	}

package/dist/runtime/index.js

@@ -1,3 +1,3 @@
-import { a as isWidgetHostConnectMessage, c as WidgetClient, i as createWidgetClient, l as WIDGET_SDK_VERSION, n as WIDGET_HOST_CONNECT, o as PRESENTATION_CONFIRMATION_TIMEOUT_MS, r as WidgetRuntimeClient, s as REGION_CONFIRMATION_TIMEOUT_MS, t as WIDGET_BOOTSTRAP_READY } from "../runtime-8ppcE14g.js";
+import { a as isWidgetHostConnectMessage, c as WidgetClient, i as createWidgetClient, l as WIDGET_SDK_VERSION, n as WIDGET_HOST_CONNECT, o as PRESENTATION_CONFIRMATION_TIMEOUT_MS, r as WidgetRuntimeClient, s as REGION_CONFIRMATION_TIMEOUT_MS, t as WIDGET_BOOTSTRAP_READY } from "../runtime-RyAEhkyn.js";
 import { i as isWidgetProtocolMessage, r as MessagePortTransport } from "../protocol-endpoint-CDz-YDGT.js";
 export { MessagePortTransport, PRESENTATION_CONFIRMATION_TIMEOUT_MS, REGION_CONFIRMATION_TIMEOUT_MS, WIDGET_BOOTSTRAP_READY, WIDGET_HOST_CONNECT, WIDGET_SDK_VERSION, WidgetClient, WidgetRuntimeClient, createWidgetClient, isWidgetHostConnectMessage, isWidgetProtocolMessage };

package/dist/{runtime-8ppcE14g.js → runtime-RyAEhkyn.js}

@@ -2,7 +2,7 @@ import { r as MessagePortTransport, t as ProtocolEndpoint } from "./protocol-end
 //#endregion
 //#region src/runtime/version.ts
 /** 从当前安装的 SDK package.json 读取版本，插件作者不需要重复填写。 */
-const WIDGET_SDK_VERSION = "0.4.0";
+const WIDGET_SDK_VERSION = "0.4.1";
 //#endregion
 //#region src/runtime/network.ts
 const failureReasons = /* @__PURE__ */ new Set([

package/llms.txt

@@ -21,8 +21,9 @@
 - 先在 Manifest 声明 capability，再等待 Host grant。
 - 用 `WidgetError` 的 `code/phase/retryable/correlationId` 诊断启动、渲染和能力失败。
 - `ok=false` 的能力结果是可处理状态，不要直接重试或绕过 Host。
-- 当前文件读写使用 `context.files.read(input, options)` / `write(input, options)`；Manifest
-  分别申请 `files.read` / `files.write`，文件引用来自当前 file-preview。SDK 只传字节，不负责 ASE
+- 文件读写使用 `context.files.read(input, options)` / `write(input, options)`；Manifest
+  分别申请 `files.read` / `files.write`。file-preview 的引用来自当前文件；Panel 只有获得
+  `files.write` grant 时才能保存 `data.root` / `files.list` 取得的已有文件。SDK 只传字节，不负责 ASE
   或其他格式序列化。完整保存示例见 README「读取和保存当前文件」。
 - read 兼容仅含 content/encoding 的旧响应，可选 offset/bytesRead/nextOffset/eof/truncated/revision
   只验证已提供值并原样返回，不补造版本或游标。无 revision 仍可展示，但不能保存。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dp-bohrium/widget-sdk",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Bohrium Widget 开发者 SDK：在 Widget Bundle 内与 Host 建立 Bridge，并暴露生命周期与能力协议。",
   "license": "MIT",
   "type": "module",
@@ -18,7 +18,7 @@
     "runtime"
   ],
   "author": "Bohrium",
-  "homepage": "https://www.npmjs.com/package/@dp-bohrium/widget-sdk",
+  "homepage": "https://dev.dp.tech/bohrium-widget-sdk/",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
@@ -48,7 +48,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@dp-bohrium/widget-contracts": "0.4.0"
+    "@dp-bohrium/widget-contracts": "0.4.1"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.2.0",