slicejs-cli 3.6.4 → 3.6.5

package/README.md

@@ -134,7 +134,6 @@ When you install `slicejs-cli`, the `postinstall` script automatically configure
     "slice:doctor": "node ./node_modules/slicejs-cli/client.js doctor",
     "slice:version": "node ./node_modules/slicejs-cli/client.js version",
     "slice:help": "node ./node_modules/slicejs-cli/client.js --help",
-    "slice:update": "node ./node_modules/slicejs-cli/client.js update",
     "slice:types": "node ./node_modules/slicejs-cli/client.js types generate"
   }
 }

package/client.js

@@ -35,7 +35,7 @@ import {
   runScriptCommand,
   SUPPORTED_PACKAGE_MANAGERS
 } from './commands/utils/PackageManager.js';
-import { SLICE_SCRIPTS } from './commands/utils/sliceScripts.js';
+import { SLICE_SCRIPTS, verifySliceScriptsInPackageJson } from './commands/utils/sliceScripts.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -44,20 +44,50 @@ const getCategories = () => {
   return config && config.paths?.components ? Object.keys(config.paths.components) : [];
 };
 
+// Helper to validate port number
+function parsePort(value) {
+  if (!value) return undefined;
+  const port = parseInt(value, 10);
+  if (isNaN(port) || port < 1 || port > 65535) {
+    Print.error(`Invalid port: "${value}". Must be a number between 1 and 65535.`);
+    process.exit(1);
+  }
+  return port;
+}
+
+async function withNodeEnv(env, fn) {
+  const prevEnv = process.env.NODE_ENV;
+  process.env.NODE_ENV = env;
+  listComponents();
+  try {
+    return await fn();
+  } finally {
+    process.env.NODE_ENV = prevEnv;
+  }
+}
+
 // Function to run version check for all commands
 async function runWithVersionCheck(commandFunction, ...args) {
   try {
-    updateManager.notifyAvailableUpdates().catch(() => {});
+    const globalOpts = program.opts();
+    const skipVersionCheck = globalOpts.noVersionCheck === false;
+
+    if (!skipVersionCheck) {
+      updateManager.notifyAvailableUpdates().catch(() => {});
+    }
 
     const result = await commandFunction(...args);
 
-    setTimeout(() => {
-      versionChecker.checkForUpdates(false);
-    }, 100);
+    if (!skipVersionCheck) {
+      setTimeout(() => {
+        versionChecker.checkForUpdates(false);
+      }, 100);
+    }
 
     return result;
   } catch (error) {
     Print.error(`Command execution: ${error.message}`);
+    console.error(error.stack);
     return false;
   }
 }
@@ -80,7 +110,7 @@ function maybeDelegateToLocalCli() {
     {
       stdio: 'inherit',
       cwd: process.cwd(),
-      env: process.env
+      env: { ...process.env, SLICE_NO_LOCAL_DELEGATION: '1' }
     }
   );
 
