@sanity/workbench-cli 1.9.0 → 2.0.0

package/dist/_exports/build.d.ts

@@ -14,9 +14,8 @@ declare type AssetSourceView = Extract<
 /**
  * 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
- * advertised by `sanity start` resolve to the same id. Hashed with the Web Crypto
- * API rather than `node:crypto` for parity with `resolveAppId`'s browser-safe
- * home. `sanity deploy` resolves its own id from the applications API.
+ * advertised by `sanity start` resolve to the same id. `sanity deploy` resolves
+ * its own id from the applications API.
  */
 export declare function buildAppId(app: ResolvedWorkbenchApp): Promise<string>;
 
@@ -25,8 +24,8 @@ export declare function buildAppId(app: ResolvedWorkbenchApp): Promise<string>;
  * `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.
+ * panel `views`, never both — but `asset_source` and `tile` views are separate
+ * kinds and may accompany either.
  * @public
  */
 declare type DefineAppInput = Omit<
@@ -40,7 +39,7 @@ declare type DefineAppInput = Omit<
       }
     | {
         entry?: string;
-        views?: AssetSourceView[];
+        views?: (AssetSourceView | TileView)[];
       }
   );
 
@@ -137,6 +136,21 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
               },
               z.core.$strip
             >,
+            z.ZodMiniObject<
+              {
+                priority: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                size: z.ZodMiniEnum<{
+                  small: "small";
+                  large: "large";
+                  banner: "banner";
+                }>;
+                title: z.ZodMiniString<string>;
+                name: z.ZodMiniString<string>;
+                src: z.ZodMiniString<string>;
+                type: z.ZodMiniLiteral<"tile">;
+              },
+              z.core.$strip
+            >,
           ],
           "type"
         >
@@ -193,6 +207,14 @@ export declare function resolveWorkbenchApp(
   cliConfig: CliConfig | null | undefined,
 ): ResolvedWorkbenchApp | null;
 
+/** The `tile` variant of an app's `views`. @public */
+declare type TileView = Extract<
+  NonNullable<z.output<typeof DefineAppInputSchema>["views"]>[number],
+  {
+    type: "tile";
+  }
+>;
+
 /**
  * Nominal brand the CLI discriminates on to enable the workbench build/deploy
  * codepath. Registered via `Symbol.for` so the marker survives module-realm

package/dist/_exports/deploy.d.ts

@@ -21,6 +21,15 @@ declare type AssetSourceView = Extract<
   }
 >;
 
+/**
+ * A resource a deployment may interact with, as Brett stores it. Per-deployment
+ * and forbidden for singletons (the server 400s).
+ */
+export declare interface BrettAccess {
+  resourceId: string;
+  resourceType: "canvas" | "dashboard" | "dataset" | "media-library";
+}
+
 /** A studio workspace as Brett stores it. */
 export declare interface BrettWorkspace {
   dataset: string;
@@ -57,13 +66,11 @@ export declare function createCoreApp(options: {
 }): 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.
+ * `rollback` undoes the creation, so a later failure leaves no record stranded at the slug.
  * @internal
  */
 export declare interface CreatedApplication {
-  applicationId: string;
+  application: Application;
   rollback: () => Promise<void>;
 }
 
@@ -84,8 +91,8 @@ export declare function createStudio(options: {
  * `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.
+ * panel `views`, never both — but `asset_source` and `tile` views are separate
+ * kinds and may accompany either.
  * @public
  */
 declare type DefineAppInput = Omit<
@@ -99,7 +106,7 @@ declare type DefineAppInput = Omit<
       }
     | {
         entry?: string;
-        views?: AssetSourceView[];
+        views?: (AssetSourceView | TileView)[];
       }
   );
 
@@ -196,6 +203,21 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
               },
               z.core.$strip
             >,
+            z.ZodMiniObject<
+              {
+                priority: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                size: z.ZodMiniEnum<{
+                  small: "small";
+                  large: "large";
+                  banner: "banner";
+                }>;
+                title: z.ZodMiniString<string>;
+                name: z.ZodMiniString<string>;
+                src: z.ZodMiniString<string>;
+                type: z.ZodMiniLiteral<"tile">;
+              },
+              z.core.$strip
+            >,
           ],
           "type"
         >
@@ -258,7 +280,7 @@ export declare function deployConfig(options: {
 }): Promise<void>;
 
 /** A view or service as the deploy report and `--json` output surface it. */
