@sanity/cli 8.22.1 → 8.24.0

package/README.md

@@ -36,14 +36,24 @@ Code for sanity cli
 - [`sanity context build KNOWLEDGEBASEID`](#sanity-context-build-knowledgebaseid)
 - [`sanity context create`](#sanity-context-create)
 - [`sanity context delete KNOWLEDGEBASEID`](#sanity-context-delete-knowledgebaseid)
+- [`sanity context entries get KNOWLEDGEBASEID PATH`](#sanity-context-entries-get-knowledgebaseid-path)
+- [`sanity context entries list KNOWLEDGEBASEID`](#sanity-context-entries-list-knowledgebaseid)
+- [`sanity context entries rebuild KNOWLEDGEBASEID PATH`](#sanity-context-entries-rebuild-knowledgebaseid-path)
 - [`sanity context get KNOWLEDGEBASEID`](#sanity-context-get-knowledgebaseid)
 - [`sanity context imports create KNOWLEDGEBASEID`](#sanity-context-imports-create-knowledgebaseid)
 - [`sanity context imports delete KNOWLEDGEBASEID IMPORTID`](#sanity-context-imports-delete-knowledgebaseid-importid)
 - [`sanity context imports download KNOWLEDGEBASEID IMPORTID`](#sanity-context-imports-download-knowledgebaseid-importid)
 - [`sanity context imports get KNOWLEDGEBASEID IMPORTID`](#sanity-context-imports-get-knowledgebaseid-importid)
 - [`sanity context imports list KNOWLEDGEBASEID`](#sanity-context-imports-list-knowledgebaseid)
+- [`sanity context issues apply KNOWLEDGEBASEID ISSUEID`](#sanity-context-issues-apply-knowledgebaseid-issueid)
+- [`sanity context issues dismiss KNOWLEDGEBASEID ISSUEID`](#sanity-context-issues-dismiss-knowledgebaseid-issueid)
+- [`sanity context issues get KNOWLEDGEBASEID ISSUEID`](#sanity-context-issues-get-knowledgebaseid-issueid)
+- [`sanity context issues list KNOWLEDGEBASEID`](#sanity-context-issues-list-knowledgebaseid)
+- [`sanity context issues reopen KNOWLEDGEBASEID ISSUEID`](#sanity-context-issues-reopen-knowledgebaseid-issueid)
+- [`sanity context issues resolve KNOWLEDGEBASEID ISSUEID`](#sanity-context-issues-resolve-knowledgebaseid-issueid)
 - [`sanity context jobs get KNOWLEDGEBASEID JOBID`](#sanity-context-jobs-get-knowledgebaseid-jobid)
 - [`sanity context list`](#sanity-context-list)
+- [`sanity context query QUERY`](#sanity-context-query-query)
 - [`sanity context refresh KNOWLEDGEBASEID`](#sanity-context-refresh-knowledgebaseid)
 - [`sanity context update KNOWLEDGEBASEID`](#sanity-context-update-knowledgebaseid)
 - [`sanity cors add ORIGIN`](#sanity-cors-add-origin)
@@ -1060,6 +1070,89 @@ EXAMPLES
     $ sanity context delete kb-abc123 --yes
 ```
 
+## `sanity context entries get KNOWLEDGEBASEID PATH`
+
+Get an entry and its content
+
+```
+USAGE
+  $ sanity context entries get KNOWLEDGEBASEID PATH [--json]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+  PATH             Entry path, as listed by `sanity context entries list`
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Get an entry and its content
+
+EXAMPLES
+  Print an entry and its content
+
+    $ sanity context entries get kb-abc123 billing/refunds
+
+  Output the entry, including citations, as JSON
+
+    $ sanity context entries get kb-abc123 billing/refunds --json
+```
+
+## `sanity context entries list KNOWLEDGEBASEID`
+
+List the entries a knowledge base build produced
+
+```
+USAGE
+  $ sanity context entries list KNOWLEDGEBASEID [--json]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List the entries a knowledge base build produced
+
+EXAMPLES
+  List all entries for a knowledge base
+
+    $ sanity context entries list kb-abc123
+
+  Output entries as JSON
+
+    $ sanity context entries list kb-abc123 --json
+```
+
+## `sanity context entries rebuild KNOWLEDGEBASEID PATH`
+
+Rebuild one entry from its sources
+
+```
+USAGE
+  $ sanity context entries rebuild KNOWLEDGEBASEID PATH [--watch]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+  PATH             Entry path, as listed by `sanity context entries list`
+
+FLAGS
+  --watch  Wait for the rebuild to finish, exiting non-zero if it fails
+
+DESCRIPTION
+  Rebuild one entry from its sources
+
+EXAMPLES
+  Start a rebuild and return the job ID
+
+    $ sanity context entries rebuild kb-abc123 billing/refunds
+
+  Rebuild an entry and wait for it to finish (non-zero exit on failure)
+
+    $ sanity context entries rebuild kb-abc123 billing/refunds --watch
+```
+
 ## `sanity context get KNOWLEDGEBASEID`
 
 Get details of a knowledge base
@@ -1239,6 +1332,192 @@ EXAMPLES
     $ sanity context imports list kb-abc123 --json
 ```
 
+## `sanity context issues apply KNOWLEDGEBASEID ISSUEID`
+
+Accept and apply issues to a knowledge base
+
+```
+USAGE
+  $ sanity context issues apply KNOWLEDGEBASEID ISSUEID... [--watch]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+  ISSUEID...       ID of an issue to accept and apply (pass several to apply them in one batch). Conflicts can't be
+                   applied; resolve them with `sanity context issues resolve`
+
+FLAGS
+  --watch  Wait for the apply to finish, exiting non-zero if it fails
+
+DESCRIPTION
+  Accept and apply issues to a knowledge base
+
+EXAMPLES
+  Accept and apply two issues in one batch
+
+    $ sanity context issues apply kb-abc123 issue.def456 issue.ghi789
+
+  Apply an issue and wait for it to finish (non-zero exit on failure)
+
+    $ sanity context issues apply kb-abc123 issue.def456 --watch
+```
+
+## `sanity context issues dismiss KNOWLEDGEBASEID ISSUEID`
+
+Dismiss an issue
+
+```
+USAGE
+  $ sanity context issues dismiss KNOWLEDGEBASEID ISSUEID
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+  ISSUEID          Issue ID
+
+DESCRIPTION
+  Dismiss an issue
+
+  Dismissing is permanent: dismissed issues can't be reopened.
+
+EXAMPLES
+  Dismiss an issue
+
+    $ sanity context issues dismiss kb-abc123 issue.def456
+```
+
+## `sanity context issues get KNOWLEDGEBASEID ISSUEID`
+
+Get details of an issue
+
+```
+USAGE
+  $ sanity context issues get KNOWLEDGEBASEID ISSUEID [--json]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+  ISSUEID          Issue ID
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Get details of an issue
+
+EXAMPLES
+  Get details of a specific issue
+
+    $ sanity context issues get kb-abc123 issue.def456
+
+  Output the issue as JSON
+
+    $ sanity context issues get kb-abc123 issue.def456 --json
+```
+
+## `sanity context issues list KNOWLEDGEBASEID`
+
+List issues found by knowledge base builds
+
+```
+USAGE
+  $ sanity context issues list KNOWLEDGEBASEID [--json] [--kind
+    add_entry|conflict|gap|merge_entry|remove_entry|split_entry|update_required] [--scope <path>] [--severity
+    critical|suggestion] [--status open|accepted|rejected]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+
+FLAGS
+  --kind=<option>      Only list issues of this kind
+                       <options: add_entry|conflict|gap|merge_entry|remove_entry|split_entry|update_required>
+  --scope=<path>       Only list issues about this entry path or anything under it (`*` for knowledge-base-wide issues)
+  --severity=<option>  Only list issues of this severity
+                       <options: critical|suggestion>
+  --status=<option>    Only list issues with this status (rejected = dismissed, accepted = resolved or applied)
+                       <options: open|accepted|rejected>
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List issues found by knowledge base builds
+
+EXAMPLES
+  List all issues for a knowledge base
+
+    $ sanity context issues list kb-abc123
+
+  List issues awaiting triage
+
+    $ sanity context issues list kb-abc123 --status open
+
+  List critical conflicts
+
+    $ sanity context issues list kb-abc123 --kind conflict --severity critical
+
+  List issues about entries under billing/
+
+    $ sanity context issues list kb-abc123 --scope billing
+
+  Output issues as JSON
+
+    $ sanity context issues list kb-abc123 --json
+```
+
+## `sanity context issues reopen KNOWLEDGEBASEID ISSUEID`
+
+Reopen a resolved conflict issue
+
+```
+USAGE
+  $ sanity context issues reopen KNOWLEDGEBASEID ISSUEID
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+  ISSUEID          Issue ID
+
+DESCRIPTION
+  Reopen a resolved conflict issue
+
+EXAMPLES
+  Return a resolved conflict issue to triage
+
+    $ sanity context issues reopen kb-abc123 issue.def456
+```
+
+## `sanity context issues resolve KNOWLEDGEBASEID ISSUEID`
+
+Resolve a conflict issue by choosing the correct side
+
+```
+USAGE
+  $ sanity context issues resolve KNOWLEDGEBASEID ISSUEID [--side <value>] [--watch]
+
+ARGUMENTS
+  KNOWLEDGEBASEID  Knowledge base ID
+  ISSUEID          Issue ID
+
+FLAGS
+  --side=<value>  Index of the correct side, as listed by `sanity context issues get`
+  --watch         Wait for the entry rewrite to finish, exiting non-zero if it fails
+
+DESCRIPTION
+  Resolve a conflict issue by choosing the correct side
+
+  Resolving also creates a standing instruction that future builds follow. `sanity context issues reopen` removes it.
+
+EXAMPLES
+  Interactively choose the correct side of a conflict
+
+    $ sanity context issues resolve kb-abc123 issue.def456
+
+  Choose side 1 and wait for the entry to be rewritten
+
+    $ sanity context issues resolve kb-abc123 issue.def456 --side 1 --watch
+
+  Keep the entry as it is (for a conflict on a single entry)
+
+    $ sanity context issues resolve kb-abc123 issue.def456 --side 0
+```
+
 ## `sanity context jobs get KNOWLEDGEBASEID JOBID`
 
 Get the status of a knowledge base job
@@ -1301,6 +1580,40 @@ EXAMPLES
     $ sanity context list --organization org-abc123 --json
 ```
 
+## `sanity context query QUERY`
+
+Query an organization's Context documents with GROQ
+
+```
+USAGE
+  $ sanity context query QUERY [--json] [--organization <id>] [--params <json>]
+
+ARGUMENTS
+  QUERY  GROQ query to run against the organization's Context documents
+
+FLAGS
+  --params=<json>  Query parameters as a JSON object
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+OVERRIDE FLAGS
+  --organization=<id>  Organization to query (overrides CLI configuration)
+
+DESCRIPTION
+  Query an organization's Context documents with GROQ
+
+EXAMPLES
+  List open issues across all knowledge bases
+
+    $ sanity context query '*[_type == "sanity.context.issue" && status == "open"]{_id, knowledgeBaseId}'
+
+  List the entry paths of one knowledge base as plain JSON
+
+    $ sanity context query '*[_type == "sanity.context.entry" && knowledgeBaseId == $kb].path' --params '{"kb": \
+      "kb-abc123"}' --json
+```
+
 ## `sanity context refresh KNOWLEDGEBASEID`
 
 Refresh a knowledge base: re-check sources and apply what changed

package/dist/actions/codemods/dashboard.js

@@ -1,17 +1,47 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
 import { findPathForFiles, getCliConfig, getLocalPackageVersion, getStudioConfig, isWorkbenchApp, tryFindStudioConfigPath } from '@sanity/cli-core';
-import { input, select } from '@sanity/cli-core/ux';
+import { getYarnMajorVersion, readPackageJson } from '@sanity/cli-core/package-manager';
+import { confirm, input, select } from '@sanity/cli-core/ux';
 import { toAppSlug } from '@sanity/workbench-cli/init';
+import { execa } from 'execa';
 import { lt } from 'semver';
+import yaml from 'yaml';
 import { getOrganizationGrants, listOrganizations } from '../../services/organizations.js';
 import { getProjectById } from '../../services/projects.js';
+import { determineIsApp } from '../../util/determineIsApp.js';
+import { detectWorkspace } from '../../util/packageManager/installationInfo/detectWorkspace.js';
+import { getPackageManagerChoice, getPartialEnvWithNpmPath } from '../../util/packageManager/packageManagerChoice.js';
 import { getManageUrl } from '../projects/getManageUrl.js';
-// The first `sanity` release whose `sanity/cli` exports `defineApplication`
-const MIN_SANITY_VERSION = '6.12.0';
+// `defineApplication` landed in 6.12.0; the Dashboard also needs the CLI fixes released since
+const MIN_SANITY_VERSION = '6.20.0';
+const MIN_SDK_VERSION = '3.9.1';
+async function findOutdated(packages, workDir) {
+    const installed = await Promise.all(packages.map(({ name })=>getLocalPackageVersion(name, workDir)));
+    return packages.flatMap((pkg, index)=>{
+        const version = installed[index];
+        return version && lt(version, pkg.min) ? [
+            {
+                ...pkg,
+                version
+            }
+        ] : [];
+    });
+}
+// corepack's `packageManager: "yarn@4.9.1"` names the major even without a .yarnrc.yml
+function declaredYarnMajor(field) {
+    const match = typeof field === 'string' ? /^yarn@(\d+)/.exec(field) : null;
+    return match ? Number.parseInt(match[1], 10) : undefined;
+}
+function listOutdated(packages) {
+    return packages.map(({ min, name, neededBy, version })=>`  - ${name} ${version} (${neededBy} ${min} or later)`).join('\n');
+}
 const purpose = 'Move an existing Studio or SDK app onto the Dashboard';
 const description = `
 Rewrites sanity.cli.ts (or .js) so the next \`sanity dev\` and \`sanity deploy\` run the project
 as a new Dashboard application. Asks for the application's title and slug, and looks up the
-organization from the project.
+organization from the project. Offers to upgrade sanity (older than ${MIN_SANITY_VERSION}) and, in
+SDK apps, @sanity/sdk and @sanity/sdk-react (older than ${MIN_SDK_VERSION}) to their latest versions.
 
 from: app: {organizationId: 'oAbc', entry: './src/App.tsx'}
   to: app: defineApplication({title: 'Acme', slug: 'acme', organizationId: 'oAbc', entry: './src/App.tsx'})
@@ -22,7 +52,7 @@ Dashboard build replaces the existing application.
 export const dashboard = {
     description,
     filename: 'dashboard.js',
-    prepare: async ({ output, workDir })=>{
+    prepare: async ({ dry, output, workDir })=>{
         const config = await getCliConfig(workDir);
         if (isWorkbenchApp(config.app)) {
             throw new Error('This project is already a Dashboard application.');
@@ -88,9 +118,107 @@ export const dashboard = {
         if (appIdKey) {
             output.warn(`Remove \`${appIdKey}\` from your CLI config before you deploy. It points at your existing application, and deploying with it in place replaces that application with the Dashboard build.`);
         }
-        const sanityVersion = await getLocalPackageVersion('sanity', workDir);
-        if (sanityVersion && lt(sanityVersion, MIN_SANITY_VERSION)) {
-            output.warn(`This project uses sanity ${sanityVersion}, and \`defineApplication\` needs ${MIN_SANITY_VERSION} or later. Upgrade sanity before you run \`sanity dev\` or \`sanity deploy\`.`);
+        const required = [
+            {
+                min: MIN_SANITY_VERSION,
+                name: 'sanity',
+                neededBy: 'the Dashboard needs'
+            },
+            ...determineIsApp(config) ? [
+                '@sanity/sdk',
+                '@sanity/sdk-react'
+            ].map((name)=>({
+                    min: MIN_SDK_VERSION,
+                    name,
+                    neededBy: 'SDK apps need'
+                })) : []
+        ];
+        const outdated = await findOutdated(required, workDir);
+        if (outdated.length > 0) {
+            output.warn(`\`sanity dev\` and \`sanity deploy\` will fail until you upgrade:\n${listOutdated(outdated)}`);
+            const { chosen: packageManager } = await getPackageManagerChoice(workDir, {
+                interactive: false
+            });
+            const { root, yarnBerry } = await detectWorkspace(workDir);
+            const [{ dependencies, devDependencies }, rootManifest] = await Promise.all([
+                readPackageJson(path.join(workDir, 'package.json'), {
+                    skipSchemaValidation: true
+                }),
+                readFile(path.join(root, 'package.json'), 'utf8').then(JSON.parse, ()=>null)
+            ]);
+            let pnpmOverrides = [];
+            if (packageManager === 'pnpm') {
+                const workspacePath = path.join(root, 'pnpm-workspace.yaml');
+                const workspaceConfig = await readFile(workspacePath, 'utf8').then(yaml.parse, ()=>null);
+                pnpmOverrides = Object.keys({
+                    ...rootManifest?.pnpm?.overrides,
+                    ...workspaceConfig?.overrides
+                });
+            }
+            // bun's upgrade leaves a catalog untouched, yarn's swaps `catalog:` for a plain range, and
+            // pnpm's does the same when `overrides` pins the package
+            const isUnupgradableCatalog = (name)=>(dependencies?.[name] ?? devDependencies?.[name] ?? '').startsWith('catalog:') && (packageManager === 'bun' || packageManager === 'yarn' || pnpmOverrides.some((key)=>key === name || key.startsWith(`${name}@`)));
+            const catalogued = outdated.filter(({ name })=>isUnupgradableCatalog(name));
+            const upgradable = outdated.filter(({ name })=>!isUnupgradableCatalog(name));
+            if (catalogued.length > 0) {
+                const targets = catalogued.map(({ min, name })=>`${name} to ^${min} or later`).join(', ');
+                const install = `then run \`${packageManager} install\``;
+                output.log(packageManager === 'pnpm' ? `pnpm can't upgrade catalog packages that \`overrides\` pin, so update them yourself: set ${targets} in the catalog and in \`overrides\`, ${install}.` : `${packageManager} can't upgrade catalog packages, so update them yourself: set ${targets} in the catalog in ${packageManager === 'bun' ? 'the root package.json' : '.yarnrc.yml'}, ${install}.`);
+            }
+            if (upgradable.length > 0) {
+                const names = upgradable.map(({ name })=>name);
+                const latest = names.map((name)=>`${name}@latest`);
+                // Berry dropped `yarn upgrade`, and the user agent only names yarn when the CLI itself was
+                // run through yarn, so take the project's own signals first
+                const isYarnBerry = yarnBerry || (declaredYarnMajor(rootManifest?.packageManager) ?? getYarnMajorVersion() ?? 1) >= 2;
+                // pnpm keeps `catalog:` and bumps the catalog entry only with `update --latest`
+                const command = {
+                    bun: [
+                        'bun',
+                        'update',
+                        ...latest
+                    ],
+                    manual: undefined,
+                    npm: [
+                        'npm',
+                        'install',
+                        '--legacy-peer-deps',
+                        ...latest
+                    ],
+                    pnpm: [
+                        'pnpm',
+                        'update',
+                        ...names,
+                        '--latest'
+                    ],
+                    yarn: [
+                        'yarn',
+                        isYarnBerry ? 'up' : 'upgrade',
+                        ...latest
+                    ]
+                }[packageManager];
+                if (!command) {
+                    output.log(`Upgrade ${names.join(', ')} to the latest version with your package manager.`);
+                } else if (dry || !await confirm({
+                    default: true,
+                    message: `Upgrade ${names.join(', ')} to the latest version now?`
+                })) {
+                    output.log(`Run \`${command.join(' ')}\` to upgrade.`);
+                } else {
+                    output.log(`Running \`${command.join(' ')}\``);
+                    // The version check below reports a failed upgrade, so the exit code isn't needed
+                    await execa(command[0], command.slice(1), {
+                        cwd: workDir,
+                        env: getPartialEnvWithNpmPath(workDir),
+                        reject: false,
+                        stdio: 'inherit'
+                    });
+                    const stillOutdated = await findOutdated(upgradable, workDir);
+                    if (stillOutdated.length > 0) {
+                        output.warn(`These are still too old after the upgrade. Upgrade them before you run \`sanity dev\` or \`sanity deploy\`:\n${listOutdated(stillOutdated)}`);
+                    }
+                }
+            }
         }
         // getCliConfig has already checked there is exactly one
         const cliConfigPaths = await findPathForFiles(workDir, [

package/dist/actions/codemods/dashboard.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/codemods/dashboard.ts"],"sourcesContent":["import {\n  findPathForFiles,\n  getCliConfig,\n  getLocalPackageVersion,\n  getStudioConfig,\n  isWorkbenchApp,\n  tryFindStudioConfigPath,\n} from '@sanity/cli-core'\nimport {input, select} from '@sanity/cli-core/ux'\nimport {toAppSlug} from '@sanity/workbench-cli/init'\nimport {lt} from 'semver'\n\nimport {getOrganizationGrants, listOrganizations} from '../../services/organizations.js'\nimport {getProjectById} from '../../services/projects.js'\nimport {getManageUrl} from '../projects/getManageUrl.js'\nimport {type CodeMod} from './types.js'\n\n// The first `sanity` release whose `sanity/cli` exports `defineApplication`\nconst MIN_SANITY_VERSION = '6.12.0'\n\nconst purpose = 'Move an existing Studio or SDK app onto the Dashboard'\nconst description = `\nRewrites sanity.cli.ts (or .js) so the next \\`sanity dev\\` and \\`sanity deploy\\` run the project\nas a new Dashboard application. Asks for the application's title and slug, and looks up the\norganization from the project.\n\nfrom: app: {organizationId: 'oAbc', entry: './src/App.tsx'}\n  to: app: defineApplication({title: 'Acme', slug: 'acme', organizationId: 'oAbc', entry: './src/App.tsx'})\n\nThe existing deployment is left alone. Remove \\`deployment.appId\\` before deploying, or the\nDashboard build replaces the existing application.\n`.trim()\n\nexport const dashboard: CodeMod = {\n  description,\n  filename: 'dashboard.js',\n  prepare: async ({output, workDir}) => {\n    const config = await getCliConfig(workDir)\n    if (isWorkbenchApp(config.app)) {\n      throw new Error('This project is already a Dashboard application.')\n    }\n\n    const projectId = config.api?.projectId\n    let organizationId = config.app?.organizationId\n    // Deploy creates the application with both IDs, and the API rejects a project outside the\n    // organization, so a project's organization is the only valid choice\n    if (!organizationId && projectId) {\n      organizationId = (await getProjectById(projectId)).organizationId ?? undefined\n      if (!organizationId) {\n        throw new Error(\n          `Project ${projectId} isn't in an organization, and a Dashboard application needs one. Move the project into an organization at ${getManageUrl(projectId)}, then run this again.`,\n        )\n      }\n    }\n    if (!organizationId) {\n      const choices = await Promise.all(\n        (await listOrganizations()).map(async ({id, name}) => {\n          // Grants can 401 for implicit memberships; treat any failure as no access\n          const grants = await getOrganizationGrants(id).catch(() => null)\n          const canDeploy = (grants?.['sanity.sdk.applications'] ?? []).some((resource) =>\n            resource.grants.some((grant) => grant.name === 'deploy'),\n          )\n          return {\n            disabled: canDeploy ? false : 'Insufficient permissions',\n            name: `${name} [${id}]`,\n            value: id,\n          }\n        }),\n      )\n      if (!choices.some((choice) => choice.disabled === false)) {\n        throw new Error(\n          \"You can't deploy applications in any of your organizations. Ask an organization administrator for access, then run this again.\",\n        )\n      }\n      organizationId = await select({choices, message: 'Organization that owns the application:'})\n    }\n\n    let suggestedTitle = config.app?.title\n    if (!suggestedTitle && (await tryFindStudioConfigPath(workDir))) {\n      const studioConfig = await getStudioConfig(workDir, {resolvePlugins: false})\n      suggestedTitle = Array.isArray(studioConfig) ? undefined : studioConfig.title\n    }\n\n    const title = await input({\n      default: suggestedTitle,\n      message: 'Application title:',\n      validate: (value) => (value.trim() ? true : 'Enter a title for the application.'),\n    })\n\n    // A studio titled after its host would otherwise suggest the one slug that's rejected\n    const suggestedSlug = toAppSlug(title) ?? undefined\n    const slug = await input({\n      default: suggestedSlug === config.studioHost ? undefined : suggestedSlug,\n      message: 'Application slug (the hostname it deploys to):',\n      validate: (value) => {\n        if (toAppSlug(value) !== value) {\n          return 'Use lowercase letters, numbers and hyphens, starting with a letter.'\n        }\n        if (value === config.studioHost) {\n          return `\"${value}\" is your Studio's hostname (studioHost), so the deploy would fail. Choose a different slug.`\n        }\n        return true\n      },\n    })\n\n    // `app.id` is the deprecated spelling and deploy still honours it\n    const appIdKey = config.deployment?.appId ? 'deployment.appId' : config.app?.id && 'app.id'\n    if (appIdKey) {\n      output.warn(\n        `Remove \\`${appIdKey}\\` from your CLI config before you deploy. It points at your existing application, and deploying with it in place replaces that application with the Dashboard build.`,\n      )\n    }\n\n    const sanityVersion = await getLocalPackageVersion('sanity', workDir)\n    if (sanityVersion && lt(sanityVersion, MIN_SANITY_VERSION)) {\n      output.warn(\n        `This project uses sanity ${sanityVersion}, and \\`defineApplication\\` needs ${MIN_SANITY_VERSION} or later. Upgrade sanity before you run \\`sanity dev\\` or \\`sanity deploy\\`.`,\n      )\n    }\n\n    // getCliConfig has already checked there is exactly one\n    const cliConfigPaths = await findPathForFiles(workDir, ['sanity.cli.ts', 'sanity.cli.js'])\n    const paths = cliConfigPaths.filter((path) => path.exists).map((path) => path.path)\n\n    return {options: {organizationId, slug, title: title.trim()}, paths}\n  },\n  purpose,\n}\n"],"names":["findPathForFiles","getCliConfig","getLocalPackageVersion","getStudioConfig","isWorkbenchApp","tryFindStudioConfigPath","input","select","toAppSlug","lt","getOrganizationGrants","listOrganizations","getProjectById","getManageUrl","MIN_SANITY_VERSION","purpose","description","trim","dashboard","filename","prepare","output","workDir","config","app","Error","projectId","api","organizationId","undefined","choices","Promise","all","map","id","name","grants","catch","canDeploy","some","resource","grant","disabled","value","choice","message","suggestedTitle","title","studioConfig","resolvePlugins","Array","isArray","default","validate","suggestedSlug","slug","studioHost","appIdKey","deployment","appId","warn","sanityVersion","cliConfigPaths","paths","filter","path","exists","options"],"mappings":"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"}
+{"version":3,"sources":["../../../src/actions/codemods/dashboard.ts"],"sourcesContent":["import {readFile} from 'node:fs/promises'\nimport path from 'node:path'\n\nimport {\n  findPathForFiles,\n  getCliConfig,\n  getLocalPackageVersion,\n  getStudioConfig,\n  isWorkbenchApp,\n  tryFindStudioConfigPath,\n} from '@sanity/cli-core'\nimport {getYarnMajorVersion, readPackageJson} from '@sanity/cli-core/package-manager'\nimport {confirm, input, select} from '@sanity/cli-core/ux'\nimport {toAppSlug} from '@sanity/workbench-cli/init'\nimport {execa} from 'execa'\nimport {lt} from 'semver'\nimport yaml from 'yaml'\n\nimport {getOrganizationGrants, listOrganizations} from '../../services/organizations.js'\nimport {getProjectById} from '../../services/projects.js'\nimport {determineIsApp} from '../../util/determineIsApp.js'\nimport {detectWorkspace} from '../../util/packageManager/installationInfo/detectWorkspace.js'\nimport {\n  getPackageManagerChoice,\n  getPartialEnvWithNpmPath,\n} from '../../util/packageManager/packageManagerChoice.js'\nimport {getManageUrl} from '../projects/getManageUrl.js'\nimport {type CodeMod} from './types.js'\n\n// `defineApplication` landed in 6.12.0; the Dashboard also needs the CLI fixes released since\nconst MIN_SANITY_VERSION = '6.20.0'\nconst MIN_SDK_VERSION = '3.9.1'\n\ninterface RequiredPackage {\n  min: string\n  name: string\n  neededBy: string\n}\n\nasync function findOutdated(packages: RequiredPackage[], workDir: string) {\n  const installed = await Promise.all(\n    packages.map(({name}) => getLocalPackageVersion(name, workDir)),\n  )\n  return packages.flatMap((pkg, index) => {\n    const version = installed[index]\n    return version && lt(version, pkg.min) ? [{...pkg, version}] : []\n  })\n}\n\n// corepack's `packageManager: \"yarn@4.9.1\"` names the major even without a .yarnrc.yml\nfunction declaredYarnMajor(field: unknown) {\n  const match = typeof field === 'string' ? /^yarn@(\\d+)/.exec(field) : null\n  return match ? Number.parseInt(match[1], 10) : undefined\n}\n\nfunction listOutdated(packages: Awaited<ReturnType<typeof findOutdated>>) {\n  return packages\n    .map(({min, name, neededBy, version}) => `  - ${name} ${version} (${neededBy} ${min} or later)`)\n    .join('\\n')\n}\n\nconst purpose = 'Move an existing Studio or SDK app onto the Dashboard'\nconst description = `\nRewrites sanity.cli.ts (or .js) so the next \\`sanity dev\\` and \\`sanity deploy\\` run the project\nas a new Dashboard application. Asks for the application's title and slug, and looks up the\norganization from the project. Offers to upgrade sanity (older than ${MIN_SANITY_VERSION}) and, in\nSDK apps, @sanity/sdk and @sanity/sdk-react (older than ${MIN_SDK_VERSION}) to their latest versions.\n\nfrom: app: {organizationId: 'oAbc', entry: './src/App.tsx'}\n  to: app: defineApplication({title: 'Acme', slug: 'acme', organizationId: 'oAbc', entry: './src/App.tsx'})\n\nThe existing deployment is left alone. Remove \\`deployment.appId\\` before deploying, or the\nDashboard build replaces the existing application.\n`.trim()\n\nexport const dashboard: CodeMod = {\n  description,\n  filename: 'dashboard.js',\n  prepare: async ({dry, output, workDir}) => {\n    const config = await getCliConfig(workDir)\n    if (isWorkbenchApp(config.app)) {\n      throw new Error('This project is already a Dashboard application.')\n    }\n\n    const projectId = config.api?.projectId\n    let organizationId = config.app?.organizationId\n    // Deploy creates the application with both IDs, and the API rejects a project outside the\n    // organization, so a project's organization is the only valid choice\n    if (!organizationId && projectId) {\n      organizationId = (await getProjectById(projectId)).organizationId ?? undefined\n      if (!organizationId) {\n        throw new Error(\n          `Project ${projectId} isn't in an organization, and a Dashboard application needs one. Move the project into an organization at ${getManageUrl(projectId)}, then run this again.`,\n        )\n      }\n    }\n    if (!organizationId) {\n      const choices = await Promise.all(\n        (await listOrganizations()).map(async ({id, name}) => {\n          // Grants can 401 for implicit memberships; treat any failure as no access\n          const grants = await getOrganizationGrants(id).catch(() => null)\n          const canDeploy = (grants?.['sanity.sdk.applications'] ?? []).some((resource) =>\n            resource.grants.some((grant) => grant.name === 'deploy'),\n          )\n          return {\n            disabled: canDeploy ? false : 'Insufficient permissions',\n            name: `${name} [${id}]`,\n            value: id,\n          }\n        }),\n      )\n      if (!choices.some((choice) => choice.disabled === false)) {\n        throw new Error(\n          \"You can't deploy applications in any of your organizations. Ask an organization administrator for access, then run this again.\",\n        )\n      }\n      organizationId = await select({choices, message: 'Organization that owns the application:'})\n    }\n\n    let suggestedTitle = config.app?.title\n    if (!suggestedTitle && (await tryFindStudioConfigPath(workDir))) {\n      const studioConfig = await getStudioConfig(workDir, {resolvePlugins: false})\n      suggestedTitle = Array.isArray(studioConfig) ? undefined : studioConfig.title\n    }\n\n    const title = await input({\n      default: suggestedTitle,\n      message: 'Application title:',\n      validate: (value) => (value.trim() ? true : 'Enter a title for the application.'),\n    })\n\n    // A studio titled after its host would otherwise suggest the one slug that's rejected\n    const suggestedSlug = toAppSlug(title) ?? undefined\n    const slug = await input({\n      default: suggestedSlug === config.studioHost ? undefined : suggestedSlug,\n      message: 'Application slug (the hostname it deploys to):',\n      validate: (value) => {\n        if (toAppSlug(value) !== value) {\n          return 'Use lowercase letters, numbers and hyphens, starting with a letter.'\n        }\n        if (value === config.studioHost) {\n          return `\"${value}\" is your Studio's hostname (studioHost), so the deploy would fail. Choose a different slug.`\n        }\n        return true\n      },\n    })\n\n    // `app.id` is the deprecated spelling and deploy still honours it\n    const appIdKey = config.deployment?.appId ? 'deployment.appId' : config.app?.id && 'app.id'\n    if (appIdKey) {\n      output.warn(\n        `Remove \\`${appIdKey}\\` from your CLI config before you deploy. It points at your existing application, and deploying with it in place replaces that application with the Dashboard build.`,\n      )\n    }\n\n    const required: RequiredPackage[] = [\n      {min: MIN_SANITY_VERSION, name: 'sanity', neededBy: 'the Dashboard needs'},\n      ...(determineIsApp(config)\n        ? ['@sanity/sdk', '@sanity/sdk-react'].map((name) => ({\n            min: MIN_SDK_VERSION,\n            name,\n            neededBy: 'SDK apps need',\n          }))\n        : []),\n    ]\n    const outdated = await findOutdated(required, workDir)\n    if (outdated.length > 0) {\n      output.warn(\n        `\\`sanity dev\\` and \\`sanity deploy\\` will fail until you upgrade:\\n${listOutdated(outdated)}`,\n      )\n\n      const {chosen: packageManager} = await getPackageManagerChoice(workDir, {interactive: false})\n      const {root, yarnBerry} = await detectWorkspace(workDir)\n      const [{dependencies, devDependencies}, rootManifest] = await Promise.all([\n        readPackageJson(path.join(workDir, 'package.json'), {skipSchemaValidation: true}),\n        readFile(path.join(root, 'package.json'), 'utf8').then(JSON.parse, () => null),\n      ])\n      let pnpmOverrides: string[] = []\n      if (packageManager === 'pnpm') {\n        const workspacePath = path.join(root, 'pnpm-workspace.yaml')\n        const workspaceConfig = await readFile(workspacePath, 'utf8').then(yaml.parse, () => null)\n        pnpmOverrides = Object.keys({\n          ...rootManifest?.pnpm?.overrides,\n          ...workspaceConfig?.overrides,\n        })\n      }\n\n      // bun's upgrade leaves a catalog untouched, yarn's swaps `catalog:` for a plain range, and\n      // pnpm's does the same when `overrides` pins the package\n      const isUnupgradableCatalog = (name: string) =>\n        (dependencies?.[name] ?? devDependencies?.[name] ?? '').startsWith('catalog:') &&\n        (packageManager === 'bun' ||\n          packageManager === 'yarn' ||\n          pnpmOverrides.some((key) => key === name || key.startsWith(`${name}@`)))\n      const catalogued = outdated.filter(({name}) => isUnupgradableCatalog(name))\n      const upgradable = outdated.filter(({name}) => !isUnupgradableCatalog(name))\n\n      if (catalogued.length > 0) {\n        const targets = catalogued.map(({min, name}) => `${name} to ^${min} or later`).join(', ')\n        const install = `then run \\`${packageManager} install\\``\n        output.log(\n          packageManager === 'pnpm'\n            ? `pnpm can't upgrade catalog packages that \\`overrides\\` pin, so update them yourself: set ${targets} in the catalog and in \\`overrides\\`, ${install}.`\n            : `${packageManager} can't upgrade catalog packages, so update them yourself: set ${targets} in the catalog in ${packageManager === 'bun' ? 'the root package.json' : '.yarnrc.yml'}, ${install}.`,\n        )\n      }\n\n      if (upgradable.length > 0) {\n        const names = upgradable.map(({name}) => name)\n        const latest = names.map((name) => `${name}@latest`)\n        // Berry dropped `yarn upgrade`, and the user agent only names yarn when the CLI itself was\n        // run through yarn, so take the project's own signals first\n        const isYarnBerry =\n          yarnBerry ||\n          (declaredYarnMajor(rootManifest?.packageManager) ?? getYarnMajorVersion() ?? 1) >= 2\n        // pnpm keeps `catalog:` and bumps the catalog entry only with `update --latest`\n        const command = {\n          bun: ['bun', 'update', ...latest],\n          manual: undefined,\n          npm: ['npm', 'install', '--legacy-peer-deps', ...latest],\n          pnpm: ['pnpm', 'update', ...names, '--latest'],\n          yarn: ['yarn', isYarnBerry ? 'up' : 'upgrade', ...latest],\n        }[packageManager]\n\n        if (!command) {\n          output.log(`Upgrade ${names.join(', ')} to the latest version with your package manager.`)\n        } else if (\n          dry ||\n          !(await confirm({\n            default: true,\n            message: `Upgrade ${names.join(', ')} to the latest version now?`,\n          }))\n        ) {\n          output.log(`Run \\`${command.join(' ')}\\` to upgrade.`)\n        } else {\n          output.log(`Running \\`${command.join(' ')}\\``)\n          // The version check below reports a failed upgrade, so the exit code isn't needed\n          await execa(command[0], command.slice(1), {\n            cwd: workDir,\n            env: getPartialEnvWithNpmPath(workDir),\n            reject: false,\n            stdio: 'inherit',\n          })\n          const stillOutdated = await findOutdated(upgradable, workDir)\n          if (stillOutdated.length > 0) {\n            output.warn(\n              `These are still too old after the upgrade. Upgrade them before you run \\`sanity dev\\` or \\`sanity deploy\\`:\\n${listOutdated(stillOutdated)}`,\n            )\n          }\n        }\n      }\n    }\n\n    // getCliConfig has already checked there is exactly one\n    const cliConfigPaths = await findPathForFiles(workDir, ['sanity.cli.ts', 'sanity.cli.js'])\n    const paths = cliConfigPaths.filter((path) => path.exists).map((path) => path.path)\n\n    return {options: {organizationId, slug, title: title.trim()}, paths}\n  },\n  purpose,\n}\n"],"names":["readFile","path","findPathForFiles","getCliConfig","getLocalPackageVersion","getStudioConfig","isWorkbenchApp","tryFindStudioConfigPath","getYarnMajorVersion","readPackageJson","confirm","input","select","toAppSlug","execa","lt","yaml","getOrganizationGrants","listOrganizations","getProjectById","determineIsApp","detectWorkspace","getPackageManagerChoice","getPartialEnvWithNpmPath","getManageUrl","MIN_SANITY_VERSION","MIN_SDK_VERSION","findOutdated","packages","workDir","installed","Promise","all","map","name","flatMap","pkg","index","version","min","declaredYarnMajor","field","match","exec","Number","parseInt","undefined","listOutdated","neededBy","join","purpose","description","trim","dashboard","filename","prepare","dry","output","config","app","Error","projectId","api","organizationId","choices","id","grants","catch","canDeploy","some","resource","grant","disabled","value","choice","message","suggestedTitle","title","studioConfig","resolvePlugins","Array","isArray","default","validate","suggestedSlug","slug","studioHost","appIdKey","deployment","appId","warn","required","outdated","length","chosen","packageManager","interactive","root","yarnBerry","dependencies","devDependencies","rootManifest","skipSchemaValidation","then","JSON","parse","pnpmOverrides","workspacePath","workspaceConfig","Object","keys","pnpm","overrides","isUnupgradableCatalog","startsWith","key","catalogued","filter","upgradable","targets","install","log","names","latest","isYarnBerry","command","bun","manual","npm","yarn","slice","cwd","env","reject","stdio","stillOutdated","cliConfigPaths","paths","exists","options"],"mappings":"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"}

package/dist/actions/codemods/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/codemods/types.ts"],"sourcesContent":["import {type Output} from '@sanity/cli-core'\n\nexport interface CodeMod {\n  description: string\n  // Must match filename in `cli/codemods/`\n  filename: string\n  purpose: string\n\n  /**\n   * Runs in the CLI process before the transform (prompts, API lookups). `options` reach the\n   * transform's `options` argument; `paths` replace the default target of the whole directory.\n   */\n  prepare?: (context: {output: Output; workDir: string}) => Promise<{\n    options: Record<string, string>\n    paths: string[]\n  }>\n  verify?: (context: {workDir: string}) => Promise<void>\n}\n"],"names":[],"mappings":"AAEA,WAeC"}
+{"version":3,"sources":["../../../src/actions/codemods/types.ts"],"sourcesContent":["import {type Output} from '@sanity/cli-core'\n\nexport interface CodeMod {\n  description: string\n  // Must match filename in `cli/codemods/`\n  filename: string\n  purpose: string\n\n  /**\n   * Runs in the CLI process before the transform (prompts, API lookups). `options` reach the\n   * transform's `options` argument; `paths` replace the default target of the whole directory.\n   */\n  prepare?: (context: {dry: boolean; output: Output; workDir: string}) => Promise<{\n    options: Record<string, string>\n    paths: string[]\n  }>\n  verify?: (context: {workDir: string}) => Promise<void>\n}\n"],"names":[],"mappings":"AAEA,WAeC"}

package/dist/actions/context/watchJob.js

@@ -1,5 +1,11 @@
 import { spinner } from '@sanity/cli-core/ux';
 import { waitForJob } from './waitForJob.js';
+/**
+ * Error message for a job that ended in a non-succeeded terminal state,
+ * e.g. "Build failed: <reason>"
+ */ export function formatJobFailure(noun, job) {
+    return `${noun} ${job.status}${job.error ? `: ${job.error}` : ''}`;
+}
 /**
  * Watch a knowledge base job with a spinner until it reaches a terminal
  * state, updating the spinner text with the job status on each poll.
@@ -18,13 +24,13 @@ import { waitForJob } from './waitForJob.js';
             }
         });
     } catch (error) {
-        spin.fail();
+        spin.fail(label);
         throw error;
     }
     if (job.status === 'succeeded') {
-        spin.succeed(successText);
+        spin.succeed(successText ?? label);
     } else {
-        spin.fail();
+        spin.fail(label);
     }
     return job;
 }

package/dist/actions/context/watchJob.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/context/watchJob.ts"],"sourcesContent":["import {spinner} from '@sanity/cli-core/ux'\nimport {type Context} from '@sanity/client'\n\nimport {waitForJob} from './waitForJob.js'\n\n/**\n * Watch a knowledge base job with a spinner until it reaches a terminal\n * state, updating the spinner text with the job status on each poll.\n *\n * Fails the spinner and rethrows on polling errors, and fails it when the\n * terminal status is not `succeeded` — turning either outcome into a\n * command error (and exit code) is the caller's responsibility.\n */\nexport async function watchJob(\n  knowledgeBaseId: string,\n  jobId: string,\n  options: {label: string; successText?: string},\n): Promise<Context.Job> {\n  const {label, successText} = options\n  const spin = spinner(label).start()\n\n  let job: Context.Job\n  try {\n    job = await waitForJob(knowledgeBaseId, jobId, {\n      onPoll: (pending) => {\n        spin.text = `${label} (${pending.status})`\n      },\n    })\n  } catch (error) {\n    spin.fail()\n    throw error\n  }\n\n  if (job.status === 'succeeded') {\n    spin.succeed(successText)\n  } else {\n    spin.fail()\n  }\n\n  return job\n}\n"],"names":["spinner","waitForJob","watchJob","knowledgeBaseId","jobId","options","label","successText","spin","start","job","onPoll","pending","text","status","error","fail","succeed"],"mappings":"AAAA,SAAQA,OAAO,QAAO,sBAAqB;AAG3C,SAAQC,UAAU,QAAO,kBAAiB;AAE1C;;;;;;;CAOC,GACD,OAAO,eAAeC,SACpBC,eAAuB,EACvBC,KAAa,EACbC,OAA8C;IAE9C,MAAM,EAACC,KAAK,EAAEC,WAAW,EAAC,GAAGF;IAC7B,MAAMG,OAAOR,QAAQM,OAAOG,KAAK;IAEjC,IAAIC;IACJ,IAAI;QACFA,MAAM,MAAMT,WAAWE,iBAAiBC,OAAO;YAC7CO,QAAQ,CAACC;gBACPJ,KAAKK,IAAI,GAAG,GAAGP,MAAM,EAAE,EAAEM,QAAQE,MAAM,CAAC,CAAC,CAAC;YAC5C;QACF;IACF,EAAE,OAAOC,OAAO;QACdP,KAAKQ,IAAI;QACT,MAAMD;IACR;IAEA,IAAIL,IAAII,MAAM,KAAK,aAAa;QAC9BN,KAAKS,OAAO,CAACV;IACf,OAAO;QACLC,KAAKQ,IAAI;IACX;IAEA,OAAON;AACT"}
+{"version":3,"sources":["../../../src/actions/context/watchJob.ts"],"sourcesContent":["import {spinner} from '@sanity/cli-core/ux'\nimport {type Context} from '@sanity/client'\n\nimport {waitForJob} from './waitForJob.js'\n\n/**\n * Error message for a job that ended in a non-succeeded terminal state,\n * e.g. \"Build failed: <reason>\"\n */\nexport function formatJobFailure(noun: string, job: Context.Job): string {\n  return `${noun} ${job.status}${job.error ? `: ${job.error}` : ''}`\n}\n\n/**\n * Watch a knowledge base job with a spinner until it reaches a terminal\n * state, updating the spinner text with the job status on each poll.\n *\n * Fails the spinner and rethrows on polling errors, and fails it when the\n * terminal status is not `succeeded` — turning either outcome into a\n * command error (and exit code) is the caller's responsibility.\n */\nexport async function watchJob(\n  knowledgeBaseId: string,\n  jobId: string,\n  options: {label: string; successText?: string},\n): Promise<Context.Job> {\n  const {label, successText} = options\n  const spin = spinner(label).start()\n\n  let job: Context.Job\n  try {\n    job = await waitForJob(knowledgeBaseId, jobId, {\n      onPoll: (pending) => {\n        spin.text = `${label} (${pending.status})`\n      },\n    })\n  } catch (error) {\n    spin.fail(label)\n    throw error\n  }\n\n  if (job.status === 'succeeded') {\n    spin.succeed(successText ?? label)\n  } else {\n    spin.fail(label)\n  }\n\n  return job\n}\n"],"names":["spinner","waitForJob","formatJobFailure","noun","job","status","error","watchJob","knowledgeBaseId","jobId","options","label","successText","spin","start","onPoll","pending","text","fail","succeed"],"mappings":"AAAA,SAAQA,OAAO,QAAO,sBAAqB;AAG3C,SAAQC,UAAU,QAAO,kBAAiB;AAE1C;;;CAGC,GACD,OAAO,SAASC,iBAAiBC,IAAY,EAAEC,GAAgB;IAC7D,OAAO,GAAGD,KAAK,CAAC,EAAEC,IAAIC,MAAM,GAAGD,IAAIE,KAAK,GAAG,CAAC,EAAE,EAAEF,IAAIE,KAAK,EAAE,GAAG,IAAI;AACpE;AAEA;;;;;;;CAOC,GACD,OAAO,eAAeC,SACpBC,eAAuB,EACvBC,KAAa,EACbC,OAA8C;IAE9C,MAAM,EAACC,KAAK,EAAEC,WAAW,EAAC,GAAGF;IAC7B,MAAMG,OAAOb,QAAQW,OAAOG,KAAK;IAEjC,IAAIV;IACJ,IAAI;QACFA,MAAM,MAAMH,WAAWO,iBAAiBC,OAAO;YAC7CM,QAAQ,CAACC;gBACPH,KAAKI,IAAI,GAAG,GAAGN,MAAM,EAAE,EAAEK,QAAQX,MAAM,CAAC,CAAC,CAAC;YAC5C;QACF;IACF,EAAE,OAAOC,OAAO;QACdO,KAAKK,IAAI,CAACP;QACV,MAAML;IACR;IAEA,IAAIF,IAAIC,MAAM,KAAK,aAAa;QAC9BQ,KAAKM,OAAO,CAACP,eAAeD;IAC9B,OAAO;QACLE,KAAKK,IAAI,CAACP;IACZ;IAEA,OAAOP;AACT"}