@sanity/workbench-cli 1.5.0 → 1.7.0

package/dist/_exports/build.d.ts

@@ -3,6 +3,13 @@ import { CliConfig } from "@sanity/cli-core";
 import { PluginOption } from "vite";
 import { z } from "zod/mini";
 
+/**
+ * The `build`/`start` id for a workbench app — a hash of its declared shape.
+ * Shared so the bundle inlined by `sanity build` and the registry entry advertised
+ * by `sanity start` resolve to the same id.
+ */
+export declare function buildAppId(app: ResolvedWorkbenchApp): string;
+
 /**
  * User-facing input for `unstable_defineApp`. Excludes the internal
  * `applicationType`, `isSingleton`, and `config` — validated by the
@@ -87,7 +94,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
         >
       >
     >;
-    slug: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    slug: z.ZodMiniString<string>;
     title: z.ZodMiniString<string>;
     views: z.ZodMiniOptional<
       z.ZodMiniArray<
@@ -131,8 +138,12 @@ declare interface DefineAppResult extends DefineAppInput {
 declare interface ResolvedWorkbenchApp {
   /** The app's unique `name` from `unstable_defineApp`. */
   readonly name: string;
+  /** Organization that owns the app — part of its build-id identity. */
+  readonly organizationId: string;
   /** Background worker services the app declares. */
   readonly services: NonNullable<DefineAppInput["services"]>;
+  /** Hostname the application is created at on first deploy. */
+  readonly slug: string;
   /** Dock panel views the app declares. */
   readonly views: NonNullable<DefineAppInput["views"]>;
   /** Resolved app kind — `studio` or one of the SDK app types. */
@@ -141,10 +152,10 @@ declare interface ResolvedWorkbenchApp {
   readonly config?: WorkbenchApp["config"];
   /** SDK app-view entrypoint, when declared. */
   readonly entry?: string;
+  /** Path to the app's icon SVG, resolved and shipped to Brett on deploy. */
+  readonly icon?: string;
   /** Explicit singleton flag (a Sanity-owned app); `undefined` when the app doesn't set it. */
   readonly isSingleton?: boolean;
-  /** Hostname the application is created at on first deploy. */
-  readonly slug?: string;
   /** Dashboard visibility declared by the app; `undefined` when unset. */
   readonly visibility?: AppVisibility;
 }
@@ -185,6 +196,39 @@ export declare interface WorkbenchExposes {
   views?: DefineAppInput["views"];
 }
 
