ezi 0.0.2 → 2.0.0

package/README.md

@@ -1,48 +1,51 @@
-<div align="center">
-  <h1>ezi</h1>
-  <p>A smooth, minimal framework for infusing JavaScript with dynamic behavior.</p>
-</div>
-
-## Hi there 👋
-
-### Welcome to the sleek and minimal framework that brings dynamic behavior to JavaScript! ✨
-
----
-
-# Features
-
-- Smooth Integration: Easy-to-use framework for adding dynamic functionality to
-  your JavaScript projects.
-- Minimalistic Design: Focus on what matters with a clean and simple setup.
-- Dynamic State Management: Manage and update your state with ease.
-- Explore more and start building with DeshiJS today! 🚀
-
----
-
-```html
-<div id="root"></div>
-
-<template>
-  <button @click="incrementCounter()">
-    { count } {count <= 1 ? 'time' : 'times' }
-  </button>
-</template>
-
-<script type="module">
-  import ezi from "//unpkg.com/ezi";
-  ezi.init();
-
-  useSignal({
-    count: 0,
-    incrementCounter: function () {
-      this.count++;
-    },
-  });
-  
-  useEffect(() => {
-    console.log("component mounted!");
-  });
-</script>
-```
-
-author: [Nazmul Hossain](https://www.facebook.com/codervai)
+# ezi — `npx ezi` launcher for ezicode
+
+Zero-dependency TypeScript CLI. It detects OS/arch, downloads the matching
+native `ezicode` binary from GitHub Releases on first run, caches it, and
+launches the editor detached. No `npm install` required by users.
+
+## Mono-repo layout
+
+```
+ezicode/            # Rust workspace (cargo members: app)
+├── app/            # native editor (ezicode binary)
+├── ezi-cli/        # npm launcher (this folder, NOT a cargo member)
+```
+
+Cargo ignores `ezi-cli/` (`members = ["app"]` in root `Cargo.toml:2`), npm
+ignores the Rust side. One repo, two package managers.
+
+## Develop
+
+```bash
+cd ezi-cli
+npm install
+npm run build     # tsc -> dist/index.js
+node ./dist/index.js --help
+EZI_VERBOSE=1 node ./dist/index.js .   # downloads real binary, opens editor
+```
+
+## Publish
+
+```bash
+cd ezi-cli
+npm run build
+npm publish       # package `ezi`, bin `ezi` -> dist/index.js
+```
+
+Users then run:
+
+```bash
+npx -y ezi .      # first run downloads ~30-60MB binary to cache, opens editor
+ezi .             # after npm i -g ezi
+```
+
+Keep `VERSION` in `src/index.ts`, `version` in `package.json`, and `version`
+in `app/Cargo.toml` in sync — the launcher builds its download URL as
+`.../releases/download/v<VERSION>/ezicode-<target>.*`.
+
+## Cache
+
+- Linux/macOS: `~/.cache/ezi/v<version>/` (or `$XDG_CACHE_HOME`)
+- Windows: `%LOCALAPPDATA%/ezi/cache/v<version>/`
+- Override: `EZI_CACHE`, `EZI_VERSION`, `EZI_REPO`

package/dist/index.js

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * ezi — zero-install launcher for the ezicode native editor.
+ *
+ * Usage:
+ *   npx ezi [file|dir] [args...]   open editor (downloads binary on first run)
+ *   npx ezi --help                  show help
+ *   npx ezi --version               launcher + editor version
+ *
+ * Env overrides:
+ *   EZI_VERSION   GitHub tag version without `v` (default: package version)
+ *   EZI_REPO      `owner/repo` (default: olovalabs/ezicode)
+ *   EZI_CACHE     cache dir override
+ *
+ * Design: zero npm dependencies (node builtins only) so the published
+ * package stays ~5KB. Platform binaries come from GitHub Releases:
+ *   linux x64   -> ezicode-x86_64-unknown-linux-gnu.tar.gz
+ *   mac arm64   -> ezicode-aarch64-apple-darwin.tar.gz
+ *   win x64     -> ezicode-x86_64-pc-windows-msvc.exe (standalone, no unzip)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("node:fs"));
+const https = __importStar(require("node:https"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const LAUNCHER_VERSION = "2.0.0"; // npm package version
+const EDITOR_VERSION = "0.1.2"; // keep in sync with app/Cargo.toml (default download)
+const REPO = process.env.EZI_REPO || "olovalabs/ezicode";
+const TAG = `v${process.env.EZI_VERSION || EDITOR_VERSION}`;
+function resolveTarget() {
+    const platform = process.platform;
+    const arch = process.arch;
+    if (platform === "linux" && arch === "x64") {
+        const t = "x86_64-unknown-linux-gnu";
+        return { kind: "targz", asset: `ezicode-${t}.tar.gz`, binRel: `ezicode-${t}/ezicode` };
+    }
+    if (platform === "darwin" && arch === "arm64") {
+        const t = "aarch64-apple-darwin";
+        return { kind: "targz", asset: `ezicode-${t}.tar.gz`, binRel: `ezicode-${t}/ezicode` };
+    }
+    if (platform === "win32" && arch === "x64") {
+        // Standalone exe on the release — no zip extraction needed.
+        return { kind: "exe", asset: "ezicode-x86_64-pc-windows-msvc.exe" };
+    }
+    throw new Error(`ezi: unsupported platform ${platform}/${arch}. ` +
+        `Prebuilt binaries exist for linux-x64, darwin-arm64, win32-x64 only. ` +
+        `Build from source: https://github.com/${REPO}`);
+}
+function cacheDir() {
+    if (process.env.EZI_CACHE)
+        return process.env.EZI_CACHE;
+    if (process.platform === "win32") {
+        const base = process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local");
+        return path.join(base, "ezi", "cache", TAG);
+    }
+    const xdg = process.env.XDG_CACHE_HOME || path.join(os.homedir(), ".cache");
+    return path.join(xdg, "ezi", TAG);
+}
+function download(url, dest, redirects = 5) {
+    return new Promise((resolve, reject) => {
+        const req = https.get(url, { headers: { "User-Agent": "ezi-launcher" } }, (res) => {
+            const status = res.statusCode || 0;
+            if (status >= 300 && status < 400 && res.headers.location) {
+                if (redirects === 0) {
+                    reject(new Error(`ezi: too many redirects downloading ${url}`));
+                    return;
+                }
+                res.resume();
+                download(res.headers.location, dest, redirects - 1).then(resolve, reject);
+                return;
+            }
+            if (status !== 200) {
+                res.resume();
+                reject(new Error(`ezi: download failed (${status}) for ${url}`));
+                return;
+            }
+            const out = fs.createWriteStream(dest);
+            res.pipe(out);
+            out.on("finish", () => out.close(() => resolve()));
+            out.on("error", (err) => {
+                fs.rmSync(dest, { force: true });
+                reject(err);
+            });
+        });
+        req.on("error", reject);
+    });
+}
+function extractTargz(archive, destDir) {
+    return new Promise((resolve, reject) => {
+        // System tar exists on linux + macOS runners and images. Zero-dep by design.
+        (0, node_child_process_1.execFile)("tar", ["-xzf", archive, "-C", destDir], (err, _stdout, stderr) => {
+            if (err) {
+                reject(new Error(`ezi: failed to extract ${archive}: ${stderr || err.message}`));
+                return;
+            }
+            resolve();
+        });
+    });
+}
+async function ensureBinary(verbose) {
+    const target = resolveTarget();
+    const dir = cacheDir();
+    fs.mkdirSync(dir, { recursive: true });
+    if (target.kind === "exe") {
+        const bin = path.join(dir, "ezicode.exe");
+        if (fs.existsSync(bin))
+            return bin;
+        const url = `https://github.com/${REPO}/releases/download/${TAG}/${target.asset}`;
+        const tmp = bin + ".download";
+        if (verbose)
+            console.log(`ezi: downloading ${url}`);
+        await download(url, tmp);
+        fs.renameSync(tmp, bin);
+        return bin;
+    }
+    const bin = path.join(dir, target.binRel);
+    if (fs.existsSync(bin)) {
+        fs.chmodSync(bin, 0o755);
+        return bin;
+    }
+    const url = `https://github.com/${REPO}/releases/download/${TAG}/${target.asset}`;
+    const archive = path.join(dir, target.asset);
+    if (!fs.existsSync(archive)) {
+        if (verbose)
+            console.log(`ezi: downloading ${url}`);
+        await download(url, archive);
+    }
+    if (verbose)
+        console.log(`ezi: extracting ${target.asset}`);
+    await extractTargz(archive, dir);
+    if (!fs.existsSync(bin))
+        throw new Error(`ezi: binary not found after extract: ${bin}`);
+    fs.chmodSync(bin, 0o755);
+    return bin;
+}
+function printHelp() {
+    console.log(`ezi ${LAUNCHER_VERSION} — launcher for ezicode (https://github.com/${REPO})
+
+Usage:
+  ezi [file|dir] [editor-args...]   open in ezicode (downloads binary first run)
+  ezi --help                        this help
+  ezi --version                     launcher version
+  ezi --where                       print cached binary path
+  ezi --clean                       remove cached binaries
+
+Env:
+  EZI_VERSION   release version (default ${EDITOR_VERSION})
+  EZI_REPO      owner/repo (default ${REPO})
+  EZI_CACHE     cache dir override
+`);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const verbose = args.includes("--verbose") || !!process.env.EZI_VERBOSE;
+    const passthrough = args.filter((a) => a !== "--verbose");
+    if (passthrough.includes("--help") || passthrough.includes("-h")) {
+        printHelp();
+        return;
+    }
+    if (passthrough.includes("--version") || passthrough.includes("-V")) {
+        console.log(`ezi ${LAUNCHER_VERSION} (editor ${TAG} @ ${REPO})`);
+        return;
+    }
+    if (passthrough.includes("--clean")) {
+        fs.rmSync(cacheDir(), { recursive: true, force: true });
+        console.log("ezi: cache cleared");
+        return;
+    }
+    const bin = await ensureBinary(verbose);
+    if (passthrough.includes("--where")) {
+        console.log(bin);
+        return;
+    }
+    // Launch detached so `npx ezi` returns immediately while the GUI stays open.
+    // stdio ignored: the editor owns its own window, not the terminal.
+    const child = (0, node_child_process_1.spawn)(bin, passthrough, {
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true,
+    });
+    child.unref();
+    if (verbose)
+        console.log(`ezi: launched ${bin}`);
+}
+main().catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});

package/package.json

@@ -1,6 +1,32 @@
-{
-  "name": "ezi",
-  "main": "app.js",
-  "version": "0.0.2",
-  "author": "Nazmul Hossain"
-}
+{
+  "name": "ezi",
+  "version": "2.0.0",
+  "description": "Launch ezicode editor with npx — zero-install native binary launcher",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/olovalabs/ezicode.git",
+    "directory": "ezi-cli"
+  },
+  "homepage": "https://github.com/olovalabs/ezicode",
+  "keywords": ["ezicode", "ezi", "editor", "ide", "cli", "launcher"],
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "ezi": "./dist/index.js"
+  },
+  "files": ["dist/"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node ./dist/index.js",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.7.0",
+    "typescript": "^5.6.0"
+  }
+}

package/app.js

@@ -1 +0,0 @@
-console.log("Hello world");