@owear/cli 0.1.2 → 0.1.4

package/template/README.md

@@ -3,54 +3,54 @@
 
 # __APP_NAME__
 
-App de escritorio construida con **[Owear](https://owear.dev)**: el WebView del
-sistema renderiza tu frontend web y el kernel nativo te da el sistema operativo.
+Desktop app built with **[Owear](https://owear.dev)**: the system WebView renders
+your web frontend and the native kernel gives you the operating system.
 
-## Empezar
+## Get started
 
 ```bash
 npm install
 npm run dev     # ≡ ow dev
 ```
 
-Se abre una ventana con el WebView del sistema. Edita `src/renderer.ts` y el
-hot-reload de Vite lo refleja al instante.
+A window with the system WebView opens. Edit `src/renderer.ts` and Vite's
+hot-reload reflects it instantly.
 
 ```bash
 npm run build   # ≡ ow build → dist/
 ```
 
-## Estructura
+## Structure
 
 ```
-├── index.html          UI (titlebar propia, hero, tarjetas)
+├── index.html          UI (custom title bar, hero, cards)
 ├── src/
-│   ├── renderer.ts     lógica del renderer + llamadas a módulos nativos
-│   ├── style.css       estilos
-│   └── ow.d.ts         tipos de window.ow
+│   ├── renderer.ts     renderer logic + calls to native modules
+│   ├── style.css       styles
+│   └── ow.d.ts         types for window.ow
 └── app/
-    └── main.ts         proceso principal (sidecar Node): sólo la ventana
+    └── main.ts         main process (Node sidecar): just the window
 ```
 
-## Cómo se llama al sistema
+## How it talks to the system
 
-Sin `ipcRenderer` ni `ipcMain`: el renderer invoca los módulos nativos del
-kernel directo.
+No `ipcRenderer` and no `ipcMain`: the renderer calls the kernel's native modules
+directly.
 
 ```ts
-const path = await ow.invoke('dialog', 'open', 'open', 'Abrir archivo')
+const path = await ow.invoke('dialog', 'open', 'open', 'Open a file')
 const text = await ow.invoke('fs', 'readText', path)
-await ow.invoke('notification', 'show', 'Listo', `Leídos ${text.length} bytes`)
+await ow.invoke('notification', 'show', 'Done', `Read ${text.length} bytes`)
 ```
 
-Módulos incluidos (stock): `fs` · `path` · `process` (PTY) · `dialog` ·
-`clipboard` · `shell` · `screen` · `net` · `notification` · `power` · `menu` ·
-`globalshortcut` · `updater` · `capturer`, más los builtins `ow-window` (ventana),
-`window` (extras del WebView), `session`, `app` y `crashreporter`.
+Stock modules: `fs` · `path` · `process` (PTY) · `dialog` · `clipboard` ·
+`shell` · `screen` · `net` · `notification` · `power` · `menu` ·
+`globalshortcut` · `updater` · `capturer`, plus the builtins `ow-window`
+(window), `window` (WebView extras), `session`, `app`, and `crashreporter`.
 
-## Añadir un módulo nativo propio (C++)
+## Adding your own native module (C++)
 
-1. Crea `native/mi_modulo.cpp`:
+1. Create `native/my_module.cpp`:
 
    ```cpp
    #include <ow/Json.h>
@@ -61,17 +61,23 @@ Módulos incluidos (stock): `fs` · `path` · `process` (PTY) · `dialog` ·
        ow::Module::RespondOk(res, "\"pong\"");
    }
 
-   OW_MODULE_BEGIN(mi_modulo, "1.0.0")
+   OW_MODULE_BEGIN(my_module, "1.0.0")
    OW_FN(ping)
    OW_MODULE_END()
    ```
 
-2. `ow dev` lo compila a `.owm` y genera el binding. Úsalo en el renderer:
+2. `ow dev` compiles it to `.owm` and generates the binding. Use it in the
+   renderer:
 
    ```ts
-   import { mi_modulo } from '@owear/native'
-   await mi_modulo.ping()
+   import { my_module } from '@owear/native'
+   await my_module.ping()
    ```
 
-> Requiere un compilador de C++ en el sistema. Si no lo tienes, no añadas
-> `native/` y la app sigue funcionando con los módulos stock.
+> Requires a C++ compiler on the system. If you do not have one, do not add
+> `native/` and the app keeps working with the stock modules.
+
+## Learn more
+
+The full documentation lives in the Owear repository under
+[`docs/`](https://github.com/owear/owear/tree/main/docs).

package/template/app/main.ts

@@ -3,21 +3,290 @@
 //
 // app/main.ts — proceso principal (sidecar Node), estilo Electron.
 //
-// Sólo gestiona el ciclo de vida de la ventana. La app en sí vive en el
-// renderer, que llama a los módulos nativos directo. Aquí podrías añadir
-// lógica privilegiada (por ejemplo, exponerla vía un módulo nativo propio).
+// Sólo gestiona el ciclo de vida de la ventana. La app vive en el renderer,
+// que llama a los módulos nativos directo.
 
-import { app, BrowserWindow } from '@owear/core'
+import { app, BrowserWindow, Menu, Tray, invokeNative, nativeImage, theme, screen, powerMonitor, powerSaveBlocker } from '@owear/core'
+import * as fs from 'node:fs'
+import * as os from 'node:os'
+import * as path from 'node:path'
 
 app.whenReady().then(() => {
+  // Icono de la app: `favicon.svg` del proyecto (Vite lo copia a dist/ en build).
+  // `app.setIcon` fija el icono por defecto de las ventanas creadas después.
+  // (API de icono del kernel: `window.setIcon`.)
+  const iconPath = [
+    path.join(app.getAppPath(), 'favicon.svg'), // empaquetado: dist/ → app/
+    path.join(process.cwd(), 'public', 'favicon.svg'), // dev: public/ del proyecto
+  ].find((p) => fs.existsSync(p))
+  if (iconPath) app.setIcon(iconPath)
+
   const win = new BrowserWindow({
     title: '__APP_NAME__',
     width: 1080,
     height: 720,
     titleBarStyle: 'custom', // titlebar propia + regiones [data-ow-drag]
+    // Botones de ventana nativos (min/max/close) dentro de la titlebar custom.
+    // En Linux son los del TEMA (la distro define forma/tamaño/hover).
+    // Opcional: color = fondo de la banda · symbolColor = glifo ·
+    // buttonColor = fondo interno del círculo (si no, los del tema).
+    titleBarOverlay: { height: 40, color: '#21252b' },
     url: process.env.OW_DEV_SERVER_URL ?? 'app://index.html',
   })
 
   win.on('ready-to-show', () => console.log('[main] ventana lista, id =', win.id))
   win.on('closed', () => app.quit())
+
+  // ── C3: webContents (capturePage, eventos, setWindowOpenHandler) ─────────
+  app.handle('starter.capture', async () => {
+    const img = await win.webContents.capturePage()
+    return { data: img.toPNG().toString('base64') }
+  })
+  win.webContents.on('did-finish-load', () =>
+    void app.send('webContents.event', 'did-finish-load')
+  )
+  win.webContents.on('before-input-event', (e: { key?: string }) =>
+    void app.send('webContents.event', `before-input-event ${e?.key ?? ''}`)
+  )
+  win.webContents.setWindowOpenHandler(({ url }) => {
+    void app.send('webContents.event', `window-open ${url}`)
+    return { action: 'deny' }
+  })
+
+  // ── C4: nativeImage (captura → resize/crop/toPNG/dataURL) ────────────────
+  app.handle('starter.nativeImage', async () => {
+    const shot = await win.webContents.capturePage() // NativeImage
+    const small = shot.resize({ width: 64 })
+    const fromBuffer = nativeImage.createFromBuffer(shot.toPNG())
+    const fromUrl = nativeImage.createFromDataURL(small.toDataURL())
+    const cropped = shot.crop({ x: 0, y: 0, width: 16, height: 16 })
+    return {
+      original: shot.getSize(),
+      resized: small.getSize(),
+      cropped: cropped.getSize(),
+      pngBytes: small.toPNG().length,
+      reDecoded: fromBuffer.getSize(),
+      fromDataURL: fromUrl.getSize(),
+      empty: small.isEmpty(),
+    }
+  })
+
+  // ── C5: menu (contextual + menubar) ──────────────────────────────────────
+  // Menubar (Windows nativo; noop en Linux/GNOME por diseño).
+  Menu.setApplicationMenu(
+    Menu.buildFromTemplate([
+      {
+        label: 'Archivo',
+        submenu: [
+          { label: 'Nuevo', accelerator: 'CmdOrCtrl+N', click: () => void app.send('menu.event', 'Nuevo') },
+          { type: 'separator' },
+          { role: 'quit' },
+        ],
+      },
+      {
+        label: 'Ver',
+        submenu: [
+          {
+            label: 'Barra lateral',
+            type: 'checkbox',
+            checked: true,
+            click: (mi) => void app.send('menu.event', `sidebar=${mi.checked}`),
+          },
+          { type: 'separator' },
+          { role: 'toggleDevTools' },
+          { role: 'reload' },
+        ],
+      },
+    ])
+  )
+
+  // Menú contextual (popup) disparado por un botón del starter.
+  app.handle('starter.menu', () => {
+    Menu.buildFromTemplate([
+      { label: 'Nuevo', click: () => void app.send('menu.event', 'Nuevo') },
+      { label: 'Abrir', accelerator: 'CmdOrCtrl+O', click: () => void app.send('menu.event', 'Abrir') },
+      { type: 'separator' },
+      {
+        label: 'Barra lateral',
+        type: 'checkbox',
+        checked: true,
+        click: (mi) => void app.send('menu.event', `checkbox=${mi.checked}`),
+      },
+      { label: 'Zona A', type: 'radio', checked: true, click: () => void app.send('menu.event', 'radio A') },
+      { label: 'Zona B', type: 'radio', click: () => void app.send('menu.event', 'radio B') },
+      { type: 'separator' },
+      { role: 'copy' },
+      { role: 'toggleDevTools' },
+      { role: 'quit' },
+    ]).popup({ window: win })
+    return null
+  })
+
+  // ── C6: tray (icono de bandeja) ──────────────────────────────────────────
+  let tray: Tray | null = null
+  app.handle('starter.tray', async () => {
+    if (tray) return { created: false, id: tray.id }
+    const icon = (await win.webContents.capturePage()).resize({ width: 16, height: 16 })
+    tray = new Tray(icon)
+    tray.setToolTip('__APP_NAME__')
+    tray.setTitle('__APP_NAME__')
+    tray.setContextMenu(
+      Menu.buildFromTemplate([
+        { label: 'Mostrar ventana', click: () => void win.show() },
+        { label: 'Capturar página', click: () => void app.send('tray.event', 'capturar') },
+        { type: 'separator' },
+        { role: 'quit' },
+      ])
+    )
+    tray.on('click', () => {
+      void win.show()
+      void app.send('tray.event', 'click')
+    })
+    tray.on('right-click', () => void app.send('tray.event', 'right-click'))
+    tray.on('double-click', () => void app.send('tray.event', 'double-click'))
+    return { created: true, id: tray.id }
+  })
+  app.handle('starter.trayDestroy', () => {
+    tray?.destroy()
+    tray = null
+    return null
+  })
+
+  // ── C7: nativeTheme (leer/forzar/escuchar) ───────────────────────────────
+  app.handle('starter.themeGet', () => theme.get())
+  app.handle('starter.themeSet', async (src: string) => {
+    await theme.setSource((src as 'system' | 'light' | 'dark') ?? 'system')
+    return theme.get()
+  })
+  void theme.watch() // cambios del sistema → ow.on('theme.changed')
+
+  // ── C8: print / printToPDF ───────────────────────────────────────────────
+  app.handle('starter.printPdf', async () => {
+    try {
+      const pdf = await win.webContents.printToPDF()
+      const out = path.join(os.tmpdir(), 'owear-starter.pdf')
+      fs.writeFileSync(out, pdf)
+      void invokeNative('shell', 'showItemInFolder', out)
+      return { ok: true, bytes: pdf.length, path: out }
+    } catch (e) {
+      return { ok: false, error: e instanceof Error ? e.message : String(e) }
+    }
+  })
+  app.handle('starter.print', () => {
+    win.webContents.print()
+    return null
+  })
+
+  // ── C9: BrowserWindow completo ───────────────────────────────────────────
+  let child: BrowserWindow | null = null
+  app.handle('starter.childWindow', () => {
+    if (child) {
+      void child.focus()
+      return { id: child.id }
+    }
+    child = new BrowserWindow({
+      title: 'Ventana secundaria',
+      width: 520,
+      height: 360,
+      parent: win.id ?? undefined,
+      backgroundColor: '#12161c',
+      url: process.env.OW_DEV_SERVER_URL ?? 'app://index.html',
+    })
+    child.on('closed', () => {
+      child = null
+    })
+    return { id: child.id }
+  })
+  app.handle('starter.toggleOnTop', async () => {
+    const on = await win.isAlwaysOnTop()
+    await win.setAlwaysOnTop(!on)
+    return { on: !on }
+  })
+  app.handle('starter.progress', async () => {
+    await win.setProgressBar(0.5)
+    setTimeout(() => void win.setProgressBar(-1, { mode: 'none' }), 4000)
+    return null
+  })
+  app.handle('starter.ignoreMouse', () => {
+    void win.setIgnoreMouseEvents(true, { forward: true })
+    setTimeout(() => void win.setIgnoreMouseEvents(false), 3000)
+    return null
+  })
+  app.handle('starter.windows', async () => {
+    const focus = await BrowserWindow.getFocusedWindow()
+    const all = await BrowserWindow.getAllWindows()
+    return { focused: focus?.id ?? null, count: all.length, ids: all.map((w) => w.id) }
+  })
+
+  // ── C10: pantallas (multi-monitor) y energía ─────────────────────────────
+  app.handle('starter.screens', async () => {
+    await screen.watch()
+    const displays = await screen.getAllDisplays()
+    const primary = displays.find((d) => d.primary) ?? displays[0] ?? null
+    const cursor = await screen.getCursorScreenPoint()
+    return { displays, primaryId: primary?.id ?? null, cursor }
+  })
+  app.handle('starter.nearest', async () => {
+    const cursor = await screen.getCursorScreenPoint()
+    const display = await screen.getDisplayNearestPoint(cursor)
+    return { cursor, display }
+  })
+  app.handle('starter.powerOn', async () => {
+    await powerMonitor.watch()
+    const onBattery = await powerMonitor.isOnBatteryPower()
+    const idle = await powerMonitor.getIdleTime()
+    return { onBattery, idle }
+  })
+  app.handle('starter.idle', async () => {
+    const idleTime = await powerMonitor.getIdleTime()
+    const state = await powerMonitor.getIdleState(30)
+    return { idleTime, state }
+  })
+  let blockerId: number | null = null
+  app.handle('starter.blocker', () => {
+    if (blockerId != null) {
+      const ok = powerSaveBlocker.stop(blockerId)
+      blockerId = null
+      return { on: false, ok }
+    }
+    blockerId = powerSaveBlocker.start('prevent-display-sleep')
+    return { on: true, id: blockerId }
+  })
+})
+
+// ── C1: exponer `app` al renderer para probarlo en el starter ──────────────
+// El renderer llama `ow.invoke('node','call',{fn:'starter.*'})`.
+app.handle('starter.appInfo', () => ({
+  name: app.getName(),
+  version: app.getVersion(),
+  packaged: app.isPackaged(),
+  appPath: app.getAppPath(),
+}))
+
+const APP_PATH_NAMES = [
+  'home',
+  'userData',
+  'temp',
+  'logs',
+  'downloads',
+  'documents',
+  'exe',
+  'appPath',
+] as const
+
+app.handle('starter.appPaths', () => {
+  const out: Record<string, string> = {}
+  for (const name of APP_PATH_NAMES) out[name] = app.getPath(name)
+  return out
 })
+
+// Ciclo de vida de la app → renderer (app.send → ow.on('app.event')).
+for (const ev of [
+  'window-all-closed',
+  'before-quit',
+  'will-quit',
+  'second-instance',
+  'child-process-gone',
+] as const) {
+  app.on(ev, () => app.send('app.event', ev))
+}

package/template/index.html

@@ -31,7 +31,6 @@
 
     <main class="page">
       <section class="hero">
-        <span class="eyebrow">Owear</span>
         <h1>__APP_NAME__</h1>
         <p class="lead">
           Frontend web, sistema nativo. Estos botones llaman <strong>directo</strong> a los
@@ -39,6 +38,28 @@
         </p>
         <div class="actions">
           <button class="btn btn--primary" data-action="open">Abrir archivo…</button>
+          <button class="btn" data-action="multi">Abrir varios…</button>
+          <button class="btn" data-action="save">Guardar como…</button>
+          <button class="btn" data-action="capture">Capturar página</button>
+          <button class="btn" data-action="nimage">nativeImage</button>
+          <button class="btn" data-action="menu">Menú contextual</button>
+          <button class="btn" data-action="tray">Tray</button>
+          <button class="btn btn--ghost" data-action="theme-system">Tema: sistema</button>
+          <button class="btn btn--ghost" data-action="theme-light">Claro</button>
+          <button class="btn btn--ghost" data-action="theme-dark">Oscuro</button>
+          <button class="btn" data-action="pdf">Exportar PDF</button>
+          <button class="btn" data-action="print">Imprimir</button>
+          <button class="btn" data-action="child">Ventana 2</button>
+          <button class="btn" data-action="ontop">AlwaysOnTop</button>
+          <button class="btn" data-action="prog">Progreso</button>
+          <button class="btn" data-action="ignore">Ignorar ratón</button>
+          <button class="btn" data-action="wins">Ventanas</button>
+          <button class="btn" data-action="screens">Pantallas</button>
+          <button class="btn" data-action="nearest">Monitor del cursor</button>
+          <button class="btn btn--ghost" data-action="power-on">Escuchar energía</button>
+          <button class="btn btn--ghost" data-action="blocker">Bloqueador ON/OFF</button>
+          <button class="btn btn--ghost" data-action="idle">Idle</button>
+          <button class="btn" data-action="ask">Diálogo con botones</button>
           <button class="btn" data-action="notify">Notificar</button>
           <button class="btn" data-action="copy">Copiar ruta</button>
           <button class="btn" data-action="reveal">Mostrar en carpeta</button>
@@ -46,37 +67,105 @@
         </div>
       </section>
 
-      <section class="grid">
-        <article class="card">
-          <header class="card__head">
-            <h2>Entorno</h2>
-            <span class="badge" id="env-window">—</span>
-          </header>
-          <dl class="kv">
-            <div><dt>Plataforma</dt><dd id="env-platform">—</dd></div>
-            <div><dt>Motor</dt><dd id="env-engine">—</dd></div>
-            <div><dt>Escala</dt><dd id="env-dpr">—</dd></div>
-          </dl>
-          <p class="ua" id="env-ua">—</p>
-        </article>
+      <!-- Contenedor con fondo propio que agrupa las cards -->
+      <section class="board">
+        <section class="grid">
+          <article class="card">
+            <header class="card__head">
+              <h2>Entorno</h2>
+              <span class="badge" id="env-window">—</span>
+            </header>
+            <dl class="kv">
+              <div><dt>Plataforma</dt><dd id="env-platform">—</dd></div>
+              <div><dt>Motor</dt><dd id="env-engine">—</dd></div>
+              <div><dt>Escala</dt><dd id="env-dpr">—</dd></div>
+            </dl>
+            <p class="ua" id="env-ua">—</p>
+          </article>
 
-        <article class="card card--grow">
-          <header class="card__head">
-            <h2>Consola</h2>
-            <button class="linkbtn" data-action="clear">Limpiar</button>
-          </header>
-          <pre id="console" class="console">Listo. Pulsa «Abrir archivo…» para invocar un módulo nativo.</pre>
-        </article>
-      </section>
+          <article class="card">
+            <header class="card__head">
+              <h2>App <span class="hint">C1</span></h2>
+              <span class="badge" id="app-version">—</span>
+            </header>
+            <dl class="kv">
+              <div><dt>Nombre</dt><dd id="app-name">—</dd></div>
+              <div><dt>Empaquetada</dt><dd id="app-packaged">—</dd></div>
+              <div><dt>userData</dt><dd id="app-path-userData" class="mono">—</dd></div>
+              <div><dt>exe</dt><dd id="app-path-exe" class="mono">—</dd></div>
+              <div><dt>appPath</dt><dd id="app-path-appPath" class="mono">—</dd></div>
+            </dl>
+          </article>
 
-      <section class="card">
-        <header class="card__head"><h2>Cómo funciona</h2></header>
-        <p class="hint">
-          Cada botón invoca un módulo nativo con <code>ow.invoke()</code>.
-        </p>
-        <pre class="code"><code>const path = await ow.invoke('dialog', 'open', 'open', 'Abrir archivo')
+          <article class="card card--grow">
+            <header class="card__head">
+              <h2>Consola</h2>
+              <button class="linkbtn" data-action="clear">Limpiar</button>
+            </header>
+            <pre id="console" class="console">Listo. Pulsa «Abrir archivo…» para invocar un módulo nativo.</pre>
+          </article>
+        </section>
+
+        <section class="card">
+          <header class="card__head"><h2>Cómo funciona</h2></header>
+          <p class="hint">
+            Cada botón invoca un módulo nativo con <code>ow.invoke()</code>.
+          </p>
+          <pre class="code"><code>const path = await ow.invoke('dialog', 'open', 'open', 'Abrir archivo')
 const text = await ow.invoke('fs', 'readText', path)
 await ow.invoke('notification', 'show', 'Listo', 'Leídos ' + text.length + ' bytes')</code></pre>
+        </section>
+      </section>
+
+      <!-- C10: pantallas (multi-monitor) y energía -->
+      <section class="board">
+        <header class="card__head">
+          <h2>Pantallas y energía <span class="hint">C10</span></h2>
+          <span class="badge" id="mon-count">—</span>
+        </header>
+        <section class="grid">
+          <article class="card">
+            <header class="card__head">
+              <h2>Monitores</h2>
+              <span class="badge" id="mon-primary">—</span>
+            </header>
+            <div id="mon-map" class="monmap">
+              <span class="monmap__hint">Pulsa «Pantallas» para mapear los monitores.</span>
+            </div>
+            <div id="mon-list" class="monlist"></div>
+          </article>
+          <article class="card card--grow">
+            <header class="card__head">
+              <h2>Energía</h2>
+              <span class="badge" id="power-status">—</span>
+            </header>
+            <p class="hint">
+              Escucha suspend/resume, AC/batería y bloqueo de sesión. El bloqueador
+              impide que se apague la pantalla.
+            </p>
+            <pre id="power-log" class="console console--short">Sin eventos todavía.</pre>
+          </article>
+        </section>
+      </section>
+
+      <!-- Webview embebida: un navegador nativo hijo de la ventana (proceso
+           propio), controlado por la API webview.* y colocado sobre #wv-slot. -->
+      <section class="board">
+        <header class="card__head">
+          <h2>Navegador embebido</h2>
+          <span class="badge" id="wv-status">—</span>
+        </header>
+        <div class="browser">
+          <div class="browser__bar">
+            <button class="iconbtn" id="wv-back" title="Atrás" aria-label="Atrás">‹</button>
+            <button class="iconbtn" id="wv-fwd" title="Adelante" aria-label="Adelante">›</button>
+            <button class="iconbtn" id="wv-reload" title="Recargar" aria-label="Recargar">⟳</button>
+            <input id="wv-url" class="browser__url" type="text"
+                   value="https://scrakk.art" spellcheck="false" />
+            <button class="btn btn--primary" id="wv-go">Ir</button>
+          </div>
+          <div id="wv-slot" class="browser__slot"></div>
+        </div>
       </section>
     </main>
 

package/template/package.json

@@ -3,7 +3,7 @@
   "version": "0.1.0",
   "private": true,
   "type": "module",
-  "description": "App de escritorio construida con Owear.",
+  "description": "App de escritorio construida con Owear (Starter: titlebar propia, módulos nativos y UI real).",
   "scripts": {
     "dev": "ow dev",
     "build": "ow build",

package/template/public/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64">
+  <rect width="64" height="64" rx="14" fill="#282c34"/>
+  <rect x="18" y="18" width="28" height="28" rx="7" fill="#d3869b"/>
+</svg>

package/template/src/ow.d.ts

@@ -2,13 +2,21 @@
 // SPDX-License-Identifier: Apache-2.0
 //
 // Tipos de la API que el kernel inyecta en cada documento (`window.ow`).
-// Mantenidos a mano contra docs/API.md §1.
+// Types maintained by hand against docs/api/renderer.md.
 
 export {}
 
 declare global {
   interface Window {
     __owWindowId: number
+    /** Presente cuando la ventana usa `titleBarOverlay` (botones nativos). */
+    __owTitlebarOverlay?: {
+      enabled: boolean
+      height: number
+      width: number
+      top?: number
+      right?: number
+    }
     ow: {
       invoke(module: string, fn: string, ...args: unknown[]): Promise<unknown>
       invokeSync(module: string, fn: string, ...args: unknown[]): unknown