feat(create): improve UX when running vp create from monorepo subdirectories

When a user runs `vp create` from a subdirectory of a monorepo, the
command auto-detects the workspace root and creates packages relative to
that root. This can be confusing since the user expects location-awareness.

Changes:
- Show "Detected monorepo root at <path>" info message when in a subdir
- In interactive mode, add a "current directory" option to the parent dir
  selector when the user's cwd is not under a standard workspace pattern
  dir, and default to it
- In non-interactive mode, show a hint about using --directory
- Add snap test covering all edge cases: workspace subdir, workspace
  parent dir, non-workspace dir, and --directory from a subdir

Author: fengmk2

packages/cli/snap-tests-global/create-from-monorepo-subdir/apps/website/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "website",
+  "version": "0.0.0"
+}

packages/cli/snap-tests-global/create-from-monorepo-subdir/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "test-monorepo",
+  "version": "0.0.0",
+  "private": true,
+  "packageManager": "pnpm@10.12.1"
+}

packages/cli/snap-tests-global/create-from-monorepo-subdir/pnpm-workspace.yaml

@@ -0,0 +1,4 @@
+packages:
+  - apps/*
+  - packages/*
+  - tools/*

packages/cli/snap-tests-global/create-from-monorepo-subdir/scripts/helper/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "helper",
+  "version": "0.0.0"
+}

packages/cli/snap-tests-global/create-from-monorepo-subdir/snap.txt

@@ -0,0 +1,21 @@
+> cd apps/website && vp create --no-interactive vite:generator # from workspace subdir
+> test -f tools/vite-plus-generator/package.json && echo 'Created at tools/vite-plus-generator' || echo 'NOT at tools/'
+Created at tools/vite-plus-generator
+
+> test ! -f apps/website/tools/vite-plus-generator/package.json && echo 'Not in apps/website/' || echo 'BUG: in apps/website/'
+Not in apps/website/
+
+> cd apps && vp create --no-interactive vite:application # from workspace parent dir
+> test -f apps/vite-plus-application/package.json && echo 'Created at apps/vite-plus-application' || echo 'NOT at apps/'
+Created at apps/vite-plus-application
+
+> cd scripts/helper && vp create --no-interactive vite:library # from non-workspace dir
+> test -f packages/vite-plus-library/package.json && echo 'Created at packages/vite-plus-library' || echo 'NOT at packages/'
+Created at packages/vite-plus-library
+
+> test ! -f scripts/helper/packages/vite-plus-library/package.json && echo 'Not in scripts/helper/' || echo 'BUG: in scripts/helper/'
+Not in scripts/helper/
+
+> cd scripts/helper && vp create --no-interactive vite:application --directory apps/custom-app # --directory from non-workspace dir
+> test -f apps/custom-app/package.json && echo 'Created at apps/custom-app with --directory' || echo 'NOT at apps/custom-app'
+Created at apps/custom-app with --directory

packages/cli/snap-tests-global/create-from-monorepo-subdir/steps.json

@@ -0,0 +1,29 @@
+{
+  "commands": [
+    {
+      "command": "cd apps/website && vp create --no-interactive vite:generator # from workspace subdir",
+      "ignoreOutput": true
+    },
+    "test -f tools/vite-plus-generator/package.json && echo 'Created at tools/vite-plus-generator' || echo 'NOT at tools/'",
+    "test ! -f apps/website/tools/vite-plus-generator/package.json && echo 'Not in apps/website/' || echo 'BUG: in apps/website/'",
+
+    {
+      "command": "cd apps && vp create --no-interactive vite:application # from workspace parent dir",
+      "ignoreOutput": true
+    },
+    "test -f apps/vite-plus-application/package.json && echo 'Created at apps/vite-plus-application' || echo 'NOT at apps/'",
+
+    {
+      "command": "cd scripts/helper && vp create --no-interactive vite:library # from non-workspace dir",
+      "ignoreOutput": true
+    },
+    "test -f packages/vite-plus-library/package.json && echo 'Created at packages/vite-plus-library' || echo 'NOT at packages/'",
+    "test ! -f scripts/helper/packages/vite-plus-library/package.json && echo 'Not in scripts/helper/' || echo 'BUG: in scripts/helper/'",
+
+    {
+      "command": "cd scripts/helper && vp create --no-interactive vite:application --directory apps/custom-app # --directory from non-workspace dir",
+      "ignoreOutput": true
+    },
+    "test -f apps/custom-app/package.json && echo 'Created at apps/custom-app with --directory' || echo 'NOT at apps/custom-app'"
+  ]
+}

packages/cli/src/create/bin.ts

@@ -15,6 +15,7 @@ import {
   selectAgentTargetPath,
   writeAgentInstructions,
 } from '../utils/agent.js';
+import { displayRelative } from '../utils/path.js';
 import {
   defaultInteractive,
   downloadPackageManager,
@@ -184,8 +185,20 @@ Use \`vp create --list\` to list all available templates, or run \`vp create --h
     packageName = formatted.packageName;
   }
 
-  const workspaceInfoOptional = await detectWorkspace(process.cwd());
+  const cwd = process.cwd();
+  const workspaceInfoOptional = await detectWorkspace(cwd);
   const isMonorepo = workspaceInfoOptional.isMonorepo;
+  const cwdRelativeToRoot =
+    isMonorepo && workspaceInfoOptional.rootDir !== cwd
+      ? displayRelative(cwd, workspaceInfoOptional.rootDir)
+      : '';
+  const isInSubdirectory = cwdRelativeToRoot !== '';
+  const cwdUnderParentDir = isInSubdirectory
+    ? workspaceInfoOptional.parentDirs.some(
+        (dir) => cwdRelativeToRoot === dir || cwdRelativeToRoot.startsWith(`${dir}/`),
+      )
+    : true;
+  const shouldOfferCwdOption = isInSubdirectory && !cwdUnderParentDir;
 
   // Interactive mode: prompt for template if not provided
   let selectedTemplateName = templateName as string;
@@ -287,27 +300,44 @@ Use \`vp create --list\` to list all available templates, or run \`vp create --h
     cancelAndExit('Cannot create a monorepo inside an existing monorepo', 1);
   }
 
+  if (isInSubdirectory) {
+    prompts.log.info(`Detected monorepo root at ${accent(workspaceInfoOptional.rootDir)}`);
+  }
+
   if (isMonorepo && options.interactive && !targetDir) {
     let parentDir: string | undefined;
-    if (workspaceInfoOptional.parentDirs.length > 0) {
-      const defaultParentDir =
-        inferParentDir(selectedTemplateName, workspaceInfoOptional) ??
-        workspaceInfoOptional.parentDirs[0];
+    const hasParentDirs = workspaceInfoOptional.parentDirs.length > 0;
+
+    if (hasParentDirs || isInSubdirectory) {
+      const dirOptions: { label: string; value: string; hint: string }[] =
+        workspaceInfoOptional.parentDirs.map((dir) => ({
+          label: `${dir}/`,
+          value: dir,
+          hint: '',
+        }));
+
+      if (shouldOfferCwdOption) {
+        dirOptions.push({
+          label: `${cwdRelativeToRoot}/ (current directory)`,
+          value: cwdRelativeToRoot,
+          hint: '',
+        });
+      }
+
+      dirOptions.push({
+        label: 'other',
+        value: 'other',
+        hint: 'Enter a custom target directory',
+      });
+
+      const defaultParentDir = shouldOfferCwdOption
+        ? cwdRelativeToRoot
+        : (inferParentDir(selectedTemplateName, workspaceInfoOptional) ??
+          workspaceInfoOptional.parentDirs[0]);
+
       const selected = await prompts.select({
         message: 'Where should the new package be added to the monorepo:',
-        options: workspaceInfoOptional.parentDirs
-          .map((dir) => ({
-            label: `${dir}/`,
-            value: dir,
-            hint: ``,
-          }))
-          .concat([
-            {
-              label: 'other',
-              value: 'other',
-              hint: 'Enter a custom target directory',
-            },
-          ]),
+        options: dirOptions,
         initialValue: defaultParentDir,
       });
 
@@ -339,6 +369,9 @@ Use \`vp create --list\` to list all available templates, or run \`vp create --h
     selectedParentDir = parentDir;
   }
   if (isMonorepo && !options.interactive && !targetDir) {
+    if (isInSubdirectory) {
+      prompts.log.info(`Use ${accent('--directory')} to specify a different target location.`);
+    }
     const inferredParentDir =
       inferParentDir(selectedTemplateName, workspaceInfoOptional) ??
       workspaceInfoOptional.parentDirs[0];