@qumra/cli 2.4.15 → 2.4.18

package/README.md

@@ -1,6 +1,29 @@
+<div align="center">
+
+<br />
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://qumra.cloud/logo-white.svg">
+  <source media="(prefers-color-scheme: light)" srcset="https://qumra.cloud/logo.svg">
+  <img alt="Qumra Cloud" src="https://qumra.cloud/logo.svg" width="200">
+</picture>
+
+<br />
+<br />
+
 # @qumra/cli
 
-Official CLI for [Qumra Cloud](https://qumra.cloud) — build, develop, and deploy themes and apps for your e-commerce store.
+**Build, develop, and deploy themes & apps for your Qumra Cloud store.**
+
+[![npm version](https://img.shields.io/npm/v/@qumra/cli?color=%23764abc&label=npm)](https://www.npmjs.com/package/@qumra/cli)
+[![node](https://img.shields.io/node/v/@qumra/cli?color=%23339933)](https://nodejs.org)
+[![license](https://img.shields.io/npm/l/@qumra/cli?color=%232563eb)](LICENSE)
+
+[Documentation](https://docs.qumra.cloud/docs/cli/intro) · [Qumra Cloud](https://qumra.cloud) · [Get Started](https://app.qumra.cloud)
+
+</div>
+
+---
 
 ## Installation
 
@@ -11,16 +34,16 @@ npm install -g @qumra/cli
 ## Quick Start
 
 ```bash
-# Login to your Qumra Cloud account
+# 1. Login to your account
 qumra login
 
-# Initialize a new theme project
+# 2. Initialize a theme
 qumra theme init
 
-# Start local development server with hot reload
+# 3. Start developing with hot reload
 qumra theme dev
 
-# Publish your theme
+# 4. Publish when ready
 qumra theme publish
 ```
 
@@ -28,54 +51,90 @@ qumra theme publish
 
 ### Authentication
 
-| Command | Description |
-|---------|-------------|
-| `qumra login` | Login to your Qumra Cloud account |
-| `qumra logout` | Logout from your account |
-| `qumra info` | Show current user info |
+```
+qumra login          Login to your Qumra Cloud account
+qumra logout         Logout from your account
+qumra info           Show current user info
+```
 
 ### Themes
 
-| Command | Description |
-|---------|-------------|
-| `qumra theme init` | Initialize a new theme project |
-| `qumra theme dev` | Start local development server with hot reload |
-| `qumra theme publish` | Publish theme to Qumra Cloud |
-| `qumra theme bundle` | Bundle theme for distribution |
-| `qumra theme patch` | Bump patch version and publish |
-| `qumra theme minor` | Bump minor version and publish |
-| `qumra theme major` | Bump major version and publish |
+```
+qumra theme init     Initialize a new theme project
+qumra theme dev      Start dev server with hot reload
+qumra theme publish  Publish theme to Qumra Cloud
+qumra theme bundle   Bundle theme for distribution
+qumra theme patch    Bump patch version and publish
+qumra theme minor    Bump minor version and publish
+qumra theme major    Bump major version and publish
+```
 
 ### Apps
 
-| Command | Description |
-|---------|-------------|
-| `qumra app init` | Initialize a new app project |
-| `qumra app dev` | Start local development server with tunnel |
-| `qumra app deploy` | Deploy app to Qumra Cloud |
+```
+qumra app init       Initialize a new app project
+qumra app dev        Start dev server with HTTPS tunnel
+qumra app deploy     Deploy app to Qumra Cloud
+```
 
 ### Generators
 
-| Command | Description |
-|---------|-------------|
-| `qumra generate widget` | Scaffold a new widget |
+```
+qumra generate widget    Scaffold a new widget
+```
 
 ## Theme Development
 
-Running `qumra theme dev` starts a local development environment with:
+`qumra theme dev` spins up a full local development environment:
 
-- **Proxy server** — forwards requests to your store with local asset overrides
-- **Hot reload** — CSS changes apply instantly, other changes trigger a full reload
-- **File watcher** — automatically syncs file changes to the cloud
+```
+┌─────────────────────────────────────────────┐
+│  Qumra Dev Server                           │
+├─────────────────────────────────────────────┤
+│                                             │
+│  Local:    http://localhost:3000             │
+│  Store:    https://mystore.qumra.cloud      │
+│  Editor:   https://app.qumra.cloud/...      │
+│                                             │
+│  ● Proxy server      — local asset serving  │
+│  ● Hot reload        — instant CSS updates  │
+│  ● File watcher      — auto cloud sync      │
+│                                             │
+├─────────────────────────────────────────────┤
+│  q quit  ·  o open browser  ·  e editor     │
+└─────────────────────────────────────────────┘
+```
+
+### Theme Structure
+
+```
+my-theme/
+├── assets/        Static files (images, fonts, scripts)
+├── layouts/       Base layout templates (.njk)
+├── templates/     Page templates (.njk)
+├── ui/            UI components (.njk, .css)
+├── widgets/       Widget schemas & templates
+├── pages/         Page definitions (.json)
+├── locales/       Translation files (.json)
+└── settings/      Theme configuration
+    ├── settings-schema.json
+    ├── settings-data.json
+    ├── header-schema.json
+    ├── header-data.json
+    ├── footer-schema.json
+    ├── footer-data.json
+    └── templates-settings.json
+```
 
 ## Requirements
 
-- Node.js >= 18
+- **Node.js** >= 18
+- A [Qumra Cloud](https://qumra.cloud) account
 
 ## Documentation
 
-Full documentation is available at [docs.qumra.cloud](https://docs.qumra.cloud/docs/cli/intro).
+Full docs available at **[docs.qumra.cloud](https://docs.qumra.cloud/docs/cli/intro)**
 
 ## License
 
-[MIT](LICENSE)
+[MIT](LICENSE) — Made with care by [Qumra](https://qumra.cloud)

package/dist/cli.js

@@ -278807,59 +278807,65 @@ const ansiRegex$2 = ansiRegex$3;
 
 var stripAnsi$4 = string => typeof string === 'string' ? string.replace(ansiRegex$2(), '') : string;
 
-var isFullwidthCodePoint$2 = {exports: {}};
+var isFullwidthCodePoint$1 = {exports: {}};
 
 /* eslint-disable yoda */
 
-const isFullwidthCodePoint$1 = codePoint => {
-	if (Number.isNaN(codePoint)) {
-		return false;
-	}
+var hasRequiredIsFullwidthCodePoint;
 
-	// Code points are derived from:
-	// http://www.unix.org/Public/UNIDATA/EastAsianWidth.txt
-	if (
-		codePoint >= 0x1100 && (
-			codePoint <= 0x115F || // Hangul Jamo
-			codePoint === 0x2329 || // LEFT-POINTING ANGLE BRACKET
-			codePoint === 0x232A || // RIGHT-POINTING ANGLE BRACKET
-			// CJK Radicals Supplement .. Enclosed CJK Letters and Months
-			(0x2E80 <= codePoint && codePoint <= 0x3247 && codePoint !== 0x303F) ||
-			// Enclosed CJK Letters and Months .. CJK Unified Ideographs Extension A
-			(0x3250 <= codePoint && codePoint <= 0x4DBF) ||
-			// CJK Unified Ideographs .. Yi Radicals
-			(0x4E00 <= codePoint && codePoint <= 0xA4C6) ||
-			// Hangul Jamo Extended-A
-			(0xA960 <= codePoint && codePoint <= 0xA97C) ||
-			// Hangul Syllables
-			(0xAC00 <= codePoint && codePoint <= 0xD7A3) ||
-			// CJK Compatibility Ideographs
-			(0xF900 <= codePoint && codePoint <= 0xFAFF) ||
-			// Vertical Forms
-			(0xFE10 <= codePoint && codePoint <= 0xFE19) ||
-			// CJK Compatibility Forms .. Small Form Variants
-			(0xFE30 <= codePoint && codePoint <= 0xFE6B) ||
-			// Halfwidth and Fullwidth Forms
-			(0xFF01 <= codePoint && codePoint <= 0xFF60) ||
-			(0xFFE0 <= codePoint && codePoint <= 0xFFE6) ||
-			// Kana Supplement
-			(0x1B000 <= codePoint && codePoint <= 0x1B001) ||
-			// Enclosed Ideographic Supplement
-			(0x1F200 <= codePoint && codePoint <= 0x1F251) ||
-			// CJK Unified Ideographs Extension B .. Tertiary Ideographic Plane
-			(0x20000 <= codePoint && codePoint <= 0x3FFFD)
-		)
-	) {
-		return true;
-	}
+function requireIsFullwidthCodePoint () {
+	if (hasRequiredIsFullwidthCodePoint) return isFullwidthCodePoint$1.exports;
+	hasRequiredIsFullwidthCodePoint = 1;
 
-	return false;
-};
+	const isFullwidthCodePoint = codePoint => {
+		if (Number.isNaN(codePoint)) {
+			return false;
+		}
+
+		// Code points are derived from:
+		// http://www.unix.org/Public/UNIDATA/EastAsianWidth.txt
+		if (
+			codePoint >= 0x1100 && (
+				codePoint <= 0x115F || // Hangul Jamo
+				codePoint === 0x2329 || // LEFT-POINTING ANGLE BRACKET
+				codePoint === 0x232A || // RIGHT-POINTING ANGLE BRACKET
+				// CJK Radicals Supplement .. Enclosed CJK Letters and Months
+				(0x2E80 <= codePoint && codePoint <= 0x3247 && codePoint !== 0x303F) ||
+				// Enclosed CJK Letters and Months .. CJK Unified Ideographs Extension A
+				(0x3250 <= codePoint && codePoint <= 0x4DBF) ||
+				// CJK Unified Ideographs .. Yi Radicals
+				(0x4E00 <= codePoint && codePoint <= 0xA4C6) ||
+				// Hangul Jamo Extended-A
+				(0xA960 <= codePoint && codePoint <= 0xA97C) ||
+				// Hangul Syllables
+				(0xAC00 <= codePoint && codePoint <= 0xD7A3) ||
+				// CJK Compatibility Ideographs
+				(0xF900 <= codePoint && codePoint <= 0xFAFF) ||
+				// Vertical Forms
+				(0xFE10 <= codePoint && codePoint <= 0xFE19) ||
+				// CJK Compatibility Forms .. Small Form Variants
+				(0xFE30 <= codePoint && codePoint <= 0xFE6B) ||
+				// Halfwidth and Fullwidth Forms
+				(0xFF01 <= codePoint && codePoint <= 0xFF60) ||
+				(0xFFE0 <= codePoint && codePoint <= 0xFFE6) ||
+				// Kana Supplement
+				(0x1B000 <= codePoint && codePoint <= 0x1B001) ||
+				// Enclosed Ideographic Supplement
+				(0x1F200 <= codePoint && codePoint <= 0x1F251) ||
+				// CJK Unified Ideographs Extension B .. Tertiary Ideographic Plane
+				(0x20000 <= codePoint && codePoint <= 0x3FFFD)
+			)
+		) {
+			return true;
+		}
 
-isFullwidthCodePoint$2.exports = isFullwidthCodePoint$1;
-isFullwidthCodePoint$2.exports.default = isFullwidthCodePoint$1;
+		return false;
+	};
 
-var isFullwidthCodePointExports = isFullwidthCodePoint$2.exports;
+	isFullwidthCodePoint$1.exports = isFullwidthCodePoint;
+	isFullwidthCodePoint$1.exports.default = isFullwidthCodePoint;
+	return isFullwidthCodePoint$1.exports;
+}
 
 var emojiRegex$3 = function () {
   // https://mths.be/emoji
@@ -278867,7 +278873,7 @@ var emojiRegex$3 = function () {
 };
 
 const stripAnsi$3 = stripAnsi$4;
-const isFullwidthCodePoint = isFullwidthCodePointExports;
+const isFullwidthCodePoint = requireIsFullwidthCodePoint();
 const emojiRegex$2 = emojiRegex$3;
 
 const stringWidth$3 = string => {
@@ -279155,7 +279161,7 @@ function requireStringWidth () {
 	if (hasRequiredStringWidth) return stringWidth$1.exports;
 	hasRequiredStringWidth = 1;
 	const stripAnsi = requireStripAnsi();
-	const isFullwidthCodePoint = isFullwidthCodePointExports;
+	const isFullwidthCodePoint = requireIsFullwidthCodePoint();
 	const emojiRegex = requireEmojiRegex();
 
 	const stringWidth = string => {
@@ -304360,7 +304366,7 @@ class SectionBuilder {
     }
 }
 
-var version$2 = "2.4.15";
+var version$2 = "2.4.18";
 var pkg = {
 	version: version$2};
 
@@ -534468,6 +534474,7 @@ AppTunnelService = __decorate$5([
 let AppDevServerService = class AppDevServerService {
     constructor(logger) {
         this.logger = logger;
+        this.childProcess = null;
     }
     async start(options) {
         const { env, cwd = process.cwd() } = options;
@@ -534478,7 +534485,9 @@ let AppDevServerService = class AppDevServerService {
                 cwd,
                 env: { ...process.env, ...env },
                 shell: true,
+                detached: true,
             });
+            this.childProcess = child;
             (_a = child.stdout) === null || _a === void 0 ? void 0 : _a.on('data', (data) => {
                 const lines = data.toString().trim().split('\n');
                 for (const line of lines) {
@@ -534508,6 +534517,7 @@ let AppDevServerService = class AppDevServerService {
             setTimeout(resolve, 2000);
             // Handle exit
             child.on('exit', (code) => {
+                this.childProcess = null;
                 if (code !== 0) {
                     this.logger.componentLog('React Router', `Server exited with code ${code}`, 'error');
                 }
@@ -534526,7 +534536,9 @@ let AppDevServerService = class AppDevServerService {
                 cwd,
                 env: { ...process.env, ...env },
                 shell: true,
+                detached: true,
             });
+            this.childProcess = child;
             (_a = child.stdout) === null || _a === void 0 ? void 0 : _a.on('data', (data) => {
                 const lines = data.toString().trim().split('\n');
                 for (const line of lines) {
@@ -534556,12 +534568,31 @@ let AppDevServerService = class AppDevServerService {
             setTimeout(resolve, 2000);
             // Handle exit
             child.on('exit', (code) => {
+                this.childProcess = null;
                 if (code !== 0) {
                     devUI.log('React Router', `Server exited with code ${code}`, 'error');
                 }
             });
         });
     }
+    stop() {
+        if (this.childProcess && !this.childProcess.killed) {
+            // Kill the process tree (shell: true spawns a shell + child)
+            if (this.childProcess.pid) {
+                try {
+                    process.kill(-this.childProcess.pid, 'SIGTERM');
+                }
+                catch {
+                    // Fallback if process group kill fails
+                    this.childProcess.kill('SIGTERM');
+                }
+            }
+            else {
+                this.childProcess.kill('SIGTERM');
+            }
+            this.childProcess = null;
+        }
+    }
     async getAvailablePort(startPort = 4000) {
         let port = startPort;
         while (true) {
@@ -534674,23 +534705,26 @@ let AppService = class AppService {
                 { label: 'Install URL', url: installUrl },
             ],
             shortcuts: [
-                { key: 'q', label: 'Quit', handler: () => {
+                {
+                    key: 'q', label: 'Quit', handler: () => {
+                        this.devServer.stop();
                         devUI.stop();
                         this.tunnel.stopTunnel();
                         process.exit(0);
-                    } },
+                    }
+                },
                 { key: 'p', label: 'Preview', handler: () => open(developmentUrl) },
                 { key: 'o', label: 'Open Store', handler: () => open(installUrl) },
             ],
             logPanels: ['All', 'Server', 'Tunnel', 'Prisma'],
         });
         // Log initial steps
-        devUI.log('prisma', 'Running migrations...');
-        require$$1$7.execSync('npx prisma db push && npx prisma generate', {
-            cwd: process.cwd(),
-            stdio: 'ignore',
-        });
-        devUI.log('prisma', 'Migrations complete', 'success');
+        // devUI.log('prisma', 'Running migrations...');
+        // execSync('npx prisma db push && npx prisma generate', {
+        //   cwd: process.cwd(),
+        //   stdio: 'ignore',
+        // });
+        // devUI.log('prisma', 'Migrations complete', 'success');
         devUI.log('tunnel', `Tunnel ready: ${developmentUrl}`, 'success');
         devUI.log('app-preview', 'Dev preview ready', 'success');
         // Open install URL in browser

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qumra/cli",
-  "version": "2.4.15",
+  "version": "2.4.18",
   "description": "Official CLI for Qumra Cloud e-commerce platform. Build, develop, and deploy themes and apps.",
   "main": "dist/cli.js",
   "bin": {