@sanity/cli-build 5.2.0 → 5.3.0

package/dist/_exports/_internal/build.d.ts

@@ -1,59 +1,69 @@
-import { CliConfig } from "@sanity/cli-core/types";
-import { ConfigEnv } from "vite";
-import { FSWatcher } from "chokidar";
-import { InlineConfig } from "vite";
-import { Output } from "@sanity/cli-core/types";
-import { Plugin } from "vite";
-import { PluginOptions } from "babel-plugin-react-compiler";
-import { UserViteConfig } from "@sanity/cli-core/types";
+import { CliConfig, Output, UserViteConfig } from "@sanity/cli-core/types";
 import { WorkbenchExposes } from "@sanity/workbench-cli/build";
-
+import { ConfigEnv, InlineConfig, Plugin } from "vite";
+import { FSWatcher } from "chokidar";
+interface CompareDependencyVersions {
+  installed: string;
+  pkg: string;
+  remote: string;
+}
+interface UnresolvedPrerelease {
+  pkg: string;
+  version: string;
+}
+interface CompareDependencyVersionsResult {
+  mismatched: Array<CompareDependencyVersions>;
+  unresolvedPrerelease: Array<UnresolvedPrerelease>;
+}
+interface CompareDependencyVersionsOptions {
+  /** When provided, uses the app-specific module endpoint instead of the default endpoint. */
+  appId?: string;
+}
 /**
- * Everything the production build needs to produce an auto-updating studio/app.
+ * @internal
  *
- * Auto-updating deployments load `sanity` (and friends) from Sanity's module
- * CDN via an import map, and load `react`/`react-dom`/`styled-components` from
- * hashed vendor chunks emitted by the build itself. These concerns always come
- * together: when auto-updates are disabled none of this applies and everything
- * is bundled as usual.
+ * Compares the versions of dependencies in the studio or app with their remote versions.
  *
- * @internal
- */
-declare interface AutoUpdatesBuildConfig {
-  /** Import map entries for the packages served from Sanity's module CDN. */
-  imports: Record<string, string>;
-  /** Vendor packages to emit as hashed browser-loadable ESM chunks. */
-  vendor: VendorBuildConfig;
-  /** Stylesheets served from the module CDN, loaded via `<link>` tags. */
-  cssUrls?: string[];
-}
-
-/**
- * Internal build app that avoids depending on flags for CLI config.
- * @param options - options for the build
+ * This function reads the package.json file in the provided working directory, and compares the versions of the dependencies
+ * specified in the `autoUpdatesImports` parameter with their remote versions. If the versions do not match, the dependency is
+ * added to a list of failed dependencies, which is returned by the function.
+ *
+ * The failed dependencies are anything that does not strictly match the remote version.
+ * This means that if a version is lower or greater by even a patch it will be marked as failed.
+ *
+ * @param packages - An array of packages with their name and version to compare against remote.
+ * @param workDir - The path to the working directory containing the package.json file.
+ * @param options - Optional configuration for version comparison.
+ *
+ * @returns A promise that resolves to an object containing `mismatched` (packages whose local and remote versions differ)
+ * and `unresolvedPrerelease` (packages with prerelease versions that could not be resolved remotely).
+ *
+ * @throws Throws an error if the remote version of a non-prerelease package cannot be fetched, or if the local version
+ * of a package cannot be parsed.
  */
