@sanity/workbench-cli 2.0.2 → 2.2.1

package/dist/actions/dev/startDevManifestWatcher.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/dev/startDevManifestWatcher.ts"],"sourcesContent":["import {watch} from 'node:fs'\nimport {basename, dirname} from 'node:path'\n\nimport {findProjectRoot, type Output, subdebug} from '@sanity/cli-core'\n\nimport {canonicalizeWatchDir} from './canonicalizeWatchDir.js'\nimport {type DevServerConfig, type DevServerInterface} from './deriveConfigs.js'\n\nconst devDebug = subdebug('dev')\n\n/**\n * Debounce window between config file events and the next manifest\n * regeneration. Coalesces rapid saves (e.g. editor auto-save) and\n * atomic-rename bursts emitted by tools like VS Code.\n */\nconst DEBOUNCE_MS = 250\n\ninterface DevManifestWatcher {\n  close: () => Promise<void>\n}\n\n/** Subset of registry fields the watcher is allowed to update. */\ninterface ManifestPatch<T> {\n  manifest: T | undefined\n  manifestUpdatedAt: string\n\n  /** Same re-derive-don't-omit contract as `interfaces`. */\n  configs?: DevServerConfig[] | undefined\n  /**\n   * Workbench interfaces (views/services/app view) re-derived from the config\n   * on each change, so editing `views`/`services`/`entry` in `sanity.cli.ts`\n   * re-syncs live like `title`/`icon`. `undefined` only for\n   * non-branded configs — the registry patch is a shallow merge, so extractors\n   * must re-derive rather than omit, or the registered set gets wiped.\n   */\n  interfaces?: DevServerInterface[] | undefined\n}\n\ninterface StartDevManifestWatcherOptions<T> {\n  /**\n   * Run the project-specific extraction and resolve to the manifest patch, which\n   * the watcher stamps with `manifestUpdatedAt` before forwarding. Receives the\n   * resolved config path (`sanity.config.ts` for studios, `sanity.cli.ts` for\n   * core-apps) and the working directory.\n   */\n  extract: (params: {\n    configPath: string\n    workDir: string\n  }) => Promise<Omit<ManifestPatch<T>, 'manifestUpdatedAt'>>\n  output: Output\n  /**\n   * Called after every successful extraction with the inlined manifest +\n   * interfaces. Awaited, so an interface-set change can rebuild the federation\n   * remote before the registry is patched (which is what reloads the workbench).\n   */\n  update: (patch: ManifestPatch<T>) => Promise<void> | void\n  workDir: string\n\n  /**\n   * Extra config filenames (basenames in the project root directory) that also\n   * trigger a regeneration. Studios resolve their project root via\n   * `sanity.config.*` but declare workbench interfaces in `sanity.cli.*`, so\n   * their watcher needs to react to both files.\n   */\n  extraWatchFilenames?: readonly string[]\n}\n\n/**\n * Generate the project manifest once and then keep it in sync with the\n * project's config file (`sanity.config.(ts|js)` for studios,\n * `sanity.cli.(ts|js)` for core-apps) on disk. The initial generation runs\n * fire-and-forget so it doesn't block dev-server startup; subsequent\n * file-system events are coalesced behind it, so the extractor never has\n * overlapping writes to its shared output directory. Each successful\n * regeneration inlines the new manifest into the registry via the `update`\n * callback, so any running workbench rebroadcasts to its clients.\n *\n * Errors during extraction are logged as warnings and do not crash the dev\n * server — the previously extracted manifest (if any) stays in the\n * registry.\n */\nexport async function startDevManifestWatcher<T>({\n  extract,\n  extraWatchFilenames,\n  output,\n  update,\n  workDir,\n}: StartDevManifestWatcherOptions<T>): Promise<DevManifestWatcher> {\n  const projectRoot = await findProjectRoot(workDir)\n  const configPath = projectRoot.path\n\n  let running = false\n  let pending = false\n  let closed = false\n\n  const regenerate = async () => {\n    if (closed) return\n    if (running) {\n      pending = true\n      return\n    }\n    running = true\n    try {\n      const {configs, interfaces, manifest} = await extract({configPath, workDir})\n      if (closed) return\n      await update({\n        configs,\n        interfaces,\n        manifest,\n        manifestUpdatedAt: new Date().toISOString(),\n      })\n    } catch (err) {\n      // Extractors print their own spinner failure; log the reason here so\n      // the user sees what went wrong alongside the spinner indicator.\n      devDebug('Manifest regeneration failed: %O', err)\n      output.warn(\n        `Could not extract manifest for workbench: ${err instanceof Error ? err.message : String(err)}`,\n      )\n    } finally {\n      running = false\n      if (pending && !closed) {\n        pending = false\n        void regenerate()\n      }\n    }\n  }\n\n  // Route the initial extraction through `regenerate` too, so file-system\n  // events arriving before it finishes get coalesced rather than racing it\n  // for the shared output directory.\n  void regenerate()\n\n  // Watch the config file's parent directory and filter by filename.\n  // Watching the file itself is unreliable across editors that perform\n  // atomic-save (delete + rename) — the watcher loses its target once the\n  // inode changes. Directory watches survive those transitions.\n  // Canonicalize to the real long path so `fs.watch` doesn't abort on Windows\n  // short-path dirs. See `canonicalizeWatchDir`.\n  const configDir = canonicalizeWatchDir(dirname(configPath))\n  const watchFilenames = new Set([basename(configPath), ...(extraWatchFilenames ?? [])])\n\n  let debounceTimer: ReturnType<typeof setTimeout> | undefined\n\n  const onEvent = (_event: string, filename: Buffer | string | null) => {\n    if (!filename) return\n    const name = typeof filename === 'string' ? filename : filename.toString('utf8')\n    if (!watchFilenames.has(name)) return\n    clearTimeout(debounceTimer)\n    debounceTimer = setTimeout(() => {\n      void regenerate()\n    }, DEBOUNCE_MS)\n  }\n\n  const watcher = watch(configDir, onEvent)\n\n  watcher.on('error', (err) => {\n    devDebug('Config watcher error: %O', err)\n    output.warn(`Manifest watcher error: ${err instanceof Error ? err.message : String(err)}`)\n  })\n\n  return {\n    // Idempotent — a repeat close (e.g. a signal handler racing an explicit\n    // close) is a no-op, so we never clear an already-cleared timer or\n    // double-close the underlying watcher.\n    close: async () => {\n      if (closed) return\n      closed = true\n      clearTimeout(debounceTimer)\n      watcher.close()\n    },\n  }\n}\n"],"names":["watch","basename","dirname","findProjectRoot","subdebug","canonicalizeWatchDir","devDebug","DEBOUNCE_MS","startDevManifestWatcher","extract","extraWatchFilenames","output","update","workDir","projectRoot","configPath","path","running","pending","closed","regenerate","configs","interfaces","manifest","manifestUpdatedAt","Date","toISOString","err","warn","Error","message","String","configDir","watchFilenames","Set","debounceTimer","onEvent","_event","filename","name","toString","has","clearTimeout","setTimeout","watcher","on","close"],"mappings":"AAAA,SAAQA,KAAK,QAAO,UAAS;AAC7B,SAAQC,QAAQ,EAAEC,OAAO,QAAO,YAAW;AAE3C,SAAQC,eAAe,EAAeC,QAAQ,QAAO,mBAAkB;AAEvE,SAAQC,oBAAoB,QAAO,4BAA2B;AAG9D,MAAMC,WAAWF,SAAS;AAE1B;;;;CAIC,GACD,MAAMG,cAAc;AAoDpB;;;;;;;;;;;;;CAaC,GACD,OAAO,eAAeC,wBAA2B,EAC/CC,OAAO,EACPC,mBAAmB,EACnBC,MAAM,EACNC,MAAM,EACNC,OAAO,EAC2B;IAClC,MAAMC,cAAc,MAAMX,gBAAgBU;IAC1C,MAAME,aAAaD,YAAYE,IAAI;IAEnC,IAAIC,UAAU;IACd,IAAIC,UAAU;IACd,IAAIC,SAAS;IAEb,MAAMC,aAAa;QACjB,IAAID,QAAQ;QACZ,IAAIF,SAAS;YACXC,UAAU;YACV;QACF;QACAD,UAAU;QACV,IAAI;YACF,MAAM,EAACI,OAAO,EAAEC,UAAU,EAAEC,QAAQ,EAAC,GAAG,MAAMd,QAAQ;gBAACM;gBAAYF;YAAO;YAC1E,IAAIM,QAAQ;YACZ,MAAMP,OAAO;gBACXS;gBACAC;gBACAC;gBACAC,mBAAmB,IAAIC,OAAOC,WAAW;YAC3C;QACF,EAAE,OAAOC,KAAK;YACZ,qEAAqE;YACrE,iEAAiE;YACjErB,SAAS,oCAAoCqB;YAC7ChB,OAAOiB,IAAI,CACT,CAAC,0CAA0C,EAAED,eAAeE,QAAQF,IAAIG,OAAO,GAAGC,OAAOJ,MAAM;QAEnG,SAAU;YACRV,UAAU;YACV,IAAIC,WAAW,CAACC,QAAQ;gBACtBD,UAAU;gBACV,KAAKE;YACP;QACF;IACF;IAEA,wEAAwE;IACxE,yEAAyE;IACzE,mCAAmC;IACnC,KAAKA;IAEL,mEAAmE;IACnE,qEAAqE;IACrE,wEAAwE;IACxE,8DAA8D;IAC9D,4EAA4E;IAC5E,+CAA+C;IAC/C,MAAMY,YAAY3B,qBAAqBH,QAAQa;IAC/C,MAAMkB,iBAAiB,IAAIC,IAAI;QAACjC,SAASc;WAAiBL,uBAAuB,EAAE;KAAE;IAErF,IAAIyB;IAEJ,MAAMC,UAAU,CAACC,QAAgBC;QAC/B,IAAI,CAACA,UAAU;QACf,MAAMC,OAAO,OAAOD,aAAa,WAAWA,WAAWA,SAASE,QAAQ,CAAC;QACzE,IAAI,CAACP,eAAeQ,GAAG,CAACF,OAAO;QAC/BG,aAAaP;QACbA,gBAAgBQ,WAAW;YACzB,KAAKvB;QACP,GAAGb;IACL;IAEA,MAAMqC,UAAU5C,MAAMgC,WAAWI;IAEjCQ,QAAQC,EAAE,CAAC,SAAS,CAAClB;QACnBrB,SAAS,4BAA4BqB;QACrChB,OAAOiB,IAAI,CAAC,CAAC,wBAAwB,EAAED,eAAeE,QAAQF,IAAIG,OAAO,GAAGC,OAAOJ,MAAM;IAC3F;IAEA,OAAO;QACL,wEAAwE;QACxE,mEAAmE;QACnE,uCAAuC;QACvCmB,OAAO;YACL,IAAI3B,QAAQ;YACZA,SAAS;YACTuB,aAAaP;YACbS,QAAQE,KAAK;QACf;IACF;AACF"}
+{"version":3,"sources":["../../../src/actions/dev/startDevManifestWatcher.ts"],"sourcesContent":["import {watch} from 'node:fs'\nimport {basename, dirname} from 'node:path'\n\nimport {findProjectRoot, type Output, subdebug} from '@sanity/cli-core'\n\nimport {canonicalizeWatchDir} from './canonicalizeWatchDir.js'\nimport {type DevServerConfig, type DevServerInterface} from './deriveConfigs.js'\n\nconst devDebug = subdebug('dev')\n\n/**\n * Debounce window between config file events and the next manifest\n * regeneration. Coalesces rapid saves (e.g. editor auto-save) and\n * atomic-rename bursts emitted by tools like VS Code.\n */\nconst DEBOUNCE_MS = 250\n\ninterface DevManifestWatcher {\n  close: () => Promise<void>\n}\n\n/** Subset of registry fields the watcher is allowed to update. */\ninterface ManifestPatch<T> {\n  manifest: T | undefined\n  manifestUpdatedAt: string\n\n  /** Same re-derive-don't-omit contract as `interfaces`. */\n  configs?: DevServerConfig[] | undefined\n  /**\n   * Workbench interfaces (views/web workers/app view) re-derived from the config\n   * on each change, so editing `views`/`webWorkers`/`entry` in `sanity.cli.ts`\n   * re-syncs live like `title`/`icon`. `undefined` only for\n   * non-branded configs — the registry patch is a shallow merge, so extractors\n   * must re-derive rather than omit, or the registered set gets wiped.\n   */\n  interfaces?: DevServerInterface[] | undefined\n}\n\ninterface StartDevManifestWatcherOptions<T> {\n  /**\n   * Run the project-specific extraction and resolve to the manifest patch, which\n   * the watcher stamps with `manifestUpdatedAt` before forwarding. Receives the\n   * resolved config path (`sanity.config.ts` for studios, `sanity.cli.ts` for\n   * core-apps) and the working directory.\n   */\n  extract: (params: {\n    configPath: string\n    workDir: string\n  }) => Promise<Omit<ManifestPatch<T>, 'manifestUpdatedAt'>>\n  output: Output\n  /**\n   * Called after every successful extraction with the inlined manifest +\n   * interfaces. Awaited, so an interface-set change can rebuild the federation\n   * remote before the registry is patched (which is what reloads the workbench).\n   */\n  update: (patch: ManifestPatch<T>) => Promise<void> | void\n  workDir: string\n\n  /**\n   * Extra config filenames (basenames in the project root directory) that also\n   * trigger a regeneration. Studios resolve their project root via\n   * `sanity.config.*` but declare workbench interfaces in `sanity.cli.*`, so\n   * their watcher needs to react to both files.\n   */\n  extraWatchFilenames?: readonly string[]\n}\n\n/**\n * Generate the project manifest once and then keep it in sync with the\n * project's config file (`sanity.config.(ts|js)` for studios,\n * `sanity.cli.(ts|js)` for core-apps) on disk. The initial generation runs\n * fire-and-forget so it doesn't block dev-server startup; subsequent\n * file-system events are coalesced behind it, so the extractor never has\n * overlapping writes to its shared output directory. Each successful\n * regeneration inlines the new manifest into the registry via the `update`\n * callback, so any running workbench rebroadcasts to its clients.\n *\n * Errors during extraction are logged as warnings and do not crash the dev\n * server — the previously extracted manifest (if any) stays in the\n * registry.\n */\nexport async function startDevManifestWatcher<T>({\n  extract,\n  extraWatchFilenames,\n  output,\n  update,\n  workDir,\n}: StartDevManifestWatcherOptions<T>): Promise<DevManifestWatcher> {\n  const projectRoot = await findProjectRoot(workDir)\n  const configPath = projectRoot.path\n\n  let running = false\n  let pending = false\n  let closed = false\n\n  const regenerate = async () => {\n    if (closed) return\n    if (running) {\n      pending = true\n      return\n    }\n    running = true\n    try {\n      const {configs, interfaces, manifest} = await extract({configPath, workDir})\n      if (closed) return\n      await update({\n        configs,\n        interfaces,\n        manifest,\n        manifestUpdatedAt: new Date().toISOString(),\n      })\n    } catch (err) {\n      // Extractors print their own spinner failure; log the reason here so\n      // the user sees what went wrong alongside the spinner indicator.\n      devDebug('Manifest regeneration failed: %O', err)\n      output.warn(\n        `Could not extract manifest for workbench: ${err instanceof Error ? err.message : String(err)}`,\n      )\n    } finally {\n      running = false\n      if (pending && !closed) {\n        pending = false\n        void regenerate()\n      }\n    }\n  }\n\n  // Route the initial extraction through `regenerate` too, so file-system\n  // events arriving before it finishes get coalesced rather than racing it\n  // for the shared output directory.\n  void regenerate()\n\n  // Watch the config file's parent directory and filter by filename.\n  // Watching the file itself is unreliable across editors that perform\n  // atomic-save (delete + rename) — the watcher loses its target once the\n  // inode changes. Directory watches survive those transitions.\n  // Canonicalize to the real long path so `fs.watch` doesn't abort on Windows\n  // short-path dirs. See `canonicalizeWatchDir`.\n  const configDir = canonicalizeWatchDir(dirname(configPath))\n  const watchFilenames = new Set([basename(configPath), ...(extraWatchFilenames ?? [])])\n\n  let debounceTimer: ReturnType<typeof setTimeout> | undefined\n\n  const onEvent = (_event: string, filename: Buffer | string | null) => {\n    if (!filename) return\n    const name = typeof filename === 'string' ? filename : filename.toString('utf8')\n    if (!watchFilenames.has(name)) return\n    clearTimeout(debounceTimer)\n    debounceTimer = setTimeout(() => {\n      void regenerate()\n    }, DEBOUNCE_MS)\n  }\n\n  const watcher = watch(configDir, onEvent)\n\n  watcher.on('error', (err) => {\n    devDebug('Config watcher error: %O', err)\n    output.warn(`Manifest watcher error: ${err instanceof Error ? err.message : String(err)}`)\n  })\n\n  return {\n    // Idempotent — a repeat close (e.g. a signal handler racing an explicit\n    // close) is a no-op, so we never clear an already-cleared timer or\n    // double-close the underlying watcher.\n    close: async () => {\n      if (closed) return\n      closed = true\n      clearTimeout(debounceTimer)\n      watcher.close()\n    },\n  }\n}\n"],"names":["watch","basename","dirname","findProjectRoot","subdebug","canonicalizeWatchDir","devDebug","DEBOUNCE_MS","startDevManifestWatcher","extract","extraWatchFilenames","output","update","workDir","projectRoot","configPath","path","running","pending","closed","regenerate","configs","interfaces","manifest","manifestUpdatedAt","Date","toISOString","err","warn","Error","message","String","configDir","watchFilenames","Set","debounceTimer","onEvent","_event","filename","name","toString","has","clearTimeout","setTimeout","watcher","on","close"],"mappings":"AAAA,SAAQA,KAAK,QAAO,UAAS;AAC7B,SAAQC,QAAQ,EAAEC,OAAO,QAAO,YAAW;AAE3C,SAAQC,eAAe,EAAeC,QAAQ,QAAO,mBAAkB;AAEvE,SAAQC,oBAAoB,QAAO,4BAA2B;AAG9D,MAAMC,WAAWF,SAAS;AAE1B;;;;CAIC,GACD,MAAMG,cAAc;AAoDpB;;;;;;;;;;;;;CAaC,GACD,OAAO,eAAeC,wBAA2B,EAC/CC,OAAO,EACPC,mBAAmB,EACnBC,MAAM,EACNC,MAAM,EACNC,OAAO,EAC2B;IAClC,MAAMC,cAAc,MAAMX,gBAAgBU;IAC1C,MAAME,aAAaD,YAAYE,IAAI;IAEnC,IAAIC,UAAU;IACd,IAAIC,UAAU;IACd,IAAIC,SAAS;IAEb,MAAMC,aAAa;QACjB,IAAID,QAAQ;QACZ,IAAIF,SAAS;YACXC,UAAU;YACV;QACF;QACAD,UAAU;QACV,IAAI;YACF,MAAM,EAACI,OAAO,EAAEC,UAAU,EAAEC,QAAQ,EAAC,GAAG,MAAMd,QAAQ;gBAACM;gBAAYF;YAAO;YAC1E,IAAIM,QAAQ;YACZ,MAAMP,OAAO;gBACXS;gBACAC;gBACAC;gBACAC,mBAAmB,IAAIC,OAAOC,WAAW;YAC3C;QACF,EAAE,OAAOC,KAAK;YACZ,qEAAqE;YACrE,iEAAiE;YACjErB,SAAS,oCAAoCqB;YAC7ChB,OAAOiB,IAAI,CACT,CAAC,0CAA0C,EAAED,eAAeE,QAAQF,IAAIG,OAAO,GAAGC,OAAOJ,MAAM;QAEnG,SAAU;YACRV,UAAU;YACV,IAAIC,WAAW,CAACC,QAAQ;gBACtBD,UAAU;gBACV,KAAKE;YACP;QACF;IACF;IAEA,wEAAwE;IACxE,yEAAyE;IACzE,mCAAmC;IACnC,KAAKA;IAEL,mEAAmE;IACnE,qEAAqE;IACrE,wEAAwE;IACxE,8DAA8D;IAC9D,4EAA4E;IAC5E,+CAA+C;IAC/C,MAAMY,YAAY3B,qBAAqBH,QAAQa;IAC/C,MAAMkB,iBAAiB,IAAIC,IAAI;QAACjC,SAASc;WAAiBL,uBAAuB,EAAE;KAAE;IAErF,IAAIyB;IAEJ,MAAMC,UAAU,CAACC,QAAgBC;QAC/B,IAAI,CAACA,UAAU;QACf,MAAMC,OAAO,OAAOD,aAAa,WAAWA,WAAWA,SAASE,QAAQ,CAAC;QACzE,IAAI,CAACP,eAAeQ,GAAG,CAACF,OAAO;QAC/BG,aAAaP;QACbA,gBAAgBQ,WAAW;YACzB,KAAKvB;QACP,GAAGb;IACL;IAEA,MAAMqC,UAAU5C,MAAMgC,WAAWI;IAEjCQ,QAAQC,EAAE,CAAC,SAAS,CAAClB;QACnBrB,SAAS,4BAA4BqB;QACrChB,OAAOiB,IAAI,CAAC,CAAC,wBAAwB,EAAED,eAAeE,QAAQF,IAAIG,OAAO,GAAGC,OAAOJ,MAAM;IAC3F;IAEA,OAAO;QACL,wEAAwE;QACxE,mEAAmE;QACnE,uCAAuC;QACvCmB,OAAO;YACL,IAAI3B,QAAQ;YACZA,SAAS;YACTuB,aAAaP;YACbS,QAAQE,KAAK;QACf;IACF;AACF"}

package/dist/actions/dev/startDevServerRegistration.js

@@ -1,37 +1,24 @@
 import { getCliConfigUncached } from '@sanity/cli-core';
-import { isWorkbenchApp } from '../../defineApp.js';
+import { applicationReference } from '../../applicationReference.js';
+import { isWorkbenchApp, isWorkbenchConfig } from '../../defineApp.js';
 import { deriveInterfaces } from '../../deriveInterfaces.js';
+import { resolveWorkbenchConfig } from '../../resolveWorkbenchConfig.js';
 import { formatWorkbenchAppErrors, validateWorkbenchApp } from '../../validateWorkbenchApp.js';
 import { deriveConfigs } from './deriveConfigs.js';
 import { trackExposesSet } from './exposesSetId.js';
-import { getRegisteredServers, isConfigOnlyServer, registerDevServer } from './registry.js';
+import { getRegisteredServers, registerDevServer } from './registry.js';
 import { startDevManifestWatcher } from './startDevManifestWatcher.js';
 /**
- * Log any config validation errors without aborting. Unlike build and deploy,
- * dev stays up on an invalid config so the author sees the errors and fixes them
- * live on the next save.
+ * Log any app validation errors without aborting. Unlike build and deploy, dev
+ * stays up on an invalid app so the author sees the errors and fixes them live on
+ * the next save. A config is not an app — it isn't validated by the app schema
+ * (which would spuriously demand a slug/title), so skip it here.
  */ function reportConfigErrors(app, output) {
+    if (isWorkbenchConfig(app)) return;
     const errors = validateWorkbenchApp(app);
     if (errors.length === 0) return;
     output.warn(formatWorkbenchAppErrors(errors));
 }
-/**
- * A live server — other than this process — already playing the given role for
- * the slug. Only a *same-role* duplicate is a conflict: a config-only server
- * (configs, no interfaces — e.g. a media-library config app) is never routed
- * as an app, so it may share a slug with the app server it configures. The
- * workbench renders the app and publishes both servers' configs, and can
- * always tell them apart.
- */ function findSameRoleConflict(id, configOnly) {
-    return getRegisteredServers().find((server)=>server.pid !== process.pid && server.id === id && isConfigOnlyServer(server) === configOnly);
-}
-/**
- * Remedy line for a same-role slug conflict, phrased for the role. Changing the
- * slug is only real advice for an app — a config app's slug is fixed by the
- * app it configures (e.g. `unstable_defineMediaLibrary` hard-codes it).
- */ function conflictRemedy(configOnly) {
-    return configOnly ? 'Stop that server first.' : 'Stop that server, or give this app its own `slug` in sanity.cli.ts.';
-}
 /** The address the server actually bound — the live socket, which can differ from the configured port under non-strict ports. */ function serverAddress(server) {
     const resolvedHost = server.config.server.host;
     const addr = server.httpServer?.address();
@@ -53,33 +40,42 @@ import { startDevManifestWatcher } from './startDevManifestWatcher.js';
     const interfaces = deriveInterfaces(cliConfig.app, {
         isApp
     });
-    const configs = await deriveConfigs(cliConfig.app);
-    const id = isWorkbenchApp(cliConfig.app) ? cliConfig.app.slug : undefined;
-    const configOnly = isConfigOnlyServer({
-        configs,
-        interfaces
-    });
-    const devServer = id ? findSameRoleConflict(id, configOnly) : undefined;
+    const configs = await deriveConfigs(cliConfig);
+    const workbenchApp = isWorkbenchApp(cliConfig.app) ? cliConfig.app : undefined;
+    const config = resolveWorkbenchConfig(cliConfig);
+    // A config runs alongside the app it configures, so give it its own id
+    // namespace — sharing the app's slug would make the two indistinguishable here.
+    const id = config ? `config:${config.appType}` : workbenchApp?.slug;
+    // Identity is resolved and the reference composed here, so the workbench reads
+    // both off the registry entry instead of recomposing them. Name defaults to the
+    // slug, mirroring brett.
+    const name = workbenchApp?.name ?? workbenchApp?.slug;
+    const reference = workbenchApp && name ? // is a config, not an app — so its reference is always `<org>/<name>`.
+    applicationReference({
+        isSingleton: false,
+        name,
+        organizationId: workbenchApp.organizationId
+    }) : undefined;
+    // Separate namespaces mean a shared id is a genuine duplicate, so the gate is
+    // a plain id match — no config-vs-app role left to reconcile.
+    const devServer = id ? getRegisteredServers().find((server)=>server.id === id) : undefined;
     if (id && devServer) {
-        const subject = configOnly ? `A config for "${id}"` : `The app "${id}"`;
-        output.error(`${subject} is already served by another dev server running on port ${devServer.port}, ` + "so the workbench can't tell them apart and this one stays out of it. " + conflictRemedy(configOnly), {
+        output.error(`"${id}" is already served by another dev server running on port ${devServer.port}, ` + "so the workbench can't tell them apart and this one stays out of it. Stop that server first.", {
             exit: false
         });
         return {
             close: async ()=>{}
         };
     }
-    // The role the registry currently advertises for this server; a config edit
-    // can flip it (see the re-check in `update`). Committed only after a
-    // successful registry patch, so a failed pass re-checks on the next save.
-    let registeredConfigOnly = configOnly;
     const registration = registerDevServer({
         configs,
         host: appHost,
         id,
         interfaces,
+        name,
         port: appPort,
         projectId: cliConfig?.api?.projectId,
+        reference,
         type: isApp ? 'coreApp' : 'studio',
         workDir
     });
@@ -91,11 +87,11 @@ import { startDevManifestWatcher } from './startDevManifestWatcher.js';
         // Re-derive every pass (don't omit): the registry patch is a shallow merge,
         // so omitting would wipe the registered set.
         extract: async (params)=>{
-            const app = (await getCliConfigUncached(params.workDir)).app;
-            reportConfigErrors(app, output);
+            const nextConfig = await getCliConfigUncached(params.workDir);
+            reportConfigErrors(nextConfig.app, output);
             return {
-                configs: await deriveConfigs(app),
-                interfaces: deriveInterfaces(app, {
+                configs: await deriveConfigs(nextConfig),
+                interfaces: deriveInterfaces(nextConfig.app, {
                     isApp
                 }),
                 manifest: await extractManifest(params)
@@ -109,31 +105,11 @@ import { startDevManifestWatcher } from './startDevManifestWatcher.js';
         ],
         output,
         update: async (patch)=>{
-            // A save can flip the server's role — e.g. a config-only app gaining an
-            // `entry` becomes app-role — so re-run the same-role collision check the
-            // registration gate applied, or the flip would quietly reintroduce the
-            // ambiguity (two app-role servers on one slug). The patch is skipped, not
-            // fatal: the registry keeps the previous shape and the next save retries.
-            const nextConfigOnly = isConfigOnlyServer({
-                configs: patch.configs,
-                interfaces: patch.interfaces
-            });
-            if (id && nextConfigOnly !== registeredConfigOnly) {
-                const conflict = findSameRoleConflict(id, nextConfigOnly);
-                if (conflict) {
-                    const subject = nextConfigOnly ? `a config for "${id}"` : `the app "${id}"`;
-                    output.error(`This change makes this dev server serve ${subject} like the dev server running on ` + `port ${conflict.port} already does, so the workbench couldn't tell them apart — ` + `keeping the previous registration. ${conflictRemedy(nextConfigOnly)}`, {
-                        exit: false
-                    });
-                    return;
-                }
-            }
             if (!exposesSet.changed({
                 configs: patch.configs,
                 interfaces: patch.interfaces
             })) {
                 registration.update(patch);
-                registeredConfigOnly = nextConfigOnly;
                 return;
             }
             // Rebuild the remote *before* patching the registry — the patch reloads the
@@ -149,7 +125,6 @@ import { startDevManifestWatcher } from './startDevManifestWatcher.js';
                 ...patch,
                 ...serverAddress(rebuiltServer)
             } : patch);
-            registeredConfigOnly = nextConfigOnly;
         },
         workDir
     });

package/dist/actions/dev/startDevServerRegistration.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/dev/startDevServerRegistration.ts"],"sourcesContent":["import {type CliConfig, getCliConfigUncached, type Output} from '@sanity/cli-core'\nimport {type ViteDevServer} from 'vite'\n\nimport {isWorkbenchApp} from '../../defineApp.js'\nimport {deriveInterfaces} from '../../deriveInterfaces.js'\nimport {formatWorkbenchAppErrors, validateWorkbenchApp} from '../../validateWorkbenchApp.js'\nimport {deriveConfigs} from './deriveConfigs.js'\nimport {trackExposesSet} from './exposesSetId.js'\nimport {\n  type DevServerManifest,\n  getRegisteredServers,\n  isConfigOnlyServer,\n  registerDevServer,\n} from './registry.js'\nimport {startDevManifestWatcher} from './startDevManifestWatcher.js'\n\ninterface DevServerRegistrationOptions {\n  cliConfig: CliConfig\n  /**\n   * Extract the project manifest to inline into the registry. The caller owns the\n   * studio-vs-app split (manifest formats are CLI-domain); registration re-derives\n   * the interface set alongside it.\n   */\n  extractManifest: (params: {\n    configPath: string\n    workDir: string\n  }) => Promise<DevServerManifest['manifest']>\n  isApp: boolean\n  output: Output\n  server: ViteDevServer\n  workDir: string\n\n  /**\n   * Rebuild the app's federation remote when its interface set changes, awaited\n   * *before* the registry patch — the patch reloads the workbench page, which must\n   * re-fetch a remote that already exposes the new interface. Resolves with the\n   * recreated server so the entry gets its actual address (non-strict ports may\n   * shift it); must reject if the restart produces no server, so the set stays\n   * uncommitted and the next save retries instead of advertising a dead port.\n   */\n  onInterfaceSetChange?: () => Promise<ViteDevServer>\n}\n\ninterface DevServerRegistrationHandle {\n  close: () => Promise<void>\n}\n\n/**\n * Log any config validation errors without aborting. Unlike build and deploy,\n * dev stays up on an invalid config so the author sees the errors and fixes them\n * live on the next save.\n */\nfunction reportConfigErrors(app: CliConfig['app'], output: Output): void {\n  const errors = validateWorkbenchApp(app)\n  if (errors.length === 0) return\n  output.warn(formatWorkbenchAppErrors(errors))\n}\n\n/**\n * A live server — other than this process — already playing the given role for\n * the slug. Only a *same-role* duplicate is a conflict: a config-only server\n * (configs, no interfaces — e.g. a media-library config app) is never routed\n * as an app, so it may share a slug with the app server it configures. The\n * workbench renders the app and publishes both servers' configs, and can\n * always tell them apart.\n */\nfunction findSameRoleConflict(id: string, configOnly: boolean): DevServerManifest | undefined {\n  return getRegisteredServers().find(\n    (server) =>\n      server.pid !== process.pid && server.id === id && isConfigOnlyServer(server) === configOnly,\n  )\n}\n\n/**\n * Remedy line for a same-role slug conflict, phrased for the role. Changing the\n * slug is only real advice for an app — a config app's slug is fixed by the\n * app it configures (e.g. `unstable_defineMediaLibrary` hard-codes it).\n */\nfunction conflictRemedy(configOnly: boolean): string {\n  return configOnly\n    ? 'Stop that server first.'\n    : 'Stop that server, or give this app its own `slug` in sanity.cli.ts.'\n}\n\n/** The address the server actually bound — the live socket, which can differ from the configured port under non-strict ports. */\nfunction serverAddress(server: ViteDevServer) {\n  const resolvedHost = server.config.server.host\n  const addr = server.httpServer?.address()\n  return {\n    host: typeof resolvedHost === 'string' ? resolvedHost : 'localhost',\n    port: typeof addr === 'object' && addr ? addr.port : server.config.server.port,\n  }\n}\n\n/**\n * Register the dev server in the registry and watch its config for manifest +\n * interface changes. The workbench reads the entry to locate and render the\n * server; the watcher keeps it current as `sanity.cli.ts` is edited.\n */\nexport async function startDevServerRegistration(\n  options: DevServerRegistrationOptions,\n): Promise<DevServerRegistrationHandle> {\n  const {cliConfig, extractManifest, isApp, onInterfaceSetChange, output, server, workDir} = options\n\n  const {host: appHost, port: appPort} = serverAddress(server)\n\n  reportConfigErrors(cliConfig.app, output)\n\n  // Forwarded alongside (not inside) the manifest so the workbench renders local\n  // panels/workers and reads the configs without a deploy.\n  const interfaces = deriveInterfaces(cliConfig.app, {isApp})\n  const configs = await deriveConfigs(cliConfig.app)\n\n  const id = isWorkbenchApp(cliConfig.app) ? cliConfig.app.slug : undefined\n\n  const configOnly = isConfigOnlyServer({configs, interfaces})\n  const devServer = id ? findSameRoleConflict(id, configOnly) : undefined\n\n  if (id && devServer) {\n    const subject = configOnly ? `A config for \"${id}\"` : `The app \"${id}\"`\n    output.error(\n      `${subject} is already served by another dev server running on port ${devServer.port}, ` +\n        \"so the workbench can't tell them apart and this one stays out of it. \" +\n        conflictRemedy(configOnly),\n      {exit: false},\n    )\n    return {close: async () => {}}\n  }\n\n  // The role the registry currently advertises for this server; a config edit\n  // can flip it (see the re-check in `update`). Committed only after a\n  // successful registry patch, so a failed pass re-checks on the next save.\n  let registeredConfigOnly = configOnly\n\n  const registration = registerDevServer({\n    configs,\n    host: appHost,\n    id,\n    interfaces,\n    port: appPort,\n    projectId: cliConfig?.api?.projectId,\n    type: isApp ? 'coreApp' : 'studio',\n    workDir,\n  })\n\n  const exposesSet = trackExposesSet({configs, interfaces})\n\n  const watcher = await startDevManifestWatcher({\n    // Re-derive every pass (don't omit): the registry patch is a shallow merge,\n    // so omitting would wipe the registered set.\n    extract: async (params) => {\n      const app = (await getCliConfigUncached(params.workDir)).app\n      reportConfigErrors(app, output)\n      return {\n        configs: await deriveConfigs(app),\n        interfaces: deriveInterfaces(app, {isApp}),\n        manifest: await extractManifest(params),\n      }\n    },\n    // A studio's root resolves to `sanity.config.*` but its interfaces live in\n    // `sanity.cli.*` — watch that too. Apps already root at `sanity.cli.*`.\n    extraWatchFilenames: isApp ? undefined : ['sanity.cli.js', 'sanity.cli.ts'],\n    output,\n    update: async (patch) => {\n      // A save can flip the server's role — e.g. a config-only app gaining an\n      // `entry` becomes app-role — so re-run the same-role collision check the\n      // registration gate applied, or the flip would quietly reintroduce the\n      // ambiguity (two app-role servers on one slug). The patch is skipped, not\n      // fatal: the registry keeps the previous shape and the next save retries.\n      const nextConfigOnly = isConfigOnlyServer({\n        configs: patch.configs,\n        interfaces: patch.interfaces,\n      })\n      if (id && nextConfigOnly !== registeredConfigOnly) {\n        const conflict = findSameRoleConflict(id, nextConfigOnly)\n        if (conflict) {\n          const subject = nextConfigOnly ? `a config for \"${id}\"` : `the app \"${id}\"`\n          output.error(\n            `This change makes this dev server serve ${subject} like the dev server running on ` +\n              `port ${conflict.port} already does, so the workbench couldn't tell them apart — ` +\n              `keeping the previous registration. ${conflictRemedy(nextConfigOnly)}`,\n            {exit: false},\n          )\n          return\n        }\n      }\n\n      if (\n        !exposesSet.changed({\n          configs: patch.configs,\n          interfaces: patch.interfaces,\n        })\n      ) {\n        registration.update(patch)\n        registeredConfigOnly = nextConfigOnly\n        return\n      }\n      // Rebuild the remote *before* patching the registry — the patch reloads the\n      // page, which must re-fetch a remote that already exposes the new interface.\n      const rebuiltServer = await onInterfaceSetChange?.()\n      // Commit only after a successful rebuild, so a thrown one retries next pass.\n      exposesSet.commit({\n        configs: patch.configs,\n        interfaces: patch.interfaces,\n      })\n      // The recreated server can bind a different port (non-strict ports).\n      registration.update(rebuiltServer ? {...patch, ...serverAddress(rebuiltServer)} : patch)\n      registeredConfigOnly = nextConfigOnly\n    },\n    workDir,\n  })\n\n  return {\n    close: async () => {\n      registration.release()\n      await watcher.close()\n    },\n  }\n}\n"],"names":["getCliConfigUncached","isWorkbenchApp","deriveInterfaces","formatWorkbenchAppErrors","validateWorkbenchApp","deriveConfigs","trackExposesSet","getRegisteredServers","isConfigOnlyServer","registerDevServer","startDevManifestWatcher","reportConfigErrors","app","output","errors","length","warn","findSameRoleConflict","id","configOnly","find","server","pid","process","conflictRemedy","serverAddress","resolvedHost","config","host","addr","httpServer","address","port","startDevServerRegistration","options","cliConfig","extractManifest","isApp","onInterfaceSetChange","workDir","appHost","appPort","interfaces","configs","slug","undefined","devServer","subject","error","exit","close","registeredConfigOnly","registration","projectId","api","type","exposesSet","watcher","extract","params","manifest","extraWatchFilenames","update","patch","nextConfigOnly","conflict","changed","rebuiltServer","commit","release"],"mappings":"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"}
+{"version":3,"sources":["../../../src/actions/dev/startDevServerRegistration.ts"],"sourcesContent":["import {type CliConfig, getCliConfigUncached, type Output} from '@sanity/cli-core'\nimport {type ViteDevServer} from 'vite'\n\nimport {applicationReference} from '../../applicationReference.js'\nimport {isWorkbenchApp, isWorkbenchConfig} from '../../defineApp.js'\nimport {deriveInterfaces} from '../../deriveInterfaces.js'\nimport {resolveWorkbenchConfig} from '../../resolveWorkbenchConfig.js'\nimport {formatWorkbenchAppErrors, validateWorkbenchApp} from '../../validateWorkbenchApp.js'\nimport {deriveConfigs} from './deriveConfigs.js'\nimport {trackExposesSet} from './exposesSetId.js'\nimport {type DevServerManifest, getRegisteredServers, registerDevServer} from './registry.js'\nimport {startDevManifestWatcher} from './startDevManifestWatcher.js'\n\ninterface DevServerRegistrationOptions {\n  cliConfig: CliConfig\n  /**\n   * Extract the project manifest to inline into the registry. The caller owns the\n   * studio-vs-app split (manifest formats are CLI-domain); registration re-derives\n   * the interface set alongside it.\n   */\n  extractManifest: (params: {\n    configPath: string\n    workDir: string\n  }) => Promise<DevServerManifest['manifest']>\n  isApp: boolean\n  output: Output\n  server: ViteDevServer\n  workDir: string\n\n  /**\n   * Rebuild the app's federation remote when its interface set changes, awaited\n   * *before* the registry patch — the patch reloads the workbench page, which must\n   * re-fetch a remote that already exposes the new interface. Resolves with the\n   * recreated server so the entry gets its actual address (non-strict ports may\n   * shift it); must reject if the restart produces no server, so the set stays\n   * uncommitted and the next save retries instead of advertising a dead port.\n   */\n  onInterfaceSetChange?: () => Promise<ViteDevServer>\n}\n\ninterface DevServerRegistrationHandle {\n  close: () => Promise<void>\n}\n\n/**\n * Log any app validation errors without aborting. Unlike build and deploy, dev\n * stays up on an invalid app so the author sees the errors and fixes them live on\n * the next save. A config is not an app — it isn't validated by the app schema\n * (which would spuriously demand a slug/title), so skip it here.\n */\nfunction reportConfigErrors(app: CliConfig['app'], output: Output): void {\n  if (isWorkbenchConfig(app)) return\n  const errors = validateWorkbenchApp(app)\n  if (errors.length === 0) return\n  output.warn(formatWorkbenchAppErrors(errors))\n}\n\n/** The address the server actually bound — the live socket, which can differ from the configured port under non-strict ports. */\nfunction serverAddress(server: ViteDevServer) {\n  const resolvedHost = server.config.server.host\n  const addr = server.httpServer?.address()\n  return {\n    host: typeof resolvedHost === 'string' ? resolvedHost : 'localhost',\n    port: typeof addr === 'object' && addr ? addr.port : server.config.server.port,\n  }\n}\n\n/**\n * Register the dev server in the registry and watch its config for manifest +\n * interface changes. The workbench reads the entry to locate and render the\n * server; the watcher keeps it current as `sanity.cli.ts` is edited.\n */\nexport async function startDevServerRegistration(\n  options: DevServerRegistrationOptions,\n): Promise<DevServerRegistrationHandle> {\n  const {cliConfig, extractManifest, isApp, onInterfaceSetChange, output, server, workDir} = options\n\n  const {host: appHost, port: appPort} = serverAddress(server)\n\n  reportConfigErrors(cliConfig.app, output)\n\n  // Forwarded alongside (not inside) the manifest so the workbench renders local\n  // panels/workers and reads the configs without a deploy.\n  const interfaces = deriveInterfaces(cliConfig.app, {isApp})\n  const configs = await deriveConfigs(cliConfig)\n\n  const workbenchApp = isWorkbenchApp(cliConfig.app) ? cliConfig.app : undefined\n  const config = resolveWorkbenchConfig(cliConfig)\n  // A config runs alongside the app it configures, so give it its own id\n  // namespace — sharing the app's slug would make the two indistinguishable here.\n  const id = config ? `config:${config.appType}` : workbenchApp?.slug\n  // Identity is resolved and the reference composed here, so the workbench reads\n  // both off the registry entry instead of recomposing them. Name defaults to the\n  // slug, mirroring brett.\n  const name = workbenchApp?.name ?? workbenchApp?.slug\n  const reference =\n    workbenchApp && name\n      ? // No workbench app is a singleton now that the only one (the Media Library)\n        // is a config, not an app — so its reference is always `<org>/<name>`.\n        applicationReference({\n          isSingleton: false,\n          name,\n          organizationId: workbenchApp.organizationId,\n        })\n      : undefined\n\n  // Separate namespaces mean a shared id is a genuine duplicate, so the gate is\n  // a plain id match — no config-vs-app role left to reconcile.\n  const devServer = id ? getRegisteredServers().find((server) => server.id === id) : undefined\n\n  if (id && devServer) {\n    output.error(\n      `\"${id}\" is already served by another dev server running on port ${devServer.port}, ` +\n        \"so the workbench can't tell them apart and this one stays out of it. Stop that server first.\",\n      {exit: false},\n    )\n    return {close: async () => {}}\n  }\n\n  const registration = registerDevServer({\n    configs,\n    host: appHost,\n    id,\n    interfaces,\n    name,\n    port: appPort,\n    projectId: cliConfig?.api?.projectId,\n    reference,\n    type: isApp ? 'coreApp' : 'studio',\n    workDir,\n  })\n\n  const exposesSet = trackExposesSet({configs, interfaces})\n\n  const watcher = await startDevManifestWatcher({\n    // Re-derive every pass (don't omit): the registry patch is a shallow merge,\n    // so omitting would wipe the registered set.\n    extract: async (params) => {\n      const nextConfig = await getCliConfigUncached(params.workDir)\n      reportConfigErrors(nextConfig.app, output)\n      return {\n        configs: await deriveConfigs(nextConfig),\n        interfaces: deriveInterfaces(nextConfig.app, {isApp}),\n        manifest: await extractManifest(params),\n      }\n    },\n    // A studio's root resolves to `sanity.config.*` but its interfaces live in\n    // `sanity.cli.*` — watch that too. Apps already root at `sanity.cli.*`.\n    extraWatchFilenames: isApp ? undefined : ['sanity.cli.js', 'sanity.cli.ts'],\n    output,\n    update: async (patch) => {\n      if (\n        !exposesSet.changed({\n          configs: patch.configs,\n          interfaces: patch.interfaces,\n        })\n      ) {\n        registration.update(patch)\n        return\n      }\n      // Rebuild the remote *before* patching the registry — the patch reloads the\n      // page, which must re-fetch a remote that already exposes the new interface.\n      const rebuiltServer = await onInterfaceSetChange?.()\n      // Commit only after a successful rebuild, so a thrown one retries next pass.\n      exposesSet.commit({\n        configs: patch.configs,\n        interfaces: patch.interfaces,\n      })\n      // The recreated server can bind a different port (non-strict ports).\n      registration.update(rebuiltServer ? {...patch, ...serverAddress(rebuiltServer)} : patch)\n    },\n    workDir,\n  })\n\n  return {\n    close: async () => {\n      registration.release()\n      await watcher.close()\n    },\n  }\n}\n"],"names":["getCliConfigUncached","applicationReference","isWorkbenchApp","isWorkbenchConfig","deriveInterfaces","resolveWorkbenchConfig","formatWorkbenchAppErrors","validateWorkbenchApp","deriveConfigs","trackExposesSet","getRegisteredServers","registerDevServer","startDevManifestWatcher","reportConfigErrors","app","output","errors","length","warn","serverAddress","server","resolvedHost","config","host","addr","httpServer","address","port","startDevServerRegistration","options","cliConfig","extractManifest","isApp","onInterfaceSetChange","workDir","appHost","appPort","interfaces","configs","workbenchApp","undefined","id","appType","slug","name","reference","isSingleton","organizationId","devServer","find","error","exit","close","registration","projectId","api","type","exposesSet","watcher","extract","params","nextConfig","manifest","extraWatchFilenames","update","patch","changed","rebuiltServer","commit","release"],"mappings":"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"}

package/dist/actions/dev/startWorkbenchDevServer.js

@@ -1,4 +1,5 @@
-import { resolveLocalPackage, subdebug } from '@sanity/cli-core';
+import { fileURLToPath } from 'node:url';
+import { subdebug } from '@sanity/cli-core';
 import { isStaging } from '@sanity/cli-core/util';
 import viteReact from '@vitejs/plugin-react';
 import { createServer } from 'vite';
@@ -8,6 +9,8 @@ import { createExposesTracker } from './exposesSetId.js';
 import { acquireWorkbenchLock, getRegisteredServers, isConfigOnlyServer, readWorkbenchLock, watchRegistry } from './registry.js';
 import { writeWorkbenchRuntime } from './writeWorkbenchRuntime.js';
 const devDebug = subdebug('dev');
+const renderDashboardEntry = '@sanity/workbench-cli/_internal_render';
+const renderDashboardPath = fileURLToPath(new URL('../../_exports/_internal_render.js', import.meta.url));
 const noop = async ()=>{};
 // Every server is a local app except a config-only one — a config
 // with no interfaces (the media library). A server with both lands in both channels.
@@ -78,14 +81,9 @@ const toApplicationsPayload = (servers)=>({
         }
     };
 }
-/**
- * Start the workbench dev server when federation is enabled and the workbench
- * package is available. If the desired port is already taken — by another
- * workbench instance or an unrelated process — fall back to running without a
- * workbench and let the app/studio dev server claim the configured port.
- */ export async function startWorkbenchDevServer(options) {
+export async function startWorkbenchDevServer(options) {
     const { cacheDir, cliConfig, httpHost, httpPort: workbenchPort, mode, output, reactStrictMode, workDir } = options;
-    // Workbench is opted into solely by calling `unstable_defineApp`.
+    // Workbench is opted into solely by calling `defineApplication`.
     if (!isWorkbenchApp(cliConfig?.app)) {
         devDebug('Not a workbench app, skipping workbench dev server');
         return {
@@ -95,21 +93,6 @@ const toApplicationsPayload = (servers)=>({
             workbenchPort
         };
     }
-    let workbenchAvailable = false;
-    try {
-        await resolveLocalPackage('sanity/workbench', workDir);
-        workbenchAvailable = true;
-    } catch  {
-        devDebug('Workbench not available, skipping workbench dev server');
-    }
-    if (!workbenchAvailable) {
-        return {
-            close: noop,
-            httpHost,
-            workbenchAvailable,
-            workbenchPort
-        };
-    }
     // Acquire an exclusive lock — only one workbench per machine.
     // Uses O_EXCL which is atomic at the OS level, preventing races when
     // multiple `sanity dev` processes start simultaneously (e.g. via turbo).
@@ -163,7 +146,7 @@ const toApplicationsPayload = (servers)=>({
             await close();
         },
         httpHost,
-        workbenchAvailable,
+        workbenchAvailable: true,
         workbenchPort: actualPort
     };
 }
@@ -192,14 +175,9 @@ async function createWorkbenchViteServer(options) {
         logLevel: 'warn',
         mode: 'development',
         optimizeDeps: {
-            // Exclude sanity/workbench (and its transitive dep @sanity/workbench)
-            // from dep pre-bundling so that `import.meta.hot` is available at
-            // runtime — pre-bundled modules do not receive Vite's HMR client
-            // injection, which causes the custom HMR events for local application
-            // discovery to silently not fire.
+            // Keep this entry out of pre-bundling so Vite injects its HMR context.
             exclude: [
-                'sanity',
-                '@sanity/workbench'
+                renderDashboardEntry
             ]
         },
         // viteReact looks inert here — it transforms none of the host's own modules —
@@ -216,6 +194,10 @@ async function createWorkbenchViteServer(options) {
             ] : []
         ],
         resolve: {
+            // The generated Vite root cannot reliably resolve this package.
+            alias: {
+                [renderDashboardEntry]: renderDashboardPath
+            },
             dedupe: [
                 'react',
                 'react-dom'
@@ -260,7 +242,7 @@ async function createWorkbenchViteServer(options) {
         }
     };
 }
-// Workbench is opted into via `unstable_defineApp`, which carries the
+// Workbench is opted into via `defineApplication`, which carries the
 // organization ID. Deliberately no fallback (e.g. resolving it from the
 // configured project): the lookup would need an authenticated user and an
 // API round-trip on every startup for something the opt-in already declares.
@@ -268,7 +250,7 @@ const resolveOrganizationId = (cliConfig)=>{
     if (cliConfig.app?.organizationId) {
         return cliConfig.app.organizationId;
     }
-    throw new Error('Workbench requires an organization ID. Pass "organizationId" to unstable_defineApp() in sanity.cli.ts.');
+    throw new Error('Workbench requires an organization ID. Pass "organizationId" to defineApplication() in sanity.cli.ts.');
 };
 // Restricts protocol to http(s) so the URL is safe to interpolate into HTML
 // attributes and Link headers downstream.

package/dist/actions/dev/startWorkbenchDevServer.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/dev/startWorkbenchDevServer.ts"],"sourcesContent":["import {type CliConfig, type Output, resolveLocalPackage, subdebug} from '@sanity/cli-core'\nimport {isStaging} from '@sanity/cli-core/util'\nimport viteReact from '@vitejs/plugin-react'\nimport {createServer, type InlineConfig, type Plugin, type ViteDevServer} from 'vite'\nimport {z} from 'zod/mini'\n\nimport {isWorkbenchApp} from '../../defineApp.js'\nimport {createExposesTracker} from './exposesSetId.js'\nimport {\n  acquireWorkbenchLock,\n  type DevServerManifest,\n  getRegisteredServers,\n  isConfigOnlyServer,\n  readWorkbenchLock,\n  watchRegistry,\n} from './registry.js'\nimport {writeWorkbenchRuntime} from './writeWorkbenchRuntime.js'\n\nconst devDebug = subdebug('dev')\n\nconst noop = async () => {}\n\n// Every server is a local app except a config-only one — a config\n// with no interfaces (the media library). A server with both lands in both channels.\nconst isLocalApp = (server: DevServerManifest): boolean => !isConfigOnlyServer(server)\n\nconst toApplicationsPayload = (servers: DevServerManifest[]) => ({\n  applications: servers\n    .filter((server) => isLocalApp(server))\n    .map(({host, id, interfaces, manifest, port, projectId, type}) => ({\n      host,\n      id,\n      interfaces,\n      manifest,\n      port,\n      projectId,\n      type,\n    })),\n  configs: servers.flatMap(({configs, host, port}) =>\n    // The registry stores the config flat; the workbench wire shape nests the\n    // type-specific payload (`fields` for a media library) under `config`, keyed\n    // by the `appType` discriminator.\n    (configs ?? []).map(({appType, id, moduleName, version, ...config}) => ({\n      appType,\n      config,\n      id,\n      moduleName,\n      remoteURL: `http://${host}:${port}`,\n      version,\n    })),\n  ),\n})\n\n/**\n * Bridge the dev-server registry into a workbench Vite server's HMR channel so\n * the page tracks apps as they come and go. A changed interface set means a\n * rebuilt remote — full-reload to drop the stale remote-entry; otherwise\n * rebroadcast for a soft reconcile. Returns a detach fn.\n */\nfunction attachViteDevServerBridge(server: ViteDevServer): () => void {\n  server.ws.on('sanity:workbench:get-local-applications', (_, client) => {\n    client.send(\n      'sanity:workbench:local-applications',\n      toApplicationsPayload(getRegisteredServers()),\n    )\n  })\n\n  const setTracker = createExposesTracker()\n  const registryWatcher = watchRegistry((servers) => {\n    if (setTracker.hasChanged(servers)) {\n      server.ws.send({type: 'full-reload'})\n      return\n    }\n    server.ws.send('sanity:workbench:local-applications', toApplicationsPayload(servers))\n  })\n\n  return () => registryWatcher.close()\n}\n\n/**\n * Make the workbench remote act as the machine's workbench: claim the singleton\n * lock so app `sanity dev`s register into it instead of each starting their own,\n * and bridge the registry so the remote shows the local apps. No-op lock if one\n * is already held.\n */\nexport function startWorkbenchRemoteCoordinator(options: {\n  httpHost: string | undefined\n  port: number\n  server: ViteDevServer\n}): {close: () => Promise<void>} {\n  const {httpHost, port, server} = options\n\n  const lock = acquireWorkbenchLock({host: httpHost || 'localhost', port})\n  if (!lock) {\n    const existing = readWorkbenchLock()\n    devDebug(\n      'Workbench lock already held by pid %d on port %d; bridging the registry without claiming it',\n      existing?.pid,\n      existing?.port,\n    )\n  }\n\n  const detachBridge = attachViteDevServerBridge(server)\n\n  return {\n    close: async () => {\n      detachBridge()\n      lock?.release()\n    },\n  }\n}\n\ninterface WorkbenchDevServerResult {\n  close: () => Promise<void>\n  httpHost: string | undefined\n  workbenchAvailable: boolean\n  workbenchPort: number\n}\n\nexport interface StartWorkbenchOptions {\n  /** Dependency-cache dir for the workbench Vite server, kept apart from the user's own. */\n  cacheDir: string\n  cliConfig: CliConfig\n  httpHost: string | undefined\n  httpPort: number\n  /** `dev` renders a live app and honors a local workbench-UI override; `preview`\n   * (`sanity start`) previews a build and loads the deployed workbench UI. */\n  mode: 'development' | 'preview'\n  output: Output\n  /** Wrap the workbench in React StrictMode; the CLI resolves it (unset collapses to `false`). */\n  reactStrictMode: boolean\n  workDir: string\n}\n\n/**\n * Start the workbench dev server when federation is enabled and the workbench\n * package is available. If the desired port is already taken — by another\n * workbench instance or an unrelated process — fall back to running without a\n * workbench and let the app/studio dev server claim the configured port.\n */\nexport async function startWorkbenchDevServer(\n  options: StartWorkbenchOptions,\n): Promise<WorkbenchDevServerResult> {\n  const {\n    cacheDir,\n    cliConfig,\n    httpHost,\n    httpPort: workbenchPort,\n    mode,\n    output,\n    reactStrictMode,\n    workDir,\n  } = options\n\n  // Workbench is opted into solely by calling `unstable_defineApp`.\n  if (!isWorkbenchApp(cliConfig?.app)) {\n    devDebug('Not a workbench app, skipping workbench dev server')\n    return {close: noop, httpHost, workbenchAvailable: false, workbenchPort}\n  }\n\n  let workbenchAvailable = false\n\n  try {\n    await resolveLocalPackage('sanity/workbench', workDir)\n    workbenchAvailable = true\n  } catch {\n    devDebug('Workbench not available, skipping workbench dev server')\n  }\n\n  if (!workbenchAvailable) {\n    return {close: noop, httpHost, workbenchAvailable, workbenchPort}\n  }\n\n  // Acquire an exclusive lock — only one workbench per machine.\n  // Uses O_EXCL which is atomic at the OS level, preventing races when\n  // multiple `sanity dev` processes start simultaneously (e.g. via turbo).\n  const workbenchLock = acquireWorkbenchLock({host: httpHost || 'localhost', port: workbenchPort})\n  if (!workbenchLock) {\n    const existing = readWorkbenchLock()\n    devDebug(\n      'Workbench already running at pid %d on port %d, skipping',\n      existing?.pid,\n      existing?.port,\n    )\n    return {\n      close: noop,\n      httpHost: existing?.host ?? httpHost,\n      workbenchAvailable: true,\n      workbenchPort: existing?.port ?? workbenchPort,\n    }\n  }\n\n  // The lock is already held; an exception here (runtime-file write failure,\n  // invalid remote URL) would otherwise leak it until the next acquire prunes\n  // the stale PID.\n  let result: Awaited<ReturnType<typeof createWorkbenchViteServer>>\n  try {\n    result = await createWorkbenchViteServer({\n      cacheDir,\n      cliConfig,\n      httpHost,\n      mode,\n      output,\n      reactStrictMode,\n      workbenchPort,\n      workDir,\n    })\n  } catch (err) {\n    workbenchLock.release()\n    throw err\n  }\n\n  if (!result) {\n    workbenchLock.release()\n    return {close: noop, httpHost, workbenchAvailable: false, workbenchPort}\n  }\n\n  const {actualPort, close} = result\n  workbenchLock.updatePort(actualPort)\n\n  return {\n    close: async () => {\n      workbenchLock.release()\n      await close()\n    },\n    httpHost,\n    workbenchAvailable,\n    workbenchPort: actualPort,\n  }\n}\n\ninterface CreateWorkbenchViteServerOptions {\n  cacheDir: string\n  cliConfig: CliConfig\n  httpHost: string | undefined\n  mode: 'development' | 'preview'\n  output: Output\n  reactStrictMode: boolean\n  workbenchPort: number\n  workDir: string\n}\n\ninterface CreateWorkbenchViteServerResult {\n  actualPort: number\n  close: () => Promise<void>\n}\n\nasync function createWorkbenchViteServer(\n  options: CreateWorkbenchViteServerOptions,\n): Promise<CreateWorkbenchViteServerResult | undefined> {\n  const {cacheDir, cliConfig, httpHost, mode, output, reactStrictMode, workbenchPort, workDir} =\n    options\n\n  // `preview` loads `.env.development` (the env hook treats only `build`/`deploy`\n  // as production), which points the workbench UI at a local dev server that\n  // isn't running here. Ignore the override and load the deployed UI instead.\n  const remoteUrl =\n    mode === 'preview'\n      ? undefined\n      : parseRemoteUrl(process.env.SANITY_INTERNAL_WORKBENCH_REMOTE_URL)\n\n  const organizationId = resolveOrganizationId(cliConfig)\n\n  devDebug('Writing workbench runtime files')\n  const root = await writeWorkbenchRuntime({\n    cwd: workDir,\n    organizationId,\n    reactStrictMode,\n    remoteUrl,\n  })\n\n  const viteConfig: InlineConfig = {\n    // Custom cache directory so sanity's vite cache doesn't conflict with local vite projects\n    cacheDir,\n    configFile: false,\n    define: {\n      __SANITY_STAGING__: isStaging(),\n      'import.meta.env.SANITY_INTERNAL_WORKBENCH_REMOTE_URL': JSON.stringify(remoteUrl),\n    },\n    logLevel: 'warn',\n    mode: 'development',\n    optimizeDeps: {\n      // Exclude sanity/workbench (and its transitive dep @sanity/workbench)\n      // from dep pre-bundling so that `import.meta.hot` is available at\n      // runtime — pre-bundled modules do not receive Vite's HMR client\n      // injection, which causes the custom HMR events for local application\n      // discovery to silently not fire.\n      exclude: ['sanity', '@sanity/workbench'],\n    },\n    // viteReact looks inert here — it transforms none of the host's own modules —\n    // but it's load-bearing for the remotes. It serves the Fast Refresh runtime at\n    // /@react-refresh and injects the preamble that defines window.$RefreshReg$. The\n    // federated remotes loaded into this page are react-refresh transformed, so\n    // without the preamble they throw \"can't detect preamble\", and without the\n    // runtime their /@react-refresh import (wired by @module-federation/vite's\n    // remoteHmr) fails. Dropping it as dead code broke every panel; see #1262.\n    plugins: [viteReact(), ...(remoteUrl ? [remoteManifestPreloadHeaderPlugin(remoteUrl)] : [])],\n    resolve: {dedupe: ['react', 'react-dom']},\n    root,\n    server: {\n      host: httpHost,\n      port: workbenchPort,\n      strictPort: false,\n      warmup: {\n        clientFiles: ['./workbench.js'],\n      },\n    },\n  }\n\n  devDebug('Creating workbench vite server')\n  const server = await createServer(viteConfig)\n  try {\n    await server.listen()\n  } catch (err) {\n    await server.close()\n    output.warn(\n      `Workbench dev server failed to start: ${err instanceof Error ? err.message : String(err)}`,\n    )\n    return undefined\n  }\n\n  // Vite may have picked a different port if the desired one was occupied\n  const addr = server.httpServer?.address()\n  const actualPort = typeof addr === 'object' && addr ? addr.port : workbenchPort\n\n  // Fire-and-forget: warm the workbench remote's Vite transform pipeline so\n  // the first browser request hits a pre-populated module graph.\n  if (remoteUrl) {\n    fetch(remoteUrl)\n      .then((r) => r.body?.cancel())\n      .catch(() => {})\n    devDebug('Warming workbench remote at %s', remoteUrl)\n  }\n\n  const detachBridge = attachViteDevServerBridge(server)\n\n  return {\n    actualPort,\n    close: async () => {\n      detachBridge()\n      await server.close()\n    },\n  }\n}\n\n// Workbench is opted into via `unstable_defineApp`, which carries the\n// organization ID. Deliberately no fallback (e.g. resolving it from the\n// configured project): the lookup would need an authenticated user and an\n// API round-trip on every startup for something the opt-in already declares.\nconst resolveOrganizationId = (cliConfig: CliConfig): string => {\n  if (cliConfig.app?.organizationId) {\n    return cliConfig.app.organizationId\n  }\n\n  throw new Error(\n    'Workbench requires an organization ID. Pass \"organizationId\" to unstable_defineApp() in sanity.cli.ts.',\n  )\n}\n\n// Restricts protocol to http(s) so the URL is safe to interpolate into HTML\n// attributes and Link headers downstream.\nconst remoteUrlSchema = z.url({normalize: true, protocol: /^https?$/})\n\nfunction parseRemoteUrl(value: string | undefined): string | undefined {\n  if (!value) return undefined\n\n  const result = remoteUrlSchema.safeParse(value)\n\n  if (!result.success) {\n    throw new Error(\n      `Invalid SANITY_INTERNAL_WORKBENCH_REMOTE_URL: ${value} (must be an http(s) URL)`,\n    )\n  }\n\n  return result.data\n}\n\n/**\n * Sets a `Link: <remoteUrl>; rel=preload; as=fetch; crossorigin` response header\n * on the index document so the browser can start fetching the Module Federation\n * manifest as soon as response headers arrive — before HTML parsing reaches the\n * in-head preconnect hint. `as=fetch` matches how the federation runtime later\n * retrieves the JSON manifest, allowing the preload entry to satisfy that fetch.\n */\nfunction remoteManifestPreloadHeaderPlugin(remoteUrl: string): Plugin {\n  return {\n    apply: 'serve',\n    configureServer(server) {\n      server.middlewares.use((req, res, next) => {\n        const pathname = (req.url || '/').split('?')[0]\n        if (pathname === '/' || pathname === '/index.html') {\n          res.setHeader('Link', `<${remoteUrl}>; rel=preload; as=fetch; crossorigin`)\n        }\n        next()\n      })\n    },\n    name: 'sanity:workbench-remote-preload-header',\n  }\n}\n"],"names":["resolveLocalPackage","subdebug","isStaging","viteReact","createServer","z","isWorkbenchApp","createExposesTracker","acquireWorkbenchLock","getRegisteredServers","isConfigOnlyServer","readWorkbenchLock","watchRegistry","writeWorkbenchRuntime","devDebug","noop","isLocalApp","server","toApplicationsPayload","servers","applications","filter","map","host","id","interfaces","manifest","port","projectId","type","configs","flatMap","appType","moduleName","version","config","remoteURL","attachViteDevServerBridge","ws","on","_","client","send","setTracker","registryWatcher","hasChanged","close","startWorkbenchRemoteCoordinator","options","httpHost","lock","existing","pid","detachBridge","release","startWorkbenchDevServer","cacheDir","cliConfig","httpPort","workbenchPort","mode","output","reactStrictMode","workDir","app","workbenchAvailable","workbenchLock","result","createWorkbenchViteServer","err","actualPort","updatePort","remoteUrl","undefined","parseRemoteUrl","process","env","SANITY_INTERNAL_WORKBENCH_REMOTE_URL","organizationId","resolveOrganizationId","root","cwd","viteConfig","configFile","define","__SANITY_STAGING__","JSON","stringify","logLevel","optimizeDeps","exclude","plugins","remoteManifestPreloadHeaderPlugin","resolve","dedupe","strictPort","warmup","clientFiles","listen","warn","Error","message","String","addr","httpServer","address","fetch","then","r","body","cancel","catch","remoteUrlSchema","url","normalize","protocol","value","safeParse","success","data","apply","configureServer","middlewares","use","req","res","next","pathname","split","setHeader","name"],"mappings":"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"}
+{"version":3,"sources":["../../../src/actions/dev/startWorkbenchDevServer.ts"],"sourcesContent":["import {fileURLToPath} from 'node:url'\n\nimport {type CliConfig, type Output, subdebug} from '@sanity/cli-core'\nimport {isStaging} from '@sanity/cli-core/util'\nimport viteReact from '@vitejs/plugin-react'\nimport {createServer, type InlineConfig, type Plugin, type ViteDevServer} from 'vite'\nimport {z} from 'zod/mini'\n\nimport {isWorkbenchApp} from '../../defineApp.js'\nimport {createExposesTracker} from './exposesSetId.js'\nimport {\n  acquireWorkbenchLock,\n  type DevServerManifest,\n  getRegisteredServers,\n  isConfigOnlyServer,\n  readWorkbenchLock,\n  watchRegistry,\n} from './registry.js'\nimport {writeWorkbenchRuntime} from './writeWorkbenchRuntime.js'\n\nconst devDebug = subdebug('dev')\nconst renderDashboardEntry = '@sanity/workbench-cli/_internal_render'\nconst renderDashboardPath = fileURLToPath(\n  new URL('../../_exports/_internal_render.js', import.meta.url),\n)\n\nconst noop = async () => {}\n\n// Every server is a local app except a config-only one — a config\n// with no interfaces (the media library). A server with both lands in both channels.\nconst isLocalApp = (server: DevServerManifest): boolean => !isConfigOnlyServer(server)\n\nconst toApplicationsPayload = (servers: DevServerManifest[]) => ({\n  applications: servers\n    .filter((server) => isLocalApp(server))\n    .map(({host, id, interfaces, manifest, port, projectId, type}) => ({\n      host,\n      id,\n      interfaces,\n      manifest,\n      port,\n      projectId,\n      type,\n    })),\n  configs: servers.flatMap(({configs, host, port}) =>\n    // The registry stores the config flat; the workbench wire shape nests the\n    // type-specific payload (`fields` for a media library) under `config`, keyed\n    // by the `appType` discriminator.\n    (configs ?? []).map(({appType, id, moduleName, version, ...config}) => ({\n      appType,\n      config,\n      id,\n      moduleName,\n      remoteURL: `http://${host}:${port}`,\n      version,\n    })),\n  ),\n})\n\n/**\n * Bridge the dev-server registry into a workbench Vite server's HMR channel so\n * the page tracks apps as they come and go. A changed interface set means a\n * rebuilt remote — full-reload to drop the stale remote-entry; otherwise\n * rebroadcast for a soft reconcile. Returns a detach fn.\n */\nfunction attachViteDevServerBridge(server: ViteDevServer): () => void {\n  server.ws.on('sanity:workbench:get-local-applications', (_, client) => {\n    client.send(\n      'sanity:workbench:local-applications',\n      toApplicationsPayload(getRegisteredServers()),\n    )\n  })\n\n  const setTracker = createExposesTracker()\n  const registryWatcher = watchRegistry((servers) => {\n    if (setTracker.hasChanged(servers)) {\n      server.ws.send({type: 'full-reload'})\n      return\n    }\n    server.ws.send('sanity:workbench:local-applications', toApplicationsPayload(servers))\n  })\n\n  return () => registryWatcher.close()\n}\n\n/**\n * Make the workbench remote act as the machine's workbench: claim the singleton\n * lock so app `sanity dev`s register into it instead of each starting their own,\n * and bridge the registry so the remote shows the local apps. No-op lock if one\n * is already held.\n */\nexport function startWorkbenchRemoteCoordinator(options: {\n  httpHost: string | undefined\n  port: number\n  server: ViteDevServer\n}): {close: () => Promise<void>} {\n  const {httpHost, port, server} = options\n\n  const lock = acquireWorkbenchLock({host: httpHost || 'localhost', port})\n  if (!lock) {\n    const existing = readWorkbenchLock()\n    devDebug(\n      'Workbench lock already held by pid %d on port %d; bridging the registry without claiming it',\n      existing?.pid,\n      existing?.port,\n    )\n  }\n\n  const detachBridge = attachViteDevServerBridge(server)\n\n  return {\n    close: async () => {\n      detachBridge()\n      lock?.release()\n    },\n  }\n}\n\ninterface WorkbenchDevServerResult {\n  close: () => Promise<void>\n  httpHost: string | undefined\n  workbenchAvailable: boolean\n  workbenchPort: number\n}\n\nexport interface StartWorkbenchOptions {\n  /** Dependency-cache dir for the workbench Vite server, kept apart from the user's own. */\n  cacheDir: string\n  cliConfig: CliConfig\n  httpHost: string | undefined\n  httpPort: number\n  /** `dev` renders a live app and honors a local workbench-UI override; `preview`\n   * (`sanity start`) previews a build and loads the deployed workbench UI. */\n  mode: 'development' | 'preview'\n  output: Output\n  /** Wrap the workbench in React StrictMode; the CLI resolves it (unset collapses to `false`). */\n  reactStrictMode: boolean\n  workDir: string\n}\n\nexport async function startWorkbenchDevServer(\n  options: StartWorkbenchOptions,\n): Promise<WorkbenchDevServerResult> {\n  const {\n    cacheDir,\n    cliConfig,\n    httpHost,\n    httpPort: workbenchPort,\n    mode,\n    output,\n    reactStrictMode,\n    workDir,\n  } = options\n\n  // Workbench is opted into solely by calling `defineApplication`.\n  if (!isWorkbenchApp(cliConfig?.app)) {\n    devDebug('Not a workbench app, skipping workbench dev server')\n    return {close: noop, httpHost, workbenchAvailable: false, workbenchPort}\n  }\n\n  // Acquire an exclusive lock — only one workbench per machine.\n  // Uses O_EXCL which is atomic at the OS level, preventing races when\n  // multiple `sanity dev` processes start simultaneously (e.g. via turbo).\n  const workbenchLock = acquireWorkbenchLock({host: httpHost || 'localhost', port: workbenchPort})\n  if (!workbenchLock) {\n    const existing = readWorkbenchLock()\n    devDebug(\n      'Workbench already running at pid %d on port %d, skipping',\n      existing?.pid,\n      existing?.port,\n    )\n    return {\n      close: noop,\n      httpHost: existing?.host ?? httpHost,\n      workbenchAvailable: true,\n      workbenchPort: existing?.port ?? workbenchPort,\n    }\n  }\n\n  // The lock is already held; an exception here (runtime-file write failure,\n  // invalid remote URL) would otherwise leak it until the next acquire prunes\n  // the stale PID.\n  let result: Awaited<ReturnType<typeof createWorkbenchViteServer>>\n  try {\n    result = await createWorkbenchViteServer({\n      cacheDir,\n      cliConfig,\n      httpHost,\n      mode,\n      output,\n      reactStrictMode,\n      workbenchPort,\n      workDir,\n    })\n  } catch (err) {\n    workbenchLock.release()\n    throw err\n  }\n\n  if (!result) {\n    workbenchLock.release()\n    return {close: noop, httpHost, workbenchAvailable: false, workbenchPort}\n  }\n\n  const {actualPort, close} = result\n  workbenchLock.updatePort(actualPort)\n\n  return {\n    close: async () => {\n      workbenchLock.release()\n      await close()\n    },\n    httpHost,\n    workbenchAvailable: true,\n    workbenchPort: actualPort,\n  }\n}\n\ninterface CreateWorkbenchViteServerOptions {\n  cacheDir: string\n  cliConfig: CliConfig\n  httpHost: string | undefined\n  mode: 'development' | 'preview'\n  output: Output\n  reactStrictMode: boolean\n  workbenchPort: number\n  workDir: string\n}\n\ninterface CreateWorkbenchViteServerResult {\n  actualPort: number\n  close: () => Promise<void>\n}\n\nasync function createWorkbenchViteServer(\n  options: CreateWorkbenchViteServerOptions,\n): Promise<CreateWorkbenchViteServerResult | undefined> {\n  const {cacheDir, cliConfig, httpHost, mode, output, reactStrictMode, workbenchPort, workDir} =\n    options\n\n  // `preview` loads `.env.development` (the env hook treats only `build`/`deploy`\n  // as production), which points the workbench UI at a local dev server that\n  // isn't running here. Ignore the override and load the deployed UI instead.\n  const remoteUrl =\n    mode === 'preview'\n      ? undefined\n      : parseRemoteUrl(process.env.SANITY_INTERNAL_WORKBENCH_REMOTE_URL)\n\n  const organizationId = resolveOrganizationId(cliConfig)\n\n  devDebug('Writing workbench runtime files')\n  const root = await writeWorkbenchRuntime({\n    cwd: workDir,\n    organizationId,\n    reactStrictMode,\n    remoteUrl,\n  })\n\n  const viteConfig: InlineConfig = {\n    // Custom cache directory so sanity's vite cache doesn't conflict with local vite projects\n    cacheDir,\n    configFile: false,\n    define: {\n      __SANITY_STAGING__: isStaging(),\n      'import.meta.env.SANITY_INTERNAL_WORKBENCH_REMOTE_URL': JSON.stringify(remoteUrl),\n    },\n    logLevel: 'warn',\n    mode: 'development',\n    optimizeDeps: {\n      // Keep this entry out of pre-bundling so Vite injects its HMR context.\n      exclude: [renderDashboardEntry],\n    },\n    // viteReact looks inert here — it transforms none of the host's own modules —\n    // but it's load-bearing for the remotes. It serves the Fast Refresh runtime at\n    // /@react-refresh and injects the preamble that defines window.$RefreshReg$. The\n    // federated remotes loaded into this page are react-refresh transformed, so\n    // without the preamble they throw \"can't detect preamble\", and without the\n    // runtime their /@react-refresh import (wired by @module-federation/vite's\n    // remoteHmr) fails. Dropping it as dead code broke every panel; see #1262.\n    plugins: [viteReact(), ...(remoteUrl ? [remoteManifestPreloadHeaderPlugin(remoteUrl)] : [])],\n    resolve: {\n      // The generated Vite root cannot reliably resolve this package.\n      alias: {[renderDashboardEntry]: renderDashboardPath},\n      dedupe: ['react', 'react-dom'],\n    },\n    root,\n    server: {\n      host: httpHost,\n      port: workbenchPort,\n      strictPort: false,\n      warmup: {\n        clientFiles: ['./workbench.js'],\n      },\n    },\n  }\n\n  devDebug('Creating workbench vite server')\n  const server = await createServer(viteConfig)\n  try {\n    await server.listen()\n  } catch (err) {\n    await server.close()\n    output.warn(\n      `Workbench dev server failed to start: ${err instanceof Error ? err.message : String(err)}`,\n    )\n    return undefined\n  }\n\n  // Vite may have picked a different port if the desired one was occupied\n  const addr = server.httpServer?.address()\n  const actualPort = typeof addr === 'object' && addr ? addr.port : workbenchPort\n\n  // Fire-and-forget: warm the workbench remote's Vite transform pipeline so\n  // the first browser request hits a pre-populated module graph.\n  if (remoteUrl) {\n    fetch(remoteUrl)\n      .then((r) => r.body?.cancel())\n      .catch(() => {})\n    devDebug('Warming workbench remote at %s', remoteUrl)\n  }\n\n  const detachBridge = attachViteDevServerBridge(server)\n\n  return {\n    actualPort,\n    close: async () => {\n      detachBridge()\n      await server.close()\n    },\n  }\n}\n\n// Workbench is opted into via `defineApplication`, which carries the\n// organization ID. Deliberately no fallback (e.g. resolving it from the\n// configured project): the lookup would need an authenticated user and an\n// API round-trip on every startup for something the opt-in already declares.\nconst resolveOrganizationId = (cliConfig: CliConfig): string => {\n  if (cliConfig.app?.organizationId) {\n    return cliConfig.app.organizationId\n  }\n\n  throw new Error(\n    'Workbench requires an organization ID. Pass \"organizationId\" to defineApplication() in sanity.cli.ts.',\n  )\n}\n\n// Restricts protocol to http(s) so the URL is safe to interpolate into HTML\n// attributes and Link headers downstream.\nconst remoteUrlSchema = z.url({normalize: true, protocol: /^https?$/})\n\nfunction parseRemoteUrl(value: string | undefined): string | undefined {\n  if (!value) return undefined\n\n  const result = remoteUrlSchema.safeParse(value)\n\n  if (!result.success) {\n    throw new Error(\n      `Invalid SANITY_INTERNAL_WORKBENCH_REMOTE_URL: ${value} (must be an http(s) URL)`,\n    )\n  }\n\n  return result.data\n}\n\n/**\n * Sets a `Link: <remoteUrl>; rel=preload; as=fetch; crossorigin` response header\n * on the index document so the browser can start fetching the Module Federation\n * manifest as soon as response headers arrive — before HTML parsing reaches the\n * in-head preconnect hint. `as=fetch` matches how the federation runtime later\n * retrieves the JSON manifest, allowing the preload entry to satisfy that fetch.\n */\nfunction remoteManifestPreloadHeaderPlugin(remoteUrl: string): Plugin {\n  return {\n    apply: 'serve',\n    configureServer(server) {\n      server.middlewares.use((req, res, next) => {\n        const pathname = (req.url || '/').split('?')[0]\n        if (pathname === '/' || pathname === '/index.html') {\n          res.setHeader('Link', `<${remoteUrl}>; rel=preload; as=fetch; crossorigin`)\n        }\n        next()\n      })\n    },\n    name: 'sanity:workbench-remote-preload-header',\n  }\n}\n"],"names":["fileURLToPath","subdebug","isStaging","viteReact","createServer","z","isWorkbenchApp","createExposesTracker","acquireWorkbenchLock","getRegisteredServers","isConfigOnlyServer","readWorkbenchLock","watchRegistry","writeWorkbenchRuntime","devDebug","renderDashboardEntry","renderDashboardPath","URL","url","noop","isLocalApp","server","toApplicationsPayload","servers","applications","filter","map","host","id","interfaces","manifest","port","projectId","type","configs","flatMap","appType","moduleName","version","config","remoteURL","attachViteDevServerBridge","ws","on","_","client","send","setTracker","registryWatcher","hasChanged","close","startWorkbenchRemoteCoordinator","options","httpHost","lock","existing","pid","detachBridge","release","startWorkbenchDevServer","cacheDir","cliConfig","httpPort","workbenchPort","mode","output","reactStrictMode","workDir","app","workbenchAvailable","workbenchLock","result","createWorkbenchViteServer","err","actualPort","updatePort","remoteUrl","undefined","parseRemoteUrl","process","env","SANITY_INTERNAL_WORKBENCH_REMOTE_URL","organizationId","resolveOrganizationId","root","cwd","viteConfig","configFile","define","__SANITY_STAGING__","JSON","stringify","logLevel","optimizeDeps","exclude","plugins","remoteManifestPreloadHeaderPlugin","resolve","alias","dedupe","strictPort","warmup","clientFiles","listen","warn","Error","message","String","addr","httpServer","address","fetch","then","r","body","cancel","catch","remoteUrlSchema","normalize","protocol","value","safeParse","success","data","apply","configureServer","middlewares","use","req","res","next","pathname","split","setHeader","name"],"mappings":"AAAA,SAAQA,aAAa,QAAO,WAAU;AAEtC,SAAqCC,QAAQ,QAAO,mBAAkB;AACtE,SAAQC,SAAS,QAAO,wBAAuB;AAC/C,OAAOC,eAAe,uBAAsB;AAC5C,SAAQC,YAAY,QAA2D,OAAM;AACrF,SAAQC,CAAC,QAAO,WAAU;AAE1B,SAAQC,cAAc,QAAO,qBAAoB;AACjD,SAAQC,oBAAoB,QAAO,oBAAmB;AACtD,SACEC,oBAAoB,EAEpBC,oBAAoB,EACpBC,kBAAkB,EAClBC,iBAAiB,EACjBC,aAAa,QACR,gBAAe;AACtB,SAAQC,qBAAqB,QAAO,6BAA4B;AAEhE,MAAMC,WAAWb,SAAS;AAC1B,MAAMc,uBAAuB;AAC7B,MAAMC,sBAAsBhB,cAC1B,IAAIiB,IAAI,sCAAsC,YAAYC,GAAG;AAG/D,MAAMC,OAAO,WAAa;AAE1B,kEAAkE;AAClE,qFAAqF;AACrF,MAAMC,aAAa,CAACC,SAAuC,CAACX,mBAAmBW;AAE/E,MAAMC,wBAAwB,CAACC,UAAkC,CAAA;QAC/DC,cAAcD,QACXE,MAAM,CAAC,CAACJ,SAAWD,WAAWC,SAC9BK,GAAG,CAAC,CAAC,EAACC,IAAI,EAAEC,EAAE,EAAEC,UAAU,EAAEC,QAAQ,EAAEC,IAAI,EAAEC,SAAS,EAAEC,IAAI,EAAC,GAAM,CAAA;gBACjEN;gBACAC;gBACAC;gBACAC;gBACAC;gBACAC;gBACAC;YACF,CAAA;QACFC,SAASX,QAAQY,OAAO,CAAC,CAAC,EAACD,OAAO,EAAEP,IAAI,EAAEI,IAAI,EAAC,GAI7C,AAHA,0EAA0E;YAC1E,6EAA6E;YAC7E,kCAAkC;YACjCG,CAAAA,WAAW,EAAE,AAAD,EAAGR,GAAG,CAAC,CAAC,EAACU,OAAO,EAAER,EAAE,EAAES,UAAU,EAAEC,OAAO,EAAE,GAAGC,QAAO,GAAM,CAAA;oBACtEH;oBACAG;oBACAX;oBACAS;oBACAG,WAAW,CAAC,OAAO,EAAEb,KAAK,CAAC,EAAEI,MAAM;oBACnCO;gBACF,CAAA;IAEJ,CAAA;AAEA;;;;;CAKC,GACD,SAASG,0BAA0BpB,MAAqB;IACtDA,OAAOqB,EAAE,CAACC,EAAE,CAAC,2CAA2C,CAACC,GAAGC;QAC1DA,OAAOC,IAAI,CACT,uCACAxB,sBAAsBb;IAE1B;IAEA,MAAMsC,aAAaxC;IACnB,MAAMyC,kBAAkBpC,cAAc,CAACW;QACrC,IAAIwB,WAAWE,UAAU,CAAC1B,UAAU;YAClCF,OAAOqB,EAAE,CAACI,IAAI,CAAC;gBAACb,MAAM;YAAa;YACnC;QACF;QACAZ,OAAOqB,EAAE,CAACI,IAAI,CAAC,uCAAuCxB,sBAAsBC;IAC9E;IAEA,OAAO,IAAMyB,gBAAgBE,KAAK;AACpC;AAEA;;;;;CAKC,GACD,OAAO,SAASC,gCAAgCC,OAI/C;IACC,MAAM,EAACC,QAAQ,EAAEtB,IAAI,EAAEV,MAAM,EAAC,GAAG+B;IAEjC,MAAME,OAAO9C,qBAAqB;QAACmB,MAAM0B,YAAY;QAAatB;IAAI;IACtE,IAAI,CAACuB,MAAM;QACT,MAAMC,WAAW5C;QACjBG,SACE,+FACAyC,UAAUC,KACVD,UAAUxB;IAEd;IAEA,MAAM0B,eAAehB,0BAA0BpB;IAE/C,OAAO;QACL6B,OAAO;YACLO;YACAH,MAAMI;QACR;IACF;AACF;AAwBA,OAAO,eAAeC,wBACpBP,OAA8B;IAE9B,MAAM,EACJQ,QAAQ,EACRC,SAAS,EACTR,QAAQ,EACRS,UAAUC,aAAa,EACvBC,IAAI,EACJC,MAAM,EACNC,eAAe,EACfC,OAAO,EACR,GAAGf;IAEJ,iEAAiE;IACjE,IAAI,CAAC9C,eAAeuD,WAAWO,MAAM;QACnCtD,SAAS;QACT,OAAO;YAACoC,OAAO/B;YAAMkC;YAAUgB,oBAAoB;YAAON;QAAa;IACzE;IAEA,8DAA8D;IAC9D,qEAAqE;IACrE,yEAAyE;IACzE,MAAMO,gBAAgB9D,qBAAqB;QAACmB,MAAM0B,YAAY;QAAatB,MAAMgC;IAAa;IAC9F,IAAI,CAACO,eAAe;QAClB,MAAMf,WAAW5C;QACjBG,SACE,4DACAyC,UAAUC,KACVD,UAAUxB;QAEZ,OAAO;YACLmB,OAAO/B;YACPkC,UAAUE,UAAU5B,QAAQ0B;YAC5BgB,oBAAoB;YACpBN,eAAeR,UAAUxB,QAAQgC;QACnC;IACF;IAEA,2EAA2E;IAC3E,4EAA4E;IAC5E,iBAAiB;IACjB,IAAIQ;IACJ,IAAI;QACFA,SAAS,MAAMC,0BAA0B;YACvCZ;YACAC;YACAR;YACAW;YACAC;YACAC;YACAH;YACAI;QACF;IACF,EAAE,OAAOM,KAAK;QACZH,cAAcZ,OAAO;QACrB,MAAMe;IACR;IAEA,IAAI,CAACF,QAAQ;QACXD,cAAcZ,OAAO;QACrB,OAAO;YAACR,OAAO/B;YAAMkC;YAAUgB,oBAAoB;YAAON;QAAa;IACzE;IAEA,MAAM,EAACW,UAAU,EAAExB,KAAK,EAAC,GAAGqB;IAC5BD,cAAcK,UAAU,CAACD;IAEzB,OAAO;QACLxB,OAAO;YACLoB,cAAcZ,OAAO;YACrB,MAAMR;QACR;QACAG;QACAgB,oBAAoB;QACpBN,eAAeW;IACjB;AACF;AAkBA,eAAeF,0BACbpB,OAAyC;IAEzC,MAAM,EAACQ,QAAQ,EAAEC,SAAS,EAAER,QAAQ,EAAEW,IAAI,EAAEC,MAAM,EAAEC,eAAe,EAAEH,aAAa,EAAEI,OAAO,EAAC,GAC1Ff;IAEF,gFAAgF;IAChF,2EAA2E;IAC3E,4EAA4E;IAC5E,MAAMwB,YACJZ,SAAS,YACLa,YACAC,eAAeC,QAAQC,GAAG,CAACC,oCAAoC;IAErE,MAAMC,iBAAiBC,sBAAsBtB;IAE7C/C,SAAS;IACT,MAAMsE,OAAO,MAAMvE,sBAAsB;QACvCwE,KAAKlB;QACLe;QACAhB;QACAU;IACF;IAEA,MAAMU,aAA2B;QAC/B,0FAA0F;QAC1F1B;QACA2B,YAAY;QACZC,QAAQ;YACNC,oBAAoBvF;YACpB,wDAAwDwF,KAAKC,SAAS,CAACf;QACzE;QACAgB,UAAU;QACV5B,MAAM;QACN6B,cAAc;YACZ,uEAAuE;YACvEC,SAAS;gBAAC/E;aAAqB;QACjC;QACA,8EAA8E;QAC9E,+EAA+E;QAC/E,iFAAiF;QACjF,4EAA4E;QAC5E,2EAA2E;QAC3E,2EAA2E;QAC3E,2EAA2E;QAC3EgF,SAAS;YAAC5F;eAAiByE,YAAY;gBAACoB,kCAAkCpB;aAAW,GAAG,EAAE;SAAE;QAC5FqB,SAAS;YACP,gEAAgE;YAChEC,OAAO;gBAAC,CAACnF,qBAAqB,EAAEC;YAAmB;YACnDmF,QAAQ;gBAAC;gBAAS;aAAY;QAChC;QACAf;QACA/D,QAAQ;YACNM,MAAM0B;YACNtB,MAAMgC;YACNqC,YAAY;YACZC,QAAQ;gBACNC,aAAa;oBAAC;iBAAiB;YACjC;QACF;IACF;IAEAxF,SAAS;IACT,MAAMO,SAAS,MAAMjB,aAAakF;IAClC,IAAI;QACF,MAAMjE,OAAOkF,MAAM;IACrB,EAAE,OAAO9B,KAAK;QACZ,MAAMpD,OAAO6B,KAAK;QAClBe,OAAOuC,IAAI,CACT,CAAC,sCAAsC,EAAE/B,eAAegC,QAAQhC,IAAIiC,OAAO,GAAGC,OAAOlC,MAAM;QAE7F,OAAOI;IACT;IAEA,wEAAwE;IACxE,MAAM+B,OAAOvF,OAAOwF,UAAU,EAAEC;IAChC,MAAMpC,aAAa,OAAOkC,SAAS,YAAYA,OAAOA,KAAK7E,IAAI,GAAGgC;IAElE,0EAA0E;IAC1E,+DAA+D;IAC/D,IAAIa,WAAW;QACbmC,MAAMnC,WACHoC,IAAI,CAAC,CAACC,IAAMA,EAAEC,IAAI,EAAEC,UACpBC,KAAK,CAAC,KAAO;QAChBtG,SAAS,kCAAkC8D;IAC7C;IAEA,MAAMnB,eAAehB,0BAA0BpB;IAE/C,OAAO;QACLqD;QACAxB,OAAO;YACLO;YACA,MAAMpC,OAAO6B,KAAK;QACpB;IACF;AACF;AAEA,qEAAqE;AACrE,wEAAwE;AACxE,0EAA0E;AAC1E,6EAA6E;AAC7E,MAAMiC,wBAAwB,CAACtB;IAC7B,IAAIA,UAAUO,GAAG,EAAEc,gBAAgB;QACjC,OAAOrB,UAAUO,GAAG,CAACc,cAAc;IACrC;IAEA,MAAM,IAAIuB,MACR;AAEJ;AAEA,4EAA4E;AAC5E,0CAA0C;AAC1C,MAAMY,kBAAkBhH,EAAEa,GAAG,CAAC;IAACoG,WAAW;IAAMC,UAAU;AAAU;AAEpE,SAASzC,eAAe0C,KAAyB;IAC/C,IAAI,CAACA,OAAO,OAAO3C;IAEnB,MAAMN,SAAS8C,gBAAgBI,SAAS,CAACD;IAEzC,IAAI,CAACjD,OAAOmD,OAAO,EAAE;QACnB,MAAM,IAAIjB,MACR,CAAC,8CAA8C,EAAEe,MAAM,yBAAyB,CAAC;IAErF;IAEA,OAAOjD,OAAOoD,IAAI;AACpB;AAEA;;;;;;CAMC,GACD,SAAS3B,kCAAkCpB,SAAiB;IAC1D,OAAO;QACLgD,OAAO;QACPC,iBAAgBxG,MAAM;YACpBA,OAAOyG,WAAW,CAACC,GAAG,CAAC,CAACC,KAAKC,KAAKC;gBAChC,MAAMC,WAAW,AAACH,CAAAA,IAAI9G,GAAG,IAAI,GAAE,EAAGkH,KAAK,CAAC,IAAI,CAAC,EAAE;gBAC/C,IAAID,aAAa,OAAOA,aAAa,eAAe;oBAClDF,IAAII,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAEzD,UAAU,qCAAqC,CAAC;gBAC5E;gBACAsD;YACF;QACF;QACAI,MAAM;IACR;AACF"}

package/dist/actions/dev/writeWorkbenchRuntime.js

@@ -6,9 +6,9 @@ const devDebug = subdebug('dev');
 const workbenchJsTemplate = `\
 // This file is auto-generated on 'sanity dev'
 // Modifications to this file are automatically discarded
-import {renderWorkbench} from "sanity/workbench"
+import {renderDashboard} from "@sanity/workbench-cli/_internal_render"
 
-renderWorkbench(
+renderDashboard(
   document.getElementById("workbench"),
   {organizationId: %SANITY_WORKBENCH_ORGANIZATION_ID%},
   {reactStrictMode: %SANITY_WORKBENCH_REACT_STRICT_MODE%}

package/dist/actions/dev/writeWorkbenchRuntime.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/dev/writeWorkbenchRuntime.ts"],"sourcesContent":["import fs from 'node:fs/promises'\nimport path from 'node:path'\n\nimport {subdebug} from '@sanity/cli-core'\nimport {isStaging} from '@sanity/cli-core/util'\n\nconst devDebug = subdebug('dev')\n\nconst workbenchJsTemplate = `\\\n// This file is auto-generated on 'sanity dev'\n// Modifications to this file are automatically discarded\nimport {renderWorkbench} from \"sanity/workbench\"\n\nrenderWorkbench(\n  document.getElementById(\"workbench\"),\n  {organizationId: %SANITY_WORKBENCH_ORGANIZATION_ID%},\n  {reactStrictMode: %SANITY_WORKBENCH_REACT_STRICT_MODE%}\n)\n`\n\nconst indexHtmlTemplate = `\\\n<!DOCTYPE html>\n<!-- This file is auto-generated on 'sanity dev' -->\n<!-- Modifications to this file are automatically discarded -->\n<html>\n  <head>\n    <meta charset=\"UTF-8\" />\n%SANITY_WORKBENCH_PREFETCH_HINTS%\n  </head>\n  <body>\n    <div id=\"workbench\"></div>\n    <script>globalThis.__SANITY_STAGING__ = %SANITY_WORKBENCH_STAGING%</script>\n    <script type=\"module\" src=\"./workbench.js\"></script>\n  </body>\n</html>\n`\n\n/**\n * Generates the `.sanity/workbench` directory with static entry files for\n * the workbench Vite dev server.\n *\n * @param cwd - Current working directory (Sanity root dir)\n * @returns The absolute path to the written workbench runtime directory\n * @internal\n */\nexport async function writeWorkbenchRuntime(options: {\n  cwd: string\n  organizationId?: string\n  reactStrictMode: boolean\n  remoteUrl?: string\n}): Promise<string> {\n  const {cwd, organizationId, reactStrictMode, remoteUrl} = options\n  const workbenchDir = path.join(cwd, '.sanity', 'workbench')\n\n  const workbenchJs = workbenchJsTemplate\n    .replace(\n      /%SANITY_WORKBENCH_ORGANIZATION_ID%/,\n      organizationId === undefined ? 'undefined' : JSON.stringify(organizationId),\n    )\n    .replace(/%SANITY_WORKBENCH_REACT_STRICT_MODE%/, JSON.stringify(reactStrictMode))\n\n  const prefetchHints = buildPrefetchHints(remoteUrl)\n\n  // The runtime flag builds get via decorateIndexWithStagingScript — a vite\n  // `define` never reaches pre-bundled dependencies like the SDK.\n  const indexHtml = indexHtmlTemplate\n    .replace(/%SANITY_WORKBENCH_PREFETCH_HINTS%/, prefetchHints)\n    .replace(/%SANITY_WORKBENCH_STAGING%/, JSON.stringify(isStaging()))\n\n  devDebug('Making workbench runtime directory')\n  await fs.mkdir(workbenchDir, {recursive: true})\n\n  devDebug('Writing workbench.js to workbench runtime directory')\n  await fs.writeFile(path.join(workbenchDir, 'workbench.js'), workbenchJs)\n\n  devDebug('Writing index.html to workbench runtime directory')\n  await fs.writeFile(path.join(workbenchDir, 'index.html'), indexHtml)\n\n  return workbenchDir\n}\n\nfunction buildPrefetchHints(remoteUrl: string | undefined): string {\n  if (!remoteUrl) return ''\n\n  try {\n    const url = new URL(remoteUrl)\n    return [\n      `    <link rel=\"preconnect\" href=\"${url.origin}\" />`,\n      `    <link rel=\"preload\" as=\"fetch\" href=\"${url.toString()}\" crossorigin />`,\n    ].join('\\n')\n  } catch {\n    return ''\n  }\n}\n"],"names":["fs","path","subdebug","isStaging","devDebug","workbenchJsTemplate","indexHtmlTemplate","writeWorkbenchRuntime","options","cwd","organizationId","reactStrictMode","remoteUrl","workbenchDir","join","workbenchJs","replace","undefined","JSON","stringify","prefetchHints","buildPrefetchHints","indexHtml","mkdir","recursive","writeFile","url","URL","origin","toString"],"mappings":"AAAA,OAAOA,QAAQ,mBAAkB;AACjC,OAAOC,UAAU,YAAW;AAE5B,SAAQC,QAAQ,QAAO,mBAAkB;AACzC,SAAQC,SAAS,QAAO,wBAAuB;AAE/C,MAAMC,WAAWF,SAAS;AAE1B,MAAMG,sBAAsB,CAAC;;;;;;;;;;AAU7B,CAAC;AAED,MAAMC,oBAAoB,CAAC;;;;;;;;;;;;;;;AAe3B,CAAC;AAED;;;;;;;CAOC,GACD,OAAO,eAAeC,sBAAsBC,OAK3C;IACC,MAAM,EAACC,GAAG,EAAEC,cAAc,EAAEC,eAAe,EAAEC,SAAS,EAAC,GAAGJ;IAC1D,MAAMK,eAAeZ,KAAKa,IAAI,CAACL,KAAK,WAAW;IAE/C,MAAMM,cAAcV,oBACjBW,OAAO,CACN,sCACAN,mBAAmBO,YAAY,cAAcC,KAAKC,SAAS,CAACT,iBAE7DM,OAAO,CAAC,wCAAwCE,KAAKC,SAAS,CAACR;IAElE,MAAMS,gBAAgBC,mBAAmBT;IAEzC,0EAA0E;IAC1E,gEAAgE;IAChE,MAAMU,YAAYhB,kBACfU,OAAO,CAAC,qCAAqCI,eAC7CJ,OAAO,CAAC,8BAA8BE,KAAKC,SAAS,CAAChB;IAExDC,SAAS;IACT,MAAMJ,GAAGuB,KAAK,CAACV,cAAc;QAACW,WAAW;IAAI;IAE7CpB,SAAS;IACT,MAAMJ,GAAGyB,SAAS,CAACxB,KAAKa,IAAI,CAACD,cAAc,iBAAiBE;IAE5DX,SAAS;IACT,MAAMJ,GAAGyB,SAAS,CAACxB,KAAKa,IAAI,CAACD,cAAc,eAAeS;IAE1D,OAAOT;AACT;AAEA,SAASQ,mBAAmBT,SAA6B;IACvD,IAAI,CAACA,WAAW,OAAO;IAEvB,IAAI;QACF,MAAMc,MAAM,IAAIC,IAAIf;QACpB,OAAO;YACL,CAAC,iCAAiC,EAAEc,IAAIE,MAAM,CAAC,IAAI,CAAC;YACpD,CAAC,yCAAyC,EAAEF,IAAIG,QAAQ,GAAG,gBAAgB,CAAC;SAC7E,CAACf,IAAI,CAAC;IACT,EAAE,OAAM;QACN,OAAO;IACT;AACF"}
+{"version":3,"sources":["../../../src/actions/dev/writeWorkbenchRuntime.ts"],"sourcesContent":["import fs from 'node:fs/promises'\nimport path from 'node:path'\n\nimport {subdebug} from '@sanity/cli-core'\nimport {isStaging} from '@sanity/cli-core/util'\n\nconst devDebug = subdebug('dev')\n\nconst workbenchJsTemplate = `\\\n// This file is auto-generated on 'sanity dev'\n// Modifications to this file are automatically discarded\nimport {renderDashboard} from \"@sanity/workbench-cli/_internal_render\"\n\nrenderDashboard(\n  document.getElementById(\"workbench\"),\n  {organizationId: %SANITY_WORKBENCH_ORGANIZATION_ID%},\n  {reactStrictMode: %SANITY_WORKBENCH_REACT_STRICT_MODE%}\n)\n`\n\nconst indexHtmlTemplate = `\\\n<!DOCTYPE html>\n<!-- This file is auto-generated on 'sanity dev' -->\n<!-- Modifications to this file are automatically discarded -->\n<html>\n  <head>\n    <meta charset=\"UTF-8\" />\n%SANITY_WORKBENCH_PREFETCH_HINTS%\n  </head>\n  <body>\n    <div id=\"workbench\"></div>\n    <script>globalThis.__SANITY_STAGING__ = %SANITY_WORKBENCH_STAGING%</script>\n    <script type=\"module\" src=\"./workbench.js\"></script>\n  </body>\n</html>\n`\n\n/**\n * Generates the `.sanity/workbench` directory with static entry files for\n * the workbench Vite dev server.\n *\n * @param cwd - Current working directory (Sanity root dir)\n * @returns The absolute path to the written workbench runtime directory\n * @internal\n */\nexport async function writeWorkbenchRuntime(options: {\n  cwd: string\n  organizationId?: string\n  reactStrictMode: boolean\n  remoteUrl?: string\n}): Promise<string> {\n  const {cwd, organizationId, reactStrictMode, remoteUrl} = options\n  const workbenchDir = path.join(cwd, '.sanity', 'workbench')\n\n  const workbenchJs = workbenchJsTemplate\n    .replace(\n      /%SANITY_WORKBENCH_ORGANIZATION_ID%/,\n      organizationId === undefined ? 'undefined' : JSON.stringify(organizationId),\n    )\n    .replace(/%SANITY_WORKBENCH_REACT_STRICT_MODE%/, JSON.stringify(reactStrictMode))\n\n  const prefetchHints = buildPrefetchHints(remoteUrl)\n\n  // The runtime flag builds get via decorateIndexWithStagingScript — a vite\n  // `define` never reaches pre-bundled dependencies like the SDK.\n  const indexHtml = indexHtmlTemplate\n    .replace(/%SANITY_WORKBENCH_PREFETCH_HINTS%/, prefetchHints)\n    .replace(/%SANITY_WORKBENCH_STAGING%/, JSON.stringify(isStaging()))\n\n  devDebug('Making workbench runtime directory')\n  await fs.mkdir(workbenchDir, {recursive: true})\n\n  devDebug('Writing workbench.js to workbench runtime directory')\n  await fs.writeFile(path.join(workbenchDir, 'workbench.js'), workbenchJs)\n\n  devDebug('Writing index.html to workbench runtime directory')\n  await fs.writeFile(path.join(workbenchDir, 'index.html'), indexHtml)\n\n  return workbenchDir\n}\n\nfunction buildPrefetchHints(remoteUrl: string | undefined): string {\n  if (!remoteUrl) return ''\n\n  try {\n    const url = new URL(remoteUrl)\n    return [\n      `    <link rel=\"preconnect\" href=\"${url.origin}\" />`,\n      `    <link rel=\"preload\" as=\"fetch\" href=\"${url.toString()}\" crossorigin />`,\n    ].join('\\n')\n  } catch {\n    return ''\n  }\n}\n"],"names":["fs","path","subdebug","isStaging","devDebug","workbenchJsTemplate","indexHtmlTemplate","writeWorkbenchRuntime","options","cwd","organizationId","reactStrictMode","remoteUrl","workbenchDir","join","workbenchJs","replace","undefined","JSON","stringify","prefetchHints","buildPrefetchHints","indexHtml","mkdir","recursive","writeFile","url","URL","origin","toString"],"mappings":"AAAA,OAAOA,QAAQ,mBAAkB;AACjC,OAAOC,UAAU,YAAW;AAE5B,SAAQC,QAAQ,QAAO,mBAAkB;AACzC,SAAQC,SAAS,QAAO,wBAAuB;AAE/C,MAAMC,WAAWF,SAAS;AAE1B,MAAMG,sBAAsB,CAAC;;;;;;;;;;AAU7B,CAAC;AAED,MAAMC,oBAAoB,CAAC;;;;;;;;;;;;;;;AAe3B,CAAC;AAED;;;;;;;CAOC,GACD,OAAO,eAAeC,sBAAsBC,OAK3C;IACC,MAAM,EAACC,GAAG,EAAEC,cAAc,EAAEC,eAAe,EAAEC,SAAS,EAAC,GAAGJ;IAC1D,MAAMK,eAAeZ,KAAKa,IAAI,CAACL,KAAK,WAAW;IAE/C,MAAMM,cAAcV,oBACjBW,OAAO,CACN,sCACAN,mBAAmBO,YAAY,cAAcC,KAAKC,SAAS,CAACT,iBAE7DM,OAAO,CAAC,wCAAwCE,KAAKC,SAAS,CAACR;IAElE,MAAMS,gBAAgBC,mBAAmBT;IAEzC,0EAA0E;IAC1E,gEAAgE;IAChE,MAAMU,YAAYhB,kBACfU,OAAO,CAAC,qCAAqCI,eAC7CJ,OAAO,CAAC,8BAA8BE,KAAKC,SAAS,CAAChB;IAExDC,SAAS;IACT,MAAMJ,GAAGuB,KAAK,CAACV,cAAc;QAACW,WAAW;IAAI;IAE7CpB,SAAS;IACT,MAAMJ,GAAGyB,SAAS,CAACxB,KAAKa,IAAI,CAACD,cAAc,iBAAiBE;IAE5DX,SAAS;IACT,MAAMJ,GAAGyB,SAAS,CAACxB,KAAKa,IAAI,CAACD,cAAc,eAAeS;IAE1D,OAAOT;AACT;AAEA,SAASQ,mBAAmBT,SAA6B;IACvD,IAAI,CAACA,WAAW,OAAO;IAEvB,IAAI;QACF,MAAMc,MAAM,IAAIC,IAAIf;QACpB,OAAO;YACL,CAAC,iCAAiC,EAAEc,IAAIE,MAAM,CAAC,IAAI,CAAC;YACpD,CAAC,yCAAyC,EAAEF,IAAIG,QAAQ,GAAG,gBAAgB,CAAC;SAC7E,CAACf,IAAI,CAAC;IACT,EAAE,OAAM;QACN,OAAO;IACT;AACF"}

package/dist/actions/preview/serveBuiltApplication.js

@@ -4,7 +4,7 @@ import { checkBuiltOutput } from '../deploy/checkBuiltOutput.js';
 const previewDebug = subdebug('preview');
 /**
  * Serve a built workbench app's `dist` as static files over a Vite `preview`
- * server, so its `mf-manifest.json` + `remote-entry.js` are reachable exactly as
+ * server, so its manifest and referenced assets are reachable exactly as
  * a live `sanity dev` remote would be — the workbench then federates it in.
  *
  * A missing federation build surfaces as `BUILD_NOT_FOUND` (from

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/actions/preview/serveBuiltApplication.ts"],"sourcesContent":["import {subdebug} from '@sanity/cli-core'\nimport {type InlineConfig, preview} from 'vite'\n\nimport {checkBuiltOutput} from '../deploy/checkBuiltOutput.js'\n\nconst previewDebug = subdebug('preview')\n\nexport interface BuiltApplicationServer {\n  close: () => Promise<void>\n  /** Routable host the remote is reachable at, for the registry's remote URL. */\n  host: string\n  /** Port Vite bound — may differ from the requested one under non-strict ports. */\n  port: number\n}\n\n/**\n * Serve a built workbench app's `dist` as static files over a Vite `preview`\n * server, so its `mf-manifest.json` + `remote-entry.js` are reachable exactly as\n * a live `sanity dev` remote would be — the workbench then federates it in.\n *\n * A missing federation build surfaces as `BUILD_NOT_FOUND` (from\n * `checkBuiltOutput`) so the command shows the same \"run sanity build\" hint the\n * studio preview path does; real I/O errors surface as themselves.\n */\nexport async function serveBuiltApplication(options: {\n  cacheDir: string\n  httpHost: string\n  httpPort: number\n  outDir: string\n  workDir: string\n}): Promise<BuiltApplicationServer> {\n  const {cacheDir, httpHost, httpPort, outDir, workDir} = options\n\n  await checkBuiltOutput(outDir)\n\n  const config: InlineConfig = {\n    // Serve at the root so `mf-manifest.json` and its `publicPath: 'auto'` chunks\n    // resolve under the registered remote URL.\n    base: '/',\n    // Needed for vite to serve `outDir` itself rather than `outDir/dist`.\n    build: {outDir},\n    cacheDir,\n    configFile: false,\n    logLevel: 'warn',\n    mode: 'production',\n    preview: {host: httpHost, port: httpPort, strictPort: false},\n    root: workDir,\n  }\n\n  previewDebug('Serving built remote from %s', outDir)\n  const server = await preview(config)\n\n  const addr = server.httpServer.address()\n  const port = typeof addr === 'object' && addr ? addr.port : httpPort\n\n  return {\n    // Drop idle keep-alive sockets so shutdown doesn't stall on a browser that\n    // kept the connection open — otherwise `close` waits out the teardown grace.\n    // `closeAllConnections` isn't on Vite's `HttpServer` type, but is on the\n    // underlying node server (18.2+); the optional call tolerates its absence.\n    close: () =>\n      new Promise((resolve, reject) => {\n        server.httpServer.close((err) => (err ? reject(err) : resolve()))\n        ;(server.httpServer as {closeAllConnections?: () => void}).closeAllConnections?.()\n      }),\n    host: httpHost,\n    port,\n  }\n}\n"],"names":["subdebug","preview","checkBuiltOutput","previewDebug","serveBuiltApplication","options","cacheDir","httpHost","httpPort","outDir","workDir","config","base","build","configFile","logLevel","mode","host","port","strictPort","root","server","addr","httpServer","address","close","Promise","resolve","reject","err","closeAllConnections"],"mappings":"AAAA,SAAQA,QAAQ,QAAO,mBAAkB;AACzC,SAA2BC,OAAO,QAAO,OAAM;AAE/C,SAAQC,gBAAgB,QAAO,gCAA+B;AAE9D,MAAMC,eAAeH,SAAS;AAU9B;;;;;;;;CAQC,GACD,OAAO,eAAeI,sBAAsBC,OAM3C;IACC,MAAM,EAACC,QAAQ,EAAEC,QAAQ,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,OAAO,EAAC,GAAGL;IAExD,MAAMH,iBAAiBO;IAEvB,MAAME,SAAuB;QAC3B,8EAA8E;QAC9E,2CAA2C;QAC3CC,MAAM;QACN,sEAAsE;QACtEC,OAAO;YAACJ;QAAM;QACdH;QACAQ,YAAY;QACZC,UAAU;QACVC,MAAM;QACNf,SAAS;YAACgB,MAAMV;YAAUW,MAAMV;YAAUW,YAAY;QAAK;QAC3DC,MAAMV;IACR;IAEAP,aAAa,gCAAgCM;IAC7C,MAAMY,SAAS,MAAMpB,QAAQU;IAE7B,MAAMW,OAAOD,OAAOE,UAAU,CAACC,OAAO;IACtC,MAAMN,OAAO,OAAOI,SAAS,YAAYA,OAAOA,KAAKJ,IAAI,GAAGV;IAE5D,OAAO;QACL,2EAA2E;QAC3E,6EAA6E;QAC7E,yEAAyE;QACzE,2EAA2E;QAC3EiB,OAAO,IACL,IAAIC,QAAQ,CAACC,SAASC;gBACpBP,OAAOE,UAAU,CAACE,KAAK,CAAC,CAACI,MAASA,MAAMD,OAAOC,OAAOF;gBACpDN,OAAOE,UAAU,CAAwCO,mBAAmB;YAChF;QACFb,MAAMV;QACNW;IACF;AACF"}
+{"version":3,"sources":["../../../src/actions/preview/serveBuiltApplication.ts"],"sourcesContent":["import {subdebug} from '@sanity/cli-core'\nimport {type InlineConfig, preview} from 'vite'\n\nimport {checkBuiltOutput} from '../deploy/checkBuiltOutput.js'\n\nconst previewDebug = subdebug('preview')\n\nexport interface BuiltApplicationServer {\n  close: () => Promise<void>\n  /** Routable host the remote is reachable at, for the registry's remote URL. */\n  host: string\n  /** Port Vite bound — may differ from the requested one under non-strict ports. */\n  port: number\n}\n\n/**\n * Serve a built workbench app's `dist` as static files over a Vite `preview`\n * server, so its manifest and referenced assets are reachable exactly as\n * a live `sanity dev` remote would be — the workbench then federates it in.\n *\n * A missing federation build surfaces as `BUILD_NOT_FOUND` (from\n * `checkBuiltOutput`) so the command shows the same \"run sanity build\" hint the\n * studio preview path does; real I/O errors surface as themselves.\n */\nexport async function serveBuiltApplication(options: {\n  cacheDir: string\n  httpHost: string\n  httpPort: number\n  outDir: string\n  workDir: string\n}): Promise<BuiltApplicationServer> {\n  const {cacheDir, httpHost, httpPort, outDir, workDir} = options\n\n  await checkBuiltOutput(outDir)\n\n  const config: InlineConfig = {\n    // Serve at the root so `mf-manifest.json` and its `publicPath: 'auto'` chunks\n    // resolve under the registered remote URL.\n    base: '/',\n    // Needed for vite to serve `outDir` itself rather than `outDir/dist`.\n    build: {outDir},\n    cacheDir,\n    configFile: false,\n    logLevel: 'warn',\n    mode: 'production',\n    preview: {host: httpHost, port: httpPort, strictPort: false},\n    root: workDir,\n  }\n\n  previewDebug('Serving built remote from %s', outDir)\n  const server = await preview(config)\n\n  const addr = server.httpServer.address()\n  const port = typeof addr === 'object' && addr ? addr.port : httpPort\n\n  return {\n    // Drop idle keep-alive sockets so shutdown doesn't stall on a browser that\n    // kept the connection open — otherwise `close` waits out the teardown grace.\n    // `closeAllConnections` isn't on Vite's `HttpServer` type, but is on the\n    // underlying node server (18.2+); the optional call tolerates its absence.\n    close: () =>\n      new Promise((resolve, reject) => {\n        server.httpServer.close((err) => (err ? reject(err) : resolve()))\n        ;(server.httpServer as {closeAllConnections?: () => void}).closeAllConnections?.()\n      }),\n    host: httpHost,\n    port,\n  }\n}\n"],"names":["subdebug","preview","checkBuiltOutput","previewDebug","serveBuiltApplication","options","cacheDir","httpHost","httpPort","outDir","workDir","config","base","build","configFile","logLevel","mode","host","port","strictPort","root","server","addr","httpServer","address","close","Promise","resolve","reject","err","closeAllConnections"],"mappings":"AAAA,SAAQA,QAAQ,QAAO,mBAAkB;AACzC,SAA2BC,OAAO,QAAO,OAAM;AAE/C,SAAQC,gBAAgB,QAAO,gCAA+B;AAE9D,MAAMC,eAAeH,SAAS;AAU9B;;;;;;;;CAQC,GACD,OAAO,eAAeI,sBAAsBC,OAM3C;IACC,MAAM,EAACC,QAAQ,EAAEC,QAAQ,EAAEC,QAAQ,EAAEC,MAAM,EAAEC,OAAO,EAAC,GAAGL;IAExD,MAAMH,iBAAiBO;IAEvB,MAAME,SAAuB;QAC3B,8EAA8E;QAC9E,2CAA2C;QAC3CC,MAAM;QACN,sEAAsE;QACtEC,OAAO;YAACJ;QAAM;QACdH;QACAQ,YAAY;QACZC,UAAU;QACVC,MAAM;QACNf,SAAS;YAACgB,MAAMV;YAAUW,MAAMV;YAAUW,YAAY;QAAK;QAC3DC,MAAMV;IACR;IAEAP,aAAa,gCAAgCM;IAC7C,MAAMY,SAAS,MAAMpB,QAAQU;IAE7B,MAAMW,OAAOD,OAAOE,UAAU,CAACC,OAAO;IACtC,MAAMN,OAAO,OAAOI,SAAS,YAAYA,OAAOA,KAAKJ,IAAI,GAAGV;IAE5D,OAAO;QACL,2EAA2E;QAC3E,6EAA6E;QAC7E,yEAAyE;QACzE,2EAA2E;QAC3EiB,OAAO,IACL,IAAIC,QAAQ,CAACC,SAASC;gBACpBP,OAAOE,UAAU,CAACE,KAAK,CAAC,CAACI,MAASA,MAAMD,OAAOC,OAAOF;gBACpDN,OAAOE,UAAU,CAAwCO,mBAAmB;YAChF;QACFb,MAAMV;QACNW;IACF;AACF"}

package/dist/actions/preview/startWorkbenchPreview.js

@@ -54,7 +54,7 @@ import { serveBuiltApplication } from './serveBuiltApplication.js';
         const workbench = resolveWorkbenchApp(cliConfig);
         if (!workbench) throw new Error('`sanity start` was invoked in a non-workbench application');
         const inlinedId = await readInlinedAppId(outDir);
-        const configs = await deriveConfigs(cliConfig.app);
+        const configs = await deriveConfigs(cliConfig);
         const id = inlinedId ?? await buildAppId(workbench);
         const registration = registerDevServer({
             configs,