slicejs-cli 2.7.0 → 2.7.3

package/README.md

@@ -1,16 +1,29 @@
+<div align="center">
+
 # Slice.js CLI
+<img src="./assets/Slice.js-logo.png" alt="Slice.js logo" width="200" />
+<br/>
+
+<div style="display: flex; justify-content: center; align-items: center; gap: 10px; align-content: center;">
+<a href="https://www.npmjs.com/package/slicejs-cli"><img src="https://img.shields.io/npm/v/slicejs-cli.svg?label=CLI" alt="npm version" /></a>
+<img src="https://img.shields.io/badge/Node-%E2%89%A5%2020.0.0-339933?logo=node.js" alt="node requirement" />
+<a href="#license"><img src="https://img.shields.io/badge/License-ISC-blue.svg" alt="license" /></a>
+</div>
+
 
-Command-line interface for developing web applications with the Slice.js framework.
+<p>CLI for building web applications with the Slice.js framework</p>
+
+</div>
 
 ## Installation
 
-### Local Installation (Recommended)
+- Local (recommended):
 
 ```bash
 npm install slicejs-cli --save-dev
 ```
 
-### Global Installation
+- Global:
 
 ```bash
 npm install -g slicejs-cli
@@ -24,108 +37,104 @@ After installation, you can use the `slice` command directly:
 slice [command] [options]
 ```
 
-Or with npx (no installation required):
+Or with npx (without global install):
 
 ```bash
 npx slicejs-cli [command]
 ```
 
-## Commands
+## Essential Commands
 
-### Project Initialization
+### Initialize a project
 
 ```bash
 slice init
 ```
 
-Initializes a new Slice.js project with the complete framework structure.
+Initializes a Slice.js project with the full structure (`src/` and `api/`), installs initial Visual components, and configures npm scripts.
 
-### Development Server
+### Development server
 
 ```bash
-# Start development server on default port (3000)
+# Default port (3000)
 slice dev
 
-# Start on custom port
+# Custom port
 slice dev -p 8080
 
-# Alternative command (same as dev)
+# Alias
 slice start
 slice start -p 8080
 ```
 
-### Component Management (Local)
+### Component management (local)
 
 ```bash
-# Create a new component (interactive)
+# Create a component (interactive)
 slice component create
 
-# List all local components
+# List local components
 slice component list
 
 # Delete a component (interactive)
 slice component delete
 ```
 
-**Shortcuts:**
+Shortcuts:
 ```bash
-slice component create → slice comp create
-slice component list   → slice comp ls
-slice component delete → slice comp remove
+slice comp create
+slice comp ls
+slice comp remove
 ```
 
-### Component Registry (Official Repository)
+### Official component registry
 
 ```bash
-# Install components from official repository
+# Install Visual components
 slice get Button Card Input
 
-# Install service component
+# Install a Service component
 slice get FetchManager --service
 
-# Force overwrite existing components
+# Force overwrite
 slice get Button --force
 
 # Browse available components
 slice browse
 
-# Update all local components to latest versions
+# Update all local components
 slice sync
-
-# Force update without confirmation
 slice sync --force
 ```
 
-**Shortcuts:**
+Shortcuts:
 ```bash
-slice registry get Button → slice get Button
-slice registry list       → slice browse
-slice registry sync       → slice sync
+slice get Button
+slice browse
+slice sync
 ```
 
 ### Utilities
 
 ```bash
-# Show version information
+# Version info
 slice version
 slice -v
 
-# Update CLI and Framework
-slice update              # Check and prompt for updates
-slice update --yes        # Update all automatically
-slice update --cli        # Update only CLI
-slice update --framework  # Update only Framework
+# Updates (CLI and Framework)
+slice update              # Check and prompt to update
+slice update --yes        # Update everything automatically
+slice update --cli        # CLI only
+slice update --framework  # Framework only
 
-# Show help
+# Help
 slice --help
 slice [command] --help
 ```
 
-## NPM Scripts
-
-When you install `slicejs-cli`, the following scripts are automatically added to your project's `package.json`:
+## npm Scripts
 
-### Recommended (New)
+`slice init` automatically configures the recommended scripts in your `package.json`:
 
 ```json
 {
@@ -149,18 +158,6 @@ npm run get
 npm run browse
 ```
 
