@lynx-js/lynxtron 0.0.1 → 0.0.3

package/apis/api/clipboard.d.ts

@@ -0,0 +1,54 @@
+// 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 { NativeImage } from './native-image';
+
+export type ClipboardType = 'clipboard';
+
+export interface ClipboardWriteData {
+  text?: string;
+  html?: string;
+  image?: NativeImage;
+}
+
+export interface Clipboard {
+  /**
+   * An array of supported formats for the clipboard contents.
+   */
+  availableFormats(type?: ClipboardType): string[];
+  /**
+   * Clears the clipboard contents.
+   */
+  clear(type?: ClipboardType): void;
+  /**
+   * The content in the clipboard as markup.
+   */
+  readHTML(type?: ClipboardType): string;
+  /**
+   * The image content in the clipboard.
+   */
+  readImage(type?: ClipboardType): NativeImage;
+  /**
+   * The content in the clipboard as plain text.
+   */
+  readText(type?: ClipboardType): string;
+  /**
+   * Writes data to the clipboard.
+   */
+  write(data: ClipboardWriteData, type?: ClipboardType): void;
+  /**
+   * Writes markup to the clipboard.
+   */
+  writeHTML(markup: string, type?: ClipboardType): void;
+  /**
+   * Writes an image to the clipboard.
+   */
+  writeImage(image: NativeImage, type?: ClipboardType): void;
+  /**
+   * Writes text to the clipboard as plain text.
+   */
+  writeText(text: string, type?: ClipboardType): void;
+}
+
+export declare const clipboard: Clipboard;

package/apis/api/command-line.d.ts

@@ -0,0 +1,46 @@
+// 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.
+
+export declare class CommandLine {
+  /**
+   * Append an argument to the command line. The argument will be quoted correctly.
+   * Switches will precede arguments regardless of appending order.
+   *
+   * If you're appending an argument like `--switch=value`, consider using
+   * `appendSwitch('switch', 'value')` instead.
+   *
+   * [!NOTE] This will not affect `process.argv`. The intended usage of this
+   * function is to control command-line behavior.
+   */
+  appendArgument(value: string): void;
+  /**
+   * Append a switch (with optional `value`) to the command line.
+   *
+   * [!NOTE] This will not affect `process.argv`. The intended usage of this
+   * function is to control command-line behavior.
+   */
+  appendSwitch(the_switch: string, value?: string): void;
+  /**
+   * The command-line switch value.
+   *
+   * This function is meant to obtain command-line switches. It is not meant to be
+   * used for application-specific command line arguments. For the latter, please use
+   * `process.argv`.
+   *
+   * > [!NOTE] When the switch is not present or has no value, it returns empty
+   * string.
+   */
+  getSwitchValue(the_switch: string): string;
+  /**
+   * Whether the command-line switch is present.
+   */
+  hasSwitch(the_switch: string): boolean;
+  /**
+   * Removes the specified switch from the command line.
+   *
+   * > [!NOTE] This will not affect `process.argv`. The intended usage of this
+   * function is to control command-line behavior.
+   */
+  removeSwitch(the_switch: string): void;
+}

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

@@ -0,0 +1,8 @@
+// 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.
+
+export interface ContextBridge {
+  exposeInLynxBTS(apis: Record<string, any>): void;
+}
+export const contextBridge: ContextBridge;

package/apis/api/devtool.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.
+
+export interface Devtool {
+  /**
+   * Set whether to enable the Lynx devtool.
+   */
+  setDevToolEnabled(enabled: boolean): void;
+  /**
+   * Get whether the Lynx devtool is enabled.
+   */
+  isDevtoolEnabled(): boolean;
+  /**
+   * Set whether to enable the Lynx logbox.
+   */
+  setLogboxEnabled(enable: boolean): void;
+  /**
+   * Get whether the Lynx logbox is enabled.
+   */
+  isLogboxEnabled(): boolean;
+  /**
+   * Set the callback for handling open-card requests from the Lynx devtool.
+   * Pass null to clear the current callback.
+   */
+  setOpenCardCallback(callback: ((url: string) => void) | null): void;
+
+  /**
+   * Connect to the Lynx devtool.
+   */
+  connectDevtool(url: string): void;
+}
+
+export declare const devtool: Devtool;