feat(create-sanity): bundle init logic into single file (#759)

Reapply PR #759 changes onto current main. Replaces the old
create-sanity shim with a Rollup-bundled standalone entry point,
extracts shared flag definitions, and decouples init from oclif.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: 2 people

.changeset/pr-759.md

@@ -0,0 +1,8 @@
+<!-- auto-generated -->
+---
+'@sanity/cli-core': minor
+'@sanity/cli': minor
+'create-sanity': minor
+---
+
+bundle `init` logic into single file

knip.config.ts

@@ -3,10 +3,9 @@ import {type KnipConfig} from 'knip'
 const project = ['src/**/*.{js,jsx,ts,tsx}', '!**/docs/**']
 
 const baseConfig = {
-  // For now only care about cli package
-  // Disabled: the changeset plugin can't resolve local file paths in the changelog config
-  changesets: false,
   ignore: [
+    'packages/@sanity/cli-test/fixtures/**',
+
     // See `helpClass` in `oclif.config.js`
     'packages/@sanity/cli/src/SanityHelp.ts',
     // Loaded dynamically by @changesets/cli at version time
@@ -80,7 +79,9 @@ const baseConfig = {
       project,
     },
     'packages/create-sanity': {
-      ignoreDependencies: ['@sanity/cli'],
+      // @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', 'rxjs'],
     },
   },
 } satisfies KnipConfig

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

@@ -33,6 +33,10 @@
       "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",
       "default": "./dist/_exports/ux.js"
@@ -69,6 +73,7 @@
     "@sanity/client": "catalog:",
     "babel-plugin-react-compiler": "^1.0.0",
     "boxen": "^8.0.1",
+    "clean-stack": "^6.0.0",
     "debug": "catalog:",
     "get-it": "^8.7.0",
     "get-tsconfig": "catalog:",
@@ -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

@@ -1,3 +1,9 @@
+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'
@@ -11,9 +17,6 @@ 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 '../errors/NonInteractiveError.js'
-export * from '../errors/NotFoundError.js'
-export * from '../errors/ProjectRootNotFoundError.js'
 export * from '../exitCodes.js'
 export * from '../loaders/studio/studioWorkerTask.js'
 export * from '../loaders/tsx/tsxWorkerTask.js'
@@ -50,3 +53,16 @@ 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.