@owear/cli 0.1.3 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owear/cli",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "CLI de Owear: create, dev, build",
   "type": "module",
   "bin": {
@@ -8,8 +8,8 @@
     "owear-build-native": "./src/owear-build-native.js"
   },
   "optionalDependencies": {
-    "@owear/linux-x64-gnu": "0.1.3",
-    "@owear/win32-x64": "0.1.3"
+    "@owear/linux-x64-gnu": "workspace:*",
+    "@owear/win32-x64": "workspace:*"
   },
   "files": [
     "src",
@@ -17,6 +17,9 @@
     "template",
     "template-installer"
   ],
+  "scripts": {
+    "typecheck": "node --check src/ow.js && node --check src/owear-build-native.js && node --check tools/owear-pack.mjs && node --check tools/owear-installer.mjs && node --check tools/owear-linux.mjs && node --check tools/owear-msi.mjs && node --check tools/owear-update.mjs && node --check tools/owear-sign.mjs"
+  },
   "license": "Apache-2.0",
   "homepage": "https://owear.dev",
   "repository": {
@@ -29,8 +32,5 @@
   },
   "engines": {
     "node": ">=20"
-  },
-  "scripts": {
-    "typecheck": "node --check src/ow.js && node --check src/owear-build-native.js && node --check tools/owear-pack.mjs && node --check tools/owear-installer.mjs && node --check tools/owear-linux.mjs && node --check tools/owear-msi.mjs"
   }
-}
+}

package/src/ow.js

@@ -148,6 +148,7 @@ async function main() {
     case 'dev':    return cmdDev(rest)
     case 'build':  return cmdBuild(rest)
     case 'api':    return cmdApi(rest)
+    case 'update': return cmdUpdate(rest)
     default:
       die(`comando desconocido: ${cmd} (usa --help)`)
   }
@@ -167,9 +168,20 @@ ${C.cyan}owear${C.reset} — framework desktop nativo
   ${C.green}ow build uninstaller${C.reset}         binario desinstalador
   ${C.green}ow api list${C.reset}                  lista las APIs del repo y sus manifiestos
   ${C.green}ow api new <nombre>${C.reset}          scaffoldea una API (api/<nombre>/ + manifiesto)
+  ${C.green}ow update --file <bin> --version <v>${C.reset}  publica un update (blockmap + manifiesto YAML firmado)
+  ${C.green}ow update --gen-key <ruta>${C.reset}   genera un par de claves Ed25519 para firmar
 
 Variables útiles:
   OW_KERNEL_BIN     ruta al binario owear
+  OW_SIGN_KEY       clave privada Ed25519 para firmar artefactos (→ <file>.sig)
+  OW_SIGN_PFX       certificado PKCS#12 para Authenticode (Windows PE/MSI)
+  OW_SIGN_PFX_PASSWORD  contraseña del PFX (o --pfx-password-env)
+
+Firma (ow build app|installer|uninstaller):
+  --sign-key <pem>           firma Ed25519 desprendida del artefacto
+  --pfx <p12>                Authenticode (requiere osslsigncode/signtool)
+  --timestamp <url>          sellado de tiempo Authenticode
+  --require-sign             falla el build si no se firma
 `)
 }
 
@@ -380,7 +392,7 @@ function findMainEntry(cwd) {
  * así que compilamos con esbuild (viene con vite). De este modo el runtime del
  * sistema sirve y el arranque no depende de la versión que tenga el usuario.
  */
-function prepareMain(cwd, outDir) {
+function prepareMain(cwd, outDir, bundle = false) {
   const entry = findMainEntry(cwd)
   if (!entry) return null
   if (entry.endsWith('.js') || entry.endsWith('.mjs')) return entry
@@ -393,7 +405,11 @@ function prepareMain(cwd, outDir) {
     [
       'esbuild', entry,
       '--bundle', '--platform=node', '--format=esm',
-      '--packages=external', `--outfile=${out}`, '--log-level=warning',
+      // En producción se EMBEBE @owear/core (y deps) en main.js: el payload de
+      // un single-binary/instalador no lleva node_modules. En dev se dejan
+      // externas (node_modules está presente).
+      ...(bundle ? [] : ['--packages=external']),
+      `--outfile=${out}`, '--log-level=warning',
     ],
     { cwd, stdio: 'inherit', shell: process.platform === 'win32' }
   )
@@ -538,7 +554,7 @@ async function cmdBuildBundle(cwd) {
   const code = await runProc('npx', ['vite', 'build'], { cwd, shell: process.platform === 'win32' })
   if (code !== 0) die('vite build falló')
 
-  const mainJs = prepareMain(cwd, path.join(cwd, 'dist'))
+  const mainJs = prepareMain(cwd, path.join(cwd, 'dist'), true)
 
   const workersDir = prepareWorkers(cwd, path.join(cwd, 'dist'))
   if (workersDir) log(`workers: ${path.relative(cwd, workersDir)}`)
@@ -695,6 +711,52 @@ function runTool(name, args) {
   if (r.status !== 0) die(`falló ${name}`)
 }
 
+/**
+ * Firma un artefacto recién construido. Authenticode si hay `--pfx`
+ * (`OW_SIGN_PFX`), Ed25519 desprendida (`<file>.sig`) si hay `--sign-key`
+ * (`OW_SIGN_KEY`). Nunca rompe el build: sin material de firma no hace nada;
+ * con `--require-sign` la firma pasa a ser obligatoria.
+ */
+function signArtifact(args, file) {
+  const key = flag(args, '--sign-key', process.env.OW_SIGN_KEY ?? '')
+  const pfx = flag(args, '--pfx', process.env.OW_SIGN_PFX ?? '')
+  if (!key && !pfx) return
+  const extra = []
+  if (key) extra.push('--ed25519-key', key)
+  if (pfx) {
+    extra.push('--pfx', pfx, '--pfx-password-env', flag(args, '--pfx-password-env', 'OW_SIGN_PFX_PASSWORD'))
+  }
+  const ts = flag(args, '--timestamp', process.env.OW_SIGN_TIMESTAMP ?? '')
+  if (ts) extra.push('--timestamp', ts)
+  if (args.includes('--require-sign')) extra.push('--require')
+  runTool('owear-sign.mjs', ['--file', file, ...extra])
+}
+
+/**
+ * ow update — publica un update del auto-updater: calcula el blockmap (delta
+ * por bloques), genera el manifiesto YAML del canal y lo firma (Ed25519).
+ * Delega en tools/owear-update.mjs (mismos flags).
+ */
+function cmdUpdate(args) {
+  if (!args.length) {
+    console.log(`
+${C.cyan}ow update${C.reset} — publica un update (delta + manifiesto YAML firmado)
+
+  ${C.green}ow update --gen-key owear-signing${C.reset}
+      genera el par de claves Ed25519 (privada <ruta>.pem; pública <ruta>.pub.b64,
+      que va en el bridge como ${C.dim}updater.publicKey${C.reset})
+
+  ${C.green}ow update --file release/MiApp-1.4.0 --version 1.4.0 --key owear-signing.pem${C.reset} \\
+      [--channel latest] [--url https://up.miapp.dev] [--notes "…"|--notes @notas.md] \\
+      [--block-size 262144] [--mandatory] [--out-dir release]
+
+  Salidas: ${C.dim}<file>.blockmap${C.reset} (bloques sha256) y ${C.dim}<channel>.yml${C.reset} (manifiesto YAML).
+`)
+    return
+  }
+  runTool('owear-update.mjs', args)
+}
+
 function readPkg(cwd) {
   try {
     return JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf8'))
@@ -771,6 +833,7 @@ async function cmdBuildApp(cwd, args) {
     const out = path.join(outDir, exe)
     packDir(kernel, bundle, out)
     log(`binario único: ${out}`)
+    signArtifact(args, out)
     return
   }
 
@@ -799,6 +862,7 @@ async function cmdBuildApp(cwd, args) {
     runTool('owear-linux.mjs', ['deb', '--stage', stage, '--out', out, '--name', slug,
       '--version', meta.version, '--maintainer', meta.publisher, '--description', meta.appName])
     log(`.deb: ${out}`)
+    signArtifact(args, out)
     return
   }
 
@@ -823,6 +887,7 @@ async function cmdBuildApp(cwd, args) {
     const out = path.join(outDir, `${slug}-${meta.version}-x86_64.AppImage`)
     runTool('owear-linux.mjs', ['appimage', '--appdir', appDir, '--out', out, '--arch', 'x86_64'])
     log(`AppImage: ${out}`)
+    signArtifact(args, out)
     return
   }
 
@@ -833,6 +898,7 @@ async function cmdBuildApp(cwd, args) {
     runTool('owear-msi.mjs', ['--stage', stage, '--out', out, '--name', slug,
       '--version', meta.version, '--publisher', meta.publisher, '--appId', meta.appId])
     log(`.MSI: ${out}`)
+    signArtifact(args, out)
     return
   }
 
@@ -869,7 +935,14 @@ async function cmdBuildInstaller(cwd, args, isUninstaller) {
     // 1b) desinstalador (si existe installer/uninstaller) → se instala junto a la app
     if (fs.existsSync(path.join(cwd, 'installer', 'uninstaller'))) {
       log('build del desinstalador…')
-      await cmdBuildInstaller(cwd, [], true)
+      // propaga solo los flags de firma (no --mode/--format, que no aplican)
+      const signArgs = []
+      for (const f of ['--sign-key', '--pfx', '--pfx-password-env', '--timestamp']) {
+        const v = flag(args, f, null)
+        if (v) signArgs.push(f, v)
+      }
+      if (args.includes('--require-sign')) signArgs.push('--require-sign')
+      await cmdBuildInstaller(cwd, signArgs, true)
       const un = path.join(outDir, `${slug}-uninstaller${exe}`)
       if (fs.existsSync(un)) fs.copyFileSync(un, path.join(payloadDir, path.basename(un)))
     }
@@ -879,11 +952,15 @@ async function cmdBuildInstaller(cwd, args, isUninstaller) {
   const ui = await buildInstallerUI(cwd, isUninstaller ? 'uninstaller' : 'installer')
 
   // 3) metadatos (installer.json / uninstaller.json) — el kernel los detecta
+  const iconRel = bridge.obj?.app?.icon
+  const iconAbs = iconRel ? path.resolve(cwd, iconRel) : ''
+  const iconOk = Boolean(iconAbs) && fs.existsSync(iconAbs)
   const meta = {
     appId: bridge.obj?.app?.id ?? slug,
     appName: bridge.obj?.app?.name ?? slug,
     version: bridge.obj?.app?.version ?? '0.0.0',
     publisher: bridge.obj?.app?.publisher ?? null,
+    icon: iconOk ? 'icon' + path.extname(iconAbs) : null,
     mode: isUninstaller ? 'uninstaller' : mode,
     layout: target.layout ?? mode,
     order: bridge.obj?.order ?? null,
@@ -909,9 +986,11 @@ async function cmdBuildInstaller(cwd, args, isUninstaller) {
     '--name', slug,
   ]
   if (payloadDir) toolArgs.push('--payload', payloadDir)
+  if (iconOk) toolArgs.push('--icon', iconAbs)
   const r = spawnSync(process.execPath, toolArgs, { stdio: 'inherit' })
   if (r.status !== 0) die(`falló owear-installer (${kind})`)
   log(`${kind}: ${out}`)
+  signArtifact(args, out)
 }
 
 main().catch((e) => die(e?.stack ?? String(e)))

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))
+}