feat(create-sanity): standalone bundled create-sanity package

knip.config.ts

@@ -3,8 +3,9 @@ import {type KnipConfig} from 'knip'
 const project = ['src/**/*.{js,jsx,ts,tsx}', '!**/docs/**']
 
 const baseConfig = {
-  // For now only care about cli package
   ignore: [
+    'tmp/**',
+
     'packages/@sanity/cli-test/fixtures/**',
 
     // See `helpClass` in `oclif.config.js`
@@ -72,6 +73,8 @@ const baseConfig = {
       project,
     },
     'packages/create-sanity': {
+      // @sanity/cli is imported via relative source paths (../../@sanity/cli/src/...)
+      // for bundling, but the workspace link is still needed for resolution
       ignoreDependencies: ['@sanity/cli'],
     },
   },

packages/@sanity/cli-core/package.json

@@ -25,12 +25,16 @@
   ],
   "type": "module",
   "sideEffects": false,
-  "main": "./dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "./dist/_exports/index.js",
+  "types": "dist/_exports/index.d.ts",
   "exports": {
     ".": {
-      "source": "./src/index.ts",
-      "default": "./dist/index.js"
+      "source": "./src/_exports/index.ts",
+      "default": "./dist/_exports/index.js"
+    },
+    "./errors": {
+      "source": "./src/_exports/errors.ts",
+      "default": "./dist/_exports/errors.js"
     },
     "./ux": {
       "source": "./src/_exports/ux.ts",
@@ -68,6 +72,7 @@
     "@sanity/client": "catalog:",
     "babel-plugin-react-compiler": "^1.0.0",
     "boxen": "^8.0.1",
+    "clean-stack": "^6.0.0",
     "configstore": "^7.0.0",
     "debug": "catalog:",
     "get-it": "^8.7.0",
@@ -82,6 +87,7 @@
     "tsx": "catalog:",
     "vite": "catalog:",
     "vite-node": "^5.3.0",
+    "wrap-ansi": "^10.0.0",
     "zod": "catalog:"
   },
   "devDependencies": {

packages/@sanity/cli-core/src/_exports/errors.ts

@@ -0,0 +1,5 @@
+export * from '../errors/CLIError.js'
+export * from '../errors/CLIWarning.js'
+export * from '../errors/NonInteractiveError.js'
+export * from '../errors/NotFoundError.js'
+export * from '../errors/ProjectRootNotFoundError.js'

packages/@sanity/cli-core/src/_exports/index.ts

@@ -0,0 +1,67 @@
+import {deprecate} from 'node:util'
+
+import {NonInteractiveError as _NonInteractiveError} from '../errors/NonInteractiveError.js'
+import {NotFoundError as _NotFoundError} from '../errors/NotFoundError.js'
+import {ProjectRootNotFoundError as _ProjectRootNotFoundError} from '../errors/ProjectRootNotFoundError.js'
+
+export * from '../config/cli/getCliConfig.js'
+export * from '../config/cli/getCliConfigSync.js'
+export {type CliConfig} from '../config/cli/types/cliConfig.js'
+export {type UserViteConfig} from '../config/cli/types/userViteConfig.js'
+export * from '../config/findProjectRoot.js'
+export * from '../config/findProjectRootSync.js'
+export * from '../config/studio/getStudioConfig.js'
+export * from '../config/studio/getStudioWorkspaces.js'
+export * from '../config/studio/isStudioConfig.js'
+export * from '../config/util/findConfigsPaths.js'
+export * from '../config/util/findStudioConfigPath.js'
+export {type ProjectRootResult} from '../config/util/recursivelyResolveProjectRoot.js'
+export * from '../debug.js'
+export * from '../loaders/studio/studioWorkerTask.js'
+export * from '../loaders/tsx/tsxWorkerTask.js'
+export * from '../SanityCommand.js'
+export * from '../services/apiClient.js'
+export * from '../services/cliUserConfig.js'
+export * from '../services/getCliToken.js'
+export * from '../telemetry/getTelemetryBaseInfo.js'
+export {
+  type CLITelemetryStore,
+  type ConsentInformation,
+  type TelemetryUserProperties,
+} from '../telemetry/types.js'
+export {type Output, type SanityOrgUser} from '../types.js'
+export {doImport} from '../util/doImport.js'
+export * from '../util/environment/mockBrowserEnvironment.js'
+export {
+  clearCliTelemetry,
+  CLI_TELEMETRY_SYMBOL,
+  getCliTelemetry,
+  setCliTelemetry,
+} from '../util/getCliTelemetry.js'
+export * from '../util/getSanityEnvVar.js'
+export * from '../util/getSanityUrl.js'
+export * from '../util/getUserConfig.js'
+export * from '../util/importModule.js'
+export * from '../util/isCi.js'
+export * from '../util/isInteractive.js'
+export * from '../util/isStaging.js'
+export * from '../util/normalizePath.js'
+export * from '../util/promisifyWorker.js'
+export * from '../util/readPackageJson.js'
+export * from '../util/resolveLocalPackage.js'
+export * from '../util/safeStructuredClone.js'
+export * from '../ux/colorizeJson.js'
+export * from '../ux/timer.js'
+
+export const NonInteractiveError = deprecate(
+  _NonInteractiveError,
+  'Import `NonInteractiveError` from `@sanity/cli-core/errors`',
+)
+export const NotFoundError = deprecate(
+  _NotFoundError,
+  'Import `NotFoundError` from `@sanity/cli-core/errors`',
+)
+export const ProjectRootNotFoundError = deprecate(
+  _ProjectRootNotFoundError,
+  'Import `ProjectRootNotFoundError` from `@sanity/cli-core/errors`',
+)

packages/@sanity/cli-core/src/_exports/ux.ts

@@ -1,5 +1,7 @@
 export {NonInteractiveError} from '../errors/NonInteractiveError.js'
 export * from '../ux/boxen.js'
+export * from '../ux/errors.js'
 export * from '../ux/logSymbols.js'
+export * from '../ux/output.js'
 export * from '../ux/prompts.js'
 export * from '../ux/spinner.js'

packages/@sanity/cli-core/src/errors/CLIError.ts

@@ -0,0 +1,46 @@
+import {styleText} from 'node:util'
+
+import {type PrettyPrintableError} from '@oclif/core/interfaces'
+import cleanStack from 'clean-stack'
+
+/**
+ * A formatted CLI error that pretty-prints to stderr.
+ *
+ * This is a lightweight reimplementation of `@oclif/core`'s `CLIError`.
+ * We can't import the original because `@oclif/core` is a CJS barrel that
+ * pulls in the entire oclif runtime (~10MB) when bundled - defeating
+ * tree-shaking in the standalone `create-sanity` bundle. By owning the
+ * error class here, code in `@sanity/cli-core` and the init action tree
+ * can throw formatted errors without depending on oclif at all.
+ *
+ * The `oclif` property is shaped so oclif's error handler still recognises
+ * these errors when thrown inside an oclif command, preserving the correct
+ * exit code and suppressing redundant stack traces.
+ */
+export class CLIError extends Error {
+  code?: string
+  oclif: {exit?: number} = {exit: 2}
+  ref?: string
+  skipOclifErrorHandling?: boolean
+  suggestions?: string[]
+
+  constructor(error: Error | string, options: PrettyPrintableError & {exit?: false | number} = {}) {
+    super(error instanceof Error ? error.message : error)
+    if (error instanceof Error && error.stack) {
+      this.stack = error.stack
+    }
+    if (options.exit !== undefined)
+      this.oclif.exit = options.exit === false ? undefined : options.exit
+    this.code = options.code
+    this.suggestions = options.suggestions
+    this.ref = options.ref
+  }
+
+  get bang(): string | undefined {
+    return styleText('red', process.platform === 'win32' ? '»' : '›')
+  }
+
+  get prettyStack(): string {
+    return cleanStack(super.stack!, {pretty: true})
+  }
+}

packages/@sanity/cli-core/src/errors/CLIWarning.ts

@@ -0,0 +1,18 @@
+import {styleText} from 'node:util'
+
+import {CLIError} from './CLIError.js'
+
+/**
+ * A warning-level CLI error. Identical to {@link CLIError} except the
+ * bang prefix is yellow instead of red.
+ */
+export class CLIWarning extends CLIError {
+  constructor(input: Error | string) {
+    super(input instanceof Error ? input.message : input)
+    this.name = 'Warning'
+  }
+
+  override get bang(): string | undefined {
+    return styleText('yellow', process.platform === 'win32' ? '»' : '›')
+  }
+}

packages/@sanity/cli-core/src/errors/NonInteractiveError.ts

@@ -1,4 +1,4 @@
-import {CLIError} from '@oclif/core/errors'
+import {CLIError} from './CLIError.js'
 
 /**
  * Error thrown when a prompt is attempted in a non-interactive environment

packages/@sanity/cli-core/src/errors/ProjectRootNotFoundError.ts

@@ -1,6 +1,5 @@
-import {CLIError} from '@oclif/core/errors'
-
 import {isRecord} from '../util/isRecord.js'
+import {CLIError} from './CLIError.js'
 
 /**
  * Error thrown when a project root directory cannot be found.

packages/@sanity/cli-core/src/services/apiClient.ts

@@ -1,4 +1,5 @@
-import {ux} from '@oclif/core'
+import {styleText} from 'node:util'
+
 import {
   type ClientConfig,
   type ClientError,
@@ -168,7 +169,7 @@ function authErrors() {
 
       const statusCode = isHttpError(err) && err.response.body.statusCode
       if (statusCode === 401) {
-        err.message = `${err.message}. You may need to login again with ${ux.colorize('cyan', 'sanity login')}.\nFor more information, see ${generateHelpUrl('cli-errors')}.`
+        err.message = `${err.message}. You may need to login again with ${styleText('cyan', 'sanity login')}.\nFor more information, see ${generateHelpUrl('cli-errors')}.`
       }
 
       return err

packages/@sanity/cli-core/src/util/getCliTelemetry.ts

@@ -1,7 +1,7 @@
-import {ux} from '@oclif/core'
 import {noopLogger} from '@sanity/telemetry'
 
 import {type CLITelemetryStore} from '../telemetry/types.js'
+import {warn} from '../ux/errors.js'
 
 /**
  * @public
@@ -33,7 +33,7 @@ export function getCliTelemetry(): CLITelemetryStore {
   const state = getState()
   // This should never happen, but if it does, we return a noop logger to avoid errors.
   if (!state) {
-    ux.warn('CLI telemetry not initialized, returning noop logger')
+    warn('CLI telemetry not initialized, returning noop logger')
     return noopLogger
   }
 

packages/@sanity/cli-core/src/ux/errors.ts

@@ -0,0 +1,84 @@
+/* eslint-disable no-console -- this is the error output layer */
+import {type PrettyPrintableError} from '@oclif/core/interfaces'
+import wrapAnsi from 'wrap-ansi'
+
+import {CLIError} from '../errors/CLIError.js'
+import {CLIWarning} from '../errors/CLIWarning.js'
+
+const settings: {debug?: boolean} = (globalThis as Record<string, unknown>).oclif ?? {}
+
+/**
+ * Print a formatted error to stderr without throwing, when `exit: false`.
+ */
+export function error(input: Error | string, options: PrettyPrintableError & {exit: false}): void
+/**
+ * Throw a formatted {@link CLIError}.
+ */
+export function error(
+  input: Error | string,
+  options?: PrettyPrintableError & {exit?: number},
+): never
+export function error(
+  input: Error | string,
+  options: PrettyPrintableError & {exit?: false | number} = {},
+): void {
+  const err = new CLIError(input, options)
+
+  if (options.exit === false) {
+    const message = prettyPrint(err)
+    if (message) console.error(message)
+  } else {
+    throw err
+  }
+}
+
+/**
+ * Print a formatted warning to stderr.
+ */
+export function warn(input: Error | string): void {
+  const err = new CLIWarning(input)
+  const message = prettyPrint(err)
+  if (message) console.error(message)
+}
+
+function indentString(str: string, count: number, options?: {indent?: string}): string {
+  const indent = options?.indent ?? ' '
+  if (count === 0) return str
+  return str.replaceAll(/^(?!\s*$)/gm, indent.repeat(count))
+}
+
+function stderrWidth(): number {
+  const env = Number.parseInt(process.env.OCLIF_COLUMNS!, 10)
+  if (env) return env
+  if (!process.stderr.isTTY) return 80
+  const w = (process.stderr as {getWindowSize?: () => number[]}).getWindowSize?.()[0] ?? 80
+  return Math.max(w < 1 ? 80 : w, 40)
+}
+
+function formatSuggestions(suggestions?: string[]): string | undefined {
+  const label = 'Try this:'
+  if (!suggestions || suggestions.length === 0) return undefined
+  if (suggestions.length === 1) return `${label} ${suggestions[0]}`
+  return `${label}\n${indentString(suggestions.map((s) => `* ${s}`).join('\n'), 2)}`
+}
+
+function prettyPrint(error: CLIError): string | undefined {
+  if (settings.debug) return error.prettyStack
+
+  const {bang: prefix, code, message, name: errorSuffix, ref, suggestions} = error
+  const formattedHeader = message ? `${errorSuffix || 'Error'}: ${message}` : undefined
+  const formattedCode = code ? `Code: ${code}` : undefined
+  const formattedSuggestions = formatSuggestions(suggestions)
+  const formattedReference = ref ? `Reference: ${ref}` : undefined
+
+  const formatted = [formattedHeader, formattedCode, formattedSuggestions, formattedReference]
+    .filter(Boolean)
+    .join('\n')
+
+  const width = stderrWidth()
+  let output = wrapAnsi(formatted, width - 6, {hard: true, trim: false})
+  output = indentString(output, 3)
+  output = indentString(output, 1, {indent: prefix || ''})
+  output = indentString(output, 1)
+  return output
+}