-export declare interface DeployedExpose {
+export declare interface DeployedInterface {
   name: string;
   src: string;
   title: string;
@@ -277,6 +299,7 @@ export declare interface DeployedExpose {
  * @internal
  */
 export declare function deployWorkbenchApp(options: {
+  access?: readonly BrettAccess[];
   app: CliConfig["app"];
   applicationId: string;
   icon?: string;
@@ -359,18 +382,46 @@ export declare function summarizeConfig(config: {
 }): string;
 
 /**
- * The deploy summary of an app's exposes: the structured records (for `--json`)
- * and one report line per non-empty group (for the human report).
+ * One report line per non-empty group, alongside the records `--json` reports.
  * @internal
  */
 export declare function summarizeInterfaces({
   services,
   views,
 }: WorkbenchExposes): {
-  exposes: DeployedExpose[];
   lines: string[];
+  services: DeployedInterface[];
+  views: DeployedInterface[];
 };
 
+/** The `tile` variant of an app's `views`. @public */
+declare type TileView = Extract<
+  NonNullable<z.output<typeof DefineAppInputSchema>["views"]>[number],
+  {
+    type: "tile";
+  }
+>;
+
+/**
+ * Gated once so a plain app can't pick up a stray key: without a workbench
+ * there is nothing to contribute. `views` and `services` travel together.
+ */
+export declare function toWorkbenchPayload(
+  workbench: DeployableWorkbenchApp | null,
+  {
+    config,
+    interfaces,
+    title,
+  }: {
+    config?: string;
+    interfaces: {
+      services: DeployedInterface[];
+      views: DeployedInterface[];
+    } | null;
+    title: string;
+  },
+): Partial<WorkbenchDeployPayload>;
+
 declare type ViewDeploymentPayload = z.infer<
   typeof viewDeploymentPayloadSchema
 >;
@@ -393,6 +444,7 @@ declare const viewDeploymentPayloadSchema: z.ZodMiniObject<
           type: z.ZodMiniEnum<{
             asset_source: "asset_source";
             panel: "panel";
+            tile: "tile";
           }>;
         },
         z.core.$loose
@@ -419,6 +471,18 @@ declare const WORKBENCH_APP: unique symbol;
 declare type WorkbenchApp = DefineAppResult &
   z.output<typeof DefineAppInputSchema>;
 
+/** What a workbench app contributes to a deploy payload. */
+export declare interface WorkbenchDeployPayload {
+  slug: string;
+  title: string;
+  /** Media-library config summary. */
+  config?: string;
+  isSingleton?: boolean;
+  services?: DeployedInterface[];
+  views?: DeployedInterface[];
+  visibility?: string;
+}
+
 /**
  * Bundled so adding a declaration family touches this type and the artifact
  * expanders, not every hop of build/dev plumbing in between.

package/dist/_exports/deploy.js

@@ -1,5 +1,6 @@
 export { checkBuiltOutput } from '../actions/deploy/checkBuiltOutput.js';
 export { deployConfig, resolveInstallationId, summarizeConfig } from '../actions/deploy/deployConfig.js';
+export { toWorkbenchPayload } from '../actions/deploy/deployPayload.js';
 export { createCoreApp, createStudio, deployWorkbenchApp } from '../actions/deploy/deployWorkbenchApp.js';
 export { getWorkbench } from '../actions/deploy/getWorkbench.js';
 export { summarizeInterfaces } from '../actions/deploy/summarizeInterfaces.js';

package/dist/_exports/deploy.js.map

@@ -1 +1 @@
-{"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"}
+{"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 {toWorkbenchPayload, type WorkbenchDeployPayload} from '../actions/deploy/deployPayload.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 DeployedInterface, summarizeInterfaces} from '../actions/deploy/summarizeInterfaces.js'\nexport {\n  type Application,\n  type BrettAccess,\n  type BrettWorkspace,\n  getApplication,\n  getApplicationUrl,\n  getWorkbenchUrl,\n  listApplications,\n} from '../services/applications.js'\n"],"names":["checkBuiltOutput","deployConfig","resolveInstallationId","summarizeConfig","toWorkbenchPayload","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,SAAQC,kBAAkB,QAAoC,qCAAoC;AAClG,SACEC,aAAa,EAEbC,YAAY,EACZC,kBAAkB,QACb,0CAAyC;AAChD,SAAQC,YAAY,QAAO,oCAAmC;AAC9D,SAAgCC,mBAAmB,QAAO,2CAA0C;AACpG,SAIEC,cAAc,EACdC,iBAAiB,EACjBC,eAAe,EACfC,gBAAgB,QACX,8BAA6B"}

package/dist/_exports/dev.d.ts

@@ -107,6 +107,29 @@ declare const devServerManifestSchema: z.ZodMiniObject<
               },
               z.core.$strip
             >,
+            z.ZodMiniObject<
+              {
+                metadata: z.ZodMiniObject<
+                  {
+                    priority: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                    size: z.ZodMiniEnum<{
+                      small: "small";
+                      large: "large";
+                      banner: "banner";
+                    }>;
+                  },
+                  z.core.$strip
+                >;
+                type: z.ZodMiniLiteral<"tile">;
+                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

@@ -32,8 +32,8 @@ export declare interface AssetSourceViewComponents {
  * `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.
+ * panel `views`, never both — but `asset_source` and `tile` views are separate
+ * kinds and may accompany either.
  * @public
  */
 export declare type DefineAppInput = Omit<
@@ -47,7 +47,7 @@ export declare type DefineAppInput = Omit<
       }
     | {
         entry?: string;
-        views?: AssetSourceView[];
+        views?: (AssetSourceView | TileView)[];
       }
   );
 
@@ -144,6 +144,21 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
               },
               z.core.$strip
             >,
+            z.ZodMiniObject<
+              {
+                priority: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                size: z.ZodMiniEnum<{
+                  small: "small";
+                  large: "large";
+                  banner: "banner";
+                }>;
+                title: z.ZodMiniString<string>;
+                name: z.ZodMiniString<string>;
+                src: z.ZodMiniString<string>;
+                type: z.ZodMiniLiteral<"tile">;
+              },
+              z.core.$strip
+            >,
           ],
           "type"
         >
