@zappdev/cli 0.1.1 → 0.3.0

package/README.md

@@ -1,15 +1,15 @@
-# @zapp/cli
+# @zappdev/cli
 
 CLI for building cross-platform desktop apps with Zapp.
 
 ## Install
 
 ```sh
-bun add -D @zapp/cli
+bun add -g @zappdev/cli
 ```
 
 ```sh
-npm install -D @zapp/cli
+npm install -g @zappdev/cli
 ```
 
 ## Quick Start
@@ -18,37 +18,40 @@ npm install -D @zapp/cli
 # Create a new Zapp project
 zapp init my-app
 cd my-app
+bun install
 
 # Start the dev server with hot reload
 zapp dev
 
 # Build for production
-zapp build
+zapp build --brotli
 
-# Package into a distributable
-zapp package
+# Package into a .app bundle (macOS)
+zapp package --brotli
 ```
 
 ## Commands
 
-| Command    | Description                                      |
-| ---------- | ------------------------------------------------ |
-| `init`     | Scaffold a new Zapp project                      |
-| `dev`      | Start the development server with live reload     |
-| `build`    | Compile the native backend and bundle the frontend |
-| `package`  | Package the app into a distributable binary       |
-| `generate` | Generate bindings and boilerplate code            |
+| Command    | Description                                       |
+| ---------- | ------------------------------------------------- |
+| `init`     | Scaffold a new Zapp project (any Vite template)   |
+| `dev`      | Start dev mode with Vite hot reload + native app  |
+| `build`    | Build frontend assets + compile native binary     |
+| `package`  | Build and package into a platform bundle (.app)   |
+| `generate` | Generate TypeScript bindings from Zen-C services  |
 
-## Options
+## Common Options
 
-All build-related commands support:
+- `--root` — project root directory
+- `--frontend` — frontend directory
+- `--input` — build file path (default: `zapp/build.zc`)
+- `--out` — override output binary path
+- `--log-level` — log verbosity (`error`, `warn`, `info`, `debug`, `trace`)
 
-- `--root` -- project root directory
-- `--frontend` -- frontend directory
-- `--input` -- build file path (default: `zapp/build.zc`)
-- `--out` -- override output binary path
-- `--backend` -- backend script path
-- `--log-level` -- log verbosity (`error`, `warn`, `info`, `debug`, `trace`)
+## Prerequisites
+
+- [Zen-C compiler](https://github.com/zenc-lang/zenc) (`zc`) in your PATH
+- [Bun](https://bun.sh) runtime
 
 ## License
 

package/dist/zapp-cli.js

@@ -8235,7 +8235,8 @@ var generateBuildConfigZc = async ({
   backendScriptPath,
   logLevel,
   csp,
-  enableDevTools
+  enableDevTools,
+  allowNavigation
 }) => {
   const buildDir = path2.join(root, ".zapp");
   await mkdir2(buildDir, { recursive: true });
@@ -8284,6 +8285,10 @@ raw {
     const char* zapp_build_csp(void) {
         return ${csp ? cString(csp) : '""'};
     }
+
+    const char* zapp_build_allowed_navigation(void) {
+        return ${allowNavigation && allowNavigation.length > 0 ? cString(JSON.stringify(allowNavigation)) : '""'};
+    }
 }
 `;
   const outPath = path2.join(buildDir, "zapp_build_config.zc");
@@ -8714,7 +8719,8 @@ var runBuild = async ({
     backendScriptPath,
     logLevel: effectiveLogLevel,
     csp: config.security?.csp,
-    enableDevTools: isDebug ? true : undefined
+    enableDevTools: isDebug ? true : undefined,
+    allowNavigation: config.security?.allowNavigation
   });
   process5.stdout.write(`[zapp] building native binary
 `);
