@dp-bohrium/widget-sdk 0.8.0 → 0.10.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export type { CompileWidgetPluginManifestOptions } from "./manifest.js";
 export { compileWidgetPluginManifest } from "./manifest.js";
-export type { CapabilityRequest, CapabilityResult, FileDownloadResult, FileMutationId, FilePreviewContent, FilePreviewRenderRequest, FileReadInput, FileReadResult, FileReference, FileRevision, FileWriteInput, FileWriteResult, GrantedCapability, JsonValue, PanelContent, PanelRenderRequest, RenderRequest, RenderState, TaskObservationBatch, TaskObservationEvent, TaskObservationSnapshot, Theme, ThemeMode, WidgetActivationEvent, WidgetActivationEvents, WidgetContribution, WidgetError, WidgetErrorCode, WidgetEventName, WidgetFilePreviewContribution, WidgetLiveEvent, WidgetNetworkFetchInput, WidgetNetworkFetchOutput, WidgetPanelContribution, WidgetPluginContributions, WidgetPluginManifest, WidgetToolPhase, } from "./protocol/index.js";
+export type { CapabilityRequest, CapabilityResult, FileDownloadResult, FileMutationId, FilePreviewContent, FilePreviewRenderRequest, FileReadInput, FileReadResult, FileReference, FileRevision, FileWriteInput, FileWriteResult, GrantedCapability, JsonValue, PanelContent, PanelRenderRequest, RenderRequest, RenderState, Theme, ThemeMode, WidgetActivationEvent, WidgetActivationEvents, WidgetContribution, WidgetError, WidgetErrorCode, WidgetEventName, WidgetFilePreviewContribution, WidgetLiveEvent, WidgetNetworkFetchInput, WidgetNetworkFetchOutput, WidgetPanelContribution, WidgetPluginContributions, WidgetPluginManifest, WidgetToolPhase, } from "./protocol/index.js";
 export { isWidgetActivationEvent, isWidgetEventName, WIDGET_ACTIVATION_EVENTS, WIDGET_EVENT_NAMES, } from "./protocol/index.js";
 export type { HostUserEmail, HostUserEmailResult, HostUserProfile, HostUserProfileResult, WidgetHostUserClient, } from "./runtime/service.js";
-export type { FileDownloadCapabilityResult, FileReadCapabilityResult, FileWriteCapabilityResult, TaskListCapabilityResult, TaskWatchCapabilityResult, UiStateReadCapabilityResult, UiStateWriteCapabilityResult, WidgetActivation, WidgetCapabilityApi, WidgetContext, WidgetDisposable, WidgetEventApi, WidgetFileApi, WidgetHandle, WidgetHostOptions, WidgetModule, WidgetRenderContext, WidgetRenderHandler, WidgetTaskApi, WidgetUiApi, WidgetUiStateApi, } from "./widget.js";
+export type { FileDownloadCapabilityResult, FileReadCapabilityResult, FileWriteCapabilityResult, UiStateReadCapabilityResult, UiStateWriteCapabilityResult, WidgetActivation, WidgetCapabilityApi, WidgetContext, WidgetDisposable, WidgetEventApi, WidgetFileApi, WidgetHandle, WidgetHostOptions, WidgetModule, WidgetRenderContext, WidgetRenderHandler, WidgetUiApi, WidgetUiStateApi, } from "./widget.js";
 export { runWidgetHost } from "./widget.js";

package/dist/index.js

@@ -1,5 +1,6 @@
-import { i as createWidgetClient, l as WIDGET_SDK_VERSION } from "./runtime-D2xmZVSb.js";
-import { i as isWidgetActivationEvent, n as isWidgetEventName, r as WIDGET_ACTIVATION_EVENTS, t as WIDGET_EVENT_NAMES } from "./widget-events-gsKJbjqg.js";
+import { i as createWidgetClient, l as WIDGET_SDK_VERSION } from "./runtime-Bn_ee8xy.js";
+import { a as projectWidgetRuntimeDiagnostic, c as WIDGET_EVENT_NAMES, d as isWidgetActivationEvent, l as isWidgetEventName, u as WIDGET_ACTIVATION_EVENTS } from "./widget-recovery-BF_sSUZX.js";
+import { n as isWidgetGuestDiagnostic } from "./development-guards-COvBR0G1.js";
 //#region src/manifest.ts
 function compiledContribution(contribution) {
 	switch (contribution.type) {
@@ -315,16 +316,6 @@ function createContext(client, payload, renderHandlers, lifetime) {
 				input
 			}, options)
 		},
