pake-cli 3.15.1 → 3.15.3

package/README.md

@@ -194,6 +194,12 @@ First-time packaging requires environment setup and may be slower, subsequent bu
 
 Using Pake from a script or AI agent? Pass `--json` for machine-readable results, describe apps declaratively with `--config app.json` ([schema](schema/pake.schema.json)), and package local build output directly with `pake ./dist --name MyTool`. See [llms.txt](llms.txt) for the full agent contract. Claude Code users can install the official skill with `/plugin marketplace add tw93/Pake` and `/plugin install pake@pake`.
 
+Copy this to your AI agent to get started:
+
+```text
+Use Pake (npm i -g pake-cli) to package webpages as desktop apps. Read https://unpkg.com/pake-cli@latest/llms.txt first; always run pake with --json and parse stdout as a single JSON object. Package <url-or-local-dist> into an app named <AppName>.
+```
+
 ## Development
 
 Requires Rust `>=1.85` and Node `>=22` (recommended LTS; `>=18` also works). For detailed installation guide, see [Tauri documentation](https://v2.tauri.app/start/prerequisites/). If unfamiliar with development environment, use the CLI tool instead.

package/dist/cli.js

@@ -20,7 +20,7 @@ import * as psl from 'psl';
 import { InvalidArgumentError, program as program$1, Option } from 'commander';
 
 var name = "pake-cli";
-var version = "3.15.1";
+var version = "3.15.3";
 var description = "🤱🏻 Turn any webpage into a desktop app with one command. 🤱🏻 一键打包网页生成轻量桌面应用。";
 var engines = {
 	node: ">=18.0.0"
@@ -47,7 +47,8 @@ var keywords = [
 ];
 var files = [
 	"LICENSE-EXCEPTION",
-	"dist",
+	"llms.txt",
+	"dist/cli.js",
 	"src-tauri"
 ];
 var scripts = {

package/llms.txt

@@ -0,0 +1,31 @@
+# Pake
+
+> Pake turns any webpage or local web build into a lightweight desktop app (~5MB) for macOS, Windows, and Linux, using Tauri (Rust) and the system webview. One CLI command packages a URL, a local HTML file, or a static directory into a native installer.
+
+## Install and run
+
+- Install: `npm install -g pake-cli` (requires Node 18+ and Rust; the CLI offers to install Rust when missing)
+- Basic: `pake https://example.com --name MyApp`
+- Local build output: `pake ./dist --name MyTool` (directory must contain index.html at its root; hash routing only, history-mode SPA routing unsupported)
+
+## Agent contract
+
+- Always pass `--json` in automation: stdout carries exactly one JSON object `{ok, name, platform, arch, outputs: [{path, sizeBytes, format}], warnings, error: {code, message, hint} | null}`; all logs go to stderr; interactive prompts are disabled.
+- Exit codes: 0 success, 2 invalid input, 3 build failure, 4 missing environment or dependency setup failure, 1 unexpected.
+- On Linux multi-target builds, ok:true can carry fewer outputs than requested formats; failed targets land in warnings. Check outputs[].format.
+- Error codes: INVALID_INPUT, ENV_MISSING, BUILD_FAILED, UNEXPECTED, plus NETWORK (reserved; current versions report network failures under the phase code, e.g. ENV_MISSING or BUILD_FAILED). `error.hint` states how to fix.
+- Declarative config: `pake --config app.json --json`; fields are camelCase CLI option names plus `url`. Explicit CLI flags win over config fields. Unknown fields fail fast. A relative `url` path resolves against the process working directory, not the config file's directory.
+- Config schema: https://raw.githubusercontent.com/tw93/Pake/main/schema/pake.schema.json
+
+## Docs
+
+- [CLI usage, all options](https://github.com/tw93/Pake/blob/main/docs/cli-usage.md): every flag with defaults and examples
+- [Advanced usage](https://github.com/tw93/Pake/blob/main/docs/advanced-usage.md): style injection, containers, customization
+- [FAQ](https://github.com/tw93/Pake/blob/main/docs/faq.md): platform-specific troubleshooting
+
+## Notes
+
+- Output formats: dmg/app (macOS), msi (Windows), deb/AppImage/rpm/zst (Linux); pick with `--targets`.
+- Icons auto-fetch from the site favicon when `--icon` is omitted.
+- `--proxy-url` is baked into the app webview at build time; it does not proxy the icon download itself.
+- Google OAuth and similar providers may reject embedded webviews regardless of flags; `--new-window` and `--safe-domain` help with most SSO flows.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pake-cli",
-  "version": "3.15.1",
+  "version": "3.15.3",
   "description": "🤱🏻 Turn any webpage into a desktop app with one command. 🤱🏻 一键打包网页生成轻量桌面应用。",
   "engines": {
     "node": ">=18.0.0"
@@ -27,7 +27,8 @@
   ],
   "files": [
     "LICENSE-EXCEPTION",
-    "dist",
+    "llms.txt",
+    "dist/cli.js",
     "src-tauri"
   ],
   "scripts": {

package/src-tauri/Cargo.lock

@@ -2564,7 +2564,7 @@ dependencies = [
 
 [[package]]
 name = "pake"
-version = "3.15.1"
+version = "3.15.3"
 dependencies = [
  "objc2",
  "objc2-app-kit",
@@ -2582,6 +2582,7 @@ dependencies = [
  "tauri-plugin-single-instance",
  "tauri-plugin-window-state",
  "tokio",
+ "windows-sys 0.61.2",
 ]
 
 [[package]]

package/src-tauri/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "pake"
-version = "3.15.1"
+version = "3.15.3"
 description = "🤱🏻 Turn any webpage into a desktop app with Rust."
 authors = ["Tw93"]
 license = "GPL-3.0-or-later"
@@ -41,6 +41,13 @@ objc2 = "0.6"
 objc2-app-kit = { version = "0.3", features = ["NSApplication", "NSDockTile"] }
 objc2-foundation = { version = "0.3", features = ["NSString"] }
 
+[target.'cfg(windows)'.dependencies]
+windows-sys = { version = "0.61.2", features = [
+  "Win32_Foundation",
+  "Win32_UI_Shell",
+  "Win32_UI_WindowsAndMessaging",
+] }
+
 [features]
 # this feature is used for development builds from development cli
 cli-build = []

package/src-tauri/src/app/setup.rs

@@ -1,4 +1,4 @@
-use crate::app::window::open_additional_window_safe;
+use crate::app::window::{open_additional_window_safe, reapply_window_icon};
 use std::str::FromStr;
 use std::sync::{Arc, Mutex};
 use std::time::{Duration, Instant};
@@ -56,6 +56,7 @@ pub fn set_system_tray(
             "show_app" => {
                 if let Some(window) = app.get_webview_window("pake") {
                     let _ = window.show();
+                    reapply_window_icon(&window);
                     #[cfg(target_os = "linux")]
                     if _init_fullscreen && !window.is_fullscreen().unwrap_or(false) {
                         let _ = window.set_fullscreen(true);
@@ -83,6 +84,7 @@ pub fn set_system_tray(
                             let _ = window.hide();
                         } else {
                             let _ = window.show();
+                            reapply_window_icon(&window);
                             let _ = window.set_focus();
                             #[cfg(target_os = "linux")]
                             if _init_fullscreen && !window.is_fullscreen().unwrap_or(false) {
@@ -153,6 +155,7 @@ pub fn set_global_shortcut(
                                 let _ = window.hide();
                             } else {
                                 let _ = window.show();
+                                reapply_window_icon(&window);
                                 let _ = window.set_focus();
                                 #[cfg(target_os = "linux")]
                                 if _init_fullscreen && !window.is_fullscreen().unwrap_or(false) {

package/src-tauri/src/app/window.rs

@@ -3,6 +3,8 @@ use crate::util::{
     check_file_or_append, get_data_dir, get_download_message_with_lang, sanitize_download_filename,
     show_toast, MessageType,
 };
+#[cfg(target_os = "windows")]
+use std::{os::windows::ffi::OsStrExt, ptr, sync::OnceLock};
 use std::{
     path::PathBuf,
     str::FromStr,
@@ -13,6 +15,12 @@ use tauri::{
     AppHandle, Config, Manager, Url, WebviewUrl, WebviewWindow, WebviewWindowBuilder,
 };
 
+#[cfg(target_os = "windows")]
+use windows_sys::Win32::UI::{
+    Shell::ExtractIconExW,
+    WindowsAndMessaging::{SendMessageW, ICON_BIG, WM_SETICON},
+};
+
 use tauri::Theme;
 
 #[cfg(target_os = "macos")]
@@ -69,6 +77,77 @@ pub fn open_additional_window(app: &AppHandle) -> tauri::Result<WebviewWindow> {
     build_window_with_label(app, &state.pake_config, &state.tauri_config, &label)
 }
 
+#[cfg(target_os = "windows")]
+fn taskbar_icon_handle() -> Option<isize> {
+    static TASKBAR_ICON: OnceLock<Option<isize>> = OnceLock::new();
+
+    *TASKBAR_ICON.get_or_init(|| {
+        let executable = match std::env::current_exe() {
+            Ok(path) => path,
+            Err(error) => {
+                eprintln!(
+                    "[Pake] Failed to resolve the app executable for its taskbar icon: {error}"
+                );
+                return None;
+            }
+        };
+        let executable_wide: Vec<u16> = executable
+            .as_os_str()
+            .encode_wide()
+            .chain(std::iter::once(0))
+            .collect();
+        let mut large_icon = ptr::null_mut();
+        let extracted = unsafe {
+            ExtractIconExW(
+                executable_wide.as_ptr(),
+                0,
+                &mut large_icon,
+                ptr::null_mut(),
+                1,
+            )
+        };
+        if extracted == 0 || large_icon.is_null() {
+            eprintln!(
+                "[Pake] Failed to extract the taskbar icon from {}.",
+                executable.display()
+            );
+            return None;
+        }
+
+        // WM_SETICON keeps this handle rather than copying it. Cache the single
+        // extracted icon for the process lifetime so repeated tray restores do
+        // not leak a new HICON or leave the window with a dangling handle.
+        Some(large_icon as isize)
+    })
+}
+
+// Apps autostarted at Windows logon can register their icons before Explorer's
+// icon cache is ready (#1323). Re-assert both the small/title-bar icon and the
+// large taskbar icon whenever a window becomes visible.
+#[cfg(target_os = "windows")]
+pub fn reapply_window_icon(window: &WebviewWindow) {
+    if let Some(icon) = window.app_handle().default_window_icon().cloned() {
+        if let Err(error) = window.set_icon(icon) {
+            eprintln!("[Pake] Failed to re-apply the window icon: {error}");
+        }
+    }
+
+    let Some(taskbar_icon) = taskbar_icon_handle() else {
+        return;
+    };
+    match window.hwnd() {
+        Ok(hwnd) => unsafe {
+            SendMessageW(hwnd.0, WM_SETICON, ICON_BIG as usize, taskbar_icon);
+        },
+        Err(error) => {
+            eprintln!("[Pake] Failed to resolve the window handle for its taskbar icon: {error}");
+        }
+    }
+}
+
+#[cfg(not(target_os = "windows"))]
+pub fn reapply_window_icon(_window: &WebviewWindow) {}
+
 struct WindowBuildOptions<'a> {
     label: &'a str,
     url: WebviewUrl,
@@ -99,6 +178,7 @@ fn open_requested_window(
 
     let title = target_url.host_str().unwrap_or(target_url.as_str());
     let _ = window.set_title(title);
+    reapply_window_icon(&window);
     let _ = window.set_focus();
 
     Ok(window)
@@ -111,6 +191,7 @@ pub fn open_additional_window_safe(app: &AppHandle) {
         std::thread::spawn(move || {
             if let Ok(window) = open_additional_window(&app_handle) {
                 let _ = window.show();
+                reapply_window_icon(&window);
                 let _ = window.set_focus();
             }
         });
@@ -120,6 +201,7 @@ pub fn open_additional_window_safe(app: &AppHandle) {
     {
         if let Ok(window) = open_additional_window(app) {
             let _ = window.show();
+            reapply_window_icon(&window);
             let _ = window.set_focus();
         }
     }

package/src-tauri/src/lib.rs

@@ -25,7 +25,7 @@ use app::{
         set_dock_badge_label, set_zoom, update_theme_mode,
     },
     setup::{set_global_shortcut, set_system_tray},
-    window::{open_additional_window_safe, set_window, MultiWindowState},
+    window::{open_additional_window_safe, reapply_window_icon, set_window, MultiWindowState},
 };
 use util::get_pake_config;
 
@@ -179,6 +179,7 @@ pub fn run_app() {
                 } else if let Some(window) = app.get_webview_window("pake") {
                     let _ = window.unminimize();
                     let _ = window.show();
+                    reapply_window_icon(&window);
                     let _ = window.set_focus();
                 }
             },
@@ -231,6 +232,7 @@ pub fn run_app() {
                 tauri::async_runtime::spawn(async move {
                     tokio::time::sleep(tokio::time::Duration::from_millis(WINDOW_SHOW_DELAY)).await;
                     let _ = window_clone.show();
+                    reapply_window_icon(&window_clone);
 
                     // Fixed: Linux fullscreen issue with virtual keyboard
                     #[cfg(target_os = "linux")]
@@ -300,6 +302,7 @@ pub fn run_app() {
                 if !has_visible_windows {
                     if let Some(window) = _app.get_webview_window("pake") {
                         let _ = window.show();
+                        reapply_window_icon(&window);
                         let _ = window.set_focus();
                     }
                 }

package/src-tauri/src/util.rs

@@ -183,16 +183,21 @@ mod tests {
     use std::env;
     use std::fs;
     use std::path::PathBuf;
+    use std::sync::atomic::{AtomicU64, Ordering};
+
+    static TEMP_PATH_COUNTER: AtomicU64 = AtomicU64::new(0);
 
     fn temp_path(name: &str) -> PathBuf {
         let mut dir = env::temp_dir();
+        let unique = TEMP_PATH_COUNTER.fetch_add(1, Ordering::Relaxed);
         dir.push(format!(
-            "pake-util-test-{}-{}",
+            "pake-util-test-{}-{}-{}",
             std::process::id(),
             std::time::SystemTime::now()
                 .duration_since(std::time::UNIX_EPOCH)
                 .map(|d| d.as_nanos())
-                .unwrap_or(0)
+                .unwrap_or(0),
+            unique
         ));
         fs::create_dir_all(&dir).unwrap();
         dir.push(name);

package/src-tauri/tauri.conf.json

@@ -1,7 +1,7 @@
 {
   "productName": "Weekly",
   "identifier": "com.pake.weekly",
-  "version": "3.15.1",
+  "version": "3.15.3",
   "app": {
     "withGlobalTauri": true,
     "trayIcon": {