@sanity/sdk-react 3.4.0-next.20260921073349 → 3.4.0-next.20260921115438

package/dist/_exports/dashboard.d.ts

@@ -586,50 +586,69 @@ type TopicEmitter<K extends EventTopic$1> = (...args: PayloadOf$1<K> extends voi
  * @public
  */
 export declare function useEmit<K extends EventTopic$1>(topic: K): TopicEmitter<K>;
+/**
+ * A navigation the Dashboard asks the app to perform, or that the app reports to the Dashboard.
+ * `path` is relative to the app's own route, with no leading slash (`'documents/abc'`), and may
+ * carry a query string and hash.
+ * @public
+ */
+type DashboardNavigation = PathChangeMessage['data'];
+/**
+ * Reports an in-app navigation to the Dashboard so the browser URL and the Dashboard's own
+ * router follow the app. `type` defaults to `'push'` and only applies in the federated runtime;
+ * see {@link useNavigate}.
+ * @public
+ */
+type NavigateToDashboardPath = (options: {
+  path: string;
+  type?: 'push' | 'replace';
+}) => void;
 /**
  * @public
  *
  * A helper hook designed to be injected into routing components for apps within the Dashboard.
- * While the Dashboard can usually handle navigation, there are special cases when you
- * are already within a target app, and need to navigate to another route inside of that app.
- *
- * For example, your user might "favorite" a document inside of your application.
- * If they click on the Dashboard favorites item in the sidebar, and are already within your application,
- * there needs to be some way for the dashboard to signal to your application to reroute to where that document was favorited.
- *
- * This hook is intended to receive those messages, and takes a function to route to the correct path.
+ * It keeps the app's router and the Dashboard in two-way sync: `navigateFn` receives the
+ * navigations the Dashboard asks the app to perform, and the returned function reports the app's
+ * own in-app navigations back to the Dashboard so the browser URL and the Dashboard's router
+ * follow along.
+ *
+ * A navigation the app reports is not echoed back through `navigateFn`. The returned function is
+ * referentially stable.
+ *
+ * The two Dashboard runtimes differ:
+ * - In an iframe (Comlink), inbound `type` may be `'push'`, `'replace'` or `'pop'`. Reporting is
+ *   optional because the bridge already forwards the iframe's own `pushState`; a reported `type`
+ *   is ignored and the host applies the URL as a `replace`.
+ * - In a federated app (message bus), inbound `type` is `'push'` or `'replace'`; `'pop'` is never
+ *   sent. Reporting is required because the app's router does not reach the host, and `type` is
+ *   honoured. Until the Dashboard publishes the app's base path, reports are dropped with a
+ *   console warning.
  *
  * @param navigateFn - Function to handle navigation; should accept:
  * - `path`: a string, which will be a relative path (for example, 'my-route')
  * - `type`: 'push', 'replace', or 'pop', which will be the type of navigation to perform
+ * @returns A function the app calls to report its own in-app navigations to the Dashboard.
  *
  * @example
  * ```tsx
  * import {useNavigate} from '@sanity/sdk-react/dashboard'
- * import {BrowserRouter, useNavigate as useRouterNavigate} from 'react-router'
- * import {Suspense} from 'react'
- *
- * function DashboardNavigationHandler() {
- *   const navigate = useRouterNavigate()
- *   useNavigate(({path, type}) => {
- *     navigate(path, {replace: type === 'replace'})
+ * import {useEffect} from 'react'
+ * import {useLocation, useNavigate as useRouterNavigate} from 'react-router'
+ *
+ * function DashboardNavigationSync() {
+ *   const routerNavigate = useRouterNavigate()
+ *   const {pathname, search, hash} = useLocation()
+ *   const navigate = useNavigate(({path, type}) => {
+ *     routerNavigate(path, {replace: type === 'replace'})
  *   })
+ *   useEffect(() => {
+ *     navigate({path: `${pathname.slice(1)}${search}${hash}`})
+ *   }, [navigate, pathname, search, hash])
  *   return null
  * }
- *
- * // Wrap the component with Suspense since the hook may suspend
- * function MyApp() {
- *   return (
- *     <BrowserRouter>
- *       <Suspense>
- *         <DashboardNavigationHandler />
- *       </Suspense>
- *     </BrowserRouter>
- *   )
- * }
  * ```
  */
-export declare function useNavigate(navigateFn: (options: PathChangeMessage['data']) => void): void;
+export declare function useNavigate(navigateFn: (options: DashboardNavigation) => void): NavigateToDashboardPath;
 /**
  * @public
  * @category Types
@@ -645,6 +664,9 @@ interface NavigateToStudioResult {
  * Uses the `projectId` and `dataset` properties of the {@link DocumentHandle} you provide to resolve the correct Studio.
  * This will only work if you have deployed a studio with a workspace with this `projectId` / `dataset` combination.
  *
+ * Works in both Dashboard runtimes: it sends the navigation over the Comlink connection in the
+ * iframe runtime and over the message bus in the federated runtime.
+ *
  * @remarks If you write your own Document Handle to pass to this hook (as opposed to a Document Handle generated by another hook),
  * it must include values for `documentId`, `documentType`, `projectId`, and `dataset`.
  *
@@ -773,5 +795,5 @@ export declare const useTopic: <K extends StateTopic$1>(topic: K) => TopicData$1
  * @public
  */
 export declare function useWindowTitle(viewTitle?: string): void;
-export { type AgentResourceContextOptions, type ApplicationConfig, type ApplicationConfigAppType, type ApplicationConfigSelector, type CanvasUrl, type Capability, type CapabilityRecord, type ConnectMessageBusOptions, type CoreApplicationUrl, type CreateIntentParameters, type CreateRemoteInstanceOptions, type DashboardApplication, type DashboardTopics, type DashboardUrl, type DashboardView, type DashboardWebWorker, type EditIntentParameters, type EventTopic, type EventTopicDef, type FederationRemote, type MediaLibraryUrl, type MessageBus, type MessageBusAbortOptions, type MessageBusClient, type MessageBusConnection, type MessageBusEmitOptions, type MessageBusEmitResult, MessageBusError, type MessageBusErrorCode, type MessageBusHost, type MessageBusMessage, type MessageBusMeta, type MessageBusQueryOptions, type MessageBusStateSource, type NavigateToStudioResult, type NavigationLocation, type NavigationTarget, type PayloadOf, type ReleaseIntentParameters, type RemoteInstance, type RemoteModuleRef, type ReplyOf, type StateTopic, type StateTopicDef, type StudioIntentUrl, type StudioUrl, type StudioWorkspaceUrl, DashboardTokenRefreshProvider as TokenRefreshProvider, type TopicData, type TopicEmitter, TopicError, type TopicName, type TopicResult, type Topics, type Urls, type ValueOf, capabilities, connectMessageBus };
+export { type AgentResourceContextOptions, type ApplicationConfig, type ApplicationConfigAppType, type ApplicationConfigSelector, type CanvasUrl, type Capability, type CapabilityRecord, type ConnectMessageBusOptions, type CoreApplicationUrl, type CreateIntentParameters, type CreateRemoteInstanceOptions, type DashboardApplication, type DashboardNavigation, type DashboardTopics, type DashboardUrl, type DashboardView, type DashboardWebWorker, type EditIntentParameters, type EventTopic, type EventTopicDef, type FederationRemote, type MediaLibraryUrl, type MessageBus, type MessageBusAbortOptions, type MessageBusClient, type MessageBusConnection, type MessageBusEmitOptions, type MessageBusEmitResult, MessageBusError, type MessageBusErrorCode, type MessageBusHost, type MessageBusMessage, type MessageBusMeta, type MessageBusQueryOptions, type MessageBusStateSource, type NavigateToDashboardPath, type NavigateToStudioResult, type NavigationLocation, type NavigationTarget, type PayloadOf, type ReleaseIntentParameters, type RemoteInstance, type RemoteModuleRef, type ReplyOf, type StateTopic, type StateTopicDef, type StudioIntentUrl, type StudioUrl, type StudioWorkspaceUrl, DashboardTokenRefreshProvider as TokenRefreshProvider, type TopicData, type TopicEmitter, TopicError, type TopicName, type TopicResult, type Topics, type Urls, type ValueOf, capabilities, connectMessageBus };
 //# sourceMappingURL=dashboard.d.ts.map

package/dist/_exports/dashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.d.ts","names":[],"sources":["../../src/context/DashboardTokenRefresh.tsx","../../src/dashboard/createRemoteInstance.ts","../../src/dashboard/urlFor.ts","../../src/hooks/dashboard/useAgentResourceContext.ts","../../src/hooks/dashboard/useApplications.ts","../../src/hooks/dashboard/useApplication.ts","../../src/hooks/dashboard/useApplicationBasePath.ts","../../src/hooks/dashboard/useApplicationConfig.ts","../../src/hooks/dashboard/useApplicationConfigs.ts","../../src/hooks/dashboard/useApplicationForegroundId.ts","../../src/hooks/dashboard/useAuthToken.ts","../../src/hooks/dashboard/useCapabilities.ts","../../src/hooks/dashboard/useCurrentUser.ts","../../src/hooks/dashboard/useEmit.ts","../../src/hooks/dashboard/useNavigate.ts","../../src/hooks/dashboard/useNavigateToStudioDocument.ts","../../src/hooks/dashboard/useOrganizationId.tsx","../../src/hooks/dashboard/useRemoteClient.ts","../../src/hooks/dashboard/useTopic.ts","../../src/hooks/dashboard/useWindowTitle.ts"],"mappings":"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"}
+{"version":3,"file":"dashboard.d.ts","names":[],"sources":["../../src/context/DashboardTokenRefresh.tsx","../../src/dashboard/createRemoteInstance.ts","../../src/dashboard/urlFor.ts","../../src/hooks/dashboard/useAgentResourceContext.ts","../../src/hooks/dashboard/useApplications.ts","../../src/hooks/dashboard/useApplication.ts","../../src/hooks/dashboard/useApplicationBasePath.ts","../../src/hooks/dashboard/useApplicationConfig.ts","../../src/hooks/dashboard/useApplicationConfigs.ts","../../src/hooks/dashboard/useApplicationForegroundId.ts","../../src/hooks/dashboard/useAuthToken.ts","../../src/hooks/dashboard/useCapabilities.ts","../../src/hooks/dashboard/useCurrentUser.ts","../../src/hooks/dashboard/useEmit.ts","../../src/hooks/dashboard/useNavigate.ts","../../src/hooks/dashboard/useNavigateToStudioDocument.ts","../../src/hooks/dashboard/useOrganizationId.tsx","../../src/hooks/dashboard/useRemoteClient.ts","../../src/hooks/dashboard/useTopic.ts","../../src/hooks/dashboard/useWindowTitle.ts"],"mappings":"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"}

package/dist/_exports/dashboard.js

@@ -2,11 +2,11 @@ import { a as useWindowConnection, c as useSanityInstance, i as DashboardTokenRe
 import { c } from "react-compiler-runtime";
 import "@sanity/sdk";
 import { createLogger, getApplicationOrigin, isDashboardEnvironment, requireDashboardMessageBus } from "@sanity/sdk/_internal";
-import { useEffect, useRef, useState } from "react";
+import { useCallback, useEffect, useEffectEvent, useRef, useState } from "react";
 import { SDK_CHANNEL_NAME, SDK_NODE_NAME } from "@sanity/message-protocol";
 import "@sanity/sdk/comlink";
-import { of } from "rxjs";
-import { MessageBusError, TopicError, capabilities, connectMessageBus } from "@sanity/sdk/dashboard";
+import { filter, map, of, pairwise } from "rxjs";
+import { MessageBusError, TopicError, TopicError as TopicError$1, capabilities, connectMessageBus } from "@sanity/sdk/dashboard";
 import "@sanity/types";
 import { createInstance } from "@module-federation/runtime";
 import "@module-federation/runtime/types";
@@ -723,54 +723,140 @@ function useEmit(topic) {
 * @public
 *
 * A helper hook designed to be injected into routing components for apps within the Dashboard.
-* While the Dashboard can usually handle navigation, there are special cases when you
-* are already within a target app, and need to navigate to another route inside of that app.
-*
-* For example, your user might "favorite" a document inside of your application.
-* If they click on the Dashboard favorites item in the sidebar, and are already within your application,
-* there needs to be some way for the dashboard to signal to your application to reroute to where that document was favorited.
-*
-* This hook is intended to receive those messages, and takes a function to route to the correct path.
+* It keeps the app's router and the Dashboard in two-way sync: `navigateFn` receives the
+* navigations the Dashboard asks the app to perform, and the returned function reports the app's
+* own in-app navigations back to the Dashboard so the browser URL and the Dashboard's router
+* follow along.
+*
+* A navigation the app reports is not echoed back through `navigateFn`. The returned function is
+* referentially stable.
+*
+* The two Dashboard runtimes differ:
+* - In an iframe (Comlink), inbound `type` may be `'push'`, `'replace'` or `'pop'`. Reporting is
+*   optional because the bridge already forwards the iframe's own `pushState`; a reported `type`
+*   is ignored and the host applies the URL as a `replace`.
+* - In a federated app (message bus), inbound `type` is `'push'` or `'replace'`; `'pop'` is never
+*   sent. Reporting is required because the app's router does not reach the host, and `type` is
+*   honoured. Until the Dashboard publishes the app's base path, reports are dropped with a
+*   console warning.
 *
 * @param navigateFn - Function to handle navigation; should accept:
 * - `path`: a string, which will be a relative path (for example, 'my-route')
 * - `type`: 'push', 'replace', or 'pop', which will be the type of navigation to perform
+* @returns A function the app calls to report its own in-app navigations to the Dashboard.
 *
 * @example
 * ```tsx
 * import {useNavigate} from '@sanity/sdk-react/dashboard'
-* import {BrowserRouter, useNavigate as useRouterNavigate} from 'react-router'
-* import {Suspense} from 'react'
-*
-* function DashboardNavigationHandler() {
-*   const navigate = useRouterNavigate()
-*   useNavigate(({path, type}) => {
-*     navigate(path, {replace: type === 'replace'})
+* import {useEffect} from 'react'
+* import {useLocation, useNavigate as useRouterNavigate} from 'react-router'
+*
+* function DashboardNavigationSync() {
+*   const routerNavigate = useRouterNavigate()
+*   const {pathname, search, hash} = useLocation()
+*   const navigate = useNavigate(({path, type}) => {
+*     routerNavigate(path, {replace: type === 'replace'})
 *   })
+*   useEffect(() => {
+*     navigate({path: `${pathname.slice(1)}${search}${hash}`})
+*   }, [navigate, pathname, search, hash])
 *   return null
 * }
-*
-* // Wrap the component with Suspense since the hook may suspend
-* function MyApp() {
-*   return (
-*     <BrowserRouter>
-*       <Suspense>
-*         <DashboardNavigationHandler />
-*       </Suspense>
-*     </BrowserRouter>
-*   )
-* }
 * ```
 */
 function useNavigate(navigateFn) {
-	let $ = c(2), t0;
+	return isDashboardEnvironment() ? useBusNavigate(navigateFn) : useComlinkNavigate(navigateFn);
+}
+function useComlinkNavigate(navigateFn) {
+	let $ = c(4), t0;
 	$[0] === navigateFn ? t0 = $[1] : (t0 = {
 		name: SDK_NODE_NAME,
 		connectTo: SDK_CHANNEL_NAME,
 		onMessage: { "dashboard/v1/history/change-path": (data) => {
 			navigateFn(data);
 		} }
-	}, $[0] = navigateFn, $[1] = t0), useWindowConnection(t0);
+	}, $[0] = navigateFn, $[1] = t0);
+	let { sendMessage } = useWindowConnection(t0), t1;
+	return $[2] === sendMessage ? t1 = $[3] : (t1 = (t2) => {
+		let { path } = t2;
+		return sendMessage("dashboard/v1/bridge/listeners/history/update-url", { url: new URL(path, window.location.origin).href });
+	}, $[2] = sendMessage, $[3] = t1), t1;
+}
+function joinPath(base, path) {
+	let root = base.replace(/\/$/, "");
+	return path ? `${root}/${path}` : root;
+}
+function useBusNavigate(navigateFn) {
+	let $ = c(9), instance = useSanityInstance(), t0;
+	$[0] === instance ? t0 = $[1] : (t0 = requireDashboardMessageBus(instance, "navigate"), $[0] = instance, $[1] = t0);
+	let bus = t0, navigate = useEffectEvent(navigateFn), ownRequest = useRef(null), t1;
+	$[2] !== bus || $[3] !== navigate ? (t1 = () => {
+		let sub = bus.subscribe("navigation.location").pipe(pairwise(), filter((pair) => {
+			let [prev, curr] = pair;
+			return curr?.transition === null && curr.appId === bus.appId && prev?.transition?.to.appId === bus.appId && prev.transition.to.path === curr.path;
+		}), filter((t2) => {
+			let [, curr_0] = t2, suppress = curr_0.path === ownRequest.current;
+			return ownRequest.current = null, !suppress;
+		}), map(_temp$1)).subscribe((change) => navigate(change));
+		return () => sub.unsubscribe();
+	}, $[2] = bus, $[3] = navigate, $[4] = t1) : t1 = $[4];
+	let t2;
+	$[5] === bus ? t2 = $[6] : (t2 = [bus], $[5] = bus, $[6] = t2), useEffect(t1, t2);
+	let t3;
+	return $[7] === bus ? t3 = $[8] : (t3 = (t4) => {
+		let { path, type: t5 } = t4, type = t5 === void 0 ? "push" : t5, own = path.replace(/^\//, "");
+		ownRequest.current = own;
+		let clearIfStale = () => {
+			ownRequest.current === own && (ownRequest.current = null);
+		};
+		bus.query("applications.base-path").then((base) => {
+			if (!base.ok) throw new TopicError$1("applications.base-path");
+			return bus.emit("navigation.location.update", {
+				url: joinPath(base.value, own),
+				history: type
+			});
+		}).then((reply) => {
+			reply.ok || clearIfStale();
+		}, (error) => {
+			console.warn("Failed to report navigation to the Dashboard", error), clearIfStale();
+		});
+	}, $[7] = bus, $[8] = t3), t3;
+}
+function _temp$1(t0) {
+	let [prev_0, curr_1] = t0;
+	return {
+		path: curr_1.path,
+		type: prev_0.transition.navigationType
+	};
+}
+function useComlinkStudioNavigator(documentHandle) {
+	let $ = c(5), t0;
+	$[0] === Symbol.for("react.memo_cache_sentinel") ? (t0 = {
+		name: SDK_NODE_NAME,
+		connectTo: SDK_CHANNEL_NAME
+	}, $[0] = t0) : t0 = $[0];
+	let { sendMessage } = useWindowConnection(t0), t1;
+	return $[1] !== documentHandle.documentId || $[2] !== documentHandle.documentType || $[3] !== sendMessage ? (t1 = (workspace) => {
+		let message = {
+			type: "dashboard/v1/bridge/navigate-to-resource",
+			data: {
+				resourceId: workspace.id,
+				resourceType: "studio",
+				path: `/intent/edit/id=${documentHandle.documentId};type=${documentHandle.documentType}`
+			}
+		};
+		sendMessage(message.type, message.data);
+	}, $[1] = documentHandle.documentId, $[2] = documentHandle.documentType, $[3] = sendMessage, $[4] = t1) : t1 = $[4], t1;
+}
+function useBusStudioNavigator(documentHandle) {
+	let $ = c(4), navigate = useEmit("navigation.location.update"), t0;
+	return $[0] !== documentHandle.documentId || $[1] !== documentHandle.documentType || $[2] !== navigate ? (t0 = (workspace) => {
+		let url = urlFor.studios(workspace.userApplicationId).workspace(workspace.name).intent("edit", {
+			id: documentHandle.documentId,
+			type: documentHandle.documentType
+		}).url();
+		navigate({ url }).then(_temp, _temp2);
+	}, $[0] = documentHandle.documentId, $[1] = documentHandle.documentType, $[2] = navigate, $[3] = t0) : t0 = $[3], t0;
 }
 /**
 * @public
@@ -780,6 +866,9 @@ function useNavigate(navigateFn) {
 * Uses the `projectId` and `dataset` properties of the {@link DocumentHandle} you provide to resolve the correct Studio.
 * This will only work if you have deployed a studio with a workspace with this `projectId` / `dataset` combination.
 *
+* Works in both Dashboard runtimes: it sends the navigation over the Comlink connection in the
+* iframe runtime and over the message bus in the federated runtime.
+*
 * @remarks If you write your own Document Handle to pass to this hook (as opposed to a Document Handle generated by another hook),
 * it must include values for `documentId`, `documentType`, `projectId`, and `dataset`.
 *
@@ -817,41 +906,38 @@ function useNavigate(navigateFn) {
 * }
 * ```
 */
+function _temp2(error) {
+	console.warn("Failed to navigate to studio document", error);
+}
+function _temp(reply) {
+	reply.ok === !1 && console.warn("Failed to navigate to studio document", reply);
+}
 function useNavigateToStudioDocument(documentHandle, preferredStudioUrl) {
-	let $ = c(8), { workspacesByProjectIdAndDataset } = useStudioWorkspacesByProjectIdDataset(), t0;
-	$[0] === Symbol.for("react.memo_cache_sentinel") ? (t0 = {
-		name: SDK_NODE_NAME,
-		connectTo: SDK_CHANNEL_NAME
-	}, $[0] = t0) : t0 = $[0];
-	let { sendMessage } = useWindowConnection(t0), t1;
-	$[1] !== documentHandle || $[2] !== preferredStudioUrl || $[3] !== sendMessage || $[4] !== workspacesByProjectIdAndDataset ? (t1 = () => {
+	let { workspacesByProjectIdAndDataset } = useStudioWorkspacesByProjectIdDataset(), sendToWorkspace = isDashboardEnvironment() ? useBusStudioNavigator(documentHandle) : useComlinkStudioNavigator(documentHandle);
+	return { navigateToStudioDocument: useCallback(() => {
 		let { projectId, dataset } = documentHandle;
 		if (!projectId || !dataset) {
 			console.warn("Project ID and dataset are required to navigate to a studio document");
 			return;
 		}
-		let workspace;
-		if (preferredStudioUrl) workspace = [...workspacesByProjectIdAndDataset[`${projectId}:${dataset}`] || [], ...workspacesByProjectIdAndDataset["NO_PROJECT_ID:NO_DATASET"] || []].find((w) => w.url === preferredStudioUrl);
-		else {
-			let workspaces = workspacesByProjectIdAndDataset[`${projectId}:${dataset}`];
-			workspaces?.length > 1 && (console.warn("Multiple workspaces found for document and no preferred studio url", documentHandle), console.warn("Using the first one", workspaces[0])), workspace = workspaces?.[0];
-		}
+		let workspace = resolveWorkspace(documentHandle, workspacesByProjectIdAndDataset, preferredStudioUrl);
 		if (!workspace) {
 			console.warn(`No workspace found for document with projectId: ${projectId} and dataset: ${dataset}${preferredStudioUrl ? ` or with preferred studio url: ${preferredStudioUrl}` : ""}`);
 			return;
 		}
-		let message = {
-			type: "dashboard/v1/bridge/navigate-to-resource",
-			data: {
-				resourceId: workspace.id,
-				resourceType: "studio",
-				path: `/intent/edit/id=${documentHandle.documentId};type=${documentHandle.documentType}`
-			}
-		};
-		sendMessage(message.type, message.data);
-	}, $[1] = documentHandle, $[2] = preferredStudioUrl, $[3] = sendMessage, $[4] = workspacesByProjectIdAndDataset, $[5] = t1) : t1 = $[5];
-	let navigateToStudioDocument = t1, t2;
-	return $[6] === navigateToStudioDocument ? t2 = $[7] : (t2 = { navigateToStudioDocument }, $[6] = navigateToStudioDocument, $[7] = t2), t2;
+		sendToWorkspace(workspace);
+	}, [
+		documentHandle,
+		workspacesByProjectIdAndDataset,
+		preferredStudioUrl,
+		sendToWorkspace
+	]) };
+}
+function resolveWorkspace(documentHandle, workspacesByProjectIdAndDataset, preferredStudioUrl) {
+	let { projectId, dataset } = documentHandle, key = `${projectId}:${dataset}`;
+	if (preferredStudioUrl) return [...workspacesByProjectIdAndDataset[key] || [], ...workspacesByProjectIdAndDataset["NO_PROJECT_ID:NO_DATASET"] || []].find((w) => w.url === preferredStudioUrl);
+	let workspaces = workspacesByProjectIdAndDataset[key];
+	return workspaces && workspaces.length > 1 && (console.warn("Multiple workspaces found for document and no preferred studio url", documentHandle), console.warn("Using the first one", workspaces[0])), workspaces?.[0];
 }
 const remoteClientStates = /* @__PURE__ */ new WeakMap();
 /** Returns the instance's remote client state, creating it on first use. @internal */