-export declare function buildApp(options: BuildOptions): Promise<void>;
-
-export declare type BuildAppEventListener = BuildEventListener;
-
-declare interface BuildEventListener {
+declare function compareDependencyVersions(packages: {
+  name: string;
+  version: string;
+}[], workDir: string, { appId }?: CompareDependencyVersionsOptions): Promise<CompareDependencyVersionsResult>;
+type MessageFunc = ({ message }: {
+  message: string;
+}) => void;
+interface BuildEventListener {
   onPreReleaseInInteractiveAutoUpdate(params: {
     prereleaseMessage: string;
   }): Promise<void>;
   onPreReleaseInNonInteractiveAutoUpdate: MessageFunc;
 }
-
-declare interface BuildOptions {
+type BuildAppEventListener = BuildEventListener;
+interface BuildOptions$1 {
   appId: string | undefined;
   appTitle: string | undefined;
   autoUpdatesEnabled: boolean;
   checkAppId: () => void;
-  compareDependencyVersions: (
-    packages: {
-      name: string;
-      version: string;
-    }[],
-  ) => Promise<CompareDependencyVersionsResult>;
+  compareDependencyVersions: (packages: {
+    name: string;
+    version: string;
+  }[]) => Promise<CompareDependencyVersionsResult>;
   determineBasePath: () => string;
   entry: string | undefined;
   eventListener: Partial<BuildAppEventListener>;
@@ -61,8 +71,8 @@ declare interface BuildOptions {
   minify: boolean;
   outDir: string | undefined;
   output: Output;
-  reactCompiler: CliConfig["reactCompiler"];
-  schemaExtraction: CliConfig["schemaExtraction"];
+  reactCompiler: CliConfig['reactCompiler'];
+  schemaExtraction: CliConfig['schemaExtraction'];
   sourceMap: boolean;
   stats: boolean;
   unattendedMode: boolean;
@@ -72,52 +82,87 @@ declare interface BuildOptions {
   /** The workbench app's bus identity (`__SANITY_APP_ID__`). */
   workbenchAppId?: string;
 }
-
-declare interface BuildOptions_2 {
-  appId: string | undefined;
-  autoUpdatesEnabled: boolean;
-  checkAppId: () => void;
-  compareDependencyVersions: (
-    packages: {
-      name: string;
-      version: string;
-    }[],
-  ) => Promise<CompareDependencyVersionsResult>;
-  determineBasePath: () => string;
-  eventListener: Partial<BuildStudioEventListener>;
+/**
+ * Internal build app that avoids depending on flags for CLI config.
+ * @param options - options for the build
+ */
+declare function buildApp(options: BuildOptions$1): Promise<void>;
+interface VendorBuildConfig {
+  /** Rolldown entry name -\> absolute path to the package entry file. */
+  entries: Record<string, string>;
+  /** Named exports each CommonJS entry must re-expose as ESM, keyed by chunk name. */
+  namesByChunkName: Record<string, readonly string[]>;
+  /** Rolldown entry chunk name -\> bare import specifier (e.g. `react`, `react-dom/client`). */
+  specifiersByChunkName: Record<string, string>;
+}
+interface ResolveVendorBuildConfigOptions {
+  cwd: string;
   isApp: boolean;
-  isWorkbenchApp: boolean;
-  minify: boolean;
-  outDir: string | undefined;
-  output: Output;
-  reactCompiler: boolean | CliConfig["reactCompiler"] | undefined;
-  schemaExtraction: CliConfig["schemaExtraction"];
-  sourceMap: boolean;
-  stats: boolean;
-  unattendedMode: boolean;
-  vite: UserViteConfig | undefined;
-  workDir: string;
+}
+/**
+ * Resolves vendor package entry points and metadata for a combined studio/app build.
+ * Does not run a build — callers add `entries` to the main Vite/Rolldown input and
+ * derive the import map from emitted vendor chunks after the single `vite.build`.
+ *
+ * @internal
+ */
+declare function resolveVendorBuildConfig({ cwd, isApp }: ResolveVendorBuildConfigOptions): Promise<VendorBuildConfig>;
+/**
+ * Everything the production build needs to produce an auto-updating studio/app.
+ *
+ * Auto-updating deployments load `sanity` (and friends) from Sanity's module
+ * CDN via an import map, and load `react`/`react-dom`/`styled-components` from
+ * hashed vendor chunks emitted by the build itself. These concerns always come
+ * together: when auto-updates are disabled none of this applies and everything
+ * is bundled as usual.
+ *
+ * @internal
+ */
+interface AutoUpdatesBuildConfig {
+  /** Import map entries for the packages served from Sanity's module CDN. */
+  imports: Record<string, string>;
+  /** Vendor packages to emit as hashed browser-loadable ESM chunks. */
+  vendor: VendorBuildConfig;
+  /** Stylesheets served from the module CDN, loaded via `<link>` tags. */
+  cssUrls?: string[];
+}
+interface ChunkModule {
+  name: string;
+  renderedLength: number;
+}
+interface ChunkStats {
+  modules: ChunkModule[];
+  name: string;
+}
+interface StaticBuildOptions {
+  basePath: string;
+  cwd: string;
+  outputDir: string;
+  appTitle?: string;
+  autoUpdates?: AutoUpdatesBuildConfig;
+  entry?: string;
   exposes?: WorkbenchExposes;
+  isApp?: boolean;
+  /** Workbench app (opted in via `unstable_defineApp`) — drives the federation build. */
+  isWorkbenchApp?: boolean;
+  minify?: boolean;
+  profile?: boolean;
+  reactCompiler?: CliConfig['reactCompiler'];
+  schemaExtraction?: CliConfig['schemaExtraction'];
+  sourceMap?: boolean;
+  vite?: UserViteConfig;
   /** The workbench app's bus identity (`__SANITY_APP_ID__`). */
   workbenchAppId?: string;
 }
-
 /**
  * Builds static files
  *
  * @internal
  */
-export declare function buildStaticFiles(options: StaticBuildOptions): Promise<{
+declare function buildStaticFiles(options: StaticBuildOptions): Promise<{
   chunks: ChunkStats[];
 }>;
-
-/**
- * Internal build studio that avoids depending on flags for CLI config.
- * @param options - options for the build
- */
-export declare function buildStudio(options: BuildOptions_2): Promise<void>;
-
-export declare interface BuildStudioEventListener extends BuildEventListener {
+interface BuildStudioEventListener extends BuildEventListener {
   onBuildEnd: MessageFunc;
   onBuildFail: MessageFunc;
   onBuildStart: MessageFunc;
@@ -125,7 +170,9 @@ export declare interface BuildStudioEventListener extends BuildEventListener {
   onCleanOutputDirStart: MessageFunc;
   onIncompatibleDeclaredStyledComponentsVersionRange: MessageFunc;
   onIncompatibleInstalledStyledComponentsVersionRange: MessageFunc;
-  onInteractiveNonDefaultOutputDir({ message }: { message: string }): Promise<{
+  onInteractiveNonDefaultOutputDir({ message }: {
+    message: string;
+  }): Promise<{
     shouldClean: boolean;
   }>;
   onInvalidStyledComponentsVersionRange: MessageFunc;
@@ -142,207 +189,71 @@ export declare interface BuildStudioEventListener extends BuildEventListener {
     versionMismatchWarning: string;
   }): void;
 }
-
-/**
- * Checks that the studio has declared and installed the required dependencies
- * needed by the Sanity modules. While we generally use regular, explicit
- * dependencies in modules, there are certain dependencies that are better
- * served being peer dependencies, such as react and styled-components.
- *
- * If these dependencies are not installed/declared, we report an error
- * and instruct the user to install them manually.
- *
- * Additionally, returns the version of the 'sanity' dependency from the package.json.
- */
-export declare function checkRequiredDependencies(
-  options: CheckRequiredDependenciesOptions,
-): Promise<CheckResult>;
-
-declare interface CheckRequiredDependenciesOptions {
+interface BuildOptions {
+  appId: string | undefined;
+  autoUpdatesEnabled: boolean;
+  checkAppId: () => void;
+  compareDependencyVersions: (packages: {
+    name: string;
+    version: string;
+  }[]) => Promise<CompareDependencyVersionsResult>;
+  determineBasePath: () => string;
+  eventListener: Partial<BuildStudioEventListener>;
   isApp: boolean;
+  isWorkbenchApp: boolean;
+  minify: boolean;
+  outDir: string | undefined;
+  output: Output;
+  reactCompiler: boolean | CliConfig['reactCompiler'] | undefined;
+  schemaExtraction: CliConfig['schemaExtraction'];
+  sourceMap: boolean;
+  stats: boolean;
+  unattendedMode: boolean;
+  vite: UserViteConfig | undefined;
   workDir: string;
-  onIncompatibleDeclaredStyledComponentsVersionRange?: BuildStudioEventListener["onIncompatibleDeclaredStyledComponentsVersionRange"];
-  onIncompatibleInstalledStyledComponentsVersionRange?: BuildStudioEventListener["onIncompatibleInstalledStyledComponentsVersionRange"];
-  onInvalidStyledComponentsVersionRange?: BuildStudioEventListener["onInvalidStyledComponentsVersionRange"];
-  onNoDeclaredStyledComponentsVersion?: BuildStudioEventListener["onNoDeclaredStyledComponentsVersion"];
-  onNoInstalledSanityVersion?: BuildStudioEventListener["onNoInstalledSanityVersion"];
-  onNoInstalledStyledComponentsVersion?: BuildStudioEventListener["onNoInstalledStyledComponentsVersion"];
-}
-
-declare interface CheckResult {
-  installedSanityVersion: string;
-}
-
-export declare function checkStudioDependencyVersions(
-  workDir: string,
-  output: Output,
-  {
-    packages,
-  }?: {
-    packages?: TrackedPackage[];
-  },
-): Promise<void>;
-
-declare interface ChunkModule {
-  name: string;
-  renderedLength: number;
-}
-
-declare interface ChunkStats {
-  modules: ChunkModule[];
-  name: string;
-}
-
-export declare interface CompareDependencyVersions {
-  installed: string;
-  pkg: string;
-  remote: string;
+  exposes?: WorkbenchExposes;
+  /** The workbench app's bus identity (`__SANITY_APP_ID__`). */
+  workbenchAppId?: string;
 }
-
 /**
- * @internal
- *
- * Compares the versions of dependencies in the studio or app with their remote versions.
- *
- * This function reads the package.json file in the provided working directory, and compares the versions of the dependencies
- * specified in the `autoUpdatesImports` parameter with their remote versions. If the versions do not match, the dependency is
- * added to a list of failed dependencies, which is returned by the function.
- *
- * The failed dependencies are anything that does not strictly match the remote version.
- * This means that if a version is lower or greater by even a patch it will be marked as failed.
- *
- * @param packages - An array of packages with their name and version to compare against remote.
- * @param workDir - The path to the working directory containing the package.json file.
- * @param options - Optional configuration for version comparison.
- *
- * @returns A promise that resolves to an object containing `mismatched` (packages whose local and remote versions differ)
- * and `unresolvedPrerelease` (packages with prerelease versions that could not be resolved remotely).
- *
- * @throws Throws an error if the remote version of a non-prerelease package cannot be fetched, or if the local version
- * of a package cannot be parsed.
+ * Internal build studio that avoids depending on flags for CLI config.
+ * @param options - options for the build
  */
-export declare function compareDependencyVersions(
-  packages: {
-    name: string;
-    version: string;
-  }[],
-  workDir: string,
-  { appId }?: CompareDependencyVersionsOptions,
-): Promise<CompareDependencyVersionsResult>;
-
-declare interface CompareDependencyVersionsOptions {
-  /** When provided, uses the app-specific module endpoint instead of the default endpoint. */
-  appId?: string;
+declare function buildStudio(options: BuildOptions): Promise<void>;
+interface CheckResult {
+  installedSanityVersion: string;
 }
-
-export declare interface CompareDependencyVersionsResult {
-  mismatched: Array<CompareDependencyVersions>;
-  unresolvedPrerelease: Array<UnresolvedPrerelease>;
+interface CheckRequiredDependenciesOptions {
+  isApp: boolean;
+  workDir: string;
+  onIncompatibleDeclaredStyledComponentsVersionRange?: BuildStudioEventListener['onIncompatibleDeclaredStyledComponentsVersionRange'];
+  onIncompatibleInstalledStyledComponentsVersionRange?: BuildStudioEventListener['onIncompatibleInstalledStyledComponentsVersionRange'];
+  onInvalidStyledComponentsVersionRange?: BuildStudioEventListener['onInvalidStyledComponentsVersionRange'];
+  onNoDeclaredStyledComponentsVersion?: BuildStudioEventListener['onNoDeclaredStyledComponentsVersion'];
+  onNoInstalledSanityVersion?: BuildStudioEventListener['onNoInstalledSanityVersion'];
+  onNoInstalledStyledComponentsVersion?: BuildStudioEventListener['onNoInstalledStyledComponentsVersion'];
 }
-
 /**
- * Merge user-provided Vite configuration object or function
- *
- * @param defaultConfig - Default configuration object
- * @param userConfig - User-provided configuration object or function
- * @returns Merged configuration
- * @internal
- */
-export declare function extendViteConfigWithUserConfig(
-  env: ConfigEnv,
-  defaultConfig: InlineConfig,
-  userConfig: UserViteConfig,
-): Promise<InlineConfig>;
-
-/**
- * Get a configuration object for Vite based on the passed options
+ * Checks that the studio has declared and installed the required dependencies
+ * needed by the Sanity modules. While we generally use regular, explicit
+ * dependencies in modules, there are certain dependencies that are better
+ * served being peer dependencies, such as react and styled-components.
  *
- * @internal Only meant for consumption inside of Sanity modules, do not depend on this externally
- */
-export declare function getViteConfig(
-  options: ViteOptions,
-): Promise<InlineConfig>;
-
-declare type MessageFunc = ({ message }: { message: string }) => void;
-
-/**
- * Resolves vendor package entry points and metadata for a combined studio/app build.
- * Does not run a build — callers add `entries` to the main Vite/Rolldown input and
- * derive the import map from emitted vendor chunks after the single `vite.build`.
+ * If these dependencies are not installed/declared, we report an error
+ * and instruct the user to install them manually.
  *
- * @internal
- */
-export declare function resolveVendorBuildConfig({
-  cwd,
-  isApp,
-}: ResolveVendorBuildConfigOptions): Promise<VendorBuildConfig>;
-
-declare interface ResolveVendorBuildConfigOptions {
-  cwd: string;
-  isApp: boolean;
-}
-
-declare interface RuntimeOptions {
-  cwd: string;
-  reactStrictMode: boolean | undefined;
-  watch: boolean;
-  appTitle?: string;
-  basePath?: string;
-  entry?: string;
-  isApp?: boolean;
-  isWorkbenchApp?: boolean;
-}
-
-/**
- * Root directory (relative to the project) used by Sanity tooling for
- * build-time artifacts and caches — Vite's `cacheDir` and the dev-time
- * manifest output. Lives under `node_modules/` so it's out of `dist` and
- * ignored by default in typical `.gitignore` files.
+ * Additionally, returns the version of the 'sanity' dependency from the package.json.
  */
-export declare const SANITY_CACHE_DIR = "node_modules/.sanity";
-
-declare interface StaticBuildOptions {
-  basePath: string;
-  cwd: string;
-  outputDir: string;
-  appTitle?: string;
-  autoUpdates?: AutoUpdatesBuildConfig;
-  entry?: string;
-  exposes?: WorkbenchExposes;
-  isApp?: boolean;
-  /** Workbench app (opted in via `unstable_defineApp`) — drives the federation build. */
-  isWorkbenchApp?: boolean;
-  minify?: boolean;
-  profile?: boolean;
-  reactCompiler?: boolean | PluginOptions;
-  schemaExtraction?: CliConfig["schemaExtraction"];
-  sourceMap?: boolean;
-  vite?: UserViteConfig;
-  /** The workbench app's bus identity (`__SANITY_APP_ID__`). */
-  workbenchAppId?: string;
-}
-
-declare interface TrackedPackage {
+declare function checkRequiredDependencies(options: CheckRequiredDependenciesOptions): Promise<CheckResult>;
+interface TrackedPackage {
   deprecatedBelow: string | null;
   name: string;
   supported: string[];
 }
-
-export declare interface UnresolvedPrerelease {
-  pkg: string;
-  version: string;
-}
-
-declare interface VendorBuildConfig {
-  /** Rolldown entry name -\> absolute path to the package entry file. */
-  entries: Record<string, string>;
-  /** Named exports each CommonJS entry must re-expose as ESM, keyed by chunk name. */
-  namesByChunkName: Record<string, readonly string[]>;
-  /** Rolldown entry chunk name -\> bare import specifier (e.g. `react`, `react-dom/client`). */
-  specifiersByChunkName: Record<string, string>;
-}
-
-declare interface ViteOptions {
+declare function checkStudioDependencyVersions(workDir: string, output: Output, { packages }?: {
+  packages?: TrackedPackage[];
+}): Promise<void>;
+interface ViteOptions {
   /**
    * Root path of the studio/sanity app
    */
@@ -358,8 +269,8 @@ declare interface ViteOptions {
   /**
    * Mode to run vite in - eg development or production
    */
-  mode: "development" | "production";
-  reactCompiler: boolean | PluginOptions | undefined;
+  mode: 'development' | 'production';
+  reactCompiler: CliConfig['reactCompiler'];
   /**
    * Additional plugins when configured, eg. typegen
    */
@@ -393,7 +304,7 @@ declare interface ViteOptions {
   /**
    * Schema extraction configuration
    */
-  schemaExtraction?: CliConfig["schemaExtraction"];
+  schemaExtraction?: CliConfig['schemaExtraction'];
   /**
    * HTTP development server configuration
    */
@@ -411,7 +322,31 @@ declare interface ViteOptions {
    */
   workbenchAppId?: string;
 }
-
+/**
+ * Get a configuration object for Vite based on the passed options
+ *
+ * @internal Only meant for consumption inside of Sanity modules, do not depend on this externally
+ */
+declare function getViteConfig(options: ViteOptions): Promise<InlineConfig>;
+/**
+ * Merge user-provided Vite configuration object or function
+ *
+ * @param defaultConfig - Default configuration object
+ * @param userConfig - User-provided configuration object or function
+ * @returns Merged configuration
+ * @internal
+ */
+declare function extendViteConfigWithUserConfig(env: ConfigEnv, defaultConfig: InlineConfig, userConfig: UserViteConfig): Promise<InlineConfig>;
+interface RuntimeOptions {
+  cwd: string;
+  reactStrictMode: boolean | undefined;
+  watch: boolean;
+  appTitle?: string;
+  basePath?: string;
+  entry?: string;
+  isApp?: boolean;
+  isWorkbenchApp?: boolean;
+}
 /**
  * Generates the `.sanity/runtime` directory, and optionally watches for custom
  * document files, rebuilding when they change
@@ -420,12 +355,19 @@ declare interface ViteOptions {
  * @returns A watcher instance if watch is enabled, undefined otherwise
  * @internal
  */
-export declare function writeSanityRuntime(options: RuntimeOptions): Promise<{
+declare function writeSanityRuntime(options: RuntimeOptions): Promise<{
   entries: {
     relativeConfigLocation: string | null;
     relativeEntry: string | null;
   };
   watcher: FSWatcher | undefined;
 }>;
-
-export {};
+/**
+ * Root directory (relative to the project) used by Sanity tooling for
+ * build-time artifacts and caches — Vite's `cacheDir` and the dev-time
+ * manifest output. Lives under `node_modules/` so it's out of `dist` and
+ * ignored by default in typical `.gitignore` files.
+ */
+declare const SANITY_CACHE_DIR = "node_modules/.sanity";
+export { type BuildAppEventListener, type BuildStudioEventListener, type CompareDependencyVersions, type CompareDependencyVersionsResult, SANITY_CACHE_DIR, type UnresolvedPrerelease, buildApp, buildStaticFiles, buildStudio, checkRequiredDependencies, checkStudioDependencyVersions, compareDependencyVersions, extendViteConfigWithUserConfig, getViteConfig, resolveVendorBuildConfig, writeSanityRuntime };
+//# sourceMappingURL=build.d.ts.map

package/dist/_exports/_internal/env.d.ts

@@ -1,53 +1,20 @@
-/**
- * Get environment variables prefixed with SANITY_APP_, as an object.
- *
- * @param options - Options for the environment variable loading
- *  {@link StudioEnvVariablesOptions}
- * @returns Object of app environment variables
- *
- * @internal
- */
-export declare function getAppEnvironmentVariables(
-  options?: StudioEnvVariablesOptions,
-): Record<string, string>;
-
-/**
- * Get environment variables prefixed with SANITY_STUDIO_, as an object.
- *
- * @param options - Options for the environment variable loading
- *  {@link StudioEnvVariablesOptions}
- * @returns Object of studio environment variables
- *
- * @example
- * ```tsx
- * getStudioEnvironmentVariables({prefix: 'process.env.', jsonEncode: true})
- * ```
- *
- * @public
- */
-export declare function getStudioEnvironmentVariables(
-  options?: StudioEnvVariablesOptions,
-): Record<string, string>;
-
 /**
  * The params for the `getStudioEnvironmentVariables` and `getAppEnvironmentVariables` function
  * that gets Studio/App-focused environment variables.
  *
  * @public
  */
-export declare interface StudioEnvVariablesOptions {
+interface StudioEnvVariablesOptions {
   /**
    * When specified includes environment variables from dotenv files (`.env`), in the same way the studio does.
    * A `mode` must be specified, usually `development`
    * or `production`, which will load the corresponding `.env.development` or `.env.production`.
    * To specify where to look for the dotenv files, specify `options.envFile.envDir`.
    */
-  envFile?:
-    | false
-    | {
-        envDir?: string;
-        mode: string;
-      };
+  envFile?: false | {
+    envDir?: string;
+    mode: string;
+  };
   /**
    * When specified, JSON-encodes the values, which is handy if you want to pass
    * this to a bundlers hardcoded defines, such as Vite's `define` or Webpack's `DefinePlugin`.
@@ -59,5 +26,30 @@ export declare interface StudioEnvVariablesOptions {
    */
   prefix?: string;
 }
-
-export {};
+/**
+ * Get environment variables prefixed with SANITY_STUDIO_, as an object.
+ *
+ * @param options - Options for the environment variable loading
+ *  {@link StudioEnvVariablesOptions}
+ * @returns Object of studio environment variables
+ *
+ * @example
+ * ```tsx
+ * getStudioEnvironmentVariables({prefix: 'process.env.', jsonEncode: true})
+ * ```
+ *
+ * @public
+ */
+declare function getStudioEnvironmentVariables(options?: StudioEnvVariablesOptions): Record<string, string>;
+/**
+ * Get environment variables prefixed with SANITY_APP_, as an object.
+ *
+ * @param options - Options for the environment variable loading
+ *  {@link StudioEnvVariablesOptions}
+ * @returns Object of app environment variables
+ *
+ * @internal
+ */
+declare function getAppEnvironmentVariables(options?: StudioEnvVariablesOptions): Record<string, string>;
+export { type StudioEnvVariablesOptions, getAppEnvironmentVariables, getStudioEnvironmentVariables };
+//# sourceMappingURL=env.d.ts.map