@sanity/workbench-cli 2.1.0 → 2.2.1

package/README.md

@@ -4,7 +4,7 @@ Internal implementation detail of the [Sanity CLI](https://github.com/sanity-io/
 It backs the CLI's **unstable** workbench support and is not meant to be installed
 or imported directly — its API can change or be removed without notice.
 
-Workbench is opt-in per project via `unstable_defineApp` in `sanity.cli.ts`; use it
+Workbench is opt-in per project via `defineApplication` in `sanity.cli.ts`; use it
 through the `sanity` CLI, not this package.
 
 Maintainers: see `ARCHITECTURE.md` (not published) for how this package fits together.

package/dist/_exports/build.d.ts

@@ -1,11 +1,11 @@
-import { n as WorkbenchExposes, r as resolveWorkbenchApp, t as ResolvedWorkbenchApp } from "./resolveWorkbenchApp-Be9eU8mu.js";
+import { a as resolveWorkbenchApp, i as WorkbenchExposes, n as resolveWorkbenchConfig, r as ResolvedWorkbenchApp, t as ResolvedMediaLibraryConfig } from "./resolveWorkbenchConfig-6iznHbED.js";
 import { PluginOption } from "vite";
 /**
  * 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
+ * views, web workers, 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
@@ -21,7 +21,7 @@ import { PluginOption } from "vite";
  *
  * @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.
+ * @param exposes - The app's declared views/web workers/config.
  * @internal
  */
 declare function workbenchOptimizeDeps(options: {
@@ -59,5 +59,5 @@ declare function workbenchVitePlugins(options: WorkbenchViteOptions): Promise<Pl
  * its own id from the applications API.
  */
 declare function buildAppId(app: ResolvedWorkbenchApp): Promise<string>;
-export { type WorkbenchExposes, buildAppId, resolveWorkbenchApp, workbenchOptimizeDeps, workbenchVitePlugins };
+export { type ResolvedMediaLibraryConfig, type WorkbenchExposes, buildAppId, resolveWorkbenchApp, resolveWorkbenchConfig, workbenchOptimizeDeps, workbenchVitePlugins };
 //# sourceMappingURL=build.d.ts.map

package/dist/_exports/build.js

@@ -1,11 +1,12 @@
 // Node-only build entry: the module-federation Vite plugins that
 // `@sanity/cli-build`'s `getViteConfig` swaps in for a workbench app, plus the
-// resolver the build reads declared views/services from. The build needs no
+// resolver the build reads declared views/web workers 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';
+export { resolveWorkbenchConfig } from '../resolveWorkbenchConfig.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 {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"}
+{"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/web workers 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'\nexport {type ResolvedMediaLibraryConfig, resolveWorkbenchConfig} from '../resolveWorkbenchConfig.js'\n"],"names":["workbenchOptimizeDeps","workbenchVitePlugins","buildAppId","resolveWorkbenchApp","resolveWorkbenchConfig"],"mappings":"AAAA,iEAAiE;AACjE,+EAA+E;AAC/E,+EAA+E;AAC/E,+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;AACpF,SAAyCC,sBAAsB,QAAO,+BAA8B"}

package/dist/_exports/defineApp-DldjQwq6.d.ts

@@ -0,0 +1,375 @@
+import { z } from "zod/mini";
+/** @internal */
+declare const VIEW_CONTRACT_VERSION = 1;
+/** @internal */
+declare const SERVICE_CONTRACT_VERSION = 1;
+/**
+ * A view component. The return is opaque so the runtime helpers carry no React
+ * dependency — the generated artifact renders it with the app's own React.
+ * @public
+ */
+type ViewComponent<TProps> = (props: TProps) => unknown;
+/** @public */
+interface ViewComponentBaseProps<TView> {
+  view: TView;
+}
+/** Component slots per view surface; windows load outside the component artifact path. @internal */
+declare const VIEW_COMPONENTS: {
+  readonly app: readonly [];
+  readonly asset_source: readonly ["asset_source"];
+  readonly panel: readonly ["title", "panel"];
+  readonly tile: readonly ["tile"];
+};
+/** @public */
+type ViewSurface = keyof typeof VIEW_COMPONENTS;
+/**
+ * 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";
+}>;
+/** @public */
+type TileSize = z.infer<typeof TileSizeSchema>;
+/** @public */
+type ServiceType = 'worker';
+declare const DockGroupSchema: z.ZodMiniEnum<{
+  "dock.system": "dock.system";
+  "dock.applications": "dock.applications";
+  "dock.user": "dock.user";
+}>;
+/** @public */
+type DockGroup = z.output<typeof DockGroupSchema>;
+declare const PanelViewSchema: z.ZodMiniObject<{
+  dock: z.ZodMiniOptional<z.ZodMiniObject<{
+    group: z.ZodMiniOptional<z.ZodMiniEnum<{
+      "dock.system": "dock.system";
+      "dock.applications": "dock.applications";
+      "dock.user": "dock.user";
+    }>>;
+    order: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+  }, z.core.$strip>>;
+  title: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+  src: z.ZodMiniString<string>;
+  surface: z.ZodMiniLiteral<"panel">;
+}, z.core.$strip>;
+/** @public */
+type PanelView = z.output<typeof PanelViewSchema>;
+/** @public */
+type DefinePanelViewInput = Omit<PanelView, 'surface'>;
+/** @public */
+declare function definePanelView(view: DefinePanelViewInput): PanelView;
+declare const WindowViewSchema: z.ZodMiniObject<{
+  dock: z.ZodMiniOptional<z.ZodMiniObject<{
+    group: z.ZodMiniOptional<z.ZodMiniEnum<{
+      "dock.system": "dock.system";
+      "dock.applications": "dock.applications";
+      "dock.user": "dock.user";
+    }>>;
+    order: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+  }, z.core.$strip>>;
+  title: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+  src: z.ZodMiniString<string>;
+  surface: z.ZodMiniLiteral<"app">;
+}, z.core.$strip>;
+/** @public */
+type WindowView = z.output<typeof WindowViewSchema>;
+/** @public */
+type DefineWindowViewInput = Omit<WindowView, 'surface'>;
+/** @public */
+declare function defineWindowView(view: DefineWindowViewInput): WindowView;
+declare const AssetSourceViewSchema: z.ZodMiniObject<{
+  title: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+  src: z.ZodMiniString<string>;
+  surface: z.ZodMiniLiteral<"asset_source">;
+}, z.core.$strip>;
+/** @public */
+type AssetSourceView = z.output<typeof AssetSourceViewSchema>;
+/** @public */
+type DefineAssetSourceViewInput = Omit<AssetSourceView, 'surface'>;
+/** @public */
+declare function defineAssetSourceView(view: DefineAssetSourceViewInput): AssetSourceView;
+declare const TileViewSchema: z.ZodMiniObject<{
+  order: 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>;
+  surface: z.ZodMiniLiteral<"tile">;
+}, z.core.$strip>;
+/** @public */
+type TileView = z.output<typeof TileViewSchema>;
+/** @public */
+type DefineTileViewInput = Omit<TileView, 'surface'>;
+/** @public */
+declare function defineTileView(view: DefineTileViewInput): TileView;
+/** @internal */
+declare const InterfaceDeclarationSchema: z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+  dock: z.ZodMiniOptional<z.ZodMiniObject<{
+    group: z.ZodMiniOptional<z.ZodMiniEnum<{
+      "dock.system": "dock.system";
+      "dock.applications": "dock.applications";
+      "dock.user": "dock.user";
+    }>>;
+    order: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+  }, z.core.$strip>>;
+  title: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+  src: z.ZodMiniString<string>;
+  surface: z.ZodMiniLiteral<"app">;
+}, z.core.$strip>, z.ZodMiniObject<{
+  dock: z.ZodMiniOptional<z.ZodMiniObject<{
+    group: z.ZodMiniOptional<z.ZodMiniEnum<{
+      "dock.system": "dock.system";
+      "dock.applications": "dock.applications";
+      "dock.user": "dock.user";
+    }>>;
+    order: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+  }, z.core.$strip>>;
+  title: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+  src: z.ZodMiniString<string>;
+  surface: z.ZodMiniLiteral<"panel">;
+}, z.core.$strip>, z.ZodMiniObject<{
+  title: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+  src: z.ZodMiniString<string>;
+  surface: z.ZodMiniLiteral<"asset_source">;
+}, z.core.$strip>, z.ZodMiniObject<{
+  order: 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>;
+  surface: z.ZodMiniLiteral<"tile">;
+}, z.core.$strip>], "surface">;
+/** @public */
+type ViewDeclaration = z.output<typeof InterfaceDeclarationSchema>;
+declare const WebWorkerSchema: z.ZodMiniObject<{
+  title: z.ZodMiniString<string>;
+  name: z.ZodMiniString<string>;
+  src: z.ZodMiniString<string>;
+  type: z.ZodMiniLiteral<"worker">;
+}, z.core.$strip>;
+/** @public */
+type WebWorker = z.output<typeof WebWorkerSchema>;
+/** @public */
+type DefineWebWorkerInput = Omit<WebWorker, 'type'>;
+/** @public */
+declare function defineWebWorker(webWorker: DefineWebWorkerInput): WebWorker;
+/**
+ * A workbench config's built value, keyed by `appType`; deploys as a versioned
+ * snapshot, not an interface.
+ * @internal
+ */
+declare const ConfigSchema: z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+  appType: z.ZodMiniLiteral<"media-library">;
+  fields: z.ZodMiniArray<z.ZodMiniObject<{
+    public: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+    title: z.ZodMiniString<string>;
+    name: z.ZodMiniString<string>;
+    src: z.ZodMiniString<string>;
+  }, z.core.$strip>>;
+}, z.core.$strip>], "appType">;
+/**
+ * The `{appType, fields}` config value the build expands into a federation
+ * remote and the deploy summarizes.
+ * @internal
+ */
+type WorkbenchConfigValue = z.output<typeof ConfigSchema>;
+/**
+ * Runtime-validation schema for `defineApplication`.
+ * @internal
+ */
+declare const DefineAppInputSchema: z.ZodMiniObject<{
+  applicationType: z.ZodMiniOptional<z.ZodMiniEnum<{
+    coreApp: "coreApp";
+    studio: "studio";
+    canvas: "canvas";
+    dashboard: "dashboard";
+  }>>;
+  dock: z.ZodMiniOptional<z.ZodMiniObject<{
+    group: z.ZodMiniOptional<z.ZodMiniEnum<{
+      "dock.system": "dock.system";
+      "dock.applications": "dock.applications";
+      "dock.user": "dock.user";
+    }>>;
+    order: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+  }, z.core.$strip>>;
+  entry: z.ZodMiniOptional<z.ZodMiniString<string>>;
+  icon: z.ZodMiniOptional<z.ZodMiniString<string>>;
+  name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+  organizationId: z.ZodMiniString<string>;
+  slug: z.ZodMiniString<string>;
+  title: z.ZodMiniString<string>;
+  views: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+    dock: z.ZodMiniOptional<z.ZodMiniObject<{
+      group: z.ZodMiniOptional<z.ZodMiniEnum<{
+        "dock.system": "dock.system";
+        "dock.applications": "dock.applications";
+        "dock.user": "dock.user";
+      }>>;
+      order: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+    }, z.core.$strip>>;
+    title: z.ZodMiniString<string>;
+    name: z.ZodMiniString<string>;
+    src: z.ZodMiniString<string>;
+    surface: z.ZodMiniLiteral<"app">;
+  }, z.core.$strip>, z.ZodMiniObject<{
+    dock: z.ZodMiniOptional<z.ZodMiniObject<{
+      group: z.ZodMiniOptional<z.ZodMiniEnum<{
+        "dock.system": "dock.system";
+        "dock.applications": "dock.applications";
+        "dock.user": "dock.user";
+      }>>;
+      order: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+    }, z.core.$strip>>;
+    title: z.ZodMiniString<string>;
+    name: z.ZodMiniString<string>;
+    src: z.ZodMiniString<string>;
+    surface: z.ZodMiniLiteral<"panel">;
+  }, z.core.$strip>, z.ZodMiniObject<{
+    title: z.ZodMiniString<string>;
+    name: z.ZodMiniString<string>;
+    src: z.ZodMiniString<string>;
+    surface: z.ZodMiniLiteral<"asset_source">;
+  }, z.core.$strip>, z.ZodMiniObject<{
+    order: 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>;
+    surface: z.ZodMiniLiteral<"tile">;
+  }, z.core.$strip>], "surface">>>;
+  visibility: z.ZodMiniOptional<z.ZodMiniEnum<{
+    default: "default";
+    unlisted: "unlisted";
+    disabled: "disabled";
+  }>>;
+  webWorkers: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+    title: z.ZodMiniString<string>;
+    name: z.ZodMiniString<string>;
+    src: z.ZodMiniString<string>;
+    type: z.ZodMiniLiteral<"worker">;
+  }, z.core.$strip>], "type">>>;
+}, z.core.$strip>;
+/**
+ * User-facing input for `defineApplication`. Excludes the internal
+ * `applicationType`.
+ * @public
+ */
+type DefineAppInput = Omit<z.output<typeof DefineAppInputSchema>, 'applicationType'>;
+/**
+ * Nominal brand the CLI discriminates on to enable the workbench build/deploy
+ * codepath. Registered via `Symbol.for` so the marker survives module-realm
+ * boundaries — `@sanity/cli-core` re-derives the same global symbol with
+ * `Symbol.for` rather than importing it, so it stays internal to this module.
+ */
+declare const WORKBENCH_APP: unique symbol;
+/**
+ * The branded result of `defineApplication`. Carries the same fields as the
+ * input plus the internal brand — users only ever see `DefineAppInput`.
+ * @public
+ */
+type DefineAppResult = DefineAppInput & {
+  readonly [WORKBENCH_APP]: true;
+};
+/**
+ * A branded app as the CLI reads it — the full schema shape, including the
+ * internal fields `DefineAppInput` omits. Schema-derived so the narrowing
+ * can't drift from what the schema validates.
+ * @public
+ */
+type WorkbenchApp = DefineAppResult & z.output<typeof DefineAppInputSchema>;
+/**
+ * Whether `app` is a branded `defineApplication(...)` result — the sole
+ * workbench opt-in.
+ * @public
+ */
+declare function isWorkbenchApp(app: unknown): app is WorkbenchApp;
+/**
+ * Declare a Sanity Workbench application. Identity at runtime — returns the same
+ * object reference, tagged with the workbench brand. Field validation (the
+ * `slug` pattern etc.) runs at build time in the CLI via `DefineAppInputSchema`;
+ * this helper stays a thin, pure identity wrapper.
+ * @public
+ */
+declare function defineApplication(input: DefineAppInput): DefineAppResult;
+/**
+ * One custom field a media library exposes. `src` default-exports a `defineField(...)` schema type.
+ * @public
+ */
+interface MediaLibraryField {
+  /** Unique within the media library. */
+  name: string;
+  src: string;
+  title: string;
+  /** Readable outside the owning organization. */
+  public?: boolean;
+}
+/**
+ * Sanity-owned singleton, so authors don't name or title the app — only `organizationId` is required.
+ * @public
+ */
+interface DefineMediaLibraryInput {
+  /** Organization that owns the media library — the CLI runs and deploys against it. */
+  organizationId: string;
+  fields?: MediaLibraryField[];
+}
+/**
+ * Nominal brand the CLI discriminates a config on. A config is *not* an app: it
+ * carries no `slug`/`title`/application identity, only a target `appType`, its
+ * owning `organizationId`, and its `fields`. Registered via `Symbol.for` so the
+ * marker survives module-realm boundaries — `@sanity/cli-core` re-derives the
+ * same global symbol rather than importing it.
+ */
+declare const WORKBENCH_CONFIG: unique symbol;
+/**
+ * A branded workbench config as the CLI reads it: bound to its target app by
+ * `appType`, not carrying its own app identity. The deploy/undeploy/build paths
+ * discriminate it via {@link isWorkbenchConfig}.
+ * @public
+ */
+interface WorkbenchConfig {
+  appType: 'media-library';
+  fields: MediaLibraryField[];
+  organizationId: string;
+  readonly [WORKBENCH_CONFIG]: true;
+}
+/**
+ * Whether `app` is a branded `unstable_defineMediaLibrary(...)` config — a
+ * config-carrier rather than an app. Configs live in `cliConfig.app` alongside
+ * apps but resolve through `resolveWorkbenchConfig`, not `resolveWorkbenchApp`.
+ * @public
+ */
+declare function isWorkbenchConfig(app: unknown): app is WorkbenchConfig;
+/**
+ * Declare the Sanity Media Library config. The Media Library is a Sanity-owned
+ * singleton, so this is not an app — it carries no slug or title, only the
+ * target `appType`, its owning organization, and the `fields` it contributes to
+ * the installation's config.
+ * @public
+ */
+declare function unstable_defineMediaLibrary(input: DefineMediaLibraryInput): WorkbenchConfig;
+export { WorkbenchConfigValue as A, VIEW_CONTRACT_VERSION as C, ViewSurface as D, ViewDeclaration as E, defineWindowView as F, definePanelView as M, defineTileView as N, WebWorker as O, defineWebWorker as P, TileView as S, ViewComponentBaseProps as T, DockGroup as _, WorkbenchApp as a, ServiceType as b, isWorkbenchApp as c, AssetSourceView as d, DefineAssetSourceViewInput as f, DefineWindowViewInput as g, DefineWebWorkerInput as h, MediaLibraryField as i, defineAssetSourceView as j, WindowView as k, isWorkbenchConfig as l, DefineTileViewInput as m, DefineAppResult as n, WorkbenchConfig as o, DefinePanelViewInput as p, DefineMediaLibraryInput as r, defineApplication as s, DefineAppInput as t, unstable_defineMediaLibrary as u, PanelView as v, ViewComponent as w, TileSize as x, SERVICE_CONTRACT_VERSION as y };
+//# sourceMappingURL=defineApp-DldjQwq6.d.ts.map

