slicejs-cli 2.9.5 → 3.0.2

package/README.md

@@ -45,6 +45,29 @@ npm run dev
 npm run slice -- get Button
 ```
 
+4. Use `slice` directly when the launcher command is available on your system
+   (commonly after a global install that puts `slice` in your PATH).
+   The launcher delegates to your nearest project-local `node_modules/slicejs-cli`
+   so project-pinned behavior is used from the project root and subdirectories.
+
+```bash
+slice dev
+slice build
+slice version
+```
+
+If `slice` is not available in your shell, use:
+
+```bash
+npx slicejs-cli dev
+```
+
+You can disable launcher delegation for a command when needed:
+
+```bash
+SLICE_NO_LOCAL_DELEGATION=1 slice version
+```
+
 ### Global (Not Recommended)
 
 Global installations can lead to version mismatches and "works on my machine" issues.
@@ -55,7 +78,10 @@ npm install -g slicejs-cli
 
 ## Usage
 
-After installation, you can use the `slice` command directly:
+After installation, prefer your project-local CLI. When the `slice` launcher command is
+available, it automatically delegates to the nearest local `slicejs-cli` install.
+
+Use the `slice` command directly:
 
 ```bash
 slice [command] [options]
@@ -67,6 +93,8 @@ Or with npx (without global install):
 npx slicejs-cli [command]
 ```
 
+Use `npx slicejs-cli [command]` as a fallback when the `slice` launcher command is unavailable.
+
 ## Essential Commands
 
 ### Initialize a project
@@ -154,7 +182,7 @@ slice sync
 ```bash
 # Version info
 slice version
-slice -v
+slice v
 
 # Updates (CLI and Framework)
 slice update              # Check and prompt to update
@@ -325,16 +353,16 @@ slice init
 ### Command not found
 
 ```bash
-# Use npx if not installed globally
+# If the launcher command is unavailable, run the local CLI via npx
 npx slicejs-cli dev
 
-# Or install globally
+# Optional: install globally to expose the slice launcher command
 npm install -g slicejs-cli
 ```
 
 ## Links
 
-- 📘 Documentation: https://slice-js-docs.vercel.app/
+- 📘 CLI Documentation: https://slice-js-docs.vercel.app/Documentation/CLI
 - 🐙 GitHub: https://github.com/VKneider/slice-cli
 - 📦 npm: https://www.npmjs.com/package/slicejs-cli
 

package/client.js

@@ -14,12 +14,18 @@ import fs from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
 import { getConfigPath, getProjectRoot } from "./commands/utils/PathHelper.js";
-import { exec } from "child_process";
+import { exec, spawnSync } from "node:child_process";
 import { promisify } from "util";
 import validations from "./commands/Validations.js";
 import Print from "./commands/Print.js";
 import build from './commands/build/build.js';
 import { cleanBundles, bundleInfo } from './commands/bundle/bundle.js';
+import {
+  isLocalDelegationDisabled,
+  findNearestLocalCliEntry,
+  resolveLocalCliCandidate,
+  shouldDelegateToLocalCli
+} from './commands/utils/LocalCliDelegation.js';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -84,10 +90,7 @@ async function runWithVersionCheck(commandFunction, ...args) {
       } catch {}
     })();
 
-    const updateInfo = await updateManager.checkForUpdates();
-    if (updateInfo && updateInfo.hasUpdates) {
-      await updateManager.checkAndPromptUpdates({});
-    }
+    updateManager.notifyAvailableUpdates().catch(() => {});
 
     const result = await commandFunction(...args);
 
@@ -102,6 +105,33 @@ async function runWithVersionCheck(commandFunction, ...args) {
   }
 }
 
+function maybeDelegateToLocalCli() {
+  if (isLocalDelegationDisabled(process.env)) {
+    return;
+  }
+
+  const currentEntryPath = fileURLToPath(import.meta.url);
+  const localEntryPath = findNearestLocalCliEntry(process.cwd(), resolveLocalCliCandidate);
+
+  if (!shouldDelegateToLocalCli(currentEntryPath, localEntryPath)) {
+    return;
+  }
+
+  const child = spawnSync(
+    process.execPath,
+    [localEntryPath, ...process.argv.slice(2)],
+    {
+      stdio: 'inherit',
+      cwd: process.cwd(),
+      env: process.env
+    }
+  );
+
+  process.exit(child.status ?? 1);
+}
+
+maybeDelegateToLocalCli();
+
 const sliceClient = program;
 
 try {

package/commands/utils/LocalCliDelegation.js

@@ -0,0 +1,53 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+function getParentDirectory(dir) {
+  const parent = path.dirname(dir);
+  return parent === dir ? null : parent;
+}
+
+export function isLocalDelegationDisabled(env = process.env) {
+  return env.SLICE_NO_LOCAL_DELEGATION === '1';
+}
+
+export function findNearestLocalCliEntry(startDirectory, resolveCandidate) {
+  if (!startDirectory || typeof resolveCandidate !== 'function') {
+    return null;
+  }
+
+  let current = path.resolve(startDirectory);
+  while (current) {
+    const candidate = resolveCandidate(current);
+    if (candidate) {
+      return candidate;
+    }
+    current = getParentDirectory(current);
+  }
+
+  return null;
+}
+
+export function resolveLocalCliCandidate(directory) {
+  const candidate = path.join(directory, 'node_modules', 'slicejs-cli', 'client.js');
+
+  try {
+    const stats = fs.statSync(candidate);
+    return stats.isFile() ? candidate : null;
+  } catch {
+    return null;
+  }
+}
+
+export function shouldDelegateToLocalCli(currentEntryPath, localEntryPath) {
+  if (!localEntryPath) {
+    return false;
+  }
+
+  try {
+    const currentReal = fs.realpathSync(currentEntryPath);
+    const localReal = fs.realpathSync(localEntryPath);
+    return currentReal !== localReal;
+  } catch {
+    return path.resolve(currentEntryPath) !== path.resolve(localEntryPath);
+  }
+}