@clipbus/plugin-sdk 0.9.9 → 0.10.0

package/dist/generated/ui.clipbus.generated.d.ts

@@ -1,18 +1,16 @@
-import type { PluginActionCompletePayload, PluginActionCompleteResponse, PluginActionSetButtonsPayload, PluginActionSetButtonsResponse, PluginAssetCurrentActionInputImageUrlResponse, PluginAssetCurrentActionInputPathReferenceImageUrlPayload, PluginAssetCurrentActionInputPathReferenceImageUrlResponse, PluginAssetCurrentItemImageUrlResponse, PluginAssetPathReferenceImageUrlPayload, PluginAssetPathReferenceImageUrlResponse, PluginAttachmentRendererSetButtonsPayload, PluginAttachmentRendererSetButtonsResponse, PluginClipboardCopyTextPayload, PluginClipboardCopyTextResponse, PluginConsoleLogPayload, PluginConsoleLogResponse, PluginInfoPanelClosePayload, PluginInfoPanelCloseResponse, PluginInfoPanelOpenPayload, PluginInfoPanelOpenResponse, PluginItemReadAttachmentPayload, PluginItemReadAttachmentResponse, PluginNavigationOpenFilePathPayload, PluginNavigationOpenFilePathResponse, PluginNavigationOpenUrlPayload, PluginNavigationOpenUrlResponse, PluginNavigationRevealInFinderPayload, PluginNavigationRevealInFinderResponse, PluginRuntimeInvokePayload, PluginSettingsGetAllResponse, PluginSettingsGetPayload, PluginSettingsGetResponse, PluginTextInputStateChangedPayload, PluginTextInputStateChangedResponse, PluginWindowAutoFitResponse, PluginWindowSetHeightPayload, PluginWindowSetHeightResponse } from './capabilityClients.generated.js';
-import type { PluginActionUIInput, PluginAttachmentPayload, PluginClipboardItem, PluginThemeTokenSnapshot } from './data.generated.js';
-import type { PluginActionHostInvokePayload, PluginAttachmentHostInvokePayload, PluginContextPayload, PluginInfoPanelOnActionPayload, PluginInfoPanelOnClosePayload, PluginLocalePayload } from './topicSubscribers.generated.js';
+import type { PluginActionCompletePayload, PluginActionCompleteResponse, PluginActionSetButtonsPayload, PluginActionSetButtonsResponse, PluginAssetCurrentActionInputImageUrlResponse, PluginAssetCurrentActionInputPathReferenceImageUrlPayload, PluginAssetCurrentActionInputPathReferenceImageUrlResponse, PluginAssetCurrentItemImageUrlResponse, PluginAssetPathReferenceImageUrlPayload, PluginAssetPathReferenceImageUrlResponse, PluginAttachmentRendererSetButtonsPayload, PluginAttachmentRendererSetButtonsResponse, PluginClipboardCopyTextPayload, PluginClipboardCopyTextResponse, PluginConsoleDiagnosticPayload, PluginConsoleDiagnosticResponse, PluginConsoleLogPayload, PluginConsoleLogResponse, PluginInfoPanelClosePayload, PluginInfoPanelCloseResponse, PluginInfoPanelOpenPayload, PluginInfoPanelOpenResponse, PluginItemReadAttachmentPayload, PluginItemReadAttachmentResponse, PluginNavigationOpenFilePathPayload, PluginNavigationOpenFilePathResponse, PluginNavigationOpenUrlPayload, PluginNavigationOpenUrlResponse, PluginNavigationRevealInFinderPayload, PluginNavigationRevealInFinderResponse, PluginRuntimeInvokePayload, PluginSettingsGetAllResponse, PluginSettingsGetPayload, PluginSettingsGetResponse, PluginTextInputStateChangedPayload, PluginTextInputStateChangedResponse, PluginWindowAutoFitResponse, PluginWindowSetHeightPayload, PluginWindowSetHeightResponse } from './capabilities.generated.js';
 export declare const clipbus: {
     capabilities: import("../internal/capabilities.js").CapabilitiesApi;
     runtime: {
         invoke: <TResp = unknown>(payload: PluginRuntimeInvokePayload) => Promise<TResp>;
     };
     item: {
-        current: () => PluginClipboardItem | undefined;
-        on: (fn: (payload: PluginClipboardItem) => void) => import("../internal/topic.js").Unsubscribe;
+        current: () => import("./data.generated.js").PluginClipboardItem | undefined;
+        on: (listener: (event: import("./data.generated.js").PluginClipboardItem) => void) => import("../internal/topic.js").Unsubscribe;
         readAttachment: (payload: PluginItemReadAttachmentPayload) => Promise<PluginItemReadAttachmentResponse>;
         attachment: {
-            current: () => PluginAttachmentPayload | undefined;
-            on: (fn: (payload: PluginAttachmentPayload) => void) => import("../internal/topic.js").Unsubscribe;
+            current: () => import("./data.generated.js").PluginAttachmentPayload | undefined;
+            on: (listener: (event: import("./data.generated.js").PluginAttachmentPayload) => void) => import("../internal/topic.js").Unsubscribe;
         };
     };
     asset: {
@@ -34,20 +32,20 @@ export declare const clipbus: {
         complete: (payload: PluginActionCompletePayload) => Promise<PluginActionCompleteResponse>;
         draft: {
             current: () => Record<string, unknown> | undefined;
-            on: (fn: (payload: Record<string, unknown>) => void) => import("../internal/topic.js").Unsubscribe;
+            on: (listener: (event: Record<string, unknown>) => void) => import("../internal/topic.js").Unsubscribe;
         };
         input: {
-            current: () => PluginActionUIInput | undefined;
-            on: (fn: (payload: PluginActionUIInput) => void) => import("../internal/topic.js").Unsubscribe;
+            current: () => import("./data.generated.js").PluginActionUIInput | undefined;
+            on: (listener: (event: import("./data.generated.js").PluginActionUIInput) => void) => import("../internal/topic.js").Unsubscribe;
         };
         onHostInvoke: {
-            on: (fn: (payload: PluginActionHostInvokePayload) => void) => import("../internal/topic.js").Unsubscribe;
+            on: (listener: (event: import("./hostEvents.generated.js").PluginActionHostInvokePayload) => void) => import("../internal/topic.js").Unsubscribe;
         };
     };
     attachmentRenderer: {
         setButtons: (payload: PluginAttachmentRendererSetButtonsPayload) => Promise<PluginAttachmentRendererSetButtonsResponse>;
         onHostInvoke: {
-            on: (fn: (payload: PluginAttachmentHostInvokePayload) => void) => import("../internal/topic.js").Unsubscribe;
+            on: (listener: (event: import("./hostEvents.generated.js").PluginAttachmentHostInvokePayload) => void) => import("../internal/topic.js").Unsubscribe;
         };
     };
     window: {
@@ -58,10 +56,10 @@ export declare const clipbus: {
         open: (payload: PluginInfoPanelOpenPayload) => Promise<PluginInfoPanelOpenResponse>;
         close: (payload: PluginInfoPanelClosePayload) => Promise<PluginInfoPanelCloseResponse>;
         onAction: {
-            on: (fn: (payload: PluginInfoPanelOnActionPayload) => void) => import("../internal/topic.js").Unsubscribe;
+            on: (listener: (event: import("./hostEvents.generated.js").PluginInfoPanelOnActionPayload) => void) => import("../internal/topic.js").Unsubscribe;
         };
         onClose: {
-            on: (fn: (payload: PluginInfoPanelOnClosePayload) => void) => import("../internal/topic.js").Unsubscribe;
+            on: (listener: (event: import("./hostEvents.generated.js").PluginInfoPanelOnClosePayload) => void) => import("../internal/topic.js").Unsubscribe;
         };
     };
     settings: {
@@ -70,20 +68,21 @@ export declare const clipbus: {
     };
     console: {
         log: (payload: PluginConsoleLogPayload) => Promise<PluginConsoleLogResponse>;
+        diagnostic: (payload: PluginConsoleDiagnosticPayload) => Promise<PluginConsoleDiagnosticResponse>;
     };
     textInput: {
         stateChanged: (payload: PluginTextInputStateChangedPayload) => Promise<PluginTextInputStateChangedResponse>;
     };
     pluginContext: {
-        current: () => PluginContextPayload | undefined;
-        on: (fn: (payload: PluginContextPayload) => void) => import("../internal/topic.js").Unsubscribe;
+        current: () => import("./hostEvents.generated.js").PluginContextPayload | undefined;
+        on: (listener: (event: import("./hostEvents.generated.js").PluginContextPayload) => void) => import("../internal/topic.js").Unsubscribe;
     };
     theme: {
-        current: () => PluginThemeTokenSnapshot | undefined;
-        on: (fn: (payload: PluginThemeTokenSnapshot) => void) => import("../internal/topic.js").Unsubscribe;
+        current: () => import("./data.generated.js").PluginThemeTokenSnapshot | undefined;
+        on: (listener: (event: import("./data.generated.js").PluginThemeTokenSnapshot) => void) => import("../internal/topic.js").Unsubscribe;
     };
     locale: {
-        current: () => PluginLocalePayload | undefined;
-        on: (fn: (payload: PluginLocalePayload) => void) => import("../internal/topic.js").Unsubscribe;
+        current: () => import("./hostEvents.generated.js").PluginLocalePayload | undefined;
+        on: (listener: (event: import("./hostEvents.generated.js").PluginLocalePayload) => void) => import("../internal/topic.js").Unsubscribe;
     };
 };

package/dist/generated/wireConstants.generated.d.ts

@@ -3,3 +3,24 @@ export declare const CAPABILITIES_GLOBAL: "__CLIPBUS_PLUGIN_CAPABILITIES__";
 export declare const CAPABILITY_UNSUPPORTED_ERROR_NAME: "PluginCapabilityUnsupported";
 export declare const PLUGIN_CALL_HANDLER_NAME: "clipbusPluginCall";
 export declare const WINDOW_SET_HEIGHT_METHOD: "window.setHeight";
+export declare const WIRE_ERROR_NAMES: {
+    readonly methodNotFound: "PluginRuntimeMethodNotFound";
+    readonly handlerNotFound: "PluginRuntimeHandlerNotFound";
+    readonly invocationExpired: "PluginRuntimeInvocationExpired";
+    readonly hostCallLimitExceeded: "PluginRuntimeHostCallLimitExceeded";
+    readonly hostBridgeUnavailable: "PluginHostBridgeUnavailable";
+};
+export declare const NODE_IPC_WIRE_KEYS: {
+    readonly id: "id";
+    readonly method: "method";
+    readonly request: "request";
+    readonly response: "response";
+    readonly error: "error";
+};
+export declare const NODE_IPC_LIMITS: {
+    readonly maximumFrameBytes: 67108864;
+    readonly maximumJsonDepth: 64;
+    readonly maximumIdentifierCharacters: 128;
+    readonly maximumErrorMessageBytes: 4096;
+    readonly maximumOutstandingRequests: 1;
+};

package/dist/internal/capabilities.d.ts

@@ -1,4 +1,4 @@
-import type { CapabilityMethodName } from '../generated/capabilityClients.generated.js';
+import type { CapabilityMethodName } from '../generated/capabilities.generated.js';
 /**
  * 宿主不支持某 capability 时抛出的类型化错误。
  * 插件可通过 `instanceof CapabilityUnsupportedError` 识别并降级处理。

package/dist/internal/hostEvents.d.ts

@@ -0,0 +1,15 @@
+import { type HostEventName, type PluginHostEventMap } from '../generated/hostEvents.generated.js';
+import { type Stream, type Topic } from './topic.js';
+export declare function onHostEvent<K extends HostEventName>(name: K, listener: (payload: PluginHostEventMap[K]) => void): () => void;
+/** Latest-value topic, seeded from the event's window global. */
+export declare function createHostTopic<K extends HostEventName>(name: K): Topic<PluginHostEventMap[K]>;
+export declare function createHostStream<K extends HostEventName>(name: K): Stream<PluginHostEventMap[K]>;
+/** Publish a host event the way the Host does: assign its window global, then dispatch. */
+export declare function publishHostEvent<K extends HostEventName>(name: K, payload: PluginHostEventMap[K]): void;
+/**
+ * Publish a bootstrap payload set; `events` is a generated per-context map of
+ * field → host event. Absent fields are skipped; order follows the catalog.
+ */
+export declare function publishBootstrap<B extends object>(events: {
+    readonly [F in keyof B]-?: HostEventName;
+}, payloads: B): void;

package/dist/internal/pluginCall.d.ts

@@ -0,0 +1,11 @@
+import type { CapabilityMethodName, PluginCapabilityMap, PluginRuntimeInvokePayload } from '../generated/capabilities.generated.js';
+/**
+ * Call a Host capability. Fails loud: throws `PluginHostBridgeUnavailable`
+ * outside a plugin WebView and rethrows Host rejections with their structured
+ * name and data restored. Fire-and-forget callers must catch explicitly.
+ */
+export declare function callPluginMethod<M extends CapabilityMethodName>(method: M, payload: PluginCapabilityMap[M]['payload']): Promise<PluginCapabilityMap[M]['response']>;
+/** `runtime.invoke` with the `{ response }` envelope unwrapped. */
+export declare function callRuntimeInvoke<TResp = unknown>(payload: PluginRuntimeInvokePayload): Promise<TResp>;
+/** Decode a Host rejection, restoring a structured `{ name, message, data }` error when present. */
+export declare function parseReplyError(raw: unknown): Error;

package/dist/internal/pluginContext.d.ts

@@ -0,0 +1,6 @@
+import type { PluginContextPayload } from '../generated/hostEvents.generated.js';
+import type { Topic } from './topic.js';
+export declare class PluginContextError extends Error {
+    constructor(message: string);
+}
+export declare function guardContext<A extends unknown[], R>(contextTopic: Topic<PluginContextPayload>, expected: PluginContextPayload['mode'], run: (...args: A) => R): (...args: A) => R;

package/dist/preview/index.cjs

@@ -1337,53 +1337,46 @@ function defaultReplyFor(method) {
   return {};
 }
 
-// src/generated/hostBootstrap.generated.ts
-function emitAttachmentBootstrap(p) {
-  if (p.context !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_CONTEXT__"] = p.context;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-context", { detail: p.context }));
-  }
-  if (p.item !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_ITEM__"] = p.item;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-item", { detail: p.item }));
-  }
-  if (p.attachment !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_ATTACHMENT__"] = p.attachment;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-attachment", { detail: p.attachment }));
-  }
-  if (p.theme !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_THEME__"] = p.theme;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-theme", { detail: p.theme }));
-  }
-  if (p.locale !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_LOCALE__"] = p.locale;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-locale", { detail: p.locale }));
-  }
+// src/generated/hostEvents.generated.ts
+var HOST_EVENT_WINDOW_GLOBALS = {
+  "clipbus-plugin-context": "__CLIPBUS_PLUGIN_CONTEXT__",
+  "clipbus-plugin-item": "__CLIPBUS_PLUGIN_ITEM__",
+  "clipbus-plugin-attachment": "__CLIPBUS_PLUGIN_ATTACHMENT__",
+  "clipbus-plugin-draft": "__CLIPBUS_PLUGIN_DRAFT__",
+  "clipbus-plugin-action-input": "__CLIPBUS_PLUGIN_ACTION_INPUT__",
+  "clipbus-plugin-theme": "__CLIPBUS_PLUGIN_THEME__",
+  "clipbus-plugin-attachment-host-invoke": null,
+  "clipbus-plugin-action-host-invoke": null,
+  "clipbus-plugin-info-panel-on-action": null,
+  "clipbus-plugin-info-panel-on-close": null,
+  "clipbus-plugin-locale": "__CLIPBUS_PLUGIN_LOCALE__"
+};
+var ATTACHMENT_BOOTSTRAP_EVENTS = {
+  context: "clipbus-plugin-context",
+  item: "clipbus-plugin-item",
+  attachment: "clipbus-plugin-attachment",
+  theme: "clipbus-plugin-theme",
+  locale: "clipbus-plugin-locale"
+};
+var ACTION_BOOTSTRAP_EVENTS = {
+  context: "clipbus-plugin-context",
+  item: "clipbus-plugin-item",
+  draft: "clipbus-plugin-draft",
+  actionInput: "clipbus-plugin-action-input",
+  theme: "clipbus-plugin-theme",
+  locale: "clipbus-plugin-locale"
+};
+
+// src/internal/hostEvents.ts
+function publishHostEvent(name, payload) {
+  const windowGlobal = HOST_EVENT_WINDOW_GLOBALS[name];
+  if (windowGlobal !== null) globalThis[windowGlobal] = payload;
+  globalThis.dispatchEvent(new CustomEvent(name, { detail: payload }));
 }
