@sanity/cli 3.92.1-next.33.d62ed552cc → 3.92.1-next.34.408c5e3892

package/lib/_chunks-cjs/cli.js

@@ -3792,6 +3792,9 @@ Examples:
   # Add a Function with a specific type
   sanity blueprints add function --fn-type document-publish
 
+  # Add a Function using an example
+  sanity blueprints add function --example example-name
+
   # Add a JavaScript Function
   sanity blueprints add function --js
 
@@ -3810,7 +3813,25 @@ Examples:
   signature: "<type> [--name <name>] [--fn-type <document-publish>] [--fn-lang <ts|js>] [--javascript]",
   description: "Add a Resource to a Blueprint",
   async action(args, context) {
-    const { output, apiClient } = context, flags = { ...defaultFlags$b, ...args.extOptions }, client2 = apiClient({
+    const { output, apiClient } = context, { extOptions } = args;
+    if (extOptions.example) {
+      const foundConflict = [
+        "name",
+        "n",
+        "fn-type",
+        "fn-language",
+        "lang",
+        "javascript",
+        "js",
+        "fn-helpers",
+        "helpers",
+        "fn-installer",
+        "installer"
+      ].find((key2) => extOptions[key2]);
+      if (foundConflict)
+        throw new Error(`--example can't be used with --${foundConflict}`);
+    }
+    const flags = { ...defaultFlags$b, ...extOptions }, client2 = apiClient({
       requireUser: !0,
       requireProject: !1
     }), { token: token2 } = client2.config();
@@ -3832,6 +3853,7 @@ Examples:
       ...cmdConfig.value,
       args: { type: resourceType },
       flags: {
+        example: flags.example,
         name: flags.n ?? flags.name,
         "fn-type": flags["fn-type"],
         language: flags.lang ?? flags["fn-language"],
@@ -4020,11 +4042,14 @@ Options
   --project-id <id>                  Project ID to use
 
 Examples:
-  # Create a new Blueprint manifest file in the current directory
+  # Create a new Blueprint project in the current directory
   sanity blueprints init
 
-  # Create a new Blueprint manifest file in a specific directory
+  # Create a new Blueprint project in a specific directory
   sanity blueprints init my-sanity-project --type json
+
+  # Create a new Blueprint project in a specific directory with an example
+  sanity blueprints init --example example-name
 `, defaultFlags$6 = {
   //
 }, initBlueprintsCommand = {
@@ -4039,7 +4064,21 @@ Examples:
       requireProject: !1
     }), { token: token2 } = client2.config();
     if (!token2) throw new Error("No API token found. Please run `sanity login`.");
-    const { blueprintInitCore } = await import("@sanity/runtime-cli/cores/blueprints"), { success, error: error2 } = await blueprintInitCore({
+    const { blueprintInitCore } = await import("@sanity/runtime-cli/cores/blueprints");
+    if (flags.example) {
+      const foundConflict = [
+        "blueprint-type",
+        "type",
+        "stack-id",
+        "stackId",
+        "stack",
+        "stack-name",
+        "name"
+      ].find((key2) => flags[key2]);
+      if (foundConflict)
+        throw new Error(`--example can't be used with --${foundConflict}`);
+    }
+    const { success, error: error2 } = await blueprintInitCore({
       bin: "sanity",
       log: (message) => output.print(message),
       token: token2,
@@ -4047,6 +4086,7 @@ Examples:
         dir: dir ?? flags.dir
       },
       flags: {
+        example: flags.example,
         "blueprint-type": flags["blueprint-type"] ?? flags.type,
         "project-id": flags["project-id"] ?? flags.projectId ?? flags.project,
         "stack-id": flags["stack-id"] ?? flags.stackId ?? flags.stack,
@@ -23522,23 +23562,23 @@ async function installDeclaredPackages(cwd, packageManager, context) {
     encoding: "utf8",
     env: getPartialEnvWithNpmPath(cwd),
     cwd,
-    stdio: "inherit"
-  }, npmArgs = ["install", "--legacy-peer-deps"];
+    stdio: "pipe"
+  };
   let result;
-  if (packageManager === "npm")
-    output.print(`Running 'npm ${npmArgs.join(" ")}'`), result = await execa("npm", npmArgs, execOptions);
-  else if (packageManager === "yarn") {
-    const yarnArgs = ["install"];
-    output.print(`Running 'yarn ${yarnArgs.join(" ")}'`), result = await execa("yarn", yarnArgs, execOptions);
-  } else if (packageManager === "pnpm") {
-    const pnpmArgs = ["install"];
-    output.print(`Running 'pnpm ${pnpmArgs.join(" ")}'`), result = await execa("pnpm", pnpmArgs, execOptions);
-  } else if (packageManager === "bun") {
-    const bunArgs = ["install"];
-    output.print(`Running 'bun ${bunArgs.join(" ")}'`), result = await execa("bun", bunArgs, execOptions);
-  } else packageManager === "manual" && output.print(`Manual installation selected - run 'npm ${npmArgs.join(" ")}' or similar`);
-  if (result?.exitCode || result?.failed)
-    throw new Error("Dependency installation failed");
+  const installerArgs = {
+    npm: ["install", "--legacy-peer-deps"],
+    yarn: ["install"],
+    pnpm: ["install"],
+    bun: ["install"]
+  };
+  async function handleInstall(cmd, args) {
+    const progress = output.spinner(`Running ${cmd} ${args.join(" ")}
+`).start();
+    if (result = await execa(cmd, args, execOptions), result?.exitCode || result?.failed)
+      throw progress.fail(), output.print(result.stdout), new Error("Dependency installation failed");
+    progress.succeed();
+  }
+  packageManager === "manual" ? output.print(`Manual installation selected \u2014 run 'npm ${installerArgs.npm} or equivalent'`) : await handleInstall(packageManager, installerArgs[packageManager]);
 }
 async function installNewPackages(options2, context) {
   const { packageManager, packages } = options2, { output, workDir } = context, execOptions = {
@@ -53696,18 +53736,15 @@ ${chalk2.green("Success!")} Your Sanity configuration files has been added to th
     pnpm: "pnpm dev",
     bun: "bun dev",
     manual: "npm run dev"
-  }[pkgManager];
-  outputPath === process.cwd() ? (print(`
-${chalk2.green("Success!")} Now, use this command to continue:
-`), print(
-    `${chalk2.cyan(devCommand)} - to run ${isAppTemplate ? "your Sanity application" : "Sanity Studio"}
-`
-  )) : (print(`
-${chalk2.green("Success!")} Now, use these commands to continue:
-`), print(`First: ${chalk2.cyan(`cd ${outputPath}`)} - to enter project's directory`), print(
-    `Then: ${chalk2.cyan(devCommand)} -to run ${isAppTemplate ? "your Sanity application" : "Sanity Studio"}
-`
-  )), print("Other helpful commands"), print("npx sanity docs - to open the documentation in a browser"), print("npx sanity manage - to open the project settings in a browser"), print("npx sanity help - to explore the CLI manual"), isFirstProject && (trace.log({ step: "sendCommunityInvite", selectedOption: "yes" }), print(`
+  }[pkgManager], isCurrentDir = outputPath === process.cwd(), goToProjectDir = `(${chalk2.cyan(`cd ${outputPath}`)} to navigate to your new project directory)`;
+  isAppTemplate ? (print(`\u2705 ${chalk2.green.bold("Success!")} Your custom app has been scaffolded.`), isCurrentDir || print(goToProjectDir), print(
+    `
+${chalk2.bold("Next")}, configure the project(s) and dataset(s) your app should work with.`
+  ), print("\nGet started in `src/App.tsx`, or refer to our documentation for a walkthrough:"), print(chalk2.blue.underline("https://www.sanity.io/docs/app-sdk/sdk-configuration")), print(`
+`), print("Other helpful commands:"), print("npx sanity docs       to open the documentation in a browser"), print("npx sanity dev        to start the development server for your app"), print("npx sanity deploy     to deploy your app")) : (print(`\u2705 ${chalk2.green.bold("Success!")} Your Studio has been created.`), isCurrentDir || print(goToProjectDir), print(
+    `Get started by running ${chalk2.cyan(devCommand)} to launch your Studio\u2019s development server`
+  ), print(`
+`), print("Other helpful commands:"), print("npx sanity docs     to open the documentation in a browser"), print("npx sanity manage   to open the project settings in a browser"), print("npx sanity help     to explore the CLI manual")), isFirstProject && (trace.log({ step: "sendCommunityInvite", selectedOption: "yes" }), print(`
 Join our wonderful developer community as well: ${chalk2.cyan("https://snty.link/community")}`), print(`We look forward to seeing you there!
 `)), trace.complete();
   async function getOrCreateUser() {
@@ -79649,7 +79686,10 @@ async function runCli(cliRoot, { cliVersion }) {
     await flushTelemetry();
     const error2 = typeof err.details == "string" ? err.details : err;
     console.error(`
-${error2.stack ? neatStack(err) : error2}`), cliCommandTrace.error(error2), process.exit(1);
+${error2.stack ? neatStack(err) : error2}`), err.cause && console.error(`
+Caused by:
+
+${err.cause.stack ? neatStack(err.cause) : err.cause}`), cliCommandTrace.error(error2), process.exit(1);
   });
 }
 async function getCoreModulePath(workDir, cliConfig) {