@lynx-js/lynxtron 0.0.1-alpha.7 → 0.0.1-alpha.9

package/apis/api/base-window.d.ts

@@ -742,10 +742,10 @@ export declare class BaseWindow extends EventEmitter {
     listener: (event: Event, direction: string) => void
   ): this;
   /**
-   * Emitted when the system context menu is triggered on the window, this is
-   * normally only triggered when the user right clicks on the non-client area of
-   * your window.  This is the window titlebar or any area you have declared as
-   * `-webkit-app-region: drag` in a frameless window.
+   * Emitted when the system context menu is triggered on the window. This is
+   * normally triggered when the user right clicks the system title bar or a
+   * draggable region in the Lynx UI. In a frameless window, draggable regions
+   * must be explicitly declared using the `-x-app-region: drag` CSS property.
    *
    * Calling `event.preventDefault()` will prevent the menu from being displayed.
    *

package/apis/api/lynx-bridge.d.ts

@@ -0,0 +1,34 @@
+// Copyright 2026 The Lynxtron Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+
+import { LynxBridgeInvokeEvent } from './lynx-window';
+
+export type LynxBridgeHandler = (
+  event: LynxBridgeInvokeEvent,
+  args: unknown
+) => unknown | Promise<unknown>;
+
+export interface LynxBridge extends NodeJS.EventEmitter {
+  /**
+   * Register a handler for an invoke method. The handler will be called when
+   * the Lynx side calls `bridge.call(method, args)`.
+   *
+   * The return value of the handler will be sent back to the Lynx side via
+   * `event.sendReply()`.
+   */
+  handle(method: string, handler: LynxBridgeHandler): void;
+
+  /**
+   * Register a one-time handler for an invoke method. The handler will be
+   * removed after it is called once.
+   */
+  handleOnce(method: string, handler: LynxBridgeHandler): void;
+
+  /**
+   * Remove a previously registered handler for the given method.
+   */
+  removeHandler(method: string): void;
+}
+
+export declare const lynxBridge: LynxBridge;

package/apis/lynxtron.d.ts

@@ -19,6 +19,7 @@ export * from './api/base-window';
 export * from './api/clipboard';
 export * from './api/event';
 export * from './api/lynx-window';
+export * from './api/lynx-bridge';
 export * from './api/lynx-library';
 export * from './api/touch-bar';
 export * from './api/screen';

package/lynxtron.js

@@ -39,5 +39,6 @@ export const Tray = lynxtron.Tray;
 export const LynxTemplateData = lynxtron.LynxTemplateData;
 export const LynxUpdateMeta = lynxtron.LynxUpdateMeta;
 export const powerMonitor = lynxtron.powerMonitor;
+export const lynxBridge = lynxtron.lynxBridge;
 
 export const lynx = Object.freeze({});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynx-js/lynxtron",
-  "version": "0.0.1-alpha.7",
+  "version": "0.0.1-alpha.9",
   "description": "lynxtron npm package test",
   "type": "module",
   "types": "./apis/lynxtron.d.ts",