@@ -275,17 +290,6 @@ export declare type PanelViewProps = ViewComponentBaseProps<{
   type: "panel";
 }>;
 
-/**
- * The dev id for a workbench app — the address the server bound. `sanity dev`
- * keys on where the app is served so a running app can't collide with its
- * deployed twin. Sync and dependency-free: it's re-exported from the package's
- * browser-facing entry, so it must not pull in `node:crypto`.
- */
-export declare function resolveAppId(source: {
-  host: string;
-  port: number;
-}): string;
-
 /** @internal */
 declare const SERVICE_CONTRACT_VERSION = 1;
 
@@ -324,6 +328,60 @@ export declare interface ServiceInfo {
 /** @public */
 export declare type ServiceType = "worker";
 
+/**
+ * A tile's view-component slot — the module-federation expose for its one island.
+ * @public
+ */
+export declare type TileComponent = keyof TileViewComponents;
+
+/** @public */
+export declare type TileSize = z.infer<typeof TileSizeSchema>;
+
+/**
+ * A tile's footprint family — the shape it occupies on the dashboard. Modelled
+ * on iOS WidgetKit families, not a linear scale: `banner` is full-width and
+ * shallow, which a `small`→`large` magnitude can't express. The host maps a
+ * family to a layout slot; the component reads it to render per footprint.
+ * @public
+ */
+declare const TileSizeSchema: z.ZodMiniEnum<{
+  small: "small";
+  large: "large";
+  banner: "banner";
+}>;
+
+/** The `tile` variant of an app's `views`. @public */
+declare type TileView = Extract<
+  NonNullable<z.output<typeof DefineAppInputSchema>["views"]>[number],
+  {
+    type: "tile";
+  }
+>;
+
+/**
+ * The component slot a `tile` view exposes — a single island, typed with the
+ * tile props.
+ * @public
+ */
+export declare interface TileViewComponents {
+  tile: ViewComponent<TileViewProps>;
+}
+
+/**
+ * Props a tile component receives: its own interface record (name/src/title/
+ * type) plus its footprint `size`, so it can render per family. Mirrors the
+ * `tile` record the dashboard host renders from; drift is guarded by the stamped
+ * contract version. Placement `priority` is host-only metadata, not surfaced here.
+ * @public
+ */
+export declare type TileViewProps = ViewComponentBaseProps<{
+  name: string;
+  size: TileSize;
+  src: string;
+  title: string;
+  type: "tile";
+}>;
+
 /**
  * Declare a Sanity Workbench application. Identity at runtime — returns the same
  * object reference, tagged with the workbench brand. Field validation (the
@@ -381,6 +439,7 @@ export declare function unstable_defineView<TType extends InterfaceType>(
 declare const VIEW_COMPONENTS: {
   readonly asset_source: readonly ["asset_source"];
   readonly panel: readonly ["title", "panel"];
+  readonly tile: readonly ["tile"];
 };
 
 /** @internal */
@@ -405,6 +464,7 @@ declare interface ViewComponentBaseProps<TView> {
 export declare interface ViewComponentsByType {
   asset_source: AssetSourceViewComponents;
   panel: PanelViewComponents;
+  tile: TileViewComponents;
 }
 
 /**

package/dist/_exports/index.js

@@ -1,4 +1,3 @@
-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 {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"}
+{"version":3,"sources":["../../src/_exports/index.ts"],"sourcesContent":["export type {InterfaceType, ServiceType, TileSize} 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  TileComponent,\n  TileViewComponents,\n  TileViewProps,\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"}

package/dist/_exports/preview.d.ts

@@ -90,6 +90,29 @@ declare const devServerManifestSchema: z.ZodMiniObject<
               },
               z.core.$strip
             >,
+            z.ZodMiniObject<
+              {
+                metadata: z.ZodMiniObject<
+                  {
+                    priority: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                    size: z.ZodMiniEnum<{
+                      small: "small";
+                      large: "large";
+                      banner: "banner";
+                    }>;
+                  },
+                  z.core.$strip
+                >;
+                type: z.ZodMiniLiteral<"tile">;
+                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

@@ -12,6 +12,14 @@ declare type AssetSourceView = Extract<
   }
 >;
 
+declare interface ConfigSnapshot {
+  id: string;
+  createdAt?: string;
+  deployedBy?: string;
+  /** Whether this snapshot is the one being served; at most one per installation. */
+  isActive?: boolean;
+}
+
 /**
  * The undeploy adapter for workbench apps, mirroring what a workbench deploy
  * creates: apps that expose interfaces delete their Brett application (the
@@ -31,8 +39,8 @@ export declare function createWorkbenchUndeployAdapter(options: {
  * `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.
+ * panel `views`, never both — but `asset_source` and `tile` views are separate
+ * kinds and may accompany either.
  * @public
  */
 declare type DefineAppInput = Omit<
@@ -46,7 +54,7 @@ declare type DefineAppInput = Omit<
       }
     | {
         entry?: string;
-        views?: AssetSourceView[];
+        views?: (AssetSourceView | TileView)[];
       }
   );
 
