@makaio/framework 1.0.0-dev-1781022866275 → 1.0.0-dev-1781023871421

package/dist/index-eemAKwsB.d.mts

@@ -0,0 +1,362 @@
+import * as _$zod from "zod";
+import { z } from "zod";
+import * as _$_makaio_core0 from "@makaio/framework/core";
+import * as _$zod_v4_core0 from "zod/v4/core";
+
+//#region core/contracts/src/host/namespace.d.ts
+/** Bus namespace definition for cross-cutting host shell RPCs. */
+declare const HostNamespace: _$_makaio_core0.BusNamespaceDefinition<"host", {
+  'window.opened': _$zod.ZodObject<{
+    windowId: _$zod.ZodNumber;
+    registrationId: _$zod.ZodString;
+    params: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+    label: _$zod.ZodOptional<_$zod.ZodString>;
+    visible: _$zod.ZodBoolean;
+    focused: _$zod.ZodBoolean;
+  }, _$zod_v4_core0.$strip>;
+  'window.closed': _$zod.ZodObject<{
+    windowId: _$zod.ZodNumber;
+    registrationId: _$zod.ZodString;
+    params: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+  }, _$zod_v4_core0.$strip>;
+  'window.labelChanged': _$zod.ZodObject<{
+    windowId: _$zod.ZodNumber;
+    label: _$zod.ZodString;
+  }, _$zod_v4_core0.$strip>;
+  'window.create': {
+    request: _$zod.ZodObject<{
+      registrationId: _$zod.ZodString;
+      params: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      windowId: _$zod.ZodNumber;
+    }, _$zod_v4_core0.$strip>;
+  };
+  'window.focus': {
+    request: _$zod.ZodObject<{
+      windowId: _$zod.ZodOptional<_$zod.ZodNumber>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      success: _$zod.ZodBoolean;
+    }, _$zod_v4_core0.$strip>;
+  };
+  'window.list': {
+    request: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      windows: _$zod.ZodArray<_$zod.ZodObject<{
+        windowId: _$zod.ZodNumber;
+        registrationId: _$zod.ZodString;
+        params: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+        label: _$zod.ZodOptional<_$zod.ZodString>;
+        visible: _$zod.ZodBoolean;
+        focused: _$zod.ZodBoolean;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  'window.openDashboard': {
+    request: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      windowId: _$zod.ZodNullable<_$zod.ZodNumber>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  'tray.activate': {
+    request: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      handled: _$zod.ZodBoolean;
+    }, _$zod_v4_core0.$strip>;
+  };
+  'app.focus': {
+    request: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      focused: _$zod.ZodBoolean;
+      windowId: _$zod.ZodNullable<_$zod.ZodNumber>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  'app.shutdown': {
+    request: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+  };
+}>;
+/** Typed subject tree for the host namespace. */
+declare const HostSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSubjectDefinitions<"host", {
+  'window.opened': _$zod.ZodObject<{
+    windowId: _$zod.ZodNumber;
+    registrationId: _$zod.ZodString;
+    params: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+    label: _$zod.ZodOptional<_$zod.ZodString>;
+    visible: _$zod.ZodBoolean;
+    focused: _$zod.ZodBoolean;
+  }, _$zod_v4_core0.$strip>;
+  'window.closed': _$zod.ZodObject<{
+    windowId: _$zod.ZodNumber;
+    registrationId: _$zod.ZodString;
+    params: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+  }, _$zod_v4_core0.$strip>;
+  'window.labelChanged': _$zod.ZodObject<{
+    windowId: _$zod.ZodNumber;
+    label: _$zod.ZodString;
+  }, _$zod_v4_core0.$strip>;
+  'window.create': {
+    request: _$zod.ZodObject<{
+      registrationId: _$zod.ZodString;
+      params: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      windowId: _$zod.ZodNumber;
+    }, _$zod_v4_core0.$strip>;
+  };
+  'window.focus': {
+    request: _$zod.ZodObject<{
+      windowId: _$zod.ZodOptional<_$zod.ZodNumber>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      success: _$zod.ZodBoolean;
+    }, _$zod_v4_core0.$strip>;
+  };
+  'window.list': {
+    request: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      windows: _$zod.ZodArray<_$zod.ZodObject<{
+        windowId: _$zod.ZodNumber;
+        registrationId: _$zod.ZodString;
+        params: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+        label: _$zod.ZodOptional<_$zod.ZodString>;
+        visible: _$zod.ZodBoolean;
+        focused: _$zod.ZodBoolean;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  'window.openDashboard': {
+    request: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      windowId: _$zod.ZodNullable<_$zod.ZodNumber>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  'tray.activate': {
+    request: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      handled: _$zod.ZodBoolean;
+    }, _$zod_v4_core0.$strip>;
+  };
+  'app.focus': {
+    request: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      focused: _$zod.ZodBoolean;
+      windowId: _$zod.ZodNullable<_$zod.ZodNumber>;
+    }, _$zod_v4_core0.$strip>;
+  };
+  'app.shutdown': {
+    request: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{}, _$zod_v4_core0.$strip>;
+  };
+}>, "host">;
+//#endregion
+//#region core/contracts/src/host/schemas.d.ts
+/**
+ * Desktop host window state snapshot.
+ *
+ * `registrationId` is the qualified window ID from the package registry
+ * (`{packageName}:{windowId}`) and replaces the former static `WindowType`
+ * enum field. The numeric `windowId` remains the host-assigned instance ID.
+ */
+declare const WindowStateSchema: z.ZodObject<{
+  windowId: z.ZodNumber;
+  registrationId: z.ZodString;
+  params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  label: z.ZodOptional<z.ZodString>;
+  visible: z.ZodBoolean;
+  focused: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Host shell domain schemas.
+ *
+ * Cross-cutting RPCs that any host shell (Electron, Electrobun, browser)
+ * should implement. Framework UI packages import these subjects directly
+ * from `@makaio/contracts` instead of reaching into a specific host app.
+ *
+ * Covers window lifecycle events (host → bus) consumed by the tray,
+ * and window management RPCs (bus → host) issued by the tray.
+ */
+declare const HostSchemas: {
+  /**
+   * Emitted when a new desktop window is opened.
+   *
+   * Subject: `host.window.opened`
+   * Type: Event
+   */
+  'window.opened': z.ZodObject<{
+    windowId: z.ZodNumber;
+    registrationId: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    label: z.ZodOptional<z.ZodString>;
+    visible: z.ZodBoolean;
+    focused: z.ZodBoolean;
+  }, z.core.$strip>;
+  /**
+   * Emitted when a desktop window is closed.
+   *
+   * Subject: `host.window.closed`
+   * Type: Event
+   */
+  'window.closed': z.ZodObject<{
+    windowId: z.ZodNumber;
+    registrationId: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  }, z.core.$strip>;
+  /**
+   * Emitted by the web UI when a window's display label changes — for example,
+   * when a project name becomes available or when the first message of a chat
+   * session is typed.
+   *
+   * The host main process listens for this event and calls
+   * `WindowManager.updateLabel` so the internal registry stays current.
+   * Because the event is on the shared bus, the tray handler can also
+   * react to it (e.g. to update the tray menu item label) without any
+   * additional wiring.
+   *
+   * Subject: `host.window.labelChanged`
+   * Type: Event
+   */
+  'window.labelChanged': z.ZodObject<{
+    windowId: z.ZodNumber;
+    label: z.ZodString;
+  }, z.core.$strip>;
+  /**
+   * Create a new desktop window identified by its registry registration ID.
+   *
+   * Subject: `host.window.create`
+   * Type: Request (RPC)
+   */
+  'window.create': {
+    request: z.ZodObject<{
+      registrationId: z.ZodString;
+      params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      windowId: z.ZodNumber;
+    }, z.core.$strip>;
+  };
+  /**
+   * Focus an existing window. If no `windowId` is provided, focuses the
+   * most recently active window.
+   *
+   * Subject: `host.window.focus`
+   * Type: Request (RPC)
+   */
+  'window.focus': {
+    request: z.ZodObject<{
+      windowId: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      success: z.ZodBoolean;
+    }, z.core.$strip>;
+  };
+  /**
+   * List all currently open desktop windows with their current state.
+   *
+   * Subject: `host.window.list`
+   * Type: Request (RPC)
+   */
+  'window.list': {
+    request: z.ZodObject<{}, z.core.$strip>;
+    response: z.ZodObject<{
+      windows: z.ZodArray<z.ZodObject<{
+        windowId: z.ZodNumber;
+        registrationId: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        label: z.ZodOptional<z.ZodString>;
+        visible: z.ZodBoolean;
+        focused: z.ZodBoolean;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Open (or focus) the primary dashboard window managed by the host shell.
+   *
+   * Request: empty — the handler knows the dashboard registration ID.
+   * Response: `windowId` — the host-assigned window ID, or `null` when no
+   * window could be created or focused.
+   *
+   * Subject: `host.window.openDashboard`
+   * Type: Request (RPC)
+   */
+  'window.openDashboard': {
+    request: z.ZodObject<{}, z.core.$strip>;
+    response: z.ZodObject<{
+      windowId: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Activate the tray popover panel. Fired when the user
+   * left-clicks the tray icon.
+   *
+   * The response tells whether the host handled the click.
+   * When `handled` is `true`, suppress the native menu.
+   * This is `true` for both showing and dismissing the popover (toggle).
+   *
+   * Subject: `host.tray.activate`
+   * Type: Request (RPC)
+   */
+  'tray.activate': {
+    request: z.ZodObject<{}, z.core.$strip>;
+    response: z.ZodObject<{
+      handled: z.ZodBoolean;
+    }, z.core.$strip>;
+  };
+  /**
+   * Focus the application: bring an existing window to front, or open the
+   * default shell window if none are open.
+   *
+   * Used by: second-instance detection (Electrobun health-probe),
+   * `makaio open` CLI command, Electron `second-instance` event.
+   *
+   * Subject: `host.app.focus`
+   * Type: Request (RPC)
+   */
+  'app.focus': {
+    request: z.ZodObject<{}, z.core.$strip>;
+    response: z.ZodObject<{
+      focused: z.ZodBoolean;
+      windowId: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+  };
+  /**
+   * Request graceful application shutdown.
+   *
+   * Saves the window session, closes all windows, tears down the runtime,
+   * bus handlers, tray, and dev server, then exits the process.
+   *
+   * Subject: `host.app.shutdown`
+   * Type: Request (RPC)
+   */
+  'app.shutdown': {
+    request: z.ZodObject<{}, z.core.$strip>;
+    response: z.ZodObject<{}, z.core.$strip>;
+  };
+};
+/** State snapshot for a single desktop window. */
+type WindowState = z.infer<typeof WindowStateSchema>;
+/** Payload of the `host.window.opened` event. */
+type WindowOpenedEvent = z.infer<(typeof HostSchemas)['window.opened']>;
+/** Payload of the `host.window.closed` event. */
+type WindowClosedEvent = z.infer<(typeof HostSchemas)['window.closed']>;
+/** Payload of the `host.window.labelChanged` event. */
+type WindowLabelChangedEvent = z.infer<(typeof HostSchemas)['window.labelChanged']>;
+/** Request payload for `host.window.create`. */
+type WindowCreateRequest = z.infer<(typeof HostSchemas)['window.create']['request']>;
+/** Response payload for `host.window.create`. */
+type WindowCreateResponse = z.infer<(typeof HostSchemas)['window.create']['response']>;
+/** Request payload for `host.window.focus`. */
+type WindowFocusRequest = z.infer<(typeof HostSchemas)['window.focus']['request']>;
+/** Response payload for `host.window.focus`. */
+type WindowFocusResponse = z.infer<(typeof HostSchemas)['window.focus']['response']>;
+/** Request payload for `host.window.list`. */
+type WindowListRequest = z.infer<(typeof HostSchemas)['window.list']['request']>;
+/** Response payload for `host.window.list`. */
+type WindowListResponse = z.infer<(typeof HostSchemas)['window.list']['response']>;
+/** Request payload for `host.tray.activate`. */
+type TrayActivateRequest = z.infer<(typeof HostSchemas)['tray.activate']['request']>;
+/** Response payload for `host.tray.activate`. */
+type TrayActivateResponse = z.infer<(typeof HostSchemas)['tray.activate']['response']>;
+//#endregion
+export { WindowCreateRequest as a, WindowFocusResponse as c, WindowListResponse as d, WindowOpenedEvent as f, HostSubjects as g, HostNamespace as h, WindowClosedEvent as i, WindowLabelChangedEvent as l, WindowStateSchema as m, TrayActivateRequest as n, WindowCreateResponse as o, WindowState as p, TrayActivateResponse as r, WindowFocusRequest as s, HostSchemas as t, WindowListRequest as u };