nanoshell 1.7.7 → 1.7.9

package/README.md

@@ -1,4 +1,4 @@
-# NanoShell ⚡ (`nanoshell@1.7.7`)
+# NanoShell ⚡ (`nanoshell@1.7.9`)
 
 > **Created & Engineered by Suman Biswas** 👑  
 > *Hyper-lightweight 17MB RAM, 120 FPS Native WebKit Desktop Application Framework & Runtime Engine*
@@ -19,7 +19,30 @@
 
 ---
 
-## 🆕 What's New in v1.7.7
+## 🚀 Quick Start (Modern `npm create` Standards)
+
+```bash
+# 1. Scaffold a new application project (Always fetches latest release)
+npm create nanoshell my-awesome-app
+
+# 2. Start Development Mode (In-Window Hot Reloading on Ctrl+S)
+cd my-awesome-app
+npm start
+
+# 3. Build Standalone Production Binary (.exe)
+npm run build
+
+# 4. Package Windows Installer (.exe + Setup.exe via Inno Setup)
+npm run package
+```
+
+---
+
+## 🆕 What's New in v1.7.9
+
+### 🌟 Seamless `npm create nanoshell` & Interactive Prompt
+- **Word-for-Word Scaffolding**: Published `create-nanoshell` package so `npm create nanoshell` works natively without 404 errors or stale `npx` cache issues.
+- **Interactive Scaffolding**: Running `npm create nanoshell` without arguments now interactively prompts for the project name.
 
 ### 🪟 Pure Native Win32 Windowing & Full API Control
 - **Zero Windowing Wrappers**: Fully excised AppCore window wrappers to give direct, un-sandboxed `HWND` control to native Zig code.
@@ -31,10 +54,10 @@
 - **Pixel-Accurate Hit-Testing**: Mouse input coordinates `(x, y)` are dynamically converted from Windows physical pixels to WebKit logical CSS coordinates (`toLogical = physical / dpi_scale`). Clicks, hovers, and drags land pixel-perfectly on DOM elements at any DPI.
 - **High-Quality GDI Halftone Blitting**: `SetStretchBltMode(HALFTONE)` ensures razor-sharp text and graphics rendering.
 
-### 📦 Automatic Out-of-the-Box Windows Installer (`nanoshell package`)
+### 📦 Automatic Out-of-the-Box Windows Installer (`npm run package`)
 - Generate full-featured Windows Setup installers (`.exe`) with **one single command**:
   ```bash
-  npx nanoshell package
+  npm run package
   ```
 - **Inno Setup Integration**: Auto-detects local or system Inno Setup (`ISCC.exe`), generates `setup.iss`, and builds single-file installers in `dist/` with Start Menu, Desktop shortcuts, and Control Panel Uninstaller support.
 

package/SKILL.md

@@ -3,7 +3,7 @@ name: nanoshell-desktop-framework
 description: Build ultra-fast, 120 FPS, 17MB RAM native desktop applications using HTML, CSS, JS, and Zig with the NanoShell runtime engine (nanoshell) created by Suman Biswas. Includes Per-Monitor DPI V2 crisp scaling and Win32 direct windowing.
 ---
 
-# NanoShell Native Desktop Framework Skill Guide (`nanoshell@1.7.7`)
+# NanoShell Native Desktop Framework Skill Guide (`nanoshell@1.7.9`)
 
 **Created & Engineered by Suman Biswas**
 
@@ -13,22 +13,22 @@ NanoShell is a hyper-lightweight, browser-free native desktop application framew
 
 ## Starter Template Scaffolding Command
 
-AI agents or developers can scaffold a new application using:
+AI agents or developers can scaffold a new application using modern `npm create` standards (always fetches `@latest` without stale caching):
 
 ```bash
-npx nanoshell <app-name>    # Scaffold new app template
-npx nanoshell start         # Launch dev engine with hot-reloading
-npx nanoshell build         # Build production release binary only
-npx nanoshell package       # Build binary and generate Windows Inno Setup installer (.exe)
+npm create nanoshell <app-name> # Scaffold new app template (or run without args for interactive prompt)
+npm start                       # Launch dev engine with hot-reloading
+npm run build                   # Build production release binary only
+npm run package                 # Build binary and generate Windows Inno Setup installer (.exe)
 ```
 
-`npx nanoshell package` generates a single-file Windows Setup `.exe` with a installer dialog allowing end-users to choose:
+`npm run package` generates a single-file Windows Setup `.exe` with a installer dialog allowing end-users to choose:
 - **Per-User Install** (No admin rights required, installs to `%LocalAppData%`)
 - **System-Wide Install** (Requires admin rights, installs to `Program Files`)
 
 ---
 
-## ⚡ v1.7.7 Engine Architecture & High-DPI Rules for AI Agents
+## ⚡ v1.7.9 Engine Architecture & High-DPI Rules for AI Agents
 
 1. **Pure Win32 Subsystem**: Runs on `.Windows` subsystem with zero background CMD console windows.
 2. **Per-Monitor DPI V2 Aware**: Integrates `DPI_AWARENESS_CONTEXT_PER_MONITOR_AWARE_V2`. Window client sizes are automatically scaled physically (`physical_size = logical_size * dpi_scale`).

package/cli/index.js

@@ -36,7 +36,34 @@ if (!fs.existsSync(exePath)) {
     exePath = path.join(pkgDir, 'bin', 'nanoshell.exe');
 }
 
-const args = process.argv.slice(2);
+const readline = require('readline');
+
+let args = process.argv.slice(2);
+
+// If no arguments provided (e.g. npm create nanoshell), prompt interactively for app name
+if (args.length === 0) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+
+    console.log(`\x1b[36m\x1b[1m
+  ⚡ NanoShell Native Desktop Framework Scaffolder (v${pkg.version})
+  Created & Engineered by Suman Biswas
+\x1b[0m`);
+
+    const defaultAppName = 'my-nanoshell-app';
+    rl.question(`? Project name: \x1b[36m(${defaultAppName})\x1b[0m `, (answer) => {
+        rl.close();
+        const appName = answer.trim() || defaultAppName;
+        console.log(`\n🚀 Scaffolding new NanoShell project in .\\${appName}...\n`);
+        
+        // Re-invoke self with the project name argument
+        const execRes = spawnSync(process.execPath, [__filename, appName], { stdio: 'inherit' });
+        process.exit(execRes.status || 0);
+    });
+    return;
+}
 
 // Handle "package" command directly in JS CLI runner
 if (args.length > 0 && (args[0] === 'package' || args[0] === 'installer')) {

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "nanoshell",
-  "version": "1.7.7",
+  "version": "1.7.9",
   "description": "Hyper-lightweight native desktop application framework. 17MB RAM, 120 FPS, pure Win32 DPI-aware windowing with WebKit rendering. No Electron. Created by Suman Biswas.",
   "main": "cli/index.js",
   "bin": {
     "nanoshell": "cli/index.js",
+    "create-nanoshell": "cli/index.js",
     "create-nanoshell-app": "cli/index.js"
   },
   "files": [
@@ -24,7 +25,8 @@
     "build": "zig build -Doptimize=ReleaseFast",
     "package": "node cli/index.js package",
     "start": "zig-out/bin/example_app.exe",
-    "init": "zig-out/bin/nanoshell.exe init"
+    "init": "zig-out/bin/nanoshell.exe init",
+    "pub": "npm publish --access public && cd create-nanoshell && npm publish --access public && cd .."
   },
   "keywords": [
     "nanoshell",