sanity 3.26.2-canary.52 → 3.26.2-canary.69

package/lib/_chunks/{_internal-2CJ5wSKF.js → _internal-6Pl2wJGj.js}

@@ -41,7 +41,8 @@ var deburr = require('lodash/deburr');
 var mkdirp = require('mkdirp');
 var node = require('esbuild-register/dist/node');
 var migrate = require('@sanity/migrate');
-var PathUtils = require('@sanity/util/paths');
+var tty = require('tty');
+var sanity = require('sanity');
 function _interopDefaultCompat(e) {
   return e && typeof e === 'object' && 'default' in e ? e : {
     default: e
@@ -76,7 +77,7 @@ var size__default = /*#__PURE__*/_interopDefaultCompat(size);
 var fs__default$2 = /*#__PURE__*/_interopDefaultCompat(fs$3);
 var deburr__default = /*#__PURE__*/_interopDefaultCompat(deburr);
 var mkdirp__default = /*#__PURE__*/_interopDefaultCompat(mkdirp);
-const helpText$s = "\nOptions\n  --source-maps Enable source maps for built bundles (increases size of bundle)\n  --no-minify Skip minifying built JavaScript (speeds up build, increases size of bundle)\n  -y, --yes Use unattended mode, accepting defaults and using only flags for choices\n\nExamples\n  sanity build\n  sanity build --no-minify --source-maps\n";
+const helpText$t = "\nOptions\n  --source-maps Enable source maps for built bundles (increases size of bundle)\n  --no-minify Skip minifying built JavaScript (speeds up build, increases size of bundle)\n  -y, --yes Use unattended mode, accepting defaults and using only flags for choices\n\nExamples\n  sanity build\n  sanity build --no-minify --source-maps\n";
 const buildCommand = {
   name: "build",
   signature: "[OUTPUT_DIR]",
@@ -85,7 +86,7 @@ const buildCommand = {
     const buildAction = await getBuildAction();
     return buildAction(args, context, overrides);
   },
-  helpText: helpText$s
+  helpText: helpText$t
 };
 async function getBuildAction() {
   const mod = await Promise.resolve().then(function () {
@@ -124,7 +125,7 @@ var datasetGroup = {
   isGroupRoot: true,
   description: "Interact with datasets in your project"
 };
-const helpText$r = "\nOptions\n  --source-maps Enable source maps for built bundles (increases size of bundle)\n  --no-minify Skip minifying built JavaScript (speeds up build, increases size of bundle)\n  --no-build Don't build the studio prior to deploy, instead deploying the version currently in `dist/`\n\nExamples\n  sanity deploy\n  sanity deploy --no-minify --source-maps\n";
+const helpText$s = "\nOptions\n  --source-maps Enable source maps for built bundles (increases size of bundle)\n  --no-minify Skip minifying built JavaScript (speeds up build, increases size of bundle)\n  --no-build Don't build the studio prior to deploy, instead deploying the version currently in `dist/`\n\nExamples\n  sanity deploy\n  sanity deploy --no-minify --source-maps\n";
 const deployCommand = {
   name: "deploy",
   signature: "[SOURCE_DIR] [--no-build]  [--source-maps] [--no-minify]",
@@ -135,9 +136,9 @@ const deployCommand = {
     });
     return mod.default(args, context);
   },
-  helpText: helpText$r
+  helpText: helpText$s
 };
-const helpText$q = "\nExamples\n  sanity undeploy\n";
+const helpText$r = "\nExamples\n  sanity undeploy\n";
 const undeployCommand = {
   name: "undeploy",
   signature: "",
@@ -148,7 +149,7 @@ const undeployCommand = {
     });
     return mod.default(args, context);
   },
-  helpText: helpText$q
+  helpText: helpText$r
 };
 const MAX_DATASET_NAME_LENGTH$1 = 64;
 function validateDatasetAliasName(datasetName) {
@@ -273,13 +274,13 @@ function promptForDatasetName(prompt) {
     ...options
   });
 }