@@ -9203,6 +9209,20 @@ async function packageMacOS({ root, nativeOut, config }) {
   let plistContent = "";
   if (existsSync5(configPlistPath)) {
     plistContent = await Bun.file(configPlistPath).text();
+    if (config.deepLink?.scheme && !plistContent.includes("CFBundleURLTypes")) {
+      plistContent = plistContent.replace("</dict>", `    <key>CFBundleURLTypes</key>
+    <array>
+        <dict>
+            <key>CFBundleURLName</key>
+            <string>${config.identifier}</string>
+            <key>CFBundleURLSchemes</key>
+            <array>
+                <string>${config.deepLink.scheme}</string>
+            </array>
+        </dict>
+    </array>
+</dict>`);
+    }
     if (hasIcon && !plistContent.includes("CFBundleIconFile")) {
       plistContent = plistContent.replace("</dict>", `    <key>CFBundleIconFile</key>
     <string>AppIcon</string>
@@ -9232,6 +9252,20 @@ async function packageMacOS({ root, nativeOut, config }) {
     if (copyright) {
       extraKeys += `    <key>NSHumanReadableCopyright</key>
     <string>${copyright}</string>
+`;
+    }
+    if (config.deepLink?.scheme) {
+      extraKeys += `    <key>CFBundleURLTypes</key>
+    <array>
+        <dict>
+            <key>CFBundleURLName</key>
+            <string>${config.identifier}</string>
+            <key>CFBundleURLSchemes</key>
+            <array>
+                <string>${config.deepLink.scheme}</string>
+            </array>
+        </dict>
+    </array>
 `;
     }
     plistContent = `<?xml version="1.0" encoding="UTF-8"?>
@@ -9285,7 +9319,8 @@ function applyDefaults(config) {
     description: config.description,
     author: config.author,
     macos: config.macos,
-    security: config.security
+    security: config.security,
+    deepLink: config.deepLink
   };
 }
 async function loadConfig(root) {

package/native/src/app/app.zc

@@ -10,7 +10,7 @@ include <string.h>
 struct AppConfig {
     name: string;
     applicationShouldTerminateAfterLastWindowClosed: bool;
-    webContentInspectable: bool;
+    webContentInspectable: int; // -1 = inherit from build (dev=true, prod=false), 0 = false, 1 = true
     maxWorkers: int;
     qjsStackSize: int; // QuickJS stack size in bytes (0 = default 4MB)
 }
@@ -18,7 +18,7 @@ struct AppConfig {
 opaque struct _AppConfig {
     name: string;
     applicationShouldTerminateAfterLastWindowClosed: bool;
-    webContentInspectable: bool;
+    webContentInspectable: int;
     maxWorkers: int;
     qjsStackSize: int;
 }
@@ -35,7 +35,7 @@ impl App {
     fn new(config: AppConfig) -> Self {
         app_set_bootstrap_config(config);
         let windowManager = WindowManager::new();
-        windowManager.webContentInspectable = config.webContentInspectable;
+        windowManager.webContentInspectable = app_get_bootstrap_web_content_inspectable();
         return App{
             config: _AppConfig{
                 name: config.name,
@@ -134,7 +134,7 @@ fn app_get_bootstrap_config() -> AppConfig {
     return AppConfig{
         name: "Zapp App",
         applicationShouldTerminateAfterLastWindowClosed: false,
-        webContentInspectable: true,
+        webContentInspectable: -1, // inherit from build default
         maxWorkers: 0,
         qjsStackSize: 0,
     };
@@ -149,7 +149,17 @@ fn app_get_bootstrap_application_should_terminate_after_last_window_closed() ->
 }
 
 fn app_get_bootstrap_web_content_inspectable() -> bool {
-    return app_get_bootstrap_config().webContentInspectable;
+    let user_val = app_get_bootstrap_config().webContentInspectable;
+    // -1 = inherit from build default (dev=true, prod=false)
+    //  0 = explicitly false
+    //  1 = explicitly true (user override)
+    if user_val >= 0 {
+        return user_val > 0;
+    }
+    raw {
+        extern int zapp_build_dev_tools_default(void);
+        return zapp_build_dev_tools_default() ? true : false;
+    }
 }
 
 fn app_get_bootstrap_max_workers() -> int {
@@ -288,8 +298,9 @@ fn app_apply_configure(app: App*, payload: string) -> void {
     }
     let insp_opt = json.get_bool("webContentInspectable");
     if insp_opt.is_some() {
-        app.config.webContentInspectable = insp_opt.unwrap();
-        app.window.webContentInspectable = app.config.webContentInspectable;
+        let insp_val = insp_opt.unwrap();
+        app.config.webContentInspectable = if insp_val { 1 } else { 0 };
+        app.window.webContentInspectable = insp_val;
     }
     let max_opt = json.get_int("maxWorkers");
     if max_opt.is_some() {
@@ -314,6 +325,8 @@ fn app_handle_app_action(app: App*, action: string) -> void;
 fn app_open_external(app: App*, payload: string) -> void;
 @cfg(apple)
 fn app_handle_dialog(app: App*, action: string, payload: string) -> void;
+@cfg(apple)
+fn app_set_menu(app: App*, payload: string) -> void;
 
 @cfg(windows)
 fn zapp_dispatch_invoke_result(request_id: string, payload_json: string) -> void;
@@ -330,6 +343,8 @@ fn app_open_external(app: App*, payload: string) -> void;
 fn app_handle_dialog(app: App*, action: string, payload: string) -> void;
 @cfg(windows)
 fn app_handle_app_action(app: App*, action: string) -> void;
+@cfg(windows)
+fn app_set_menu(app: App*, payload: string) -> void;
 
 @cfg(ZAPP_LINUX)
 fn zapp_dispatch_invoke_result(request_id: string, payload_json: string) -> void {
@@ -355,6 +370,10 @@ fn app_open_external(app: App*, payload: string) -> void {
 fn app_handle_dialog(app: App*, action: string, payload: string) -> void {
     raw { (void)app; (void)action; (void)payload; }
 }
+@cfg(ZAPP_LINUX)
+fn app_set_menu(app: App*, payload: string) -> void {
+    raw { (void)app; (void)payload; }
+}
 
 fn app_invoke_rpc(app: App*, method: string, request_payload: string) -> void {
     if method == "" || request_payload == "" {
@@ -471,6 +490,10 @@ fn app_handle_frontend_message(app: App*, msg: string) -> void {
             app_open_external(app, payload);
             return;
         }
+        if key == "setMenu" {
+            app_set_menu(app, payload);
+            return;
+        }
         app_handle_app_action(app, key);
         return;
     }

package/native/src/cli/node_modules/@esbuild/darwin-arm64/README.md

@@ -0,0 +1,3 @@
+# esbuild
+
+This is the macOS ARM 64-bit binary for esbuild, a JavaScript bundler and minifier. See https://github.com/evanw/esbuild for details.

package/native/src/cli/node_modules/@esbuild/darwin-arm64/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@esbuild/darwin-arm64",
+  "version": "0.27.4",
+  "description": "The macOS ARM 64-bit binary for esbuild, a JavaScript bundler.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/evanw/esbuild.git"
+  },
+  "license": "MIT",
+  "preferUnplugged": true,
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64"
+  ]
+}

package/native/src/cli/node_modules/@types/bun/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/native/src/cli/node_modules/@types/bun/README.md

@@ -0,0 +1,20 @@
+# Installation
+> `npm install --save @types/bun`
+
+# Summary
+This package contains type definitions for bun (https://bun.com).
+
+# Details
+Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/bun.
+## [index.d.ts](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/bun/index.d.ts)
+````ts
+/// <reference types="bun-types" />
+
+````
+
+### Additional Details
+ * Last updated: Mon, 02 Mar 2026 23:04:36 GMT
+ * Dependencies: [bun-types](https://npmjs.com/package/bun-types)
+
+# Credits
+These definitions were written by [Jarred Sumner](https://github.com/Jarred-Sumner), [Robobun](https://github.com/robobun), [Dylan Conway](https://github.com/dylan-conway), [Ciro Spaciari](https://github.com/cirospaciari), [Sosuke Suzuki](https://github.com/sosukesuzuki), and [Alistair Smith](https://github.com/alii).

package/native/src/cli/node_modules/@types/bun/index.d.ts

@@ -0,0 +1 @@
+/// <reference types="bun-types" />

package/native/src/cli/node_modules/@types/bun/package.json

@@ -0,0 +1,53 @@
+{
+    "name": "@types/bun",
+    "version": "1.3.10",
+    "description": "TypeScript definitions for bun",
+    "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/bun",
+    "license": "MIT",
+    "contributors": [
+        {
+            "name": "Jarred Sumner",
+            "githubUsername": "Jarred-Sumner",
+            "url": "https://github.com/Jarred-Sumner"
+        },
+        {
+            "name": "Robobun",
+            "githubUsername": "robobun",
+            "url": "https://github.com/robobun"
+        },
+        {
+            "name": "Dylan Conway",
+            "githubUsername": "dylan-conway",
+            "url": "https://github.com/dylan-conway"
+        },
+        {
+            "name": "Ciro Spaciari",
+            "githubUsername": "cirospaciari",
+            "url": "https://github.com/cirospaciari"
+        },
+        {
+            "name": "Sosuke Suzuki",
+            "githubUsername": "sosukesuzuki",
+            "url": "https://github.com/sosukesuzuki"
+        },
+        {
+            "name": "Alistair Smith",
+            "githubUsername": "alii",
+            "url": "https://github.com/alii"
+        }
+    ],
+    "main": "",
+    "types": "index.d.ts",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/DefinitelyTyped/DefinitelyTyped.git",
+        "directory": "types/bun"
+    },
+    "scripts": {},
+    "dependencies": {
+        "bun-types": "1.3.10"
+    },
+    "peerDependencies": {},
+    "typesPublisherContentHash": "c93450e885b7484ba2b76848e30088d153ff99cf09b4ea543038aac6016408b2",
+    "typeScriptVersion": "5.2"
+}

package/native/src/cli/node_modules/@types/node/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/native/src/cli/node_modules/@types/node/README.md

@@ -0,0 +1,15 @@
+# Installation
+> `npm install --save @types/node`
+
+# Summary
+This package contains type definitions for node (https://nodejs.org/).
+
+# Details
+Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node/v22.
+
+### Additional Details
+ * Last updated: Fri, 06 Mar 2026 00:57:44 GMT
+ * Dependencies: [undici-types](https://npmjs.com/package/undici-types)
+
+# Credits
+These definitions were written by [Microsoft TypeScript](https://github.com/Microsoft), [Alberto Schiabel](https://github.com/jkomyno), [Andrew Makarov](https://github.com/r3nya), [Benjamin Toueg](https://github.com/btoueg), [David Junger](https://github.com/touffy), [Mohsen Azimi](https://github.com/mohsen1), [Nikita Galkin](https://github.com/galkin), [Sebastian Silbermann](https://github.com/eps1lon), [Wilco Bakker](https://github.com/WilcoBakker), [Marcin Kopacz](https://github.com/chyzwar), [Trivikram Kamat](https://github.com/trivikr), [Junxiao Shi](https://github.com/yoursunny), [Ilia Baryshnikov](https://github.com/qwelias), [ExE Boss](https://github.com/ExE-Boss), [Piotr Błażejewicz](https://github.com/peterblazejewicz), [Anna Henningsen](https://github.com/addaleax), [Victor Perin](https://github.com/victorperin), [NodeJS Contributors](https://github.com/NodeJS), [Linus Unnebäck](https://github.com/LinusU), [wafuwafu13](https://github.com/wafuwafu13), [Matteo Collina](https://github.com/mcollina), [Dmitry Semigradsky](https://github.com/Semigradsky), and [René](https://github.com/Renegade334).

package/native/src/cli/node_modules/@types/node/assert/strict.d.ts

@@ -0,0 +1,111 @@
+/**
+ * In strict assertion mode, non-strict methods behave like their corresponding
+ * strict methods. For example, `assert.deepEqual()` will behave like
+ * `assert.deepStrictEqual()`.
+ *
+ * In strict assertion mode, error messages for objects display a diff. In legacy
+ * assertion mode, error messages for objects display the objects, often truncated.
+ *
+ * To use strict assertion mode:
+ *
+ * ```js
+ * import { strict as assert } from 'node:assert';
+ * ```
+ *
+ * ```js
+ * import assert from 'node:assert/strict';
+ * ```
+ *
+ * Example error diff:
+ *
+ * ```js
+ * import { strict as assert } from 'node:assert';
+ *
+ * assert.deepEqual([[[1, 2, 3]], 4, 5], [[[1, 2, '3']], 4, 5]);
+ * // AssertionError: Expected inputs to be strictly deep-equal:
+ * // + actual - expected ... Lines skipped
+ * //
+ * //   [
+ * //     [
+ * // ...
+ * //       2,
+ * // +     3
+ * // -     '3'
+ * //     ],
+ * // ...
+ * //     5
+ * //   ]
+ * ```
+ *
+ * To deactivate the colors, use the `NO_COLOR` or `NODE_DISABLE_COLORS`
+ * environment variables. This will also deactivate the colors in the REPL. For
+ * more on color support in terminal environments, read the tty
+ * [`getColorDepth()`](https://nodejs.org/docs/latest-v22.x/api/tty.html#writestreamgetcolordepthenv) documentation.
+ * @since v15.0.0
+ * @see [source](https://github.com/nodejs/node/blob/v22.x/lib/assert/strict.js)
+ */
+declare module "assert/strict" {
+    import {
+        Assert,
+        AssertionError,
+        AssertionErrorOptions,
+        AssertOptions,
+        AssertPredicate,
+        AssertStrict,
+        CallTracker,
+        CallTrackerCall,
+        CallTrackerReportInformation,
+        deepStrictEqual,
+        doesNotMatch,
+        doesNotReject,
+        doesNotThrow,
+        fail,
+        ifError,
+        match,
+        notDeepStrictEqual,
+        notStrictEqual,
+        ok,
+        partialDeepStrictEqual,
+        rejects,
+        strictEqual,
+        throws,
+    } from "node:assert";
+    function strict(value: unknown, message?: string | Error): asserts value;
+    namespace strict {
+        export {
+            Assert,
+            AssertionError,
+            AssertionErrorOptions,
+            AssertOptions,
+            AssertPredicate,
+            AssertStrict,
+            CallTracker,
+            CallTrackerCall,
+            CallTrackerReportInformation,
+            deepStrictEqual,
+            deepStrictEqual as deepEqual,
+            doesNotMatch,
+            doesNotReject,
+            doesNotThrow,
+            fail,
+            ifError,
+            match,
+            notDeepStrictEqual,
+            notDeepStrictEqual as notDeepEqual,
+            notStrictEqual,
+            notStrictEqual as notEqual,
+            ok,
+            partialDeepStrictEqual,
+            rejects,
+            strict,
+            strictEqual,
+            strictEqual as equal,
+            throws,
+        };
+    }
+    export = strict;
+}
+declare module "node:assert/strict" {
+    import strict = require("assert/strict");
+    export = strict;
+}