@sanity/workbench-cli 2.0.2 → 2.2.1

package/dist/actions/preview/startWorkbenchPreview.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/preview/startWorkbenchPreview.ts"],"sourcesContent":["import {readFile} from 'node:fs/promises'\nimport path from 'node:path'\nimport {styleText} from 'node:util'\n\nimport {type CliConfig, findProjectRoot, type Output} from '@sanity/cli-core'\n\nimport {buildAppId, SANITY_APP_ID_FILE} from '../../appId.js'\nimport {deriveInterfaces} from '../../deriveInterfaces.js'\nimport {resolveWorkbenchApp} from '../../resolveWorkbenchApp.js'\nimport {createServerLifecycle, toDisplayHost} from '../../util/serverOrchestration.js'\nimport {deriveConfigs} from '../dev/deriveConfigs.js'\nimport {type DevServerManifest, registerDevServer} from '../dev/registry.js'\nimport {startWorkbenchDevServer} from '../dev/startWorkbenchDevServer.js'\nimport {serveBuiltApplication} from './serveBuiltApplication.js'\n\nexport interface StartWorkbenchPreviewOptions {\n  /** Directory for the workbench Vite server's dependency cache. */\n  cacheDir: string\n  /** CLI-domain `app.id`/`deployment.appId` deprecation check, run before registering. */\n  checkForDeprecatedAppId: () => void\n  cliConfig: CliConfig\n  /** Extract the project manifest to inline into the registry (studio-vs-app handled by the CLI). */\n  extractManifest: (params: {\n    configPath: string\n    workDir: string\n  }) => Promise<DevServerManifest['manifest']>\n  httpHost: string\n  httpPort: number\n  isApp: boolean\n  /** The built `dist` directory to serve as the federation remote. */\n  outDir: string\n  output: Output\n  reactStrictMode: boolean\n  workDir: string\n}\n\n/**\n * `sanity start` for a workbench app: serve a production build the way dev serves\n * a live one. The same singleton workbench shell renders it and the same registry\n * advertises it — only the remote differs, static files from the build output\n * instead of a live Vite dev server. There's no config watcher or rebuild: a\n * build is fixed, so nothing re-syncs.\n *\n * A running workbench claims the configured port, so the built remote binds the\n * next one. Without one the remote takes the configured port and announces its\n * own URL.\n */\nexport async function startWorkbenchPreview(\n  options: StartWorkbenchPreviewOptions,\n): Promise<{close: () => Promise<void>}> {\n  const {\n    cacheDir,\n    checkForDeprecatedAppId,\n    cliConfig,\n    extractManifest,\n    httpHost,\n    httpPort,\n    isApp,\n    outDir,\n    output,\n    reactStrictMode,\n    workDir,\n  } = options\n\n  const {close, closers, installSignalHandlers} = createServerLifecycle()\n\n  const workbench = await startWorkbenchDevServer({\n    cacheDir,\n    cliConfig,\n    httpHost,\n    httpPort,\n    mode: 'preview',\n    output,\n    reactStrictMode,\n    workDir,\n  })\n  closers.push(workbench.close)\n\n  const remotePort = workbench.workbenchAvailable ? workbench.workbenchPort + 1 : httpPort\n\n  const remote = await serveBuiltApplication({\n    cacheDir,\n    httpHost,\n    httpPort: remotePort,\n    outDir,\n    workDir,\n  }).catch(async (err) => {\n    await close()\n    throw err\n  })\n  closers.push(remote.close)\n\n  try {\n    // Callers provide CLI-only validation and manifest extraction to keep them\n    // out of workbench-cli.\n    checkForDeprecatedAppId()\n    const configPath = (await findProjectRoot(workDir)).path\n    const workbench = resolveWorkbenchApp(cliConfig)\n\n    if (!workbench) throw new Error('`sanity start` was invoked in a non-workbench application')\n    const inlinedId = await readInlinedAppId(outDir)\n    const configs = await deriveConfigs(cliConfig.app)\n    const id = inlinedId ?? (await buildAppId(workbench))\n    const registration = registerDevServer({\n      configs,\n      host: remote.host,\n      id,\n      interfaces: deriveInterfaces(cliConfig.app, {isApp}),\n      manifest: await extractManifest({configPath, workDir}),\n      manifestUpdatedAt: new Date().toISOString(),\n      port: remote.port,\n      projectId: cliConfig?.api?.projectId,\n      type: isApp ? 'coreApp' : 'studio',\n      workDir,\n    })\n    closers.push(async () => registration.release())\n  } catch (err) {\n    await close()\n    throw err\n  }\n\n  if (workbench.workbenchAvailable) {\n    const workbenchUrl = `http://${toDisplayHost(workbench.httpHost)}:${workbench.workbenchPort}`\n    output.log(\n      `Workbench preview server started at ${styleText(['blue', 'underline'], workbenchUrl)} (serving build on port ${remote.port})`,\n    )\n  } else {\n    const remoteUrl = `http://${toDisplayHost(remote.host)}:${remote.port}`\n    output.log(`Serving build at ${styleText(['blue', 'underline'], remoteUrl)}`)\n  }\n\n  installSignalHandlers()\n\n  return {close}\n}\n\n/** The id the build inlined into its bundle, or undefined when absent. */\nasync function readInlinedAppId(outDir: string): Promise<string | undefined> {\n  try {\n    return (await readFile(path.join(outDir, SANITY_APP_ID_FILE), 'utf8')).trim() || undefined\n  } catch {\n    return undefined\n  }\n}\n"],"names":["readFile","path","styleText","findProjectRoot","buildAppId","SANITY_APP_ID_FILE","deriveInterfaces","resolveWorkbenchApp","createServerLifecycle","toDisplayHost","deriveConfigs","registerDevServer","startWorkbenchDevServer","serveBuiltApplication","startWorkbenchPreview","options","cacheDir","checkForDeprecatedAppId","cliConfig","extractManifest","httpHost","httpPort","isApp","outDir","output","reactStrictMode","workDir","close","closers","installSignalHandlers","workbench","mode","push","remotePort","workbenchAvailable","workbenchPort","remote","catch","err","configPath","Error","inlinedId","readInlinedAppId","configs","app","id","registration","host","interfaces","manifest","manifestUpdatedAt","Date","toISOString","port","projectId","api","type","release","workbenchUrl","log","remoteUrl","join","trim","undefined"],"mappings":"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"}
+{"version":3,"sources":["../../../src/actions/preview/startWorkbenchPreview.ts"],"sourcesContent":["import {readFile} from 'node:fs/promises'\nimport path from 'node:path'\nimport {styleText} from 'node:util'\n\nimport {type CliConfig, findProjectRoot, type Output} from '@sanity/cli-core'\n\nimport {buildAppId, SANITY_APP_ID_FILE} from '../../appId.js'\nimport {deriveInterfaces} from '../../deriveInterfaces.js'\nimport {resolveWorkbenchApp} from '../../resolveWorkbenchApp.js'\nimport {createServerLifecycle, toDisplayHost} from '../../util/serverOrchestration.js'\nimport {deriveConfigs} from '../dev/deriveConfigs.js'\nimport {type DevServerManifest, registerDevServer} from '../dev/registry.js'\nimport {startWorkbenchDevServer} from '../dev/startWorkbenchDevServer.js'\nimport {serveBuiltApplication} from './serveBuiltApplication.js'\n\nexport interface StartWorkbenchPreviewOptions {\n  /** Directory for the workbench Vite server's dependency cache. */\n  cacheDir: string\n  /** CLI-domain `app.id`/`deployment.appId` deprecation check, run before registering. */\n  checkForDeprecatedAppId: () => void\n  cliConfig: CliConfig\n  /** Extract the project manifest to inline into the registry (studio-vs-app handled by the CLI). */\n  extractManifest: (params: {\n    configPath: string\n    workDir: string\n  }) => Promise<DevServerManifest['manifest']>\n  httpHost: string\n  httpPort: number\n  isApp: boolean\n  /** The built `dist` directory to serve as the federation remote. */\n  outDir: string\n  output: Output\n  reactStrictMode: boolean\n  workDir: string\n}\n\n/**\n * `sanity start` for a workbench app: serve a production build the way dev serves\n * a live one. The same singleton workbench shell renders it and the same registry\n * advertises it — only the remote differs, static files from the build output\n * instead of a live Vite dev server. There's no config watcher or rebuild: a\n * build is fixed, so nothing re-syncs.\n *\n * A running workbench claims the configured port, so the built remote binds the\n * next one. Without one the remote takes the configured port and announces its\n * own URL.\n */\nexport async function startWorkbenchPreview(\n  options: StartWorkbenchPreviewOptions,\n): Promise<{close: () => Promise<void>}> {\n  const {\n    cacheDir,\n    checkForDeprecatedAppId,\n    cliConfig,\n    extractManifest,\n    httpHost,\n    httpPort,\n    isApp,\n    outDir,\n    output,\n    reactStrictMode,\n    workDir,\n  } = options\n\n  const {close, closers, installSignalHandlers} = createServerLifecycle()\n\n  const workbench = await startWorkbenchDevServer({\n    cacheDir,\n    cliConfig,\n    httpHost,\n    httpPort,\n    mode: 'preview',\n    output,\n    reactStrictMode,\n    workDir,\n  })\n  closers.push(workbench.close)\n\n  const remotePort = workbench.workbenchAvailable ? workbench.workbenchPort + 1 : httpPort\n\n  const remote = await serveBuiltApplication({\n    cacheDir,\n    httpHost,\n    httpPort: remotePort,\n    outDir,\n    workDir,\n  }).catch(async (err) => {\n    await close()\n    throw err\n  })\n  closers.push(remote.close)\n\n  try {\n    // Callers provide CLI-only validation and manifest extraction to keep them\n    // out of workbench-cli.\n    checkForDeprecatedAppId()\n    const configPath = (await findProjectRoot(workDir)).path\n    const workbench = resolveWorkbenchApp(cliConfig)\n\n    if (!workbench) throw new Error('`sanity start` was invoked in a non-workbench application')\n    const inlinedId = await readInlinedAppId(outDir)\n    const configs = await deriveConfigs(cliConfig)\n    const id = inlinedId ?? (await buildAppId(workbench))\n    const registration = registerDevServer({\n      configs,\n      host: remote.host,\n      id,\n      interfaces: deriveInterfaces(cliConfig.app, {isApp}),\n      manifest: await extractManifest({configPath, workDir}),\n      manifestUpdatedAt: new Date().toISOString(),\n      port: remote.port,\n      projectId: cliConfig?.api?.projectId,\n      type: isApp ? 'coreApp' : 'studio',\n      workDir,\n    })\n    closers.push(async () => registration.release())\n  } catch (err) {\n    await close()\n    throw err\n  }\n\n  if (workbench.workbenchAvailable) {\n    const workbenchUrl = `http://${toDisplayHost(workbench.httpHost)}:${workbench.workbenchPort}`\n    output.log(\n      `Workbench preview server started at ${styleText(['blue', 'underline'], workbenchUrl)} (serving build on port ${remote.port})`,\n    )\n  } else {\n    const remoteUrl = `http://${toDisplayHost(remote.host)}:${remote.port}`\n    output.log(`Serving build at ${styleText(['blue', 'underline'], remoteUrl)}`)\n  }\n\n  installSignalHandlers()\n\n  return {close}\n}\n\n/** The id the build inlined into its bundle, or undefined when absent. */\nasync function readInlinedAppId(outDir: string): Promise<string | undefined> {\n  try {\n    return (await readFile(path.join(outDir, SANITY_APP_ID_FILE), 'utf8')).trim() || undefined\n  } catch {\n    return undefined\n  }\n}\n"],"names":["readFile","path","styleText","findProjectRoot","buildAppId","SANITY_APP_ID_FILE","deriveInterfaces","resolveWorkbenchApp","createServerLifecycle","toDisplayHost","deriveConfigs","registerDevServer","startWorkbenchDevServer","serveBuiltApplication","startWorkbenchPreview","options","cacheDir","checkForDeprecatedAppId","cliConfig","extractManifest","httpHost","httpPort","isApp","outDir","output","reactStrictMode","workDir","close","closers","installSignalHandlers","workbench","mode","push","remotePort","workbenchAvailable","workbenchPort","remote","catch","err","configPath","Error","inlinedId","readInlinedAppId","configs","id","registration","host","interfaces","app","manifest","manifestUpdatedAt","Date","toISOString","port","projectId","api","type","release","workbenchUrl","log","remoteUrl","join","trim","undefined"],"mappings":"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"}

package/dist/actions/undeploy/workbenchUndeployAdapter.js

@@ -3,29 +3,29 @@ import { deleteConfig, listConfigs } from '../../services/installations.js';
 import { resolveInstallationId, summarizeConfig } from '../deploy/deployConfig.js';
 import { summarizeInterfaces } from '../deploy/summarizeInterfaces.js';
 /**
- * The undeploy adapter for workbench apps, mirroring what a workbench deploy
- * creates: apps that expose interfaces delete their Brett application (the
- * server soft-deletes its deployments and refuses singletons with active
- * installations); a singleton without interfaces — the media library — deletes
- * its installation's config snapshots instead.
+ * The undeploy adapter for workbench apps and configs, mirroring what a
+ * workbench deploy creates: an app that exposes interfaces deletes its Brett
+ * application (the server soft-deletes its deployments and refuses singletons
+ * with active installations); a config — the media library — deletes its
+ * installation's config snapshots instead. The two are severed at the source,
+ * so exactly one of `workbench`/`config` is supplied and the brand decides the path.
  */ export function createWorkbenchUndeployAdapter(options) {
-    const { appId, organizationId, type, workbench } = options;
-    // Keyed on singleton-ness, not on a locally declared config, so an undeploy
-    // still reaches the server's config snapshots after the fields are removed
-    // from sanity.cli.ts.
-    const configOnly = !!workbench.isSingleton && !workbench.hasInterfaces;
+    const { appId, config, organizationId, type, workbench } = options;
     // Workbench-internal, so kept off the reported target; resolveTarget stashes it for the delete.
     let installationId;
     return {
         resolveTarget: async ()=>{
-            if (!configOnly) return resolveApplicationTarget({
-                appId,
-                type,
-                workbench
-            });
+            if (!config) {
+                if (!workbench) throw new Error('No workbench app or config to undeploy');
+                return resolveApplicationTarget({
+                    appId,
+                    type,
+                    workbench
+                });
+            }
             const resolved = await resolveConfigTarget({
-                organizationId,
-                workbench
+                config,
+                organizationId
             });
             installationId = resolved.installationId;
             return resolved.resolution;
@@ -71,12 +71,7 @@ async function resolveApplicationTarget({ appId, type, workbench }) {
                 views
             },
             services,
-            summary: [
-                ...lines,
-                ...workbench.isSingleton === undefined ? [] : [
-                    `Singleton: ${workbench.isSingleton}`
-                ]
-            ],
+            summary: lines,
             title: application.title,
             type,
             url: getApplicationUrl({
@@ -88,10 +83,8 @@ async function resolveApplicationTarget({ appId, type, workbench }) {
         type: 'found'
     };
 }
-async function resolveConfigTarget({ organizationId, workbench }) {
-    const config = workbench.config;
-    const appType = config?.appType ?? workbench.applicationType;
-    if (!appType) throw new Error('The app declares no app type to resolve its installation');
+async function resolveConfigTarget({ config, organizationId }) {
+    const { appType } = config;
     if (!organizationId) {
         throw new Error('sanity.cli.ts does not contain an organization identifier ("app.organizationId"), which is required to resolve the installation');
     }
@@ -126,15 +119,13 @@ async function resolveConfigTarget({ organizationId, workbench }) {
                 id: null,
                 payload: {
                     appId: null,
-                    ...config ? {
-                        config: summarizeConfig(config)
-                    } : {},
+                    config: summarizeConfig(config),
                     type: 'coreApp'
                 },
-                summary: config ? [
+                summary: [
                     summarizeConfig(config)
-                ] : [],
-                title: workbench.slug,
+                ],
+                title: appType,
                 type: 'coreApp',
                 url: getWorkbenchUrl(organizationId)
             },

package/dist/actions/undeploy/workbenchUndeployAdapter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/undeploy/workbenchUndeployAdapter.ts"],"sourcesContent":["import {\n  type UndeployAdapter,\n  type UndeployApplicationTarget,\n  type UndeployConfigTarget,\n  type UndeployTargetResolution,\n} from '@sanity/cli-core/undeploy'\n\nimport {\n  deleteApplication,\n  getApplication,\n  getApplicationUrl,\n  getWorkbenchUrl,\n} from '../../services/applications.js'\nimport {type ConfigSnapshot, deleteConfig, listConfigs} from '../../services/installations.js'\nimport {resolveInstallationId, summarizeConfig} from '../deploy/deployConfig.js'\nimport {type DeployableWorkbenchApp} from '../deploy/getWorkbench.js'\nimport {type DeployedInterface, summarizeInterfaces} from '../deploy/summarizeInterfaces.js'\n\n/** The workbench extension of the shared target; serializes into `--json` as-is. */\nexport type WorkbenchUndeployTarget =\n  | (UndeployApplicationTarget & {\n      services: DeployedInterface[]\n      views: DeployedInterface[]\n    })\n  | (UndeployConfigTarget & {\n      configs: ConfigSnapshot[]\n    })\n\n/**\n * The undeploy adapter for workbench apps, mirroring what a workbench deploy\n * creates: apps that expose interfaces delete their Brett application (the\n * server soft-deletes its deployments and refuses singletons with active\n * installations); a singleton without interfaces — the media library — deletes\n * its installation's config snapshots instead.\n */\nexport function createWorkbenchUndeployAdapter(options: {\n  appId: string | undefined\n  organizationId: string | undefined\n  type: 'coreApp' | 'studio'\n  workbench: DeployableWorkbenchApp\n}): UndeployAdapter<WorkbenchUndeployTarget> {\n  const {appId, organizationId, type, workbench} = options\n  // Keyed on singleton-ness, not on a locally declared config, so an undeploy\n  // still reaches the server's config snapshots after the fields are removed\n  // from sanity.cli.ts.\n  const configOnly = !!workbench.isSingleton && !workbench.hasInterfaces\n  // Workbench-internal, so kept off the reported target; resolveTarget stashes it for the delete.\n  let installationId: string | undefined\n\n  return {\n    resolveTarget: async () => {\n      if (!configOnly) return resolveApplicationTarget({appId, type, workbench})\n      const resolved = await resolveConfigTarget({organizationId, workbench})\n      installationId = resolved.installationId\n      return resolved.resolution\n    },\n    type,\n    async undeploy(target) {\n      if (target.deletes === 'config') {\n        if (!installationId) throw new Error('No installation resolved for the config undeploy')\n        for (const snapshot of target.configs) {\n          await deleteConfig(installationId, snapshot.id)\n        }\n        return\n      }\n      await deleteApplication(target.id)\n    },\n  }\n}\n\nasync function resolveApplicationTarget({\n  appId,\n  type,\n  workbench,\n}: {\n  appId: string | undefined\n  type: 'coreApp' | 'studio'\n  workbench: DeployableWorkbenchApp\n}): Promise<UndeployTargetResolution<WorkbenchUndeployTarget>> {\n  if (!appId) {\n    return {\n      message: 'No `deployment.appId` configured',\n      solution: 'Add `deployment.appId` to sanity.cli.ts',\n      type: 'none',\n    }\n  }\n\n  const application = await getApplication(appId)\n  if (!application) {\n    return {message: 'Application with the given ID does not exist', type: 'none'}\n  }\n\n  const {lines, services, views} = summarizeInterfaces(workbench)\n  return {\n    target: {\n      application,\n      deletes: 'application',\n      id: application.id,\n      payload: {appId: application.id, services, type, views},\n      services,\n      summary: [\n        ...lines,\n        ...(workbench.isSingleton === undefined ? [] : [`Singleton: ${workbench.isSingleton}`]),\n      ],\n      title: application.title,\n      type,\n      url: getApplicationUrl({...application, type}),\n      views,\n    },\n    type: 'found',\n  }\n}\n\nasync function resolveConfigTarget({\n  organizationId,\n  workbench,\n}: {\n  organizationId: string | undefined\n  workbench: DeployableWorkbenchApp\n}): Promise<{\n  installationId?: string\n  resolution: UndeployTargetResolution<WorkbenchUndeployTarget>\n}> {\n  const config = workbench.config\n  const appType = config?.appType ?? workbench.applicationType\n  if (!appType) throw new Error('The app declares no app type to resolve its installation')\n  if (!organizationId) {\n    throw new Error(\n      'sanity.cli.ts does not contain an organization identifier (\"app.organizationId\"), which is required to resolve the installation',\n    )\n  }\n\n  const installationId = await resolveInstallationId({appType, organizationId})\n  if (!installationId) {\n    return {\n      resolution: {\n        message: `No active \"${appType}\" installation for organization \"${organizationId}\"`,\n        type: 'none',\n      },\n    }\n  }\n\n  const configs = await listConfigs(installationId)\n  if (configs.length === 0) {\n    return {\n      installationId,\n      resolution: {\n        message: `No deployed config for the \"${appType}\" installation`,\n        type: 'none',\n      },\n    }\n  }\n\n  return {\n    installationId,\n    resolution: {\n      target: {\n        configs,\n        deletes: 'config',\n        id: null,\n        payload: {\n          appId: null,\n          ...(config ? {config: summarizeConfig(config)} : {}),\n          type: 'coreApp',\n        },\n        summary: config ? [summarizeConfig(config)] : [],\n        title: workbench.slug,\n        type: 'coreApp',\n        url: getWorkbenchUrl(organizationId),\n      },\n      type: 'found',\n    },\n  }\n}\n"],"names":["deleteApplication","getApplication","getApplicationUrl","getWorkbenchUrl","deleteConfig","listConfigs","resolveInstallationId","summarizeConfig","summarizeInterfaces","createWorkbenchUndeployAdapter","options","appId","organizationId","type","workbench","configOnly","isSingleton","hasInterfaces","installationId","resolveTarget","resolveApplicationTarget","resolved","resolveConfigTarget","resolution","undeploy","target","deletes","Error","snapshot","configs","id","message","solution","application","lines","services","views","payload","summary","undefined","title","url","config","appType","applicationType","length","slug"],"mappings":"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"}
+{"version":3,"sources":["../../../src/actions/undeploy/workbenchUndeployAdapter.ts"],"sourcesContent":["import {\n  type UndeployAdapter,\n  type UndeployApplicationTarget,\n  type UndeployConfigTarget,\n  type UndeployTargetResolution,\n} from '@sanity/cli-core/undeploy'\n\nimport {type ResolvedMediaLibraryConfig} from '../../resolveWorkbenchConfig.js'\nimport {\n  deleteApplication,\n  getApplication,\n  getApplicationUrl,\n  getWorkbenchUrl,\n} from '../../services/applications.js'\nimport {type ConfigSnapshot, deleteConfig, listConfigs} from '../../services/installations.js'\nimport {resolveInstallationId, summarizeConfig} from '../deploy/deployConfig.js'\nimport {type DeployableWorkbenchApp} from '../deploy/getWorkbench.js'\nimport {\n  type DeployedView,\n  type DeployedWebWorker,\n  summarizeInterfaces,\n} from '../deploy/summarizeInterfaces.js'\n\n/** The workbench extension of the shared target; serializes into `--json` as-is. */\nexport type WorkbenchUndeployTarget =\n  | (UndeployApplicationTarget & {\n      services: DeployedWebWorker[]\n      views: DeployedView[]\n    })\n  | (UndeployConfigTarget & {\n      configs: ConfigSnapshot[]\n    })\n\n/**\n * The undeploy adapter for workbench apps and configs, mirroring what a\n * workbench deploy creates: an app that exposes interfaces deletes its Brett\n * application (the server soft-deletes its deployments and refuses singletons\n * with active installations); a config — the media library — deletes its\n * installation's config snapshots instead. The two are severed at the source,\n * so exactly one of `workbench`/`config` is supplied and the brand decides the path.\n */\nexport function createWorkbenchUndeployAdapter(options: {\n  appId: string | undefined\n  config?: ResolvedMediaLibraryConfig\n  organizationId: string | undefined\n  type: 'coreApp' | 'studio'\n  workbench?: DeployableWorkbenchApp\n}): UndeployAdapter<WorkbenchUndeployTarget> {\n  const {appId, config, organizationId, type, workbench} = options\n  // Workbench-internal, so kept off the reported target; resolveTarget stashes it for the delete.\n  let installationId: string | undefined\n\n  return {\n    resolveTarget: async () => {\n      if (!config) {\n        if (!workbench) throw new Error('No workbench app or config to undeploy')\n        return resolveApplicationTarget({appId, type, workbench})\n      }\n      const resolved = await resolveConfigTarget({config, organizationId})\n      installationId = resolved.installationId\n      return resolved.resolution\n    },\n    type,\n    async undeploy(target) {\n      if (target.deletes === 'config') {\n        if (!installationId) throw new Error('No installation resolved for the config undeploy')\n        for (const snapshot of target.configs) {\n          await deleteConfig(installationId, snapshot.id)\n        }\n        return\n      }\n      await deleteApplication(target.id)\n    },\n  }\n}\n\nasync function resolveApplicationTarget({\n  appId,\n  type,\n  workbench,\n}: {\n  appId: string | undefined\n  type: 'coreApp' | 'studio'\n  workbench: DeployableWorkbenchApp\n}): Promise<UndeployTargetResolution<WorkbenchUndeployTarget>> {\n  if (!appId) {\n    return {\n      message: 'No `deployment.appId` configured',\n      solution: 'Add `deployment.appId` to sanity.cli.ts',\n      type: 'none',\n    }\n  }\n\n  const application = await getApplication(appId)\n  if (!application) {\n    return {message: 'Application with the given ID does not exist', type: 'none'}\n  }\n\n  const {lines, services, views} = summarizeInterfaces(workbench)\n  return {\n    target: {\n      application,\n      deletes: 'application',\n      id: application.id,\n      payload: {appId: application.id, services, type, views},\n      services,\n      summary: lines,\n      title: application.title,\n      type,\n      url: getApplicationUrl({...application, type}),\n      views,\n    },\n    type: 'found',\n  }\n}\n\nasync function resolveConfigTarget({\n  config,\n  organizationId,\n}: {\n  config: ResolvedMediaLibraryConfig\n  organizationId: string | undefined\n}): Promise<{\n  installationId?: string\n  resolution: UndeployTargetResolution<WorkbenchUndeployTarget>\n}> {\n  const {appType} = config\n  if (!organizationId) {\n    throw new Error(\n      'sanity.cli.ts does not contain an organization identifier (\"app.organizationId\"), which is required to resolve the installation',\n    )\n  }\n\n  const installationId = await resolveInstallationId({appType, organizationId})\n  if (!installationId) {\n    return {\n      resolution: {\n        message: `No active \"${appType}\" installation for organization \"${organizationId}\"`,\n        type: 'none',\n      },\n    }\n  }\n\n  const configs = await listConfigs(installationId)\n  if (configs.length === 0) {\n    return {\n      installationId,\n      resolution: {\n        message: `No deployed config for the \"${appType}\" installation`,\n        type: 'none',\n      },\n    }\n  }\n\n  return {\n    installationId,\n    resolution: {\n      target: {\n        configs,\n        deletes: 'config',\n        id: null,\n        payload: {\n          appId: null,\n          config: summarizeConfig(config),\n          type: 'coreApp',\n        },\n        summary: [summarizeConfig(config)],\n        title: appType,\n        type: 'coreApp',\n        url: getWorkbenchUrl(organizationId),\n      },\n      type: 'found',\n    },\n  }\n}\n"],"names":["deleteApplication","getApplication","getApplicationUrl","getWorkbenchUrl","deleteConfig","listConfigs","resolveInstallationId","summarizeConfig","summarizeInterfaces","createWorkbenchUndeployAdapter","options","appId","config","organizationId","type","workbench","installationId","resolveTarget","Error","resolveApplicationTarget","resolved","resolveConfigTarget","resolution","undeploy","target","deletes","snapshot","configs","id","message","solution","application","lines","services","views","payload","summary","title","url","appType","length"],"mappings":"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"}

package/dist/appId.js

@@ -9,18 +9,22 @@
  * advertised by `sanity start` resolve to the same id. `sanity deploy` resolves
  * its own id from the applications API.
  */ export async function buildAppId(app) {
-    const canonical = (interfaces)=>(interfaces ?? []).map((i)=>[
-                i.type,
-                i.name,
-                i.src
-            ]).toSorted();
     const shape = JSON.stringify({
-        config: app.config ?? null,
         entry: app.entry ?? null,
+        // Identity, not address: the id keys on `name` (which defaults to `slug`). The
+        // address (`slug`) is deliberately absent, so renaming it never shifts the id.
+        name: app.name,
         organizationId: app.organizationId,
-        services: canonical(app.services),
-        slug: app.slug,
-        views: canonical(app.views)
+        services: app.webWorkers.map((webWorker)=>[
+                webWorker.type,
+                webWorker.name,
+                webWorker.src
+            ]).toSorted(),
+        views: app.views.map((view)=>[
+                view.surface,
+                view.name,
+                view.src
+            ]).toSorted()
     });
     // eslint-disable-next-line n/no-unsupported-features/node-builtins -- the Web Crypto global is available on our Node target and in the browser
     const digest = await globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(shape));

package/dist/appId.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/appId.ts"],"sourcesContent":["import {type ResolvedWorkbenchApp} from './resolveWorkbenchApp.js'\n\n/**\n * File the build writes into its output, carrying the id compiled into the\n * bundle. `sanity start` serves a build without recompiling, so it reads this\n * instead of recomputing — a deploy inlines the API id, not the shape hash.\n */\nexport const SANITY_APP_ID_FILE = 'sanity-app-id.txt'\n\n/**\n * The `build`/`start` id — a hash of the app's declared shape (its identity, not\n * its code), so the bundle inlined by `sanity build` and the registry entry\n * advertised by `sanity start` resolve to the same id. `sanity deploy` resolves\n * its own id from the applications API.\n */\nexport async function buildAppId(app: ResolvedWorkbenchApp): Promise<string> {\n  const canonical = (\n    interfaces: ReadonlyArray<{name: string; src: string; type: string}> | undefined,\n  ): Array<[string, string, string]> =>\n    (interfaces ?? []).map((i): [string, string, string] => [i.type, i.name, i.src]).toSorted()\n  const shape = JSON.stringify({\n    config: app.config ?? null,\n    entry: app.entry ?? null,\n    organizationId: app.organizationId,\n    services: canonical(app.services),\n    slug: app.slug,\n    views: canonical(app.views),\n  })\n  // eslint-disable-next-line n/no-unsupported-features/node-builtins -- the Web Crypto global is available on our Node target and in the browser\n  const digest = await globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(shape))\n  return Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, '0')).join('')\n}\n"],"names":["SANITY_APP_ID_FILE","buildAppId","app","canonical","interfaces","map","i","type","name","src","toSorted","shape","JSON","stringify","config","entry","organizationId","services","slug","views","digest","globalThis","crypto","subtle","TextEncoder","encode","Array","from","Uint8Array","byte","toString","padStart","join"],"mappings":"AAEA;;;;CAIC,GACD,OAAO,MAAMA,qBAAqB,oBAAmB;AAErD;;;;;CAKC,GACD,OAAO,eAAeC,WAAWC,GAAyB;IACxD,MAAMC,YAAY,CAChBC,aAEA,AAACA,CAAAA,cAAc,EAAE,AAAD,EAAGC,GAAG,CAAC,CAACC,IAAgC;gBAACA,EAAEC,IAAI;gBAAED,EAAEE,IAAI;gBAAEF,EAAEG,GAAG;aAAC,EAAEC,QAAQ;IAC3F,MAAMC,QAAQC,KAAKC,SAAS,CAAC;QAC3BC,QAAQZ,IAAIY,MAAM,IAAI;QACtBC,OAAOb,IAAIa,KAAK,IAAI;QACpBC,gBAAgBd,IAAIc,cAAc;QAClCC,UAAUd,UAAUD,IAAIe,QAAQ;QAChCC,MAAMhB,IAAIgB,IAAI;QACdC,OAAOhB,UAAUD,IAAIiB,KAAK;IAC5B;IACA,+IAA+I;IAC/I,MAAMC,SAAS,MAAMC,WAAWC,MAAM,CAACC,MAAM,CAACH,MAAM,CAAC,WAAW,IAAII,cAAcC,MAAM,CAACd;IACzF,OAAOe,MAAMC,IAAI,CAAC,IAAIC,WAAWR,SAAS,CAACS,OAASA,KAAKC,QAAQ,CAAC,IAAIC,QAAQ,CAAC,GAAG,MAAMC,IAAI,CAAC;AAC/F"}
+{"version":3,"sources":["../src/appId.ts"],"sourcesContent":["import {type ResolvedWorkbenchApp} from './resolveWorkbenchApp.js'\n\n/**\n * File the build writes into its output, carrying the id compiled into the\n * bundle. `sanity start` serves a build without recompiling, so it reads this\n * instead of recomputing — a deploy inlines the API id, not the shape hash.\n */\nexport const SANITY_APP_ID_FILE = 'sanity-app-id.txt'\n\n/**\n * The `build`/`start` id — a hash of the app's declared shape (its identity, not\n * its code), so the bundle inlined by `sanity build` and the registry entry\n * advertised by `sanity start` resolve to the same id. `sanity deploy` resolves\n * its own id from the applications API.\n */\nexport async function buildAppId(app: ResolvedWorkbenchApp): Promise<string> {\n  const shape = JSON.stringify({\n    entry: app.entry ?? null,\n    // Identity, not address: the id keys on `name` (which defaults to `slug`). The\n    // address (`slug`) is deliberately absent, so renaming it never shifts the id.\n    name: app.name,\n    organizationId: app.organizationId,\n    services: app.webWorkers\n      .map((webWorker): [string, string, string] => [webWorker.type, webWorker.name, webWorker.src])\n      .toSorted(),\n    views: app.views\n      .map((view): [string, string, string] => [view.surface, view.name, view.src])\n      .toSorted(),\n  })\n  // eslint-disable-next-line n/no-unsupported-features/node-builtins -- the Web Crypto global is available on our Node target and in the browser\n  const digest = await globalThis.crypto.subtle.digest('SHA-256', new TextEncoder().encode(shape))\n  return Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, '0')).join('')\n}\n"],"names":["SANITY_APP_ID_FILE","buildAppId","app","shape","JSON","stringify","entry","name","organizationId","services","webWorkers","map","webWorker","type","src","toSorted","views","view","surface","digest","globalThis","crypto","subtle","TextEncoder","encode","Array","from","Uint8Array","byte","toString","padStart","join"],"mappings":"AAEA;;;;CAIC,GACD,OAAO,MAAMA,qBAAqB,oBAAmB;AAErD;;;;;CAKC,GACD,OAAO,eAAeC,WAAWC,GAAyB;IACxD,MAAMC,QAAQC,KAAKC,SAAS,CAAC;QAC3BC,OAAOJ,IAAII,KAAK,IAAI;QACpB,+EAA+E;QAC/E,+EAA+E;QAC/EC,MAAML,IAAIK,IAAI;QACdC,gBAAgBN,IAAIM,cAAc;QAClCC,UAAUP,IAAIQ,UAAU,CACrBC,GAAG,CAAC,CAACC,YAAwC;gBAACA,UAAUC,IAAI;gBAAED,UAAUL,IAAI;gBAAEK,UAAUE,GAAG;aAAC,EAC5FC,QAAQ;QACXC,OAAOd,IAAIc,KAAK,CACbL,GAAG,CAAC,CAACM,OAAmC;gBAACA,KAAKC,OAAO;gBAAED,KAAKV,IAAI;gBAAEU,KAAKH,GAAG;aAAC,EAC3EC,QAAQ;IACb;IACA,+IAA+I;IAC/I,MAAMI,SAAS,MAAMC,WAAWC,MAAM,CAACC,MAAM,CAACH,MAAM,CAAC,WAAW,IAAII,cAAcC,MAAM,CAACrB;IACzF,OAAOsB,MAAMC,IAAI,CAAC,IAAIC,WAAWR,SAAS,CAACS,OAASA,KAAKC,QAAQ,CAAC,IAAIC,QAAQ,CAAC,GAAG,MAAMC,IAAI,CAAC;AAC/F"}

package/dist/applicationReference.js

@@ -0,0 +1,12 @@
+/**
+ * The qualified, globally-unique handle for an application: `sanity/<name>` for
+ * singletons (always Sanity-owned), `<organizationId>/<name>` otherwise. Mirrors
+ * brett's server-side composition so a locally served app carries the same
+ * reference the deployed one would — the CLI is the authority for local apps,
+ * which never reach brett.
+ * @public
+ */ export function applicationReference(app) {
+    return `${app.isSingleton ? 'sanity' : app.organizationId}/${app.name}`;
+}
+
+//# sourceMappingURL=applicationReference.js.map

package/dist/applicationReference.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/applicationReference.ts"],"sourcesContent":["/**\n * The qualified, globally-unique handle for an application: `sanity/<name>` for\n * singletons (always Sanity-owned), `<organizationId>/<name>` otherwise. Mirrors\n * brett's server-side composition so a locally served app carries the same\n * reference the deployed one would — the CLI is the authority for local apps,\n * which never reach brett.\n * @public\n */\nexport function applicationReference(app: {\n  isSingleton: boolean\n  name: string\n  organizationId: string\n}): string {\n  return `${app.isSingleton ? 'sanity' : app.organizationId}/${app.name}`\n}\n"],"names":["applicationReference","app","isSingleton","organizationId","name"],"mappings":"AAAA;;;;;;;CAOC,GACD,OAAO,SAASA,qBAAqBC,GAIpC;IACC,OAAO,GAAGA,IAAIC,WAAW,GAAG,WAAWD,IAAIE,cAAc,CAAC,CAAC,EAAEF,IAAIG,IAAI,EAAE;AACzE"}

package/dist/contract.js

@@ -5,11 +5,8 @@ import { z } from 'zod/mini';
 /** @internal */ export const VIEW_CONTRACT_VERSION = 1;
 /** @internal */ export const SERVICE_CONTRACT_VERSION = 1;
 /** @internal */ export const MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION = 1;
-/**
- * Component slots each interface type exposes, in render order. Source of truth
- * for {@link InterfaceType} and the build; add a type by registering it here.
- * @internal
- */ export const VIEW_COMPONENTS = {
+/** Component slots per view surface; windows load outside the component artifact path. @internal */ export const VIEW_COMPONENTS = {
+    app: [],
     asset_source: [
         'asset_source'
     ],
@@ -32,22 +29,25 @@ import { z } from 'zod/mini';
     'large',
     'banner'
 ]);
-/**
- * The `app` interface's dock-placement metadata. Interface metadata is
- * discriminated on `type`; `app` is the only type with a shape so far.
- * @internal
- */ export const AppInterfaceMetadataSchema = z.object({
-    group: z.optional(z.string()),
-    priority: z.optional(z.number())
+const DockGroupSchema = z.enum([
+    'dock.system',
+    'dock.applications',
+    'dock.user'
+]);
+/** @internal */ export const DockSchema = z.object({
+    group: z.optional(DockGroupSchema),
+    order: z.optional(z.number())
+});
+/** @internal */ export const ViewPlacementMetadataSchema = z.object({
+    dock: DockSchema
 });
 /**
- * A tile's interface metadata: its footprint `size` and an optional `priority`
+ * A tile's interface metadata: its footprint `size` and an optional `order`
  * the dashboard sorts on, ascending. Both are authored as top-level view fields
  * (see {@link InterfaceDeclarationSchema}) but stored on the record as metadata.
- * Mirrors `app`'s dock metadata; tile is the first view type to carry any.
  * @internal
  */ export const TileInterfaceMetadataSchema = z.object({
-    priority: z.optional(z.number()),
+    order: z.optional(z.number()),
     size: TileSizeSchema
 });
 /**
@@ -61,16 +61,16 @@ import { z } from 'zod/mini';
     tile: VIEW_CONTRACT_VERSION,
     worker: SERVICE_CONTRACT_VERSION
 };
-/** @internal */ export function interfaceContractVersion(type) {
-    const version = INTERFACE_CONTRACT_VERSIONS[type];
+/** @internal */ export function interfaceContractVersion(kind) {
+    const version = INTERFACE_CONTRACT_VERSIONS[kind];
     return version === undefined ? undefined : String(version);
 }
 /**
  * The module-federation id a build exposes an interface at. Dev stamps the same
  * id a deploy would, so the workbench loads a local interface like a deployed one.
  * @internal
- */ export function interfaceModuleId(type, name) {
-    switch(type){
+ */ export function interfaceModuleId(kind, name) {
+    switch(kind){
         case 'app':
             {
                 return 'App';
@@ -87,7 +87,7 @@ import { z } from 'zod/mini';
             }
         default:
             {
-                throw new Error(`Cannot derive a moduleId for unknown interface type: ${type}`);
+                throw new Error(`Cannot derive a moduleId for unknown interface kind: ${kind}`);
             }
     }
 }
@@ -99,7 +99,7 @@ function extensionDeclarationFields(kind) {
         src: z.string()
     };
 }
-// Every interface (view, service) shares `name` + `src` + a display `title`,
+// Every interface shares `name` + `src` + a display `title`,
 // which Brett requires on the record each becomes.
 function interfaceDeclarationFields(kind) {
     return {
@@ -108,30 +108,67 @@ function interfaceDeclarationFields(kind) {
     };
 }
 const PanelViewSchema = z.object({
-    type: z.literal('panel'),
-    ...interfaceDeclarationFields('View')
+    surface: z.literal('panel'),
+    ...interfaceDeclarationFields('View'),
+    dock: z.optional(DockSchema)
+});
+/** @public */ export function definePanelView(view) {
+    return {
+        ...view,
+        surface: 'panel'
+    };
+}
+const WindowViewSchema = z.object({
+    surface: z.literal('app'),
+    ...interfaceDeclarationFields('View'),
+    dock: z.optional(DockSchema)
 });
+/** @public */ export function defineWindowView(view) {
+    return {
+        ...view,
+        surface: 'app'
+    };
+}
 const AssetSourceViewSchema = z.object({
-    type: z.literal('asset_source'),
+    surface: z.literal('asset_source'),
     ...interfaceDeclarationFields('View')
 });
+/** @public */ export function defineAssetSourceView(view) {
+    return {
+        ...view,
+        surface: 'asset_source'
+    };
+}
 const TileViewSchema = z.object({
-    type: z.literal('tile'),
+    surface: z.literal('tile'),
     ...interfaceDeclarationFields('View'),
-    /** Sort position within its layout track, ascending. Optional. */ priority: z.optional(z.number()),
+    /** Sort position within its layout track, ascending. Optional. */ order: z.optional(z.number()),
     /** Footprint family the dashboard lays the tile out by. */ size: TileSizeSchema
 });
-/** @internal */ export const InterfaceDeclarationSchema = z.discriminatedUnion('type', [
+/** @public */ export function defineTileView(view) {
+    return {
+        ...view,
+        surface: 'tile'
+    };
+}
+/** @internal */ export const InterfaceDeclarationSchema = z.discriminatedUnion('surface', [
+    WindowViewSchema,
     PanelViewSchema,
     AssetSourceViewSchema,
     TileViewSchema
 ]);
-const WorkerServiceSchema = z.object({
+const WebWorkerSchema = z.object({
     type: z.literal('worker'),
-    ...interfaceDeclarationFields('Service')
+    ...interfaceDeclarationFields('Web worker')
 });
+/** @public */ export function defineWebWorker(webWorker) {
+    return {
+        ...webWorker,
+        type: 'worker'
+    };
+}
 /** @internal */ export const ServiceDeclarationSchema = z.discriminatedUnion('type', [
-    WorkerServiceSchema
+    WebWorkerSchema
 ]);
 const MediaLibraryFieldSchema = z.object({
     ...extensionDeclarationFields('Field'),
@@ -148,7 +185,8 @@ const MediaLibraryConfigSchema = z.object({
     fields: z.array(MediaLibraryFieldSchema).check(z.refine((fields)=>new Set(fields.map((field)=>field.name)).size === fields.length, 'Field `name` must be unique within a media library'))
 });
 /**
- * An app's optional config, keyed by `appType`; deploys as a versioned snapshot, not an interface.
+ * A workbench config's built value, keyed by `appType`; deploys as a versioned
+ * snapshot, not an interface.
  * @internal
  */ export const ConfigSchema = z.discriminatedUnion('appType', [
     MediaLibraryConfigSchema

package/dist/contract.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/contract.ts"],"sourcesContent":["import {z} from 'zod/mini'\n\n// Shared module-federation extension contract: interface (view/service) and\n// config declaration schemas, plus the versions the build stamps.\n// `zod/mini` keeps the bundle small.\n\n/** @internal */\nexport const VIEW_CONTRACT_VERSION = 1\n\n/** @internal */\nexport const SERVICE_CONTRACT_VERSION = 1\n\n/** @internal */\nexport const MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION = 1\n\n/**\n * A view component. The return is opaque so the runtime helpers carry no React\n * dependency — the generated artifact renders it with the app's own React.\n * @public\n */\nexport type ViewComponent<TProps> = (props: TProps) => unknown\n\n/** @public */\nexport interface ViewComponentBaseProps<TView> {\n  view: TView\n}\n\n/**\n * Component slots each interface type exposes, in render order. Source of truth\n * for {@link InterfaceType} and the build; add a type by registering it here.\n * @internal\n */\nexport const VIEW_COMPONENTS = {\n  asset_source: ['asset_source'],\n  panel: ['title', 'panel'],\n  tile: ['tile'],\n} as const satisfies Record<string, readonly string[]>\n\n/** @public */\nexport type InterfaceType = keyof typeof VIEW_COMPONENTS\n\n/**\n * A tile's footprint family — the shape it occupies on the dashboard. Modelled\n * on iOS WidgetKit families, not a linear scale: `banner` is full-width and\n * shallow, which a `small`→`large` magnitude can't express. The host maps a\n * family to a layout slot; the component reads it to render per footprint.\n * @public\n */\nexport const TileSizeSchema = z.enum(['small', 'large', 'banner'])\n\n/** @public */\nexport type TileSize = z.infer<typeof TileSizeSchema>\n\n/** @public */\nexport type ServiceType = 'worker'\n\n/**\n * The `app` interface's dock-placement metadata. Interface metadata is\n * discriminated on `type`; `app` is the only type with a shape so far.\n * @internal\n */\nexport const AppInterfaceMetadataSchema = z.object({\n  group: z.optional(z.string()),\n  priority: z.optional(z.number()),\n})\n\n/** @internal */\nexport type AppInterfaceMetadata = z.infer<typeof AppInterfaceMetadataSchema>\n\n/**\n * A tile's interface metadata: its footprint `size` and an optional `priority`\n * the dashboard sorts on, ascending. Both are authored as top-level view fields\n * (see {@link InterfaceDeclarationSchema}) but stored on the record as metadata.\n * Mirrors `app`'s dock metadata; tile is the first view type to carry any.\n * @internal\n */\nexport const TileInterfaceMetadataSchema = z.object({\n  priority: z.optional(z.number()),\n  size: TileSizeSchema,\n})\n\n/** @internal */\nexport type TileInterfaceMetadata = z.infer<typeof TileInterfaceMetadataSchema>\n\n/**\n * The contract version each interface type advertises, so the host can check it\n * renders/runs what it expects.\n * @internal\n */\nconst INTERFACE_CONTRACT_VERSIONS = {\n  app: undefined,\n  asset_source: VIEW_CONTRACT_VERSION,\n  panel: VIEW_CONTRACT_VERSION,\n  tile: VIEW_CONTRACT_VERSION,\n  worker: SERVICE_CONTRACT_VERSION,\n} as const\n\n/** Every interface type an app exposes — an `app` view, a view, or a service. */\nexport type InterfaceKind = keyof typeof INTERFACE_CONTRACT_VERSIONS\n\n/** @internal */\nexport function interfaceContractVersion(type: InterfaceKind): string | undefined {\n  const version = INTERFACE_CONTRACT_VERSIONS[type]\n  return version === undefined ? undefined : String(version)\n}\n\n/**\n * The module-federation id a build exposes an interface at. Dev stamps the same\n * id a deploy would, so the workbench loads a local interface like a deployed one.\n * @internal\n */\nexport function interfaceModuleId(type: string, name: string): string {\n  switch (type) {\n    case 'app': {\n      return 'App'\n    }\n    case 'asset_source':\n    case 'panel':\n    case 'tile': {\n      return `views/${name}`\n    }\n    case 'worker': {\n      return `services/${name}`\n    }\n    default: {\n      throw new Error(`Cannot derive a moduleId for unknown interface type: ${type}`)\n    }\n  }\n}\n\n// Shared `name` + `src`; `kind` only tailors the validation message.\nfunction extensionDeclarationFields(kind: 'Field' | 'Service' | 'View') {\n  const pattern = /^[a-zA-Z0-9_-]+$/\n  return {\n    name: z.string().check(z.regex(pattern, `${kind} \\`name\\` must match ${pattern}`)),\n    src: z.string(),\n  }\n}\n\n// Every interface (view, service) shares `name` + `src` + a display `title`,\n// which Brett requires on the record each becomes.\nfunction interfaceDeclarationFields(kind: 'Service' | 'View') {\n  return {\n    ...extensionDeclarationFields(kind),\n    title: z.string(`${kind} \\`title\\` is required`),\n  }\n}\n\nconst PanelViewSchema = z.object({\n  type: z.literal('panel'),\n  ...interfaceDeclarationFields('View'),\n})\n\nconst AssetSourceViewSchema = z.object({\n  type: z.literal('asset_source'),\n  ...interfaceDeclarationFields('View'),\n})\n\nconst TileViewSchema = z.object({\n  type: z.literal('tile'),\n  ...interfaceDeclarationFields('View'),\n  /** Sort position within its layout track, ascending. Optional. */\n  priority: z.optional(z.number()),\n  /** Footprint family the dashboard lays the tile out by. */\n  size: TileSizeSchema,\n})\n\n/** @internal */\nexport const InterfaceDeclarationSchema = z.discriminatedUnion('type', [\n  PanelViewSchema,\n  AssetSourceViewSchema,\n  TileViewSchema,\n])\n\nconst WorkerServiceSchema = z.object({\n  type: z.literal('worker'),\n  ...interfaceDeclarationFields('Service'),\n})\n\n/** @internal */\nexport const ServiceDeclarationSchema = z.discriminatedUnion('type', [WorkerServiceSchema])\n\nconst MediaLibraryFieldSchema = z.object({\n  ...extensionDeclarationFields('Field'),\n  public: z.optional(z.boolean()),\n  title: z.string(),\n})\n\n/**\n * Stamped where the config crosses a boundary so the authoring model doesn't carry a constant discriminator.\n * @internal\n */\nexport const INSTALLATION_CONFIG_TYPE = 'installation_config'\n\n// `appType` is stamped by `unstable_defineMediaLibrary`, never authored.\nconst MediaLibraryConfigSchema = z.object({\n  appType: z.literal('media-library'),\n  fields: z\n    .array(MediaLibraryFieldSchema)\n    .check(\n      z.refine(\n        (fields) => new Set(fields.map((field) => field.name)).size === fields.length,\n        'Field `name` must be unique within a media library',\n      ),\n    ),\n})\n\n/**\n * An app's optional config, keyed by `appType`; deploys as a versioned snapshot, not an interface.\n * @internal\n */\nexport const ConfigSchema = z.discriminatedUnion('appType', [MediaLibraryConfigSchema])\n"],"names":["z","VIEW_CONTRACT_VERSION","SERVICE_CONTRACT_VERSION","MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION","VIEW_COMPONENTS","asset_source","panel","tile","TileSizeSchema","enum","AppInterfaceMetadataSchema","object","group","optional","string","priority","number","TileInterfaceMetadataSchema","size","INTERFACE_CONTRACT_VERSIONS","app","undefined","worker","interfaceContractVersion","type","version","String","interfaceModuleId","name","Error","extensionDeclarationFields","kind","pattern","check","regex","src","interfaceDeclarationFields","title","PanelViewSchema","literal","AssetSourceViewSchema","TileViewSchema","InterfaceDeclarationSchema","discriminatedUnion","WorkerServiceSchema","ServiceDeclarationSchema","MediaLibraryFieldSchema","public","boolean","INSTALLATION_CONFIG_TYPE","MediaLibraryConfigSchema","appType","fields","array","refine","Set","map","field","length","ConfigSchema"],"mappings":"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"}
+{"version":3,"sources":["../src/contract.ts"],"sourcesContent":["import {z} from 'zod/mini'\n\n// Shared module-federation extension contract: interface (view/service) and\n// config declaration schemas, plus the versions the build stamps.\n// `zod/mini` keeps the bundle small.\n\n/** @internal */\nexport const VIEW_CONTRACT_VERSION = 1\n\n/** @internal */\nexport const SERVICE_CONTRACT_VERSION = 1\n\n/** @internal */\nexport const MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION = 1\n\n/**\n * A view component. The return is opaque so the runtime helpers carry no React\n * dependency — the generated artifact renders it with the app's own React.\n * @public\n */\nexport type ViewComponent<TProps> = (props: TProps) => unknown\n\n/** @public */\nexport interface ViewComponentBaseProps<TView> {\n  view: TView\n}\n\n/** Component slots per view surface; windows load outside the component artifact path. @internal */\nexport const VIEW_COMPONENTS = {\n  app: [],\n  asset_source: ['asset_source'],\n  panel: ['title', 'panel'],\n  tile: ['tile'],\n} as const satisfies Record<string, readonly string[]>\n\n/** @public */\nexport type ViewSurface = keyof typeof VIEW_COMPONENTS\n\n/**\n * A tile's footprint family — the shape it occupies on the dashboard. Modelled\n * on iOS WidgetKit families, not a linear scale: `banner` is full-width and\n * shallow, which a `small`→`large` magnitude can't express. The host maps a\n * family to a layout slot; the component reads it to render per footprint.\n * @public\n */\nexport const TileSizeSchema = z.enum(['small', 'large', 'banner'])\n\n/** @public */\nexport type TileSize = z.infer<typeof TileSizeSchema>\n\n/** @public */\nexport type ServiceType = 'worker'\n\nconst DockGroupSchema = z.enum(['dock.system', 'dock.applications', 'dock.user'])\n\n/** @public */\nexport type DockGroup = z.output<typeof DockGroupSchema>\n\n/** @internal */\nexport const DockSchema = z.object({\n  group: z.optional(DockGroupSchema),\n  order: z.optional(z.number()),\n})\n\n/** @internal */\nexport type Dock = z.infer<typeof DockSchema>\n\n/** @internal */\nexport const ViewPlacementMetadataSchema = z.object({dock: DockSchema})\n\n/** @internal */\nexport type ViewPlacementMetadata = z.infer<typeof ViewPlacementMetadataSchema>\n\n/**\n * A tile's interface metadata: its footprint `size` and an optional `order`\n * the dashboard sorts on, ascending. Both are authored as top-level view fields\n * (see {@link InterfaceDeclarationSchema}) but stored on the record as metadata.\n * @internal\n */\nexport const TileInterfaceMetadataSchema = z.object({\n  order: z.optional(z.number()),\n  size: TileSizeSchema,\n})\n\n/** @internal */\nexport type TileInterfaceMetadata = z.infer<typeof TileInterfaceMetadataSchema>\n\n/**\n * The contract version each interface type advertises, so the host can check it\n * renders/runs what it expects.\n * @internal\n */\nconst INTERFACE_CONTRACT_VERSIONS = {\n  app: undefined,\n  asset_source: VIEW_CONTRACT_VERSION,\n  panel: VIEW_CONTRACT_VERSION,\n  tile: VIEW_CONTRACT_VERSION,\n  worker: SERVICE_CONTRACT_VERSION,\n} as const\n\n/** Every interface type an app exposes — an `app` view, a view, or a service. */\nexport type InterfaceKind = keyof typeof INTERFACE_CONTRACT_VERSIONS\n\n/** @internal */\nexport function interfaceContractVersion(kind: InterfaceKind): string | undefined {\n  const version = INTERFACE_CONTRACT_VERSIONS[kind]\n  return version === undefined ? undefined : String(version)\n}\n\n/**\n * The module-federation id a build exposes an interface at. Dev stamps the same\n * id a deploy would, so the workbench loads a local interface like a deployed one.\n * @internal\n */\nexport function interfaceModuleId(kind: string, name: string): string {\n  switch (kind) {\n    case 'app': {\n      return 'App'\n    }\n    case 'asset_source':\n    case 'panel':\n    case 'tile': {\n      return `views/${name}`\n    }\n    case 'worker': {\n      return `services/${name}`\n    }\n    default: {\n      throw new Error(`Cannot derive a moduleId for unknown interface kind: ${kind}`)\n    }\n  }\n}\n\n// Shared `name` + `src`; `kind` only tailors the validation message.\nfunction extensionDeclarationFields(kind: 'Field' | 'View' | 'Web worker') {\n  const pattern = /^[a-zA-Z0-9_-]+$/\n  return {\n    name: z.string().check(z.regex(pattern, `${kind} \\`name\\` must match ${pattern}`)),\n    src: z.string(),\n  }\n}\n\n// Every interface shares `name` + `src` + a display `title`,\n// which Brett requires on the record each becomes.\nfunction interfaceDeclarationFields(kind: 'View' | 'Web worker') {\n  return {\n    ...extensionDeclarationFields(kind),\n    title: z.string(`${kind} \\`title\\` is required`),\n  }\n}\n\nconst PanelViewSchema = z.object({\n  surface: z.literal('panel'),\n  ...interfaceDeclarationFields('View'),\n  dock: z.optional(DockSchema),\n})\n\n/** @public */\nexport type PanelView = z.output<typeof PanelViewSchema>\n\n/** @public */\nexport type DefinePanelViewInput = Omit<PanelView, 'surface'>\n\n/** @public */\nexport function definePanelView(view: DefinePanelViewInput): PanelView {\n  return {...view, surface: 'panel'}\n}\n\nconst WindowViewSchema = z.object({\n  surface: z.literal('app'),\n  ...interfaceDeclarationFields('View'),\n  dock: z.optional(DockSchema),\n})\n\n/** @public */\nexport type WindowView = z.output<typeof WindowViewSchema>\n\n/** @public */\nexport type DefineWindowViewInput = Omit<WindowView, 'surface'>\n\n/** @public */\nexport function defineWindowView(view: DefineWindowViewInput): WindowView {\n  return {...view, surface: 'app'}\n}\n\nconst AssetSourceViewSchema = z.object({\n  surface: z.literal('asset_source'),\n  ...interfaceDeclarationFields('View'),\n})\n\n/** @public */\nexport type AssetSourceView = z.output<typeof AssetSourceViewSchema>\n\n/** @public */\nexport type DefineAssetSourceViewInput = Omit<AssetSourceView, 'surface'>\n\n/** @public */\nexport function defineAssetSourceView(view: DefineAssetSourceViewInput): AssetSourceView {\n  return {...view, surface: 'asset_source'}\n}\n\nconst TileViewSchema = z.object({\n  surface: z.literal('tile'),\n  ...interfaceDeclarationFields('View'),\n  /** Sort position within its layout track, ascending. Optional. */\n  order: z.optional(z.number()),\n  /** Footprint family the dashboard lays the tile out by. */\n  size: TileSizeSchema,\n})\n\n/** @public */\nexport type TileView = z.output<typeof TileViewSchema>\n\n/** @public */\nexport type DefineTileViewInput = Omit<TileView, 'surface'>\n\n/** @public */\nexport function defineTileView(view: DefineTileViewInput): TileView {\n  return {...view, surface: 'tile'}\n}\n\n/** @internal */\nexport const InterfaceDeclarationSchema = z.discriminatedUnion('surface', [\n  WindowViewSchema,\n  PanelViewSchema,\n  AssetSourceViewSchema,\n  TileViewSchema,\n])\n\n/** @public */\nexport type ViewDeclaration = z.output<typeof InterfaceDeclarationSchema>\n\nconst WebWorkerSchema = z.object({\n  type: z.literal('worker'),\n  ...interfaceDeclarationFields('Web worker'),\n})\n\n/** @public */\nexport type WebWorker = z.output<typeof WebWorkerSchema>\n\n/** @public */\nexport type DefineWebWorkerInput = Omit<WebWorker, 'type'>\n\n/** @public */\nexport function defineWebWorker(webWorker: DefineWebWorkerInput): WebWorker {\n  return {...webWorker, type: 'worker'}\n}\n\n/** @internal */\nexport const ServiceDeclarationSchema = z.discriminatedUnion('type', [WebWorkerSchema])\n\nconst MediaLibraryFieldSchema = z.object({\n  ...extensionDeclarationFields('Field'),\n  public: z.optional(z.boolean()),\n  title: z.string(),\n})\n\n/**\n * Stamped where the config crosses a boundary so the authoring model doesn't carry a constant discriminator.\n * @internal\n */\nexport const INSTALLATION_CONFIG_TYPE = 'installation_config'\n\n// `appType` is stamped by `unstable_defineMediaLibrary`, never authored.\nconst MediaLibraryConfigSchema = z.object({\n  appType: z.literal('media-library'),\n  fields: z\n    .array(MediaLibraryFieldSchema)\n    .check(\n      z.refine(\n        (fields) => new Set(fields.map((field) => field.name)).size === fields.length,\n        'Field `name` must be unique within a media library',\n      ),\n    ),\n})\n\n/**\n * A workbench config's built value, keyed by `appType`; deploys as a versioned\n * snapshot, not an interface.\n * @internal\n */\nexport const ConfigSchema = z.discriminatedUnion('appType', [MediaLibraryConfigSchema])\n\n/**\n * The `{appType, fields}` config value the build expands into a federation\n * remote and the deploy summarizes.\n * @internal\n */\nexport type WorkbenchConfigValue = z.output<typeof ConfigSchema>\n"],"names":["z","VIEW_CONTRACT_VERSION","SERVICE_CONTRACT_VERSION","MEDIA_LIBRARY_CONFIG_CONTRACT_VERSION","VIEW_COMPONENTS","app","asset_source","panel","tile","TileSizeSchema","enum","DockGroupSchema","DockSchema","object","group","optional","order","number","ViewPlacementMetadataSchema","dock","TileInterfaceMetadataSchema","size","INTERFACE_CONTRACT_VERSIONS","undefined","worker","interfaceContractVersion","kind","version","String","interfaceModuleId","name","Error","extensionDeclarationFields","pattern","string","check","regex","src","interfaceDeclarationFields","title","PanelViewSchema","surface","literal","definePanelView","view","WindowViewSchema","defineWindowView","AssetSourceViewSchema","defineAssetSourceView","TileViewSchema","defineTileView","InterfaceDeclarationSchema","discriminatedUnion","WebWorkerSchema","type","defineWebWorker","webWorker","ServiceDeclarationSchema","MediaLibraryFieldSchema","public","boolean","INSTALLATION_CONFIG_TYPE","MediaLibraryConfigSchema","appType","fields","array","refine","Set","map","field","length","ConfigSchema"],"mappings":"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"}