+/**
+ * Dep pre-bundling inputs for a workbench app's dev server.
+ *
+ * Vite's dep scanner crawls from the app's HTML entry, which reaches only the
+ * app's `entry` (or a studio's config) — never the federation `exposes` (dock
+ * views, worker services, media-library config fields), which the host loads
+ * dynamically at runtime. So a dep imported only by an exposed module (e.g.
+ * `sanity/workbench` in a service or view) escapes the startup scan; Vite
+ * discovers it on first request, re-optimizes, and full-page reloads — which
+ * flakes Playwright in e2e.
+ *
+ * Point `entries` at the source of every interface: the app `entry` (or, for a
+ * studio, its config), plus each view, service, and installation-config source.
+ * `entries` follows real import statements, so it covers whatever those sources
+ * transitively use — correct subpaths and all — with no hand-maintained dep
+ * list, and never crashes on an unresolvable name the way a bad `include` entry
+ * does. Each source is resolved to its on-disk file so an extensionless path
+ * (like the default `./src/App`) still matches `entries`' filesystem glob.
+ *
+ * @param cwd - Project root; `entries` are returned relative to it.
+ * @param appSources - Absolute paths to the app's `entry` and/or studio config.
+ * @param exposes - The app's declared views/services/config.
+ * @internal
+ */
+export declare function workbenchOptimizeDeps(options: {
+  appSources: readonly string[];
+  cwd: string;
+  exposes?: WorkbenchExposes;
+}): {
+  entries: string[];
+  include: string[];
+};
+
 declare interface WorkbenchViteOptions {
   /** Project root — read for the federation remote name, and the plugin workDir. */
   cwd: string;

package/dist/_exports/build.js

@@ -3,7 +3,9 @@
 // resolver the build reads declared views/services from. The build needs no
 // deploy-time guards, so it takes the bare `resolveWorkbenchApp` — the guarded
 // view (`getWorkbench`) is the deploy entry's export.
+export { workbenchOptimizeDeps } from '../actions/build/vite/optimize-deps.js';
 export { workbenchVitePlugins } from '../actions/build/vite/workbench-vite-plugins.js';
+export { buildAppId } from '../appId.js';
 export { resolveWorkbenchApp } from '../resolveWorkbenchApp.js';
 
 //# sourceMappingURL=build.js.map

package/dist/_exports/build.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/_exports/build.ts"],"sourcesContent":["// Node-only build entry: the module-federation Vite plugins that\n// `@sanity/cli-build`'s `getViteConfig` swaps in for a workbench app, plus the\n// resolver the build reads declared views/services from. The build needs no\n// deploy-time guards, so it takes the bare `resolveWorkbenchApp` — the guarded\n// view (`getWorkbench`) is the deploy entry's export.\n\nexport {workbenchVitePlugins} from '../actions/build/vite/workbench-vite-plugins.js'\nexport {resolveWorkbenchApp, type WorkbenchExposes} from '../resolveWorkbenchApp.js'\n"],"names":["workbenchVitePlugins","resolveWorkbenchApp"],"mappings":"AAAA,iEAAiE;AACjE,+EAA+E;AAC/E,4EAA4E;AAC5E,+EAA+E;AAC/E,sDAAsD;AAEtD,SAAQA,oBAAoB,QAAO,kDAAiD;AACpF,SAAQC,mBAAmB,QAA8B,4BAA2B"}
+{"version":3,"sources":["../../src/_exports/build.ts"],"sourcesContent":["// Node-only build entry: the module-federation Vite plugins that\n// `@sanity/cli-build`'s `getViteConfig` swaps in for a workbench app, plus the\n// resolver the build reads declared views/services from. The build needs no\n// deploy-time guards, so it takes the bare `resolveWorkbenchApp` — the guarded\n// view (`getWorkbench`) is the deploy entry's export.\n\nexport {workbenchOptimizeDeps} from '../actions/build/vite/optimize-deps.js'\nexport {workbenchVitePlugins} from '../actions/build/vite/workbench-vite-plugins.js'\nexport {buildAppId} from '../appId.js'\nexport {resolveWorkbenchApp, type WorkbenchExposes} from '../resolveWorkbenchApp.js'\n"],"names":["workbenchOptimizeDeps","workbenchVitePlugins","buildAppId","resolveWorkbenchApp"],"mappings":"AAAA,iEAAiE;AACjE,+EAA+E;AAC/E,4EAA4E;AAC5E,+EAA+E;AAC/E,sDAAsD;AAEtD,SAAQA,qBAAqB,QAAO,yCAAwC;AAC5E,SAAQC,oBAAoB,QAAO,kDAAiD;AACpF,SAAQC,UAAU,QAAO,cAAa;AACtC,SAAQC,mBAAmB,QAA8B,4BAA2B"}

package/dist/_exports/deploy.d.ts

@@ -59,6 +59,8 @@ declare interface BrettInterfaceBase {
 export declare interface BrettWorkspace {
   dataset: string;
   projectId: string;
+  /** Lexicon schema descriptor id; Brett requires one per workspace. */
+  schemaDescriptorId: string;
   basePath?: string;
   icon?: string;
   name?: string;
@@ -93,6 +95,41 @@ declare interface BuildExposesContext {
  */
 export declare function checkBuiltOutput(sourceDir: string): Promise<void>;
 
+/**
+ * Create a coreApp record (no deployment), so the CLI can build with its id
+ * before shipping the first deployment. First deploy only.
+ * @internal
+ */
+export declare function createCoreApp(options: {
+  isSingleton?: boolean;
+  organizationId: string;
+  slug: string;
+  title: string;
+  visibility?: AppVisibility;
+}): Promise<CreatedApplication>;
+
+/**
+ * A freshly created application record: its id, plus a way to undo the creation.
+ * The caller builds and deploys with the id, and calls `rollback` if a later
+ * step fails so the record isn't stranded at its slug.
+ * @internal
+ */
+export declare interface CreatedApplication {
+  applicationId: string;
+  rollback: () => Promise<void>;
+}
+
+/**
+ * Create a studio record (no deployment).
+ * @internal
+ */
+export declare function createStudio(options: {
+  organizationId: string;
+  projectId: string | undefined;
+  slug: string;
+  title: string;
+}): Promise<CreatedApplication>;
+
 /**
  * User-facing input for `unstable_defineApp`. Excludes the internal
  * `applicationType`, `isSingleton`, and `config` — validated by the
@@ -177,7 +214,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
         >
       >
     >;
-    slug: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    slug: z.ZodMiniString<string>;
     title: z.ZodMiniString<string>;
     views: z.ZodMiniOptional<
       z.ZodMiniArray<
@@ -253,27 +290,6 @@ export declare function deployConfig(options: {
   version: string;
 }): Promise<void>;
 
-/**
- * Deploy a workbench coreApp through Brett: redeploy when `appId` is set,
- * otherwise create the application at `slug`. Returns the application id for the
- * shell to report.
- * @internal
- */
-export declare function deployCoreApp(options: {
-  appId: string | undefined;
-  interfaces: readonly BrettInterface[];
-  isAutoUpdating: boolean;
-  isSingleton?: boolean;
-  organizationId: string;
-  slug: string;
-  sourceDir: string;
-  title: string;
-  version: string;
-  visibility?: AppVisibility;
-}): Promise<{
-  applicationId: string;
-}>;
-
 /** A view or service as the deploy report and `--json` output surface it. */
 export declare interface DeployedExpose {
   name: string;
@@ -283,26 +299,29 @@ export declare interface DeployedExpose {
 }
 
 /**
- * Deploy a workbench studio through Brett: redeploy when `appId` is set,
- * otherwise create the studio at `studioHost`. Returns the application id for
- * the shell to report; a missing `studioHost` on create is a usage error.
+ * Ship a deployment to an already-created (or `deployment.appId`) application,
+ * then sync its mutable metadata (`title`, and `icon`/`visibility` when set)
+ * from config. The deploy endpoint ignores these, so a redeploy patches them
+ * here alongside the new deployment.
+ *
+ * `onDeployed` fires the instant the deployment is live, before the metadata
+ * sync — so a caller can disarm a create-time rollback that must not delete an
+ * application once it has an active deployment.
  * @internal
  */
-export declare function deployStudio(options: {
-  appId: string | undefined;
+export declare function deployWorkbenchApp(options: {
+  applicationId: string;
+  icon?: string;
   interfaces: readonly BrettInterface[];
   isAutoUpdating: boolean;
-  organizationId: string;
-  output: Output;
-  projectId: string | undefined;
+  label?: string;
+  onDeployed?: () => void;
   sourceDir: string;
-  studioHost: string | undefined;
   title: string;
   version: string;
-  workspaces: readonly BrettWorkspace[];
-}): Promise<{
-  applicationId: string;
-}>;
+  visibility?: AppVisibility;
+  workspaces?: readonly BrettWorkspace[];
+}): Promise<void>;
 
 export declare function getApplication(
   applicationId: string,
@@ -323,8 +342,12 @@ export declare function getWorkbenchUrl(organizationId: string): string;
 declare interface ResolvedWorkbenchApp {
   /** The app's unique `name` from `unstable_defineApp`. */
   readonly name: string;
+  /** Organization that owns the app — part of its build-id identity. */
+  readonly organizationId: string;
   /** Background worker services the app declares. */
   readonly services: NonNullable<DefineAppInput["services"]>;
+  /** Hostname the application is created at on first deploy. */
+  readonly slug: string;
   /** Dock panel views the app declares. */
   readonly views: NonNullable<DefineAppInput["views"]>;
   /** Resolved app kind — `studio` or one of the SDK app types. */
@@ -333,10 +356,10 @@ declare interface ResolvedWorkbenchApp {
   readonly config?: WorkbenchApp["config"];
   /** SDK app-view entrypoint, when declared. */
   readonly entry?: string;
+  /** Path to the app's icon SVG, resolved and shipped to Brett on deploy. */
+  readonly icon?: string;
   /** Explicit singleton flag (a Sanity-owned app); `undefined` when the app doesn't set it. */
   readonly isSingleton?: boolean;
-  /** Hostname the application is created at on first deploy. */
-  readonly slug?: string;
   /** Dashboard visibility declared by the app; `undefined` when unset. */
   readonly visibility?: AppVisibility;
 }

package/dist/_exports/deploy.js

@@ -1,7 +1,7 @@
 export { buildExposes, summarizeExposes } from '../actions/deploy/buildExposes.js';
 export { checkBuiltOutput } from '../actions/deploy/checkBuiltOutput.js';
 export { deployConfig, resolveInstallationId, summarizeConfig } from '../actions/deploy/deployConfig.js';
-export { deployCoreApp, deployStudio } from '../actions/deploy/deployWorkbenchApp.js';
+export { createCoreApp, createStudio, deployWorkbenchApp } from '../actions/deploy/deployWorkbenchApp.js';
 export { getWorkbench } from '../actions/deploy/getWorkbench.js';
 export { getApplication, getApplicationUrl, getWorkbenchUrl } from '../services/applications.js';
 

package/dist/_exports/deploy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/_exports/deploy.ts"],"sourcesContent":["export {\n  buildExposes,\n  type DeployedExpose,\n  summarizeExposes,\n} from '../actions/deploy/buildExposes.js'\nexport {checkBuiltOutput} from '../actions/deploy/checkBuiltOutput.js'\nexport {\n  deployConfig,\n  resolveInstallationId,\n  summarizeConfig,\n} from '../actions/deploy/deployConfig.js'\nexport {deployCoreApp, deployStudio} from '../actions/deploy/deployWorkbenchApp.js'\nexport {getWorkbench} from '../actions/deploy/getWorkbench.js'\nexport {\n  type Application,\n  type BrettInterface,\n  type BrettWorkspace,\n  getApplication,\n  getApplicationUrl,\n  getWorkbenchUrl,\n} from '../services/applications.js'\n"],"names":["buildExposes","summarizeExposes","checkBuiltOutput","deployConfig","resolveInstallationId","summarizeConfig","deployCoreApp","deployStudio","getWorkbench","getApplication","getApplicationUrl","getWorkbenchUrl"],"mappings":"AAAA,SACEA,YAAY,EAEZC,gBAAgB,QACX,oCAAmC;AAC1C,SAAQC,gBAAgB,QAAO,wCAAuC;AACtE,SACEC,YAAY,EACZC,qBAAqB,EACrBC,eAAe,QACV,oCAAmC;AAC1C,SAAQC,aAAa,EAAEC,YAAY,QAAO,0CAAyC;AACnF,SAAQC,YAAY,QAAO,oCAAmC;AAC9D,SAIEC,cAAc,EACdC,iBAAiB,EACjBC,eAAe,QACV,8BAA6B"}
+{"version":3,"sources":["../../src/_exports/deploy.ts"],"sourcesContent":["export {\n  buildExposes,\n  type DeployedExpose,\n  summarizeExposes,\n} from '../actions/deploy/buildExposes.js'\nexport {checkBuiltOutput} from '../actions/deploy/checkBuiltOutput.js'\nexport {\n  deployConfig,\n  resolveInstallationId,\n  summarizeConfig,\n} from '../actions/deploy/deployConfig.js'\nexport {\n  createCoreApp,\n  type CreatedApplication,\n  createStudio,\n  deployWorkbenchApp,\n} from '../actions/deploy/deployWorkbenchApp.js'\nexport {getWorkbench} from '../actions/deploy/getWorkbench.js'\nexport {\n  type Application,\n  type BrettInterface,\n  type BrettWorkspace,\n  getApplication,\n  getApplicationUrl,\n  getWorkbenchUrl,\n} from '../services/applications.js'\n"],"names":["buildExposes","summarizeExposes","checkBuiltOutput","deployConfig","resolveInstallationId","summarizeConfig","createCoreApp","createStudio","deployWorkbenchApp","getWorkbench","getApplication","getApplicationUrl","getWorkbenchUrl"],"mappings":"AAAA,SACEA,YAAY,EAEZC,gBAAgB,QACX,oCAAmC;AAC1C,SAAQC,gBAAgB,QAAO,wCAAuC;AACtE,SACEC,YAAY,EACZC,qBAAqB,EACrBC,eAAe,QACV,oCAAmC;AAC1C,SACEC,aAAa,EAEbC,YAAY,EACZC,kBAAkB,QACb,0CAAyC;AAChD,SAAQC,YAAY,QAAO,oCAAmC;AAC9D,SAIEC,cAAc,EACdC,iBAAiB,EACjBC,eAAe,QACV,8BAA6B"}

package/dist/_exports/dev.d.ts

@@ -162,8 +162,6 @@ export declare function startWorkbenchDev(
 }>;
 
 export declare interface StartWorkbenchDevOptions {
-  /** Resolved app id for the registry entry (the CLI owns id resolution). */
-  appId: string | undefined;
   /** Directory for the workbench Vite server's dependency cache. */
   cacheDir: string;
   /** CLI-domain `app.id`/`deployment.appId` deprecation check, run before registering. */

package/dist/_exports/index.d.ts

@@ -1,5 +1,13 @@
 import { z } from "zod/mini";
 
+/** The declared shape hashed into a build id — the app's identity, not its code. */
+declare interface BuildAppIdentity {
+  name: string;
+  organizationId: string;
+  entry?: string;
+  exposes?: WorkbenchExposes;
+}
+
 /**
  * User-facing input for `unstable_defineApp`. Excludes the internal
  * `applicationType`, `isSingleton`, and `config` — validated by the
@@ -84,7 +92,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
         >
       >
     >;
-    slug: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    slug: z.ZodMiniString<string>;
     title: z.ZodMiniString<string>;
     views: z.ZodMiniOptional<
       z.ZodMiniArray<
@@ -230,6 +238,25 @@ export declare type PanelViewProps = ViewComponentBaseProps<{
   type: "panel";
 }>;
 
+/**
+ * Mints the id the workbench keys everything on (React keys, panel ownership, the
+ * message bus, and the bundle's `__SANITY_APP_ID__`). Each run mode derives it
+ * differently so a running dev app, a local build, and a deployed twin can't
+ * share one: `sanity dev` uses the bound address, `sanity build`/`start` a hash
+ * of the declared shape. `sanity deploy` resolves its own id from the
+ * applications API, so it isn't handled here.
+ */
+export declare function resolveAppId(
+  source:
+    | {
+        app: BuildAppIdentity;
+      }
+    | {
+        host: string;
+        port: number;
+      },
+): string;
+
 /** @internal */
 declare const SERVICE_CONTRACT_VERSION = 1;
 
@@ -366,4 +393,15 @@ declare const WORKBENCH_APP: unique symbol;
 export declare type WorkbenchApp = DefineAppResult &
   z.output<typeof DefineAppInputSchema>;
 
+/**
+ * Bundled so adding a declaration family touches this type and the artifact
+ * expanders, not every hop of build/dev plumbing in between.
+ * @internal
+ */
+declare interface WorkbenchExposes {
+  config?: WorkbenchApp["config"];
+  services?: DefineAppInput["services"];
+  views?: DefineAppInput["views"];
+}
+
 export {};

package/dist/_exports/index.js

@@ -1,3 +1,4 @@
+export { resolveAppId } from '../appId.js';
 export { isWorkbenchApp, unstable_defineApp, unstable_defineMediaLibrary } from '../defineApp.js';
 export { unstable_defineService } from '../defineService.js';
 export { unstable_defineView } from '../defineView.js';

package/dist/_exports/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/_exports/index.ts"],"sourcesContent":["export type {InterfaceType, ServiceType} from '../contract.js'\nexport {isWorkbenchApp, unstable_defineApp, unstable_defineMediaLibrary} from '../defineApp.js'\nexport type {\n  DefineAppInput,\n  DefineAppResult,\n  DefineMediaLibraryInput,\n  DockGroup,\n  MediaLibraryField,\n  WorkbenchApp,\n} from '../defineApp.js'\nexport {unstable_defineService} from '../defineService.js'\nexport type {\n  DefinedService,\n  ServiceCallback,\n  ServiceContext,\n  ServiceInfo,\n} from '../defineService.js'\nexport {unstable_defineView} from '../defineView.js'\nexport type {\n  DefinedView,\n  PanelComponent,\n  PanelViewComponents,\n  PanelViewProps,\n  ViewComponentsByType,\n} from '../defineView.js'\n"],"names":["isWorkbenchApp","unstable_defineApp","unstable_defineMediaLibrary","unstable_defineService","unstable_defineView"],"mappings":"AACA,SAAQA,cAAc,EAAEC,kBAAkB,EAAEC,2BAA2B,QAAO,kBAAiB;AAS/F,SAAQC,sBAAsB,QAAO,sBAAqB;AAO1D,SAAQC,mBAAmB,QAAO,mBAAkB"}
+{"version":3,"sources":["../../src/_exports/index.ts"],"sourcesContent":["export {resolveAppId} from '../appId.js'\nexport type {InterfaceType, ServiceType} from '../contract.js'\nexport {isWorkbenchApp, unstable_defineApp, unstable_defineMediaLibrary} from '../defineApp.js'\nexport type {\n  DefineAppInput,\n  DefineAppResult,\n  DefineMediaLibraryInput,\n  DockGroup,\n  MediaLibraryField,\n  WorkbenchApp,\n} from '../defineApp.js'\nexport {unstable_defineService} from '../defineService.js'\nexport type {\n  DefinedService,\n  ServiceCallback,\n  ServiceContext,\n  ServiceInfo,\n} from '../defineService.js'\nexport {unstable_defineView} from '../defineView.js'\nexport type {\n  DefinedView,\n  PanelComponent,\n  PanelViewComponents,\n  PanelViewProps,\n  ViewComponentsByType,\n} from '../defineView.js'\n"],"names":["resolveAppId","isWorkbenchApp","unstable_defineApp","unstable_defineMediaLibrary","unstable_defineService","unstable_defineView"],"mappings":"AAAA,SAAQA,YAAY,QAAO,cAAa;AAExC,SAAQC,cAAc,EAAEC,kBAAkB,EAAEC,2BAA2B,QAAO,kBAAiB;AAS/F,SAAQC,sBAAsB,QAAO,sBAAqB;AAO1D,SAAQC,mBAAmB,QAAO,mBAAkB"}

package/dist/_exports/init.d.ts

@@ -1,12 +1,12 @@
 /** App scaffold — `entry` auto-declares the navigable app view. */
 export declare const workbenchAppConfigTemplate =
-  "\nimport {defineCliConfig, unstable_defineApp} from 'sanity/cli'\n\nexport default defineCliConfig({\n  app: unstable_defineApp({\n    name: '%name%',\n    title: '%title%',\n    organizationId: '%organizationId%',\n    entry: '%entry%',\n  }),\n})\n";
+  "\nimport {defineCliConfig, unstable_defineApp} from 'sanity/cli'\n\nexport default defineCliConfig({\n  app: unstable_defineApp({\n    name: '%name%',\n    title: '%title%',\n    slug: '%slug%',\n    organizationId: '%organizationId%',\n    entry: '%entry%',\n  }),\n})\n";
 
 /**
  * Studio scaffold — brands with name/title only, no `entry` (studio app views
  * aren't implemented yet).
  */
 export declare const workbenchStudioConfigTemplate =
-  "\nimport {defineCliConfig, unstable_defineApp} from 'sanity/cli'\n\nexport default defineCliConfig({\n  api: {\n    projectId: '%projectId%',\n    dataset: '%dataset%'\n  },\n  app: unstable_defineApp({\n    name: '%name%',\n    title: '%title%',\n    organizationId: '%organizationId%',\n  }),\n  deployment: {\n    /**\n     * Enable auto-updates for studios.\n     * Learn more at https://www.sanity.io/docs/studio/latest-version-of-sanity#k47faf43faf56\n     */\n    autoUpdates: __BOOL__autoUpdates__,\n  },\n})\n";
+  "\nimport {defineCliConfig, unstable_defineApp} from 'sanity/cli'\n\nexport default defineCliConfig({\n  api: {\n    projectId: '%projectId%',\n    dataset: '%dataset%'\n  },\n  app: unstable_defineApp({\n    name: '%name%',\n    title: '%title%',\n    slug: '%slug%',\n    organizationId: '%organizationId%',\n  }),\n  deployment: {\n    /**\n     * Enable auto-updates for studios.\n     * Learn more at https://www.sanity.io/docs/studio/latest-version-of-sanity#k47faf43faf56\n     */\n    autoUpdates: __BOOL__autoUpdates__,\n  },\n})\n";
 
 export {};

package/dist/_exports/preview.d.ts

@@ -0,0 +1,169 @@
+import { CliConfig } from "@sanity/cli-core";
+import { Output } from "@sanity/cli-core";
+import { z } from "zod/mini";
+
+/**
+ * A manifest describing a running dev server process (studio or app).
+ * Stored as `~/.sanity/dev-servers/<pid>.json`.
+ *
+ * The workbench singleton is tracked separately via the lock file — see
+ * `acquireWorkbenchLock` and `readWorkbenchLock` below.
+ */
+declare type DevServerManifest = z.infer<typeof devServerManifestSchema>;
+
+declare const devServerManifestSchema: z.ZodMiniObject<
+  {
+    configs: z.ZodMiniOptional<
+      z.ZodMiniArray<
+        z.ZodMiniObject<
+          {
+            appType: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            fields: z.ZodMiniArray<
+              z.ZodMiniObject<
+                {
+                  name: z.ZodMiniString<string>;
+                  public: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+                  src: z.ZodMiniString<string>;
+                  title: z.ZodMiniString<string>;
+                },
+                z.core.$strip
+              >
+            >;
+            id: z.ZodMiniString<string>;
+            moduleName: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            version: z.ZodMiniNumber<number>;
+          },
+          z.core.$strip
+        >
+      >
+    >;
+    host: z.ZodMiniString<string>;
+    id: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    interfaces: z.ZodMiniOptional<
+      z.ZodMiniArray<
+        z.ZodMiniDiscriminatedUnion<
+          [
+            z.ZodMiniObject<
+              {
+                metadata: z.ZodMiniNullable<
+                  z.ZodMiniObject<
+                    {
+                      group: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                      priority: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                    },
+                    z.core.$strip
+                  >
+                >;
+                type: z.ZodMiniLiteral<"app">;
+                id: z.ZodMiniString<string>;
+                moduleId: z.ZodMiniString<string>;
+                name: z.ZodMiniString<string>;
+                src: z.ZodMiniString<string>;
+                title: z.ZodMiniString<string>;
+                version: z.ZodMiniOptional<z.ZodMiniString<string>>;
+              },
+              z.core.$strip
+            >,
+            z.ZodMiniObject<
+              {
+                metadata: z.ZodMiniNull;
+                type: z.ZodMiniLiteral<"panel">;
+                id: z.ZodMiniString<string>;
+                moduleId: z.ZodMiniString<string>;
+                name: z.ZodMiniString<string>;
+                src: z.ZodMiniString<string>;
+                title: z.ZodMiniString<string>;
+                version: z.ZodMiniOptional<z.ZodMiniString<string>>;
+              },
+              z.core.$strip
+            >,
+            z.ZodMiniObject<
+              {
+                metadata: z.ZodMiniNull;
+                type: z.ZodMiniLiteral<"worker">;
+                id: z.ZodMiniString<string>;
+                moduleId: z.ZodMiniString<string>;
+                name: z.ZodMiniString<string>;
+                src: z.ZodMiniString<string>;
+                title: z.ZodMiniString<string>;
+                version: z.ZodMiniOptional<z.ZodMiniString<string>>;
+              },
+              z.core.$strip
+            >,
+          ],
+          "type"
+        >
+      >
+    >;
+    manifest: z.ZodMiniOptional<
+      z.ZodMiniUnion<
+        readonly [
+          z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>,
+          z.ZodMiniObject<
+            {
+              group: z.ZodMiniOptional<z.ZodMiniString<string>>;
+              icon: z.ZodMiniOptional<z.ZodMiniString<string>>;
+              priority: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+              slug: z.ZodMiniOptional<z.ZodMiniString<string>>;
+              title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+              version: z.ZodMiniString<string>;
+            },
+            z.core.$strip
+          >,
+        ]
+      >
+    >;
+    manifestUpdatedAt: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    pid: z.ZodMiniNumber<number>;
+    port: z.ZodMiniNumber<number>;
+    projectId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    startedAt: z.ZodMiniString<string>;
+    type: z.ZodMiniEnum<{
+      coreApp: "coreApp";
+      studio: "studio";
+    }>;
+    version: z.ZodMiniLiteral<1>;
+    workDir: z.ZodMiniString<string>;
+  },
+  z.core.$strip
+>;
+
+/**
+ * `sanity start` for a workbench app: serve a production build the way dev serves
+ * a live one. The same singleton workbench shell renders it and the same registry
+ * advertises it — only the remote differs, static files from the build output
+ * instead of a live Vite dev server. There's no config watcher or rebuild: a
+ * build is fixed, so nothing re-syncs.
+ *
+ * A running workbench claims the configured port, so the built remote binds the
+ * next one. Without one the remote takes the configured port and announces its
+ * own URL.
+ */
+export declare function startWorkbenchPreview(
+  options: StartWorkbenchPreviewOptions,
+): Promise<{
+  close: () => Promise<void>;
+}>;
+
+export declare interface StartWorkbenchPreviewOptions {
+  /** Directory for the workbench Vite server's dependency cache. */
+  cacheDir: string;
+  /** CLI-domain `app.id`/`deployment.appId` deprecation check, run before registering. */
+  checkForDeprecatedAppId: () => void;
+  cliConfig: CliConfig;
+  /** Extract the project manifest to inline into the registry (studio-vs-app handled by the CLI). */
+  extractManifest: (params: {
+    configPath: string;
+    workDir: string;
+  }) => Promise<DevServerManifest["manifest"]>;
+  httpHost: string;
+  httpPort: number;
+  isApp: boolean;
+  /** The built `dist` directory to serve as the federation remote. */
+  outDir: string;
+  output: Output;
+  reactStrictMode: boolean;
+  workDir: string;
+}
+
+export {};

package/dist/_exports/preview.js

@@ -0,0 +1,3 @@
+export { startWorkbenchPreview } from '../actions/preview/startWorkbenchPreview.js';
+
+//# sourceMappingURL=preview.js.map

package/dist/_exports/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/_exports/preview.ts"],"sourcesContent":["export {\n  startWorkbenchPreview,\n  type StartWorkbenchPreviewOptions,\n} from '../actions/preview/startWorkbenchPreview.js'\n"],"names":["startWorkbenchPreview"],"mappings":"AAAA,SACEA,qBAAqB,QAEhB,8CAA6C"}

package/dist/_exports/undeploy.d.ts

@@ -102,7 +102,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
         >
       >
     >;
-    slug: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    slug: z.ZodMiniString<string>;
     title: z.ZodMiniString<string>;
     views: z.ZodMiniOptional<
       z.ZodMiniArray<
@@ -175,8 +175,12 @@ declare interface DeployedExpose {
 declare interface ResolvedWorkbenchApp {
   /** The app's unique `name` from `unstable_defineApp`. */
   readonly name: string;
+  /** Organization that owns the app — part of its build-id identity. */
+  readonly organizationId: string;
   /** Background worker services the app declares. */
   readonly services: NonNullable<DefineAppInput["services"]>;
+  /** Hostname the application is created at on first deploy. */
+  readonly slug: string;
   /** Dock panel views the app declares. */
   readonly views: NonNullable<DefineAppInput["views"]>;
   /** Resolved app kind — `studio` or one of the SDK app types. */
@@ -185,10 +189,10 @@ declare interface ResolvedWorkbenchApp {
   readonly config?: WorkbenchApp["config"];
   /** SDK app-view entrypoint, when declared. */
   readonly entry?: string;
+  /** Path to the app's icon SVG, resolved and shipped to Brett on deploy. */
+  readonly icon?: string;
   /** Explicit singleton flag (a Sanity-owned app); `undefined` when the app doesn't set it. */
   readonly isSingleton?: boolean;
-  /** Hostname the application is created at on first deploy. */
-  readonly slug?: string;
   /** Dashboard visibility declared by the app; `undefined` when unset. */
   readonly visibility?: AppVisibility;
 }