@lynx-js/lynxtron 0.0.1-alpha.6 → 0.0.1-alpha.8

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/api/lynx-window.d.ts

@@ -26,6 +26,15 @@ export interface LynxWindowConstructorOptions {
    * Window's height in pixels. Default is `600`.
    */
   height?: number;
+  /**
+   * Device scale factor used by windowless rendering. Default is `1`.
+   */
+  deviceScaleFactor?: number;
+  /**
+   * Whether to create the Lynx view with a windowless renderer instead of a
+   * native parent window. Default is `false`.
+   */
+  windowless?: boolean;
   /**
    * (**required** if y is used) Window's left offset from screen. Default is to
    * center the window.
@@ -247,18 +256,18 @@ export interface LynxWindowConstructorOptions {
 }
 
 export interface LynxBridgeInvokeEvent {
-  sendReply(result?: unknown): boolean;
+  sendReply(result?: any): boolean;
 }
 
 export type LynxBridgeInvokeListener = (
   event: LynxBridgeInvokeEvent,
   methodName: string,
-  params: unknown
+  params: any
 ) => void | Promise<void>;
 
 export type LynxBridgeMessageListener = (
   methodName: string,
-  params: unknown
+  params: any
 ) => void;
 
 export declare class LynxWindow extends BaseWindow {

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.6",
+  "version": "0.0.1-alpha.8",
   "description": "lynxtron npm package test",
   "type": "module",
   "types": "./apis/lynxtron.d.ts",

package/utils/env-config.js

@@ -13,8 +13,8 @@ function getPlatformPath (platform) {
       return 'lynxtron.app/Contents/MacOS/lynxtron';
     // case 'freebsd':
     // case 'openbsd':
-    // case 'linux':
-    //   return 'lynxtron';
+    case 'linux':
+      return 'lynxtron';
     case 'win32':
       return 'lynxtron.exe';
     default: