html2apk 0.8.0 → 0.9.0

package/README.md

@@ -297,6 +297,12 @@ Prioridade de configuracao:
 2. `app.json` ou `config.json`.
 3. Valores padrao do html2apk.
 
+### Modo Flutuante E Sobreposicao
+
+O icone flutuante usa a permissao especial `SYSTEM_ALERT_WINDOW`. A bridge nativa declara essa permissao no APK para que o Android liste o app na tela de `Aparecer sobre outros apps`.
+
+Mesmo com a permissao declarada no manifesto, o usuario ainda precisa liberar manualmente nas configuracoes do Android. Depois de liberar, volte ao app e chame `iniciarIconeFlutuante()` novamente.
+
 ### Tema Automatico Do APK
 
 Use `themeMode: "auto"` ou `theme: "auto"` para o APK adaptar as barras nativas do Android a cor que esta visivel na tela. O html2apk observa a tela do WebView e ajusta status bar/navigation bar em tempo real.
@@ -406,9 +412,23 @@ Exemplos de aliases:
 | `pararMic()` | `stopMic()` |
 | `lanterna()` | `flashlight()` |
 | `alternarLanterna()` | `toggleFlashlight()` |
+| `tirarFoto()` | `takePhoto()` / `capturePhoto()` |
+| `capturarVideo()` | `captureVideo()` |
+| `escanearQRCode()` | `scanQRCode()` |
 | `escolherArquivo()` | `pickFile()` |
 | `escolherImagem()` | `pickImage()` |
 | `salvarArquivo()` | `saveFile()` |
+| `lerArquivo()` | `readFile()` |
+| `listarArquivos()` | `listFiles()` |
+| `excluirArquivo()` | `deleteFile()` |
+| `abrirArquivo()` | `openFile()` |
+| `compartilharArquivo()` | `shareFile()` |
+| `baixarArquivo()` | `downloadFile()` |
+| `baixarBase64()` | `downloadBase64()` |
+| `baixarArquivoLocal()` | `downloadLocalFile()` / `downloadFromFile()` |
+| `definirPapelParede()` | `setWallpaper()` |
+| `infoPapelParede()` | `wallpaperInfo()` |
+| `abrirConfiguracaoPapelParede()` | `openWallpaperSettings()` |
 | `compartilhar()` | `share()` |
 | `copiarTexto()` | `copyText()` |
 | `lerTextoCopiado()` | `readText()` |
@@ -422,11 +442,18 @@ Exemplos de aliases:
 | `infoArmazenamento()` | `storageInfo()` |
 | `infoDesempenho()` | `performanceInfo()` |
 | `appsAbertos()` | `openAppsMemory()` |
+| `obterLocalizacao()` | `getLocation()` |
+| `acompanharLocalizacao()` | `watchLocation()` |
+| `pararLocalizacao()` | `stopLocationWatch()` |
+| `autenticarBiometria()` | `authenticateBiometric()` |
+| `salvarSeguro()` | `saveSecure()` |
+| `lerSeguro()` | `readSecure()` |
+| `removerSeguro()` | `deleteSecure()` |
 | `aoEvento()` | `onEvent()` |
 | `aoMinimizar()` | `onMinimize()` |
 | `obterLinkInicial()` | `getInitialLink()` |
 
-Os eventos tambem aceitam aliases em ingles em `onEvent()`: `app:ready`, `app:background`, `app:resumed`, `back:button`, `link:opened`, `network:changed`, `battery:changed`, `notification:received` e `notification:clicked`.
+Os eventos tambem aceitam aliases em ingles em `onEvent()`: `app:ready`, `app:background`, `app:resumed`, `back:button`, `link:opened`, `network:changed`, `battery:changed`, `location:changed`, `notification:received` e `notification:clicked`.
 
 Como tratar retornos:
 