@@ -143,6 +151,21 @@ declare const DefineAppInputSchema: z.ZodMiniObject<
               },
               z.core.$strip
             >,
+            z.ZodMiniObject<
+              {
+                priority: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+                size: z.ZodMiniEnum<{
+                  small: "small";
+                  large: "large";
+                  banner: "banner";
+                }>;
+                title: z.ZodMiniString<string>;
+                name: z.ZodMiniString<string>;
+                src: z.ZodMiniString<string>;
+                type: z.ZodMiniLiteral<"tile">;
+              },
+              z.core.$strip
+            >,
           ],
           "type"
         >
@@ -190,7 +213,7 @@ declare interface DeployableWorkbenchApp extends ResolvedWorkbenchApp {
 }
 
 /** A view or service as the deploy report and `--json` output surface it. */
-declare interface DeployedExpose {
+declare interface DeployedInterface {
   name: string;
   src: string;
   title: string;
@@ -220,6 +243,14 @@ declare interface ResolvedWorkbenchApp {
   readonly visibility?: AppVisibility;
 }
 
+/** The `tile` variant of an app's `views`. @public */
+declare type TileView = Extract<
+  NonNullable<z.output<typeof DefineAppInputSchema>["views"]>[number],
+  {
+    type: "tile";
+  }
+>;
+
 declare type ViewDeploymentPayload = z.infer<
   typeof viewDeploymentPayloadSchema
 >;
@@ -242,6 +273,7 @@ declare const viewDeploymentPayloadSchema: z.ZodMiniObject<
           type: z.ZodMiniEnum<{
             asset_source: "asset_source";
             panel: "panel";
+            tile: "tile";
           }>;
         },
         z.core.$loose
@@ -271,16 +303,11 @@ declare type WorkbenchApp = DefineAppResult &
 /** The workbench extension of the shared target; serializes into `--json` as-is. */
 declare type WorkbenchUndeployTarget =
   | (UndeployApplicationTarget & {
-      /** Interfaces (views and services) registered by the application. */
-      interfaces: DeployedExpose[];
+      services: DeployedInterface[];
+      views: DeployedInterface[];
     })
   | (UndeployConfigTarget & {
-      /** The deployed config snapshots an undeploy deletes. */
-      configs: {
-        createdAt: string | null;
-        deployedBy: string | null;
-        id: string;
-      }[];
+      configs: ConfigSnapshot[];
     });
 
 export {};

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 './summarizeInterfaces.js';
+import { summarizeGroup } from './summarizeInterfaces.js';
 const debug = subdebug('deploy');
 /**
  * The org's active installation for an app type, or `undefined` when none is
@@ -31,7 +31,7 @@ const debug = subdebug('deploy');
     switch(config.appType){
         case 'media-library':
             {
-                return summarizeExposeGroup('Media library fields', config.fields);
+                return summarizeGroup('Media library fields', config.fields);
             }
         default:
             {

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 './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"}
+{"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 {summarizeGroup} 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 summarizeGroup('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","summarizeGroup","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,cAAc,QAAO,2BAA0B;AAEvD,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,eAAe,wBAAwBQ,OAAOC,MAAM;YAC7D;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"}

package/dist/actions/deploy/deployPayload.js

@@ -0,0 +1,29 @@
+/**
+ * Gated once so a plain app can't pick up a stray key: without a workbench
+ * there is nothing to contribute. `views` and `services` travel together.
+ */ export function toWorkbenchPayload(workbench, { config, interfaces, title }) {
+    if (!workbench) return {};
+    const { services, views } = interfaces ?? {
+        services: [],
+        views: []
+    };
+    return {
+        ...config ? {
+            config
+        } : {},
+        ...workbench.isSingleton === undefined ? {} : {
+            isSingleton: workbench.isSingleton
+        },
+        ...services.length > 0 || views.length > 0 ? {
+            services,
+            views
+        } : {},
+        slug: workbench.slug,
+        title,
+        ...workbench.visibility ? {
+            visibility: workbench.visibility
+        } : {}
+    };
+}
+
+//# sourceMappingURL=deployPayload.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/deploy/deployPayload.ts"],"sourcesContent":["import {type DeployableWorkbenchApp} from './getWorkbench.js'\nimport {type DeployedInterface} from './summarizeInterfaces.js'\n\n/** What a workbench app contributes to a deploy payload. */\nexport interface WorkbenchDeployPayload {\n  slug: string\n  title: string\n\n  /** Media-library config summary. */\n  config?: string\n  isSingleton?: boolean\n  services?: DeployedInterface[]\n  views?: DeployedInterface[]\n  visibility?: string\n}\n\n/**\n * Gated once so a plain app can't pick up a stray key: without a workbench\n * there is nothing to contribute. `views` and `services` travel together.\n */\nexport function toWorkbenchPayload(\n  workbench: DeployableWorkbenchApp | null,\n  {\n    config,\n    interfaces,\n    title,\n  }: {\n    config?: string\n    interfaces: {services: DeployedInterface[]; views: DeployedInterface[]} | null\n    title: string\n  },\n): Partial<WorkbenchDeployPayload> {\n  if (!workbench) return {}\n  const {services, views} = interfaces ?? {services: [], views: []}\n  return {\n    ...(config ? {config} : {}),\n    ...(workbench.isSingleton === undefined ? {} : {isSingleton: workbench.isSingleton}),\n    ...(services.length > 0 || views.length > 0 ? {services, views} : {}),\n    slug: workbench.slug,\n    title,\n    ...(workbench.visibility ? {visibility: workbench.visibility} : {}),\n  }\n}\n"],"names":["toWorkbenchPayload","workbench","config","interfaces","title","services","views","isSingleton","undefined","length","slug","visibility"],"mappings":"AAgBA;;;CAGC,GACD,OAAO,SAASA,mBACdC,SAAwC,EACxC,EACEC,MAAM,EACNC,UAAU,EACVC,KAAK,EAKN;IAED,IAAI,CAACH,WAAW,OAAO,CAAC;IACxB,MAAM,EAACI,QAAQ,EAAEC,KAAK,EAAC,GAAGH,cAAc;QAACE,UAAU,EAAE;QAAEC,OAAO,EAAE;IAAA;IAChE,OAAO;QACL,GAAIJ,SAAS;YAACA;QAAM,IAAI,CAAC,CAAC;QAC1B,GAAID,UAAUM,WAAW,KAAKC,YAAY,CAAC,IAAI;YAACD,aAAaN,UAAUM,WAAW;QAAA,CAAC;QACnF,GAAIF,SAASI,MAAM,GAAG,KAAKH,MAAMG,MAAM,GAAG,IAAI;YAACJ;YAAUC;QAAK,IAAI,CAAC,CAAC;QACpEI,MAAMT,UAAUS,IAAI;QACpBN;QACA,GAAIH,UAAUU,UAAU,GAAG;YAACA,YAAYV,UAAUU,UAAU;QAAA,IAAI,CAAC,CAAC;IACpE;AACF"}