@sanity/workbench-cli 1.8.0 → 1.9.0

package/dist/_exports/build.d.ts

@@ -3,6 +3,14 @@ import { CliConfig } from "@sanity/cli-core";
 import { PluginOption } from "vite";
 import { z } from "zod/mini";
 
+/** The `asset_source` variant of an app's `views`. @public */
+declare type AssetSourceView = Extract<
+  NonNullable<z.output<typeof DefineAppInputSchema>["views"]>[number],
+  {
+    type: "asset_source";
+  }
+>;
+
 /**
  * The `build`/`start` id — a hash of the app's declared shape (its identity, not
  * its code), so the bundle inlined by `sanity build` and the registry entry
@@ -14,10 +22,11 @@ export declare function buildAppId(app: ResolvedWorkbenchApp): Promise<string>;
 
 /**
  * User-facing input for `unstable_defineApp`. Excludes the internal
- * `applicationType`, `isSingleton`, and `config` — validated by the
- * schema but not part of the public surface (Sanity-owned apps set them via
- * `@ts-expect-error`). A union so an app declares an app `entry` or `views`,
- * never both.
+ * `applicationType`, `isSingleton`, and `config` — validated by the schema but
+ * not part of the public surface (Sanity-owned apps set them via
+ * `@ts-expect-error`). A union: an app declares an app `entry` (navigable) or
+ * panel `views`, never both — but an `asset_source` view is a separate kind and
+ * may accompany either.
  * @public
  */
 declare type DefineAppInput = Omit<
@@ -31,7 +40,7 @@ declare type DefineAppInput = Omit<
       }
     | {
         entry?: string;
-        views?: never;
+        views?: AssetSourceView[];
       }
   );
 
@@ -84,7 +93,6 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
     >;
     icon: z.ZodMiniOptional<z.ZodMiniString<string>>;
     isSingleton: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
-    name: z.ZodMiniString<string>;
     organizationId: z.ZodMiniString<string>;
     priority: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
     services: z.ZodMiniOptional<
