@sanity/sdk-react 2.7.0 → 3.0.0-rc.0

package/dist/index.js

@@ -1,40 +1,29 @@
 import { jsx, jsxs, Fragment } from "react/jsx-runtime";
-import { c } from "react-compiler-runtime";
+import { c } from "react/compiler-runtime";
 import { ClientError, CorsOriginError } from "@sanity/client";
-import { getAuthState, getNodeState, getIsInDashboardState, isStudioConfig, setAuthToken, AuthStateType, getLoginUrlState, observeOrganizationVerificationState, handleAuthCallback, logout, isProjectUserNotFoundClientError, getClientErrorApiDescription, getClientErrorApiBody, getCorsErrorProjectId, createSanityInstance, agentGenerate, agentTransform, agentTranslate, agentPrompt, agentPatch, getTokenState, getCurrentUserState, getDashboardOrganizationId, getClientState, getOrCreateController, getOrCreateChannel, releaseChannel, isDatasetSource, isMediaLibrarySource, isCanvasSource, getFavoritesState, resolveFavoritesState, resolveDatasets, getDatasetsState, applyDocumentActions, resolveDocument, getDocumentState, subscribeDocumentEvents, getPermissionsState, getDocumentSyncStatus, editDocument, getQueryKey, parseQueryKey, getQueryState, resolveQuery, createGroqSearchFilter, getPresence, getPreviewState, resolvePreview, getProjectionState, resolveProjection, resolveProject, getProjectState, resolveProjects, getProjectsState, getActiveReleasesState, getPerspectiveState, getUsersKey, parseUsersKey, getUsersState, resolveUsers, loadMoreUsers } from "@sanity/sdk";
+import { getAuthState, getNodeState, getIsInDashboardState, isStudioConfig, setAuthToken, AuthStateType, getLoginUrlState, observeOrganizationVerificationState, handleAuthCallback, logout, isDatasetResource, isProjectUserNotFoundClientError, getClientErrorApiDescription, getClientErrorApiBody, getCorsErrorProjectId, createSanityInstance, DEFAULT_RESOURCE_NAME, agentGenerate, agentTransform, agentTranslate, agentPrompt, agentPatch, getTokenState, getCurrentUserState, getDashboardOrganizationId, getClientState, getOrCreateController, getOrCreateChannel, releaseChannel, isMediaLibraryResource, isCanvasResource, getFavoritesState, resolveFavoritesState, resolveDatasets, getDatasetsState, applyDocumentActions, resolveDocument, getDocumentState, subscribeDocumentEvents, getPermissionsState, getDocumentSyncStatus, editDocument, getQueryKey, parseQueryKey, getQueryState, resolveQuery, createGroqSearchFilter, getPresence, getProjectionState, resolveProjection, transformProjectionToPreview, PREVIEW_PROJECTION, resolveProject, getProjectState, resolveProjects, getProjectsState, getActiveReleasesState, getPerspectiveState, getUsersKey, parseUsersKey, getUsersState, resolveUsers, loadMoreUsers } from "@sanity/sdk";
 export * from "@sanity/sdk";
 import { createContext, useContext, useSyncExternalStore, useRef, useEffect, useState, Suspense, StrictMode, useCallback, useMemo, useInsertionEffect, useTransition } from "react";
 import { ErrorBoundary } from "react-error-boundary";
 import { SDK_CHANNEL_NAME, SDK_NODE_NAME } from "@sanity/message-protocol";
-import { firstValueFrom, filter, identity, Observable, startWith, distinctUntilChanged, switchMap, EMPTY } from "rxjs";
+import { firstValueFrom, filter, Observable, startWith, distinctUntilChanged, switchMap, EMPTY } from "rxjs";
 import { createRoot } from "react-dom/client";
 import { pick } from "lodash-es";
-const SanityInstanceContext = createContext(null), useSanityInstance = (config) => {
-  const $ = c(3), instance = useContext(SanityInstanceContext);
+const SanityInstanceContext = createContext(null), useSanityInstance = () => {
+  const instance = useContext(SanityInstanceContext);
   if (!instance)
-    throw new Error(`SanityInstance context not found. ${config ? `Requested config: ${JSON.stringify(config, null, 2)}. ` : ""}Please ensure that your component is wrapped in a ResourceProvider or a SanityApp component.`);
-  if (!config)
-    return instance;
-  let t0;
-  $[0] !== config || $[1] !== instance ? (t0 = instance.match(config), $[0] = config, $[1] = instance, $[2] = t0) : t0 = $[2];
-  const match = t0;
-  if (!match)
-    throw new Error(`Could not find a matching Sanity instance for the requested configuration: ${JSON.stringify(config, null, 2)}.
-Please ensure there is a ResourceProvider component with a matching configuration in the component hierarchy.`);
-  return match;
+    throw new Error("SanityInstance context not found. Please ensure that your component is wrapped in a ResourceProvider or a SanityApp component.");
+  return instance;
 };
 function createStateSourceHook(options) {
-  const getState = typeof options == "function" ? options : options.getState, getConfig = "getConfig" in options ? options.getConfig : void 0, suspense = "shouldSuspend" in options && "suspender" in options ? options : void 0;
+  const getState = typeof options == "function" ? options : options.getState, suspense = "shouldSuspend" in options && "suspender" in options ? options : void 0;
   function useHook(...t0) {
-    const $ = c(5), params = t0;
-    let t1;
-    $[0] !== params ? (t1 = getConfig?.(...params), $[0] = params, $[1] = t1) : t1 = $[1];
-    const instance = useSanityInstance(t1);
+    const $ = c(3), params = t0, instance = useSanityInstance();
     if (suspense?.suspender && suspense?.shouldSuspend?.(instance, ...params))
       throw suspense.suspender(instance, ...params);
-    let t2;
-    $[2] !== instance || $[3] !== params ? (t2 = getState(instance, ...params), $[2] = instance, $[3] = params, $[4] = t2) : t2 = $[4];
-    const state = t2;
+    let t1;
+    $[0] !== instance || $[1] !== params ? (t1 = getState(instance, ...params), $[0] = instance, $[1] = params, $[2] = t1) : t1 = $[2];
+    const state = t1;
     return useSyncExternalStore(state.subscribe, state.getCurrent);
   }
   return useHook;
@@ -66,7 +55,7 @@ function useWindowConnection(t0) {
     const [type, handler] = t42, messageUnsubscribe = node.on(type, handler);
     messageUnsubscribe && messageUnsubscribers.current.push(messageUnsubscribe);
   }), () => {
-    messageUnsubscribers.current.forEach(_temp$8), messageUnsubscribers.current = [];
+    messageUnsubscribers.current.forEach(_temp$6), messageUnsubscribers.current = [];
   }), $[4] = node, $[5] = onMessage, $[6] = t3) : t3 = $[6];
   let t4;
   $[7] !== instance || $[8] !== name || $[9] !== node || $[10] !== onMessage ? (t4 = [instance, name, onMessage, node], $[7] = instance, $[8] = name, $[9] = node, $[10] = onMessage, $[11] = t4) : t4 = $[11], useEffect(t3, t4);
@@ -84,7 +73,7 @@ function useWindowConnection(t0) {
     fetch
   }, $[16] = fetch, $[17] = sendMessage, $[18] = t7) : t7 = $[18], t7;
 }
