@sanity/cli-test 3.0.1 → 4.0.0

package/dist/test/setupFixtures.js

@@ -2,7 +2,6 @@ import { exec as execNode } from 'node:child_process';
 import { readFile, rm, writeFile } from 'node:fs/promises';
 import { basename, join } from 'node:path';
 import { promisify } from 'node:util';
-import ora from 'ora';
 import { glob } from 'tinyglobby';
 import { fileExists } from '../utils/fileExists.js';
 import { getFixturesPath, getTempPath } from '../utils/paths.js';
@@ -55,11 +54,9 @@ async function getAdditionalFixturePaths(fixtures) {
  * ```
  */ export async function setup(_, options = {}) {
     const { additionalFixtures, ignoreWorkspace, tempDir } = options;
-    const spinner = ora({
-        // Without this, the watch mode input is discarded
-        discardStdin: false,
-        text: 'Initializing test environment...'
-    }).start();
+    console.log('Initializing test environment...');
+    const timerLabel = 'Test environment initialization';
+    console.time(timerLabel);
     try {
         const fixturesDir = getFixturesPath();
         const tempDirectory = getTempPath(tempDir);
@@ -78,7 +75,7 @@ async function getAdditionalFixturePaths(fixtures) {
             if (additionalFixturePaths.length > 0) {
                 allFixturePaths.push(...additionalFixturePaths);
             } else {
-                spinner.warn(`No additional fixtures found, check the glob pattern: ${additionalFixtures.join(', ')}`);
+                console.warn(`No additional fixtures found, check the glob pattern: ${additionalFixtures.join(', ')}`);
             }
         }
         for (const { fixture, fromPath, includeDist } of allFixturePaths){
@@ -108,17 +105,18 @@ async function getAdditionalFixturePaths(fixtures) {
                 });
             } catch (error) {
                 const execError = error;
-                spinner.fail('Failed to install dependencies');
+                console.error('Failed to install dependencies');
                 console.error(execError.stderr || execError.stdout || execError.message);
                 throw new Error(`Error installing dependencies in ${toPath}: ${execError.stderr || execError.stdout || execError.message}`, {
                     cause: error
                 });
             }
         }
-        spinner.succeed('Test environment initialized');
     } catch (error) {
-        spinner.fail('Failed to initialize test environment');
+        console.error('Failed to initialize test environment!');
         throw error;
+    } finally{
+        console.timeEnd(timerLabel);
     }
 }
 /**

package/dist/test/setupFixtures.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/test/setupFixtures.ts"],"sourcesContent":["import {exec as execNode} from 'node:child_process'\nimport {readFile, rm, writeFile} from 'node:fs/promises'\nimport {basename, join} from 'node:path'\nimport {promisify} from 'node:util'\n\nimport ora from 'ora'\nimport {glob} from 'tinyglobby'\nimport {type TestProject} from 'vitest/node'\n\nimport {fileExists} from '../utils/fileExists.js'\nimport {getFixturesPath, getTempPath} from '../utils/paths.js'\nimport {DEFAULT_FIXTURES} from './constants.js'\nimport {testCopyDirectory} from './testFixture.js'\n\nconst exec = promisify(execNode)\n\n/**\n * Options for setupTestFixtures\n *\n * @public\n */\nexport interface SetupTestFixturesOptions {\n  /**\n   * Glob patterns for additional fixture directories to set up.\n   *\n   * Each pattern is matched against directories in the current working directory.\n   * Only directories containing a `package.json` file are included.\n   *\n   * @example\n   * ```typescript\n   * ['fixtures/*', 'dev/*']\n   * ```\n   */\n  additionalFixtures?: string[]\n\n  /**\n   * When true, passes `--ignore-workspace` to pnpm install so fixtures get\n   * their own node_modules even when the temp directory is inside a pnpm\n   * workspace. Required for E2E tests that spawn the CLI binary against\n   * fixture directories.\n   */\n  ignoreWorkspace?: boolean\n\n  /**\n   * Custom temp directory path. Defaults to process.cwd()/tmp\n   */\n  tempDir?: string\n}\n\nasync function getAdditionalFixturePaths(fixtures: string[]): Promise<FixtureDetails[]> {\n  const paths = await glob(fixtures, {\n    absolute: true,\n    ignore: ['**/node_modules/**', '**/dist/**'],\n    onlyDirectories: true,\n  })\n\n  const additionalFixtures: FixtureDetails[] = []\n\n  for (const path of paths) {\n    if (await fileExists(join(`${path}/package.json`))) {\n      additionalFixtures.push({\n        fixture: basename(path),\n        fromPath: path,\n        includeDist: false,\n      })\n    }\n  }\n\n  return additionalFixtures\n}\n\ninterface FixtureDetails {\n  fixture: string\n  fromPath: string\n  includeDist: boolean\n}\n\n/**\n * Global setup function for initializing test fixtures.\n *\n * Copies fixtures from the bundled location to a temp directory\n * and installs dependencies.\n *\n * Note: Fixtures are NOT built during setup. Tests that need built\n * fixtures should build them as part of the test.\n *\n * This function is designed to be used with vitest globalSetup.\n *\n * @public\n *\n * @param options - Configuration options\n * @example\n * ```typescript\n * // In vitest.config.ts\n * export default defineConfig({\n *   test: {\n *     globalSetup: ['@sanity/cli-test/vitest']\n *   }\n * })\n * ```\n */\nexport async function setup(_: TestProject, options: SetupTestFixturesOptions = {}): Promise<void> {\n  const {additionalFixtures, ignoreWorkspace, tempDir} = options\n\n  const spinner = ora({\n    // Without this, the watch mode input is discarded\n    discardStdin: false,\n    text: 'Initializing test environment...',\n  }).start()\n\n  try {\n    const fixturesDir = getFixturesPath()\n    const tempDirectory = getTempPath(tempDir)\n\n    const allFixturePaths: FixtureDetails[] = []\n\n    // Add the default fixtures\n    for (const [fixture, options] of Object.entries(DEFAULT_FIXTURES)) {\n      allFixturePaths.push({\n        fixture,\n        fromPath: join(fixturesDir, fixture),\n        includeDist: 'includeDist' in options && options.includeDist ? options.includeDist : false,\n      })\n    }\n\n    // Add the additional fixtures\n    if (additionalFixtures && additionalFixtures.length > 0) {\n      const additionalFixturePaths = await getAdditionalFixturePaths(additionalFixtures)\n\n      if (additionalFixturePaths.length > 0) {\n        allFixturePaths.push(...additionalFixturePaths)\n      } else {\n        spinner.warn(\n          `No additional fixtures found, check the glob pattern: ${additionalFixtures.join(', ')}`,\n        )\n      }\n    }\n\n    for (const {fixture, fromPath, includeDist} of allFixturePaths) {\n      const toPath = join(tempDirectory, `fixture-${fixture}`)\n      // Copy the fixture, excluding node_modules and dist\n      await testCopyDirectory(fromPath, toPath, ['node_modules', ...(includeDist ? [] : ['dist'])])\n\n      // Replace the package.json name with a temp name\n      const packageJsonPath = join(toPath, 'package.json')\n      const packageJson = await readFile(packageJsonPath, 'utf8')\n      const packageJsonData = JSON.parse(packageJson)\n      packageJsonData.name = `${packageJsonData.name}-test`\n      await writeFile(packageJsonPath, JSON.stringify(packageJsonData, null, 2))\n\n      // Run pnpm install --no-lockfile in the temp directory\n      try {\n        const ignoreWsFlag = ignoreWorkspace ? ' --ignore-workspace' : ''\n        // Disable pnpm's minimumReleaseAge for fixture installs. With\n        // `--ignore-workspace`, the workspace's `minimumReleaseAgeExclude` list\n        // is not applied, which can reject freshly-published Sanity versions\n        // pinned in fixture package.json files.\n        await exec(\n          `pnpm install --prefer-offline --no-lockfile --config.minimum-release-age=0${ignoreWsFlag}`,\n          {cwd: toPath},\n        )\n      } catch (error) {\n        const execError = error as {message: string; stderr?: string; stdout?: string}\n        spinner.fail('Failed to install dependencies')\n        console.error(execError.stderr || execError.stdout || execError.message)\n        throw new Error(\n          `Error installing dependencies in ${toPath}: ${execError.stderr || execError.stdout || execError.message}`,\n          {cause: error},\n        )\n      }\n    }\n\n    spinner.succeed('Test environment initialized')\n  } catch (error) {\n    spinner.fail('Failed to initialize test environment')\n    throw error\n  }\n}\n\n/**\n * Options for teardownTestFixtures\n *\n * @public\n */\nexport interface TeardownTestFixturesOptions {\n  /**\n   * Custom temp directory path. Defaults to process.cwd()/tmp\n   */\n  tempDir?: string\n}\n\n/**\n * Teardown function to clean up test fixtures.\n *\n * Removes the temp directory created by setupTestFixtures.\n *\n * This function is designed to be used with vitest globalSetup.\n *\n * @public\n *\n * @param options - Configuration options\n */\nexport async function teardown(options: TeardownTestFixturesOptions = {}): Promise<void> {\n  const {tempDir} = options\n  const tempDirectory = getTempPath(tempDir)\n\n  // Remove the tmp directory\n  await rm(tempDirectory, {force: true, maxRetries: 3, recursive: true}).catch(() => {})\n}\n"],"names":["exec","execNode","readFile","rm","writeFile","basename","join","promisify","ora","glob","fileExists","getFixturesPath","getTempPath","DEFAULT_FIXTURES","testCopyDirectory","getAdditionalFixturePaths","fixtures","paths","absolute","ignore","onlyDirectories","additionalFixtures","path","push","fixture","fromPath","includeDist","setup","_","options","ignoreWorkspace","tempDir","spinner","discardStdin","text","start","fixturesDir","tempDirectory","allFixturePaths","Object","entries","length","additionalFixturePaths","warn","toPath","packageJsonPath","packageJson","packageJsonData","JSON","parse","name","stringify","ignoreWsFlag","cwd","error","execError","fail","console","stderr","stdout","message","Error","cause","succeed","teardown","force","maxRetries","recursive","catch"],"mappings":"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"}
+{"version":3,"sources":["../../src/test/setupFixtures.ts"],"sourcesContent":["import {exec as execNode} from 'node:child_process'\nimport {readFile, rm, writeFile} from 'node:fs/promises'\nimport {basename, join} from 'node:path'\nimport {promisify} from 'node:util'\n\nimport {glob} from 'tinyglobby'\nimport {type TestProject} from 'vitest/node'\n\nimport {fileExists} from '../utils/fileExists.js'\nimport {getFixturesPath, getTempPath} from '../utils/paths.js'\nimport {DEFAULT_FIXTURES} from './constants.js'\nimport {testCopyDirectory} from './testFixture.js'\n\nconst exec = promisify(execNode)\n\n/**\n * Options for setupTestFixtures\n *\n * @public\n */\nexport interface SetupTestFixturesOptions {\n  /**\n   * Glob patterns for additional fixture directories to set up.\n   *\n   * Each pattern is matched against directories in the current working directory.\n   * Only directories containing a `package.json` file are included.\n   *\n   * @example\n   * ```typescript\n   * ['fixtures/*', 'dev/*']\n   * ```\n   */\n  additionalFixtures?: string[]\n\n  /**\n   * When true, passes `--ignore-workspace` to pnpm install so fixtures get\n   * their own node_modules even when the temp directory is inside a pnpm\n   * workspace. Required for E2E tests that spawn the CLI binary against\n   * fixture directories.\n   */\n  ignoreWorkspace?: boolean\n\n  /**\n   * Custom temp directory path. Defaults to process.cwd()/tmp\n   */\n  tempDir?: string\n}\n\nasync function getAdditionalFixturePaths(fixtures: string[]): Promise<FixtureDetails[]> {\n  const paths = await glob(fixtures, {\n    absolute: true,\n    ignore: ['**/node_modules/**', '**/dist/**'],\n    onlyDirectories: true,\n  })\n\n  const additionalFixtures: FixtureDetails[] = []\n\n  for (const path of paths) {\n    if (await fileExists(join(`${path}/package.json`))) {\n      additionalFixtures.push({\n        fixture: basename(path),\n        fromPath: path,\n        includeDist: false,\n      })\n    }\n  }\n\n  return additionalFixtures\n}\n\ninterface FixtureDetails {\n  fixture: string\n  fromPath: string\n  includeDist: boolean\n}\n\n/**\n * Global setup function for initializing test fixtures.\n *\n * Copies fixtures from the bundled location to a temp directory\n * and installs dependencies.\n *\n * Note: Fixtures are NOT built during setup. Tests that need built\n * fixtures should build them as part of the test.\n *\n * This function is designed to be used with vitest globalSetup.\n *\n * @public\n *\n * @param options - Configuration options\n * @example\n * ```typescript\n * // In vitest.config.ts\n * export default defineConfig({\n *   test: {\n *     globalSetup: ['@sanity/cli-test/vitest']\n *   }\n * })\n * ```\n */\nexport async function setup(_: TestProject, options: SetupTestFixturesOptions = {}): Promise<void> {\n  const {additionalFixtures, ignoreWorkspace, tempDir} = options\n  console.log('Initializing test environment...')\n  const timerLabel = 'Test environment initialization'\n  console.time(timerLabel)\n\n  try {\n    const fixturesDir = getFixturesPath()\n    const tempDirectory = getTempPath(tempDir)\n\n    const allFixturePaths: FixtureDetails[] = []\n\n    // Add the default fixtures\n    for (const [fixture, options] of Object.entries(DEFAULT_FIXTURES)) {\n      allFixturePaths.push({\n        fixture,\n        fromPath: join(fixturesDir, fixture),\n        includeDist: 'includeDist' in options && options.includeDist ? options.includeDist : false,\n      })\n    }\n\n    // Add the additional fixtures\n    if (additionalFixtures && additionalFixtures.length > 0) {\n      const additionalFixturePaths = await getAdditionalFixturePaths(additionalFixtures)\n\n      if (additionalFixturePaths.length > 0) {\n        allFixturePaths.push(...additionalFixturePaths)\n      } else {\n        console.warn(\n          `No additional fixtures found, check the glob pattern: ${additionalFixtures.join(', ')}`,\n        )\n      }\n    }\n\n    for (const {fixture, fromPath, includeDist} of allFixturePaths) {\n      const toPath = join(tempDirectory, `fixture-${fixture}`)\n      // Copy the fixture, excluding node_modules and dist\n      await testCopyDirectory(fromPath, toPath, ['node_modules', ...(includeDist ? [] : ['dist'])])\n\n      // Replace the package.json name with a temp name\n      const packageJsonPath = join(toPath, 'package.json')\n      const packageJson = await readFile(packageJsonPath, 'utf8')\n      const packageJsonData = JSON.parse(packageJson)\n      packageJsonData.name = `${packageJsonData.name}-test`\n      await writeFile(packageJsonPath, JSON.stringify(packageJsonData, null, 2))\n\n      // Run pnpm install --no-lockfile in the temp directory\n      try {\n        const ignoreWsFlag = ignoreWorkspace ? ' --ignore-workspace' : ''\n        // Disable pnpm's minimumReleaseAge for fixture installs. With\n        // `--ignore-workspace`, the workspace's `minimumReleaseAgeExclude` list\n        // is not applied, which can reject freshly-published Sanity versions\n        // pinned in fixture package.json files.\n        await exec(\n          `pnpm install --prefer-offline --no-lockfile --config.minimum-release-age=0${ignoreWsFlag}`,\n          {cwd: toPath},\n        )\n      } catch (error) {\n        const execError = error as {message: string; stderr?: string; stdout?: string}\n        console.error('Failed to install dependencies')\n        console.error(execError.stderr || execError.stdout || execError.message)\n        throw new Error(\n          `Error installing dependencies in ${toPath}: ${execError.stderr || execError.stdout || execError.message}`,\n          {cause: error},\n        )\n      }\n    }\n  } catch (error) {\n    console.error('Failed to initialize test environment!')\n    throw error\n  } finally {\n    console.timeEnd(timerLabel)\n  }\n}\n\n/**\n * Options for teardownTestFixtures\n *\n * @public\n */\nexport interface TeardownTestFixturesOptions {\n  /**\n   * Custom temp directory path. Defaults to process.cwd()/tmp\n   */\n  tempDir?: string\n}\n\n/**\n * Teardown function to clean up test fixtures.\n *\n * Removes the temp directory created by setupTestFixtures.\n *\n * This function is designed to be used with vitest globalSetup.\n *\n * @public\n *\n * @param options - Configuration options\n */\nexport async function teardown(options: TeardownTestFixturesOptions = {}): Promise<void> {\n  const {tempDir} = options\n  const tempDirectory = getTempPath(tempDir)\n\n  // Remove the tmp directory\n  await rm(tempDirectory, {force: true, maxRetries: 3, recursive: true}).catch(() => {})\n}\n"],"names":["exec","execNode","readFile","rm","writeFile","basename","join","promisify","glob","fileExists","getFixturesPath","getTempPath","DEFAULT_FIXTURES","testCopyDirectory","getAdditionalFixturePaths","fixtures","paths","absolute","ignore","onlyDirectories","additionalFixtures","path","push","fixture","fromPath","includeDist","setup","_","options","ignoreWorkspace","tempDir","console","log","timerLabel","time","fixturesDir","tempDirectory","allFixturePaths","Object","entries","length","additionalFixturePaths","warn","toPath","packageJsonPath","packageJson","packageJsonData","JSON","parse","name","stringify","ignoreWsFlag","cwd","error","execError","stderr","stdout","message","Error","cause","timeEnd","teardown","force","maxRetries","recursive","catch"],"mappings":"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"}

package/dist/test/util.d.ts

@@ -0,0 +1,203 @@
+import { CLITelemetryStore } from "@sanity/cli-core/types";
+import { Mock } from "vitest";
+import { SpinnerInstance } from "@sanity/cli-core/ux";
+
+/**
+ * Creates a mock HTTP server for testing.
+ *
+ * @returns A mock HTTP server object with emit and once methods
+ * @internal
+ */
+export declare function createMockHttpServer(): {
+  emit(event: string, ...args: unknown[]): void;
+  once(event: string, listener: (...args: unknown[]) => void): void;
+};
+
+/**
+ * Creates a mock spinner function to avoid writing output to stdout.
+ * @param overrides - Pass any mocks or stubs for test expectations
+ * @internal
+ * @deprecated Use mocks/cli-core/ux/spinner instead
+ */
+export declare function createMockSpinner(
+  overrides?: Partial<SpinnerInstance>,
+): Mock<(options: string) => SpinnerInstance>;
+
+/**
+ * Creates a mock Vite watcher for testing.
+ *
+ * @returns A mock watcher object with add, emit, and on methods
+ * @internal
+ */
+export declare function createMockWatcher(): MockWatcher;
+
+/**
+ * Creates a test token for the Sanity CLI
+ *
+ * @public
+ *
+ * @param token - The token to create
+ * @returns void
+ */
+export declare function createTestToken(token: string): void;
+
+/**
+ * Default fixtures bundled with the package and their options.
+ *
+ * @public
+ */
+export declare const DEFAULT_FIXTURES: Record<FixtureName, FixtureOptions>;
+
+/**
+ * @deprecated Use {@link FixtureName} instead. This type alias will be removed in a future release.
+ * @public
+ */
+export declare type ExampleName = FixtureName;
+
+/**
+ * Valid fixture name type.
+ * @public
+ */
+export declare type FixtureName =
+  | "basic-app"
+  | "basic-functions"
+  | "basic-studio"
+  | "federated-studio"
+  | "graphql-studio"
+  | "multi-workspace-studio"
+  | "nextjs-app"
+  | "prebuilt-app"
+  | "prebuilt-studio"
+  | "worst-case-studio";
+
+/**
+ * Options for each fixture.
+ * @public
+ */
+export declare interface FixtureOptions {
+  includeDist?: boolean;
+}
+
+/**
+ * @public
+ * @param options - Options for mocking the telemetry store.
+ * @returns The mocked telemetry store.
+ */
+export declare const mockTelemetry: (
+  options?: MockTelemetryOptions,
+) => CLITelemetryStore;
+
+/**
+ * @public
+ */
+export declare interface MockTelemetryOptions {
+  trace?: () => void;
+  updateUserProperties?: () => void;
+}
+
+/**
+ * @internal
+ */
+export declare interface MockWatcher {
+  add: Mock;
+  emit: (event: string, ...args: unknown[]) => void;
+  on: (event: string, listener: (...args: unknown[]) => void) => void;
+}
+
+/**
+ * Serializer for snapshot tests to normalize line endings and Windows ^ to Unix `\`
+ * @public
+ */
+export declare const snapshotSerializer: {
+  serialize: (val: string) => string;
+  test: (val: unknown) => val is string;
+};
+
+/**
+ * Recursively copy a directory, skipping specified folders.
+ *
+ * @param srcDir - Source directory to copy from
+ * @param destDir - Destination directory to copy to
+ * @param skip - Array of directory/file names to skip (e.g., ['node_modules', 'dist'])
+ * @internal
+ */
+export declare function testCopyDirectory(
+  srcDir: string,
+  destDir: string,
+  skip?: string[],
+): Promise<void>;
+
+/**
+ * @deprecated Use {@link testFixture} instead. This function will be removed in a future release.
+ *
+ * Clones an example (now called fixture) directory into a temporary directory with an isolated copy.
+ *
+ * @param exampleName - The name of the example/fixture to clone (e.g., 'basic-app', 'basic-studio')
+ * @param options - Configuration options
+ * @returns The absolute path to the temporary directory containing the example/fixture
+ *
+ * @public
+ */
+export declare function testExample(
+  exampleName: FixtureName | (string & {}),
+  options?: TestFixtureOptions,
+): Promise<string>;
+
+/**
+ * @deprecated Use {@link TestFixtureOptions} instead. This type alias will be removed in a future release.
+ * @public
+ */
+export declare type TestExampleOptions = TestFixtureOptions;
+
+/**
+ * Clones a fixture directory into a temporary directory with an isolated copy.
+ *
+ * The function creates a unique temporary copy of the specified fixture with:
+ * - A random unique ID to avoid conflicts between parallel tests
+ * - Symlinked node_modules for performance (from the global setup version)
+ * - Modified package.json name to prevent conflicts
+ *
+ * The fixture is first looked up in the temp directory (if global setup ran),
+ * otherwise it falls back to the bundled fixtures in the package.
+ *
+ * @param fixtureName - The name of the fixture to clone (e.g., 'basic-app', 'basic-studio')
+ * @param options - Configuration options
+ * @returns The absolute path to the temporary directory containing the fixture
+ *
+ * @public
+ *
+ * @example
+ * ```typescript
+ * import {testFixture} from '@sanity/cli-test'
+ * import {describe, test} from 'vitest'
+ *
+ * describe('my test suite', () => {
+ *   test('should work with basic-studio', async () => {
+ *     const cwd = await testFixture('basic-studio')
+ *     // ... run your tests in this directory
+ *   })
+ * })
+ * ```
+ */
+export declare function testFixture(
+  fixtureName: FixtureName | (string & {}),
+  options?: TestFixtureOptions,
+): Promise<string>;
+
+/**
+ * @public
+ */
+export declare interface TestFixtureOptions {
+  /**
+   * Custom temp directory. Defaults to process.cwd()/tmp (or the OS temp directory when
+   * `useSystemTmp` is true).
+   */
+  tempDir?: string;
+  /**
+   * Use the OS temp directory instead of cwd/tmp. Avoids monorepo workspace detection by
+   * package managers and git when tests run inside a monorepo. Ignored when `tempDir` is set.
+   */
+  useSystemTmp?: boolean;
+}
+
+export {};

package/dist/test/util.js

@@ -0,0 +1,11 @@
+// Fast, in-memory export of utilities provided by cli-test. Limit transient dependencies (no OCLIF, no nock, etc.). Dedicated exports for test utilities relying on heavy exports already exist (e.g. test/createTestClient, test/mockApi, test/oclif, test/setupFixtures, etc.)
+export * from './constants.js';
+export * from './createMockHttpServer.js';
+export * from './createMockSpinner.js';
+export * from './createMockWatcher.js';
+export * from './createTestToken.js';
+export * from './mockTelemetry.js';
+export * from './snapshotSerializer.js';
+export * from './testFixture.js';
+
+//# sourceMappingURL=util.js.map

package/dist/test/util.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/test/util.ts"],"sourcesContent":["// Fast, in-memory export of utilities provided by cli-test. Limit transient dependencies (no OCLIF, no nock, etc.). Dedicated exports for test utilities relying on heavy exports already exist (e.g. test/createTestClient, test/mockApi, test/oclif, test/setupFixtures, etc.)\nexport * from './constants.js'\nexport * from './createMockHttpServer.js'\nexport * from './createMockSpinner.js'\nexport * from './createMockWatcher.js'\nexport * from './createTestToken.js'\nexport * from './mockTelemetry.js'\nexport * from './snapshotSerializer.js'\nexport * from './testFixture.js'\n"],"names":[],"mappings":"AAAA,iRAAiR;AACjR,cAAc,iBAAgB;AAC9B,cAAc,4BAA2B;AACzC,cAAc,yBAAwB;AACtC,cAAc,yBAAwB;AACtC,cAAc,uBAAsB;AACpC,cAAc,qBAAoB;AAClC,cAAc,0BAAyB;AACvC,cAAc,mBAAkB"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Converts Unix-style paths to platform-appropriate paths.
+ * On Windows:
+ *   - Absolute paths starting with '/': adds drive letter and converts to backslashes
+ *   - Relative/partial paths: converts forward slashes to backslashes
+ * On Unix: keeps paths as-is.
+ *
+ * @param pathStr - Unix-style path (e.g., '/test/path' or '.config/file.json')
+ * @returns Platform-appropriate path
+ * @internal
+ */
+export declare function convertToSystemPath(pathStr: string): string;
+
+/**
+ * Creates a unique temporary directory for test output.
+ * Uses {@link getTempPath} as the base, creating it if needed.
+ *
+ * @param options - Configuration options: `prefix` (default: 'cli-e2e-') and
+ *   `useSystemTmp` (default: false) which uses the OS temp directory instead of
+ *   cwd/tmp to avoid monorepo workspace detection by package managers and git.
+ * @returns The path and a cleanup function
+ * @public
+ */
+export declare function createTmpDir(options?: {
+  prefix?: string;
+  useSystemTmp?: boolean;
+}): Promise<{
+  cleanup: () => Promise<void>;
+  path: string;
+}>;
+
+/**
+ * Gets the current Windows drive letter from process.cwd().
+ * Falls back to 'C:\\' if detection fails.
+ *
+ * @returns Drive letter with backslash (e.g., 'C:\\', 'D:\\') or empty string on Unix
+ * @internal
+ */
+export declare function getCurrentDrive(): string;
+
+/**
+ * Gets the path to the fixtures directory bundled with this package.
+ *
+ * The fixtures are copied during build and bundled with the published package.
+ * This function works the same whether the package is used in a monorepo
+ * or installed from npm.
+ *
+ * @returns Absolute path to the fixtures directory
+ * @internal
+ */
+export declare function getFixturesPath(): string;
+
+/**
+ * Gets the path to the temporary directory for test fixtures.
+ *
+ * Uses the initial working directory captured when this module was first loaded,
+ * not process.cwd() which may change during test execution.
+ *
+ * @param customTempDir - Optional custom temp directory path
+ * @returns Absolute path to temp directory (default: initial cwd/tmp)
+ * @internal
+ */
+export declare function getTempPath(customTempDir?: string): string;
+
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sanity/cli-test",
-  "version": "3.0.1",
+  "version": "4.0.0",
   "description": "Sanity CLI test helpers and utilities",
   "keywords": [
     "cli",
@@ -33,6 +33,66 @@
       "source": "./src/index.ts",
       "default": "./dist/index.js"
     },
+    "./mocks/cli-core/apiClient": {
+      "source": "./src/mocks/cli-core/apiClient.ts",
+      "default": "./dist/mocks/cli-core/apiClient.js"
+    },
+    "./mocks/cli-core/browser": {
+      "source": "./src/mocks/cli-core/browser.ts",
+      "default": "./dist/mocks/cli-core/browser.js"
+    },
+    "./mocks/cli-core/config": {
+      "source": "./src/mocks/cli-core/config.ts",
+      "default": "./dist/mocks/cli-core/config.js"
+    },
+    "./mocks/cli-core/package-manager": {
+      "source": "./src/mocks/cli-core/package-manager.ts",
+      "default": "./dist/mocks/cli-core/package-manager.js"
+    },
+    "./mocks/cli-core/request": {
+      "source": "./src/mocks/cli-core/request.ts",
+      "default": "./dist/mocks/cli-core/request.js"
+    },
+    "./mocks/cli-core/tasks": {
+      "source": "./src/mocks/cli-core/tasks.ts",
+      "default": "./dist/mocks/cli-core/tasks.js"
+    },
+    "./mocks/cli-core/telemetry": {
+      "source": "./src/mocks/cli-core/telemetry.ts",
+      "default": "./dist/mocks/cli-core/telemetry.js"
+    },
+    "./mocks/cli-core/ux": {
+      "source": "./src/mocks/cli-core/ux.ts",
+      "default": "./dist/mocks/cli-core/ux.js"
+    },
+    "./mocks/cli-core/SanityCommand": {
+      "source": "./src/mocks/cli-core/SanityCommand.ts",
+      "default": "./dist/mocks/cli-core/SanityCommand.js"
+    },
+    "./paths": {
+      "source": "./src/utils/paths.ts",
+      "default": "./dist/utils/paths.js"
+    },
+    "./test/createTestClient": {
+      "source": "./src/test/createTestClient.ts",
+      "default": "./dist/test/createTestClient.js"
+    },
+    "./test/mockApi": {
+      "source": "./src/test/mockApi.ts",
+      "default": "./dist/test/mockApi.js"
+    },
+    "./test/oclif": {
+      "source": "./src/test/oclif.ts",
+      "default": "./dist/test/oclif.js"
+    },
+    "./test/setupFixtures": {
+      "source": "./src/test/setupFixtures.ts",
+      "default": "./dist/test/setupFixtures.js"
+    },
+    "./test/util": {
+      "source": "./src/test/util.ts",
+      "default": "./dist/test/util.js"
+    },
     "./vitest": {
       "source": "./src/vitest.ts",
       "default": "./dist/vitest.js"
@@ -47,9 +107,8 @@
     "ansis": "^4.2.0",
     "esbuild": "^0.28.1",
     "nock": "^14.0.15",
-    "ora": "^9.0.0",
     "tinyglobby": "^0.2.17",
-    "@sanity/cli-core": "2.2.1"
+    "@sanity/cli-core": "2.3.0"
   },
   "devDependencies": {
     "@eslint/compat": "^2.1.0",
@@ -73,7 +132,7 @@
     "@oclif/core": "^4.0.0",
     "@sanity/client": "^7.0.0",
     "vitest": ">=3.0.0 <5.0.0",
-    "@sanity/cli-core": "2.2.1"
+    "@sanity/cli-core": "2.3.0"
   },
   "engines": {
     "node": ">=22.12"