@@ -93,7 +101,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
           [
             z.ZodMiniObject<
               {
-                title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                title: z.ZodMiniString<string>;
                 name: z.ZodMiniString<string>;
                 src: z.ZodMiniString<string>;
                 type: z.ZodMiniLiteral<"worker">;
@@ -113,13 +121,22 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
           [
             z.ZodMiniObject<
               {
-                title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                title: z.ZodMiniString<string>;
                 name: z.ZodMiniString<string>;
                 src: z.ZodMiniString<string>;
                 type: z.ZodMiniLiteral<"panel">;
               },
               z.core.$strip
             >,
+            z.ZodMiniObject<
+              {
+                title: z.ZodMiniString<string>;
+                name: z.ZodMiniString<string>;
+                src: z.ZodMiniString<string>;
+                type: z.ZodMiniLiteral<"asset_source">;
+              },
+              z.core.$strip
+            >,
           ],
           "type"
         >
@@ -147,13 +164,10 @@ declare type DefineAppResult = DefineAppInput & {
 
 /** @public */
 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"]>;

package/dist/_exports/deploy.d.ts

@@ -3,22 +3,6 @@ import { CliConfig } from "@sanity/cli-core";
 import { Output } from "@sanity/cli-core";
 import { z } from "zod/mini";
 
-/** @internal */
-declare type AppInterfaceMetadata = z.infer<typeof AppInterfaceMetadataSchema>;
-
-/**
- * The `app` interface's dock-placement metadata. Interface metadata is
- * discriminated on `type`; `app` is the only type with a shape so far.
- * @internal
- */
-declare const AppInterfaceMetadataSchema: z.ZodMiniObject<
-  {
-    group: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    priority: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-  },
-  z.core.$strip
->;
-
 export declare interface Application {
   id: string;
   organizationId: string;
@@ -29,31 +13,13 @@ export declare interface Application {
 
 declare type ApplicationType = "coreApp" | "studio";
 
-/**
- * An interface as Brett stores it, discriminated on `type`. `moduleId` is
- * remote-relative — the host prepends the app's id. Brett assigns the id.
- * @internal
- */
-export declare type BrettInterface =
-  | (BrettInterfaceBase & {
-      metadata: AppInterfaceMetadata | null;
-      type: "app";
-    })
-  | (BrettInterfaceBase & {
-      metadata: null;
-      type: "panel";
-    })
-  | (BrettInterfaceBase & {
-      metadata: null;
-      type: "worker";
-    });
-
-declare interface BrettInterfaceBase {
-  moduleId: string;
-  name: string;
-  title: string;
-  version: string;
-}
+/** The `asset_source` variant of an app's `views`. @public */
+declare type AssetSourceView = Extract<
+  NonNullable<z.output<typeof DefineAppInputSchema>["views"]>[number],
+  {
+    type: "asset_source";
+  }
+>;
 
 /** A studio workspace as Brett stores it. */
 export declare interface BrettWorkspace {
@@ -68,24 +34,6 @@ export declare interface BrettWorkspace {
   title?: string;
 }
 
-/**
- * The interface records deploy sends: the app view (only when `exposesAppView`),
- * every view, and every service.
- * @internal
- */
-export declare function buildExposes(
-  exposes: WorkbenchExposes,
-  { appName, appTitle, exposesAppView, version }: BuildExposesContext,
-): BrettInterface[];
-
-declare interface BuildExposesContext {
-  appName: string;
-  appTitle: string;
-  /** Whether the build exposes the app view (`./App`) — apps with an `entry`, and every studio. */
-  exposesAppView: boolean;
-  version: string;
-}
-
 /**
  * Throws unless `sourceDir` is a directory holding a federation build.
  * A workbench build always emits a module-federation remote, and may
@@ -128,14 +76,16 @@ export declare function createStudio(options: {
   projectId: string | undefined;
   slug: string;
   title: string;
+  visibility?: AppVisibility;
 }): Promise<CreatedApplication>;
 
 /**
  * User-facing input for `unstable_defineApp`. Excludes the internal
- * `applicationType`, `isSingleton`, and `config` — validated by the
- * schema but not part of the public surface (Sanity-owned apps set them via
- * `@ts-expect-error`). A union so an app declares an app `entry` or `views`,
- * never both.
+ * `applicationType`, `isSingleton`, and `config` — validated by the schema but
+ * not part of the public surface (Sanity-owned apps set them via
+ * `@ts-expect-error`). A union: an app declares an app `entry` (navigable) or
+ * panel `views`, never both — but an `asset_source` view is a separate kind and
+ * may accompany either.
  * @public
  */
 declare type DefineAppInput = Omit<
@@ -149,7 +99,7 @@ declare type DefineAppInput = Omit<
       }
     | {
         entry?: string;
-        views?: never;
+        views?: AssetSourceView[];
       }
   );
 
@@ -202,7 +152,6 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
     >;
     icon: z.ZodMiniOptional<z.ZodMiniString<string>>;
     isSingleton: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
-    name: z.ZodMiniString<string>;
     organizationId: z.ZodMiniString<string>;
     priority: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
     services: z.ZodMiniOptional<
@@ -211,7 +160,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
           [
             z.ZodMiniObject<
               {
-                title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                title: z.ZodMiniString<string>;
                 name: z.ZodMiniString<string>;
                 src: z.ZodMiniString<string>;
                 type: z.ZodMiniLiteral<"worker">;
@@ -231,13 +180,22 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
           [
             z.ZodMiniObject<
               {
-                title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                title: z.ZodMiniString<string>;
                 name: z.ZodMiniString<string>;
                 src: z.ZodMiniString<string>;
                 type: z.ZodMiniLiteral<"panel">;
               },
               z.core.$strip
             >,
+            z.ZodMiniObject<
+              {
+                title: z.ZodMiniString<string>;
+                name: z.ZodMiniString<string>;
+                src: z.ZodMiniString<string>;
+                type: z.ZodMiniLiteral<"asset_source">;
+              },
+              z.core.$strip
+            >,
           ],
           "type"
         >
@@ -319,9 +277,10 @@ export declare interface DeployedExpose {
  * @internal
  */
 export declare function deployWorkbenchApp(options: {
+  app: CliConfig["app"];
   applicationId: string;
   icon?: string;
-  interfaces: readonly BrettInterface[];
+  isApp: boolean;
   isAutoUpdating: boolean;
   label?: string;
   onDeployed?: () => void;
@@ -354,13 +313,10 @@ export declare function listApplications(
 
 /** @public */
 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"]>;
@@ -407,7 +363,7 @@ export declare function summarizeConfig(config: {
  * and one report line per non-empty group (for the human report).
  * @internal
  */
-export declare function summarizeExposes({
+export declare function summarizeInterfaces({
   services,
   views,
 }: WorkbenchExposes): {
@@ -435,6 +391,7 @@ declare const viewDeploymentPayloadSchema: z.ZodMiniObject<
           name: z.ZodMiniString<string>;
           src: z.ZodMiniString<string>;
           type: z.ZodMiniEnum<{
+            asset_source: "asset_source";
             panel: "panel";
           }>;
         },

package/dist/_exports/deploy.js

@@ -1,8 +1,8 @@
-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 { createCoreApp, createStudio, deployWorkbenchApp } from '../actions/deploy/deployWorkbenchApp.js';
 export { getWorkbench } from '../actions/deploy/getWorkbench.js';
+export { summarizeInterfaces } from '../actions/deploy/summarizeInterfaces.js';
 export { getApplication, getApplicationUrl, getWorkbenchUrl, listApplications } from '../services/applications.js';
 
 //# sourceMappingURL=deploy.js.map

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 {\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  listApplications,\n} from '../services/applications.js'\n"],"names":["buildExposes","summarizeExposes","checkBuiltOutput","deployConfig","resolveInstallationId","summarizeConfig","createCoreApp","createStudio","deployWorkbenchApp","getWorkbench","getApplication","getApplicationUrl","getWorkbenchUrl","listApplications"],"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,EACfC,gBAAgB,QACX,8BAA6B"}
+{"version":3,"sources":["../../src/_exports/deploy.ts"],"sourcesContent":["export {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 {type DeployedExpose, summarizeInterfaces} from '../actions/deploy/summarizeInterfaces.js'\nexport {\n  type Application,\n  type BrettWorkspace,\n  getApplication,\n  getApplicationUrl,\n  getWorkbenchUrl,\n  listApplications,\n} from '../services/applications.js'\n"],"names":["checkBuiltOutput","deployConfig","resolveInstallationId","summarizeConfig","createCoreApp","createStudio","deployWorkbenchApp","getWorkbench","summarizeInterfaces","getApplication","getApplicationUrl","getWorkbenchUrl","listApplications"],"mappings":"AAAA,SAAQA,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,SAA6BC,mBAAmB,QAAO,2CAA0C;AACjG,SAGEC,cAAc,EACdC,iBAAiB,EACjBC,eAAe,EACfC,gBAAgB,QACX,8BAA6B"}

package/dist/_exports/dev.d.ts

@@ -94,6 +94,19 @@ declare const devServerManifestSchema: z.ZodMiniObject<
               },
               z.core.$strip
             >,
+            z.ZodMiniObject<
+              {
+                metadata: z.ZodMiniNull;
+                type: z.ZodMiniLiteral<"asset_source">;
+                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;

package/dist/_exports/index.d.ts

@@ -1,11 +1,39 @@
+import { AssetSourceComponentProps } from "@sanity/types";
 import { z } from "zod/mini";
 
+/**
+ * An asset source's view-component slot — the module-federation expose for its
+ * one island.
+ * @public
+ */
+export declare type AssetSourceComponent = keyof AssetSourceViewComponents;
+
+/** The `asset_source` variant of an app's `views`. @public */
+declare type AssetSourceView = Extract<
+  NonNullable<z.output<typeof DefineAppInputSchema>["views"]>[number],
+  {
+    type: "asset_source";
+  }
+>;
+
+/**
+ * The component slots an `asset_source` view exposes — a single picker island,
+ * typed with the studio asset-source props it renders behind. The props are
+ * `@sanity/types`' `AssetSourceComponentProps` directly, so an authored picker
+ * receives exactly what a studio `AssetSource.component` does.
+ * @public
+ */
+export declare interface AssetSourceViewComponents {
+  asset_source: ViewComponent<AssetSourceComponentProps>;
+}
+
 /**
  * User-facing input for `unstable_defineApp`. Excludes the internal
- * `applicationType`, `isSingleton`, and `config` — validated by the
- * schema but not part of the public surface (Sanity-owned apps set them via
- * `@ts-expect-error`). A union so an app declares an app `entry` or `views`,
- * never both.
+ * `applicationType`, `isSingleton`, and `config` — validated by the schema but
+ * not part of the public surface (Sanity-owned apps set them via
+ * `@ts-expect-error`). A union: an app declares an app `entry` (navigable) or
+ * panel `views`, never both — but an `asset_source` view is a separate kind and
+ * may accompany either.
  * @public
  */
 export declare type DefineAppInput = Omit<
@@ -19,7 +47,7 @@ export declare type DefineAppInput = Omit<
       }
     | {
         entry?: string;
-        views?: never;
+        views?: AssetSourceView[];
       }
   );
 
@@ -72,7 +100,6 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
     >;
     icon: z.ZodMiniOptional<z.ZodMiniString<string>>;
     isSingleton: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
-    name: z.ZodMiniString<string>;
     organizationId: z.ZodMiniString<string>;
     priority: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
     services: z.ZodMiniOptional<
@@ -81,7 +108,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
           [
             z.ZodMiniObject<
               {
-                title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                title: z.ZodMiniString<string>;
                 name: z.ZodMiniString<string>;
                 src: z.ZodMiniString<string>;
                 type: z.ZodMiniLiteral<"worker">;
@@ -101,13 +128,22 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
           [
             z.ZodMiniObject<
               {
-                title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                title: z.ZodMiniString<string>;
                 name: z.ZodMiniString<string>;
                 src: z.ZodMiniString<string>;
                 type: z.ZodMiniLiteral<"panel">;
               },
               z.core.$strip
             >,
+            z.ZodMiniObject<
+              {
+                title: z.ZodMiniString<string>;
+                name: z.ZodMiniString<string>;
+                src: z.ZodMiniString<string>;
+                type: z.ZodMiniLiteral<"asset_source">;
+              },
+              z.core.$strip
+            >,
           ],
           "type"
         >
@@ -291,7 +327,7 @@ export declare type ServiceType = "worker";
 /**
  * Declare a Sanity Workbench application. Identity at runtime — returns the same
  * object reference, tagged with the workbench brand. Field validation (the
- * `name` pattern etc.) runs at build time in the CLI via `DefineAppInputSchema`;
+ * `slug` pattern etc.) runs at build time in the CLI via `DefineAppInputSchema`;
  * this helper stays a thin, pure identity wrapper.
  * @public
  */
@@ -343,6 +379,7 @@ export declare function unstable_defineView<TType extends InterfaceType>(
  * @internal
  */
 declare const VIEW_COMPONENTS: {
+  readonly asset_source: readonly ["asset_source"];
   readonly panel: readonly ["title", "panel"];
 };
 
@@ -366,6 +403,7 @@ declare interface ViewComponentBaseProps<TView> {
  * @public
  */
 export declare interface ViewComponentsByType {
+  asset_source: AssetSourceViewComponents;
   panel: PanelViewComponents;
 }
 

package/dist/_exports/index.js.map

@@ -1 +1 @@
-{"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"}
+{"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  AssetSourceComponent,\n  AssetSourceViewComponents,\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,14 @@
+export declare function toAppSlug(value: string): string | null;
+
 /** 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    slug: '%slug%',\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    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
+ * Studio scaffold — brands with slug/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    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";
+  "\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    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/init.js

@@ -1,5 +1,6 @@
 // Browser-safe `init` entry: the workbench `sanity.cli.ts` config templates the
-// CLI's init scaffolding fills in. Plain strings — no runtime deps.
+// CLI's init scaffolding fills in, and the coercion that fills `%slug%`. No runtime deps.
 export { workbenchAppConfigTemplate, workbenchStudioConfigTemplate } from '../actions/init/cliConfig.js';
+export { toAppSlug } from '../appSlug.js';
 
 //# sourceMappingURL=init.js.map

package/dist/_exports/init.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/_exports/init.ts"],"sourcesContent":["// Browser-safe `init` entry: the workbench `sanity.cli.ts` config templates the\n// CLI's init scaffolding fills in. Plain strings — no runtime deps.\nexport {\n  workbenchAppConfigTemplate,\n  workbenchStudioConfigTemplate,\n} from '../actions/init/cliConfig.js'\n"],"names":["workbenchAppConfigTemplate","workbenchStudioConfigTemplate"],"mappings":"AAAA,gFAAgF;AAChF,oEAAoE;AACpE,SACEA,0BAA0B,EAC1BC,6BAA6B,QACxB,+BAA8B"}
+{"version":3,"sources":["../../src/_exports/init.ts"],"sourcesContent":["// Browser-safe `init` entry: the workbench `sanity.cli.ts` config templates the\n// CLI's init scaffolding fills in, and the coercion that fills `%slug%`. No runtime deps.\nexport {\n  workbenchAppConfigTemplate,\n  workbenchStudioConfigTemplate,\n} from '../actions/init/cliConfig.js'\nexport {toAppSlug} from '../appSlug.js'\n"],"names":["workbenchAppConfigTemplate","workbenchStudioConfigTemplate","toAppSlug"],"mappings":"AAAA,gFAAgF;AAChF,0FAA0F;AAC1F,SACEA,0BAA0B,EAC1BC,6BAA6B,QACxB,+BAA8B;AACrC,SAAQC,SAAS,QAAO,gBAAe"}

package/dist/_exports/preview.d.ts

@@ -77,6 +77,19 @@ declare const devServerManifestSchema: z.ZodMiniObject<
               },
               z.core.$strip
             >,
+            z.ZodMiniObject<
+              {
+                metadata: z.ZodMiniNull;
+                type: z.ZodMiniLiteral<"asset_source">;
+                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;

package/dist/_exports/undeploy.d.ts

@@ -4,6 +4,14 @@ import { UndeployApplicationTarget } from "@sanity/cli-core/undeploy";
 import { UndeployConfigTarget } from "@sanity/cli-core/undeploy";
 import { z } from "zod/mini";
 
+/** The `asset_source` variant of an app's `views`. @public */
+declare type AssetSourceView = Extract<
+  NonNullable<z.output<typeof DefineAppInputSchema>["views"]>[number],
+  {
+    type: "asset_source";
+  }
+>;
+
 /**
  * The undeploy adapter for workbench apps, mirroring what a workbench deploy
  * creates: apps that expose interfaces delete their Brett application (the
@@ -20,10 +28,11 @@ export declare function createWorkbenchUndeployAdapter(options: {
 
 /**
  * User-facing input for `unstable_defineApp`. Excludes the internal
- * `applicationType`, `isSingleton`, and `config` — validated by the
- * schema but not part of the public surface (Sanity-owned apps set them via
- * `@ts-expect-error`). A union so an app declares an app `entry` or `views`,
- * never both.
+ * `applicationType`, `isSingleton`, and `config` — validated by the schema but
+ * not part of the public surface (Sanity-owned apps set them via
+ * `@ts-expect-error`). A union: an app declares an app `entry` (navigable) or
+ * panel `views`, never both — but an `asset_source` view is a separate kind and
+ * may accompany either.
  * @public
  */
 declare type DefineAppInput = Omit<
@@ -37,7 +46,7 @@ declare type DefineAppInput = Omit<
       }
     | {
         entry?: string;
-        views?: never;
+        views?: AssetSourceView[];
       }
   );
 
@@ -90,7 +99,6 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
     >;
     icon: z.ZodMiniOptional<z.ZodMiniString<string>>;
     isSingleton: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
-    name: z.ZodMiniString<string>;
     organizationId: z.ZodMiniString<string>;
     priority: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
     services: z.ZodMiniOptional<
@@ -99,7 +107,7 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
           [
             z.ZodMiniObject<
               {
-                title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                title: z.ZodMiniString<string>;
                 name: z.ZodMiniString<string>;
                 src: z.ZodMiniString<string>;
                 type: z.ZodMiniLiteral<"worker">;
@@ -119,13 +127,22 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
           [
             z.ZodMiniObject<
               {
-                title: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                title: z.ZodMiniString<string>;
                 name: z.ZodMiniString<string>;
                 src: z.ZodMiniString<string>;
                 type: z.ZodMiniLiteral<"panel">;
               },
               z.core.$strip
             >,
+            z.ZodMiniObject<
+              {
+                title: z.ZodMiniString<string>;
+                name: z.ZodMiniString<string>;
+                src: z.ZodMiniString<string>;
+                type: z.ZodMiniLiteral<"asset_source">;
+              },
+              z.core.$strip
+            >,
           ],
           "type"
         >
@@ -182,13 +199,10 @@ declare interface DeployedExpose {
 
 /** @public */
 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"]>;
@@ -226,6 +240,7 @@ declare const viewDeploymentPayloadSchema: z.ZodMiniObject<
           name: z.ZodMiniString<string>;
           src: z.ZodMiniString<string>;
           type: z.ZodMiniEnum<{
+            asset_source: "asset_source";
             panel: "panel";
           }>;
         },

package/dist/actions/deploy/deployConfig.js

@@ -5,7 +5,7 @@ import { subdebug } from '@sanity/cli-core';
 import { pack } from 'tar-fs';
 import { getWorkbenchUrl } from '../../services/applications.js';
 import { createConfig, resolveSingletonInstallationId } from '../../services/installations.js';
-import { summarizeExposeGroup } from './buildExposes.js';
+import { summarizeExposeGroup } from './summarizeInterfaces.js';
 const debug = subdebug('deploy');
 /**
  * The org's active installation for an app type, or `undefined` when none is

package/dist/actions/deploy/deployConfig.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/deploy/deployConfig.ts"],"sourcesContent":["import {basename, dirname} from 'node:path'\nimport {styleText} from 'node:util'\nimport {createGzip} from 'node:zlib'\n\nimport {type Output, subdebug} from '@sanity/cli-core'\nimport {pack} from 'tar-fs'\n\nimport {getWorkbenchUrl} from '../../services/applications.js'\nimport {createConfig, resolveSingletonInstallationId} from '../../services/installations.js'\nimport {summarizeExposeGroup} from './buildExposes.js'\n\nconst debug = subdebug('deploy')\n\n/**\n * The org's active installation for an app type, or `undefined` when none is\n * installed. Read-only, so `--dry-run` can report deployability.\n * @internal\n */\nexport async function resolveInstallationId(options: {\n  appType: string\n  organizationId: string\n}): Promise<string | undefined> {\n  switch (options.appType) {\n    case 'media-library': {\n      return resolveSingletonInstallationId(options.organizationId, 'media-library')\n    }\n    default: {\n      throw new Error(`Cannot create config for unknown app type: ${options.appType}`)\n    }\n  }\n}\n\n/**\n * A report heading and item list for a config; a media library's `fields` are\n * one of potentially many shapes.\n * @internal\n */\nexport function summarizeConfig(config: {\n  appType: string\n  fields: {name: string; src: string; title: string}[]\n}): string {\n  switch (config.appType) {\n    case 'media-library': {\n      return summarizeExposeGroup('Media library fields', config.fields)\n    }\n    default: {\n      throw new Error(`Cannot create config for unknown app type: ${config.appType}`)\n    }\n  }\n}\n\n/**\n * Upload the built module-federation remote to the installation as its config\n * snapshot. `installationId` is resolved by the caller so `--dry-run` never\n * reaches this mutating step.\n * @internal\n */\nexport async function deployConfig(options: {\n  appType: string\n  installationId: string\n  organizationId: string\n  output: Output\n  sourceDir: string\n  version: string\n}): Promise<void> {\n  const {appType, installationId, organizationId, output, sourceDir, version} = options\n  const tarball = pack(dirname(sourceDir), {entries: [basename(sourceDir)]}).pipe(createGzip())\n  await createConfig(installationId, {tarball, version})\n\n  debug('Deployed config for app type: %s', appType)\n  const url = getWorkbenchUrl(organizationId)\n  output.log(`\\n🚀 ${styleText('bold', 'Success!')} Config deployed to ${styleText('cyan', url)}`)\n}\n"],"names":["basename","dirname","styleText","createGzip","subdebug","pack","getWorkbenchUrl","createConfig","resolveSingletonInstallationId","summarizeExposeGroup","debug","resolveInstallationId","options","appType","organizationId","Error","summarizeConfig","config","fields","deployConfig","installationId","output","sourceDir","version","tarball","entries","pipe","url","log"],"mappings":"AAAA,SAAQA,QAAQ,EAAEC,OAAO,QAAO,YAAW;AAC3C,SAAQC,SAAS,QAAO,YAAW;AACnC,SAAQC,UAAU,QAAO,YAAW;AAEpC,SAAqBC,QAAQ,QAAO,mBAAkB;AACtD,SAAQC,IAAI,QAAO,SAAQ;AAE3B,SAAQC,eAAe,QAAO,iCAAgC;AAC9D,SAAQC,YAAY,EAAEC,8BAA8B,QAAO,kCAAiC;AAC5F,SAAQC,oBAAoB,QAAO,oBAAmB;AAEtD,MAAMC,QAAQN,SAAS;AAEvB;;;;CAIC,GACD,OAAO,eAAeO,sBAAsBC,OAG3C;IACC,OAAQA,QAAQC,OAAO;QACrB,KAAK;YAAiB;gBACpB,OAAOL,+BAA+BI,QAAQE,cAAc,EAAE;YAChE;QACA;YAAS;gBACP,MAAM,IAAIC,MAAM,CAAC,2CAA2C,EAAEH,QAAQC,OAAO,EAAE;YACjF;IACF;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASG,gBAAgBC,MAG/B;IACC,OAAQA,OAAOJ,OAAO;QACpB,KAAK;YAAiB;gBACpB,OAAOJ,qBAAqB,wBAAwBQ,OAAOC,MAAM;YACnE;QACA;YAAS;gBACP,MAAM,IAAIH,MAAM,CAAC,2CAA2C,EAAEE,OAAOJ,OAAO,EAAE;YAChF;IACF;AACF;AAEA;;;;;CAKC,GACD,OAAO,eAAeM,aAAaP,OAOlC;IACC,MAAM,EAACC,OAAO,EAAEO,cAAc,EAAEN,cAAc,EAAEO,MAAM,EAAEC,SAAS,EAAEC,OAAO,EAAC,GAAGX;IAC9E,MAAMY,UAAUnB,KAAKJ,QAAQqB,YAAY;QAACG,SAAS;YAACzB,SAASsB;SAAW;IAAA,GAAGI,IAAI,CAACvB;IAChF,MAAMI,aAAaa,gBAAgB;QAACI;QAASD;IAAO;IAEpDb,MAAM,oCAAoCG;IAC1C,MAAMc,MAAMrB,gBAAgBQ;IAC5BO,OAAOO,GAAG,CAAC,CAAC,KAAK,EAAE1B,UAAU,QAAQ,YAAY,oBAAoB,EAAEA,UAAU,QAAQyB,MAAM;AACjG"}
+{"version":3,"sources":["../../../src/actions/deploy/deployConfig.ts"],"sourcesContent":["import {basename, dirname} from 'node:path'\nimport {styleText} from 'node:util'\nimport {createGzip} from 'node:zlib'\n\nimport {type Output, subdebug} from '@sanity/cli-core'\nimport {pack} from 'tar-fs'\n\nimport {getWorkbenchUrl} from '../../services/applications.js'\nimport {createConfig, resolveSingletonInstallationId} from '../../services/installations.js'\nimport {summarizeExposeGroup} from './summarizeInterfaces.js'\n\nconst debug = subdebug('deploy')\n\n/**\n * The org's active installation for an app type, or `undefined` when none is\n * installed. Read-only, so `--dry-run` can report deployability.\n * @internal\n */\nexport async function resolveInstallationId(options: {\n  appType: string\n  organizationId: string\n}): Promise<string | undefined> {\n  switch (options.appType) {\n    case 'media-library': {\n      return resolveSingletonInstallationId(options.organizationId, 'media-library')\n    }\n    default: {\n      throw new Error(`Cannot create config for unknown app type: ${options.appType}`)\n    }\n  }\n}\n\n/**\n * A report heading and item list for a config; a media library's `fields` are\n * one of potentially many shapes.\n * @internal\n */\nexport function summarizeConfig(config: {\n  appType: string\n  fields: {name: string; src: string; title: string}[]\n}): string {\n  switch (config.appType) {\n    case 'media-library': {\n      return summarizeExposeGroup('Media library fields', config.fields)\n    }\n    default: {\n      throw new Error(`Cannot create config for unknown app type: ${config.appType}`)\n    }\n  }\n}\n\n/**\n * Upload the built module-federation remote to the installation as its config\n * snapshot. `installationId` is resolved by the caller so `--dry-run` never\n * reaches this mutating step.\n * @internal\n */\nexport async function deployConfig(options: {\n  appType: string\n  installationId: string\n  organizationId: string\n  output: Output\n  sourceDir: string\n  version: string\n}): Promise<void> {\n  const {appType, installationId, organizationId, output, sourceDir, version} = options\n  const tarball = pack(dirname(sourceDir), {entries: [basename(sourceDir)]}).pipe(createGzip())\n  await createConfig(installationId, {tarball, version})\n\n  debug('Deployed config for app type: %s', appType)\n  const url = getWorkbenchUrl(organizationId)\n  output.log(`\\n🚀 ${styleText('bold', 'Success!')} Config deployed to ${styleText('cyan', url)}`)\n}\n"],"names":["basename","dirname","styleText","createGzip","subdebug","pack","getWorkbenchUrl","createConfig","resolveSingletonInstallationId","summarizeExposeGroup","debug","resolveInstallationId","options","appType","organizationId","Error","summarizeConfig","config","fields","deployConfig","installationId","output","sourceDir","version","tarball","entries","pipe","url","log"],"mappings":"AAAA,SAAQA,QAAQ,EAAEC,OAAO,QAAO,YAAW;AAC3C,SAAQC,SAAS,QAAO,YAAW;AACnC,SAAQC,UAAU,QAAO,YAAW;AAEpC,SAAqBC,QAAQ,QAAO,mBAAkB;AACtD,SAAQC,IAAI,QAAO,SAAQ;AAE3B,SAAQC,eAAe,QAAO,iCAAgC;AAC9D,SAAQC,YAAY,EAAEC,8BAA8B,QAAO,kCAAiC;AAC5F,SAAQC,oBAAoB,QAAO,2BAA0B;AAE7D,MAAMC,QAAQN,SAAS;AAEvB;;;;CAIC,GACD,OAAO,eAAeO,sBAAsBC,OAG3C;IACC,OAAQA,QAAQC,OAAO;QACrB,KAAK;YAAiB;gBACpB,OAAOL,+BAA+BI,QAAQE,cAAc,EAAE;YAChE;QACA;YAAS;gBACP,MAAM,IAAIC,MAAM,CAAC,2CAA2C,EAAEH,QAAQC,OAAO,EAAE;YACjF;IACF;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASG,gBAAgBC,MAG/B;IACC,OAAQA,OAAOJ,OAAO;QACpB,KAAK;YAAiB;gBACpB,OAAOJ,qBAAqB,wBAAwBQ,OAAOC,MAAM;YACnE;QACA;YAAS;gBACP,MAAM,IAAIH,MAAM,CAAC,2CAA2C,EAAEE,OAAOJ,OAAO,EAAE;YAChF;IACF;AACF;AAEA;;;;;CAKC,GACD,OAAO,eAAeM,aAAaP,OAOlC;IACC,MAAM,EAACC,OAAO,EAAEO,cAAc,EAAEN,cAAc,EAAEO,MAAM,EAAEC,SAAS,EAAEC,OAAO,EAAC,GAAGX;IAC9E,MAAMY,UAAUnB,KAAKJ,QAAQqB,YAAY;QAACG,SAAS;YAACzB,SAASsB;SAAW;IAAA,GAAGI,IAAI,CAACvB;IAChF,MAAMI,aAAaa,gBAAgB;QAACI;QAASD;IAAO;IAEpDb,MAAM,oCAAoCG;IAC1C,MAAMc,MAAMrB,gBAAgBQ;IAC5BO,OAAOO,GAAG,CAAC,CAAC,KAAK,EAAE1B,UAAU,QAAQ,YAAY,oBAAoB,EAAEA,UAAU,QAAQyB,MAAM;AACjG"}