@@ -104,13 +134,12 @@ try {
 sliceClient
   .command("init")
   .description("Initialize a new Slice.js project")
-  .option("-y, --yes [name]", "Skip prompts and initialize with project name")
+  .argument("[name]", "Project name (defaults to my-slice-app)")
+  .option("-y, --yes", "Skip prompts")
   .option("--pm <packageManager>", "Package manager to use (pnpm or npm). Auto-detected when omitted")
-  .action(async (options) => {
-    let projectName = 'my-slice-app';
-    if (options.yes) {
-      projectName = typeof options.yes === 'string' ? options.yes : projectName;
-    } else {
+  .action(async (name, options) => {
+    let projectName = name ? name.trim().toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, '').replace(/-+/g, '-').replace(/^-|-$/g, '') : 'my-slice-app';
+    if (!options.yes) {
       const answers = await inquirer.prompt([
         {
           type: 'input',
@@ -222,15 +251,9 @@ sliceClient
 const buildCommand = sliceClient.command("build")
   .description("Build Slice.js project for production")
   .action(async (options) => {
-    const prevEnv = process.env.NODE_ENV;
-    process.env.NODE_ENV = 'production';
-    try {
-      await runWithVersionCheck(async () => {
-        await build(options);
-      });
-    } finally {
-      process.env.NODE_ENV = prevEnv;
-    }
+    await withNodeEnv('production', () => runWithVersionCheck(async () => {
+      await build(options);
+    }));
   });
 
 buildCommand
@@ -263,19 +286,13 @@ sliceClient
   .option("-p, --port <port>", "Port for development server")
   .option("--no-hmr", "Disable hot module reload (enabled by default)")
   .action(async (options) => {
-    const prevEnv = process.env.NODE_ENV;
-    process.env.NODE_ENV = 'development';
-    try {
-      await runWithVersionCheck(async () => {
-        await startServer({
-          mode: 'development',
-          port: options.port ? parseInt(options.port) : undefined,
-          watch: options.hmr
-        });
+    await withNodeEnv('development', () => runWithVersionCheck(async () => {
+      await startServer({
+        mode: 'development',
+        port: parsePort(options.port),
+        watch: options.hmr
       });
-    } finally {
-      process.env.NODE_ENV = prevEnv;
-    }
+    }));
   });
 
 // START COMMAND - PRODUCTION MODE
@@ -284,18 +301,12 @@ sliceClient
   .description("Serve production files from dist/ (requires prior slice build)")
   .option("-p, --port <port>", "Port for server")
   .action(async (options) => {
-    const prevEnv = process.env.NODE_ENV;
-    process.env.NODE_ENV = 'production';
-    try {
-      await runWithVersionCheck(async () => {
-        await startServer({
-          mode: 'production',
-          port: options.port ? parseInt(options.port) : undefined
-        });
+    await withNodeEnv('production', () => runWithVersionCheck(async () => {
+      await startServer({
+        mode: 'production',
+        port: parsePort(options.port)
       });
-    } finally {
-      process.env.NODE_ENV = prevEnv;
-    }
+    }));
   });
 
 // COMPONENT COMMAND GROUP - For local component management
@@ -597,19 +608,6 @@ sliceClient
     });
   });
 
-// UPDATE COMMAND
-sliceClient
-  .command("update")
-  .alias("upgrade")
-  .description("Update CLI and framework to latest versions")
-  .option("-y, --yes", "Skip confirmation and update all packages automatically")
-  .option("--cli", "Update only the Slice.js CLI")
-  .option("-f, --framework", "Update only the Slice.js Framework")
-  .option("--update-api", "Also overwrite api/index.js with the framework version (never done by default; creates a .bak backup)")
-  .action(async (options) => {
-    await updateManager.checkAndPromptUpdates(options);
-  });
-
 // DOCTOR COMMAND - Diagnose project issues
 sliceClient
   .command("doctor")
@@ -621,12 +619,11 @@ sliceClient
     });
   });
 
-// POSTINSTALL COMMAND - Manual alternative to postinstall
+// POSTINSTALL COMMAND - Configure npm scripts in existing project
 sliceClient
   .command("postinstall")
-  .description("Configure npm scripts in package.json (alternative to postinstall for --ignore-scripts users)")
+  .description("Configure npm scripts in package.json (useful when adding slicejs-cli to an existing project)")
   .action(() => {
-    // npm sets npm_config_global; pnpm global installs are detected via PNPM_HOME.
     const pnpmHome = process.env.PNPM_HOME;
     const cliEntryPath = fileURLToPath(import.meta.url);
     const isGlobal = process.env.npm_config_global === 'true'
@@ -642,7 +639,6 @@ sliceClient
     const pkgPath = path.join(projectRoot, 'package.json');
     const packageManager = resolvePackageManager(projectRoot).name;
 
-    // Shared with post.js and slice init — see commands/utils/sliceScripts.js
     const sliceScripts = SLICE_SCRIPTS;
 
     try {
@@ -701,7 +697,7 @@ Common Usage Examples:
   slice list                     - List all local components
   slice doctor                   - Run project diagnostics
   slice types generate           - Generate TypeScript typings for slice.build
-  slice postinstall              - Show post-install setup guide
+  slice postinstall              - Configure npm scripts in package.json
 
 Command Categories:
   • init, dev, start             - Project lifecycle (development only)
@@ -709,7 +705,7 @@ Command Categories:
   • component <cmd>              - Local component management
   • registry <cmd>               - Official repository operations
   • types generate               - Type declarations from static props
-  • version, update, doctor, setup - Maintenance commands
+  • version, doctor, setup - Maintenance commands
 
 Development Workflow:
   • slice init          - Initialize project

package/commands/bundle/bundle.js

@@ -74,7 +74,7 @@ export default async function bundle(options = {}) {
       console.error('\n📍 Error code:', error.code);
     }
 
-    process.exit(1);
+    throw error;
   }
 }
 
@@ -177,7 +177,8 @@ export async function cleanBundles() {
 
   } catch (error) {
     Print.error('Error cleaning bundles:', error.message);
-    process.exit(1);
+    console.error(error.stack);
+    throw error;
   }
 }
 
@@ -229,6 +230,7 @@ export async function bundleInfo() {
 
   } catch (error) {
     Print.error('Error reading information:', error.message);
-    process.exit(1);
+    console.error(error.stack);
+    throw error;
   }
 }

package/commands/doctor/doctor.js

@@ -4,12 +4,10 @@ import { createServer } from 'net';
 import chalk from 'chalk';
 import Table from 'cli-table3';
 import Print from '../Print.js';
-import inquirer from 'inquirer';
-import { exec } from 'child_process';
-import { promisify } from 'util';
-import { getProjectRoot, getSrcPath, getApiPath, getConfigPath, getPath } from '../utils/PathHelper.js';
+import { getProjectRoot, getSrcPath, getApiPath, getConfigPath, getPath, getComponentsJsPath } from '../utils/PathHelper.js';
 import { resolvePackageManager, installCommand } from '../utils/PackageManager.js';
 import updateManager from '../utils/updateManager.js';
+import { parseComponentsRegistry, extractStaticPropsFromSource } from '../types/types.js';
 
 /**
  * Checks the Node.js version
@@ -319,6 +317,100 @@ async function checkComponents() {
     }
 }
 
+/**
+ * Lints component static props for common issues.
+ * Uses the same Babel parsing as slice types generate.
+ */
+async function checkComponentProps() {
+  const issues = [];
+  const registryPath = getComponentsJsPath(import.meta.url);
+  const configPath = getConfigPath(import.meta.url);
+
+  if (!await fs.pathExists(registryPath)) {
+    return { pass: true, message: 'No components to check' };
+  }
+
+  try {
+    const content = await fs.readFile(registryPath, 'utf-8');
+    const registryMap = parseComponentsRegistry(content, registryPath);
+    const entries = Object.entries(registryMap);
+
+    if (entries.length === 0) {
+      return { pass: true, message: 'No components registered' };
+    }
+
+    // Build a category-to-path map from sliceConfig.json
+    const categoryPathCache = new Map();
+    if (await fs.pathExists(configPath)) {
+      try {
+        const config = await fs.readJson(configPath);
+        if (config.paths?.components) {
+          for (const [cat, catMeta] of Object.entries(config.paths.components)) {
+            categoryPathCache.set(cat, catMeta.path?.replace(/^[/\\]+/, '') || '');
+          }
+        }
+      } catch {}
+    }
+
+    const VALID_TYPES = new Set(['string', 'number', 'boolean', 'object', 'array', 'function', 'any']);
+    const checked = [];
+
+    for (const [compName, meta] of entries) {
+      const category = typeof meta === 'string' ? meta : (meta.category || '');
+      const relPath = categoryPathCache.get(category);
+      if (!relPath) continue;
+      const jsPath = getSrcPath(import.meta.url, relPath, compName, `${compName}.js`);
+
+      if (!await fs.pathExists(jsPath)) {
+        continue;
+      }
+
+      const source = await fs.readFile(jsPath, 'utf-8');
+      const props = extractStaticPropsFromSource(source, jsPath);
+      if (!props) continue;
+
+      checked.push(compName);
+
+      for (const [propName, propMeta] of Object.entries(props)) {
+        if (propMeta.type === 'any') {
+          issues.push({ component: compName, prop: propName, message: `"${propName}" uses type "any" — specify a concrete type` });
+        }
+        if (propMeta.required && propMeta.type !== 'boolean') {
+          issues.push({ component: compName, prop: propName, message: `"${propName}" is required but has no default value` });
+        }
+        if (propMeta.schema && propMeta.type !== 'object') {
+          issues.push({ component: compName, prop: propName, message: `"${propName}" has "schema" but type is "${propMeta.type}" (should be "object")` });
+        }
+        if (propMeta.items && propMeta.type !== 'array') {
+          issues.push({ component: compName, prop: propName, message: `"${propName}" has "items" but type is "${propMeta.type}" (should be "array")` });
+        }
+        if (!VALID_TYPES.has(propMeta.type)) {
+          issues.push({ component: compName, prop: propName, message: `"${propName}" has unknown type "${propMeta.type}"` });
+        }
+        if (Array.isArray(propMeta.allowedValues) && propMeta.allowedValues.length > 0) {
+          const typeMismatch = propMeta.allowedValues.some(v => typeof v !== propMeta.type);
+          if (typeMismatch && propMeta.type !== 'any') {
+            issues.push({ component: compName, prop: propName, message: `"${propName}" allowedValues type mismatch (expected ${propMeta.type})` });
+          }
+        }
+      }
+    }
+
+    if (issues.length === 0) {
+      return { pass: true, message: `${checked.length} components checked, props look good` };
+    }
+
+    return {
+      warn: true,
+      message: `${issues.length} prop issue(s) across ${new Set(issues.map(i => i.component)).size} component(s)`,
+      suggestion: issues.map(i => `  ${i.component}.${i.prop}: ${i.message}`).join('\n'),
+      issues
+    };
+  } catch (error) {
+    return { warn: true, message: `Cannot check props: ${error.message}` };
+  }
+}
+
 /**
  * Main diagnostic command
  */
@@ -328,7 +420,8 @@ export {
     checkConfig,
     checkPort,
     checkDependencies,
-    checkComponents
+    checkComponents,
+    checkComponentProps
 };
 
 export default async function runDiagnostics() {
@@ -343,7 +436,8 @@ export default async function runDiagnostics() {
         { name: 'Port Availability', fn: checkPort },
         { name: 'Package Manager', fn: checkPackageManagerSetup },
         { name: 'Dependencies', fn: checkDependencies },
-        { name: 'Components', fn: checkComponents }
+        { name: 'Components', fn: checkComponents },
+        { name: 'Component Props', fn: checkComponentProps }
     ];
 
     const results = [];
@@ -394,27 +488,9 @@ export default async function runDiagnostics() {
     const depsResult = results.find(r => r.name === 'Dependencies');
     if (depsResult && depsResult.warn && Array.isArray(depsResult.missing) && depsResult.missing.length > 0) {
         const projectRoot = getProjectRoot(import.meta.url);
-        const execAsync = promisify(exec);
-        const { confirmInstall } = await inquirer.prompt([
-            {
-                type: 'confirm',
-                name: 'confirmInstall',
-                message: `Install missing dependencies in this project now? (${depsResult.missing.join(', ')})`,
-                default: true
-            }
-        ]);
-        if (confirmInstall) {
-            const pm = resolvePackageManager(projectRoot).name;
-            for (const pkg of depsResult.missing) {
-                try {
-                    const cmd = installCommand(pm, `${pkg}@latest`);
-                    Print.info(`Installing ${pkg}...`);
-                    await execAsync(cmd, { cwd: projectRoot });
-                    Print.success(`${pkg} installed`);
-                } catch (e) {
-                    Print.error(`Installing ${pkg}: ${e.message}`);
-                }
-            }
+        const pm = resolvePackageManager(projectRoot).name;
+        for (const pkg of depsResult.missing) {
+            Print.info(`Missing: ${pkg}. Install with: ${installCommand(pm, `${pkg}@latest`)}`);
         }
     }
 

package/commands/getComponent/getComponent.js

@@ -262,10 +262,8 @@ filterOfficialComponents(allComponents) {
   }
 
   async updateLocalRegistrySafe(componentName, category) {
-    // Queue behind any in-flight registry update; keep the chain alive even
-    // when an update throws so later updates still run.
     const run = this._registryLock.then(() => this._updateLocalRegistry(componentName, category));
-    this._registryLock = run.catch(() => {});
+    this._registryLock = run.catch(() => { /* non-critical: registry update failure is handled by caller */ });
     return run;
   }
 
@@ -611,12 +609,12 @@ filterOfficialComponents(allComponents) {
   }
 }
 
+const sharedRegistry = new ComponentRegistry();
+
 // Main get function
 async function getComponents(componentNames = [], options = {}) {
-  const registry = new ComponentRegistry();
-  
   try {
-    await registry.loadRegistry();
+    await sharedRegistry.loadRegistry();
   } catch (error) {
     Print.error('Could not load component registry from official repository');
     Print.info('Check your internet connection and try again');
@@ -625,7 +623,7 @@ async function getComponents(componentNames = [], options = {}) {
 
   // Interactive mode if no components specified
   if (!componentNames || componentNames.length === 0) {
-    await registry.interactiveInstall();
+    await sharedRegistry.interactiveInstall();
     return true;
   }
 
@@ -634,7 +632,7 @@ async function getComponents(componentNames = [], options = {}) {
 
   if (componentNames.length === 1) {
     // Single component install
-    const componentInfo = registry.findComponentInRegistry(componentNames[0]);
+    const componentInfo = sharedRegistry.findComponentInRegistry(componentNames[0]);
     
     if (!componentInfo) {
       Print.error(`Component '${componentNames[0]}' not found in official repository`);
@@ -646,7 +644,7 @@ async function getComponents(componentNames = [], options = {}) {
     const actualCategory = options.service ? 'Service' : componentInfo.category;
 
     try {
-      await registry.installComponent(componentInfo.name, actualCategory, options.force);
+      await sharedRegistry.installComponent(componentInfo.name, actualCategory, options.force);
       return true;
     } catch (error) {
       Print.error(`Error installing component: ${error.message}`);
@@ -659,7 +657,7 @@ async function getComponents(componentNames = [], options = {}) {
     );
 
     try {
-      await registry.installMultipleComponents(normalizedComponents, category, options.force);
+      await sharedRegistry.installMultipleComponents(normalizedComponents, category, options.force);
       return true;
     } catch (error) {
       Print.error(`Error installing components: ${error.message}`);
@@ -670,11 +668,9 @@ async function getComponents(componentNames = [], options = {}) {
 
 // List components function
 async function listComponents() {
-  const registry = new ComponentRegistry();
-  
   try {
-    await registry.loadRegistry();
-    registry.displayAvailableComponents();
+    await sharedRegistry.loadRegistry();
+    sharedRegistry.displayAvailableComponents();
     return true;
   } catch (error) {
     Print.error('Could not load component registry from official repository');
@@ -685,11 +681,9 @@ async function listComponents() {
 
 // Sync components function
 async function syncComponents(options = {}) {
-  const registry = new ComponentRegistry();
-  
   try {
-    await registry.loadRegistry();
-    return await registry.updateAllComponents(options.force);
+    await sharedRegistry.loadRegistry();
+    return await sharedRegistry.updateAllComponents(options.force);
   } catch (error) {
     Print.error('Could not load component registry from official repository');
     Print.info('Check your internet connection and try again');

package/commands/init/init.js

@@ -193,6 +193,7 @@ export default async function initializeProject(options = {}) {
             } else {
                 fwSpinner.fail('Failed to ensure latest slicejs-web-framework');
                 Print.error(err.message);
+                console.error(err.stack);
                 return;
             }
         }
@@ -233,6 +234,7 @@ export default async function initializeProject(options = {}) {
             if (fs.existsSync(destinationSrc)) throw new Error(`The "src" directory already exists: ${destinationSrc}`);
         } catch (error) {
             Print.error('Validating destination directories:', error.message);
+            console.error(error.stack);
             return;
         }
 
@@ -245,6 +247,7 @@ export default async function initializeProject(options = {}) {
         } catch (error) {
             apiSpinner.fail('Error copying API structure');
             Print.error(error.message);
+            console.error(error.stack);
             return;
         }
 
@@ -296,6 +299,7 @@ export default async function initializeProject(options = {}) {
         } catch (error) {
             srcSpinner.fail('Error creating source structure');
             Print.error(error.message);
+            console.error(error.stack);
             return;
         }
 
@@ -412,7 +416,7 @@ export default async function initializeProject(options = {}) {
             pkg.scripts['browse'] = SLICE_SCRIPTS['slice:browse'];
             pkg.scripts['sync'] = SLICE_SCRIPTS['slice:sync'];
 
-            // slice:* namespaced set — shared with post.js and `slice postinstall`
+            // slice:* namespaced set — shared with `slice postinstall`
             // (commands/utils/sliceScripts.js) so the three never drift apart.
             Object.assign(pkg.scripts, SLICE_SCRIPTS);
             pkg.scripts['run'] = SLICE_SCRIPTS['slice:dev'];
@@ -437,6 +441,7 @@ export default async function initializeProject(options = {}) {
         } catch (error) {
         pkgSpinner.fail('Failed to configure npm scripts');
         Print.error(error.message);
+        console.error(error.stack);
         }
 
         const projectName = path.basename(process.cwd());
@@ -457,6 +462,7 @@ export default async function initializeProject(options = {}) {
 
     } catch (error) {
         Print.error('Unexpected error initializing project:', error.message);
+        console.error(error.stack);
     }
 }
 

package/commands/startServer/startServer.js

@@ -6,23 +6,10 @@ import { spawn } from 'child_process';
 import { createServer } from 'net';
 import setupWatcher, { stopWatcher } from './watchServer.js';
 import Print from '../Print.js';
-import { getConfigPath, getApiPath, getSrcPath, getDistPath, getPath } from '../utils/PathHelper.js';
+import { getApiPath, getSrcPath, getDistPath, getPath } from '../utils/PathHelper.js';
+import { loadConfigSync } from '../utils/loadConfig.js';
 import build from '../build/build.js';
 
-/**
- * Loads configuration from sliceConfig.json
- */
-const loadConfig = () => {
-  try {
-    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}`);
-    return null;
-  }
-};
-
 /**
  * Checks if a port is available
  */
@@ -144,20 +131,6 @@ function startNodeServer(port, mode) {
       }
     });
 
-    // Manejar Ctrl+C
-    process.on('SIGINT', () => {
-      Print.newLine();
-      Print.info('Shutting down server...');
-      serverProcess.kill('SIGINT');
-      setTimeout(() => {
-        process.exit(0);
-      }, 100);
-    });
-
-    process.on('SIGTERM', () => {
-      serverProcess.kill('SIGTERM');
-    });
-
     // If after 3 seconds we haven't detected startup, assume it's ready
     setTimeout(() => {
       if (!serverStarted) {
@@ -169,11 +142,25 @@ function startNodeServer(port, mode) {
   });
 }
 
+let currentServerProcess = null;
+let currentWatcher = null;
+
+process.on('SIGINT', () => shutdown());
+process.on('SIGTERM', () => shutdown());
+
+function shutdown() {
+  Print.newLine();
+  Print.info('Shutting down server...');
+  if (currentWatcher) stopWatcher(currentWatcher);
+  if (currentServerProcess) currentServerProcess.kill('SIGINT');
+  setTimeout(() => process.exit(0), 100);
+}
+
 /**
  * Main function to start the server
  */
 export default async function startServer(options = {}) {
-  const config = loadConfig();
+  const config = loadConfigSync(import.meta.url);
   const defaultPort = config?.server?.port || 3000;
 
   const { mode = 'development', port = defaultPort, watch = false } = options;
@@ -217,14 +204,14 @@ export default async function startServer(options = {}) {
     Print.newLine();
 
     // Start the server with arguments
-    let serverProcess = await startNodeServer(actualPort, mode);
+    currentServerProcess = await startNodeServer(actualPort, mode);
 
     // Configure watch mode if enabled
     if (watch) {
       Print.newLine();
-      const watcher = setupWatcher(serverProcess, async (changedPath) => {
-        if (serverProcess) {
-             serverProcess.kill();
+      currentWatcher = setupWatcher(currentServerProcess, async (changedPath) => {
+        if (currentServerProcess) {
+             currentServerProcess.kill();
         }
         
         // Short delay to ensure port is freed
@@ -233,19 +220,11 @@ export default async function startServer(options = {}) {
         try {
         Print.info('🔄 File changed. Restarting server...');
 
-          serverProcess = await startNodeServer(actualPort, mode);
+          currentServerProcess = await startNodeServer(actualPort, mode);
         } catch (e) {
           Print.error(`Failed to restart server: ${e.message}`);
         }
       });
-
-      // Cleanup en exit
-      const cleanup = () => {
-        stopWatcher(watcher);
-      };
-
-      process.on('SIGINT', cleanup);
-      process.on('SIGTERM', cleanup);
     }
 
   } catch (error) {

package/commands/types/types.js

@@ -345,6 +345,9 @@ const generateDeclarationContent = (componentPropsMap) => {
   lines.push('      name: K,');
   lines.push('      props?: SliceComponentPropsMap[K]');
   lines.push('    ): Promise<SliceDynamicElement | null>;');
+  lines.push('    getComponent<K extends SliceComponentName>(');
+  lines.push('      componentSliceId: K | `${K}-${string}`');
+  lines.push('    ): SliceDynamicElement | undefined;');
   lines.push('    getComponent<T extends SliceDynamicElement = SliceDynamicElement>(');
   lines.push('      componentSliceId: string');
   lines.push('    ): T | undefined;');

package/commands/utils/sliceScripts.js

@@ -1,9 +1,35 @@
 // commands/utils/sliceScripts.js
 //
 // Single source of truth for the slice:* package scripts configured by the CLI.
-// Used by post.js (the postinstall hook), the `slice postinstall` command in
+// Used by the `slice postinstall` command in
 // client.js, and `slice init` — so the three can never drift apart (they did:
 // client.js was missing slice:types, and none of them had slice:build).
+
+import fs from 'fs';
+
+/**
+ * Reads a project's package.json and verifies it contains all SLICE_SCRIPTS.
+ * Returns { missing: string[] } where each entry is the script name not found.
+ */
+export function verifySliceScriptsInPackageJson(pkgPath) {
+  const missing = [];
+  try {
+    if (!fs.existsSync(pkgPath)) {
+      return { missing: Object.keys(SLICE_SCRIPTS) };
+    }
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    const scripts = pkg.scripts || {};
+    for (const script of Object.keys(SLICE_SCRIPTS)) {
+      if (!scripts[script]) {
+        missing.push(script);
+      }
+    }
+  } catch {
+    return { missing: Object.keys(SLICE_SCRIPTS) };
+  }
+  return { missing };
+}
+
 export const SLICE_SCRIPTS = {
   'slice:init': 'node ./node_modules/slicejs-cli/client.js init',
   'slice:dev': 'node ./node_modules/slicejs-cli/client.js dev',
@@ -18,6 +44,5 @@ export const SLICE_SCRIPTS = {
   'slice:doctor': 'node ./node_modules/slicejs-cli/client.js doctor',
   'slice:version': 'node ./node_modules/slicejs-cli/client.js version',
   'slice:help': 'node ./node_modules/slicejs-cli/client.js --help',
-  'slice:update': 'node ./node_modules/slicejs-cli/client.js update',
   'slice:types': 'node ./node_modules/slicejs-cli/client.js types generate',
 };

package/commands/utils/updateManager.js

@@ -117,7 +117,7 @@ export class UpdateManager {
         }
 
         this.displayUpdates(updateInfo);
-        Print.info("Run 'slice update' to install updates when convenient.");
+        Print.info("Use your package manager to install updates: npm/pnpm update slicejs-cli slicejs-web-framework");
         return true;
     }
 
@@ -434,7 +434,7 @@ export class UpdateManager {
             let confirmUpdate = options.updateApi === true;
             if (!confirmUpdate && options.yes === true) {
                 Print.info('Skipping api/index.js update (not updated by default).');
-                Print.info('Run "slice update --update-api" to update it (a .bak backup is created).');
+                Print.info('Use --update-api to overwrite api/index.js from the framework template.');
                 return;
             }
             if (!confirmUpdate) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "slicejs-cli",
-  "version": "3.6.4",
+  "version": "3.6.5",
   "description": "Command client for developing web applications with Slice.js framework",
   "main": "client.js",
   "bin": {
@@ -11,7 +11,6 @@
   },
   "files": [
     "client.js",
-    "post.js",
     "commands",
     "assets"
   ],
@@ -21,7 +20,6 @@
   },
   "scripts": {
     "test": "node --test",
-    "postinstall": "node post.js",
     "slice:dev": "slice dev",
     "slice:build": "slice build",
     "slice:start": "slice start",
@@ -33,7 +31,6 @@
     "slice:browse": "slice browse",
     "slice:sync": "slice sync",
     "slice:version": "slice version",
-    "slice:update": "slice update",
     "slice:types": "slice types generate",
     "slice:doctor": "node ./node_modules/slicejs-cli/client.js doctor",
     "slice:help": "node ./node_modules/slicejs-cli/client.js --help"
@@ -71,4 +68,4 @@
   "devDependencies": {
     "@playwright/test": "^1.60.0"
   }
-}
+}

package/post.js

@@ -1,60 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { getProjectRoot, getPath } from './commands/utils/PathHelper.js';
-import { SLICE_SCRIPTS } from './commands/utils/sliceScripts.js';
-import { resolvePackageManager, runScriptCommand } from './commands/utils/PackageManager.js';
-
-const __filename = fileURLToPath(import.meta.url);
-
-// npm sets npm_config_global; pnpm does not — for pnpm a global install lives
-// under PNPM_HOME, so detect it by where this script is running from.
-const pnpmHome = process.env.PNPM_HOME;
-const isGlobal = process.env.npm_config_global === 'true'
-    || (pnpmHome && __filename.startsWith(pnpmHome));
-
-if (isGlobal) {
-    console.log('⚠️  Global installation of slicejs-cli detected.');
-    console.log('   We strongly recommend using a local installation to avoid version mismatches.');
-    console.log(`   Uninstall global: ${pnpmHome ? 'pnpm remove -g slicejs-cli' : 'npm uninstall -g slicejs-cli'}`);
-    process.exit(0);
-}
-
-const projectRoot = getProjectRoot(import.meta.url);
-const pkgPath = getPath(import.meta.url, 'package.json');
-const packageManager = resolvePackageManager(projectRoot).name;
-
-const sliceScripts = SLICE_SCRIPTS;
-
-try {
-    let pkg = {};
-    if (fs.existsSync(pkgPath)) {
-        pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-    } else {
-        pkg = {
-            name: path.basename(projectRoot),
-            version: '1.0.0',
-            description: 'Slice.js project',
-            scripts: {}
-        };
-    }
-
-    pkg.scripts = pkg.scripts || {};
-    let addedCount = 0;
-    for (const [script, command] of Object.entries(sliceScripts)) {
-        if (!pkg.scripts[script]) {
-            pkg.scripts[script] = command;
-            addedCount++;
-        }
-    }
-
-    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2), 'utf-8');
-    console.log(`✅  slicejs-cli installed successfully. Added ${addedCount} package scripts to package.json.`);
-    console.log(`   Run: ${runScriptCommand(packageManager, 'slice:dev')}`);
-} catch (err) {
-    console.log('✅  slicejs-cli installed successfully.');
-    console.log('   Could not auto-configure scripts:', err.message);
-    console.log(`   Configure scripts manually and run: ${runScriptCommand(packageManager, 'slice:dev')}`);
-}
-
-process.exit(0);