webview-napi 0.1.5

package/index.d.ts

@@ -0,0 +1,1596 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+export declare class Application {
+  constructor(options?: ApplicationOptions | undefined | null)
+  onEvent(handler?: (((err: Error | null, arg: ApplicationEvent) => any)) | undefined | null): void
+  bind(handler?: (((err: Error | null, arg: ApplicationEvent) => any)) | undefined | null): void
+  createBrowserWindow(options?: BrowserWindowOptions | undefined | null): BrowserWindow
+  exit(): void
+  run(): void
+  runIteration(): boolean
+}
+
+export declare class BrowserWindow {
+  get id(): string
+  createWebview(options?: WebviewOptions | undefined | null): Webview
+  get isChild(): boolean
+  isFocused(): boolean
+  isVisible(): boolean
+  isDecorated(): boolean
+  isMinimizable(): boolean
+  isMaximized(): boolean
+  isMinimized(): boolean
+  isResizable(): boolean
+  setClosable(closable: boolean): void
+  setMaximizable(maximizable: boolean): void
+  setMinimizable(minimizable: boolean): void
+  setTitle(title: string): void
+  get title(): string
+  get theme(): Theme
+  set theme(theme: Theme)
+  setWindowIcon(icon: Buffer | string, width: number, height: number): void
+  removeWindowIcon(): void
+  setVisible(visible: boolean): void
+  setProgressBar(state: ProgressBarState): void
+  setMaximized(value: boolean): void
+  setMinimized(value: boolean): void
+  focus(): void
+  getAvailableMonitors(): Array<Monitor>
+  getPrimaryMonitor(): Monitor | null
+  setContentProtection(enabled: boolean): void
+  setAlwaysOnTop(enabled: boolean): void
+  setAlwaysOnBottom(enabled: boolean): void
+  setDecorations(enabled: boolean): void
+  get fullscreen(): FullscreenType | null
+  show(): void
+}
+
+/** Event loop for handling window events. */
+export declare class EventLoop {
+  /** Creates a new event loop. */
+  constructor()
+  /** Runs the event loop. */
+  run(): void
+  /** Runs a single iteration of the event loop. */
+  runIteration(): boolean
+  /** Creates an event loop proxy. */
+  createProxy(): EventLoopProxy
+}
+
+/** Builder for creating event loops. */
+export declare class EventLoopBuilder {
+  /** Creates a new event loop builder. */
+  constructor()
+  /**
+   * Forces X11 backend on Linux.
+   * This must be called before build() to take effect.
+   */
+  withForceX11(force: boolean): this
+  /**
+   * Forces Wayland backend on Linux.
+   * This must be called before build() to take effect.
+   */
+  withForceWayland(force: boolean): this
+  /** Builds the event loop. */
+  build(): EventLoop
+}
+
+/** Proxy for sending events to an event loop. */
+export declare class EventLoopProxy {
+  /** Sends an event to the event loop. */
+  sendEvent(): void
+  /** Wakes up the event loop. */
+  wakeUp(): void
+}
+
+/** Target for event loop operations. */
+export declare class EventLoopWindowTarget {
+
+}
+
+/** Simple pixel renderer for Tao windows */
+export declare class PixelRenderer {
+  /** Creates a new pixel renderer with the given buffer dimensions */
+  constructor(bufferWidth: number, bufferHeight: number)
+  /** Creates a new pixel renderer with options */
+  static withOptions(options: RenderOptions): PixelRenderer
+  /** Sets the scaling mode */
+  setScaleMode(mode: ScaleMode): void
+  /** Sets the background color */
+  setBackgroundColor(r: number, g: number, b: number, a: number): void
+  /**
+   * Renders a pixel buffer to the given window
+   *
+   * # Arguments
+   * * `window` - The Tao window to render to
+   * * `buffer` - RGBA pixel buffer (must be buffer_width * buffer_height * 4 bytes)
+   */
+  render(window: Window, buffer: Buffer): void
+}
+
+/** The web context for a webview. */
+export declare class WebContext {
+  /** Creates a new web context with the given data directory. */
+  constructor(dataDirectory?: string | undefined | null)
+  /** Gets the data directory for this web context. */
+  dataDirectory(): string | null
+}
+
+export declare class Webview {
+  get id(): string
+  get label(): string
+  onIpcMessage(handler?: IpcHandler | undefined | null): void
+  on(handler: IpcHandler): void
+  send(message: string): void
+  loadUrl(url: string): void
+  loadHtml(html: string): void
+  evaluateScript(js: string): void
+  openDevtools(): void
+  closeDevtools(): void
+  isDevtoolsOpen(): boolean
+  reload(): void
+  print(): void
+}
+
+/** The main webview struct. */
+export declare class WebView {
+  /** Gets the native ID of the webview. */
+  get id(): string
+  /** Gets the label of the webview. */
+  get label(): string
+  /** Evaluates JavaScript code in the webview. */
+  evaluateScript(js: string): void
+  /** Opens the developer tools. */
+  openDevtools(): void
+  /** Closes the developer tools. */
+  closeDevtools(): void
+  /** Checks if the developer tools are open. */
+  isDevtoolsOpen(): boolean
+  /** Reloads the current page. */
+  reload(): void
+  /** Prints the current page. */
+  print(): void
+  /** Loads a new URL in the webview. */
+  loadUrl(url: string): void
+  /** Loads HTML content in the webview. */
+  loadHtml(html: string): void
+  /** Registers a callback for IPC messages. */
+  on(callback: (error: Error | null, message: string) => void): void
+  /**
+   * Sends a message to the webview.
+   * This calls window.__webview_on_message__(message) in JavaScript.
+   */
+  send(message: string): void
+  /** Gets the GTK widget for the webview (Unix only). */
+  gtkWidget(): bigint
+}
+
+/** Builder for creating webviews. */
+export declare class WebViewBuilder {
+  /** Creates a new webview builder. */
+  constructor()
+  /** Sets the URL to load. */
+  withUrl(url: string): this
+  /** Sets the HTML content to load. */
+  withHtml(html: string): this
+  /** Sets the width of the webview. */
+  withWidth(width: number): this
+  /** Sets the height of the webview. */
+  withHeight(height: number): this
+  /** Sets the X coordinate of the webview. */
+  withX(x: number): this
+  /** Sets the Y coordinate of the webview. */
+  withY(y: number): this
+  /** Sets whether the webview is resizable. */
+  withResizable(resizable: boolean): this
+  /** Sets the title of the webview. */
+  withTitle(title: string): this
+  /** Sets whether the webview has a menubar. */
+  withMenubar(menubar: boolean): this
+  /** Sets whether the webview is maximized. */
+  withMaximized(maximized: boolean): this
+  /** Sets whether the webview is minimized. */
+  withMinimized(minimized: boolean): this
+  /** Sets whether the webview is visible. */
+  withVisible(visible: boolean): this
+  /** Sets whether the webview has decorations. */
+  withDecorated(decorations: boolean): this
+  /** Sets whether the webview is always on top. */
+  withAlwaysOnTop(alwaysOnTop: boolean): this
+  /** Sets whether the webview is transparent. */
+  withTransparent(transparent: boolean): this
+  /** Sets whether the webview has focus. */
+  withFocused(focused: boolean): this
+  /** Sets the icon of the webview. */
+  withIcon(icon: Buffer): this
+  /** Sets the theme of the webview. */
+  withTheme(theme: WryTheme): this
+  /** Sets the user agent of the webview. */
+  withUserAgent(userAgent: string): this
+  /** Adds an initialization script to run when creating the webview. */
+  withInitializationScript(script: InitializationScript): this
+  /** Sets whether to enable drag drop. */
+  withDragDrop(dragDrop: boolean): this
+  /** Sets the background color of the webview. */
+  withBackgroundColor(color: Buffer): this
+  /** Sets whether to enable devtools. */
+  withDevtools(devtools: boolean): this
+  /** Sets whether to enable incognito mode. */
+  withIncognito(incognito: boolean): this
+  /** Sets whether to enable zoom hotkeys. */
+  withHotkeysZoom(hotkeysZoom: boolean): this
+  /** Sets whether to enable clipboard access. */
+  withClipboard(clipboard: boolean): this
+  /** Sets whether to enable autoplay. */
+  withAutoplay(autoplay: boolean): this
+  /** Sets whether to enable back/forward navigation gestures. */
+  withBackForwardNavigationGestures(backForwardNavigationGestures: boolean): this
+  /** Sets the IPC handler for the webview. */
+  withIpcHandler(callback: (error: Error | null, message: string) => void): this
+  /** Adds multiple IPC handlers for the webview. */
+  withIpcHandlers(handlers: Array<IpcHandler>): this
+  /** Builds the webview on an existing window. */
+  buildOnWindow(window: Window, label: string, ipcListenersOverride?: Array<IpcHandler> | undefined | null): WebView
+  /** Builds the webview. */
+  build(eventLoop: EventLoop, label: string, ipcListenersOverride?: Array<IpcHandler> | undefined | null): WebView
+}
+
+/** Window for displaying content. */
+export declare class Window {
+  /** Creates a new window with default attributes. */
+  constructor()
+  /** Gets the window ID. */
+  get id(): bigint
+  /** Gets the window title. */
+  title(): string
+  /** Sets the window title. */
+  setTitle(title: string): void
+  /** Gets whether the window is visible. */
+  isVisible(): boolean
+  /** Sets whether the window is visible. */
+  setVisible(visible: boolean): void
+  /** Gets whether the window is resizable. */
+  isResizable(): boolean
+  /** Sets whether the window is resizable. */
+  setResizable(resizable: boolean): void
+  /** Gets whether the window is decorated. */
+  isDecorated(): boolean
+  /** Sets whether the window is decorated. */
+  setDecorated(decorated: boolean): void
+  /** Gets the window position. */
+  outerPosition(): Position
+  /** Sets the window position. */
+  setOuterPosition(x: number, y: number): void
+  /** Gets the window size. */
+  innerSize(): Size
+  /** Sets the window size. */
+  setInnerSize(width: number, height: number): void
+  /** Gets whether the window is maximized. */
+  isMaximized(): boolean
+  /** Sets whether the window is maximized. */
+  setMaximized(maximized: boolean): void
+  /** Gets whether the window is minimized. */
+  isMinimized(): boolean
+  /** Sets whether the window is minimized. */
+  setMinimized(minimized: boolean): void
+  /** Gets whether the window is always on top. */
+  isAlwaysOnTop(): boolean
+  /** Sets whether the window is always on top. */
+  setAlwaysOnTop(alwaysOnTop: boolean): void
+  /** Gets whether the window is focused. */
+  isFocused(): boolean
+  /** Requests the window to be focused. */
+  requestFocus(): void
+  /** Gets the current cursor icon. */
+  cursorIcon(): CursorIcon
+  /** Sets the cursor icon. */
+  setCursorIcon(cursor: CursorIcon): void
+  /** Sets the cursor position. */
+  setCursorPosition(x: number, y: number): void
+  /** Gets the cursor position. */
+  cursorPosition(): Position
+  /** Drags the window. */
+  dragWindow(): boolean
+  /** Sets the window theme. */
+  setTheme(theme: TaoTheme): void
+  /** Gets the window theme. */
+  theme(): TaoTheme | null
+  /** Sets the window icon. */
+  setWindowIcon(width: number, height: number, rgba: Buffer): void
+  /** Sets whether to ignore cursor events. */
+  setIgnoreCursorEvents(ignore: boolean): void
+  /** Requests a redrawing of the window. */
+  requestRedraw(): void
+  /** Closes the window. */
+  close(): void
+}
+
+/** Builder for creating windows. */
+export declare class WindowBuilder {
+  /** Creates a new window builder. */
+  constructor()
+  /** Sets the window title. */
+  withTitle(title: string): this
+  /** Sets the window size. */
+  withInnerSize(width: number, height: number): this
+  /** Sets the window position. */
+  withPosition(x: number, y: number): this
+  /** Sets whether the window is resizable. */
+  withResizable(resizable: boolean): this
+  /** Sets whether the window has decorations. */
+  withDecorated(decorated: boolean): this
+  /** Sets whether the window is always on top. */
+  withAlwaysOnTop(alwaysOnTop: boolean): this
+  /** Sets whether the window is visible. */
+  withVisible(visible: boolean): this
+  /** Sets whether the window is transparent. */
+  withTransparent(transparent: boolean): this
+  /** Sets whether the window is maximized. */
+  withMaximized(maximized: boolean): this
+  /** Sets whether the window is focused. */
+  withFocused(focused: boolean): this
+  /** Sets whether the window has a menubar. */
+  withMenubar(menubar: boolean): this
+  /** Sets the window icon. */
+  withWindowIcon(icon: Buffer): this
+  /** Sets the window theme. */
+  withTheme(theme: TaoTheme): this
+  /** Forces X11 backend on Linux. */
+  withForceX11(force: boolean): this
+  /** Forces Wayland backend on Linux. */
+  withForceWayland(force: boolean): this
+  /** Builds the window. */
+  build(eventLoop: EventLoop): Window
+}
+
+export interface ApplicationEvent {
+  event: WebviewApplicationEvent
+}
+
+export interface ApplicationOptions {
+  controlFlow?: ControlFlow
+  waitTime?: number
+  exitCode?: number
+}
+
+/** Returns a list of all available monitors. */
+export declare function availableMonitors(): Array<MonitorInfo>
+
+/** Background throttling policy for webviews. */
+export declare const enum BackgroundThrottlingPolicy {
+  /** Throttling is suspended when the page is in the background. */
+  Suspend = 0,
+  /** Throttling is not suspended when the page is in the background. */
+  Unsuspend = 1,
+  /** Throttling is suspended when the page is in the background and the webview is not visible. */
+  UnsuspendWhenFirstVisible = 2
+}
+
+/** Bad icon error. */
+export declare const enum BadIcon {
+  /** No icon data provided. */
+  NoData = 0,
+  /** Icon data is too large. */
+  TooLarge = 1,
+  /** Icon format is invalid. */
+  Format = 2
+}
+
+export interface BrowserWindowOptions {
+  resizable?: boolean
+  title?: string
+  width?: number
+  height?: number
+  x?: number
+  y?: number
+  contentProtection?: boolean
+  alwaysOnTop?: boolean
+  alwaysOnBottom?: boolean
+  visible?: boolean
+  decorations?: boolean
+  visibleOnAllWorkspaces?: boolean
+  maximized?: boolean
+  maximizable?: boolean
+  minimizable?: boolean
+  focused?: boolean
+  transparent?: boolean
+  fullscreen?: FullscreenType
+}
+
+export declare const enum ControlFlow {
+  Poll = 0,
+  WaitUntil = 1,
+  Exit = 2,
+  ExitWithCode = 3
+}
+
+/** Cursor icon change details. */
+export interface CursorChangeDetails {
+  /** The new cursor icon. */
+  newCursor: CursorIcon
+}
+
+/** Cursor icon. */
+export declare const enum CursorIcon {
+  Default = 0,
+  Crosshair = 1,
+  Hand = 2,
+  Arrow = 3,
+  Move = 4,
+  Text = 5,
+  Wait = 6,
+  Help = 7,
+  Progress = 8,
+  NotAllowed = 9,
+  EastResize = 10,
+  NorthResize = 11,
+  NortheastResize = 12,
+  NorthwestResize = 13,
+  SouthResize = 14,
+  SoutheastResize = 15,
+  SouthwestResize = 16,
+  WestResize = 17,
+  NorthSouthResize = 18,
+  EastWestResize = 19,
+  NortheastSouthwestResize = 20,
+  NorthwestSoutheastResize = 21,
+  ColumnResize = 22,
+  RowResize = 23,
+  AllScroll = 24,
+  ZoomIn = 25,
+  ZoomOut = 26
+}
+
+/** Cursor position. */
+export interface CursorPosition {
+  /** The X coordinate. */
+  x: number
+  /** The Y coordinate. */
+  y: number
+}
+
+/** Device event type. */
+export type DeviceEvent =
+  | { type: 'MouseMotion', deltaX: number, deltaY: number }
+  | { type: 'MouseButton', button: number, state: MouseButtonState }
+  | { type: 'Key', keyCode: number, state: MouseButtonState }
+
+/** Device event filter. */
+export declare const enum DeviceEventFilter {
+  Allow = 0,
+  AllowRepeated = 1,
+  Ignore = 2
+}
+
+export interface Dimensions {
+  width: number
+  height: number
+}
+
+/** Drag drop event. */
+export declare const enum DragDropEvent {
+  /** The drag has entered the webview area. */
+  Entered = 0,
+  /** The drag is hovering over the webview area. */
+  Hovered = 1,
+  /** The drag has left the webview area. */
+  Left = 2,
+  /** The drag has been dropped on the webview. */
+  Dropped = 3
+}
+
+/** Element state for input devices. */
+export declare const enum ElementState {
+  Pressed = 0,
+  Released = 1
+}
+
+/** Error type for webview operations. */
+export declare const enum Error {
+  /** The webview was not initialized. */
+  Uninitialized = 0,
+  /** The webview has already been destroyed. */
+  AlreadyDestroyed = 1,
+  /** The script call failed. */
+  ScriptCallFailed = 2,
+  /** An IPC error occurred. */
+  Ipc = 3,
+  /** The webview is invalid. */
+  InvalidWebview = 4,
+  /** The URL is invalid. */
+  InvalidUrl = 5,
+  /** The operation is not supported on this platform. */
+  Unsupported = 6,
+  /** The icon is invalid. */
+  InvalidIcon = 7
+}
+
+/** External error type. */
+export type ExternalError =
+  | { type: 'NotSupported' }
+  | { type: 'Os', field0: string }
+
+/** Force touch/pen pressure. */
+export type Force =
+  | { type: 'Calibrated', force: number, stage: number }
+  | { type: 'Normalized', field0: number }
+
+/** Fullscreen mode. */
+export type Fullscreen =
+  | { type: 'Exclusive', field0: MonitorInfo }
+  | { type: 'Borderless', field0?: MonitorInfo }
+
+export declare const enum FullscreenType {
+  Exclusive = 0,
+  Borderless = 1
+}
+
+/** Gesture event data. */
+export interface GestureEvent {
+  /** The gesture type. */
+  gestureType: string
+  /** The position of gesture. */
+  position: Position
+  /** The amount of gesture. */
+  amount: number
+}
+
+export declare function getWebviewVersion(): string
+
+export interface HeaderData {
+  key: string
+  value?: string
+}
+
+/** HiDPI scaling information. */
+export interface HiDpiScaling {
+  /** The scale factor. */
+  scaleFactor: number
+  /** The position in pixels. */
+  positionInPixels: Position
+}
+
+/** Icon data. */
+export interface Icon {
+  /** The width of icon. */
+  width: number
+  /** The height of icon. */
+  height: number
+  /** The RGBA pixel data. */
+  rgba: Buffer
+}
+
+/** Ime state. */
+export declare const enum ImeState {
+  /** IME is disabled. */
+  Disabled = 0,
+  /** IME is enabled. */
+  Enabled = 1
+}
+
+/** An initialization script to be run when creating a webview. */
+export interface InitializationScript {
+  /** The JavaScript code to run. */
+  js: string
+  /** Whether to run the script only once. */
+  once: boolean
+}
+
+export type IpcHandler =
+  ((err: Error | null, arg: string) => any)
+
+export interface IpcMessage {
+  body: Buffer
+  method: string
+  headers: Array<HeaderData>
+  uri: string
+}
+
+/** Keyboard key. */
+export declare const enum Key {
+  /** The '1' key. */
+  Key1 = 0,
+  /** The '2' key. */
+  Key2 = 1,
+  /** The '3' key. */
+  Key3 = 2,
+  /** The '4' key. */
+  Key4 = 3,
+  /** The '5' key. */
+  Key5 = 4,
+  /** The '6' key. */
+  Key6 = 5,
+  /** The '7' key. */
+  Key7 = 6,
+  /** The '8' key. */
+  Key8 = 7,
+  /** The '9' key. */
+  Key9 = 8,
+  /** The '0' key. */
+  Key0 = 9,
+  /** The 'A' key. */
+  KeyA = 10,
+  /** The 'B' key. */
+  KeyB = 11,
+  /** The 'C' key. */
+  KeyC = 12,
+  /** The 'D' key. */
+  KeyD = 13,
+  /** The 'E' key. */
+  KeyE = 14,
+  /** The 'F' key. */
+  KeyF = 15,
+  /** The 'G' key. */
+  KeyG = 16,
+  /** The 'H' key. */
+  KeyH = 17,
+  /** The 'I' key. */
+  KeyI = 18,
+  /** The 'J' key. */
+  KeyJ = 19,
+  /** The 'K' key. */
+  KeyK = 20,
+  /** The 'L' key. */
+  KeyL = 21,
+  /** The 'M' key. */
+  KeyM = 22,
+  /** The 'N' key. */
+  KeyN = 23,
+  /** The 'O' key. */
+  KeyO = 24,
+  /** The 'P' key. */
+  KeyP = 25,
+  /** The 'Q' key. */
+  KeyQ = 26,
+  /** The 'R' key. */
+  KeyR = 27,
+  /** The 'S' key. */
+  KeyS = 28,
+  /** The 'T' key. */
+  KeyT = 29,
+  /** The 'U' key. */
+  KeyU = 30,
+  /** The 'V' key. */
+  KeyV = 31,
+  /** The 'W' key. */
+  KeyW = 32,
+  /** The 'X' key. */
+  KeyX = 33,
+  /** The 'Y' key. */
+  KeyY = 34,
+  /** The 'Z' key. */
+  KeyZ = 35,
+  /** The Escape key. */
+  Escape = 36,
+  /** The F1 key. */
+  F1 = 37,
+  /** The F2 key. */
+  F2 = 38,
+  /** The F3 key. */
+  F3 = 39,
+  /** The F4 key. */
+  F4 = 40,
+  /** The F5 key. */
+  F5 = 41,
+  /** The F6 key. */
+  F6 = 42,
+  /** The F7 key. */
+  F7 = 43,
+  /** The F8 key. */
+  F8 = 44,
+  /** The F9 key. */
+  F9 = 45,
+  /** The F10 key. */
+  F10 = 46,
+  /** The F11 key. */
+  F11 = 47,
+  /** The F12 key. */
+  F12 = 48,
+  /** The Snapshot key. */
+  Snapshot = 49,
+  /** The Scroll key. */
+  Scroll = 50,
+  /** The Pause key. */
+  Pause = 51,
+  /** The Insert key. */
+  Insert = 52,
+  /** The Home key. */
+  Home = 53,
+  /** The Delete key. */
+  Delete = 54,
+  /** The End key. */
+  End = 55,
+  /** The PageDown key. */
+  PageDown = 56,
+  /** The PageUp key. */
+  PageUp = 57,
+  /** The Left arrow key. */
+  Left = 58,
+  /** The Up arrow key. */
+  Up = 59,
+  /** The Right arrow key. */
+  Right = 60,
+  /** The Down arrow key. */
+  Down = 61,
+  /** The Backspace key. */
+  Backspace = 62,
+  /** The Enter key. */
+  Enter = 63,
+  /** The Space key. */
+  Space = 64,
+  /** The Compose key. */
+  Compose = 65,
+  /** The Numlock key. */
+  Numlock = 66,
+  /** The Numpad '0' key. */
+  Numpad0 = 67,
+  /** The Numpad '1' key. */
+  Numpad1 = 68,
+  /** The Numpad '2' key. */
+  Numpad2 = 69,
+  /** The Numpad '3' key. */
+  Numpad3 = 70,
+  /** The Numpad '4' key. */
+  Numpad4 = 71,
+  /** The Numpad '5' key. */
+  Numpad5 = 72,
+  /** The Numpad '6' key. */
+  Numpad6 = 73,
+  /** The Numpad '7' key. */
+  Numpad7 = 74,
+  /** The Numpad '8' key. */
+  Numpad8 = 75,
+  /** The Numpad '9' key. */
+  Numpad9 = 76,
+  /** The Numpad Add key. */
+  NumpadAdd = 77,
+  /** The Numpad Divide key. */
+  NumpadDivide = 78,
+  /** The Numpad Decimal key. */
+  NumpadDecimal = 79,
+  /** The Numpad Enter key. */
+  NumpadEnter = 80,
+  /** The Numpad Equals key. */
+  NumpadEquals = 81,
+  /** The Numpad Multiply key. */
+  NumpadMultiply = 82,
+  /** The Numpad Subtract key. */
+  NumpadSubtract = 83,
+  /** The Apostrophe key. */
+  Apostrophe = 84,
+  /** The CapsLock key. */
+  CapsLock = 85,
+  /** The Comma key. */
+  Comma = 86,
+  /** The Convert key. */
+  Convert = 87,
+  /** The Equal key. */
+  Equal = 88,
+  /** The Grave key. */
+  Grave = 89,
+  /** The LAlt key. */
+  LAlt = 90,
+  /** The LBracket key. */
+  LBracket = 91,
+  /** The LControl key. */
+  LControl = 92,
+  /** The LShift key. */
+  LShift = 93,
+  /** The LWin key. */
+  LWin = 94,
+  /** The NonConvert key. */
+  NonConvert = 95,
+  /** The Period key. */
+  Period = 96,
+  /** The RAlt key. */
+  RAlt = 97,
+  /** The RBracket key. */
+  RBracket = 98,
+  /** The RControl key. */
+  RControl = 99,
+  /** The RShift key. */
+  RShift = 100,
+  /** The RWin key. */
+  RWin = 101,
+  /** The Semicolon key. */
+  Semicolon = 102,
+  /** The Slash key. */
+  Slash = 103,
+  /** The Alt key (mapped). */
+  Alt = 104,
+  /** The Control key (mapped). */
+  Control = 105,
+  /** The Shift key (mapped). */
+  Shift = 106,
+  /** The Backslash key. */
+  Backslash = 107,
+  /** The NonUS# key. */
+  NonUsBackslash = 108,
+  /** The Tab key. */
+  Tab = 109
+}
+
+/** Keyboard event data. */
+export interface KeyboardEvent {
+  /** The key that was pressed. */
+  key: string
+  /** The key code. */
+  code: string
+  /** The key state. */
+  state: MouseButtonState
+  /** The modifiers state. */
+  modifiers: ModifiersState
+}
+
+/** Key code. */
+export declare const enum KeyCode {
+  Key1 = 0,
+  Key2 = 1,
+  Key3 = 2,
+  Key4 = 3,
+  Key5 = 4,
+  Key6 = 5,
+  Key7 = 6,
+  Key8 = 7,
+  Key9 = 8,
+  Key0 = 9,
+  A = 10,
+  B = 11,
+  C = 12,
+  D = 13,
+  E = 14,
+  F = 15,
+  G = 16,
+  H = 17,
+  I = 18,
+  J = 19,
+  K = 20,
+  L = 21,
+  M = 22,
+  N = 23,
+  O = 24,
+  P = 25,
+  Q = 26,
+  R = 27,
+  S = 28,
+  T = 29,
+  U = 30,
+  V = 31,
+  W = 32,
+  X = 33,
+  Y = 34,
+  Z = 35,
+  Escape = 36,
+  F1 = 37,
+  F2 = 38,
+  F3 = 39,
+  F4 = 40,
+  F5 = 41,
+  F6 = 42,
+  F7 = 43,
+  F8 = 44,
+  F9 = 45,
+  F10 = 46,
+  F11 = 47,
+  F12 = 48,
+  F13 = 49,
+  F14 = 50,
+  F15 = 51,
+  F16 = 52,
+  F17 = 53,
+  F18 = 54,
+  F19 = 55,
+  F20 = 56,
+  F21 = 57,
+  F22 = 58,
+  F23 = 59,
+  F24 = 60,
+  Snapshot = 61,
+  Scroll = 62,
+  Pause = 63,
+  Insert = 64,
+  Home = 65,
+  Delete = 66,
+  End = 67,
+  PageDown = 68,
+  PageUp = 69,
+  Left = 70,
+  Up = 71,
+  Right = 72,
+  Down = 73,
+  Backspace = 74,
+  Enter = 75,
+  Space = 76,
+  Compose = 77,
+  CapsLock = 78,
+  Numlock = 79,
+  Numpad0 = 80,
+  Numpad1 = 81,
+  Numpad2 = 82,
+  Numpad3 = 83,
+  Numpad4 = 84,
+  Numpad5 = 85,
+  Numpad6 = 86,
+  Numpad7 = 87,
+  Numpad8 = 88,
+  Numpad9 = 89,
+  NumpadAdd = 90,
+  NumpadDivide = 91,
+  NumpadDecimal = 92,
+  NumpadEnter = 93,
+  NumpadEquals = 94,
+  NumpadMultiply = 95,
+  NumpadSubtract = 96,
+  Apostrophe = 97,
+  Comma = 98,
+  Equal = 99,
+  Grave = 100,
+  LAlt = 101,
+  LBracket = 102,
+  LControl = 103,
+  LShift = 104,
+  LWin = 105,
+  Period = 106,
+  RAlt = 107,
+  RBracket = 108,
+  RControl = 109,
+  RShift = 110,
+  RWin = 111,
+  Semicolon = 112,
+  Slash = 113,
+  Backslash = 114,
+  NonUsBackslash = 115,
+  Tab = 116
+}
+
+/** Key location on the keyboard. */
+export declare const enum KeyLocation {
+  Standard = 0,
+  Left = 1,
+  Right = 2,
+  Numpad = 3
+}
+
+/** Modifier key state. */
+export declare const enum ModifiersState {
+  /** The Shift key is pressed. */
+  Shift = 0,
+  /** The Control key is pressed. */
+  Control = 1,
+  /** The Alt key is pressed. */
+  Alt = 2,
+  /** The Super key is pressed. */
+  Super = 3
+}
+
+export interface Monitor {
+  name?: string
+  scaleFactor: number
+  size: Dimensions
+  position: Position
+  videoModes: Array<VideoMode>
+}
+
+/** Forward declaration for MonitorInfo to avoid circular dependencies */
+export interface MonitorInfo {
+  /** The name of monitor. */
+  name?: string
+  /** The size of monitor. */
+  size: Size
+  /** The position of monitor. */
+  position: Position
+  /** The scale factor of monitor. */
+  scaleFactor: number
+}
+
+/** Mouse button event. */
+export type MouseButton =
+  | { type: 'Left' }
+  | { type: 'Right' }
+  | { type: 'Middle' }
+  | { type: 'Other', field0: number }
+
+/** Mouse button state. */
+export declare const enum MouseButtonState {
+  /** The button was pressed. */
+  Pressed = 0,
+  /** The button was released. */
+  Released = 1
+}
+
+/** Mouse event data. */
+export interface MouseEvent {
+  /** The button that was pressed/released. */
+  button: MouseButton
+  /** The state of button. */
+  state: MouseButtonState
+  /** The position of mouse. */
+  position: Position
+  /** The number of clicks. */
+  clickCount: number
+  /** The modifiers state. */
+  modifiers: ModifiersState
+}
+
+/** Mouse scroll delta. */
+export type MouseScrollDelta =
+  | { type: 'LineDelta', field0: number, field1: number }
+  | { type: 'PixelDelta', field0: number, field1: number }
+
+/** Features to configure a new window. */
+export interface NewWindowFeatures {
+  /** Whether the new window should have a menubar. */
+  menubar: boolean
+  /** Whether the new window should be visible. */
+  visible: boolean
+  /** The width of the new window. */
+  width: number
+  /** The height of the new window. */
+  height: number
+  /** The X coordinate of the new window. */
+  x: number
+  /** The Y coordinate of the new window. */
+  y: number
+  /** Whether the new window should be maximized. */
+  maximized: boolean
+  /** Whether the new window should be focused. */
+  focused: boolean
+  /** Whether the new window should have decorations. */
+  decorations: boolean
+  /** Whether the new window should always be on top. */
+  alwaysOnTop: boolean
+  /** Whether the new window should be transparent. */
+  transparent: boolean
+}
+
+/** The opener of a new window. */
+export interface NewWindowOpener {
+  /** The label of the opener webview. */
+  label: string
+  /** The native ID of the opener webview. */
+  nativeId: number
+}
+
+/** Response to a new window request. */
+export declare const enum NewWindowResponse {
+  /** Deny the new window request. */
+  Deny = 0,
+  /** Allow the new window request. */
+  Allow = 1,
+  /** Allow the new window request and navigate to the URL. */
+  AllowAndNavigate = 2
+}
+
+/** Not supported error. */
+export interface NotSupportedError {
+  /** The error message. */
+  message: string
+}
+
+/** OS error. */
+export interface OsError {
+  /** The OS error code. */
+  code: number
+  /** The error message. */
+  message: string
+}
+
+/** Page load event. */
+export declare const enum PageLoadEvent {
+  /** The page has started loading. */
+  Started = 0,
+  /** The page has completed loading. */
+  Completed = 1
+}
+
+/** 2D position. */
+export interface Position {
+  /** The X coordinate. */
+  x: number
+  /** The Y coordinate. */
+  y: number
+}
+
+/** Returns the primary monitor information. */
+export declare function primaryMonitor(): MonitorInfo
+
+export interface ProgressBarState {
+  /** The progress status. */
+  status: ProgressBarStatus
+  /** The progress value (0-100). */
+  progress: number
+}
+
+export declare const enum ProgressBarStatus {
+  None = 0,
+  Normal = 1,
+  Indeterminate = 2,
+  Paused = 3,
+  Error = 4
+}
+
+/** Progress state for progress bar. */
+export declare const enum ProgressState {
+  None = 0,
+  Normal = 1,
+  Indeterminate = 2,
+  Paused = 3,
+  Error = 4
+}
+
+/** Proxy configuration. */
+export type ProxyConfig =
+  | { type: 'None' }
+  | { type: 'Http', field0: string }
+  | { type: 'Https', field0: string }
+  | { type: 'Socks5', field0: string }
+
+/** A proxy endpoint for web content. */
+export interface ProxyEndpoint {
+  /** The host of the proxy. */
+  host: string
+  /** The port of the proxy. */
+  port: number
+}
+
+/** Raw keyboard event data. */
+export interface RawKeyEvent {
+  /** The key code. */
+  keyCode: number
+  /** The key state. */
+  state: MouseButtonState
+  /** The modifiers state. */
+  modifiers: ModifiersState
+}
+
+/** A rectangle area. */
+export interface Rect {
+  /** The X coordinate of the top-left corner. */
+  x: number
+  /** The Y coordinate of the top-left corner. */
+  y: number
+  /** The width of the rectangle. */
+  width: number
+  /** The height of the rectangle. */
+  height: number
+}
+
+/** 2D rectangle. */
+export interface Rectangle {
+  /** The position. */
+  origin: Position
+  /** The size. */
+  size: Size
+}
+
+/** Render options for pixel buffer display */
+export interface RenderOptions {
+  /** Width of the source buffer in pixels */
+  bufferWidth: number
+  /** Height of the source buffer in pixels */
+  bufferHeight: number
+  /** Scaling mode (default: Fit) */
+  scaleMode?: ScaleMode
+  /** Background color for letterboxing [R, G, B, A] (default: [0, 0, 0, 255]) */
+  backgroundColor?: Array<number>
+}
+
+/**
+ * Simple function to render a pixel buffer to a window
+ *
+ * This is a convenience function for one-off renders.
+ * For repeated rendering, use [`PixelRenderer`] instead.
+ */
+export declare function renderPixels(window: Window, buffer: Buffer, bufferWidth: number, bufferHeight: number): void
+
+/** A responder for a request. */
+export interface RequestAsyncResponder {
+  /** The URI of the request. */
+  uri: string
+  /** The HTTP method of the request. */
+  method: string
+  /** The body of the request. */
+  body: Buffer
+}
+
+/** Window resize details. */
+export interface ResizeDetails {
+  /** The new width. */
+  width: number
+  /** The new height. */
+  height: number
+}
+
+/** Resize direction for window resizing. */
+export declare const enum ResizeDirection {
+  East = 0,
+  North = 1,
+  Northeast = 2,
+  Northwest = 3,
+  South = 4,
+  Southeast = 5,
+  Southwest = 6,
+  West = 7
+}
+
+/** Window scale factor change details. */
+export interface ScaleFactorChangeDetails {
+  /** The new scale factor. */
+  scaleFactor: number
+  /** The new inner size in logical pixels. */
+  newInnerSize: Size
+}
+
+/** Scale mode for rendering when window is resized. */
+export declare const enum ScaleMode {
+  /** Stretch the buffer to fit the window (may distort aspect ratio). */
+  Stretch = 0,
+  /** Maintain aspect ratio with black bars (letterbox/pillarbox). */
+  Fit = 1,
+  /** Maintain aspect ratio and crop to fill the window. */
+  Fill = 2,
+  /** Integer scaling for pixel-perfect rendering. */
+  Integer = 3,
+  /** No scaling - keep original size (centered). */
+  None = 4
+}
+
+/** 2D size. */
+export interface Size {
+  /** The width. */
+  width: number
+  /** The height. */
+  height: number
+}
+
+/** Start cause of the event loop. */
+export declare const enum StartCause {
+  Wait = 0,
+  WaitCancelled = 1,
+  Poll = 2,
+  ResumeCancelled = 3,
+  Init = 4
+}
+
+/** Control flow of the application event loop. */
+export declare const enum TaoControlFlow {
+  /** The application will continue running normally. */
+  Poll = 0,
+  /** The application will wait until the specified time. */
+  WaitUntil = 1,
+  /** The application will exit. */
+  Exit = 2,
+  /** The application will exit with the given exit code. */
+  ExitWithCode = 3
+}
+
+/** Fullscreen type. */
+export declare const enum TaoFullscreenType {
+  /** Exclusive fullscreen. */
+  Exclusive = 0,
+  /** Borderless fullscreen. */
+  Borderless = 1
+}
+
+/** Progress bar data from Tao. */
+export interface TaoProgressBar {
+  /** The progress state. */
+  state: string
+  /** The progress value (0-100). */
+  progress: number
+}
+
+/** Window theme. */
+export declare const enum TaoTheme {
+  /** Light theme. */
+  Light = 0,
+  /** Dark theme. */
+  Dark = 1
+}
+
+/** Returns the current version of the tao crate. */
+export declare function taoVersion(): string
+
+export declare const enum Theme {
+  Light = 0,
+  Dark = 1,
+  System = 2
+}
+
+/** Theme change details. */
+export interface ThemeChangeDetails {
+  /** The new theme. */
+  newTheme: TaoTheme
+}
+
+/** Touch event data. */
+export interface Touch {
+  /** The touch identifier. */
+  id: number
+  /** The position of touch. */
+  position: Position
+  /** The force of touch. */
+  force?: number
+  /** The device ID. */
+  deviceId: number
+}
+
+/** Touch phase. */
+export declare const enum TouchPhase {
+  Started = 0,
+  Moved = 1,
+  Ended = 2,
+  Cancelled = 3
+}
+
+/** User attention type. */
+export declare const enum UserAttentionType {
+  Critical = 0,
+  Informational = 1
+}
+
+/** Video mode information. */
+export interface VideoMode {
+  /** The size of video mode. */
+  size: Size
+  /** The bit depth. */
+  bitDepth: number
+  /** The refresh rate. */
+  refreshRate: number
+}
+
+export interface VideoMode {
+  size: Dimensions
+  bitDepth: number
+  refreshRate: number
+}
+
+export declare const enum WebviewApplicationEvent {
+  WindowCloseRequested = 0,
+  ApplicationCloseRequested = 1
+}
+
+/** Attributes for creating a webview. */
+export interface WebViewAttributes {
+  /** The URL to load. */
+  url?: string
+  /** The HTML content to load. */
+  html?: string
+  /** The width of the webview. */
+  width: number
+  /** The height of the webview. */
+  height: number
+  /** The X coordinate of the webview. */
+  x: number
+  /** The Y coordinate of the webview. */
+  y: number
+  /** Whether the webview is resizable. */
+  resizable: boolean
+  /** The title of the webview. */
+  title?: string
+  /** Whether the webview has a menubar. */
+  menubar: boolean
+  /** Whether the webview is maximized. */
+  maximized: boolean
+  /** Whether the webview is minimized. */
+  minimized: boolean
+  /** Whether the webview is visible. */
+  visible: boolean
+  /** Whether the webview has decorations. */
+  decorations: boolean
+  /** Whether the webview is always on top. */
+  alwaysOnTop: boolean
+  /** Whether the webview is transparent. */
+  transparent: boolean
+  /** Whether the webview has focus. */
+  focused: boolean
+  /** The icon of the webview. */
+  icon?: Buffer
+  /** The theme of the webview. */
+  theme?: WryTheme
+  /** The user agent of the webview. */
+  userAgent?: string
+  /** Initialization scripts to run. */
+  initializationScripts: Array<InitializationScript>
+  /** Whether to enable drag drop. */
+  dragDrop: boolean
+  /** The background color of the webview. */
+  backgroundColor?: Buffer
+  /** Whether to enable devtools. */
+  devtools: boolean
+  /** Whether to enable incognito mode. */
+  incognito: boolean
+  /** Whether to enable zoom hotkeys. */
+  hotkeysZoom: boolean
+  /** Whether to enable clipboard access. */
+  clipboard: boolean
+  /** Whether to enable autoplay. */
+  autoplay: boolean
+  /** Whether to enable back/forward navigation gestures. */
+  backForwardNavigationGestures: boolean
+}
+
+export interface WebviewOptions {
+  url?: string
+  html?: string
+  width?: number
+  height?: number
+  x?: number
+  y?: number
+  enableDevtools?: boolean
+  incognito?: boolean
+  userAgent?: string
+  child?: boolean
+  preload?: string
+  transparent?: boolean
+  theme?: Theme
+  hotkeysZoom?: boolean
+  clipboard?: boolean
+  autoplay?: boolean
+  backForwardNavigationGestures?: boolean
+}
+
+/** Returns the version of the webview library. */
+export declare function webviewVersion(): [number, number, number]
+
+/** Window attributes. */
+export interface WindowAttributes {
+  /** The title of window. */
+  title: string
+  /** The width of window. */
+  width: number
+  /** The height of window. */
+  height: number
+  /** The X position of window. */
+  x?: number
+  /** The Y position of window. */
+  y?: number
+  /** Whether window is resizable. */
+  resizable: boolean
+  /** Whether window has decorations. */
+  decorated: boolean
+  /** Whether window is always on top. */
+  alwaysOnTop: boolean
+  /** Whether window is visible. */
+  visible: boolean
+  /** Whether window is transparent. */
+  transparent: boolean
+  /** Whether window is maximized. */
+  maximized: boolean
+  /** Whether window is focused. */
+  focused: boolean
+  /** Whether window has a menubar. */
+  menubar: boolean
+  /** The icon of window. */
+  icon?: Buffer
+  /** The theme of window. */
+  theme?: TaoTheme
+  /** Whether to force X11 backend on Linux (default: auto-detect) */
+  forceX11?: boolean
+  /** Whether to force Wayland backend on Linux (default: auto-detect) */
+  forceWayland?: boolean
+}
+
+/** Window drag details. */
+export interface WindowDragOptions {
+  /** The window to drag. */
+  windowId: number
+}
+
+/** Window event type. */
+export declare const enum WindowEvent {
+  /** The window has been created. */
+  Created = 0,
+  /** The window is about to be closed. */
+  CloseRequested = 1,
+  /** The window has been destroyed. */
+  Destroyed = 2,
+  /** The window gained focus. */
+  Focused = 3,
+  /** The window lost focus. */
+  Unfocused = 4,
+  /** The window was moved. */
+  Moved = 5,
+  /** The window was resized. */
+  Resized = 6,
+  /** The window scale factor changed. */
+  ScaleFactorChanged = 7,
+  /** The window theme changed. */
+  ThemeChanged = 8,
+  /** The window was minimized. */
+  Minimized = 9,
+  /** The window was maximized. */
+  Maximized = 10,
+  /** The window was restored from minimized state. */
+  Restored = 11,
+  /** The window became visible. */
+  Visible = 12,
+  /** The window became invisible. */
+  Invisible = 13
+}
+
+/** Window event data. */
+export interface WindowEventData {
+  /** The window event type. */
+  event: WindowEvent
+  /** The window ID. */
+  windowId: number
+}
+
+/** Window jump options. */
+export interface WindowJumpOptions {
+  /** The window to jump. */
+  windowId: number
+  /** The options to pass. */
+  options?: WindowOptions
+}
+
+/** Window level. */
+export declare const enum WindowLevel {
+  /** Normal window level. */
+  Normal = 0,
+  /** Always on top level. */
+  AlwaysOnTop = 1,
+  /** Always on bottom level. */
+  AlwaysOnBottom = 2
+}
+
+/** Window options for creating a window. */
+export interface WindowOptions {
+  /** The title of window. */
+  title: string
+  /** The width of window. */
+  width: number
+  /** The height of window. */
+  height: number
+  /** The X position of window. */
+  x?: number
+  /** The Y position of window. */
+  y?: number
+  /** Whether window is resizable. */
+  resizable: boolean
+  /** Whether window has a decorations. */
+  decorations: boolean
+  /** Whether window is always on top. */
+  alwaysOnTop: boolean
+  /** Whether window is visible. */
+  visible: boolean
+  /** Whether window is transparent. */
+  transparent: boolean
+  /** Whether window is maximized. */
+  maximized: boolean
+  /** Whether window is focused. */
+  focused: boolean
+  /** Whether window has a menubar. */
+  menubar: boolean
+  /** The icon of window. */
+  icon?: Buffer
+  /** The theme of window. */
+  theme?: TaoTheme
+  /** Whether to force X11 backend on Linux (default: auto-detect) */
+  forceX11?: boolean
+  /** Whether to force Wayland backend on Linux (default: auto-detect) */
+  forceWayland?: boolean
+}
+
+/** Window size limits. */
+export interface WindowSizeConstraints {
+  /** The minimum width. */
+  minWidth?: number
+  /** The minimum height. */
+  minHeight?: number
+  /** The maximum width. */
+  maxWidth?: number
+  /** The maximum height. */
+  maxHeight?: number
+}
+
+/** Theme for the webview. */
+export declare const enum WryTheme {
+  /** Light theme. */
+  Light = 0,
+  /** Dark theme. */
+  Dark = 1,
+  /** System theme. */
+  Auto = 2
+}