-function _temp$8(unsubscribe) {
+function _temp$6(unsubscribe) {
   return unsubscribe();
 }
 const DEFAULT_RESPONSE_TIMEOUT = 1e4;
@@ -114,7 +103,7 @@ function DashboardTokenRefresh(t0) {
         if (clearRefreshTimeout(), res.token) {
           setAuthToken(instance, res.token);
           const errorContainer = document.getElementById("__sanityError");
-          errorContainer && Array.from(errorContainer.getElementsByTagName("div")).some(_temp$7) && errorContainer.remove();
+          errorContainer && Array.from(errorContainer.getElementsByTagName("div")).some(_temp$5) && errorContainer.remove();
         }
         isTokenRefreshInProgress.current = !1;
       } catch {
@@ -135,7 +124,7 @@ function DashboardTokenRefresh(t0) {
   let t7;
   return $[11] !== authState || $[12] !== requestNewToken ? (t7 = [authState, requestNewToken], $[11] = authState, $[12] = requestNewToken, $[13] = t7) : t7 = $[13], useEffect(t6, t7), children;
 }
-function _temp$7(div) {
+function _temp$5(div) {
   return div.textContent?.includes("Uncaught error: Unauthorized - A valid session is required for this endpoint");
 }
 const ComlinkTokenRefreshProvider = (t0) => {
@@ -290,33 +279,47 @@ function LoginCallback() {
   let t0, t1;
   return $[0] !== handleAuthCallback2 ? (t0 = () => {
     const url = new URL(location.href);
-    handleAuthCallback2(url.toString()).then(_temp$6);
+    handleAuthCallback2(url.toString()).then(_temp$4);
   }, t1 = [handleAuthCallback2], $[0] = handleAuthCallback2, $[1] = t0, $[2] = t1) : (t0 = $[1], t1 = $[2]), useEffect(t0, t1), null;
 }
-function _temp$6(replacementLocation) {
+function _temp$4(replacementLocation) {
   replacementLocation && history.replaceState(null, "", replacementLocation);
 }
-const useLogOut = createCallbackHook(logout);
+const ResourceContext = createContext(void 0), useLogOut = createCallbackHook(logout);
 function LoginError(t0) {
-  const $ = c(18), {
+  const $ = c(25), {
     error,
     resetErrorBoundary
   } = t0;
   if (!(error instanceof AuthError || error instanceof ConfigurationError || error instanceof ClientError))
     throw error;
-  const logout2 = useLogOut(), authState = useAuthState(), [authErrorMessage, setAuthErrorMessage] = useState("Please try again or contact support if the problem persists."), [showRetryCta, setShowRetryCta] = useState(!0);
+  const logout2 = useLogOut(), authState = useAuthState(), resource = useContext(ResourceContext);
   let t1;
-  $[0] !== logout2 || $[1] !== resetErrorBoundary ? (t1 = async () => {
-    await logout2(), resetErrorBoundary();
-  }, $[0] = logout2, $[1] = resetErrorBoundary, $[2] = t1) : t1 = $[2];
-  const handleRetry = t1;
+  $[0] !== resource ? (t1 = resource && isDatasetResource(resource) ? resource.projectId : void 0, $[0] = resource, $[1] = t1) : t1 = $[1];
+  const projectId = t1, [authErrorMessage, setAuthErrorMessage] = useState("Please try again or contact support if the problem persists."), [showRetryCta, setShowRetryCta] = useState(!0);
   let t2;
-  $[3] !== authState.type || $[4] !== error || $[5] !== handleRetry ? (t2 = () => {
+  $[2] === Symbol.for("react.memo_cache_sentinel") ? (t2 = {
+    name: SDK_NODE_NAME,
+    connectTo: SDK_CHANNEL_NAME
+  }, $[2] = t2) : t2 = $[2];
+  const {
+    fetch
+  } = useWindowConnection(t2);
+  let t3;
+  $[3] !== logout2 || $[4] !== resetErrorBoundary ? (t3 = async () => {
+    await logout2(), resetErrorBoundary();
+  }, $[3] = logout2, $[4] = resetErrorBoundary, $[5] = t3) : t3 = $[5];
+  const handleRetry = t3;
+  let t4;
+  $[6] !== authState.type || $[7] !== error || $[8] !== fetch || $[9] !== handleRetry || $[10] !== projectId ? (t4 = () => {
     if (error instanceof ClientError) {
       if (error.statusCode === 401)
         if (isProjectUserNotFoundClientError(error)) {
           const description = getClientErrorApiDescription(error);
-          description && setAuthErrorMessage(description), setShowRetryCta(!1);
+          description && setAuthErrorMessage(description), setShowRetryCta(!1), fetch("dashboard/v1/auth/access/request", {
+            resourceType: "project",
+            resourceId: projectId
+          });
         } else
           setShowRetryCta(!0), handleRetry();
       else if (error.statusCode === 404) {
@@ -325,17 +328,17 @@ function LoginError(t0) {
       }
     }
     authState.type !== AuthStateType.ERROR && error instanceof ConfigurationError && (setAuthErrorMessage(error.message), setShowRetryCta(!0));
-  }, $[3] = authState.type, $[4] = error, $[5] = handleRetry, $[6] = t2) : t2 = $[6];
-  let t3;
-  $[7] !== authState || $[8] !== error || $[9] !== handleRetry ? (t3 = [authState, handleRetry, error], $[7] = authState, $[8] = error, $[9] = handleRetry, $[10] = t3) : t3 = $[10], useEffect(t2, t3);
-  const t4 = error instanceof AuthError ? "Authentication Error" : "Configuration Error";
+  }, $[6] = authState.type, $[7] = error, $[8] = fetch, $[9] = handleRetry, $[10] = projectId, $[11] = t4) : t4 = $[11];
   let t5;
-  $[11] !== handleRetry || $[12] !== showRetryCta ? (t5 = showRetryCta ? {
+  $[12] !== authState || $[13] !== error || $[14] !== fetch || $[15] !== handleRetry || $[16] !== projectId ? (t5 = [authState, handleRetry, error, fetch, projectId], $[12] = authState, $[13] = error, $[14] = fetch, $[15] = handleRetry, $[16] = projectId, $[17] = t5) : t5 = $[17], useEffect(t4, t5);
+  const t6 = error instanceof AuthError ? "Authentication Error" : "Configuration Error";
+  let t7;
+  $[18] !== handleRetry || $[19] !== showRetryCta ? (t7 = showRetryCta ? {
     text: "Retry",
     onClick: handleRetry
-  } : void 0, $[11] = handleRetry, $[12] = showRetryCta, $[13] = t5) : t5 = $[13];
-  let t6;
-  return $[14] !== authErrorMessage || $[15] !== t4 || $[16] !== t5 ? (t6 = /* @__PURE__ */ jsx(Error$1, { heading: t4, description: authErrorMessage, cta: t5 }), $[14] = authErrorMessage, $[15] = t4, $[16] = t5, $[17] = t6) : t6 = $[17], t6;
+  } : void 0, $[18] = handleRetry, $[19] = showRetryCta, $[20] = t7) : t7 = $[20];
+  let t8;
+  return $[21] !== authErrorMessage || $[22] !== t6 || $[23] !== t7 ? (t8 = /* @__PURE__ */ jsx(Error$1, { heading: t6, description: authErrorMessage, cta: t7 }), $[21] = authErrorMessage, $[22] = t6, $[23] = t7, $[24] = t8) : t8 = $[24], t8;
 }
 if (isInIframe() && !document.querySelector("[data-sanity-core]")) {
   const parsedUrl = new URL(window.location.href), mode = new URLSearchParams(parsedUrl.hash.slice(1)).get("mode"), script = document.createElement("script");
@@ -397,132 +400,269 @@ function AuthSwitch(t0) {
 }
 const SDKStudioContext = createContext(null);
 SDKStudioContext.displayName = "SDKStudioContext";
-const DEFAULT_FALLBACK = /* @__PURE__ */ jsx(Fragment, { children: "Warning: No fallback provided. Please supply a fallback prop to ensure proper Suspense handling." });
+const PerspectiveContext = createContext(void 0), DEFAULT_FALLBACK = /* @__PURE__ */ jsx(Fragment, { children: "Warning: No fallback provided. Please supply a fallback prop to ensure proper Suspense handling." });
 function ResourceProvider(t0) {
-  const $ = c(16);
-  let children, config, fallback;
+  const $ = c(19);
+  let children, fallback, resource, rest;
   $[0] !== t0 ? ({
     children,
     fallback,
-    ...config
-  } = t0, $[0] = t0, $[1] = children, $[2] = config, $[3] = fallback) : (children = $[1], config = $[2], fallback = $[3]);
-  const parent = useContext(SanityInstanceContext);
+    resource,
+    ...rest
+  } = t0, $[0] = t0, $[1] = children, $[2] = fallback, $[3] = resource, $[4] = rest) : (children = $[1], fallback = $[2], resource = $[3], rest = $[4]);
+  const parent = useContext(SanityInstanceContext), {
+    perspective,
+    auth,
+    studio
+  } = rest;
+  let t1, t2;
+  $[5] !== auth || $[6] !== perspective || $[7] !== studio ? (t2 = {
+    perspective,
+    auth,
+    studio
+  }, $[5] = auth, $[6] = perspective, $[7] = studio, $[8] = t2) : t2 = $[8], t1 = t2;
+  const config = t1;
+  if (parent) {
+    let t32;
+    return $[9] !== children || $[10] !== fallback || $[11] !== perspective || $[12] !== resource ? (t32 = /* @__PURE__ */ jsx(NestedResourceProvider, { resource, perspective, fallback, children }), $[9] = children, $[10] = fallback, $[11] = perspective, $[12] = resource, $[13] = t32) : t32 = $[13], t32;
+  }
+  let t3;
+  return $[14] !== children || $[15] !== config || $[16] !== fallback || $[17] !== resource ? (t3 = /* @__PURE__ */ jsx(RootResourceProvider, { config, resource, fallback, children }), $[14] = children, $[15] = config, $[16] = fallback, $[17] = resource, $[18] = t3) : t3 = $[18], t3;
+}
+function RootResourceProvider(t0) {
+  const $ = c(17), {
+    children,
+    fallback,
+    config,
+    resource
+  } = t0;
   let t1, t2;
-  $[4] !== config || $[5] !== parent ? (t2 = parent ? parent.createChild(config) : createSanityInstance(config), $[4] = config, $[5] = parent, $[6] = t2) : t2 = $[6], t1 = t2;
+  $[0] !== config ? (t2 = createSanityInstance(config), $[0] = config, $[1] = t2) : t2 = $[1], t1 = t2;
   const instance = t1, disposal = useRef(null);
   let t3, t4;
-  $[7] !== instance ? (t3 = () => (disposal.current !== null && instance === disposal.current.instance && (clearTimeout(disposal.current.timeoutId), disposal.current = null), () => {
+  $[2] !== instance ? (t3 = () => (disposal.current !== null && instance === disposal.current.instance && (clearTimeout(disposal.current.timeoutId), disposal.current = null), () => {
     disposal.current = {
       instance,
       timeoutId: setTimeout(() => {
         instance.isDisposed() || instance.dispose();
       }, 0)
     };
-  }), t4 = [instance], $[7] = instance, $[8] = t3, $[9] = t4) : (t3 = $[8], t4 = $[9]), useEffect(t3, t4);
+  }), t4 = [instance], $[2] = instance, $[3] = t3, $[4] = t4) : (t3 = $[3], t4 = $[4]), useEffect(t3, t4);
   const t5 = fallback ?? DEFAULT_FALLBACK;
   let t6;
-  $[10] !== children || $[11] !== t5 ? (t6 = /* @__PURE__ */ jsx(Suspense, { fallback: t5, children }), $[10] = children, $[11] = t5, $[12] = t6) : t6 = $[12];
+  $[5] !== children || $[6] !== t5 ? (t6 = /* @__PURE__ */ jsx(Suspense, { fallback: t5, children }), $[5] = children, $[6] = t5, $[7] = t6) : t6 = $[7];
   let t7;
-  return $[13] !== instance || $[14] !== t6 ? (t7 = /* @__PURE__ */ jsx(SanityInstanceContext.Provider, { value: instance, children: t6 }), $[13] = instance, $[14] = t6, $[15] = t7) : t7 = $[15], t7;
+  $[8] !== config.perspective || $[9] !== t6 ? (t7 = /* @__PURE__ */ jsx(PerspectiveContext.Provider, { value: config.perspective, children: t6 }), $[8] = config.perspective, $[9] = t6, $[10] = t7) : t7 = $[10];
+  let t8;
+  $[11] !== resource || $[12] !== t7 ? (t8 = /* @__PURE__ */ jsx(ResourceContext.Provider, { value: resource, children: t7 }), $[11] = resource, $[12] = t7, $[13] = t8) : t8 = $[13];
+  let t9;
+  return $[14] !== instance || $[15] !== t8 ? (t9 = /* @__PURE__ */ jsx(SanityInstanceContext.Provider, { value: instance, children: t8 }), $[14] = instance, $[15] = t8, $[16] = t9) : t9 = $[16], t9;
+}
+function NestedResourceProvider(t0) {
+  const $ = c(9), {
+    children,
+    fallback,
+    resource,
+    perspective
+  } = t0, parentResource = useContext(ResourceContext), parentPerspective = useContext(PerspectiveContext), resolvedResource = resource ?? parentResource, resolvedPerspective = perspective ?? parentPerspective, t1 = fallback ?? DEFAULT_FALLBACK;
+  let t2;
+  $[0] !== children || $[1] !== t1 ? (t2 = /* @__PURE__ */ jsx(Suspense, { fallback: t1, children }), $[0] = children, $[1] = t1, $[2] = t2) : t2 = $[2];
+  let t3;
+  $[3] !== resolvedPerspective || $[4] !== t2 ? (t3 = /* @__PURE__ */ jsx(PerspectiveContext.Provider, { value: resolvedPerspective, children: t2 }), $[3] = resolvedPerspective, $[4] = t2, $[5] = t3) : t3 = $[5];
+  let t4;
+  return $[6] !== resolvedResource || $[7] !== t3 ? (t4 = /* @__PURE__ */ jsx(ResourceContext.Provider, { value: resolvedResource, children: t3 }), $[6] = resolvedResource, $[7] = t3, $[8] = t4) : t4 = $[8], t4;
+}
+const ResourcesContext = createContext({});
+function collectProjectIds(resources) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const res of Object.values(resources))
+    isDatasetResource(res) && ids.add(res.projectId);
+  return [...ids];
 }
-const SourcesContext = createContext({});
 function SDKProvider(t0) {
-  const $ = c(19);
-  let children, config, fallback, props;
+  const $ = c(22);
+  let children, config, fallback, props, t1;
   $[0] !== t0 ? ({
     children,
     config,
+    resources: t1,
     fallback,
     ...props
-  } = t0, $[0] = t0, $[1] = children, $[2] = config, $[3] = fallback, $[4] = props) : (children = $[1], config = $[2], fallback = $[3], props = $[4]);
-  let t1;
-  $[5] !== config ? (t1 = Array.isArray(config) ? config : [config], $[5] = config, $[6] = t1) : t1 = $[6];
-  let configs, t2;
-  $[7] !== t1 ? (configs = t1.slice().reverse(), t2 = configs.map(_temp$5).filter(_temp2$1), $[7] = t1, $[8] = configs, $[9] = t2) : (configs = $[8], t2 = $[9]);
-  const projectIds = t2;
+  } = t0, $[0] = t0, $[1] = children, $[2] = config, $[3] = fallback, $[4] = props, $[5] = t1) : (children = $[1], config = $[2], fallback = $[3], props = $[4], t1 = $[5]);
+  let t2;
+  $[6] !== t1 ? (t2 = t1 === void 0 ? {} : t1, $[6] = t1, $[7] = t2) : t2 = $[7];
+  const resources = t2;
   let t3, t4;
-  $[10] !== props.sources ? (t4 = props.sources ?? {}, $[10] = props.sources, $[11] = t4) : t4 = $[11], t3 = t4;
-  const sourcesValue = t3;
+  $[8] !== resources ? (t4 = collectProjectIds(resources), $[8] = resources, $[9] = t4) : t4 = $[9], t3 = t4;
+  const projectIds = t3;
   let t5;
-  if ($[12] !== children || $[13] !== configs || $[14] !== fallback || $[15] !== projectIds || $[16] !== props || $[17] !== sourcesValue) {
-    const createNestedProviders = (index) => index >= configs.length ? /* @__PURE__ */ jsx(AuthBoundary, { ...props, projectIds, children: /* @__PURE__ */ jsx(SourcesContext.Provider, { value: sourcesValue, children }) }) : /* @__PURE__ */ jsx(ResourceProvider, { ...configs[index], fallback, children: createNestedProviders(index + 1) });
-    t5 = createNestedProviders(0), $[12] = children, $[13] = configs, $[14] = fallback, $[15] = projectIds, $[16] = props, $[17] = sourcesValue, $[18] = t5;
-  } else
-    t5 = $[18];
-  return t5;
-}
-function _temp2$1(id) {
-  return !!id;
-}
-function _temp$5(c2) {
-  return c2.projectId;
+  t5 = resources[DEFAULT_RESOURCE_NAME];
+  const rootResource = t5;
+  let t6;
+  $[10] !== children || $[11] !== resources ? (t6 = /* @__PURE__ */ jsx(ResourcesContext.Provider, { value: resources, children }), $[10] = children, $[11] = resources, $[12] = t6) : t6 = $[12];
+  let t7;
+  $[13] !== projectIds || $[14] !== props || $[15] !== t6 ? (t7 = /* @__PURE__ */ jsx(AuthBoundary, { ...props, projectIds, children: t6 }), $[13] = projectIds, $[14] = props, $[15] = t6, $[16] = t7) : t7 = $[16];
+  let t8;
+  return $[17] !== config || $[18] !== fallback || $[19] !== rootResource || $[20] !== t7 ? (t8 = /* @__PURE__ */ jsx(ResourceProvider, { ...config, resource: rootResource, fallback, children: t7 }), $[17] = config, $[18] = fallback, $[19] = rootResource, $[20] = t7, $[21] = t8) : t8 = $[21], t8;
 }
 const REDIRECT_URL = "https://sanity.io/welcome";
-function deriveConfigFromWorkspace(workspace) {
+function deriveFromWorkspace(workspace) {
   return {
-    projectId: workspace.projectId,
-    dataset: workspace.dataset,
-    studio: {
-      auth: workspace.auth.token ? {
-        token: workspace.auth.token
-      } : void 0
+    config: {
+      studio: {
+        authenticated: workspace.authenticated,
+        auth: workspace.auth.token ? {
+          token: workspace.auth.token
+        } : void 0,
+        projectId: workspace.projectId
+      }
+    },
+    resources: {
+      [DEFAULT_RESOURCE_NAME]: {
+        projectId: workspace.projectId,
+        dataset: workspace.dataset
+      }
     }
   };
 }
 function SanityApp(t0) {
-  const $ = c(18);
-  let children, configProp, fallback, props;
+  const $ = c(21);
+  let children, configProp, fallback, props, resourcesProp;
   $[0] !== t0 ? ({
     children,
     fallback,
     config: configProp,
+    resources: resourcesProp,
     ...props
-  } = t0, $[0] = t0, $[1] = children, $[2] = configProp, $[3] = fallback, $[4] = props) : (children = $[1], configProp = $[2], fallback = $[3], props = $[4]);
+  } = t0, $[0] = t0, $[1] = children, $[2] = configProp, $[3] = fallback, $[4] = props, $[5] = resourcesProp) : (children = $[1], configProp = $[2], fallback = $[3], props = $[4], resourcesProp = $[5]);
   const studioWorkspace = useContext(SDKStudioContext);
   let t1;
   bb0: {
-    if (configProp) {
-      t1 = configProp;
+    if (studioWorkspace && !configProp && !resourcesProp) {
+      let t22;
+      $[6] !== studioWorkspace ? (t22 = deriveFromWorkspace(studioWorkspace), $[6] = studioWorkspace, $[7] = t22) : t22 = $[7], t1 = t22;
       break bb0;
     }
-    if (studioWorkspace) {
-      let t23;
-      $[5] !== studioWorkspace ? (t23 = deriveConfigFromWorkspace(studioWorkspace), $[5] = studioWorkspace, $[6] = t23) : t23 = $[6], t1 = t23;
-      break bb0;
+    t1 = null;
+  }
+  const derived = t1;
+  let t2;
+  bb1: {
+    if (configProp) {
+      t2 = configProp;
+      break bb1;
+    }
+    if (derived) {
+      t2 = derived.config;
+      break bb1;
     }
-    let t22;
-    $[7] === Symbol.for("react.memo_cache_sentinel") ? (t22 = [], $[7] = t22) : t22 = $[7], t1 = t22;
+    let t32;
+    $[8] === Symbol.for("react.memo_cache_sentinel") ? (t32 = {}, $[8] = t32) : t32 = $[8], t2 = t32;
   }
-  const resolvedConfig = t1;
-  let t2, t3;
-  $[8] !== configProp || $[9] !== resolvedConfig || $[10] !== studioWorkspace ? (t2 = () => {
+  const resolvedConfig = t2;
+  let t3;
+  bb2: {
+    if (resourcesProp) {
+      t3 = resourcesProp;
+      break bb2;
+    }
+    if (derived) {
+      t3 = derived.resources;
+      break bb2;
+    }
+    let t42;
+    $[9] === Symbol.for("react.memo_cache_sentinel") ? (t42 = {}, $[9] = t42) : t42 = $[9], t3 = t42;
+  }
+  const resolvedResources = t3;
+  let t4, t5;
+  $[10] !== configProp || $[11] !== resolvedConfig || $[12] !== studioWorkspace ? (t4 = () => {
     let timeout;
-    const primaryConfig = Array.isArray(resolvedConfig) ? resolvedConfig[0] : resolvedConfig, shouldRedirectWithoutConfig = configProp === void 0 && !studioWorkspace && !primaryConfig;
-    return !isInIframe() && !isLocalUrl(window) && (shouldRedirectWithoutConfig || primaryConfig && !isStudioConfig(primaryConfig)) && (timeout = setTimeout(_temp$4, 1e3)), () => clearTimeout(timeout);
-  }, t3 = [configProp, resolvedConfig, studioWorkspace], $[8] = configProp, $[9] = resolvedConfig, $[10] = studioWorkspace, $[11] = t2, $[12] = t3) : (t2 = $[11], t3 = $[12]), useEffect(t2, t3);
-  let t4;
-  return $[13] !== children || $[14] !== fallback || $[15] !== props || $[16] !== resolvedConfig ? (t4 = /* @__PURE__ */ jsx(SDKProvider, { ...props, fallback, config: resolvedConfig, children }), $[13] = children, $[14] = fallback, $[15] = props, $[16] = resolvedConfig, $[17] = t4) : t4 = $[17], t4;
+    const shouldRedirectWithoutConfig = configProp === void 0 && !studioWorkspace && !resolvedConfig;
+    return !isInIframe() && !isLocalUrl(window) && (shouldRedirectWithoutConfig || resolvedConfig && !isStudioConfig(resolvedConfig)) && (timeout = setTimeout(_temp$3, 1e3)), () => clearTimeout(timeout);
+  }, t5 = [configProp, resolvedConfig, studioWorkspace], $[10] = configProp, $[11] = resolvedConfig, $[12] = studioWorkspace, $[13] = t4, $[14] = t5) : (t4 = $[13], t5 = $[14]), useEffect(t4, t5);
+  let t6;
+  return $[15] !== children || $[16] !== fallback || $[17] !== props || $[18] !== resolvedConfig || $[19] !== resolvedResources ? (t6 = /* @__PURE__ */ jsx(SDKProvider, { ...props, fallback, config: resolvedConfig, resources: resolvedResources, children }), $[15] = children, $[16] = fallback, $[17] = props, $[18] = resolvedConfig, $[19] = resolvedResources, $[20] = t6) : t6 = $[20], t6;
 }
-function _temp$4() {
+function _temp$3() {
   console.warn("Redirecting to core", REDIRECT_URL), window.location.replace(REDIRECT_URL);
 }
-function renderSanityApp(rootElement, namedSources, options, children) {
+function renderSanityApp(rootElement, namedResources, options, children) {
   if (!rootElement)
     throw new Error("Missing root element to mount application into");
   const {
     reactStrictMode = !1
-  } = options, root = createRoot(rootElement), config = Object.values(namedSources);
-  return root.render(reactStrictMode ? /* @__PURE__ */ jsx(StrictMode, { children: /* @__PURE__ */ jsx(SanityApp, { config, fallback: /* @__PURE__ */ jsx("div", { children: "Loading..." }), children }) }) : /* @__PURE__ */ jsx(SanityApp, { config, fallback: /* @__PURE__ */ jsx("div", { children: "Loading..." }), children })), () => root.unmount();
+  } = options, root = createRoot(rootElement);
+  return root.render(reactStrictMode ? /* @__PURE__ */ jsx(StrictMode, { children: /* @__PURE__ */ jsx(SanityApp, { resources: namedResources, fallback: /* @__PURE__ */ jsx("div", { children: "Loading..." }), children }) }) : /* @__PURE__ */ jsx(SanityApp, { resources: namedResources, fallback: /* @__PURE__ */ jsx("div", { children: "Loading..." }), children })), () => root.unmount();
+}
+function normalizeResourceOptions(options, resources, contextResource, contextPerspective) {
+  const {
+    resourceName,
+    ...rest
+  } = options;
+  if (resourceName && Object.hasOwn(options, "resource"))
+    throw new Error(`Resource name ${JSON.stringify(resourceName)} and resource ${JSON.stringify(options.resource)} cannot be used together.`);
+  let resolvedResource = options.resource;
+  if (!resolvedResource && resourceName) {
+    if (!Object.hasOwn(resources, resourceName))
+      throw new Error(`There's no resource named ${JSON.stringify(resourceName)} in context. Register it via the resources prop on <SanityApp>.`);
+    resolvedResource = resources[resourceName];
+  }
+  if (resolvedResource || (resolvedResource = contextResource), resolvedResource === void 0)
+    throw new Error("A resource is required. Provide `resource`, `resourceName`, or ensure a default resource is available from context (e.g. via <ResourceProvider> or <SanityApp>).");
+  const resolvedPerspective = Object.hasOwn(options, "perspective") ? options.perspective : contextPerspective;
+  return {
+    ...rest,
+    resource: resolvedResource,
+    ...resolvedPerspective !== void 0 && {
+      perspective: resolvedPerspective
+    }
+  };
+}
+function useNormalizedResourceOptions(options) {
+  const $ = c(5), resources = useContext(ResourcesContext), contextResource = useContext(ResourceContext), contextPerspective = useContext(PerspectiveContext);
+  let t0;
+  return $[0] !== contextPerspective || $[1] !== contextResource || $[2] !== options || $[3] !== resources ? (t0 = normalizeResourceOptions(options, resources, contextResource, contextPerspective), $[0] = contextPerspective, $[1] = contextResource, $[2] = options, $[3] = resources, $[4] = t0) : t0 = $[4], t0;
+}
+function useAgentCallback(action) {
+  const $ = c(5), instance = useSanityInstance(), resources = useContext(ResourcesContext), contextResource = useContext(ResourceContext);
+  let t0;
+  return $[0] !== action || $[1] !== contextResource || $[2] !== instance || $[3] !== resources ? (t0 = (options) => {
+    const {
+      resource
+    } = normalizeResourceOptions({
+      resource: options.resource,
+      resourceName: options.resourceName
+    }, resources, contextResource), {
+      resourceName: _,
+      ...rest
+    } = options;
+    return action(instance, {
+      ...rest,
+      resource
+    });
+  }, $[0] = action, $[1] = contextResource, $[2] = instance, $[3] = resources, $[4] = t0) : t0 = $[4], t0;
+}
+function useAgentGenerate() {
+  return useAgentCallback(agentGenerate);
+}
+function useAgentTransform() {
+  return useAgentCallback(agentTransform);
+}
+function useAgentTranslate() {
+  return useAgentCallback(agentTranslate);
 }
-const useAgentGenerate = createCallbackHook(agentGenerate), useAgentTransform = createCallbackHook(agentTransform), useAgentTranslate = createCallbackHook(agentTranslate);
 function promptAdapter(instance, options) {
   return firstValueFrom(agentPrompt(instance, options));
 }
-const useAgentPrompt = createCallbackHook(promptAdapter);
+function useAgentPrompt() {
+  return useAgentCallback(promptAdapter);
+}
 function patchAdapter(instance, options) {
   return firstValueFrom(agentPatch(instance, options));
 }
-const useAgentPatch = createCallbackHook(patchAdapter);
+function useAgentPatch() {
+  return useAgentCallback(patchAdapter);
+}
 function useAgentResourceContext(options) {
   const $ = c(9), {
     projectId,
@@ -584,8 +724,7 @@ const useClient = createStateSourceHook({
     if (!options || typeof options != "object")
       throw new Error('useClient() requires a configuration object with at least an "apiVersion" property. Example: useClient({ apiVersion: "2024-11-12" })');
     return getClientState(instance, options);
-  },
-  getConfig: (options) => options
+  }
 });
 function useFrameConnection(options) {
   const $ = c(12), {
@@ -611,7 +750,7 @@ function useFrameConnection(options) {
       const [type, handler] = t22, unsubscribe = channel.on(type, handler);
       messageUnsubscribers.push(unsubscribe);
     }), () => {
-      messageUnsubscribers.forEach(_temp$3), releaseChannel(instance, name), channelRef.current = null, controllerRef.current = null;
+      messageUnsubscribers.forEach(_temp$2), releaseChannel(instance, name), channelRef.current = null, controllerRef.current = null;
     };
   }, t1 = [targetOrigin, name, connectTo, heartbeat, onMessage, instance, onStatus], $[0] = connectTo, $[1] = heartbeat, $[2] = instance, $[3] = name, $[4] = onMessage, $[5] = onStatus, $[6] = targetOrigin, $[7] = t0, $[8] = t1) : (t0 = $[7], t1 = $[8]), useEffect(t0, t1);
   let t2;
@@ -633,9 +772,12 @@ function useFrameConnection(options) {
     sendMessage
   }, $[11] = t4) : t4 = $[11], t4;
 }
-function _temp$3(unsub) {
+function _temp$2(unsub) {
   return unsub();
 }
+function useResource() {
+  return useContext(ResourceContext);
+}
 function useDashboardNavigate(navigateFn) {
   const $ = c(2);
   let t0;
@@ -649,33 +791,12 @@ function useDashboardNavigate(navigateFn) {
     }
   }, $[0] = navigateFn, $[1] = t0) : t0 = $[1], useWindowConnection(t0);
 }
-function useNormalizedSourceOptions(options) {
-  const $ = c(6);
-  let rest, sourceName;
-  if ($[0] !== options ? ({
-    sourceName,
-    ...rest
-  } = options, $[0] = options, $[1] = rest, $[2] = sourceName) : (rest = $[1], sourceName = $[2]), sourceName && Object.hasOwn(options, "source"))
-    throw new Error(`Source name ${JSON.stringify(sourceName)} and source ${JSON.stringify(options.source)} cannot be used together.`);
-  const sources = useContext(SourcesContext);
-  let resolvedSource;
-  if (options.source && (resolvedSource = options.source), sourceName && !Object.hasOwn(sources, sourceName))
-    throw new Error(`There's no source named ${JSON.stringify(sourceName)} in context. Please use <SourceProvider>.`);
-  sourceName && sources[sourceName] && (resolvedSource = sources[sourceName]);
-  let t0;
-  return $[3] !== resolvedSource || $[4] !== rest ? (t0 = {
-    ...rest,
-    source: resolvedSource
-  }, $[3] = resolvedSource, $[4] = rest, $[5] = t0) : t0 = $[5], t0;
-}
 function useResourceIdFromDocumentHandle(documentHandle) {
-  const $ = c(3), options = useNormalizedSourceOptions(documentHandle), {
-    projectId,
-    dataset,
-    source
+  const $ = c(3), options = useNormalizedResourceOptions(documentHandle), {
+    resource
   } = options;
   let resourceId = "", resourceType;
-  projectId && dataset && (resourceId = `${projectId}.${dataset}`), source && (isDatasetSource(source) ? (resourceId = `${source.projectId}.${source.dataset}`, resourceType = void 0) : isMediaLibrarySource(source) ? (resourceId = source.mediaLibraryId, resourceType = "media-library") : isCanvasSource(source) && (resourceId = source.canvasId, resourceType = "canvas"));
+  resource && (isDatasetResource(resource) ? (resourceId = `${resource.projectId}.${resource.dataset}`, resourceType = void 0) : isMediaLibraryResource(resource) ? (resourceId = resource.mediaLibraryId, resourceType = "media-library") : isCanvasResource(resource) && (resourceId = resource.canvasId, resourceType = "canvas"));
   let t0;
   return $[0] !== resourceId || $[1] !== resourceType ? (t0 = {
     id: resourceId,
@@ -700,7 +821,7 @@ function useDispatchIntent(params) {
         if (!action && !intentId)
           throw new Error("useDispatchIntent: Either `action` or `intentId` must be provided.");
         if (action && intentId && console.warn("useDispatchIntent: Both `action` and `intentId` were provided. Using `intentId` and ignoring `action`."), !resource.id)
-          throw new Error("useDispatchIntent: Unable to determine resource. Either `source`, `sourceName`, or both `projectId` and `dataset` must be provided in documentHandle.");
+          throw new Error("useDispatchIntent: Unable to determine resource. Either `resource`, `resourceName`, or both `projectId` and `dataset` must be provided in documentHandle.");
         const message = {
           type: "dashboard/v1/events/intents/dispatch-intent",
           data: {
@@ -735,8 +856,7 @@ function useDispatchIntent(params) {
 function useManageFavorite({
   documentId,
   documentType,
-  projectId: paramProjectId,
-  dataset: paramDataset,
+  resource: paramResource,
   resourceId: paramResourceId,
   resourceType,
   schemaName
@@ -746,21 +866,22 @@ function useManageFavorite({
   } = useWindowConnection({
     name: SDK_NODE_NAME,
     connectTo: SDK_CHANNEL_NAME
-  }), instance = useSanityInstance(), {
-    config
-  } = instance, instanceProjectId = config?.projectId, instanceDataset = config?.dataset, projectId = paramProjectId ?? instanceProjectId, dataset = paramDataset ?? instanceDataset;
+  }), instance = useSanityInstance(), contextResource = useContext(ResourceContext), resource = paramResource ?? contextResource, datasetResource = resource && isDatasetResource(resource) ? resource : void 0, projectId = datasetResource?.projectId, dataset = datasetResource?.dataset;
   if (resourceType === "studio" && (!projectId || !dataset))
     throw new Error("projectId and dataset are required for studio resources");
   const resourceId = resourceType === "studio" && !paramResourceId ? `${projectId}.${dataset}` : paramResourceId;
   if (!resourceId)
     throw new Error("resourceId is required for media-library and canvas resources");
+  if (!resource)
+    throw new Error("resource is required");
   const context = useMemo(() => ({
     documentId,
     documentType,
+    resource,
     resourceId,
     resourceType,
     schemaName
-  }), [documentId, documentType, resourceId, resourceType, schemaName]), favoriteState = getFavoritesState(instance, context), isFavorited = useSyncExternalStore(favoriteState.subscribe, favoriteState.getCurrent)?.isFavorited ?? !1, handleFavoriteAction = useCallback(async (action) => {
+  }), [documentId, documentType, resource, resourceId, resourceType, schemaName]), favoriteState = getFavoritesState(instance, context), isFavorited = useSyncExternalStore(favoriteState.subscribe, favoriteState.getCurrent)?.isFavorited ?? !1, handleFavoriteAction = useCallback(async (action) => {
     if (!(!fetch || !documentId || !documentType || !resourceType))
       try {
         const payload = {
@@ -854,9 +975,8 @@ function useNavigateToStudioDocument(documentHandle, preferredStudioUrl) {
   let t1;
   $[1] !== documentHandle || $[2] !== preferredStudioUrl || $[3] !== sendMessage || $[4] !== workspacesByProjectIdAndDataset ? (t1 = () => {
     const {
-      projectId,
-      dataset
-    } = documentHandle;
+      resource
+    } = documentHandle, datasetResource = resource && isDatasetResource(resource) ? resource : void 0, projectId = datasetResource?.projectId, dataset = datasetResource?.dataset;
     if (!projectId || !dataset) {
       console.warn("Project ID and dataset are required to navigate to a studio document");
       return;
@@ -938,46 +1058,27 @@ function useRecordDocumentHistoryEvent(t0) {
 }
 const useDatasets = createStateSourceHook({
   getState: getDatasetsState,
-  shouldSuspend: (instance, projectHandle) => (
-    // remove `undefined` since we're suspending when that is the case
-    getDatasetsState(instance, projectHandle).getCurrent() === void 0
-  ),
-  suspender: resolveDatasets,
-  getConfig: identity
+  shouldSuspend: (instance, options) => getDatasetsState(instance, options).getCurrent() === void 0,
+  suspender: resolveDatasets
 }), useApplyDocumentActions = () => {
-  const $ = c(2), instance = useSanityInstance();
+  const $ = c(4), instance = useSanityInstance(), resources = useContext(ResourcesContext), contextResource = useContext(ResourceContext);
   let t0;
-  return $[0] !== instance ? (t0 = (actionOrActions, options) => {
-    const actions = Array.isArray(actionOrActions) ? actionOrActions : [actionOrActions];
-    let projectId, dataset;
-    for (const action of actions)
-      if (action.projectId) {
-        if (projectId || (projectId = action.projectId), action.projectId !== projectId)
-          throw new Error(`Mismatched project IDs found in actions. All actions must belong to the same project. Found "${action.projectId}" but expected "${projectId}".`);
-        if (action.dataset && (dataset || (dataset = action.dataset), action.dataset !== dataset))
-          throw new Error(`Mismatched datasets found in actions. All actions must belong to the same dataset. Found "${action.dataset}" but expected "${dataset}".`);
-      }
-    if (projectId || dataset) {
-      const actualInstance = instance.match({
-        projectId,
-        dataset
-      });
-      if (!actualInstance)
-        throw new Error(`Could not find a matching Sanity instance for the requested action: ${JSON.stringify({
-          projectId,
-          dataset
-        }, null, 2)}.
-  Please ensure there is a ResourceProvider component with a matching configuration in the component hierarchy.`);
-      return applyDocumentActions(actualInstance, {
-        actions,
-        ...options
-      });
-    }
+  return $[0] !== contextResource || $[1] !== instance || $[2] !== resources ? (t0 = (actionOrActions, options) => {
+    const actions = Array.isArray(actionOrActions) ? actionOrActions : [actionOrActions], optionsResource = options ? normalizeResourceOptions(options, resources, contextResource).resource : void 0, normalizedActions = actions.map((action) => normalizeResourceOptions(action, resources, contextResource));
+    let resource;
+    for (const action_0 of normalizedActions)
+      if (resource || (resource = action_0.resource), action_0.resource !== resource)
+        throw new Error(`Mismatched resources found in actions. All actions must belong to the same resource. Found "${JSON.stringify(action_0.resource)}" but expected "${JSON.stringify(resource)}".`);
+    if (optionsResource && resource && optionsResource !== resource)
+      throw new Error(`Mismatched resources found in actions. Found top-level resource "${JSON.stringify(optionsResource)}" but expected resource from action handles "${JSON.stringify(resource)}".`);
+    const effectiveResource = resource ?? optionsResource;
+    if (!effectiveResource)
+      throw new Error("No resource found. Provide a resource via the action handle or context.");
     return applyDocumentActions(instance, {
       actions,
-      ...options
+      resource: effectiveResource
     });
-  }, $[0] = instance, $[1] = t0) : t0 = $[1], t0;
+  }, $[0] = contextResource, $[1] = instance, $[2] = resources, $[3] = t0) : t0 = $[3], t0;
 }, useDocumentValue = createStateSourceHook({
   // Pass options directly to getDocumentState
   getState: (instance, options) => getDocumentState(instance, options),
@@ -987,8 +1088,7 @@ const useDatasets = createStateSourceHook({
     ...options
   }) => getDocumentState(instance, options).getCurrent() === void 0,
   // Extract handle part for resolveDocument
-  suspender: (instance, options) => resolveDocument(instance, options),
-  getConfig: identity
+  suspender: (instance, options) => resolveDocument(instance, options)
 }), wrapHookWithData = (useValue) => {
   function useHook(...params) {
     return {
@@ -996,14 +1096,17 @@ const useDatasets = createStateSourceHook({
     };
   }
   return useHook;
-}, useDocument = wrapHookWithData(useDocumentValue);
+}, useDocument = wrapHookWithData((options) => {
+  const normalizedOptions = useNormalizedResourceOptions(options);
+  return useDocumentValue(normalizedOptions);
+});
 function useDocumentEvent(options) {
-  const $ = c(9);
+  const $ = c(10), normalizedOptions = useNormalizedResourceOptions(options);
   let datasetHandle, onEvent;
-  $[0] !== options ? ({
+  $[0] !== normalizedOptions ? ({
     onEvent,
     ...datasetHandle
-  } = options, $[0] = options, $[1] = datasetHandle, $[2] = onEvent) : (datasetHandle = $[1], onEvent = $[2]);
+  } = normalizedOptions, $[0] = normalizedOptions, $[1] = datasetHandle, $[2] = onEvent) : (datasetHandle = $[1], onEvent = $[2]);
   const ref = useRef(onEvent);
   let t0;
   $[3] !== onEvent ? (t0 = () => {
@@ -1011,58 +1114,42 @@ function useDocumentEvent(options) {
   }, $[3] = onEvent, $[4] = t0) : t0 = $[4], useInsertionEffect(t0);
   let t1;
   $[5] === Symbol.for("react.memo_cache_sentinel") ? (t1 = (documentEvent) => ref.current(documentEvent), $[5] = t1) : t1 = $[5];
-  const stableHandler = t1, instance = useSanityInstance(datasetHandle);
+  const stableHandler = t1, instance = useSanityInstance();
   let t2, t3;
-  $[6] !== instance ? (t2 = () => subscribeDocumentEvents(instance, stableHandler), t3 = [instance, stableHandler], $[6] = instance, $[7] = t2, $[8] = t3) : (t2 = $[7], t3 = $[8]), useEffect(t2, t3);
+  $[6] !== datasetHandle.resource || $[7] !== instance ? (t2 = () => subscribeDocumentEvents(instance, {
+    eventHandler: stableHandler,
+    resource: datasetHandle.resource
+  }), t3 = [instance, datasetHandle.resource, stableHandler], $[6] = datasetHandle.resource, $[7] = instance, $[8] = t2, $[9] = t3) : (t2 = $[8], t3 = $[9]), useEffect(t2, t3);
 }
 function useDocumentPermissions(actionOrActions) {
-  const $ = c(13);
-  let t0, t1;
-  $[0] !== actionOrActions ? (t1 = Array.isArray(actionOrActions) ? actionOrActions : [actionOrActions], $[0] = actionOrActions, $[1] = t1) : t1 = $[1], t0 = t1;
-  const actions = t0;
-  let projectId, dataset;
-  if ($[2] !== actions || $[3] !== dataset || $[4] !== projectId) {
-    for (const action of actions)
-      if (action.projectId) {
-        if (projectId || (projectId = action.projectId), action.projectId !== projectId)
-          throw new Error(`Mismatched project IDs found in actions. All actions must belong to the same project. Found "${action.projectId}" but expected "${projectId}".`);
-        if (action.dataset && (dataset || (dataset = action.dataset), action.dataset !== dataset))
-          throw new Error(`Mismatched datasets found in actions. All actions must belong to the same dataset. Found "${action.dataset}" but expected "${dataset}".`);
-      }
-    $[2] = actions, $[3] = dataset, $[4] = projectId, $[5] = projectId, $[6] = dataset;
-  } else
-    projectId = $[5], dataset = $[6];
-  let t2;
-  $[7] !== dataset || $[8] !== projectId ? (t2 = {
-    projectId,
-    dataset
-  }, $[7] = dataset, $[8] = projectId, $[9] = t2) : t2 = $[9];
-  const instance = useSanityInstance(t2);
-  if (getPermissionsState(instance, {
-    actions
-  }).getCurrent() === void 0)
-    throw firstValueFrom(getPermissionsState(instance, {
-      actions
-    }).observable.pipe(filter(_temp$2)));
-  let t3, t4;
-  $[10] !== actions || $[11] !== instance ? (t4 = getPermissionsState(instance, {
-    actions
-  }), $[10] = actions, $[11] = instance, $[12] = t4) : t4 = $[12], t3 = t4;
+  const instance = useSanityInstance(), contextResource = useContext(ResourceContext), resources = useContext(ResourcesContext), normalizedActions = useMemo(() => Array.isArray(actionOrActions) ? actionOrActions.map((action) => normalizeResourceOptions(action, resources, contextResource)) : [normalizeResourceOptions(actionOrActions, resources, contextResource)], [actionOrActions, resources, contextResource]);
+  let resource;
+  for (const action_0 of normalizedActions)
+    if (action_0.resource && (resource || (resource = action_0.resource), action_0.resource !== resource))
+      throw new Error(`Mismatched resources found in actions. All actions must belong to the same resource. Found "${JSON.stringify(action_0.resource)}" but expected "${JSON.stringify(resource)}".`);
+  const effectiveResource = resource ?? contextResource;
+  if (!effectiveResource)
+    throw new Error("No resource found. Provide a resource via the action handle or wrap with a resource context.");
+  const permissionsOptions = useMemo(() => ({
+    resource: effectiveResource,
+    actions: normalizedActions
+  }), [effectiveResource, normalizedActions]);
+  if (!useCallback(() => getPermissionsState(instance, permissionsOptions).getCurrent() !== void 0, [permissionsOptions, instance])())
+    throw firstValueFrom(getPermissionsState(instance, permissionsOptions).observable.pipe(filter((result) => result !== void 0)));
   const {
     subscribe,
     getCurrent
-  } = t3;
+  } = useMemo(() => getPermissionsState(instance, permissionsOptions), [permissionsOptions, instance]);
   return useSyncExternalStore(subscribe, getCurrent);
 }
-function _temp$2(result) {
-  return result !== void 0;
-}
-const useDocumentSyncStatus = createStateSourceHook({
+const useDocumentSyncStatusValue = createStateSourceHook({
   getState: getDocumentSyncStatus,
   shouldSuspend: (instance, doc) => getDocumentSyncStatus(instance, doc).getCurrent() === void 0,
-  suspender: (instance, doc) => resolveDocument(instance, doc),
-  getConfig: identity
-}), ignoredKeys = ["_id", "_type", "_createdAt", "_updatedAt", "_rev"];
+  suspender: (instance, doc) => resolveDocument(instance, doc)
+}), useDocumentSyncStatus = (options) => {
+  const normalizedOptions = useNormalizedResourceOptions(options);
+  return useDocumentSyncStatusValue(normalizedOptions);
+}, ignoredKeys = ["_id", "_type", "_createdAt", "_updatedAt", "_rev"];
 function useEditDocument(t0) {
   const $ = c(8);
   let doc, path;
@@ -1070,25 +1157,25 @@ function useEditDocument(t0) {
     path,
     ...doc
   } = t0, $[0] = t0, $[1] = doc, $[2] = path) : (doc = $[1], path = $[2]);
-  const instance = useSanityInstance(doc), apply = useApplyDocumentActions();
-  if (getDocumentState(instance, doc).getCurrent() === void 0)
-    throw resolveDocument(instance, doc);
+  const instance = useSanityInstance(), normalizedDoc = useNormalizedResourceOptions(doc), apply = useApplyDocumentActions();
+  if (getDocumentState(instance, normalizedDoc).getCurrent() === void 0)
+    throw resolveDocument(instance, normalizedDoc);
   let t1;
-  return $[3] !== apply || $[4] !== doc || $[5] !== instance || $[6] !== path ? (t1 = (updater) => {
+  return $[3] !== apply || $[4] !== instance || $[5] !== normalizedDoc || $[6] !== path ? (t1 = (updater) => {
     const currentPath = path;
     if (currentPath) {
       const currentValue = getDocumentState(instance, {
-        ...doc,
+        ...normalizedDoc,
         path
       }).getCurrent(), nextValue = typeof updater == "function" ? updater(currentValue) : updater;
-      return apply(editDocument(doc, {
+      return apply(editDocument(normalizedDoc, {
         set: {
           [currentPath]: nextValue
         }
       }));
     }
     const current = getDocumentState(instance, {
-      ...doc,
+      ...normalizedDoc,
       path
     }).getCurrent(), nextValue_0 = typeof updater == "function" ? updater(current) : updater;
     if (typeof nextValue_0 != "object" || !nextValue_0)
@@ -1096,21 +1183,21 @@ function useEditDocument(t0) {
     const editActions = Object.keys({
       ...current,
       ...nextValue_0
-    }).filter(_temp$1).filter((key_0) => current?.[key_0] !== nextValue_0[key_0]).map((key_1) => key_1 in nextValue_0 ? editDocument(doc, {
+    }).filter(_temp$1).filter((key_0) => current?.[key_0] !== nextValue_0[key_0]).map((key_1) => key_1 in nextValue_0 ? editDocument(normalizedDoc, {
       set: {
         [key_1]: nextValue_0[key_1]
       }
-    }) : editDocument(doc, {
+    }) : editDocument(normalizedDoc, {
       unset: [key_1]
     }));
     return apply(editActions);
-  }, $[3] = apply, $[4] = doc, $[5] = instance, $[6] = path, $[7] = t1) : t1 = $[7], t1;
+  }, $[3] = apply, $[4] = instance, $[5] = normalizedDoc, $[6] = path, $[7] = t1) : t1 = $[7], t1;
 }
 function _temp$1(key) {
   return !ignoredKeys.includes(key);
 }
 function useQuery(options) {
-  const instance = useSanityInstance(options), normalized = useNormalizedSourceOptions(options), [isPending, startTransition] = useTransition(), queryKey = getQueryKey(normalized), [deferredQueryKey, setDeferredQueryKey] = useState(queryKey), ref = useRef(new AbortController());
+  const instance = useSanityInstance(), normalized = useNormalizedResourceOptions(options), [isPending, startTransition] = useTransition(), queryKey = getQueryKey(normalized), [deferredQueryKey, setDeferredQueryKey] = useState(queryKey), ref = useRef(new AbortController());
   useEffect(() => {
     queryKey !== deferredQueryKey && startTransition(() => {
       ref && !ref.current.signal.aborted && (ref.current.abort(), ref.current = new AbortController()), setDeferredQueryKey(queryKey);
@@ -1144,9 +1231,9 @@ function useDocuments({
   filter: filter2,
   orderings,
   documentType,
-  ...options
+  ...rawOptions
 }) {
-  const instance = useSanityInstance(options), [limit, setLimit] = useState(batchSize), documentTypes = useMemo(() => (Array.isArray(documentType) ? documentType : [documentType]).filter((i) => typeof i == "string"), [documentType]), key = JSON.stringify({
+  const options = useNormalizedResourceOptions(rawOptions), [limit, setLimit] = useState(batchSize), documentTypes = useMemo(() => (Array.isArray(documentType) ? documentType : [documentType]).filter((i) => typeof i == "string"), [documentType]), key = JSON.stringify({
     filter: filter2,
     search,
     params,
@@ -1176,10 +1263,8 @@ function useDocuments({
     query: `{"count":${countQuery},"data":${dataQuery}}`,
     params: {
       ...params,
-      __handle: {
-        ...pick(instance.config, "projectId", "dataset", "perspective"),
-        ...pick(options, "projectId", "dataset", "perspective")
-      },
+      // these are passed back to the user as part of each document handle
+      __handle: pick(options, ["resource", "perspective"]),
       __types: documentTypes
     }
   }), hasMore = data.length < count, loadMore = useCallback(() => {
@@ -1194,8 +1279,8 @@ function useDocuments({
   }), [count, data, hasMore, isPending, loadMore]);
 }
 function usePaginatedDocuments(t0) {
-  const $ = c(62);
-  let documentType, options, orderings, search, t1, t2, t3;
+  const $ = c(58);
+  let documentType, orderings, rawOptions, search, t1, t2, t3;
   $[0] !== t0 ? ({
     documentType,
     filter: t1,
@@ -1203,32 +1288,33 @@ function usePaginatedDocuments(t0) {
     params: t3,
     orderings,
     search,
-    ...options
-  } = t0, $[0] = t0, $[1] = documentType, $[2] = options, $[3] = orderings, $[4] = search, $[5] = t1, $[6] = t2, $[7] = t3) : (documentType = $[1], options = $[2], orderings = $[3], search = $[4], t1 = $[5], t2 = $[6], t3 = $[7]);
+    ...rawOptions
+  } = t0, $[0] = t0, $[1] = documentType, $[2] = orderings, $[3] = rawOptions, $[4] = search, $[5] = t1, $[6] = t2, $[7] = t3) : (documentType = $[1], orderings = $[2], rawOptions = $[3], search = $[4], t1 = $[5], t2 = $[6], t3 = $[7]);
   const filter2 = t1 === void 0 ? "" : t1, pageSize = t2 === void 0 ? 25 : t2;
   let t4;
   $[8] !== t3 ? (t4 = t3 === void 0 ? {} : t3, $[8] = t3, $[9] = t4) : t4 = $[9];
-  const params = t4, instance = useSanityInstance(options), [pageIndex, setPageIndex] = useState(0);
+  const params = t4, options = useNormalizedResourceOptions(rawOptions), [pageIndex, setPageIndex] = useState(0);
   let t5;
-  $[10] !== filter2 || $[11] !== orderings || $[12] !== pageSize || $[13] !== params || $[14] !== search ? (t5 = JSON.stringify({
+  $[10] !== filter2 || $[11] !== options || $[12] !== orderings || $[13] !== pageSize || $[14] !== params || $[15] !== search ? (t5 = JSON.stringify({
     filter: filter2,
     search,
     params,
     orderings,
-    pageSize
-  }), $[10] = filter2, $[11] = orderings, $[12] = pageSize, $[13] = params, $[14] = search, $[15] = t5) : t5 = $[15];
+    pageSize,
+    ...options
+  }), $[10] = filter2, $[11] = options, $[12] = orderings, $[13] = pageSize, $[14] = params, $[15] = search, $[16] = t5) : t5 = $[16];
   const key = t5;
   let t6;
-  $[16] === Symbol.for("react.memo_cache_sentinel") ? (t6 = () => {
+  $[17] === Symbol.for("react.memo_cache_sentinel") ? (t6 = () => {
     setPageIndex(0);
-  }, $[16] = t6) : t6 = $[16];
+  }, $[17] = t6) : t6 = $[17];
   let t7;
-  $[17] !== key ? (t7 = [key], $[17] = key, $[18] = t7) : t7 = $[18], useEffect(t6, t7);
+  $[18] !== key ? (t7 = [key], $[18] = key, $[19] = t7) : t7 = $[19], useEffect(t6, t7);
   const startIndex = pageIndex * pageSize, endIndex = (pageIndex + 1) * pageSize;
   let t8;
-  $[19] !== documentType ? (t8 = Array.isArray(documentType) ? documentType : [documentType], $[19] = documentType, $[20] = t8) : t8 = $[20];
+  $[20] !== documentType ? (t8 = Array.isArray(documentType) ? documentType : [documentType], $[20] = documentType, $[21] = t8) : t8 = $[21];
   let t9;
-  $[21] !== t8 ? (t9 = t8.filter(_temp), $[21] = t8, $[22] = t9) : t9 = $[22];
+  $[22] !== t8 ? (t9 = t8.filter(_temp), $[22] = t8, $[23] = t9) : t9 = $[23];
   const documentTypes = t9;
   let t10;
   const conditions = [], trimmedSearch = search?.trim();
@@ -1239,52 +1325,45 @@ function usePaginatedDocuments(t0) {
   documentTypes?.length && conditions.push("(_type in $__types)"), filter2 && conditions.push(`(${filter2})`), t10 = conditions.length ? `[${conditions.join(" && ")}]` : "";
   const filterClause = t10, orderClause = orderings ? `| order(${orderings.map(_temp3).join(",")})` : "", dataQuery = `*${filterClause}${orderClause}[${startIndex}...${endIndex}]{"documentId":_id,"documentType":_type,...$__handle}`, countQuery = `count(*${filterClause})`, t11 = `{"data":${dataQuery},"count":${countQuery}}`;
   let t12;
-  $[23] !== instance.config ? (t12 = pick(instance.config, "projectId", "dataset", "perspective"), $[23] = instance.config, $[24] = t12) : t12 = $[24];
+  $[24] !== options ? (t12 = pick(options, ["resource", "perspective"]), $[24] = options, $[25] = t12) : t12 = $[25];
   let t13;
-  $[25] !== options ? (t13 = pick(options, "projectId", "dataset", "perspective"), $[25] = options, $[26] = t13) : t13 = $[26];
-  let t14;
-  $[27] !== t12 || $[28] !== t13 ? (t14 = {
-    ...t12,
-    ...t13
-  }, $[27] = t12, $[28] = t13, $[29] = t14) : t14 = $[29];
-  let t15;
-  $[30] !== documentTypes || $[31] !== params || $[32] !== t14 ? (t15 = {
+  $[26] !== documentTypes || $[27] !== params || $[28] !== t12 ? (t13 = {
     ...params,
     __types: documentTypes,
-    __handle: t14
-  }, $[30] = documentTypes, $[31] = params, $[32] = t14, $[33] = t15) : t15 = $[33];
-  let t16;
-  $[34] !== options || $[35] !== t11 || $[36] !== t15 ? (t16 = {
+    __handle: t12
+  }, $[26] = documentTypes, $[27] = params, $[28] = t12, $[29] = t13) : t13 = $[29];
+  let t14;
+  $[30] !== options || $[31] !== t11 || $[32] !== t13 ? (t14 = {
     ...options,
     query: t11,
-    params: t15
-  }, $[34] = options, $[35] = t11, $[36] = t15, $[37] = t16) : t16 = $[37];
+    params: t13
+  }, $[30] = options, $[31] = t11, $[32] = t13, $[33] = t14) : t14 = $[33];
   const {
-    data: t17,
+    data: t15,
     isPending
-  } = useQuery(t16), {
+  } = useQuery(t14), {
     data,
     count
-  } = t17, totalPages = Math.ceil(count / pageSize), currentPage = pageIndex + 1;
+  } = t15, totalPages = Math.ceil(count / pageSize), currentPage = pageIndex + 1;
+  let t16;
+  $[34] === Symbol.for("react.memo_cache_sentinel") ? (t16 = () => setPageIndex(0), $[34] = t16) : t16 = $[34];
+  const firstPage = t16;
+  let t17;
+  $[35] === Symbol.for("react.memo_cache_sentinel") ? (t17 = () => setPageIndex(_temp4), $[35] = t17) : t17 = $[35];
+  const previousPage = t17;
   let t18;
-  $[38] === Symbol.for("react.memo_cache_sentinel") ? (t18 = () => setPageIndex(0), $[38] = t18) : t18 = $[38];
-  const firstPage = t18;
+  $[36] !== totalPages ? (t18 = () => setPageIndex((prev_0) => Math.min(prev_0 + 1, totalPages - 1)), $[36] = totalPages, $[37] = t18) : t18 = $[37];
+  const nextPage = t18;
   let t19;
-  $[39] === Symbol.for("react.memo_cache_sentinel") ? (t19 = () => setPageIndex(_temp4), $[39] = t19) : t19 = $[39];
-  const previousPage = t19;
+  $[38] !== totalPages ? (t19 = () => setPageIndex(totalPages - 1), $[38] = totalPages, $[39] = t19) : t19 = $[39];
+  const lastPage = t19;
   let t20;
-  $[40] !== totalPages ? (t20 = () => setPageIndex((prev_0) => Math.min(prev_0 + 1, totalPages - 1)), $[40] = totalPages, $[41] = t20) : t20 = $[41];
-  const nextPage = t20;
-  let t21;
-  $[42] !== totalPages ? (t21 = () => setPageIndex(totalPages - 1), $[42] = totalPages, $[43] = t21) : t21 = $[43];
-  const lastPage = t21;
-  let t22;
-  $[44] !== totalPages ? (t22 = (pageNumber) => {
+  $[40] !== totalPages ? (t20 = (pageNumber) => {
     pageNumber < 1 || pageNumber > totalPages || setPageIndex(pageNumber - 1);
-  }, $[44] = totalPages, $[45] = t22) : t22 = $[45];
-  const goToPage = t22, hasFirstPage = pageIndex > 0, hasPreviousPage = pageIndex > 0, hasNextPage = pageIndex < totalPages - 1, hasLastPage = pageIndex < totalPages - 1;
-  let t23;
-  return $[46] !== count || $[47] !== currentPage || $[48] !== data || $[49] !== endIndex || $[50] !== goToPage || $[51] !== hasFirstPage || $[52] !== hasLastPage || $[53] !== hasNextPage || $[54] !== hasPreviousPage || $[55] !== isPending || $[56] !== lastPage || $[57] !== nextPage || $[58] !== pageSize || $[59] !== startIndex || $[60] !== totalPages ? (t23 = {
+  }, $[40] = totalPages, $[41] = t20) : t20 = $[41];
+  const goToPage = t20, hasFirstPage = pageIndex > 0, hasPreviousPage = pageIndex > 0, hasNextPage = pageIndex < totalPages - 1, hasLastPage = pageIndex < totalPages - 1;
+  let t21;
+  return $[42] !== count || $[43] !== currentPage || $[44] !== data || $[45] !== endIndex || $[46] !== goToPage || $[47] !== hasFirstPage || $[48] !== hasLastPage || $[49] !== hasNextPage || $[50] !== hasPreviousPage || $[51] !== isPending || $[52] !== lastPage || $[53] !== nextPage || $[54] !== pageSize || $[55] !== startIndex || $[56] !== totalPages ? (t21 = {
     data,
     isPending,
     pageSize,
@@ -1302,7 +1381,7 @@ function usePaginatedDocuments(t0) {
     lastPage,
     hasLastPage,
     goToPage
-  }, $[46] = count, $[47] = currentPage, $[48] = data, $[49] = endIndex, $[50] = goToPage, $[51] = hasFirstPage, $[52] = hasLastPage, $[53] = hasNextPage, $[54] = hasPreviousPage, $[55] = isPending, $[56] = lastPage, $[57] = nextPage, $[58] = pageSize, $[59] = startIndex, $[60] = totalPages, $[61] = t23) : t23 = $[61], t23;
+  }, $[42] = count, $[43] = currentPage, $[44] = data, $[45] = endIndex, $[46] = goToPage, $[47] = hasFirstPage, $[48] = hasLastPage, $[49] = hasNextPage, $[50] = hasPreviousPage, $[51] = isPending, $[52] = lastPage, $[53] = nextPage, $[54] = pageSize, $[55] = startIndex, $[56] = totalPages, $[57] = t21) : t21 = $[57], t21;
 }
 function _temp4(prev) {
   return Math.max(prev - 1, 0);
@@ -1316,70 +1395,39 @@ function _temp2(str) {
 function _temp(i) {
   return typeof i == "string";
 }
-function usePresence() {
-  const $ = c(11), sanityInstance = useSanityInstance();
-  let t0, t1;
-  $[0] !== sanityInstance ? (t1 = getPresence(sanityInstance), $[0] = sanityInstance, $[1] = t1) : t1 = $[1], t0 = t1;
-  const source = t0;
-  let t2;
-  $[2] !== source ? (t2 = (callback) => source.subscribe(callback), $[2] = source, $[3] = t2) : t2 = $[3];
-  const subscribe = t2;
-  let t3, t4;
-  $[4] !== source ? (t3 = () => source.getCurrent(), t4 = () => source.getCurrent(), $[4] = source, $[5] = t3, $[6] = t4) : (t3 = $[5], t4 = $[6]);
-  const locations = useSyncExternalStore(subscribe, t3, t4);
-  let t5;
-  $[7] !== locations ? (t5 = locations || [], $[7] = locations, $[8] = t5) : t5 = $[8];
-  let t6;
-  return $[9] !== t5 ? (t6 = {
-    locations: t5
-  }, $[9] = t5, $[10] = t6) : t6 = $[10], t6;
-}
-function useDocumentPreview(t0) {
-  const $ = c(13);
-  let docHandle, ref;
-  $[0] !== t0 ? ({
-    ref,
-    ...docHandle
-  } = t0, $[0] = t0, $[1] = docHandle, $[2] = ref) : (docHandle = $[1], ref = $[2]);
-  const instance = useSanityInstance(docHandle);
+function usePresence(t0) {
+  const $ = c(14);
   let t1;
-  $[3] !== docHandle || $[4] !== instance ? (t1 = getPreviewState(instance, docHandle), $[3] = docHandle, $[4] = instance, $[5] = t1) : t1 = $[5];
-  const stateSource = t1;
-  let t2;
-  $[6] !== ref || $[7] !== stateSource ? (t2 = (onStoreChanged) => {
-    const subscription = new Observable((observer) => {
-      if (typeof IntersectionObserver > "u" || typeof HTMLElement > "u") {
-        observer.next(!0);
-        return;
-      }
-      const intersectionObserver = new IntersectionObserver((t32) => {
-        const [entry] = t32;
-        return observer.next(entry.isIntersecting);
-      }, {
-        rootMargin: "0px",
-        threshold: 0
-      });
-      return ref?.current && ref.current instanceof HTMLElement ? intersectionObserver.observe(ref.current) : observer.next(!0), () => intersectionObserver.disconnect();
-    }).pipe(startWith(!1), distinctUntilChanged(), switchMap((isVisible) => isVisible ? new Observable((obs) => stateSource.subscribe(() => obs.next())) : EMPTY)).subscribe({
-      next: onStoreChanged
-    });
-    return () => subscription.unsubscribe();
-  }, $[6] = ref, $[7] = stateSource, $[8] = t2) : t2 = $[8];
-  const subscribe = t2;
-  let t3;
-  return $[9] !== docHandle || $[10] !== instance || $[11] !== stateSource ? (t3 = () => {
-    const currentState = stateSource.getCurrent();
-    if (currentState.data === null)
-      throw resolvePreview(instance, docHandle);
-    return currentState;
-  }, $[9] = docHandle, $[10] = instance, $[11] = stateSource, $[12] = t3) : t3 = $[12], useSyncExternalStore(subscribe, t3);
+  $[0] !== t0 ? (t1 = t0 === void 0 ? {} : t0, $[0] = t0, $[1] = t1) : t1 = $[1];
+  const normalizedOptions = useNormalizedResourceOptions(t1), sanityInstance = useSanityInstance();
+  if (normalizedOptions.resource) {
+    if (isMediaLibraryResource(normalizedOptions.resource))
+      throw new Error("usePresence() does not support media library resources. Presence tracking requires a dataset resource. Either remove the resourceName parameter or use a dataset resource instead.");
+    if (isCanvasResource(normalizedOptions.resource))
+      throw new Error("usePresence() does not support canvas resources. Presence tracking requires a dataset resource. Either remove the resourceName parameter or use a dataset resource instead.");
+  }
+  let t2, t3;
+  $[2] !== normalizedOptions || $[3] !== sanityInstance ? (t3 = getPresence(sanityInstance, normalizedOptions), $[2] = normalizedOptions, $[3] = sanityInstance, $[4] = t3) : t3 = $[4], t2 = t3;
+  const source = t2;
+  let t4;
+  $[5] !== source ? (t4 = (callback) => source.subscribe(callback), $[5] = source, $[6] = t4) : t4 = $[6];
+  const subscribe = t4;
+  let t5, t6;
+  $[7] !== source ? (t5 = () => source.getCurrent(), t6 = () => source.getCurrent(), $[7] = source, $[8] = t5, $[9] = t6) : (t5 = $[8], t6 = $[9]);
+  const locations = useSyncExternalStore(subscribe, t5, t6);
+  let t7;
+  $[10] !== locations ? (t7 = locations || [], $[10] = locations, $[11] = t7) : t7 = $[11];
+  let t8;
+  return $[12] !== t7 ? (t8 = {
+    locations: t7
+  }, $[12] = t7, $[13] = t8) : t8 = $[13], t8;
 }
 function useDocumentProjection({
   ref,
   projection,
   ...docHandle
 }) {
-  const instance = useSanityInstance(docHandle), normalizedProjection = useMemo(() => projection.trim(), [projection]), normalizedDocHandle = useNormalizedSourceOptions(docHandle), stateSource = useMemo(() => getProjectionState(instance, {
+  const instance = useSanityInstance(), normalizedProjection = useMemo(() => projection.trim(), [projection]), normalizedDocHandle = useNormalizedResourceOptions(docHandle), stateSource = useMemo(() => getProjectionState(instance, {
     ...normalizedDocHandle,
     projection: normalizedProjection
   }), [instance, normalizedDocHandle, normalizedProjection]);
@@ -1406,27 +1454,62 @@ function useDocumentProjection({
   }, [stateSource, ref]);
   return useSyncExternalStore(subscribe, stateSource.getCurrent);
 }
+function useDocumentPreview(t0) {
+  const $ = c(13);
+  let docHandle, ref;
+  $[0] !== t0 ? ({
+    ref,
+    ...docHandle
+  } = t0, $[0] = t0, $[1] = docHandle, $[2] = ref) : (docHandle = $[1], ref = $[2]);
+  const instance = useSanityInstance(), normalizedDocHandle = useNormalizedResourceOptions(docHandle);
+  let t1;
+  $[3] !== normalizedDocHandle || $[4] !== ref ? (t1 = {
+    ...normalizedDocHandle,
+    projection: PREVIEW_PROJECTION,
+    ref
+  }, $[3] = normalizedDocHandle, $[4] = ref, $[5] = t1) : t1 = $[5];
+  const projectionResult = useDocumentProjection(t1);
+  let t2, t3;
+  $[6] !== instance || $[7] !== normalizedDocHandle.resource || $[8] !== projectionResult.data ? (t3 = transformProjectionToPreview(instance, normalizedDocHandle.resource, projectionResult.data), $[6] = instance, $[7] = normalizedDocHandle.resource, $[8] = projectionResult.data, $[9] = t3) : t3 = $[9], t2 = t3;
+  const previewValue = t2;
+  let t4;
+  return $[10] !== previewValue || $[11] !== projectionResult.isPending ? (t4 = {
+    data: previewValue,
+    isPending: projectionResult.isPending
+  }, $[10] = previewValue, $[11] = projectionResult.isPending, $[12] = t4) : t4 = $[12], t4;
+}
 const useProject = createStateSourceHook({
   // remove `undefined` since we're suspending when that is the case
   getState: getProjectState,
   shouldSuspend: (instance, projectHandle) => getProjectState(instance, projectHandle).getCurrent() === void 0,
-  suspender: resolveProject,
-  getConfig: identity
+  suspender: (instance, projectHandle) => resolveProject(instance, projectHandle)
 }), useProjects = createStateSourceHook({
   getState: getProjectsState,
   shouldSuspend: (instance, options) => getProjectsState(instance, options).getCurrent() === void 0,
   suspender: resolveProjects
-}), useActiveReleases = createStateSourceHook({
+}), useActiveReleasesValue = createStateSourceHook({
   getState: getActiveReleasesState,
-  shouldSuspend: (instance) => getActiveReleasesState(instance).getCurrent() === void 0,
-  suspender: (instance) => firstValueFrom(getActiveReleasesState(instance).observable.pipe(filter(Boolean)))
-}), usePerspective = createStateSourceHook({
+  shouldSuspend: (instance, options) => getActiveReleasesState(instance, options).getCurrent() === void 0,
+  suspender: (instance, options) => firstValueFrom(getActiveReleasesState(instance, options).observable.pipe(filter(Boolean)))
+}), useActiveReleases = (options) => {
+  const $ = c(2);
+  let t0;
+  $[0] !== options ? (t0 = options ?? {}, $[0] = options, $[1] = t0) : t0 = $[1];
+  const normalizedOptions = useNormalizedResourceOptions(t0);
+  return useActiveReleasesValue(normalizedOptions);
+}, usePerspectiveValue = createStateSourceHook({
   getState: getPerspectiveState,
   shouldSuspend: (instance, options) => getPerspectiveState(instance, options).getCurrent() === void 0,
-  suspender: (instance, _options) => firstValueFrom(getActiveReleasesState(instance).observable.pipe(filter(Boolean)))
-});
+  suspender: (instance, _options) => firstValueFrom(getPerspectiveState(instance, _options).observable.pipe(filter(Boolean)))
+}), usePerspective = (options) => {
+  const $ = c(2);
+  let t0;
+  $[0] !== options ? (t0 = options ?? {}, $[0] = options, $[1] = t0) : t0 = $[1];
+  const normalizedOptions = useNormalizedResourceOptions(t0);
+  return usePerspectiveValue(normalizedOptions);
+};
 function useUser(options) {
-  const instance = useSanityInstance(options), [isPending, startTransition] = useTransition(), key = getUsersKey(instance, options), [deferredKey, setDeferredKey] = useState(key), deferred = useMemo(() => parseUsersKey(deferredKey), [deferredKey]), [ref, setRef] = useState(new AbortController());
+  const instance = useSanityInstance(), [isPending, startTransition] = useTransition(), key = getUsersKey(instance, options), [deferredKey, setDeferredKey] = useState(key), deferred = useMemo(() => parseUsersKey(deferredKey), [deferredKey]), [ref, setRef] = useState(new AbortController());
   useEffect(() => {
     key !== deferredKey && startTransition(() => {
       ref.signal.aborted || (ref.abort(), setRef(new AbortController())), setDeferredKey(key);
@@ -1447,7 +1530,7 @@ function useUser(options) {
   };
 }
 function useUsers(options) {
-  const instance = useSanityInstance(options), [isPending, startTransition] = useTransition(), key = getUsersKey(instance, options), [deferredKey, setDeferredKey] = useState(key), deferred = useMemo(() => parseUsersKey(deferredKey), [deferredKey]), [ref, setRef] = useState(new AbortController());
+  const instance = useSanityInstance(), [isPending, startTransition] = useTransition(), key = getUsersKey(instance, options), [deferredKey, setDeferredKey] = useState(key), deferred = useMemo(() => parseUsersKey(deferredKey), [deferredKey]), [ref, setRef] = useState(new AbortController());
   useEffect(() => {
     key !== deferredKey && startTransition(() => {
       ref.signal.aborted || (ref.abort(), setRef(new AbortController())), setDeferredKey(key);
@@ -1475,7 +1558,7 @@ function useUsers(options) {
     loadMore
   };
 }
-var version = "2.7.0";
+var version = "3.0.0-rc.0";
 function getEnv(key) {
   if (typeof import.meta < "u" && import.meta.env)
     return import.meta.env[key];
@@ -1531,6 +1614,7 @@ export {
   useProjects,
   useQuery,
   useRecordDocumentHistoryEvent,
+  useResource,
   useSanityInstance,
   useStudioWorkspacesByProjectIdDataset,
   useUser,