-const helpText$p = "\nOptions\n  --visibility <mode> Set visibility for this dataset (public/private)\n\nExamples\n  sanity dataset create\n  sanity dataset create <name>\n  sanity dataset create <name> --visibility private\n";
+const helpText$q = "\nOptions\n  --visibility <mode> Set visibility for this dataset (public/private)\n\nExamples\n  sanity dataset create\n  sanity dataset create <name>\n  sanity dataset create <name> --visibility private\n";
 const allowedModes = ["private", "public", "custom"];
 const createDatasetCommand = {
   name: "create",
   group: "dataset",
   signature: "[NAME]",
-  helpText: helpText$p,
+  helpText: helpText$q,
   description: "Create a new dataset within your project",
   action: async (args, context) => {
     const {
@@ -389,7 +390,7 @@ const datasetVisibilityCommand = {
     output.print("Dataset visibility changed");
   }
 };
-const helpText$o = "\nOptions\n  --force Do not prompt for delete confirmation - forcefully delete\n\nExamples\n  sanity dataset delete\n  sanity dataset delete my-dataset\n  sanity dataset delete my-dataset --force\n";
+const helpText$p = "\nOptions\n  --force Do not prompt for delete confirmation - forcefully delete\n\nExamples\n  sanity dataset delete\n  sanity dataset delete my-dataset\n  sanity dataset delete my-dataset --force\n";
 function parseCliFlags$4(args) {
   return yargs__default.default(helpers.hideBin(args.argv || process.argv).slice(2)).option("force", {
     type: "boolean"
@@ -398,7 +399,7 @@ function parseCliFlags$4(args) {
 const deleteDatasetCommand = {
   name: "delete",
   group: "dataset",
-  helpText: helpText$o,
+  helpText: helpText$p,
   signature: "[datasetName]",
   description: "Delete a dataset within your project",
   action: async (args, context) => {
@@ -471,7 +472,7 @@ async function chooseDatasetPrompt(context) {
   return selected;
 }
 const noop = () => null;
-const helpText$n = "\nOptions\n  --raw                     Extract only documents, without rewriting asset references\n  --no-assets               Export only non-asset documents and remove references to image assets\n  --no-drafts               Export only published versions of documents\n  --no-compress             Skips compressing tarball entries (still generates a gzip file)\n  --types                   Defines which document types to export\n  --overwrite               Overwrite any file with the same name\n  --asset-concurrency <num> Concurrent number of asset downloads\n\nExamples\n  sanity dataset export moviedb localPath.tar.gz\n  sanity dataset export moviedb assetless.tar.gz --no-assets\n  sanity dataset export staging staging.tar.gz --raw\n  sanity dataset export staging staging.tar.gz --types products,shops\n";
+const helpText$o = "\nOptions\n  --raw                     Extract only documents, without rewriting asset references\n  --no-assets               Export only non-asset documents and remove references to image assets\n  --no-drafts               Export only published versions of documents\n  --no-compress             Skips compressing tarball entries (still generates a gzip file)\n  --types                   Defines which document types to export\n  --overwrite               Overwrite any file with the same name\n  --asset-concurrency <num> Concurrent number of asset downloads\n\nExamples\n  sanity dataset export moviedb localPath.tar.gz\n  sanity dataset export moviedb assetless.tar.gz --no-assets\n  sanity dataset export staging staging.tar.gz --raw\n  sanity dataset export staging staging.tar.gz --types products,shops\n";
 function parseFlags$1(rawFlags) {
   const flags = {};
   if (rawFlags.types) {
@@ -502,7 +503,7 @@ const exportDatasetCommand = {
   group: "dataset",
   signature: "[NAME] [DESTINATION]",
   description: "Export dataset to local filesystem as a gzipped tarball",
-  helpText: helpText$n,
+  helpText: helpText$o,
   action: async (args, context) => {
     const {
       apiClient,
@@ -612,7 +613,7 @@ async function getOutputPath(destination, dataset, prompt, flags) {
   return finalPath;
 }
 const yellow = str => "\x1B[33m".concat(str, "\x1B[39m");
-const helpText$m = '\nOptions\n  --missing On duplicate document IDs, skip importing document in question\n  --replace On duplicate document IDs, replace existing document with imported document\n  --allow-failing-assets Skip assets that cannot be fetched/uploaded\n  --replace-assets Skip reuse of existing assets\n  --skip-cross-dataset-references Skips references to other datasets\n\nRarely used options (should generally not be used)\n  --allow-assets-in-different-dataset Allow asset documents to reference different project/dataset\n\nExamples\n  # Import "moviedb.ndjson" from the current directory to the dataset called "moviedb"\n  sanity dataset import moviedb.ndjson moviedb\n\n  # Import "moviedb.tar.gz" from the current directory to the dataset called "moviedb",\n  # replacing any documents encountered that have the same document IDs\n  sanity dataset import moviedb.tar.gz moviedb --replace\n\n  # Import from a folder containing an ndjson file, such as an extracted tarball\n  # retrieved through "sanity dataset export".\n  sanity dataset import ~/some/folder moviedb\n\n  # Import from a remote URL. Will download and extract the tarball to a temporary\n  # location before importing it.\n  sanity dataset import https://some.url/moviedb.tar.gz moviedb --replace\n';
+const helpText$n = '\nOptions\n  --missing On duplicate document IDs, skip importing document in question\n  --replace On duplicate document IDs, replace existing document with imported document\n  --allow-failing-assets Skip assets that cannot be fetched/uploaded\n  --replace-assets Skip reuse of existing assets\n  --skip-cross-dataset-references Skips references to other datasets\n\nRarely used options (should generally not be used)\n  --allow-assets-in-different-dataset Allow asset documents to reference different project/dataset\n\nExamples\n  # Import "moviedb.ndjson" from the current directory to the dataset called "moviedb"\n  sanity dataset import moviedb.ndjson moviedb\n\n  # Import "moviedb.tar.gz" from the current directory to the dataset called "moviedb",\n  # replacing any documents encountered that have the same document IDs\n  sanity dataset import moviedb.tar.gz moviedb --replace\n\n  # Import from a folder containing an ndjson file, such as an extracted tarball\n  # retrieved through "sanity dataset export".\n  sanity dataset import ~/some/folder moviedb\n\n  # Import from a remote URL. Will download and extract the tarball to a temporary\n  # location before importing it.\n  sanity dataset import https://some.url/moviedb.tar.gz moviedb --replace\n';
 function toBoolIfSet(flag) {
   return typeof flag === "undefined" ? void 0 : Boolean(flag);
 }
@@ -639,7 +640,7 @@ const importDatasetCommand = {
   group: "dataset",
   signature: "[FILE | FOLDER | URL] [TARGET_DATASET]",
   description: "Import documents to given dataset from either an ndjson file or a gzipped tarball",
-  helpText: helpText$m,
+  helpText: helpText$n,
   // eslint-disable-next-line max-statements
   action: async (args, context) => {
     const {
@@ -995,7 +996,7 @@ const getClientUrl = function (client, uri) {
   const base = useCdn ? config.cdnUrl : config.url;
   return "".concat(base, "/").concat(uri.replace(/^\//, ""));
 };
-const helpText$l = "\nOptions\n  --detach Start the copy without waiting for it to finish\n  --attach <job-id> Attach to the running copy process to show progress\n  --skip-history Don't preserve document history on copy\n  --list Lists all dataset copy jobs corresponding to a certain criteria.\n  --offset Start position in the list of jobs. Default 0. With --list.\n  --limit Maximum number of jobs returned. Default 10. Maximum 1000. With --list.\n\nExamples\n  sanity dataset copy\n  sanity dataset copy <source-dataset>\n  sanity dataset copy <source-dataset> <target-dataset>\n  sanity dataset copy --skip-history <source-dataset> <target-dataset>\n  sanity dataset copy --detach <source-dataset> <target-dataset>\n  sanity dataset copy --attach <job-id>\n  sanity dataset copy --list\n  sanity dataset copy --list --offset=2\n  sanity dataset copy --list --offset=2 --limit=10\n";
+const helpText$m = "\nOptions\n  --detach Start the copy without waiting for it to finish\n  --attach <job-id> Attach to the running copy process to show progress\n  --skip-history Don't preserve document history on copy\n  --list Lists all dataset copy jobs corresponding to a certain criteria.\n  --offset Start position in the list of jobs. Default 0. With --list.\n  --limit Maximum number of jobs returned. Default 10. Maximum 1000. With --list.\n\nExamples\n  sanity dataset copy\n  sanity dataset copy <source-dataset>\n  sanity dataset copy <source-dataset> <target-dataset>\n  sanity dataset copy --skip-history <source-dataset> <target-dataset>\n  sanity dataset copy --detach <source-dataset> <target-dataset>\n  sanity dataset copy --attach <job-id>\n  sanity dataset copy --list\n  sanity dataset copy --list --offset=2\n  sanity dataset copy --list --offset=2 --limit=10\n";
 function parseCliFlags$3(args) {
   return yargs__default.default(helpers.hideBin(args.argv || process.argv).slice(2)).option("attach", {
     type: "string"
@@ -1088,7 +1089,7 @@ const copyDatasetCommand = {
   name: "copy",
   group: "dataset",
   signature: "[SOURCE_DATASET] [TARGET_DATASET]",
-  helpText: helpText$l,
+  helpText: helpText$m,
   description: "Manages dataset copying, including starting a new copy job, listing copy jobs and following the progress of a running copy job",
   action: async (args, context) => {
     const {
@@ -1383,12 +1384,12 @@ var __template$1 = (cooked, raw) => __freeze$1(__defProp$1(cooked, "raw", {
   value: __freeze$1(raw || cooked.slice())
 }));
 var _a$1;
-const helpText$k = "\nBelow are examples of the alias subcommand\n\nCreate Alias\n  sanity dataset alias create\n  sanity dataset alias create <alias-name>\n  sanity dataset alias create <alias-name> <target-dataset>\n\nDelete Alias\n  Options\n    --force Skips security prompt and forces link command\n\n  Usage\n    sanity dataset alias delete <alias-name>\n    sanity dataset alias delete <alias-name> --force\n\nLink Alias\n  Options\n    --force Skips security prompt and forces link command\n\n  Usage\n    sanity dataset alias link\n    sanity dataset alias link <alias-name>\n    sanity dataset alias link <alias-name> <target-dataset>\n    sanity dataset alias link <alias-name> <target-dataset> --force\n\nUn-link Alias\n  Options\n    --force Skips security prompt and forces link command\n\n  Usage\n    sanity dataset alias unlink\n    sanity dataset alias unlink <alias-name>\n    sanity dataset alias unlink <alias-name> --force\n";
+const helpText$l = "\nBelow are examples of the alias subcommand\n\nCreate Alias\n  sanity dataset alias create\n  sanity dataset alias create <alias-name>\n  sanity dataset alias create <alias-name> <target-dataset>\n\nDelete Alias\n  Options\n    --force Skips security prompt and forces link command\n\n  Usage\n    sanity dataset alias delete <alias-name>\n    sanity dataset alias delete <alias-name> --force\n\nLink Alias\n  Options\n    --force Skips security prompt and forces link command\n\n  Usage\n    sanity dataset alias link\n    sanity dataset alias link <alias-name>\n    sanity dataset alias link <alias-name> <target-dataset>\n    sanity dataset alias link <alias-name> <target-dataset> --force\n\nUn-link Alias\n  Options\n    --force Skips security prompt and forces link command\n\n  Usage\n    sanity dataset alias unlink\n    sanity dataset alias unlink <alias-name>\n    sanity dataset alias unlink <alias-name> --force\n";
 const aliasCommand = {
   name: "alias",
   group: "dataset",
   signature: "SUBCOMMAND [ALIAS_NAME, TARGET_DATASET]",
-  helpText: helpText$k,
+  helpText: helpText$l,
   description: "You can manage your dataset alias using this command.",
   action: async (args, context) => {
     const [verb] = args.argsWithoutOptions;
@@ -1441,12 +1442,12 @@ function colorizeJson(input, chalk) {
     return formatter(token.raw);
   }).join("");
 }
-const helpText$j = "\nGet and print a document from the projects configured dataset\n\nOptions\n  --pretty colorized JSON output\n  --dataset NAME to override dataset\n\nExamples\n  # Get the document with the ID \"myDocId\"\n  sanity documents get myDocId\n\n  # ID wrapped in double or single quote works equally well\n  sanity documents get 'myDocId'\n";
+const helpText$k = "\nGet and print a document from the projects configured dataset\n\nOptions\n  --pretty colorized JSON output\n  --dataset NAME to override dataset\n\nExamples\n  # Get the document with the ID \"myDocId\"\n  sanity documents get myDocId\n\n  # ID wrapped in double or single quote works equally well\n  sanity documents get 'myDocId'\n";
 const getDocumentsCommand = {
   name: "get",
   group: "documents",
   signature: "[DOCUMENT_ID]",
-  helpText: helpText$j,
+  helpText: helpText$k,
   description: "Get and print a document by ID",
   action: async (args, context) => {
     const {
@@ -1477,12 +1478,12 @@ const getDocumentsCommand = {
   }
 };
 const defaultApiVersion = "v2022-06-01";
-const helpText$i = "\nRun a query against the projects configured dataset\n\nOptions\n  --pretty colorized JSON output\n  --dataset NAME to override dataset\n  --project PROJECT to override project ID\n  --anonymous Send the query without any authorization token\n  --api-version API version to use (defaults to `".concat(defaultApiVersion, '`)\n\nEnvironment variables\n  `SANITY_CLI_QUERY_API_VERSION` - will use the defined API version,\n  unless `--api-version` is specified.\n\nExamples\n  # Fetch 5 documents of type "movie"\n  sanity documents query \'*[_type == "movie"][0..4]\'\n\n  # Fetch title of the oldest movie in the dataset named "staging"\n  sanity documents query \'*[_type == "movie"]|order(releaseDate asc)[0]{title}\' --dataset staging\n\n  # Use API version v2021-06-07 and do a query\n  sanity documents query --api-version v2021-06-07 \'*[_id == "header"] { "headerText": pt::text(body) }\'\n');
+const helpText$j = "\nRun a query against the projects configured dataset\n\nOptions\n  --pretty colorized JSON output\n  --dataset NAME to override dataset\n  --project PROJECT to override project ID\n  --anonymous Send the query without any authorization token\n  --api-version API version to use (defaults to `".concat(defaultApiVersion, '`)\n\nEnvironment variables\n  `SANITY_CLI_QUERY_API_VERSION` - will use the defined API version,\n  unless `--api-version` is specified.\n\nExamples\n  # Fetch 5 documents of type "movie"\n  sanity documents query \'*[_type == "movie"][0..4]\'\n\n  # Fetch title of the oldest movie in the dataset named "staging"\n  sanity documents query \'*[_type == "movie"]|order(releaseDate asc)[0]{title}\' --dataset staging\n\n  # Use API version v2021-06-07 and do a query\n  sanity documents query --api-version v2021-06-07 \'*[_id == "header"] { "headerText": pt::text(body) }\'\n');
 var queryDocumentsCommand = {
   name: "query",
   group: "documents",
   signature: "[QUERY]",
-  helpText: helpText$i,
+  helpText: helpText$j,
   description: "Query for documents",
   action: async (args, context) => {
     var _a, _b;
@@ -1556,12 +1557,12 @@ function parseCliFlags(args) {
     default: fallbackApiVersion
   }).argv;
 }
-const helpText$h = '\nDelete a document from the projects configured dataset\n\nOptions\n  --dataset NAME to override dataset\n\nExample\n  # Delete the document with the ID "myDocId"\n  sanity documents delete myDocId\n\n  # ID wrapped in double or single quote works equally well\n  sanity documents delete \'myDocId\'\n\n  # Delete document with ID "someDocId" from dataset "blog"\n  sanity documents delete --dataset=blog someDocId\n\n  # Delete the document with ID "doc1" and "doc2"\n  sanity documents delete doc1 doc2\n';
+const helpText$i = '\nDelete a document from the projects configured dataset\n\nOptions\n  --dataset NAME to override dataset\n\nExample\n  # Delete the document with the ID "myDocId"\n  sanity documents delete myDocId\n\n  # ID wrapped in double or single quote works equally well\n  sanity documents delete \'myDocId\'\n\n  # Delete document with ID "someDocId" from dataset "blog"\n  sanity documents delete --dataset=blog someDocId\n\n  # Delete the document with ID "doc1" and "doc2"\n  sanity documents delete doc1 doc2\n';
 const deleteDocumentsCommand = {
   name: "delete",
   group: "documents",
   signature: "[ID] [...IDS]",
-  helpText: helpText$h,
+  helpText: helpText$i,
   description: "Delete a document by ID",
   action: async (args, context) => {
     const {
@@ -1597,12 +1598,12 @@ const deleteDocumentsCommand = {
     }
   }
 };
-const helpText$g = '\nOptions\n  --replace On duplicate document IDs, replace existing document with specified document(s)\n  --missing On duplicate document IDs, don\'t modify the target document(s)\n  --watch   Write the documents whenever the target file or buffer changes\n  --json5   Use JSON5 file type to allow a "simplified" version of JSON\n  --id <id> Specify a document ID to use. Will fetch remote document ID and populate editor.\n  --dataset NAME to override dataset\n\nExamples\n  # Create the document specified in "myDocument.json".\n  sanity documents create myDocument.json\n\n  # Open configured $EDITOR and create the specified document(s)\n  sanity documents create\n\n  # Fetch document with the ID "myDocId" and open configured $EDITOR with the\n  # current document content (if any). Replace document with the edited version\n  # when the editor closes\n  sanity documents create --id myDocId --replace\n\n  # Open configured $EDITOR and replace the document with the given content\n  # on each save. Use JSON5 file extension and parser for simplified syntax.\n  sanity documents create --id myDocId --watch --replace --json5\n';
+const helpText$h = '\nOptions\n  --replace On duplicate document IDs, replace existing document with specified document(s)\n  --missing On duplicate document IDs, don\'t modify the target document(s)\n  --watch   Write the documents whenever the target file or buffer changes\n  --json5   Use JSON5 file type to allow a "simplified" version of JSON\n  --id <id> Specify a document ID to use. Will fetch remote document ID and populate editor.\n  --dataset NAME to override dataset\n\nExamples\n  # Create the document specified in "myDocument.json".\n  sanity documents create myDocument.json\n\n  # Open configured $EDITOR and create the specified document(s)\n  sanity documents create\n\n  # Fetch document with the ID "myDocId" and open configured $EDITOR with the\n  # current document content (if any). Replace document with the edited version\n  # when the editor closes\n  sanity documents create --id myDocId --replace\n\n  # Open configured $EDITOR and replace the document with the given content\n  # on each save. Use JSON5 file extension and parser for simplified syntax.\n  sanity documents create --id myDocId --watch --replace --json5\n';
 const createDocumentsCommand = {
   name: "create",
   group: "documents",
   signature: "[FILE]",
-  helpText: helpText$g,
+  helpText: helpText$h,
   description: "Create one or more documents",
   // eslint-disable-next-line complexity
   action: async (args, context) => {
@@ -1786,22 +1787,22 @@ function getEditor() {
     args
   };
 }
-const description = "Downloads and validates all document specified in a workspace";
-const helpText$f = "\nOptions\n  -y, --yes Skips the first confirmation prompt.\n  --workspace <name> The name of the workspace to use when downloading and validating all documents.\n  --dataset <name> Override the dataset used. By default, this is derived from the given workspace.\n  --file <filepath> Provide a path to either an .ndjson file or a tarball containing an .ndjson file.\n  --format <pretty|ndjson|json> The output format used to print the found validation markers and report progress.\n  --level <error|warning|info> The minimum level reported out. Defaults to warning.\n  --max-custom-validation-concurrency <number> Specify how many custom validators can run concurrently. Defaults to 5.\n\nExamples\n  # Validates all documents in a Sanity project with more than one workspace\n  sanity documents validate --workspace default\n\n  # Override the dataset specified in the workspace\n  sanity documents validate --workspace default --dataset staging\n\n  # Save the results of the report into a file\n  sanity documents validate > report.txt\n\n  # Report out info level validation markers too\n  sanity documents validate --level info\n";
-const validateDocumentsCommand = {
+const description$1 = "Downloads and validates all document specified in a workspace";
+const helpText$g = "\nOptions\n  -y, --yes Skips the first confirmation prompt.\n  --workspace <name> The name of the workspace to use when downloading and validating all documents.\n  --dataset <name> Override the dataset used. By default, this is derived from the given workspace.\n  --file <filepath> Provide a path to either an .ndjson file or a tarball containing an .ndjson file.\n  --format <pretty|ndjson|json> The output format used to print the found validation markers and report progress.\n  --level <error|warning|info> The minimum level reported out. Defaults to warning.\n  --max-custom-validation-concurrency <number> Specify how many custom validators can run concurrently. Defaults to 5.\n\nExamples\n  # Validates all documents in a Sanity project with more than one workspace\n  sanity documents validate --workspace default\n\n  # Override the dataset specified in the workspace\n  sanity documents validate --workspace default --dataset staging\n\n  # Save the results of the report into a file\n  sanity documents validate > report.txt\n\n  # Report out info level validation markers too\n  sanity documents validate --level info\n";
+const validateDocumentsCommand$1 = {
   name: "validate",
   group: "documents",
   signature: "",
-  description,
-  helpText: helpText$f,
+  description: description$1,
+  helpText: helpText$g,
   action: async (args, context) => {
     const mod = await Promise.resolve().then(function () {
-      return require('./validateAction-NIrqtyYJ.js');
+      return require('./validateAction-shi462sq.js');
     });
     return mod.default(args, context);
   }
 };
-const helpText$e = '\nNotes\n  Changing the hostname or port number might require a new entry to the CORS-origins allow list.\n\nOptions\n  --port <port> TCP port to start server on. [default: 3333]\n  --host <host> The local network interface at which to listen. [default: "127.0.0.1"]\n\nExamples\n  sanity dev --host=0.0.0.0\n  sanity dev --port=1942\n';
+const helpText$f = '\nNotes\n  Changing the hostname or port number might require a new entry to the CORS-origins allow list.\n\nOptions\n  --port <port> TCP port to start server on. [default: 3333]\n  --host <host> The local network interface at which to listen. [default: "127.0.0.1"]\n\nExamples\n  sanity dev --host=0.0.0.0\n  sanity dev --port=1942\n';
 const devCommand = {
   name: "dev",
   signature: "[--port <port>] [--host <host>]",
@@ -1810,7 +1811,7 @@ const devCommand = {
     const devAction = await getDevAction();
     return devAction(args, context);
   },
-  helpText: helpText$e
+  helpText: helpText$f
 };
 async function getDevAction() {
   const mod = await Promise.resolve().then(function () {
@@ -1819,7 +1820,7 @@ async function getDevAction() {
   return mod.default;
 }
 const isInteractive = process.stdout.isTTY && process.env.TERM !== "dumb" && !("CI" in process.env);
-const helpText$d = '\nNotes\n  Changing the hostname or port number might require a new CORS-entry to be added.\n\nOptions\n  --port <port> TCP port to start server on. [default: 3333]\n  --host <host> The local network interface at which to listen. [default: "127.0.0.1"]\n\nExamples\n  sanity start --host=0.0.0.0\n  sanity start --port=1942\n  sanity start some/build-output-dir\n';
+const helpText$e = '\nNotes\n  Changing the hostname or port number might require a new CORS-entry to be added.\n\nOptions\n  --port <port> TCP port to start server on. [default: 3333]\n  --host <host> The local network interface at which to listen. [default: "127.0.0.1"]\n\nExamples\n  sanity start --host=0.0.0.0\n  sanity start --port=1942\n  sanity start some/build-output-dir\n';
 const startCommand = {
   name: "start",
   signature: "[BUILD_OUTPUT_DIR] [--port <port>] [--host <host>]",
@@ -1864,7 +1865,7 @@ const startCommand = {
       }
     }
   },
-  helpText: helpText$d
+  helpText: helpText$e
 };
 async function getPreviewAction$1() {
   const mod = await Promise.resolve().then(function () {
@@ -1872,6 +1873,21 @@ async function getPreviewAction$1() {
   });
   return mod.default;
 }
+const description = "Validates all schema types specified in a workspace.";
+const helpText$d = "\nOptions\n  --workspace <name> The name of the workspace to use when validating all schema types.\n  --format <pretty|ndjson|json> The output format used to print schema errors and warnings.\n  --level <error|warning> The minimum level reported out. Defaults to warning.\n\nExamples\n  # Validates all schema types in a Sanity project with more than one workspace\n  sanity schema validate --workspace default\n\n  # Save the results of the report into a file\n  sanity schema validate > report.txt\n\n  # Report out only errors\n  sanity schema validate --level error\n";
+const validateDocumentsCommand = {
+  name: "validate",
+  group: "schema",
+  signature: "",
+  description,
+  helpText: helpText$d,
+  action: async (args, context) => {
+    const mod = await Promise.resolve().then(function () {
+      return require('./validateAction-4Jl_y_iB.js');
+    });
+    return mod.default(args, context);
+  }
+};
 const helpText$c = '\nNotes\n  Changing the hostname or port number might require a new entry to the CORS-origins allow list.\n\nOptions\n  --port <port> TCP port to start server on. [default: 3333]\n  --host <host> The local network interface at which to listen. [default: "127.0.0.1"]\n\nExamples\n  sanity preview --host=0.0.0.0\n  sanity preview --port=1942\n  sanity preview some/build-output-dir\n';
 const previewCommand = {
   name: "preview",
@@ -2483,7 +2499,7 @@ const listGraphQLAPIsCommand = {
   description: "Lists all the GraphQL endpoints deployed for this project",
   action: async (args, context) => {
     const mod = await Promise.resolve().then(function () {
-      return require('./listApisAction-6lGkFZrU.js');
+      return require('./listApisAction-IvKV4iAd.js');
     });
     return mod.default(args, context);
   },
@@ -2497,7 +2513,7 @@ const deployGraphQLAPICommand = {
   description: "Deploy a GraphQL API from the current Sanity schema",
   action: async (args, context) => {
     const mod = await Promise.resolve().then(function () {
-      return require('./deployApiAction-bRyJpGOS.js');
+      return require('./deployApiAction-rVL67VYW.js');
     });
     return mod.default(args, context);
   },
@@ -2712,37 +2728,37 @@ const renameType = _ref4 => {
     migrationName,
     documentTypes
   } = _ref4;
-  return "import {defineMigration, at, set} from 'sanity/migrate'\n\nconst oldType = 'old'\nconst newType = 'new'\n\nexport default defineMigration({\n  name: '".concat(migrationName, "',\n").concat(documentTypes.length > 0 ? "  documentTypes: [".concat(documentTypes.map(t => JSON.stringify(t)).join(", "), "],\n") : "", "\n  migrate: {\n    object(object, path, context) {\n      if (object._type === oldType) {\n        return at('_type', set(newType))\n      }\n    }\n  }\n})\n");
+  return "import {defineMigration, at, set} from 'sanity/migrate'\n\nconst oldType = 'old'\nconst newType = 'new'\n\nexport default defineMigration({\n  title: '".concat(migrationName, "',\n").concat(documentTypes.length > 0 ? "  documentTypes: [".concat(documentTypes.map(t => JSON.stringify(t)).join(", "), "],\n") : "", "\n  migrate: {\n    object(object, path, context) {\n      if (object._type === oldType) {\n        return at('_type', set(newType))\n      }\n    }\n  }\n})\n");
 };
 const stringToPTE = _ref5 => {
   let {
     migrationName,
     documentTypes
   } = _ref5;
-  return "import {pathsAreEqual, stringToPath} from 'sanity'\nimport {defineMigration, set} from 'sanity/migrate'\n\nconst targetPath = stringToPath('some.path')\n\nexport default defineMigration({\n  name: '".concat(migrationName, "',\n").concat(documentTypes.length > 0 ? "  documentTypes: [".concat(documentTypes.map(t => JSON.stringify(t)).join(", "), "],\n") : "", "\n  migrate: {\n    string(node, path, ctx) {\n      if (pathsAreEqual(path, targetPath)) {\n        return set([\n          {\n            style: 'normal',\n            _type: 'block',\n            children: [\n              {\n                _type: 'span',\n                marks: [],\n                text: node,\n              },\n            ],\n            markDefs: [],\n          },\n        ])\n      }\n    },\n  },\n})\n");
+  return "import {pathsAreEqual, stringToPath} from 'sanity'\nimport {defineMigration, set} from 'sanity/migrate'\n\nconst targetPath = stringToPath('some.path')\n\nexport default defineMigration({\n  title: '".concat(migrationName, "',\n").concat(documentTypes.length > 0 ? "  documentTypes: [".concat(documentTypes.map(t => JSON.stringify(t)).join(", "), "],\n") : "", "\n  migrate: {\n    string(node, path, ctx) {\n      if (pathsAreEqual(path, targetPath)) {\n        return set([\n          {\n            style: 'normal',\n            _type: 'block',\n            children: [\n              {\n                _type: 'span',\n                marks: [],\n                text: node,\n              },\n            ],\n            markDefs: [],\n          },\n        ])\n      }\n    },\n  },\n})\n");
 };
 const minimalSimple = _ref6 => {
   let {
     migrationName,
     documentTypes
   } = _ref6;
-  return "import {defineMigration} from 'sanity/migrate'\n\nexport default defineMigration({\n  name: '".concat(migrationName, "',\n").concat(documentTypes.length > 0 ? "  documentTypes: [".concat(documentTypes.map(t => JSON.stringify(t)).join(", "), "],\n") : "", "\n  migrate: {\n    document(doc, context) {\n      // this will be called for every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n    node(node, path, context) {\n      // this will be called for every node in every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n    object(node, path, context) {\n      // this will be called for every object node in every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n    array(node, path, context) {\n      // this will be called for every array node in every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n    string(node, path, context) {\n      // this will be called for every string node in every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n    number(node, path, context) {\n      // this will be called for every number node in every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n    boolean(node, path, context) {\n      // this will be called for every boolean node in every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n    null(node, path, context) {\n      // this will be called for every null node in every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n  },\n})\n");
+  return "import {defineMigration} from 'sanity/migrate'\n\nexport default defineMigration({\n  title: '".concat(migrationName, "',\n").concat(documentTypes.length > 0 ? "  documentTypes: [".concat(documentTypes.map(t => JSON.stringify(t)).join(", "), "],\n") : "", "\n  migrate: {\n    document(doc, context) {\n      // this will be called for every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n    node(node, path, context) {\n      // this will be called for every node in every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n    object(node, path, context) {\n      // this will be called for every object node in every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n    array(node, path, context) {\n      // this will be called for every array node in every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n    string(node, path, context) {\n      // this will be called for every string node in every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n    number(node, path, context) {\n      // this will be called for every number node in every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n    boolean(node, path, context) {\n      // this will be called for every boolean node in every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n    null(node, path, context) {\n      // this will be called for every null node in every document of the matching type\n      // any patch returned will be applied to the document\n      // you can also return mutations that touches other documents\n    },\n  },\n})\n");
 };
 const minimalAdvanced = _ref7 => {
   let {
     migrationName,
     documentTypes
   } = _ref7;
-  return "import {defineMigration, patch, at, setIfMissing} from 'sanity/migrate'\n\n/**\n * this migration will set `Default title` on all documents that are missing a title\n * and make `true` the default value for the `enabled` field\n */\nexport default defineMigration({\n  name: '".concat(migrationName, "',\n").concat(documentTypes.length > 0 ? "  documentTypes: [".concat(documentTypes.map(t => JSON.stringify(t)).join(", "), "],\n") : "", "\n  async *migrate(documents, context) {\n    for await (const document of documents()) {\n      yield patch(document._id, [\n        at('title', setIfMissing('Default title')),\n        at('enabled', setIfMissing(true)),\n      ])\n    }\n  }\n})\n");
+  return "import {defineMigration, patch, at, setIfMissing} from 'sanity/migrate'\n\n/**\n * this migration will set `Default title` on all documents that are missing a title\n * and make `true` the default value for the `enabled` field\n */\nexport default defineMigration({\n  title: '".concat(migrationName, "',\n").concat(documentTypes.length > 0 ? "  documentTypes: [".concat(documentTypes.map(t => JSON.stringify(t)).join(", "), "],\n") : "", "\n  async *migrate(documents, context) {\n    for await (const document of documents()) {\n      yield patch(document._id, [\n        at('title', setIfMissing('Default title')),\n        at('enabled', setIfMissing(true)),\n      ])\n    }\n  }\n})\n");
 };
 const renameField = _ref8 => {
   let {
     migrationName,
     documentTypes
   } = _ref8;
-  return "import {defineMigration, at, setIfMissing, unset} from 'sanity/migrate'\n\nconst from = 'oldFieldName'\nconst to = 'newFieldName'\n\nexport default defineMigration({\n  name: '".concat(migrationName, "',\n").concat(documentTypes.length > 0 ? "  documentTypes: [".concat(documentTypes.map(t => JSON.stringify(t)).join(", "), "],\n") : "", "\n  migrate: {\n    document(doc, path, context) {\n      return [\n        at(to, setIfMissing(doc[from]))\n        at(from, unset())\n      ]\n    }\n  }\n})\n");
+  return "import {defineMigration, at, setIfMissing, unset} from 'sanity/migrate'\n\nconst from = 'oldFieldName'\nconst to = 'newFieldName'\n\nexport default defineMigration({\n  title: '".concat(migrationName, "',\n").concat(documentTypes.length > 0 ? "  documentTypes: [".concat(documentTypes.map(t => JSON.stringify(t)).join(", "), "],\n") : "", "\n  migrate: {\n    document(doc, context) {\n      return [\n        at(to, setIfMissing(doc[from])),\n        at(from, unset())\n      ]\n    }\n  }\n})\n");
 };
-const helpText$2 = "\nCreate a new migration within your project\n";
+const helpText$2 = '\nCreate a new migration within your project\n\nExamples:\n    # Create a new migration, you will be prompted to provide a type\n    sanity migration create\n\n    # Create a new migration, specifying the title\n    sanity migration create "Rename field from location to address"\n';
 const TEMPLATES = [{
   name: "Minimalistic migration to get you started",
   template: minimalSimple
@@ -2759,10 +2775,10 @@ const TEMPLATES = [{
   name: "Advanced template using async iterators providing more fine grained control",
   template: minimalAdvanced
 }];
-const createMigrationCommand$2 = {
+const createMigrationCommand$1 = {
   name: "create",
   group: "migration",
-  signature: "[NAME]",
+  signature: "[TITLE]",
   helpText: helpText$2,
   description: "Create a new content migration within your project",
   action: async (args, context) => {
@@ -2772,15 +2788,15 @@ const createMigrationCommand$2 = {
       workDir,
       chalk
     } = context;
-    let name = "";
-    while (!name.trim()) {
-      name = await prompt.single({
+    let [title] = args.argsWithoutOptions;
+    while (!(title == null ? void 0 : title.trim())) {
+      title = await prompt.single({
         type: "input",
-        suffix: " (e.g. rename field from location to address)",
-        message: "Name of migration"
+        suffix: ' (e.g. "Rename field from location to address")',
+        message: "Title of migration"
       });
-      if (!name.trim()) {
-        output.print(chalk.red("Name cannot be empty"));
+      if (!title.trim()) {
+        output.error(chalk.red("Name cannot be empty"));
       }
     }
     const types = await prompt.single({
@@ -2797,7 +2813,7 @@ const createMigrationCommand$2 = {
         value: definedTemplate.name
       }))
     });
-    const sluggedName = deburr__default.default(name.toLowerCase()).replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+    const sluggedName = deburr__default.default(title.toLowerCase()).replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
     const destDir = path__default.default.join(MIGRATIONS_DIRECTORY, sluggedName);
     if (node_fs.existsSync(destDir)) {
       if (!(await prompt.single({
@@ -2810,7 +2826,7 @@ const createMigrationCommand$2 = {
     }
     mkdirp__default.default.sync(destDir);
     const renderedTemplate = (templatesByName[template].template || minimalSimple)({
-      migrationName: name,
+      migrationName: title,
       documentTypes: types.split(",").map(t => t.trim()).filter(Boolean)
     });
     const definitionFile = path__default.default.join(destDir, "index.ts");
@@ -2826,71 +2842,302 @@ const createMigrationCommand$2 = {
     output.print("\u{1F449} Learn more about schema and content migrations at ".concat(chalk.bold("https://www.sanity.io/docs/schema-and-content-migrations")));
   }
 };
+function resolveMigrationScript$1(workDir, migrationName) {
+  return [migrationName, path__default.default.join(migrationName, "index")].flatMap(location => MIGRATION_SCRIPT_EXTENSIONS.map(ext => {
+    const relativePath = path__default.default.join(MIGRATIONS_DIRECTORY, "".concat(location, ".").concat(ext));
+    const absolutePath = path__default.default.resolve(workDir, relativePath);
+    let mod;
+    try {
+      mod = require(absolutePath);
+    } catch (err) {}
+    return {
+      relativePath,
+      absolutePath,
+      mod
+    };
+  }));
+}
+const helpText$1 = "";
+const createMigrationCommand = {
+  name: "list",
+  group: "migration",
+  signature: "[NAME]",
+  helpText: helpText$1,
+  description: "List available migrations",
+  action: async (args, context) => {
+    const {
+      workDir,
+      output
+    } = context;
+    const migrations = await resolveMigrations(workDir);
+    const table = new consoleTablePrinter.Table({
+      title: "Found ".concat(migrations.length, " migrations in project"),
+      columns: [{
+        name: "id",
+        title: "ID",
+        alignment: "left"
+      }, {
+        name: "title",
+        title: "Title",
+        alignment: "left"
+      }]
+    });
+    migrations.forEach(definedMigration => {
+      table.addRow({
+        id: definedMigration.dirname,
+        title: definedMigration.migration.title
+      });
+    });
+    table.printTable();
+    output.print("\nRun `sanity migration run <ID>` to run a migration");
+  }
+};
+async function resolveMigrations(workDir) {
+  {
+    node.register({
+      target: "node".concat(process.version.slice(1))
+    });
+  }
+  const directories = (await fs$3.readdir(path__default.default.join(workDir, MIGRATIONS_DIRECTORY), {
+    withFileTypes: true
+  })).filter(ent => ent.isDirectory());
+  return directories.map(ent => {
+    const candidates = resolveMigrationScript$1(workDir, ent.name);
+    const found = candidates.find(candidate => {
+      var _a;
+      return (_a = candidate.mod) == null ? void 0 : _a.default;
+    });
+    if (!found) {
+      return null;
+    }
+    return {
+      dirname: ent.name,
+      migration: found.mod.default
+    };
+  }).filter(Boolean);
+}
+const maxKeyLength = function () {
+  let children = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  let depth = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+  return Object.entries(children).map(_ref9 => {
+    let [key, child] = _ref9;
+    return Math.max(key.length + depth * 2, maxKeyLength(child.children, depth + 1));
+  }).reduce((max, next) => next > max ? next : max, 0);
+};
+const formatTree = _ref10 => {
+  let {
+    node = {},
+    paddingLength,
+    indent = "",
+    getNodes: getLeaves = _ref11 => {
+      let {
+        nodes
+      } = _ref11;
+      return nodes;
+    },
+    getMessage
+  } = _ref10;
+  const entries = Object.entries(node);
+  return entries.map((_ref12, index) => {
+    let [key, child] = _ref12;
+    const isLast = index === entries.length - 1;
+    const nextIndent = "".concat(indent).concat(isLast ? "  " : "\u2502 ");
+    const leaves = getLeaves(child);
+    const nested = formatTree({
+      node: child.children,
+      paddingLength,
+      indent: nextIndent,
+      getNodes: getLeaves,
+      getMessage
+    });
+    if (!(leaves == null ? void 0 : leaves.length)) {
+      const current2 = "".concat(indent).concat(isLast ? "\u2514" : "\u251C", "\u2500 ").concat(key);
+      return [current2, nested].filter(Boolean).join("\n");
+    }
+    const [first, ...rest] = leaves;
+    const firstPadding = ".".repeat(paddingLength - indent.length - key.length);
+    const elbow = isLast ? "\u2514" : "\u251C";
+    const subsequentPadding = " ".repeat(paddingLength - indent.length + 2);
+    const firstMessage = "".concat(indent).concat(elbow, "\u2500 ").concat(key, " ").concat(firstPadding, " ").concat(getMessage(first));
+    const subsequentMessages = rest.map(marker => "".concat(nextIndent).concat(subsequentPadding, " ").concat(getMessage(marker))).join("\n");
+    const current = [firstMessage, subsequentMessages].filter(Boolean).join("\n");
+    return [current, nested].filter(Boolean).join("\n");
+  }).join("\n");
+};
+function convertToTree(nodes) {
+  const root = {};
+  function addNode(node) {
+    let tree = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : root;
+    if (!node.path.length) {
+      if (!tree.nodes) tree.nodes = [];
+      tree.nodes.push(node);
+      return;
+    }
+    const [current, ...rest] = node.path;
+    const key = sanity.pathToString([current]);
+    if (!tree.children) tree.children = {};
+    if (!(key in tree.children)) tree.children[key] = {};
+    addNode({
+      ...node,
+      path: rest
+    }, tree.children[key]);
+  }
+  for (const node of nodes) addNode(node);
+  return root;
+}
+const isTty = tty.isatty(1);
+function prettyFormat(_ref13) {
+  let {
+    chalk,
+    subject,
+    migration,
+    indentSize = 0
+  } = _ref13;
+  return (Array.isArray(subject) ? subject : [subject]).map(subjectEntry => {
+    if (subjectEntry.type === "transaction") {
+      return [[badge("transaction", "info", chalk), typeof subjectEntry.id === "undefined" ? null : chalk.underline(subjectEntry.id)].filter(Boolean).join(" "), indent(prettyFormat({
+        chalk,
+        subject: subjectEntry.mutations,
+        migration,
+        indentSize
+      }))].join("\n\n");
+    }
+    return prettyFormatMutation({
+      chalk,
+      subject: subjectEntry,
+      migration,
+      indentSize
+    });
+  }).join("\n\n");
+}
 function encodeItemRef(ref) {
   return typeof ref === "number" ? ref : ref._key;
 }
-function formatTransaction(chalk, mutation) {
-  var _a;
-  if (mutation.type === "transaction") {
-    return mutation.mutations.flatMap(m => formatTransaction(chalk, m)).join("\n");
-  }
-  if (mutation.type === "create" || mutation.type === "createIfNotExists" || mutation.type === "createOrReplace") {
-    return [chalk.bold(mutation.type), ": ", JSON.stringify(mutation.document)].join("");
+function badgeStyle(chalk, variant) {
+  const styles = {
+    info: chalk.bgWhite.black,
+    incremental: chalk.bgGreen.black.bold,
+    maybeDestructive: chalk.bgYellow.black.bold,
+    destructive: chalk.bgRed.black.bold
+  };
+  return styles[variant];
+}
+function badge(label, variant, chalk) {
+  if (!isTty) {
+    return "[".concat(label, "]");
   }
-  if (mutation.type === "delete") {
-    return ["".concat(chalk.red.bold("delete"), " "), mutation.id].join(": ");
+  return badgeStyle(chalk, variant)(" ".concat(label, " "));
+}
+const mutationImpact = {
+  create: "incremental",
+  createIfNotExists: "incremental",
+  createOrReplace: "maybeDestructive",
+  delete: "destructive",
+  patch: "maybeDestructive"
+};
+function documentId(mutation) {
+  if ("id" in mutation) {
+    return mutation.id;
   }
-  if (mutation.type === "patch") {
-    const ifRevision = (_a = mutation.options) == null ? void 0 : _a.ifRevision;
-    return [chalk.blue.bold("patch"), "", "(".concat(mutation.id, ")"), ifRevision ? " (if revision==".concat(ifRevision, ")") : "", ":\n", mutation.patches.map(nodePatch => "  ".concat(formatPatchMutation(chalk, nodePatch))).join("\n")].join("");
+  if ("document" in mutation) {
+    return mutation.document._id;
   }
-  throw new Error("Invalid mutation type: ".concat(mutation.type));
+  return void 0;
+}
+const listFormatter = new Intl.ListFormat("en-US", {
+  type: "disjunction"
+});
+function mutationHeader(chalk, mutation, migration) {
+  var _a;
+  const mutationType = badge(mutation.type, mutationImpact[mutation.type], chalk);
+  const documentType = "document" in mutation || migration.documentTypes ? badge("document" in mutation ? mutation.document._type : listFormatter.format((_a = migration.documentTypes) != null ? _a : []), "info", chalk) : null;
+  return [mutationType, documentType, chalk.underline(documentId(mutation))].filter(Boolean).join(" ");
+}
+function prettyFormatMutation(_ref14) {
+  let {
+    chalk,
+    subject,
+    migration,
+    indentSize = 0
+  } = _ref14;
+  var _a;
+  const lock = "options" in subject ? chalk.cyan("(if revision==".concat((_a = subject.options) == null ? void 0 : _a.ifRevision, ")")) : "";
+  const header = [mutationHeader(chalk, subject, migration), lock].join(" ");
+  const padding = " ".repeat(indentSize);
+  if (subject.type === "create" || subject.type === "createIfNotExists" || subject.type === "createOrReplace") {
+    return [header, "\n", indent(JSON.stringify(subject.document, null, 2), indentSize)].join("");
+  }
+  if (subject.type === "patch") {
+    const tree = convertToTree(subject.patches.flat());
+    const paddingLength = Math.max(maxKeyLength(tree.children) + 2, 30);
+    return [header, "\n", formatTree({
+      node: tree.children,
+      paddingLength,
+      indent: padding,
+      getMessage: patch => formatPatchMutation(chalk, patch)
+    })].join("");
+  }
+  return header;
 }
 function formatPatchMutation(chalk, patch) {
   const {
     op
   } = patch;
-  const path = chalk.grey(PathUtils.toString(patch.path));
   const formattedType = chalk.bold(op.type);
   if (op.type === "unset") {
-    return [path, "".concat(formattedType, "()")].join(": ");
+    return "".concat(chalk.red(formattedType), "()");
   }
   if (op.type === "diffMatchPatch") {
-    return [path, "".concat(formattedType, "(").concat(op.value, ")")].join(": ");
+    return "".concat(chalk.yellow(formattedType), "(").concat(op.value, ")");
   }
   if (op.type === "inc" || op.type === "dec") {
-    return [path, "".concat(formattedType, "(").concat(op.amount, ")")].join(": ");
+    return "".concat(chalk.yellow(formattedType), "(").concat(op.amount, ")");
   }
-  if (op.type === "set" || op.type === "setIfMissing") {
-    return [path, "".concat(formattedType, "(").concat(JSON.stringify(op.value), ")")].join(": ");
+  if (op.type === "set") {
+    return "".concat(chalk.yellow(formattedType), "(").concat(JSON.stringify(op.value), ")");
+  }
+  if (op.type === "setIfMissing") {
+    return "".concat(chalk.green(formattedType), "(").concat(JSON.stringify(op.value), ")");
   }
   if (op.type === "assign") {
-    return [path, "".concat(formattedType, "(").concat(JSON.stringify(op.value), ")")].join(": ");
+    return "".concat(chalk.yellow(formattedType), "(").concat(JSON.stringify(op.value), ")");
   }
   if (op.type === "unassign") {
-    return [path, "".concat(formattedType, "(").concat(JSON.stringify(op.keys), ")")].join(": ");
+    return "".concat(chalk.red(formattedType), "(").concat(JSON.stringify(op.keys), ")");
+  }
+  if (op.type === "insert") {
+    return "".concat(chalk.green(formattedType), "(").concat(op.position, ", ").concat(encodeItemRef(op.referenceItem), ", ").concat(JSON.stringify(op.items), ")");
   }
-  if (op.type === "insert" || op.type === "upsert") {
-    return [path, "".concat(formattedType, "(").concat(op.position, ", ").concat(encodeItemRef(op.referenceItem), ", ").concat(JSON.stringify(op.items), ")")].join(": ");
+  if (op.type === "upsert") {
+    return "".concat(chalk.yellow(formattedType), "(").concat(op.position, ", ").concat(encodeItemRef(op.referenceItem), ", ").concat(JSON.stringify(op.items), ")");
   }
   if (op.type === "replace") {
-    return [path, "".concat(formattedType, "(").concat(encodeItemRef(op.referenceItem), ", ").concat(JSON.stringify(op.items), ")")].join(": ");
+    return "".concat(chalk.yellow(formattedType), "(").concat(encodeItemRef(op.referenceItem), ", ").concat(JSON.stringify(op.items), ")");
   }
   if (op.type === "truncate") {
-    return [path, "".concat(formattedType, "(").concat(op.startIndex, ", ").concat(op.endIndex)].join(": ");
+    return "".concat(chalk.red(formattedType), "(").concat(op.startIndex, ", ").concat(op.endIndex, ")");
   }
   throw new Error("Invalid operation type: ".concat(op.type));
 }
-const helpText$1 = "\nOptions\n  --dry <boolean> Whether or not to dry run the migration. Default to true, to actually run the migration, pass --no-dry\n  --from-export <export.tar.gz> Use a local dataset export as source for migration instead of calling the Sanity API. Note: this is only supported for dry runs.\n  --concurrency <concurrent> How many mutation requests to run in parallel. Must be between 1 and ".concat(migrate.MAX_MUTATION_CONCURRENCY, ". Default: ").concat(migrate.DEFAULT_MUTATION_CONCURRENCY, ".\n  --no-progress Don't output progress. Useful if you want debug your migration script and see the output of console.log() statements.\n  --dataset <dataset> Dataset to migrate. Defaults to the dataset configured in your Sanity CLI config.\n  --projectId <project id> Project ID of the dataset to migrate. Defaults to the projectId configured in your Sanity CLI config.\n  --no-confirm Skip the confirmation prompt before running the migration. Make sure you know what you're doing before using this flag.\n\n\nExamples\n  # dry run the migration\n  sanity migration run <name>\n\n  # execute the migration against a dataset\n  sanity migration run <name> --no-dry --projectId xyz --dataset staging\n\n  # run the migration using the dataset export as the source\n  sanity migration run <name> --dry false --from-export=production.tar.gz --projectId xyz --dataset staging\n");
+function indent(subject) {
+  let size = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 2;
+  const padding = " ".repeat(size);
+  return subject.split("\n").map(line => padding + line).join("\n");
+}
+const helpText = "\nOptions\n  --dry <boolean> Whether or not to dry run the migration. Default to true, to actually run the migration, pass --no-dry\n  --concurrency <concurrent> How many mutation requests to run in parallel. Must be between 1 and ".concat(migrate.MAX_MUTATION_CONCURRENCY, ". Default: ").concat(migrate.DEFAULT_MUTATION_CONCURRENCY, ".\n  --no-progress Don't output progress. Useful if you want debug your migration script and see the output of console.log() statements.\n  --dataset <dataset> Dataset to migrate. Defaults to the dataset configured in your Sanity CLI config.\n  --projectId <project id> Project ID of the dataset to migrate. Defaults to the projectId configured in your Sanity CLI config.\n  --no-confirm Skip the confirmation prompt before running the migration. Make sure you know what you're doing before using this flag.\n  --from-export <export.tar.gz> Use a local dataset export as source for migration instead of calling the Sanity API. Note: this is only supported for dry runs.\n\n\nExamples\n  # dry run the migration\n  sanity migration run <id>\n\n  # execute the migration against a dataset\n  sanity migration run <id> --no-dry --projectId xyz --dataset staging\n\n  # run the migration using the dataset export as the source\n  sanity migration run <id> --dry false --from-export=production.tar.gz --projectId xyz --dataset staging\n");
 const tryExtensions = ["mjs", "js", "ts", "cjs"];
-function resolveMigrationScript$1(workDir, migrationName) {
-  return [migrationName, path__default.default.join(migrationName, "index")].flatMap(location => tryExtensions.map(ext => {
+function resolveMigrationScript(workDir, migrationId) {
+  return [migrationId, path__default.default.join(migrationId, "index")].flatMap(location => tryExtensions.map(ext => {
     const relativePath = path__default.default.join("migrations", "".concat(location, ".").concat(ext));
     const absolutePath = path__default.default.resolve(workDir, relativePath);
     let mod;
     try {
       mod = require(absolutePath);
-    } catch (err) {}
+    } catch (err) {
+      if (err.code !== "MODULE_NOT_FOUND") {
+        throw new Error("Error: ".concat(err.message, '"'));
+      }
+    }
     return {
       relativePath,
       absolutePath,
@@ -2898,11 +3145,11 @@ function resolveMigrationScript$1(workDir, migrationName) {
     };
   }));
 }
-const createMigrationCommand$1 = {
+const runMigrationCommand = {
   name: "run",
   group: "migration",
-  signature: "[NAME] [MIGRATION NAME]",
-  helpText: helpText$1,
+  signature: "ID",
+  helpText,
   description: "Run a migration against a dataset",
   action: async (args, context) => {
     const {
@@ -2912,29 +3159,51 @@ const createMigrationCommand$1 = {
       chalk,
       workDir
     } = context;
-    const [migrationName] = args.argsWithoutOptions;
+    const [id] = args.argsWithoutOptions;
     const [fromExport, dry, showProgress, dataset, projectId, shouldConfirm] = [args.extOptions["from-export"], args.extOptions.dry !== false, args.extOptions.progress !== false, args.extOptions.dataset, args.extOptions["project-id"], args.extOptions.confirm !== false];
     if (dataset && !projectId || projectId && !dataset) {
       throw new Error("If either --dataset or --projectId is provided, both must be provided");
     }
-    if (!migrationName) {
-      throw new Error("MIGRATION NAME must be provided. `sanity migration run <name>`");
+    if (!id) {
+      output.error(chalk.red("Error: Migration ID must be provided"));
+      const migrations = await resolveMigrations(workDir);
+      const table = new consoleTablePrinter.Table({
+        title: "Migrations found in project",
+        columns: [{
+          name: "id",
+          title: "ID",
+          alignment: "left"
+        }, {
+          name: "title",
+          title: "Title",
+          alignment: "left"
+        }]
+      });
+      migrations.forEach(definedMigration => {
+        table.addRow({
+          id: definedMigration.dirname,
+          title: definedMigration.migration.title
+        });
+      });
+      table.printTable();
+      output.print("\nRun `sanity migration run <ID>` to run a migration");
+      return;
     }
     {
       node.register({
         target: "node".concat(process.version.slice(1))
       });
     }
-    const candidates = resolveMigrationScript$1(workDir, migrationName);
+    const candidates = resolveMigrationScript(workDir, id);
     const resolvedScripts = candidates.filter(candidate => {
       var _a;
       return (_a = candidate.mod) == null ? void 0 : _a.default;
     });
     if (resolvedScripts.length > 1) {
-      throw new Error('Found multiple migrations for "'.concat(migrationName, '" in current directory ').concat(candidates.map(candidate => candidate.relativePath).join(", ")));
+      throw new Error('Found multiple migrations for "'.concat(id, '" in current directory ').concat(candidates.map(candidate => candidate.relativePath).join(", ")));
     }
     if (resolvedScripts.length === 0) {
-      throw new Error('No migration found for "'.concat(migrationName, '" in current directory. Make sure that the migration file exists and exports a valid migration as its default export.\n\n Tried the following files:\n -').concat(candidates.map(candidate => candidate.relativePath).join("\n - ")));
+      throw new Error('No migration found for "'.concat(id, '" in current directory. Make sure that the migration file exists and exports a valid migration as its default export.\n\n Tried the following files:\n -').concat(candidates.map(candidate => candidate.relativePath).join("\n - ")));
     }
     const script = resolvedScripts[0];
     const mod = script.mod;
@@ -2966,134 +3235,86 @@ const createMigrationCommand$1 = {
       apiVersion: "v2024-01-29"
     };
     if (dry) {
-      const spinner = output.spinner('Running migration "'.concat(migrationName, '" in dry mode')).start();
-      if (fromExport) {
-        await migrate.runFromArchive(migration, fromExport, {
-          api: apiConfig,
-          concurrency,
-          onProgress: createProgress(spinner)
-        });
-        return;
-      }
-      migrate.dryRun({
-        api: apiConfig
-      }, migration);
-      spinner.stop();
-    } else {
-      const response = shouldConfirm && (await prompt.single({
-        message: "This migration will run on the ".concat(chalk.yellow(chalk.bold(apiConfig.dataset)), " dataset in ").concat(chalk.yellow(chalk.bold(apiConfig.projectId)), " project. Are you sure?"),
-        type: "confirm"
-      }));
-      if (response === false) {
-        debug("User aborted migration");
-        return;
-      }
-      const spinner = output.spinner('Running migration "'.concat(migrationName, '"')).start();
-      await migrate.run({
-        api: apiConfig,
-        concurrency,
-        onProgress: createProgress(spinner)
-      }, migration);
-      spinner.stop();
-    }
-    function createProgress(spinner) {
+      dryRunHandler();
+      return;
+    }
+    const response = shouldConfirm && (await prompt.single({
+      message: "This migration will run on the ".concat(chalk.yellow(chalk.bold(apiConfig.dataset)), " dataset in ").concat(chalk.yellow(chalk.bold(apiConfig.projectId)), " project. Are you sure?"),
+      type: "confirm"
+    }));
+    if (response === false) {
+      debug("User aborted migration");
+      return;
+    }
+    const spinner = output.spinner('Running migration "'.concat(id, '"')).start();
+    await migrate.run({
+      api: apiConfig,
+      concurrency,
+      onProgress: createProgress(spinner)
+    }, migration);
+    spinner.stop();
+    function createProgress(progressSpinner) {
       return function onProgress(progress) {
         if (!showProgress) {
-          spinner.stop();
+          progressSpinner.stop();
           return;
         }
         if (progress.done) {
-          spinner.text = 'Migration "'.concat(migrationName, '" completed.\n\n  Project id:  ').concat(chalk.bold(projectId), "\n  Dataset:     ").concat(chalk.bold(dataset), "\n\n  ").concat(progress.documents, " documents processed.\n  ").concat(progress.mutations, " mutations generated.\n  ").concat(chalk.green(progress.completedTransactions.length), " transactions committed.");
-          spinner.stopAndPersist({
+          progressSpinner.text = 'Migration "'.concat(id, '" completed.\n\n  Project id:  ').concat(chalk.bold(apiConfig.projectId), "\n  Dataset:     ").concat(chalk.bold(apiConfig.dataset), "\n\n  ").concat(progress.documents, " documents processed.\n  ").concat(progress.mutations, " mutations generated.\n  ").concat(chalk.green(progress.completedTransactions.length), " transactions committed.");
+          progressSpinner.stopAndPersist({
             symbol: chalk.green("\u2714")
           });
           return;
         }
         [null, ...progress.currentTransactions].forEach(transaction => {
           var _a;
-          spinner.text = 'Running migration "'.concat(migrationName, '"\u2026\n\n  Project id:     ').concat(chalk.bold(projectId), "\n  Dataset:        ").concat(chalk.bold(dataset), "\n  Document type:  ").concat(chalk.bold((_a = migration.documentTypes) == null ? void 0 : _a.join(",")), "\n\n  ").concat(progress.documents, " documents processed\u2026\n  ").concat(progress.mutations, " mutations generated\u2026\n  ").concat(chalk.blue(progress.pending), " requests pending\u2026\n  ").concat(chalk.green(progress.completedTransactions.length), " transactions committed.\n\n  ").concat(transaction && !progress.done ? "\xBB ".concat(chalk.grey(formatTransaction(chalk, transaction))) : "");
+          progressSpinner.text = 'Running migration "'.concat(id, '" ').concat(dry ? "in dry mode..." : "...", "\n\n  Project id:     ").concat(chalk.bold(apiConfig.projectId), "\n  Dataset:        ").concat(chalk.bold(apiConfig.dataset), "\n  Document type:  ").concat(chalk.bold((_a = migration.documentTypes) == null ? void 0 : _a.join(",")), "\n\n  ").concat(progress.documents, " documents processed\u2026\n  ").concat(progress.mutations, " mutations generated\u2026\n  ").concat(chalk.blue(progress.pending), " requests pending\u2026\n  ").concat(chalk.green(progress.completedTransactions.length), " transactions committed.\n\n  ").concat(transaction && !progress.done ? "\xBB ".concat(prettyFormat({
+            chalk,
+            subject: transaction,
+            migration,
+            indentSize: 2
+          })) : "");
         });
       };
     }
-  }
-};
-function resolveMigrationScript(workDir, migrationName) {
-  return [migrationName, path__default.default.join(migrationName, "index")].flatMap(location => MIGRATION_SCRIPT_EXTENSIONS.map(ext => {
-    const relativePath = path__default.default.join(MIGRATIONS_DIRECTORY, "".concat(location, ".").concat(ext));
-    const absolutePath = path__default.default.resolve(workDir, relativePath);
-    let mod;
-    try {
-      mod = require(absolutePath);
-    } catch (err) {}
-    return {
-      relativePath,
-      absolutePath,
-      mod
-    };
-  }));
-}
-const helpText = "";
-const createMigrationCommand = {
-  name: "list",
-  group: "migration",
-  signature: "[NAME]",
-  helpText,
-  description: "List available migrations",
-  action: async (args, context) => {
-    const {
-      output,
-      workDir
-    } = context;
-    {
-      node.register({
-        target: "node".concat(process.version.slice(1))
-      });
-    }
-    const directories = (await fs$3.readdir(path__default.default.join(workDir, MIGRATIONS_DIRECTORY), {
-      withFileTypes: true
-    })).filter(ent => ent.isDirectory());
-    const migrationModules = directories.map(ent => {
-      const candidates = resolveMigrationScript(workDir, ent.name);
-      const found = candidates.find(candidate => {
-        var _a;
-        return (_a = candidate.mod) == null ? void 0 : _a.default;
-      });
-      if (!found) {
-        return null;
+    async function dryRunHandler() {
+      if (fromExport) {
+        const dryRunSpinner = output.spinner('Running migration "'.concat(id, '" in dry mode')).start();
+        await migrate.runFromArchive(migration, fromExport, {
+          api: apiConfig,
+          concurrency,
+          onProgress: createProgress(dryRunSpinner)
+        });
+        dryRunSpinner.stop();
+      } else {
+        output.print('Running migration "'.concat(id, '" in dry mode'));
+        output.print();
+        output.print("Project id:  ".concat(chalk.bold(apiConfig.projectId)));
+        output.print("Dataset:     ".concat(chalk.bold(apiConfig.dataset)));
+        for await (const mutation of migrate.dryRun({
+          api: apiConfig
+        }, migration)) {
+          if (!mutation) continue;
+          output.print();
+          output.print(prettyFormat({
+            chalk,
+            subject: mutation,
+            migration
+          }));
+        }
       }
-      return {
-        dirname: ent.name,
-        migration: found.mod.default
-      };
-    }).filter(Boolean);
-    const table = new consoleTablePrinter.Table({
-      title: "Found ".concat(migrationModules.length, " migrations in project"),
-      columns: [{
-        name: "id",
-        title: "ID",
-        alignment: "left"
-      }, {
-        name: "name",
-        title: "Name",
-        alignment: "left"
-      }]
-    });
-    migrationModules.forEach(definedMigration => {
-      table.addRow({
-        id: definedMigration.dirname,
-        name: definedMigration.migration.name
-      });
-    });
-    table.printTable();
-    output.print('\nRun "sanity migration run <MIGRATION ID>" to run a migration');
+    }
   }
 };
-const commands = [buildCommand, checkCommand, configCheckCommand, datasetGroup, deployCommand, undeployCommand, listDatasetsCommand, createDatasetCommand, datasetVisibilityCommand, exportDatasetCommand, importDatasetCommand, deleteDatasetCommand, copyDatasetCommand, aliasCommand, corsGroup, listCorsOriginsCommand, addCorsOriginCommand, deleteCorsOriginCommand, usersGroup, inviteUserCommand, listUsersCommand, hookGroup, listHooksCommand, createHookCommand, migrationGroup, createMigrationCommand$2, createMigrationCommand$1, createMigrationCommand, deleteHookCommand, listHookLogsCommand, printHookAttemptCommand, documentsGroup, getDocumentsCommand, queryDocumentsCommand, deleteDocumentsCommand, createDocumentsCommand, validateDocumentsCommand, graphqlGroup, listGraphQLAPIsCommand, deployGraphQLAPICommand, deleteGraphQLAPICommand, devCommand, startCommand, previewCommand, uninstallCommand, execCommand];
+const commands = [buildCommand, checkCommand, configCheckCommand, datasetGroup, deployCommand, undeployCommand, listDatasetsCommand, createDatasetCommand, datasetVisibilityCommand, exportDatasetCommand, importDatasetCommand, deleteDatasetCommand, copyDatasetCommand, aliasCommand, corsGroup, listCorsOriginsCommand, addCorsOriginCommand, deleteCorsOriginCommand, usersGroup, inviteUserCommand, listUsersCommand, hookGroup, listHooksCommand, createHookCommand, migrationGroup, createMigrationCommand$1, runMigrationCommand, createMigrationCommand, deleteHookCommand, listHookLogsCommand, printHookAttemptCommand, documentsGroup, getDocumentsCommand, queryDocumentsCommand, deleteDocumentsCommand, createDocumentsCommand, validateDocumentsCommand$1, graphqlGroup, listGraphQLAPIsCommand, deployGraphQLAPICommand, deleteGraphQLAPICommand, devCommand, startCommand, validateDocumentsCommand, previewCommand, uninstallCommand, execCommand];
 const cliProjectCommands = {
   requiredCliVersionRange: "^3.0.0",
   commands
 };
 exports.cliProjectCommands = cliProjectCommands;
+exports.convertToTree = convertToTree;
 exports.debug = debug;
+exports.formatTree = formatTree;
 exports.getClientUrl = getClientUrl;
-//# sourceMappingURL=_internal-2CJ5wSKF.js.map
+exports.maxKeyLength = maxKeyLength;
+//# sourceMappingURL=_internal-6Pl2wJGj.js.map