-function emitActionBootstrap(p) {
-  if (p.context !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_CONTEXT__"] = p.context;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-context", { detail: p.context }));
-  }
-  if (p.item !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_ITEM__"] = p.item;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-item", { detail: p.item }));
-  }
-  if (p.draft !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_DRAFT__"] = p.draft;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-draft", { detail: p.draft }));
-  }
-  if (p.actionInput !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_ACTION_INPUT__"] = p.actionInput;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-action-input", { detail: p.actionInput }));
-  }
-  if (p.theme !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_THEME__"] = p.theme;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-theme", { detail: p.theme }));
-  }
-  if (p.locale !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_LOCALE__"] = p.locale;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-locale", { detail: p.locale }));
+function publishBootstrap(events, payloads) {
+  for (const field of Object.keys(events)) {
+    const value = payloads[field];
+    if (value !== void 0) publishHostEvent(events[field], value);
   }
 }
 
@@ -1421,7 +1414,7 @@ function computeWirePayloads(scenario, themeKey = DEFAULT_THEME_KEY) {
 }
 function injectWire(_target, payloads) {
   if (payloads.mode === "attachmentRenderer") {
-    emitAttachmentBootstrap({
+    publishBootstrap(ATTACHMENT_BOOTSTRAP_EVENTS, {
       context: payloads.context,
       item: payloads.item,
       attachment: payloads.attachment,
@@ -1429,7 +1422,7 @@ function injectWire(_target, payloads) {
       locale: payloads.locale
     });
   } else {
-    emitActionBootstrap({
+    publishBootstrap(ACTION_BOOTSTRAP_EVENTS, {
       context: payloads.context,
       item: payloads.item,
       draft: payloads.draft,

package/dist/preview/index.js

@@ -1294,53 +1294,46 @@ function defaultReplyFor(method) {
   return {};
 }
 
-// src/generated/hostBootstrap.generated.ts
-function emitAttachmentBootstrap(p) {
-  if (p.context !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_CONTEXT__"] = p.context;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-context", { detail: p.context }));
-  }
-  if (p.item !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_ITEM__"] = p.item;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-item", { detail: p.item }));
-  }
-  if (p.attachment !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_ATTACHMENT__"] = p.attachment;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-attachment", { detail: p.attachment }));
-  }
-  if (p.theme !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_THEME__"] = p.theme;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-theme", { detail: p.theme }));
-  }
-  if (p.locale !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_LOCALE__"] = p.locale;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-locale", { detail: p.locale }));
-  }
+// src/generated/hostEvents.generated.ts
+var HOST_EVENT_WINDOW_GLOBALS = {
+  "clipbus-plugin-context": "__CLIPBUS_PLUGIN_CONTEXT__",
+  "clipbus-plugin-item": "__CLIPBUS_PLUGIN_ITEM__",
+  "clipbus-plugin-attachment": "__CLIPBUS_PLUGIN_ATTACHMENT__",
+  "clipbus-plugin-draft": "__CLIPBUS_PLUGIN_DRAFT__",
+  "clipbus-plugin-action-input": "__CLIPBUS_PLUGIN_ACTION_INPUT__",
+  "clipbus-plugin-theme": "__CLIPBUS_PLUGIN_THEME__",
+  "clipbus-plugin-attachment-host-invoke": null,
+  "clipbus-plugin-action-host-invoke": null,
+  "clipbus-plugin-info-panel-on-action": null,
+  "clipbus-plugin-info-panel-on-close": null,
+  "clipbus-plugin-locale": "__CLIPBUS_PLUGIN_LOCALE__"
+};
+var ATTACHMENT_BOOTSTRAP_EVENTS = {
+  context: "clipbus-plugin-context",
+  item: "clipbus-plugin-item",
+  attachment: "clipbus-plugin-attachment",
+  theme: "clipbus-plugin-theme",
+  locale: "clipbus-plugin-locale"
+};
+var ACTION_BOOTSTRAP_EVENTS = {
+  context: "clipbus-plugin-context",
+  item: "clipbus-plugin-item",
+  draft: "clipbus-plugin-draft",
+  actionInput: "clipbus-plugin-action-input",
+  theme: "clipbus-plugin-theme",
+  locale: "clipbus-plugin-locale"
+};
+
+// src/internal/hostEvents.ts
+function publishHostEvent(name, payload) {
+  const windowGlobal = HOST_EVENT_WINDOW_GLOBALS[name];
+  if (windowGlobal !== null) globalThis[windowGlobal] = payload;
+  globalThis.dispatchEvent(new CustomEvent(name, { detail: payload }));
 }
