@dp-bohrium/widget-sdk 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 本文件只记录影响使用者的变更：运行时 API、事件订阅、Manifest 要求。
 
+## 0.3.0
+
+### 破坏性变更
+
+**1. RenderRequest 与 content 删除旧字段：slot 改为 contribution、panelType 改为 id**
+
+- 已发布的 0.2.0 运行时仍读取 `request.slot`。本版改为用 `request.contribution` 收窄 `request.content`；`request.slot` 不再存在。
+- `content.panelType` 改为 `content.id`，其余 `content` 的 `slot` 改为 `contribution`。
+- `compileWidgetPluginManifest` 生成的宿主清单字段由 `widgetConfig.slot` 改为 `widgetConfig.contribution`；作者 Manifest 写法不变。
+
+### 修复
+
+**2. 同步公开类型文档**
+
+- SDK 与 contracts 锁定同一版本，公开类型说明与 schema 一致。widget-cli 单独以 `0.1.0` 发布，不进入这次 SDK Tag。
+
 ## 0.2.0
 
 ### 新增

package/README.md

@@ -45,7 +45,7 @@ import type { WidgetContext } from "@dp-bohrium/widget-sdk";
 
 export function activate(context: WidgetContext) {
   context.render((request, renderContext) => {
-    renderSlot(request.slot, request.content, renderContext.phase);
+    renderContribution(request.contribution, request.content, renderContext.phase);
   });
   context.events.on("tool-call-result", () => {
     void context.ui.present("floating");

package/dist/compatibility/testing.js

@@ -1,4 +1,4 @@
-import { n as MemoryTransport, t as ProtocolEndpoint } from "../protocol-endpoint-I78q3jVT.js";
+import { n as MemoryTransport, t as ProtocolEndpoint } from "../protocol-endpoint-CDz-YDGT.js";
 //#region src/runtime/mock-host.ts
 const widgetMessageTypes = /* @__PURE__ */ new Set([
 	"ready",

package/dist/index.js

@@ -1,11 +1,11 @@
-import { i as createWidgetClient, l as WIDGET_SDK_VERSION } from "./runtime-Dute9ozh.js";
+import { i as createWidgetClient, l as WIDGET_SDK_VERSION } from "./runtime-Drr96Awx.js";
 import { WIDGET_ACTIVATION_EVENTS, WIDGET_EVENT_NAMES, isWidgetActivationEvent, isWidgetEventName } from "@dp-bohrium/widget-contracts";
 //#region src/manifest.ts
-function compiledSlot(contribution) {
+function compiledContribution(contribution) {
 	switch (contribution.type) {
 		case "panel": return {
 			type: "panel",
-			panelType: contribution.id,
+			id: contribution.id,
 			...contribution.placement === void 0 ? {} : { placement: contribution.placement }
 		};
 		case "file-preview": return {
@@ -18,7 +18,7 @@ function compiledSlot(contribution) {
 * 将开发者维护的插件清单编译为宿主可加载的宿主清单。
 *
 * 这是构建工具的边界函数，不是类型提示入口：作者直接编辑带 `$schema` 的 JSON，
-* SDK 版本从当前安装包读取，宿主入口默认落到 dist/widget.js，内部 slot 标识只在这里生成。
+* SDK 版本从当前安装包读取，宿主入口默认落到 dist/widget.js，内部 contribution 标识只在这里生成。
 */
 function compileWidgetPluginManifest(manifest, options = {}) {
 	const samples = options.samples ?? manifest.samples;
@@ -34,7 +34,7 @@ function compileWidgetPluginManifest(manifest, options = {}) {
 			hostApiVersion: 1,
 			widgetSdkVersion: WIDGET_SDK_VERSION,
 			entry: options.hostEntry ?? "dist/widget.js",
-			slot: compiledSlot(manifest.contributes.widget),
+			contribution: compiledContribution(manifest.contributes.widget),
 			...activationEvents === void 0 ? {} : { activationEvents },
 			...manifest.capabilities === void 0 ? {} : { requestedCapabilities: manifest.capabilities },
 			...manifest.runtime === void 0 ? {} : { runtime: manifest.runtime },

package/dist/manifest.d.ts

@@ -8,6 +8,6 @@ export interface CompileWidgetPluginManifestOptions {
  * 将开发者维护的插件清单编译为宿主可加载的宿主清单。
  *
  * 这是构建工具的边界函数，不是类型提示入口：作者直接编辑带 `$schema` 的 JSON，
- * SDK 版本从当前安装包读取，宿主入口默认落到 dist/widget.js，内部 slot 标识只在这里生成。
+ * SDK 版本从当前安装包读取，宿主入口默认落到 dist/widget.js，内部 contribution 标识只在这里生成。
  */
 export declare function compileWidgetPluginManifest(manifest: WidgetPluginManifest, options?: CompileWidgetPluginManifestOptions): WidgetManifest;

package/dist/{protocol-endpoint-I78q3jVT.js → protocol-endpoint-CDz-YDGT.js}

@@ -37,7 +37,7 @@ function isProtocolPayload(type, payload) {
 			const revision = property(payload, "revision");
 			const context = property(payload, "context");
 			const content = property(payload, "content");
-			return property(payload, "schemaVersion") === 1 && typeof property(payload, "requestId") === "string" && typeof property(payload, "instanceId") === "string" && typeof revision === "number" && Number.isSafeInteger(revision) && revision >= 1 && typeof property(payload, "slot") === "string" && typeof property(payload, "state") === "string" && isRecord(context) && isRecord(content);
+			return property(payload, "schemaVersion") === 1 && typeof property(payload, "requestId") === "string" && typeof property(payload, "instanceId") === "string" && typeof revision === "number" && Number.isSafeInteger(revision) && revision >= 1 && typeof property(payload, "contribution") === "string" && typeof property(payload, "state") === "string" && isRecord(context) && isRecord(content);
 		}
 		case "event": return typeof property(payload, "type") === "string" && isRecord(property(payload, "payload"));
 		case "capability-result": return typeof property(payload, "requestId") === "string" && isRecord(property(payload, "result"));

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-Dute9ozh.js";
-import { i as isWidgetProtocolMessage, r as MessagePortTransport } from "../protocol-endpoint-I78q3jVT.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-Drr96Awx.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-Dute9ozh.js → runtime-Drr96Awx.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dp-bohrium/widget-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Bohrium Widget 开发者 SDK：在 Widget Bundle 内与 Host 建立 Bridge，并暴露生命周期与能力协议。",
   "license": "MIT",
   "type": "module",
@@ -48,7 +48,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@dp-bohrium/widget-contracts": "0.2.0"
+    "@dp-bohrium/widget-contracts": "0.3.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.2.0",