-		tasks: {
-			list: (input = {}, options) => client.requestCapability({
-				operation: "tasks.list",
-				input
-			}, options),
-			watch: (input, options) => client.requestCapability({
-				operation: "tasks.watch",
-				input
-			}, options)
-		},
 		network: client.network,
 		services: client.services,
 		hostUser: client.hostUser,
@@ -368,6 +359,7 @@ function createContext(client, payload, renderHandlers, lifetime) {
 function createWidgetRuntime(module, options = {}) {
 	let client;
 	const renderHandlers = /* @__PURE__ */ new Set();
+	let latestRenderRevision = 0;
 	const reportCleanupError = (error) => options.onCleanupError?.(toStartupError(error));
 	const lifetime = createWidgetLifetime(reportCleanupError);
 	let activation;
@@ -393,6 +385,16 @@ function createWidgetRuntime(module, options = {}) {
 			retryable: false,
 			correlationId: request.requestId
 		};
+		let location = null;
+		try {
+			location = error instanceof Error ? /(?:\/__widget\/guest\/[^/]+\/|\/assets\/)([a-zA-Z0-9_./-]+):(\d+):(\d+)/u.exec(error.stack ?? "") : null;
+		} catch {}
+		const projected = projectWidgetRuntimeDiagnostic(failure, update ? "update" : "render", location?.[1] ? [{
+			file: location[1],
+			line: Number(location[2]),
+			column: Number(location[3])
+		}] : void 0);
+		const diagnostic = isWidgetGuestDiagnostic(projected) ? projected : projectWidgetRuntimeDiagnostic(failure, update ? "update" : "render");
 		writeLocalDiagnostic("[Widget 渲染失败]", failure, error);
 		for (const observer of [options.events?.onError, options.onError]) try {
 			Promise.resolve(observer?.(failure)).catch((observerError) => {
@@ -401,6 +403,7 @@ function createWidgetRuntime(module, options = {}) {
 		} catch (observerError) {
 			writeLocalDiagnostic("[Widget 诊断回调失败]", observerError);
 		}
+		return diagnostic;
 	}
 	function runDeactivation() {
 		if (deactivation) return deactivation;
@@ -438,18 +441,51 @@ function createWidgetRuntime(module, options = {}) {
 				return activation;
 			},
 			onRender(request, update) {
+				latestRenderRevision = request.revision;
 				const renderContext = {
 					phase: update ? "update" : "initial",
 					signal: lifetime.signal
 				};
-				for (const handler of [...renderHandlers]) {
-					if (lifetime.signal.aborted) break;
+				const handlers = [...renderHandlers];
+				let reported = false;
+				const reportResult = (diagnostic) => {
+					if (lifetime.signal.aborted || !handlers.length || reported) return;
+					reported = true;
 					try {
-						Promise.resolve(handler(request, renderContext)).catch((error) => reportRenderFailure(error, request, update));
+						if (request.revision !== latestRenderRevision) client.reportRenderResult({
+							requestId: request.requestId,
+							revision: request.revision,
+							outcome: "superseded"
+						});
+						else if (diagnostic) client.reportRenderResult({
+							requestId: request.requestId,
+							revision: request.revision,
+							outcome: "failed",
+							diagnostic: {
+								...diagnostic,
+								correlationId: request.requestId,
+								phase: update ? "update" : "render"
+							}
+						});
+						else client.reportRenderResult({
+							requestId: request.requestId,
+							revision: request.revision,
+							outcome: "handled"
+						});
+					} catch (reason) {
+						writeLocalDiagnostic("[Widget 诊断发送失败]", reason);
+					}
+				};
+				Promise.all(handlers.map(async (handler) => {
+					if (lifetime.signal.aborted) return;
+					try {
+						await handler(request, renderContext);
 					} catch (error) {
-						reportRenderFailure(error, request, update);
+						reportResult(reportRenderFailure(error, request, update));
 					}
-				}
+				})).then(() => reportResult()).catch((reason) => {
+					writeLocalDiagnostic("[Widget 诊断发送失败]", reason);
+				});
 			},
 			onDispose: dispose
 		}

package/dist/protocol/development-guards.d.ts

@@ -0,0 +1,9 @@
+import type { WidgetDevelopmentDiagnostic, WidgetDevelopmentOffer, WidgetRenderResult } from "./generated-runtime-contracts.js";
+/** 与源头 Schema 同源限额的轻量边界判定，不加载 AJV 或 Runtime。 */
+export declare function isWidgetGuestDiagnostic(value: unknown): value is WidgetDevelopmentDiagnostic & {
+    source: "sdk";
+};
+/** offer 只声明解析能力；实际 iframe 来源与 attempt 由 Host 校验。 */
+export declare function isWidgetDevelopmentOffer(value: unknown): value is WidgetDevelopmentOffer;
+/** 失败回执仍需 Host 再匹配实际已发送的 request/revision。 */
+export declare function isWidgetRenderResult(value: unknown): value is WidgetRenderResult;

package/dist/protocol/generated-development-policy.d.ts

@@ -0,0 +1,22 @@
+/** GENERATED FILE. Do not edit directly. */
+export declare const widgetDevelopmentPolicy: {
+    readonly required: readonly ["schemaVersion", "source", "code", "phase", "operation", "severity", "message"];
+    readonly keys: readonly ["schemaVersion", "source", "code", "sourceCode", "phase", "sourcePhase", "operation", "severity", "message", "retryable", "correlationId", "diagnostics", "io"];
+    readonly textMax: {
+        readonly code: 96;
+        readonly sourceCode: 96;
+        readonly sourcePhase: 96;
+        readonly operation: 96;
+        readonly message: 1024;
+        readonly field: 128;
+        readonly expected: 256;
+        readonly observed: 256;
+        readonly file: 256;
+        readonly excerpt: 1024;
+    };
+    readonly maxDetails: 8;
+    readonly phases: readonly ["discovery", "build", "config", "load", "handshake", "render", "update", "capability", "dispose"];
+    readonly severities: readonly ["warning", "request-error", "instance-failure"];
+    readonly identifierPattern: "^[A-Za-z][A-Za-z0-9_.-]*$";
+    readonly filePattern: "^(?!/)(?!.*\\\\)(?!.*:)(?!.*(?:^|/)\\.{1,2}(?:/|$))[^\\u0000-\\u001f]+$";
+};

package/dist/protocol/generated-host-runtime-config.d.ts

@@ -134,20 +134,6 @@ export type GrantedCapability = ({
         pageSize: number;
         minPollMs: number;
     };
-} | {
-    name: "tasks.list";
-    limits: {
-        callsPerMinute: number;
-        pageSize: number;
-        minPollMs: number;
-    };
-} | {
-    name: "tasks.watch";
-    limits: {
-        callsPerMinute: number;
-        pageSize: number;
-        minPollMs: number;
-    };
 } | {
     name: "ui.state";
     limits: {
@@ -366,7 +352,6 @@ export interface PanelContributionConfig {
 export interface RequestedCapabilities {
     files?: FilesCapabilityRequest;
     events?: EventsCapabilityRequest;
-    tasks?: TasksCapabilityRequest;
     state?: StateCapabilityRequest;
     actions?: ActionsCapabilityRequest;
     network?: NetworkCapabilityRequest;
@@ -393,13 +378,6 @@ export interface EventsCapabilityRequest {
      */
     topics: [string, ...(string)[]];
 }
-/**
- * 任务发现与观察能力的申请；list / watch 至少显式申请一项，已申请项固定为 true。
- */
-export interface TasksCapabilityRequest {
-    list?: true;
-    watch?: true;
-}
 /**
  * 受限 UI 状态读写能力的申请；read / write 分别声明。
  */

package/dist/protocol/generated-manifest.d.ts

@@ -105,7 +105,6 @@ export interface PanelContributionConfig {
 export interface RequestedCapabilities {
     files?: FilesCapabilityRequest;
     events?: EventsCapabilityRequest;
-    tasks?: TasksCapabilityRequest;
     state?: StateCapabilityRequest;
     actions?: ActionsCapabilityRequest;
     network?: NetworkCapabilityRequest;
@@ -132,13 +131,6 @@ export interface EventsCapabilityRequest {
      */
     topics: [string, ...(string)[]];
 }
-/**
- * 任务发现与观察能力的申请；list / watch 至少显式申请一项，已申请项固定为 true。
- */
-export interface TasksCapabilityRequest {
-    list?: true;
-    watch?: true;
-}
 /**
  * 受限 UI 状态读写能力的申请；read / write 分别声明。
  */

package/dist/protocol/generated-plugin-manifest.d.ts

@@ -89,7 +89,6 @@ export interface WidgetFilePreviewContribution {
 export interface RequestedCapabilities {
     files?: FilesCapabilityRequest;
     events?: EventsCapabilityRequest;
-    tasks?: TasksCapabilityRequest;
     state?: StateCapabilityRequest;
     actions?: ActionsCapabilityRequest;
     network?: NetworkCapabilityRequest;
@@ -116,13 +115,6 @@ export interface EventsCapabilityRequest {
      */
     topics: [string, ...(string)[]];
 }
-/**
- * 任务发现与观察能力的申请；list / watch 至少显式申请一项，已申请项固定为 true。
- */
-export interface TasksCapabilityRequest {
-    list?: true;
-    watch?: true;
-}
 /**
  * 受限 UI 状态读写能力的申请；read / write 分别声明。
  */