package/dist/_exports/deploy.d.ts

@@ -1,5 +1,6 @@
-import { i as getWorkbench, n as summarizeInterfaces, r as DeployableWorkbenchApp, t as DeployedInterface } from "./summarizeInterfaces-DLsq6P43.js";
-import "./contract-DyG11fQ7.js";
+import "./defineApp-DldjQwq6.js";
+import { n as resolveWorkbenchConfig, t as ResolvedMediaLibraryConfig } from "./resolveWorkbenchConfig-6iznHbED.js";
+import { a as DeployableWorkbenchApp, i as summarizeInterfaces, n as DeployedView, o as getWorkbench, r as DeployedWebWorker, t as DeployedInterface } from "./summarizeInterfaces-CjkeWwkY.js";
 import { AppVisibility, CliConfig, Output } from "@sanity/cli-core";
 import "node:zlib";
 /**
@@ -52,9 +53,8 @@ interface WorkbenchDeployPayload {
   title: string;
   /** Media-library config summary. */
   config?: string;
-  isSingleton?: boolean;
-  services?: DeployedInterface[];
-  views?: DeployedInterface[];
+  services?: DeployedWebWorker[];
+  views?: DeployedView[];
   visibility?: string;
 }
 /**
@@ -64,8 +64,8 @@ interface WorkbenchDeployPayload {
 declare function toWorkbenchPayload(workbench: DeployableWorkbenchApp | null, { config, interfaces, title }: {
   config?: string;
   interfaces: {
-    services: DeployedInterface[];
-    views: DeployedInterface[];
+    services: DeployedWebWorker[];
+    views: DeployedView[];
   } | null;
   title: string;
 }): Partial<WorkbenchDeployPayload>;
@@ -117,7 +117,7 @@ interface CreatedApplication {
  * @internal
  */
 declare function createCoreApp(options: {
-  isSingleton?: boolean;
+  name?: string;
   organizationId: string;
   slug: string;
   title: string;
@@ -128,6 +128,7 @@ declare function createCoreApp(options: {
  * @internal
  */
 declare function createStudio(options: {
+  name?: string;
   organizationId: string;
   projectId: string | undefined;
   slug: string;
@@ -160,5 +161,5 @@ declare function deployWorkbenchApp(options: {
   visibility?: AppVisibility;
   workspaces?: readonly BrettWorkspace[];
 }): Promise<void>;
-export { type Application, type BrettAccess, type BrettWorkspace, type CreatedApplication, type DeployedInterface, type WorkbenchDeployPayload, checkBuiltOutput, createCoreApp, createStudio, deployConfig, deployWorkbenchApp, getApplication, getApplicationUrl, getWorkbench, getWorkbenchUrl, listApplications, resolveInstallationId, summarizeConfig, summarizeInterfaces, toWorkbenchPayload };
+export { type Application, type BrettAccess, type BrettWorkspace, type CreatedApplication, type DeployedInterface, type DeployedView, type DeployedWebWorker, type ResolvedMediaLibraryConfig, type WorkbenchDeployPayload, checkBuiltOutput, createCoreApp, createStudio, deployConfig, deployWorkbenchApp, getApplication, getApplicationUrl, getWorkbench, getWorkbenchUrl, listApplications, resolveInstallationId, resolveWorkbenchConfig, summarizeConfig, summarizeInterfaces, toWorkbenchPayload };
 //# sourceMappingURL=deploy.d.ts.map

package/dist/_exports/deploy.js

@@ -4,6 +4,7 @@ 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';
+export { resolveWorkbenchConfig } from '../resolveWorkbenchConfig.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 {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"}
+{"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 {\n  type DeployedInterface,\n  type DeployedView,\n  type DeployedWebWorker,\n  summarizeInterfaces,\n} from '../actions/deploy/summarizeInterfaces.js'\nexport {type ResolvedMediaLibraryConfig, resolveWorkbenchConfig} from '../resolveWorkbenchConfig.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","resolveWorkbenchConfig","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,SAIEC,mBAAmB,QACd,2CAA0C;AACjD,SAAyCC,sBAAsB,QAAO,+BAA8B;AACpG,SAIEC,cAAc,EACdC,iBAAiB,EACjBC,eAAe,EACfC,gBAAgB,QACX,8BAA6B"}

package/dist/_exports/dev.d.ts

@@ -1,4 +1,4 @@
-import { t as DevServerManifest } from "./registry-DI7hnTof.js";
+import { t as DevServerManifest } from "./registry-HE_dEHFa.js";
 import { CliConfig, Output } from "@sanity/cli-core";
 import { ViteDevServer } from "vite";
 /**

package/dist/_exports/index.d.ts

@@ -1,5 +1,4 @@
-import { a as MediaLibraryField, c as unstable_defineApp, i as DockGroup, l as unstable_defineMediaLibrary, n as DefineAppResult, o as WorkbenchApp, r as DefineMediaLibraryInput, s as isWorkbenchApp, t as DefineAppInput } from "./defineApp-DSvQx8rf.js";
-import { a as VIEW_CONTRACT_VERSION, i as TileSize, n as SERVICE_CONTRACT_VERSION, o as ViewComponent, r as ServiceType, s as ViewComponentBaseProps, t as InterfaceType } from "./contract-DyG11fQ7.js";
+import { C as VIEW_CONTRACT_VERSION, D as ViewSurface, E as ViewDeclaration, F as defineWindowView, M as definePanelView, N as defineTileView, O as WebWorker, P as defineWebWorker, S as TileView, T as ViewComponentBaseProps, _ as DockGroup, a as WorkbenchApp, b as ServiceType, c as isWorkbenchApp, d as AssetSourceView, f as DefineAssetSourceViewInput, g as DefineWindowViewInput, h as DefineWebWorkerInput, i as MediaLibraryField, j as defineAssetSourceView, k as WindowView, l as isWorkbenchConfig, m as DefineTileViewInput, n as DefineAppResult, o as WorkbenchConfig, p as DefinePanelViewInput, r as DefineMediaLibraryInput, s as defineApplication, t as DefineAppInput, u as unstable_defineMediaLibrary, v as PanelView, w as ViewComponent, x as TileSize, y as SERVICE_CONTRACT_VERSION } from "./defineApp-DldjQwq6.js";
 import { AssetSourceComponentProps } from "@sanity/types";
 /**
  * The service's own declaration, surfaced to the callback.
@@ -49,6 +48,13 @@ interface DefinedService<TType extends ServiceType = ServiceType> {
  * @public
  */
 declare function unstable_defineService<TType extends ServiceType>(type: TType, run: ServiceCallbacksByType[TType]): DefinedService<TType>;
+/** @public */
+type WindowViewProps = ViewComponentBaseProps<{
+  name: string;
+  src: string;
+  surface: 'app';
+  title: string;
+}>;
 /**
  * Props a panel component receives: its interface record, minus the
  * service-assigned `id`/`deployment_id` a local dev server can't provide. Mirrors
@@ -59,8 +65,8 @@ declare function unstable_defineService<TType extends ServiceType>(type: TType,
 type PanelViewProps = ViewComponentBaseProps<{
   name: string;
   src: string;
+  surface: 'panel';
   title: string;
-  type: 'panel';
 }>;
 /**
  * The component slots a `panel` view exposes — each its own module-federation
@@ -93,18 +99,18 @@ interface AssetSourceViewComponents {
  */
 type AssetSourceComponent = keyof AssetSourceViewComponents;
 /**
- * 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
+ * Props a tile component receives: its own interface record 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.
+ * contract version. Placement `order` is host-only metadata, not surfaced here.
  * @public
  */
 type TileViewProps = ViewComponentBaseProps<{
   name: string;
   size: TileSize;
   src: string;
+  surface: 'tile';
   title: string;
-  type: 'tile';
 }>;
 /**
  * The component slot a `tile` view exposes — a single island, typed with the
@@ -120,22 +126,23 @@ interface TileViewComponents {
  */
 type TileComponent = keyof TileViewComponents;
 /**
- * The components each interface type exposes, keyed by type.
+ * The components each view surface exposes.
  * @public
  */
-interface ViewComponentsByType {
+interface ViewComponentsBySurface {
+  app: ViewComponent<WindowViewProps>;
   asset_source: AssetSourceViewComponents;
   panel: PanelViewComponents;
   tile: TileViewComponents;
 }
 /**
- * The result of `unstable_defineView`: the author's component(s), the view type,
+ * The result of `unstable_defineView`: the author's component(s), the view surface,
  * and the internal contract version the build artifact targets.
  * @public
  */
-interface DefinedView<TType extends InterfaceType = InterfaceType> {
-  readonly components: ViewComponentsByType[TType];
-  readonly type: TType;
+interface DefinedView<TSurface extends ViewSurface = ViewSurface> {
+  readonly components: ViewComponentsBySurface[TSurface];
+  readonly surface: TSurface;
   /** @internal */
   readonly version: typeof VIEW_CONTRACT_VERSION;
 }
@@ -144,11 +151,11 @@ interface DefinedView<TType extends InterfaceType = InterfaceType> {
  * and the props each component receives — `"panel"` yields a `{title, panel}`
  * record whose components are typed with the panel props.
  *
- * Returns the component(s) tagged with their type and the contract version, for
+ * Returns the component(s) tagged with their surface and contract version, for
  * the CLI build to generate render artifacts from. Used as the default export of
  * a view's `src` file.
  * @public
  */
-declare function unstable_defineView<TType extends InterfaceType>(type: TType, components: ViewComponentsByType[TType]): DefinedView<TType>;
-export { type AssetSourceComponent, type AssetSourceViewComponents, type DefineAppInput, type DefineAppResult, type DefineMediaLibraryInput, type DefinedService, type DefinedView, type DockGroup, type InterfaceType, type MediaLibraryField, type PanelComponent, type PanelViewComponents, type PanelViewProps, type ServiceCallback, type ServiceContext, type ServiceInfo, type ServiceType, type TileComponent, type TileSize, type TileViewComponents, type TileViewProps, type ViewComponentsByType, type WorkbenchApp, isWorkbenchApp, unstable_defineApp, unstable_defineMediaLibrary, unstable_defineService, unstable_defineView };
+declare function unstable_defineView<TSurface extends ViewSurface>(surface: TSurface, components: ViewComponentsBySurface[TSurface]): DefinedView<TSurface>;
+export { type AssetSourceComponent, type AssetSourceView, type AssetSourceViewComponents, type DefineAppInput, type DefineAppResult, type DefineAssetSourceViewInput, type DefineMediaLibraryInput, type DefinePanelViewInput, type DefineTileViewInput, type DefineWebWorkerInput, type DefineWindowViewInput, type DefinedService, type DefinedView, type DockGroup, type MediaLibraryField, type PanelComponent, type PanelView, type PanelViewComponents, type PanelViewProps, type ServiceCallback, type ServiceContext, type ServiceInfo, type ServiceType, type TileComponent, type TileSize, type TileView, type TileViewComponents, type TileViewProps, type ViewComponentsBySurface, type ViewDeclaration, type ViewSurface, type WebWorker, type WindowView, type WindowViewProps, type WorkbenchApp, type WorkbenchConfig, defineApplication, defineAssetSourceView, definePanelView, defineTileView, defineWebWorker, defineWindowView, isWorkbenchApp, isWorkbenchConfig, unstable_defineMediaLibrary, unstable_defineService, unstable_defineView };
 //# sourceMappingURL=index.d.ts.map

package/dist/_exports/index.js

@@ -1,4 +1,5 @@
-export { isWorkbenchApp, unstable_defineApp, unstable_defineMediaLibrary } from '../defineApp.js';
+export { defineAssetSourceView, definePanelView, defineTileView, defineWebWorker, defineWindowView } from '../contract.js';
+export { defineApplication, isWorkbenchApp, isWorkbenchConfig, 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, 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"}
+{"version":3,"sources":["../../src/_exports/index.ts"],"sourcesContent":["export type {\n  AssetSourceView,\n  DefineAssetSourceViewInput,\n  DefinePanelViewInput,\n  DefineTileViewInput,\n  DefineWebWorkerInput,\n  DefineWindowViewInput,\n  DockGroup,\n  PanelView,\n  ServiceType,\n  TileSize,\n  TileView,\n  ViewDeclaration,\n  ViewSurface,\n  WebWorker,\n  WindowView,\n} from '../contract.js'\nexport {\n  defineAssetSourceView,\n  definePanelView,\n  defineTileView,\n  defineWebWorker,\n  defineWindowView,\n} from '../contract.js'\nexport {\n  defineApplication,\n  isWorkbenchApp,\n  isWorkbenchConfig,\n  unstable_defineMediaLibrary,\n} from '../defineApp.js'\nexport type {\n  DefineAppInput,\n  DefineAppResult,\n  DefineMediaLibraryInput,\n  MediaLibraryField,\n  WorkbenchApp,\n  WorkbenchConfig,\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  ViewComponentsBySurface,\n  WindowViewProps,\n} from '../defineView.js'\n"],"names":["defineAssetSourceView","definePanelView","defineTileView","defineWebWorker","defineWindowView","defineApplication","isWorkbenchApp","isWorkbenchConfig","unstable_defineMediaLibrary","unstable_defineService","unstable_defineView"],"mappings":"AAiBA,SACEA,qBAAqB,EACrBC,eAAe,EACfC,cAAc,EACdC,eAAe,EACfC,gBAAgB,QACX,iBAAgB;AACvB,SACEC,iBAAiB,EACjBC,cAAc,EACdC,iBAAiB,EACjBC,2BAA2B,QACtB,kBAAiB;AASxB,SAAQC,sBAAsB,QAAO,sBAAqB;AAO1D,SAAQC,mBAAmB,QAAO,mBAAkB"}

package/dist/_exports/preview.d.ts

@@ -1,4 +1,4 @@
-import { t as DevServerManifest } from "./registry-DI7hnTof.js";
+import { t as DevServerManifest } from "./registry-HE_dEHFa.js";
 import { CliConfig, Output } from "@sanity/cli-core";
 interface StartWorkbenchPreviewOptions {
   /** Directory for the workbench Vite server's dependency cache. */