-function emitActionBootstrap(p) {
-  if (p.context !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_CONTEXT__"] = p.context;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-context", { detail: p.context }));
-  }
-  if (p.item !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_ITEM__"] = p.item;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-item", { detail: p.item }));
-  }
-  if (p.draft !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_DRAFT__"] = p.draft;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-draft", { detail: p.draft }));
-  }
-  if (p.actionInput !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_ACTION_INPUT__"] = p.actionInput;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-action-input", { detail: p.actionInput }));
-  }
-  if (p.theme !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_THEME__"] = p.theme;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-theme", { detail: p.theme }));
-  }
-  if (p.locale !== void 0) {
-    globalThis["__CLIPBUS_PLUGIN_LOCALE__"] = p.locale;
-    globalThis.dispatchEvent(new CustomEvent("clipbus-plugin-locale", { detail: p.locale }));
+function publishBootstrap(events, payloads) {
+  for (const field of Object.keys(events)) {
+    const value = payloads[field];
+    if (value !== void 0) publishHostEvent(events[field], value);
   }
 }
 
@@ -1378,7 +1371,7 @@ function computeWirePayloads(scenario, themeKey = DEFAULT_THEME_KEY) {
 }
 function injectWire(_target, payloads) {
   if (payloads.mode === "attachmentRenderer") {
-    emitAttachmentBootstrap({
+    publishBootstrap(ATTACHMENT_BOOTSTRAP_EVENTS, {
       context: payloads.context,
       item: payloads.item,
       attachment: payloads.attachment,
@@ -1386,7 +1379,7 @@ function injectWire(_target, payloads) {
       locale: payloads.locale
     });
   } else {
-    emitActionBootstrap({
+    publishBootstrap(ACTION_BOOTSTRAP_EVENTS, {
       context: payloads.context,
       item: payloads.item,
       draft: payloads.draft,

package/dist/preview/wire.d.ts

@@ -1,5 +1,5 @@
 import type { PluginThemeTokenSnapshot } from '../generated/data.generated.js';
-import type { PluginContextPayload, PluginLocalePayload } from '../generated/hostBootstrap.generated.js';
+import { type PluginContextPayload, type PluginLocalePayload } from '../generated/hostEvents.generated.js';
 import type { PluginActionUIInput, PluginAttachmentPayload, PluginClipboardItem } from '../generated/data.generated.js';
 import type { PreviewScenario } from './types.js';
 /**
@@ -34,7 +34,7 @@ export declare function computeWirePayloads(scenario: PreviewScenario, themeKey?
  * The `target` parameter is a forward-looking seam for future iframe support.
  *
  * No hardcoded global names or event names — all delegation flows through the
- * generated emitAttachmentBootstrap / emitActionBootstrap functions.
+ * generated per-context bootstrap event sets.
  */
 export declare function injectWire(_target: Window, payloads: WirePayloads): void;
 /**

package/dist/runtime/defineMessage.d.ts

@@ -1,5 +1,5 @@
 import type { MessageContract } from '../shared/defineMessage.js';
-import type { MessageHandler, MessageHandlerContext } from '../generated/runtime.definePlugin.generated.js';
+import type { MessageHandler, MessageHandlerContext } from '../generated/runtime.registry.generated.js';
 export interface RuntimeMessageContract<TReq, TResp> extends MessageContract<TReq, TResp> {
     handle(fn: (req: TReq, ctx: MessageHandlerContext) => Promise<TResp> | TResp): readonly [string, MessageHandler];
 }

package/dist/runtime/definePlugin.d.ts

@@ -0,0 +1,2 @@
+import type { PluginRegistry, PluginSetup } from '../generated/runtime.registry.generated.js';
+export declare function definePlugin(definition: PluginRegistry | PluginSetup): PluginSetup;

package/dist/runtime/index.cjs

@@ -23,84 +23,16 @@ __export(index_exports, {
   CapabilityUnsupportedError: () => CapabilityUnsupportedError,
   actionResult: () => actionResult,
   defineMessage: () => defineMessage,
-  definePlugin: () => definePlugin,
-  host: () => host
+  definePlugin: () => definePlugin
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/internal/internalConsole.ts
-function pick(method) {
-  if (typeof globalThis === "undefined") return () => {
-  };
-  const g = globalThis;
-  const fn = g.console?.[method];
-  if (typeof fn !== "function") return () => {
-  };
-  return fn.bind(g.console);
-}
-var internalConsole = Object.freeze({
-  log: pick("log"),
-  warn: pick("warn"),
-  error: pick("error")
-});
-
-// src/internal/ipcBus.ts
-var _instance = null;
-var ipcBus = new Proxy({}, {
-  get(_target, prop) {
-    if (!_instance) {
-      throw new Error("[clipbus-plugin] ipcBus accessed before configureIpcBus() was called.");
-    }
-    return _instance[prop];
-  }
-});
-
-// src/generated/runtime.host.generated.ts
-var host = {
-  item: {
-    setTags: (payload) => ipcBus.request("item.setTags", payload),
-    addTags: (payload) => ipcBus.request("item.addTags", payload),
-    removeTags: (payload) => ipcBus.request("item.removeTags", payload),
-    setPinned: (payload) => ipcBus.request("item.setPinned", payload),
-    setAttachments: (payload) => ipcBus.request("item.setAttachments", payload),
-    setSearchExtension: (payload) => ipcBus.request("item.setSearchExtension", payload),
-    materializeImagePath: () => ipcBus.request("item.materializeImagePath", {}),
-    readAttachment: (payload) => ipcBus.request("item.readAttachment", payload)
-  },
-  asset: {
-    registerImage: (payload) => ipcBus.request("asset.registerImage", payload)
-  },
-  clipboard: {
-    copyText: (payload) => ipcBus.request("clipboard.copyText", payload)
-  },
-  navigation: {
-    openUrl: (payload) => ipcBus.request("navigation.openUrl", payload),
-    revealInFinder: (payload) => ipcBus.request("navigation.revealInFinder", payload),
-    openFilePath: (payload) => ipcBus.request("navigation.openFilePath", payload)
-  },
-  action: {
-    allocateImageTempPath: (payload) => ipcBus.request("action.allocateImageTempPath", payload),
-    materializeInputImagePath: () => ipcBus.request("action.materializeInputImagePath", {}),
-    allocateOutputFilePath: (payload) => ipcBus.request("action.allocateOutputFilePath", payload)
-  },
-  settings: {
-    get: (payload) => ipcBus.request("settings.get", payload),
-    getAll: () => ipcBus.request("settings.getAll", {})
-  },
-  console: {
-    log: (payload) => ipcBus.request("console.log", payload)
-  },
-  locale: {
-    get: () => ipcBus.request("locale.get", {})
-  }
-};
-
-// src/generated/runtime.definePlugin.generated.ts
+// src/runtime/definePlugin.ts
 function definePlugin(definition) {
   if ("setup" in definition) {
     return {
-      setup() {
-        const registry = definition.setup();
+      setup(context) {
+        const registry = definition.setup(context);
         validateRegistry(registry);
         return registry;
       }
@@ -112,14 +44,11 @@ function definePlugin(definition) {
   } };
 }
 function validateRegistry(registry) {
-  for (const [id, handler] of Object.entries(registry.attachmentRenderers ?? {})) {
-    if (handler && typeof handler === "object" && "invokeOperation" in handler) {
-      throw new Error(`attachmentRenderers["${id}"]: invokeOperation has been removed.`);
-    }
-  }
-  for (const [id, handler] of Object.entries(registry.actions ?? {})) {
-    if (handler && typeof handler === "object" && "invokeOperation" in handler) {
-      throw new Error(`actions["${id}"]: invokeOperation has been removed.`);
+  for (const key of ["attachmentRenderers", "actions"]) {
+    for (const [id, handler] of Object.entries(registry[key] ?? {})) {
+      if (handler && typeof handler === "object" && "invokeOperation" in handler) {
+        throw new Error(`${key}["${id}"]: invokeOperation has been removed.`);
+      }
     }
   }
 }
@@ -167,6 +96,5 @@ var CapabilityUnsupportedError = class extends Error {
   CapabilityUnsupportedError,
   actionResult,
   defineMessage,
-  definePlugin,
-  host
+  definePlugin
 });

package/dist/runtime/index.d.cts

@@ -1,4 +1,10 @@
-export * from '../generated/INDEX.runtime.generated.js';
+export { definePlugin } from './definePlugin.js';
+export { actionResult } from '../generated/runtime.actionResult.generated.js';
 export { defineMessage } from './defineMessage.js';
 export type { RuntimeMessageContract } from './defineMessage.js';
 export { CapabilityUnsupportedError } from '../internal/capabilities.js';
+export type * from '../generated/data.generated.js';
+export type * from '../generated/capabilities.generated.js';
+export type * from '../generated/hostClients.generated.js';
+export type * from '../generated/runtime.handlers.generated.js';
+export type * from '../generated/runtime.registry.generated.js';

package/dist/runtime/index.d.ts

@@ -1,4 +1,10 @@
-export * from '../generated/INDEX.runtime.generated.js';
+export { definePlugin } from './definePlugin.js';
+export { actionResult } from '../generated/runtime.actionResult.generated.js';
 export { defineMessage } from './defineMessage.js';
 export type { RuntimeMessageContract } from './defineMessage.js';
 export { CapabilityUnsupportedError } from '../internal/capabilities.js';
+export type * from '../generated/data.generated.js';
+export type * from '../generated/capabilities.generated.js';
+export type * from '../generated/hostClients.generated.js';
+export type * from '../generated/runtime.handlers.generated.js';
+export type * from '../generated/runtime.registry.generated.js';