@@ -623,6 +650,103 @@ await salvarArquivo({
 await compartilhar({ texto: "Veja isso", url: "https://exemplo.com" });
 ```
 
+`salvarArquivo()` tem dois modos:
+
+- `salvarArquivo({ nome, conteudo })` abre o seletor nativo para o usuario escolher onde salvar, como ja acontecia.
+- `salvarArquivo("nomeArquivo", minhaVariavel)` salva direto no armazenamento app-scoped do APK. Use esse formato para CRUD interno.
+
+CRUD de arquivos internos:
+
+```js
+await salvarArquivo("perfil.json", {
+  nome: "Ana",
+  plano: "premium"
+});
+
+const perfil = await lerArquivo("perfil.json");
+console.log(perfil.nome);
+
+const completo = await lerArquivoCompleto("perfil.json");
+console.log(completo.uri, completo.tamanho);
+
+const existe = await arquivoExiste("perfil.json");
+const arquivos = await listarArquivos();
+
+await abrirArquivo("perfil.json");
+await compartilharArquivo("perfil.json");
+await excluirArquivo("perfil.json");
+```
+
+Para baixar um arquivo e guardar no mesmo armazenamento:
+
+```js
+await baixarArquivo("https://exemplo.com/relatorio.pdf", "relatorio.pdf");
+await abrirArquivo("relatorio.pdf");
+
+await baixarBase64("foto.png", base64DaImagem, {
+  mimeType: "image/png"
+});
+
+const arquivo = await escolherArquivo();
+if (arquivo) {
+  await baixarArquivoLocal(arquivo, "copia-" + arquivo.name);
+}
+```
+
+Durante `baixarArquivo()`, `baixarBase64()` e `baixarArquivoLocal()`, o Android mostra uma notificacao de progresso quando a permissao `POST_NOTIFICATIONS` estiver liberada. No Android 13+, o html2apk pede essa permissao automaticamente; se o usuario negar, o download continua e o retorno vem com `notificationShown: false`.
+
+Papel de parede:
+
+```js
+const foto = await tirarFoto({ base64: true });
+
+await salvarArquivo("wallpaper.jpg", foto.base64, {
+  base64: true,
+  mimeType: "image/jpeg"
+});
+
+const resultado = await definirPapelParede("wallpaper.jpg", {
+  alvo: "inicio" // "inicio", "bloqueio" ou "ambos"
+});
+
+console.log(resultado.applied, resultado.systemApplied, resultado.lockApplied);
+```
+
+`definirPapelParede()` usa a API publica `WallpaperManager` do Android para imagem estatica. A entrada pode ser nome de arquivo salvo pelo app, `content://`/`file://`, data URL (`data:image/...;base64,...`) ou objeto `{ base64, mimeType }`. Video wallpaper e fundo de chamadas dependem do fluxo do sistema, live wallpaper ou app de telefone do fabricante; nesses casos use `infoPapelParede()` e `abrirConfiguracaoPapelParede()`.
+
+Camera, QR Code, localizacao, biometria e storage seguro:
+
+```js
+const foto = await tirarFoto({ base64: true });
+
+const qr = await escanearQRCode();
+if (qr) {
+  console.log(qr.text);
+}
+
+const local = await obterLocalizacao({ altaPrecisao: true, timeoutMs: 10000 });
+console.log(local.latitude, local.longitude);
+
+const watch = await acompanharLocalizacao({ intervaloMs: 5000 });
+const pararEvento = aoMudarLocalizacao((evento) => {
+  console.log(evento.latitude, evento.longitude);
+});
+
+await pararLocalizacao(watch.watchId);
+pararEvento();
+
+const bio = await autenticarBiometria({
+  titulo: "Confirmar acesso",
+  descricao: "Use a biometria do aparelho"
+});
+
+if (bio.authenticated) {
+  await salvarSeguro("token", "abc123");
+  const token = await lerSeguro("token");
+  await removerSeguro("token");
+}
+```
+
 O retorno de arquivos tem este formato:
 
 ```json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "html2apk",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Node CLI and library to turn an HTML/CSS/JS folder into an Android APK through Cordova.",
   "main": "index.js",
   "bin": {

package/src/desktop/main.js

@@ -395,6 +395,339 @@ function cleanBuildOptions(options = {}) {
   return output;
 }
 
+function nativeFunctionLabHtml() {
+  return `<!doctype html>
+<html lang="pt-BR">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>html2apk - Teste de funcoes</title>
+  <style>
+    :root {
+      color-scheme: light dark;
+      --bg: #f6f8fb;
+      --panel: #ffffff;
+      --text: #172033;
+      --muted: #65758b;
+      --line: #dbe3ee;
+      --blue: #126fff;
+      --green: #18864b;
+      --red: #c33b3b;
+      --code: #0c1117;
+    }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      font-family: Inter, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+      background: var(--bg);
+      color: var(--text);
+    }
+    header {
+      position: sticky;
+      top: 0;
+      z-index: 2;
+      background: color-mix(in srgb, var(--panel) 92%, transparent);
+      border-bottom: 1px solid var(--line);
+      padding: 14px 16px;
+      backdrop-filter: blur(14px);
+    }
+    h1 { margin: 0; font-size: 1.2rem; }
+    header p { margin: 6px 0 0; color: var(--muted); line-height: 1.35; }
+    main { display: grid; gap: 14px; padding: 14px; }
+    section {
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: var(--panel);
+      overflow: hidden;
+    }
+    h2 {
+      margin: 0;
+      padding: 13px 14px;
+      font-size: .98rem;
+      border-bottom: 1px solid var(--line);
+    }
+    .grid {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
+      gap: 10px;
+      padding: 12px;
+    }
+    button {
+      min-height: 48px;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: #eef5ff;
+      color: var(--blue);
+      padding: 10px;
+      font-weight: 800;
+      text-align: left;
+    }
+    button:active { transform: translateY(1px); }
+    button small { display: block; margin-top: 4px; color: var(--muted); font-weight: 600; line-height: 1.3; }
+    .danger { background: #fff0f0; color: var(--red); }
+    .notice {
+      margin: 12px;
+      padding: 10px 12px;
+      border-radius: 8px;
+      background: #fff8df;
+      color: #745400;
+      line-height: 1.42;
+    }
+    @media (prefers-color-scheme: dark) {
+      :root {
+        --bg: #10141b;
+        --panel: #151b24;
+        --text: #e6edf7;
+        --muted: #9aa8ba;
+        --line: #283243;
+      }
+      button { background: #172642; }
+      .danger { background: #351c20; }
+      .notice { background: #2d2816; color: #f2cc60; }
+    }
+  </style>
+</head>
+<body>
+  <header>
+    <h1>Teste de funcoes html2apk</h1>
+    <p>Toque nos botoes para chamar as funcoes interpretadas do APK. Algumas abrem permissoes, camera, seletor de arquivo ou outro app Android.</p>
+  </header>
+  <main id="groups"></main>
+  <script>
+    (function () {
+      var state = {
+        scheduledId: null,
+        loopId: null,
+        watchId: null,
+        stopLocationEvent: null,
+        lastImage: null,
+        lastPhoto: null,
+        micRecording: false,
+        eventsReady: false
+      };
+      var sampleImageBase64 = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+/p9sAAAAASUVORK5CYII=";
+
+      function fn(name) {
+        if (typeof window[name] !== "function") {
+          throw new Error(name + " nao esta disponivel neste APK.");
+        }
+        return window[name];
+      }
+
+      function log(title, value, kind) {
+        var consoleKind = kind === "err" ? "error" : (kind === "ok" ? "ok" : "info");
+        var hasValue = value !== "" && typeof value !== "undefined";
+        if (window.Html2ApkRuntimeConsole && typeof window.Html2ApkRuntimeConsole.log === "function") {
+          window.Html2ApkRuntimeConsole.log(consoleKind, title, hasValue ? value : undefined);
+          return;
+        }
+        if (consoleKind === "error") {
+          console.error(title, hasValue ? value : "");
+        } else if (consoleKind === "ok") {
+          console.log(title, hasValue ? value : "");
+        } else {
+          console.info(title, hasValue ? value : "");
+        }
+      }
+
+      async function run(id) {
+        var test = actions[id];
+        if (!test) {
+          return;
+        }
+        log("Executando " + test.title, "", "");
+        try {
+          var result = await test.run();
+          log("OK: " + test.title, result, "ok");
+        } catch (error) {
+          log("ERRO: " + test.title, error, "err");
+        }
+      }
+
+      function registerEvents() {
+        if (state.eventsReady) {
+          return { registered: true, already: true };
+        }
+        state.eventsReady = true;
+        fn("aoEvento")("app:background", function (event) { log("evento app:background", event, "ok"); });
+        fn("aoEvento")("app:voltou", function (event) { log("evento app:voltou", event, "ok"); });
+        fn("aoEvento")("botao:voltar", function (event) { log("evento botao:voltar", event, "ok"); });
+        fn("aoEvento")("rede:mudou", function (event) { log("evento rede:mudou", event, "ok"); });
+        fn("aoEvento")("bateria:mudou", function (event) { log("evento bateria:mudou", event, "ok"); });
+        fn("aoClicarNotificacao")(function (event) { log("notificacao clicada", event, "ok"); });
+        return { registered: true };
+      }
+
+      var actions = {
+        toast: { title: "toast()", run: function () { return fn("toast")("Mensagem do app de teste"); } },
+        vibrar: { title: "vibrar()", run: function () { return fn("vibrar")(250); } },
+        copiarTexto: { title: "copiarTexto()", run: function () { return fn("copiarTexto")("Texto copiado pelo html2apk"); } },
+        lerTextoCopiado: { title: "lerTextoCopiado()", run: function () { return fn("lerTextoCopiado")(); } },
+        compartilharTexto: { title: "compartilharTexto()", run: function () { return fn("compartilharTexto")("Compartilhado pelo app de teste html2apk"); } },
+        compartilhar: { title: "compartilhar()", run: function () { return fn("compartilhar")({ texto: "Teste html2apk", url: "https://example.com" }); } },
+
+        notificar: { title: "notificar()", run: function () { return fn("notificar")({ titulo: "html2apk", texto: "Notificacao imediata", aoClicar: { funcao: "toast", argumentos: ["Notificacao clicada"] } }); } },
+        agendarNotificacao: { title: "agendarNotificacao()", run: async function () { var result = await fn("agendarNotificacao")({ titulo: "html2apk", texto: "Agendada para 10 segundos", quando: Date.now() + 10000 }); state.scheduledId = result && result.id; return result; } },
+        cancelarNotificacao: { title: "cancelarNotificacao()", run: function () { return fn("cancelarNotificacao")(state.scheduledId || 0); } },
+        agendarLoopNotificacoes: { title: "agendarLoopNotificacoes()", run: async function () { var result = await fn("agendarLoopNotificacoes")({ aCada: "30s", notificacoes: [{ titulo: "Loop 1", texto: "Primeiro item" }, { titulo: "Loop 2", texto: "Segundo item" }] }); state.loopId = result && result.id; return result; } },
+        cancelarLoopNotificacoes: { title: "cancelarLoopNotificacoes()", run: function () { return fn("cancelarLoopNotificacoes")(state.loopId || 0); } },
+        pushInfo: { title: "Push OneSignal", run: function () { if (typeof window.solicitarPermissaoPush !== "function") { return { available: false, message: "Configure OneSignal App ID no app real para testar push remoto." }; } return window.solicitarPermissaoPush(); } },
+
+        statusPermissoes: { title: "statusPermissoes()", run: function () { return fn("statusPermissoes")(["CAMERA", "RECORD_AUDIO", "ACCESS_FINE_LOCATION", "POST_NOTIFICATIONS", "SET_WALLPAPER"]); } },
+        permissaoNotificacao: { title: "solicitarPermissaoNotificacoes()", run: function () { return fn("solicitarPermissaoNotificacoes")(); } },
+        permissaoCamera: { title: "solicitarPermissaoCamera()", run: function () { return fn("solicitarPermissaoCamera")(); } },
+        permissaoMicrofone: { title: "solicitarPermissaoMicrofone()", run: function () { return fn("solicitarPermissaoMicrofone")(); } },
+        alarmeExato: { title: "podeAgendarNotificacaoExata()", run: function () { return fn("podeAgendarNotificacaoExata")(); } },
+        abrirAlarmeExato: { title: "abrirConfiguracaoAlarmeExato()", run: function () { return fn("abrirConfiguracaoAlarmeExato")(); } },
+        statusSobreposicao: { title: "statusPermissaoSobreposicao()", run: function () { return fn("statusPermissaoSobreposicao")(); } },
+        abrirSobreposicao: { title: "abrirConfiguracaoSobreposicao()", run: function () { return fn("abrirConfiguracaoSobreposicao")(); } },
+
+        fullscreenOn: { title: "fullscreen(true)", run: function () { return fn("fullscreen")(true); } },
+        fullscreenOff: { title: "fullscreen(false)", run: function () { return fn("fullscreen")(false); } },
+        telaAcordadaOn: { title: "manterTelaAcordada(true)", run: function () { return fn("manterTelaAcordada")(true); } },
+        telaAcordadaOff: { title: "manterTelaAcordada(false)", run: function () { return fn("manterTelaAcordada")(false); } },
+        brilhoTela: { title: "brilhoTela()", run: function () { return fn("brilhoTela")(0.72); } },
+        corTema: { title: "definirCorTema()", run: function () { return fn("definirCorTema")({ statusBarColor: "#126fff", navigationBarColor: "#10141b", darkIcons: false }); } },
+        lanterna: { title: "alternarLanterna()", run: function () { return fn("alternarLanterna")(); } },
+        statusLanterna: { title: "statusLanterna()", run: function () { return fn("statusLanterna")(); } },
+        iniciarIconeFlutuante: { title: "iniciarIconeFlutuante()", run: function () { return fn("iniciarIconeFlutuante")(); } },
+        pararIconeFlutuante: { title: "pararIconeFlutuante()", run: function () { return fn("pararIconeFlutuante")(); } },
+
+        tirarFoto: { title: "tirarFoto()", run: async function () { var result = await fn("tirarFoto")({ base64: true }); state.lastPhoto = result; return result; } },
+        capturarVideo: { title: "capturarVideo()", run: function () { return fn("capturarVideo")({ duracaoSegundos: 5 }); } },
+        escanearQRCode: { title: "escanearQRCode()", run: function () { return fn("escanearQRCode")(); } },
+        ouvirMic: { title: "ouvirMic()", run: async function () { state.micRecording = true; return fn("ouvirMic")(); } },
+        pararMic: { title: "pararMic()", run: async function () { state.micRecording = false; return fn("pararMic")(); } },
+
+        escolherImagem: { title: "escolherImagem()", run: async function () { var result = await fn("escolherImagem")(); state.lastImage = result; return result; } },
+        escolherImagens: { title: "escolherImagens()", run: function () { return fn("escolherImagens")({ multiplo: true }); } },
+        escolherArquivo: { title: "escolherArquivo()", run: function () { return fn("escolherArquivo")({ tipos: ["text/*", "application/json", "image/*"] }); } },
+        escolherArquivos: { title: "escolherArquivos()", run: function () { return fn("escolherArquivos")({ multiplo: true }); } },
+        escolherVideo: { title: "escolherVideo()", run: function () { return fn("escolherVideo")(); } },
+        escolherPasta: { title: "escolherPasta()", run: function () { return fn("escolherPasta")(); } },
+        salvarArquivoPicker: { title: "salvarArquivo({ nome })", run: function () { return fn("salvarArquivo")({ nome: "teste-html2apk.txt", mimeType: "text/plain", conteudo: "Arquivo salvo pelo teste html2apk" }); } },
+        salvarArquivoCrud: { title: "salvarArquivo('lab.json')", run: function () { return fn("salvarArquivo")("lab.json", { criadoEm: Date.now(), origem: "teste-funcoes" }); } },
+        lerArquivo: { title: "lerArquivo()", run: function () { return fn("lerArquivo")("lab.json"); } },
+        lerArquivoCompleto: { title: "lerArquivoCompleto()", run: function () { return fn("lerArquivoCompleto")("lab.json"); } },
+        listarArquivos: { title: "listarArquivos()", run: function () { return fn("listarArquivos")(); } },
+        infoArquivo: { title: "infoArquivo()", run: function () { return fn("infoArquivo")("lab.json"); } },
+        arquivoExiste: { title: "arquivoExiste()", run: function () { return fn("arquivoExiste")("lab.json"); } },
+        abrirArquivo: { title: "abrirArquivo()", run: function () { return fn("abrirArquivo")("lab.json"); } },
+        compartilharArquivo: { title: "compartilharArquivo()", run: function () { return fn("compartilharArquivo")("lab.json"); } },
+        baixarArquivo: { title: "baixarArquivo()", run: function () { return fn("baixarArquivo")("https://example.com/", "example.html"); } },
+        baixarBase64: { title: "baixarBase64()", run: function () { return fn("baixarBase64")("pixel-download.png", sampleImageBase64, { mimeType: "image/png" }); } },
+        baixarArquivoLocal: { title: "baixarArquivoLocal()", run: async function () { var file = await fn("escolherArquivo")(); if (!file) { return { canceled: true }; } return fn("baixarArquivoLocal")(file, "copia-" + (file.name || file.nome || "arquivo")); } },
+        excluirArquivo: { title: "excluirArquivo()", run: function () { return fn("excluirArquivo")("lab.json"); } },
+
+        abrirNoApp: { title: "abrirNoApp()", run: function () { return fn("abrirNoApp")("#teste-funcoes"); } },
+        abrirForaDoApp: { title: "abrirForaDoApp()", run: function () { return fn("abrirForaDoApp")("https://example.com"); } },
+        abrirUrl: { title: "abrirUrl()", run: function () { return fn("abrirUrl")("https://example.com"); } },
+        discar: { title: "discar()", run: function () { return fn("discar")("11999999999"); } },
+        abrirMapa: { title: "abrirMapa()", run: function () { return fn("abrirMapa")("Sao Paulo"); } },
+        abrirWhatsapp: { title: "abrirWhatsapp()", run: function () { return fn("abrirWhatsapp")("5511999999999", "Teste html2apk"); } },
+
+        infoDispositivo: { title: "infoDispositivo()", run: function () { return fn("infoDispositivo")(); } },
+        infoRede: { title: "infoRede()", run: function () { return fn("infoRede")(); } },
+        infoBateria: { title: "infoBateria()", run: function () { return fn("infoBateria")(); } },
+        infoMemoria: { title: "infoMemoria()", run: function () { return fn("infoMemoria")(); } },
+        infoArmazenamento: { title: "infoArmazenamento()", run: function () { return fn("infoArmazenamento")(); } },
+        infoDesempenho: { title: "infoDesempenho()", run: function () { return fn("infoDesempenho")(); } },
+        appsAbertos: { title: "appsAbertos()", run: function () { return fn("appsAbertos")(); } },
+
+        obterLocalizacao: { title: "obterLocalizacao()", run: function () { return fn("obterLocalizacao")({ altaPrecisao: true, timeoutMs: 10000 }); } },
+        acompanharLocalizacao: { title: "acompanharLocalizacao()", run: async function () { var result = await fn("acompanharLocalizacao")({ intervaloMs: 5000 }); state.watchId = result && result.watchId; return result; } },
+        pararLocalizacao: { title: "pararLocalizacao()", run: function () { return fn("pararLocalizacao")(state.watchId || ""); } },
+        aoMudarLocalizacao: { title: "aoMudarLocalizacao()", run: function () { if (state.stopLocationEvent) { state.stopLocationEvent(); } state.stopLocationEvent = fn("aoMudarLocalizacao")(function (event) { log("localizacao:mudou", event, "ok"); }); return { listening: true }; } },
+        autenticarBiometria: { title: "autenticarBiometria()", run: function () { return fn("autenticarBiometria")({ titulo: "Teste html2apk", descricao: "Confirme para testar a bridge" }); } },
+        salvarSeguro: { title: "salvarSeguro()", run: function () { return fn("salvarSeguro")("tokenTeste", { token: "abc123", criadoEm: Date.now() }); } },
+        lerSeguro: { title: "lerSeguro()", run: function () { return fn("lerSeguro")("tokenTeste"); } },
+        lerSeguroCompleto: { title: "lerSeguroCompleto()", run: function () { return fn("lerSeguroCompleto")("tokenTeste"); } },
+        listarSeguro: { title: "listarSeguro()", run: function () { return fn("listarSeguro")(); } },
+        removerSeguro: { title: "removerSeguro()", run: function () { return fn("removerSeguro")("tokenTeste"); } },
+        limparSeguro: { title: "limparSeguro()", run: function () { return fn("limparSeguro")(); } },
+
+        infoPapelParede: { title: "infoPapelParede()", run: function () { return fn("infoPapelParede")(); } },
+        definirPapelParede: { title: "definirPapelParede()", run: function () { return fn("definirPapelParede")({ base64: sampleImageBase64, mimeType: "image/png", alvo: "inicio" }); } },
+        abrirConfigPapel: { title: "abrirConfiguracaoPapelParede()", run: function () { return fn("abrirConfiguracaoPapelParede")(); } },
+        definirImagemEscolhida: { title: "imagem escolhida -> papel de parede", run: async function () { if (!state.lastImage) { state.lastImage = await fn("escolherImagem")(); } if (!state.lastImage || !state.lastImage.uri) { return { canceled: true }; } return fn("definirPapelParede")({ uri: state.lastImage.uri, alvo: "inicio", mimeType: state.lastImage.mimeType || "image/*" }); } },
+
+        registrarEventos: { title: "registrar eventos", run: function () { return registerEvents(); } },
+        obterNotificacaoInicial: { title: "obterNotificacaoInicial()", run: function () { return fn("obterNotificacaoInicial")(); } },
+        obterLinkInicial: { title: "obterLinkInicial()", run: function () { return fn("obterLinkInicial")(); } }
+      };
+
+      var groups = [
+        { title: "Feedback e compartilhamento", ids: ["toast", "vibrar", "copiarTexto", "lerTextoCopiado", "compartilharTexto", "compartilhar"] },
+        { title: "Notificacoes", ids: ["notificar", "agendarNotificacao", "cancelarNotificacao", "agendarLoopNotificacoes", "cancelarLoopNotificacoes", "pushInfo"] },
+        { title: "Permissoes e configuracoes", ids: ["statusPermissoes", "permissaoNotificacao", "permissaoCamera", "permissaoMicrofone", "alarmeExato", "abrirAlarmeExato", "statusSobreposicao", "abrirSobreposicao"] },
+        { title: "Tela e hardware", ids: ["fullscreenOn", "fullscreenOff", "telaAcordadaOn", "telaAcordadaOff", "brilhoTela", "corTema", "lanterna", "statusLanterna", "iniciarIconeFlutuante", "pararIconeFlutuante"] },
+        { title: "Camera, QR Code e microfone", ids: ["tirarFoto", "capturarVideo", "escanearQRCode", "ouvirMic", "pararMic"] },
+        { title: "Arquivos e midia", ids: ["escolherImagem", "escolherImagens", "escolherArquivo", "escolherArquivos", "escolherVideo", "escolherPasta", "salvarArquivoPicker", "salvarArquivoCrud", "lerArquivo", "lerArquivoCompleto", "listarArquivos", "infoArquivo", "arquivoExiste", "abrirArquivo", "compartilharArquivo", "baixarArquivo", "baixarBase64", "baixarArquivoLocal", "excluirArquivo"] },
+        { title: "Abrir apps externos", ids: ["abrirNoApp", "abrirForaDoApp", "abrirUrl", "discar", "abrirMapa", "abrirWhatsapp"] },
+        { title: "Diagnostico", ids: ["infoDispositivo", "infoRede", "infoBateria", "infoMemoria", "infoArmazenamento", "infoDesempenho", "appsAbertos"] },
+        { title: "Localizacao e seguranca", ids: ["obterLocalizacao", "acompanharLocalizacao", "pararLocalizacao", "aoMudarLocalizacao", "autenticarBiometria", "salvarSeguro", "lerSeguro", "lerSeguroCompleto", "listarSeguro", "removerSeguro", "limparSeguro"] },
+        { title: "Papel de parede", ids: ["infoPapelParede", "definirPapelParede", "abrirConfigPapel", "definirImagemEscolhida"] },
+        { title: "Eventos", ids: ["registrarEventos", "obterNotificacaoInicial", "obterLinkInicial"] }
+      ];
+
+      function render() {
+        var root = document.getElementById("groups");
+        root.innerHTML = groups.map(function (group) {
+          return "<section><h2>" + group.title + "</h2><div class='grid'>" + group.ids.map(function (id) {
+            var item = actions[id];
+            return "<button type='button' data-action='" + id + "'>" + item.title + "<small>Toque para executar</small></button>";
+          }).join("") + "</div></section>";
+        }).join("") + "<p class='notice'>Video wallpaper, push remoto e fundo de chamadas dependem de configuracao do sistema, OneSignal ou fabricante. O app mostra o retorno real quando a funcao nao puder agir direto.</p>";
+      }
+
+      document.addEventListener("click", function (event) {
+        var button = event.target.closest("[data-action]");
+        if (button) {
+          run(button.getAttribute("data-action"));
+        }
+      });
+
+      document.addEventListener("deviceready", function () {
+        log("deviceready", { ready: true }, "ok");
+      }, false);
+
+      render();
+    }());
+  </script>
+</body>
+</html>`;
+}
+
+async function createNativeFunctionLabProject() {
+  const projectRoot = await fs.mkdtemp(path.join(app.getPath("temp"), "html2apk-function-lab-"));
+  const config = {
+    appName: "html2apk Function Lab",
+    packageId: "dev.html2apk.functionlab",
+    version: "1.0.0",
+    buildFormat: "apk",
+    mode: "standalone",
+    orientation: "vertical",
+    minSdkVersion: 24,
+    themeMode: "fixed",
+    themeColor: "#126fff",
+    showRuntimeLogs: true,
+    permissions: [
+      "INTERNET",
+      "POST_NOTIFICATIONS",
+      "VIBRATE",
+      "CAMERA",
+      "RECORD_AUDIO",
+      "ACCESS_FINE_LOCATION",
+      "ACCESS_COARSE_LOCATION",
+      "SET_WALLPAPER"
+    ]
+  };
+
+  await fs.writeFile(path.join(projectRoot, "index.html"), nativeFunctionLabHtml(), "utf8");
+  await fs.writeFile(path.join(projectRoot, "app.json"), JSON.stringify(config, null, 2), "utf8");
+  return projectRoot;
+}
+
 function quoteForCmd(value) {
   const text = String(value);
   if (!text.length) {
@@ -837,6 +1170,49 @@ ipcMain.handle("build:run-usb-debug", async (event, options) => {
   }
 });
 
+ipcMain.handle("codes:run-function-lab", async (event) => {
+  const sendLog = (line, kind = "raw") => {
+    event.sender.send("build:log", {
+      line,
+      kind,
+      time: new Date().toISOString()
+    });
+  };
+  let projectRoot = null;
+
+  try {
+    sendLog("Creating html2apk interpreted functions test app.", "system");
+    projectRoot = await createNativeFunctionLabProject();
+    sendLog(`Function test project: ${projectRoot}`, "system");
+    sendLog("USB required: connect an Android phone with USB debugging authorized.", "system");
+    const result = await runDebugUsb({
+      projectRoot,
+      debug: false,
+      release: false,
+      showRuntimeLogs: true,
+      onLog: (line) => sendLog(line)
+    });
+    sendLog(`Function test app opened on device: ${result.device?.id || "Android device"}`, "success");
+    return {
+      ok: true,
+      result: {
+        ...result,
+        projectRoot,
+        distPath: path.join(projectRoot, "dist")
+      }
+    };
+  } catch (error) {
+    sendLog(error.message, "error");
+    return {
+      ok: false,
+      message: error.message,
+      logs: error.logs || [],
+      buildDir: error.buildDir || null,
+      projectRoot
+    };
+  }
+});
+
 ipcMain.handle("shell:open-path", async (_event, targetPath) => {
   if (!targetPath) {
     return false;

package/src/desktop/preload.js

@@ -18,6 +18,7 @@ contextBridge.exposeInMainWorld("html2apkDesktop", {
   installAndroidRequirements: () => ipcRenderer.invoke("install:android-requirements"),
   runBuild: (options) => ipcRenderer.invoke("build:run", options),
   runUsbDebugBuild: (options) => ipcRenderer.invoke("build:run-usb-debug", options),
+  runNativeFunctionLab: () => ipcRenderer.invoke("codes:run-function-lab"),
   openPath: (targetPath) => ipcRenderer.invoke("shell:open-path", targetPath),
   showItem: (targetPath) => ipcRenderer.invoke("shell:show-item", targetPath),
   openExternalUrl: (targetUrl) => ipcRenderer.invoke("shell:open-external", targetUrl),

package/src/desktop/renderer/index.html

@@ -322,10 +322,9 @@
               <strong id="currentFileName" data-i18n="noFileSelected">Nenhum arquivo selecionado</strong>
               <span id="fileLanguageBadge">text</span>
             </div>
-            <textarea id="fileEditorInput" spellcheck="false" disabled placeholder="index.html"></textarea>
-            <div class="syntax-preview-wrap">
-              <strong data-i18n="syntaxPreview">Previa com sintaxe</strong>
-              <pre id="fileHighlight" class="syntax-preview"><code></code></pre>
+            <div class="code-editor-shell">
+              <pre id="fileHighlight" class="file-editor-highlight" aria-hidden="true"><code></code></pre>
+              <textarea id="fileEditorInput" spellcheck="false" disabled placeholder="index.html"></textarea>
             </div>
           </section>
         </div>
@@ -404,9 +403,16 @@
             <p class="eyebrow" data-i18n="codesEyebrow">Bridge nativa</p>
             <h1 data-i18n="codesTitle">Codigos interpretados</h1>
           </div>
+          <button id="nativeFunctionLabButton" class="primary-action" type="button" data-i18n="testNativeFunctions">Testar funcoes</button>
         </header>
         <p class="view-intro" data-i18n="codesIntro">Estas funcoes chamadas no JavaScript do app sao interpretadas pelo plugin Cordova e executadas no Java Android.</p>
-        <div id="nativeCodeGrid" class="code-grid"></div>
+        <div class="code-browser">
+          <nav id="nativeCodeCategories" class="code-categories" aria-label="Categorias de codigos"></nav>
+          <section class="code-results">
+            <div id="nativeCodeSummary" class="code-summary"></div>
+            <div id="nativeCodeGrid" class="code-grid"></div>
+          </section>
+        </div>
       </section>
 
       <section id="view-help" class="view">