-### Legacy (Still Supported)
-
-```json
-{
-  "scripts": {
-    "slice:dev": "slice dev",
-    "slice:start": "slice start",
-    "slice:get": "slice get"
-  }
-}
-```
-
 ## Quick Start
 
 ```bash
@@ -215,11 +212,11 @@ slice sync
 
 ## Development Mode
 
-The development server (`slice dev` or `slice start`) provides:
+The development server (`slice dev` / `slice start`) provides:
 
-- ✅ Hot reload for instant changes
-- ✅ Serves files directly from `/src`
-- ✅ No build step required
+- ✅ Hot reload
+- ✅ Serves directly from `/src`
+- ✅ No build step
 - ✅ Port validation
 - ✅ Clear error messages
 
@@ -230,35 +227,46 @@ The development server (`slice dev` or `slice start`) provides:
 
 ## Configuration
 
-Project configuration is stored in `src/sliceConfig.json`, created automatically during `slice init`.
+Project configuration is stored in `src/sliceConfig.json` and is created automatically by `slice init`.
 
 ## Features
 
-- 🚀 Fast development server with hot reload
-- 📦 Component registry for sharing components
+- 🚀 Development server with hot reload
+- 📦 Official component registry
 - 🎨 Visual and Service component types
 - ✨ Interactive component creation
 - 🔄 Automatic component synchronization
 - 🛠️ Built-in validation and error handling
-- 📝 Clear, actionable error messages
+
+### Smart Updates
+
+- Detects whether the CLI in use is global or local
+- Shows an update plan (GLOBAL/PROJECT) before execution
+- Offers to include global CLI update interactively
+- Applies `uninstall` + `install @latest` to ensure latest versions
+
+### Cross-platform Paths
+
+- Centralized path helper avoids `../../..`
+- Windows/Linux/Mac compatibility using `import.meta.url` and `fileURLToPath`
 
 ## Troubleshooting
 
-### Port Already in Use
+### Port already in use
 
 ```bash
 # Use a different port
 slice dev -p 8080
 ```
 
-### Project Not Initialized
+### Project not initialized
 
 ```bash
 # Make sure to run init first
 slice init
 ```
 
-### Command Not Found
+### Command not found
 
 ```bash
 # Use npx if not installed globally

package/client.js

@@ -24,8 +24,7 @@ const loadConfig = () => {
     const configPath = getConfigPath(import.meta.url);
     const rawData = fs.readFileSync(configPath, "utf-8");
     return JSON.parse(rawData);
-  } catch (error) {
-    Print.error(`Loading configuration: ${error.message}`);
+  } catch {
     return null;
   }
 };
@@ -58,7 +57,14 @@ async function runWithVersionCheck(commandFunction, ...args) {
 
 const sliceClient = program;
 
-sliceClient.version("2.6.1").description("CLI for managing Slice.js framework components");
+try {
+  const pkgPath = path.join(__dirname, "./package.json");
+  const pkgRaw = fs.readFileSync(pkgPath, "utf-8");
+  const pkg = JSON.parse(pkgRaw);
+  sliceClient.version(pkg.version).description("CLI for managing Slice.js framework components");
+} catch {
+  sliceClient.version("0.0.0").description("CLI for managing Slice.js framework components");
+}
 
 // INIT COMMAND
 sliceClient
@@ -416,11 +422,11 @@ More info: https://slice-js-docs.vercel.app/
 
 // Default action with better messaging
 if (!process.argv.slice(2).length) {
-  program.outputHelp();
   Print.newLine();
   Print.info("Start with: slice init");
   Print.commandExample("Development", "slice dev");
   Print.commandExample("View available components", "slice browse");
+  Print.info("Use 'slice --help' for full help");
 }
 
 // Error handling for unknown commands

package/commands/utils/updateManager.js

@@ -184,13 +184,15 @@ class UpdateManager {
      */
     async updatePackage(packageName) {
         try {
-            let command = `npm install ${packageName}@latest`;
+            let installCmd = `npm install ${packageName}@latest`;
+            let uninstallCmd = `npm uninstall ${packageName}`;
             let options = {};
 
             if (packageName === 'slicejs-cli') {
                 const info = await this.detectCliInstall();
                 if (info.type === 'global') {
-                    command = `npm install -g slicejs-cli@latest`;
+                    installCmd = `npm install -g slicejs-cli@latest`;
+                    uninstallCmd = `npm uninstall -g slicejs-cli`;
                 } else {
                     options.cwd = info.projectRoot || getProjectRoot(import.meta.url);
                 }
@@ -198,7 +200,12 @@ class UpdateManager {
                 options.cwd = getProjectRoot(import.meta.url);
             }
 
-            const { stdout, stderr } = await execAsync(command, options);
+            // Try uninstall first (ignore failure)
+            try {
+                await execAsync(uninstallCmd, options);
+            } catch {}
+
+            const { stdout, stderr } = await execAsync(installCmd, options);
 
             return {
                 success: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "slicejs-cli",
-  "version": "2.7.0",
+  "version": "2.7.3",
   "description": "Command client for developing web applications with Slice.js framework",
   "main": "client.js",
   "bin": {