@qping/plugin-bus 0.3.0 → 0.4.0

package/dist/actions.d.ts

@@ -152,26 +152,44 @@ export type DetailRequest = {
     title?: string;
     initialState?: unknown;
 };
-/**
- * The result of running an action. Every field is optional and they combine: opening an IDE and
- * closing the search window is `{ host: {...}, close: true }`.
- */
-export type ActionOutcome = {
-    /** Run a host-side action (clipboard, process launch, browser, ...). */
-    host?: HostActionRequest;
-    /** Hand off to the detail page; arrives as `host.event.detailAction` with this payload. */
-    web?: {
-        payload?: unknown;
-    };
-    /** Open a web detail page. */
-    detail?: DetailRequest;
+export type ActionTarget = 
+/** Run one privileged host-side action (clipboard, process launch, browser, ...). */
+{
+    kind: "host";
+    action: HostActionRequest;
+}
+/** Hand off to the currently active detail page as host.event.detailAction. */
+ | {
+    kind: "web";
+    payload?: unknown;
+}
+/** Open a new web detail page. */
+ | ({
+    kind: "detail";
+} & DetailRequest);
+export type ActionAfter = "keep" | "close" | "refresh";
+type ActionOutcomeBase = {
     /** Status bar text. */
     message?: LocalizedText;
-    /** Close the search window afterwards. Defaults to false. */
-    close?: boolean;
-    /** Refresh the current search results afterwards. Defaults to false. */
-    refresh?: boolean;
 };
+/**
+ * The result of running an action. An action selects at most one execution target. Host targets
+ * may choose a follow-up lifecycle action; web and detail targets keep their current surface alive.
+ */
+export type ActionOutcome = ActionOutcomeBase & ({
+    target?: undefined;
+    after?: ActionAfter;
+} | {
+    target: Extract<ActionTarget, {
+        kind: "host";
+    }>;
+    after?: ActionAfter;
+} | {
+    target: Exclude<ActionTarget, {
+        kind: "host";
+    }>;
+    after?: "keep";
+});
 /**
  * What an action sees when it runs. `item` is the original object returned by `search()`,
  * including fields the host never saw — the SDK keeps it so actions do not have to re-derive
@@ -202,3 +220,4 @@ export type ActionManifestEntry = {
     hotkey?: Hotkey;
 };
 export declare function toActionManifest(definition: ActionDefinition): ActionManifestEntry;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qping/plugin-bus",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "v3 message-bus runtime for MyTools plugins (named-pipe transport).",
   "type": "module",
   "files": [
@@ -28,17 +28,17 @@
       "import": "./dist/webClient.mjs",
       "default": "./dist/webClient.mjs"
     },
-    "./i18n": {
-      "types": "./dist/i18n.d.ts",
-      "import": "./dist/i18n.mjs",
-      "default": "./dist/i18n.mjs"
-    },
-    "./search": {
-      "types": "./dist/search.d.ts",
-      "import": "./dist/search.mjs",
-      "default": "./dist/search.mjs"
-    },
-    "./dev": {
+    "./i18n": {
+      "types": "./dist/i18n.d.ts",
+      "import": "./dist/i18n.mjs",
+      "default": "./dist/i18n.mjs"
+    },
+    "./search": {
+      "types": "./dist/search.d.ts",
+      "import": "./dist/search.mjs",
+      "default": "./dist/search.mjs"
+    },
+    "./dev": {
       "types": "./dist/dev.d.ts",
       "import": "./dist/dev.mjs",
       "default": "./dist/dev.mjs"

package/src/actions.ts

@@ -89,31 +89,37 @@ export type HostActionRequest =
   | { kind: typeof HostAction.Run; command: RunSpec }
   | { kind: typeof HostAction.Kill; pid: number };
 
-/** Opens a web detail page. `page` defaults to the entry declared in plugin.json. */
-export type DetailRequest = {
-  page?: string;
-  title?: string;
-  initialState?: unknown;
-};
-
-/**
- * The result of running an action. Every field is optional and they combine: opening an IDE and
- * closing the search window is `{ host: {...}, close: true }`.
- */
-export type ActionOutcome = {
-  /** Run a host-side action (clipboard, process launch, browser, ...). */
-  host?: HostActionRequest;
-  /** Hand off to the detail page; arrives as `host.event.detailAction` with this payload. */
-  web?: { payload?: unknown };
-  /** Open a web detail page. */
-  detail?: DetailRequest;
-  /** Status bar text. */
-  message?: LocalizedText;
-  /** Close the search window afterwards. Defaults to false. */
-  close?: boolean;
-  /** Refresh the current search results afterwards. Defaults to false. */
-  refresh?: boolean;
+/** Opens a web detail page. `page` defaults to the entry declared in plugin.json. */
+export type DetailRequest = {
+  page?: string;
+  title?: string;
+  initialState?: unknown;
+};
+
+export type ActionTarget =
+  /** Run one privileged host-side action (clipboard, process launch, browser, ...). */
+  | { kind: "host"; action: HostActionRequest }
+  /** Hand off to the currently active detail page as host.event.detailAction. */
+  | { kind: "web"; payload?: unknown }
+  /** Open a new web detail page. */
+  | ({ kind: "detail" } & DetailRequest);
+
+export type ActionAfter = "keep" | "close" | "refresh";
+
+type ActionOutcomeBase = {
+  /** Status bar text. */
+  message?: LocalizedText;
 };
+
+/**
+ * The result of running an action. An action selects at most one execution target. Host targets
+ * may choose a follow-up lifecycle action; web and detail targets keep their current surface alive.
+ */
+export type ActionOutcome = ActionOutcomeBase & (
+  | { target?: undefined; after?: ActionAfter }
+  | { target: Extract<ActionTarget, { kind: "host" }>; after?: ActionAfter }
+  | { target: Exclude<ActionTarget, { kind: "host" }>; after?: "keep" }
+);
 
 /**
  * What an action sees when it runs. `item` is the original object returned by `search()`,