@sanity/sdk-react 2.9.0 → 2.11.0

package/dist/index.js

@@ -1,41 +1,34 @@
 import { jsx, jsxs, Fragment } from "react/jsx-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, getProjectionState, resolveProjection, transformProjectionToPreview, PREVIEW_PROJECTION, 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, isProjectUserNotFoundClientError, getClientErrorApiDescription, getClientErrorApiBody, isImportError, getCorsErrorProjectId, createSanityInstance, isDatasetResource, agentGenerate, agentPatch, agentPrompt, agentTransform, agentTranslate, 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, resolveOrganization, getOrganizationState, resolveOrganizations, getOrganizationsState, 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, useMemo, Suspense, StrictMode, useCallback, useInsertionEffect, useTransition } from "react";
+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 { initTelemetry, trackHookMounted } from "@sanity/sdk/_internal";
+import { initTelemetry, isDeepEqual, trackHookMounted, pickProperties } from "@sanity/sdk/_internal";
 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), warnedCallers = /* @__PURE__ */ new Set(), useSanityInstance = (config) => {
+  if (config !== void 0) {
+    const caller = new Error().stack?.split(`
+`)[2]?.trim() ?? "unknown";
+    warnedCallers.has(caller) || (warnedCallers.add(caller), console.warn("[useSanityInstance] Passing a config argument is deprecated and has no effect. SDK apps use a single instance for all resources, so the config argument is no longer needed. Call useSanityInstance() without arguments instead, or useResource() to get your currently active resource."));
+  }
+  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;
@@ -163,20 +156,41 @@ function useLoginUrl() {
   return useSyncExternalStore(subscribe, getCurrent);
 }
 function useVerifyOrgProjects(t0, projectIds) {
-  const $ = c(6), disabled = t0 === void 0 ? !1 : t0, instance = useSanityInstance(), [error, setError] = useState(null);
+  const $ = c(5), disabled = t0 === void 0 ? !1 : t0, instance = useSanityInstance(), [error, setError] = useState(null), isInactive = disabled || !projectIds || projectIds.length === 0, [prevInactive, setPrevInactive] = useState(isInactive);
+  prevInactive !== isInactive && (setPrevInactive(isInactive), isInactive && setError(null));
   let t1, t2;
-  return $[0] !== disabled || $[1] !== error || $[2] !== instance || $[3] !== projectIds ? (t1 = () => {
-    if (disabled || !projectIds || projectIds.length === 0) {
-      error !== null && setError(null);
+  return $[0] !== instance || $[1] !== isInactive || $[2] !== projectIds ? (t1 = () => {
+    if (isInactive)
       return;
-    }
     const subscription = observeOrganizationVerificationState(instance, projectIds).subscribe((result) => {
       setError(result.error);
     });
     return () => {
       subscription.unsubscribe();
     };
-  }, t2 = [instance, disabled, error, projectIds], $[0] = disabled, $[1] = error, $[2] = instance, $[3] = projectIds, $[4] = t1, $[5] = t2) : (t1 = $[4], t2 = $[5]), useEffect(t1, t2), error;
+  }, t2 = [instance, isInactive, projectIds], $[0] = instance, $[1] = isInactive, $[2] = projectIds, $[3] = t1, $[4] = t2) : (t1 = $[3], t2 = $[4]), useEffect(t1, t2), error;
+}
+const CHUNK_RELOAD_STORAGE_KEY = "__sanity_sdk_chunk_reload_attempted";
+function readChunkReloadFlag() {
+  try {
+    return typeof window > "u" || typeof window.sessionStorage > "u" ? !1 : window.sessionStorage.getItem(CHUNK_RELOAD_STORAGE_KEY) !== null;
+  } catch {
+    return !1;
+  }
+}
+function setChunkReloadFlag() {
+  try {
+    if (typeof window > "u" || typeof window.sessionStorage > "u") return;
+    window.sessionStorage.setItem(CHUNK_RELOAD_STORAGE_KEY, "1");
+  } catch {
+  }
+}
+function clearChunkReloadFlag() {
+  try {
+    if (typeof window > "u" || typeof window.sessionStorage > "u") return;
+    window.sessionStorage.removeItem(CHUNK_RELOAD_STORAGE_KEY);
+  } catch {
+  }
 }
 const FONT_SANS_SERIF = "-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Helvetica, Arial, system-ui, sans-serif", FONT_MONOSPACE = "-apple-system-ui-monospace, 'SF Mono', Menlo, Monaco, Consolas, monospace", styles = {
   container: {
@@ -233,6 +247,31 @@ function Error$1(t0) {
     t4
   ] }), $[8] = t1, $[9] = t2, $[10] = t3, $[11] = t4, $[12] = t5) : t5 = $[12], t5;
 }
+function reload() {
+  try {
+    window.location.reload();
+  } catch {
+  }
+}
+function ChunkLoadError(_props) {
+  const $ = c(4);
+  let t0;
+  $[0] === Symbol.for("react.memo_cache_sentinel") ? (t0 = readChunkReloadFlag(), $[0] = t0) : t0 = $[0];
+  const alreadyAttempted = t0;
+  let t1, t2;
+  if ($[1] === Symbol.for("react.memo_cache_sentinel") ? (t1 = () => {
+    alreadyAttempted || (setChunkReloadFlag(), reload());
+  }, t2 = [alreadyAttempted], $[1] = t1, $[2] = t2) : (t1 = $[1], t2 = $[2]), useEffect(t1, t2), !alreadyAttempted)
+    return null;
+  let t3;
+  return $[3] === Symbol.for("react.memo_cache_sentinel") ? (t3 = /* @__PURE__ */ jsx(Error$1, { heading: "A new version is available", description: "The page tried to load an asset that no longer exists. Reload to continue with the latest version.", cta: {
+    text: "Reload page",
+    onClick: _temp$6
+  } }), $[3] = t3) : t3 = $[3], t3;
+}
+function _temp$6() {
+  clearChunkReloadFlag(), reload();
+}
 function CorsErrorComponent(t0) {
   const $ = c(6), {
     projectId,
@@ -291,67 +330,100 @@ 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$5);
   }, t1 = [handleAuthCallback2], $[0] = handleAuthCallback2, $[1] = t0, $[2] = t1) : (t0 = $[1], t1 = $[2]), useEffect(t0, t1), null;
 }
-function _temp$6(replacementLocation) {
+function _temp$5(replacementLocation) {
   replacementLocation && history.replaceState(null, "", replacementLocation);
 }
 const useLogOut = createCallbackHook(logout);
+function DashboardAccessRequest(t0) {
+  const $ = c(5), {
+    projectId
+  } = t0;
+  let t1;
+  $[0] === Symbol.for("react.memo_cache_sentinel") ? (t1 = {
+    name: SDK_NODE_NAME,
+    connectTo: SDK_CHANNEL_NAME
+  }, $[0] = t1) : t1 = $[0];
+  const {
+    fetch
+  } = useWindowConnection(t1);
+  let t2, t3;
+  return $[1] !== fetch || $[2] !== projectId ? (t2 = () => {
+    fetch("dashboard/v1/auth/access/request", {
+      resourceType: "project",
+      resourceId: projectId
+    });
+  }, t3 = [fetch, projectId], $[1] = fetch, $[2] = projectId, $[3] = t2, $[4] = t3) : (t2 = $[3], t3 = $[4]), useEffect(t2, t3), null;
+}
 function LoginError(t0) {
-  const $ = c(23), {
+  const $ = c(30), {
     error,
     resetErrorBoundary
   } = t0;
   if (!(error instanceof AuthError || error instanceof ConfigurationError || error instanceof ClientError))
     throw error;
-  const logout2 = useLogOut(), authState = useAuthState(), {
+  const logout2 = useLogOut(), authState = useAuthState(), instance = useSanityInstance(), {
     config: t1
-  } = useSanityInstance(), {
+  } = instance, {
     projectId
-  } = t1, [authErrorMessage, setAuthErrorMessage] = useState("Please try again or contact support if the problem persists."), [showRetryCta, setShowRetryCta] = useState(!0);
+  } = t1, clientError = error instanceof ClientError ? error : error instanceof AuthError && error.cause instanceof ClientError ? error.cause : null;
   let t2;
-  $[0] === Symbol.for("react.memo_cache_sentinel") ? (t2 = {
-    name: SDK_NODE_NAME,
-    connectTo: SDK_CHANNEL_NAME
-  }, $[0] = t2) : t2 = $[0];
-  const {
-    fetch
-  } = useWindowConnection(t2);
+  $[0] !== instance ? (t2 = getIsInDashboardState(instance).getCurrent(), $[0] = instance, $[1] = t2) : t2 = $[1];
+  const isInDashboard = t2;
   let t3;
-  $[1] !== logout2 || $[2] !== resetErrorBoundary ? (t3 = async () => {
-    await logout2(), resetErrorBoundary();
-  }, $[1] = logout2, $[2] = resetErrorBoundary, $[3] = t3) : t3 = $[3];
-  const handleRetry = t3;
+  $[2] !== clientError ? (t3 = !!clientError && clientError.statusCode === 401 && isProjectUserNotFoundClientError(clientError), $[2] = clientError, $[3] = t3) : t3 = $[3];
+  const isProjectUserNotFound = t3, dashboardAccessProjectId = isProjectUserNotFound && projectId && isInDashboard ? projectId : null;
   let t4;
-  $[4] !== authState.type || $[5] !== error || $[6] !== fetch || $[7] !== handleRetry || $[8] !== projectId ? (t4 = () => {
-    if (error instanceof ClientError) {
-      if (error.statusCode === 401)
-        if (isProjectUserNotFoundClientError(error)) {
-          const description = getClientErrorApiDescription(error);
-          description && setAuthErrorMessage(description), setShowRetryCta(!1), fetch("dashboard/v1/auth/access/request", {
-            resourceType: "project",
-            resourceId: projectId
-          });
-        } else
-          setShowRetryCta(!0), handleRetry();
-      else if (error.statusCode === 404) {
-        const errorMessage = getClientErrorApiBody(error)?.message || "";
-        errorMessage.startsWith("Session with sid") && errorMessage.endsWith("not found") ? setAuthErrorMessage("The session ID is invalid or expired.") : setAuthErrorMessage("The login link is invalid or expired. Please try again."), setShowRetryCta(!0);
-      }
+  $[4] !== logout2 || $[5] !== resetErrorBoundary ? (t4 = async () => {
+    await logout2(), resetErrorBoundary();
+  }, $[4] = logout2, $[5] = resetErrorBoundary, $[6] = t4) : t4 = $[6];
+  const handleRetry = t4;
+  let t5, message = "Please try again or contact support if the problem persists.", retry = !0;
+  if (clientError) {
+    if (clientError.statusCode === 401)
+      if (isProjectUserNotFound) {
+        let t62;
+        $[7] !== clientError ? (t62 = getClientErrorApiDescription(clientError), $[7] = clientError, $[8] = t62) : t62 = $[8];
+        const description = t62;
+        description && (message = description), retry = !1;
+      } else
+        isInDashboard || (message = "Signing you out and returning to login...", retry = !0);
+    else if (clientError.statusCode === 404) {
+      const errorMessage = getClientErrorApiBody(clientError)?.message || "";
+      message = errorMessage.startsWith("Session with sid") && errorMessage.endsWith("not found") ? "The session ID is invalid or expired." : "The login link is invalid or expired. Please try again.", retry = !0;
     }
-    authState.type !== AuthStateType.ERROR && error instanceof ConfigurationError && (setAuthErrorMessage(error.message), setShowRetryCta(!0));
-  }, $[4] = authState.type, $[5] = error, $[6] = fetch, $[7] = handleRetry, $[8] = projectId, $[9] = t4) : t4 = $[9];
-  let t5;
-  $[10] !== authState || $[11] !== error || $[12] !== fetch || $[13] !== handleRetry || $[14] !== projectId ? (t5 = [authState, handleRetry, error, fetch, projectId], $[10] = authState, $[11] = error, $[12] = fetch, $[13] = handleRetry, $[14] = projectId, $[15] = t5) : t5 = $[15], useEffect(t4, t5);
-  const t6 = error instanceof AuthError ? "Authentication Error" : "Configuration Error";
-  let t7;
-  $[16] !== handleRetry || $[17] !== showRetryCta ? (t7 = showRetryCta ? {
+  }
+  authState.type !== AuthStateType.ERROR && error instanceof ConfigurationError && (message = error.message, retry = !0);
+  let t6;
+  $[9] !== message || $[10] !== retry ? (t6 = {
+    authErrorMessage: message,
+    showRetryCta: retry
+  }, $[9] = message, $[10] = retry, $[11] = t6) : t6 = $[11], t5 = t6;
+  const {
+    authErrorMessage,
+    showRetryCta
+  } = t5, hasAutoLoggedOutRef = useRef(!1);
+  let t7, t8;
+  $[12] !== clientError || $[13] !== handleRetry || $[14] !== isInDashboard || $[15] !== isProjectUserNotFound ? (t7 = () => {
+    clientError && clientError.statusCode === 401 && !isProjectUserNotFound && !isInDashboard && !hasAutoLoggedOutRef.current && (hasAutoLoggedOutRef.current = !0, handleRetry());
+  }, t8 = [clientError, handleRetry, isInDashboard, isProjectUserNotFound], $[12] = clientError, $[13] = handleRetry, $[14] = isInDashboard, $[15] = isProjectUserNotFound, $[16] = t7, $[17] = t8) : (t7 = $[16], t8 = $[17]), useEffect(t7, t8);
+  let t9;
+  $[18] !== dashboardAccessProjectId ? (t9 = dashboardAccessProjectId && /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(DashboardAccessRequest, { projectId: dashboardAccessProjectId }) }), $[18] = dashboardAccessProjectId, $[19] = t9) : t9 = $[19];
+  const t10 = error instanceof ConfigurationError ? "Configuration Error" : "Authentication Error";
+  let t11;
+  $[20] !== handleRetry || $[21] !== showRetryCta ? (t11 = showRetryCta ? {
     text: "Retry",
     onClick: handleRetry
-  } : void 0, $[16] = handleRetry, $[17] = showRetryCta, $[18] = t7) : t7 = $[18];
-  let t8;
-  return $[19] !== authErrorMessage || $[20] !== t6 || $[21] !== t7 ? (t8 = /* @__PURE__ */ jsx(Error$1, { heading: t6, description: authErrorMessage, cta: t7 }), $[19] = authErrorMessage, $[20] = t6, $[21] = t7, $[22] = t8) : t8 = $[22], t8;
+  } : void 0, $[20] = handleRetry, $[21] = showRetryCta, $[22] = t11) : t11 = $[22];
+  let t12;
+  $[23] !== authErrorMessage || $[24] !== t10 || $[25] !== t11 ? (t12 = /* @__PURE__ */ jsx(Error$1, { heading: t10, description: authErrorMessage, cta: t11 }), $[23] = authErrorMessage, $[24] = t10, $[25] = t11, $[26] = t12) : t12 = $[26];
+  let t13;
+  return $[27] !== t12 || $[28] !== t9 ? (t13 = /* @__PURE__ */ jsxs(Fragment, { children: [
+    t9,
+    t12
+  ] }), $[27] = t12, $[28] = t9, $[29] = t13) : t13 = $[29], t13;
 }
 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");
@@ -367,7 +439,7 @@ function AuthBoundary(t0) {
   const LoginErrorComponent = t1 === void 0 ? LoginError : t1;
   let t2, t3;
   $[3] !== LoginErrorComponent ? (t3 = function(fallbackProps) {
-    return fallbackProps.error instanceof CorsOriginError ? /* @__PURE__ */ jsx(CorsErrorComponent, { ...fallbackProps, projectId: getCorsErrorProjectId(fallbackProps.error) }) : /* @__PURE__ */ jsx(LoginErrorComponent, { ...fallbackProps });
+    return isImportError(fallbackProps.error) ? /* @__PURE__ */ jsx(ChunkLoadError, { ...fallbackProps }) : fallbackProps.error instanceof CorsOriginError ? /* @__PURE__ */ jsx(CorsErrorComponent, { ...fallbackProps, projectId: getCorsErrorProjectId(fallbackProps.error) }) : /* @__PURE__ */ jsx(LoginErrorComponent, { ...fallbackProps });
   }, $[3] = LoginErrorComponent, $[4] = t3) : t3 = $[4], t2 = t3;
   const FallbackComponent = t2;
   let t4;
@@ -413,29 +485,85 @@ function AuthSwitch(t0) {
 }
 const SDKStudioContext = createContext(null);
 SDKStudioContext.displayName = "SDKStudioContext";
+const DEFAULT_RESOURCE_NAME = "default", ResourceContext = createContext(void 0), PerspectiveContext = createContext(void 0);
+function SanityInstanceProvider(t0) {
+  const $ = c(6), {
+    instance,
+    fallback,
+    children
+  } = t0;
+  let t1;
+  $[0] !== children || $[1] !== fallback ? (t1 = /* @__PURE__ */ jsx(Suspense, { fallback, children }), $[0] = children, $[1] = fallback, $[2] = t1) : t1 = $[2];
+  let t2;
+  return $[3] !== instance || $[4] !== t1 ? (t2 = /* @__PURE__ */ jsx(SanityInstanceContext.Provider, { value: instance, children: t1 }), $[3] = instance, $[4] = t1, $[5] = t2) : t2 = $[5], t2;
+}
 const DEFAULT_FALLBACK = /* @__PURE__ */ jsx(Fragment, { children: "Warning: No fallback provided. Please supply a fallback prop to ensure proper Suspense handling." });
-function ResourceProvider({
-  children,
-  fallback,
-  ...config
-}) {
-  const parent = useContext(SanityInstanceContext), instance = useMemo(() => parent ? parent.createChild(config) : createSanityInstance(config), [config, parent]), projectId = config.projectId ?? "";
-  useMemo(() => {
-    projectId && !parent && initTelemetry(instance, projectId);
-  }, [instance, projectId, parent]);
+function ResourceProvider(t0) {
+  const $ = c(29);
+  let children, config, fallback, resource;
+  $[0] !== t0 ? ({
+    children,
+    fallback,
+    resource,
+    ...config
+  } = t0, $[0] = t0, $[1] = children, $[2] = config, $[3] = fallback, $[4] = resource) : (children = $[1], config = $[2], fallback = $[3], resource = $[4]);
+  const parentPerspective = useContext(PerspectiveContext), parentResource = useContext(ResourceContext), parentInstance = useContext(SanityInstanceContext), {
+    projectId,
+    dataset,
+    perspective
+  } = config;
+  let t1;
+  $[5] !== config || $[6] !== parentInstance ? (t1 = () => parentInstance ?? createSanityInstance(config), $[5] = config, $[6] = parentInstance, $[7] = t1) : t1 = $[7];
+  const [instance] = useState(t1);
+  let t2;
+  bb0: {
+    if (projectId && dataset) {
+      let t32;
+      $[8] !== dataset || $[9] !== projectId ? (t32 = {
+        projectId,
+        dataset
+      }, $[8] = dataset, $[9] = projectId, $[10] = t32) : t32 = $[10], t2 = t32;
+      break bb0;
+    }
+    t2 = void 0;
+  }
+  const configResource = t2;
+  let t3;
+  t3 = resource ?? configResource ?? parentResource;
+  const effectiveResource = t3;
+  let t4, t5;
+  $[11] !== effectiveResource || $[12] !== instance ? (t4 = () => {
+    effectiveResource && isDatasetResource(effectiveResource) && initTelemetry(instance, effectiveResource.projectId);
+  }, t5 = [instance, effectiveResource], $[11] = effectiveResource, $[12] = instance, $[13] = t4, $[14] = t5) : (t4 = $[13], t5 = $[14]), useEffect(t4, t5);
   const disposal = useRef(null);
-  return useEffect(() => (disposal.current !== null && instance === disposal.current.instance && (clearTimeout(disposal.current.timeoutId), disposal.current = null), () => {
+  let t6, t7;
+  $[15] !== instance || $[16] !== parentInstance ? (t6 = () => (disposal.current !== null && instance === disposal.current.instance && (clearTimeout(disposal.current.timeoutId), disposal.current = null), () => {
     disposal.current = {
       instance,
       timeoutId: setTimeout(() => {
-        instance.isDisposed() || instance.dispose();
+        !instance.isDisposed() && instance !== parentInstance && instance.dispose();
       }, 0)
     };
-  }), [instance]), /* @__PURE__ */ jsx(SanityInstanceContext.Provider, { value: instance, children: /* @__PURE__ */ jsx(Suspense, { fallback: fallback ?? DEFAULT_FALLBACK, children }) });
+  }), t7 = [instance, parentInstance], $[15] = instance, $[16] = parentInstance, $[17] = t6, $[18] = t7) : (t6 = $[17], t7 = $[18]), useEffect(t6, t7);
+  const t8 = fallback ?? DEFAULT_FALLBACK, t9 = perspective ?? parentPerspective;
+  let t10;
+  $[19] !== children || $[20] !== t9 ? (t10 = /* @__PURE__ */ jsx(PerspectiveContext.Provider, { value: t9, children }), $[19] = children, $[20] = t9, $[21] = t10) : t10 = $[21];
+  let t11;
+  $[22] !== effectiveResource || $[23] !== t10 ? (t11 = /* @__PURE__ */ jsx(ResourceContext.Provider, { value: effectiveResource, children: t10 }), $[22] = effectiveResource, $[23] = t10, $[24] = t11) : t11 = $[24];
+  let t12;
+  return $[25] !== instance || $[26] !== t11 || $[27] !== t8 ? (t12 = /* @__PURE__ */ jsx(SanityInstanceProvider, { instance, fallback: t8, children: t11 }), $[25] = instance, $[26] = t11, $[27] = t8, $[28] = t12) : t12 = $[28], t12;
+}
+const ResourcesContext = createContext({});
+function ResetChunkReloadFlagOnMount() {
+  const $ = c(1);
+  let t0;
+  return $[0] === Symbol.for("react.memo_cache_sentinel") ? (t0 = [], $[0] = t0) : t0 = $[0], useEffect(_temp$4, t0), null;
+}
+function _temp$4() {
+  clearChunkReloadFlag();
 }
-const SourcesContext = createContext({});
 function SDKProvider(t0) {
-  const $ = c(19);
+  const $ = c(29);
   let children, config, fallback, props;
   $[0] !== t0 ? ({
     children,
@@ -445,26 +573,57 @@ function SDKProvider(t0) {
   } = 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;
-  let t3, t4;
-  $[10] !== props.sources ? (t4 = props.sources ?? {}, $[10] = props.sources, $[11] = t4) : t4 = $[11], t3 = t4;
-  const sourcesValue = t3;
+  const allConfigs = t1, resolvedConfig = allConfigs[0];
+  let t2;
+  $[7] !== allConfigs ? (t2 = allConfigs.map(_temp2$1).filter(_temp3$1), $[7] = allConfigs, $[8] = t2) : t2 = $[8];
+  const projectIds = t2, singleConfig = Array.isArray(config) ? null : config, defaultProjectId = singleConfig?.projectId, defaultDataset = singleConfig?.dataset;
+  let t3;
+  bb0: {
+    let t42;
+    $[9] !== props.resources ? (t42 = props.resources ?? {}, $[9] = props.resources, $[10] = t42) : t42 = $[10];
+    const explicit = t42;
+    if (defaultProjectId && defaultDataset && !Object.hasOwn(explicit, DEFAULT_RESOURCE_NAME)) {
+      let t52;
+      $[11] !== defaultDataset || $[12] !== defaultProjectId ? (t52 = {
+        projectId: defaultProjectId,
+        dataset: defaultDataset
+      }, $[11] = defaultDataset, $[12] = defaultProjectId, $[13] = t52) : t52 = $[13];
+      let t62;
+      $[14] !== explicit || $[15] !== t52 ? (t62 = {
+        [DEFAULT_RESOURCE_NAME]: t52,
+        ...explicit
+      }, $[14] = explicit, $[15] = t52, $[16] = t62) : t62 = $[16], t3 = t62;
+      break bb0;
+    }
+    t3 = explicit;
+  }
+  const resourcesValue = t3;
+  let t4;
+  $[17] === Symbol.for("react.memo_cache_sentinel") ? (t4 = /* @__PURE__ */ jsx(ResetChunkReloadFlagOnMount, {}), $[17] = t4) : t4 = $[17];
   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;
+  $[18] !== children || $[19] !== resourcesValue ? (t5 = /* @__PURE__ */ jsx(ResourcesContext.Provider, { value: resourcesValue, children }), $[18] = children, $[19] = resourcesValue, $[20] = t5) : t5 = $[20];
+  let t6;
+  $[21] !== projectIds || $[22] !== props || $[23] !== t5 ? (t6 = /* @__PURE__ */ jsx(AuthBoundary, { ...props, projectIds, children: t5 }), $[21] = projectIds, $[22] = props, $[23] = t5, $[24] = t6) : t6 = $[24];
+  let t7;
+  return $[25] !== fallback || $[26] !== resolvedConfig || $[27] !== t6 ? (t7 = /* @__PURE__ */ jsxs(ErrorBoundary, { FallbackComponent: ChunkAwareFallback, children: [
+    t4,
+    /* @__PURE__ */ jsx(ResourceProvider, { ...resolvedConfig, fallback, children: t6 })
+  ] }), $[25] = fallback, $[26] = resolvedConfig, $[27] = t6, $[28] = t7) : t7 = $[28], t7;
 }
-function _temp2$1(id) {
+function _temp3$1(id) {
   return !!id;
 }
-function _temp$5(c2) {
+function _temp2$1(c2) {
   return c2.projectId;
 }
+function ChunkAwareFallback(fallbackProps) {
+  const $ = c(2);
+  if (isImportError(fallbackProps.error)) {
+    let t0;
+    return $[0] !== fallbackProps ? (t0 = /* @__PURE__ */ jsx(ChunkLoadError, { ...fallbackProps }), $[0] = fallbackProps, $[1] = t0) : t0 = $[1], t0;
+  }
+  throw fallbackProps.error;
+}
 const REDIRECT_URL = "https://sanity.io/welcome";
 function deriveConfigFromWorkspace(workspace) {
   return {
@@ -507,12 +666,12 @@ function SanityApp(t0) {
   $[8] !== configProp || $[9] !== resolvedConfig || $[10] !== studioWorkspace ? (t2 = () => {
     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);
+    return !isInIframe() && !isLocalUrl(window) && (shouldRedirectWithoutConfig || primaryConfig && !isStudioConfig(primaryConfig)) && (timeout = setTimeout(_temp$3, 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;
 }
-function _temp$4() {
+function _temp$3() {
   console.warn("Redirecting to core", REDIRECT_URL), window.location.replace(REDIRECT_URL);
 }
 function renderSanityApp(rootElement, namedSources, options, children) {
@@ -523,15 +682,121 @@ function renderSanityApp(rootElement, namedSources, options, children) {
   } = 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();
 }
-const useAgentGenerate = createCallbackHook(agentGenerate), useAgentTransform = createCallbackHook(agentTransform), useAgentTranslate = createCallbackHook(agentTranslate);
-function promptAdapter(instance, options) {
-  return firstValueFrom(agentPrompt(instance, options));
+function normalizeResourceOptions(options, resources, contextResource, contextPerspective) {
+  const {
+    resourceName,
+    sourceName,
+    source,
+    projectId,
+    dataset,
+    ...rest
+  } = options, effectiveResourceName = resourceName ?? sourceName, effectiveResource = options.resource ?? source;
+  if (effectiveResourceName && effectiveResource)
+    throw new Error(`Resource name ${JSON.stringify(effectiveResourceName)} and resource ${JSON.stringify(effectiveResource)} cannot be used together.`);
+  let resolvedResource;
+  if (effectiveResource)
+    resolvedResource = effectiveResource;
+  else if (effectiveResourceName) {
+    if (!Object.hasOwn(resources, effectiveResourceName))
+      throw new Error(`There's no resource named ${JSON.stringify(effectiveResourceName)} in context. Please use <ResourceProvider>.`);
+    resolvedResource = resources[effectiveResourceName];
+  }
+  !resolvedResource && projectId && dataset && (resolvedResource = {
+    projectId,
+    dataset
+  }), resolvedResource || (resolvedResource = contextResource);
+  const resolvedPerspective = Object.hasOwn(options, "perspective") ? options.perspective : contextPerspective;
+  return {
+    ...rest,
+    ...resolvedResource !== void 0 && {
+      resource: resolvedResource
+    },
+    ...resolvedPerspective !== void 0 && {
+      perspective: resolvedPerspective
+    }
+  };
+}
+function useEffectiveContextResource() {
+  const $ = c(5), contextResource = useContext(ResourceContext), instance = useContext(SanityInstanceContext);
+  let t0;
+  $[0] !== instance?.config ? (t0 = instance?.config ?? {}, $[0] = instance?.config, $[1] = t0) : t0 = $[1];
+  const {
+    projectId,
+    dataset
+  } = t0;
+  let t1;
+  bb0: {
+    if (contextResource) {
+      t1 = contextResource;
+      break bb0;
+    }
+    if (projectId && dataset) {
+      let t2;
+      $[2] !== dataset || $[3] !== projectId ? (t2 = {
+        projectId,
+        dataset
+      }, $[2] = dataset, $[3] = projectId, $[4] = t2) : t2 = $[4], t1 = t2;
+      break bb0;
+    }
+    t1 = void 0;
+  }
+  return t1;
 }
-const useAgentPrompt = createCallbackHook(promptAdapter);
-function patchAdapter(instance, options) {
-  return firstValueFrom(agentPatch(instance, options));
+function useNormalizedResourceOptions(options) {
+  const $ = c(5), resources = useContext(ResourcesContext), effectiveContextResource = useEffectiveContextResource(), contextPerspective = useContext(PerspectiveContext);
+  let t0;
+  return $[0] !== contextPerspective || $[1] !== effectiveContextResource || $[2] !== options || $[3] !== resources ? (t0 = normalizeResourceOptions(options, resources, effectiveContextResource, contextPerspective), $[0] = contextPerspective, $[1] = effectiveContextResource, $[2] = options, $[3] = resources, $[4] = t0) : t0 = $[4], t0;
+}
+function useAgentGenerate(resourceHandle) {
+  const $ = c(5), instance = useSanityInstance();
+  let t0;
+  $[0] !== resourceHandle ? (t0 = resourceHandle ?? {}, $[0] = resourceHandle, $[1] = t0) : t0 = $[1];
+  const {
+    resource
+  } = useNormalizedResourceOptions(t0);
+  let t1;
+  return $[2] !== instance || $[3] !== resource ? (t1 = (options) => agentGenerate(instance, options, resource), $[2] = instance, $[3] = resource, $[4] = t1) : t1 = $[4], t1;
+}
+function useAgentTransform(resourceHandle) {
+  const $ = c(5), instance = useSanityInstance();
+  let t0;
+  $[0] !== resourceHandle ? (t0 = resourceHandle ?? {}, $[0] = resourceHandle, $[1] = t0) : t0 = $[1];
+  const {
+    resource
+  } = useNormalizedResourceOptions(t0);
+  let t1;
+  return $[2] !== instance || $[3] !== resource ? (t1 = (options) => agentTransform(instance, options, resource), $[2] = instance, $[3] = resource, $[4] = t1) : t1 = $[4], t1;
+}
+function useAgentTranslate(resourceHandle) {
+  const $ = c(5), instance = useSanityInstance();
+  let t0;
+  $[0] !== resourceHandle ? (t0 = resourceHandle ?? {}, $[0] = resourceHandle, $[1] = t0) : t0 = $[1];
+  const {
+    resource
+  } = useNormalizedResourceOptions(t0);
+  let t1;
+  return $[2] !== instance || $[3] !== resource ? (t1 = (options) => agentTranslate(instance, options, resource), $[2] = instance, $[3] = resource, $[4] = t1) : t1 = $[4], t1;
+}
+function useAgentPrompt(resourceHandle) {
+  const $ = c(5), instance = useSanityInstance();
+  let t0;
+  $[0] !== resourceHandle ? (t0 = resourceHandle ?? {}, $[0] = resourceHandle, $[1] = t0) : t0 = $[1];
+  const {
+    resource
+  } = useNormalizedResourceOptions(t0);
+  let t1;
+  return $[2] !== instance || $[3] !== resource ? (t1 = (options) => firstValueFrom(agentPrompt(instance, options, resource)), $[2] = instance, $[3] = resource, $[4] = t1) : t1 = $[4], t1;
+}
+function useAgentPatch(resourceHandle) {
+  const $ = c(5), instance = useSanityInstance();
+  let t0;
+  $[0] !== resourceHandle ? (t0 = resourceHandle ?? {}, $[0] = resourceHandle, $[1] = t0) : t0 = $[1];
+  const {
+    resource
+  } = useNormalizedResourceOptions(t0);
+  let t1;
+  return $[2] !== instance || $[3] !== resource ? (t1 = (options) => firstValueFrom(agentPatch(instance, options, resource)), $[2] = instance, $[3] = resource, $[4] = t1) : t1 = $[4], t1;
 }
-const useAgentPatch = createCallbackHook(patchAdapter);
 function useAgentResourceContext(options) {
   const $ = c(9), {
     projectId,
@@ -620,7 +885,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;
@@ -642,9 +907,12 @@ function useFrameConnection(options) {
     sendMessage
   }, $[11] = t4) : t4 = $[11], t4;
 }
-function _temp$3(unsub) {
+function _temp$2(unsub) {
   return unsub();
 }
+function useResource() {
+  return useEffectiveContextResource();
+}
 function useDashboardNavigate(navigateFn) {
   const $ = c(2);
   let t0;
@@ -658,36 +926,12 @@ function useDashboardNavigate(navigateFn) {
     }
   }, $[0] = navigateFn, $[1] = t0) : t0 = $[1], useWindowConnection(t0);
 }
-function normalizeSourceOptions(options, sources) {
-  const {
-    sourceName,
-    ...rest
-  } = options;
-  if (!sourceName && !options.source)
-    return options;
-  if (sourceName && Object.hasOwn(options, "source"))
-    throw new Error(`Source name ${JSON.stringify(sourceName)} and source ${JSON.stringify(options.source)} cannot be used together.`);
-  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>.`);
-  return sourceName && sources[sourceName] && (resolvedSource = sources[sourceName]), {
-    ...rest,
-    source: resolvedSource
-  };
-}
-function useNormalizedSourceOptions(options) {
-  const $ = c(3), sources = useContext(SourcesContext);
-  let t0;
-  return $[0] !== options || $[1] !== sources ? (t0 = normalizeSourceOptions(options, sources), $[0] = options, $[1] = sources, $[2] = t0) : t0 = $[2], 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,
@@ -712,7 +956,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: {
@@ -1001,54 +1245,28 @@ const useDatasets = createStateSourceHook({
   suspender: resolveDatasets,
   getConfig: identity
 }), useApplyDocumentActions = () => {
-  const $ = c(3), instance = useSanityInstance(), sources = useContext(SourcesContext);
+  const $ = c(4), instance = useSanityInstance(), resources = useContext(ResourcesContext), effectiveContextResource = useEffectiveContextResource();
   let t0;
-  return $[0] !== instance || $[1] !== sources ? (t0 = (actionOrActions, options) => {
-    const actions = Array.isArray(actionOrActions) ? actionOrActions : [actionOrActions], normalizedOptions = options ? normalizeSourceOptions(options, sources) : void 0;
-    let projectId, dataset, source;
-    for (const action of actions) {
-      if (action.projectId) {
-        if (source)
-          throw new Error(`Mismatches between projectId/dataset options and source in actions. Found projectId "${action.projectId}" and dataset "${action.dataset}" but expected source "${source}".`);
-        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 (action.source) {
-        if (source || (source = action.source), action.source !== source)
-          throw new Error(`Mismatched sources found in actions. All actions must belong to the same source. Found "${action.source}" but expected "${source}".`);
-        if (projectId || dataset)
-          throw new Error(`Mismatches between projectId/dataset options and source in actions. Found "${action.source}" but expected project "${projectId}" and dataset "${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,
-        source,
-        ...normalizedOptions
-      });
-    }
+  return $[0] !== effectiveContextResource || $[1] !== instance || $[2] !== resources ? (t0 = (actionOrActions, options) => {
+    const actions = Array.isArray(actionOrActions) ? actionOrActions : [actionOrActions], optionsResource = options ? normalizeResourceOptions(options, resources, effectiveContextResource).resource : void 0, normalizedActions = actions.map((action) => normalizeResourceOptions(action, resources, effectiveContextResource));
+    let resource;
+    for (const action_0 of normalizedActions)
+      if (!resource && action_0.resource && (resource = action_0.resource), !isDeepEqual(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 && !isDeepEqual(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 ?? effectiveContextResource;
+    if (!effectiveResource)
+      throw new Error("No resource found. Provide a resource via the action handle or context.");
     return applyDocumentActions(instance, {
-      actions,
-      source,
-      ...normalizedOptions
+      actions: normalizedActions,
+      resource: effectiveResource
     });
-  }, $[0] = instance, $[1] = sources, $[2] = t0) : t0 = $[2], t0;
+  }, $[0] = effectiveContextResource, $[1] = instance, $[2] = resources, $[3] = t0) : t0 = $[3], t0;
 };
 function useTrackHookUsage(hookName) {
-  const instance = useSanityInstance(), tracked = useRef(!1);
-  tracked.current || (tracked.current = !0, trackHookMounted(instance, hookName));
+  const instance = useSanityInstance(), tracked = useRef(null);
+  tracked.current === null && (tracked.current = !0, trackHookMounted(instance, hookName));
 }
 function trackHookUsage(instance, hookName) {
   trackHookMounted(instance, hookName);
@@ -1073,13 +1291,13 @@ const useDocumentValue = createStateSourceHook({
   return useHook;
 }, useDocument = wrapHookWithData((options) => {
   useTrackHookUsage("useDocument");
-  const normalizedOptions = useNormalizedSourceOptions(options);
+  const normalizedOptions = useNormalizedResourceOptions(options);
   return useDocumentValue(normalizedOptions);
 });
 function useDocumentEvent(options) {
   const $ = c(10);
   useTrackHookUsage("useDocumentEvent");
-  const normalizedOptions = useNormalizedSourceOptions(options);
+  const normalizedOptions = useNormalizedResourceOptions(options);
   let datasetHandle, onEvent;
   $[0] !== normalizedOptions ? ({
     onEvent,
@@ -1092,63 +1310,49 @@ 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] !== datasetHandle.source || $[7] !== instance ? (t2 = () => subscribeDocumentEvents(instance, {
+  $[6] !== datasetHandle.resource || $[7] !== instance ? (t2 = () => subscribeDocumentEvents(instance, {
     eventHandler: stableHandler,
-    source: datasetHandle.source
-  }), t3 = [instance, datasetHandle.source, stableHandler], $[6] = datasetHandle.source, $[7] = instance, $[8] = t2, $[9] = t3) : (t2 = $[8], t3 = $[9]), useEffect(t2, t3);
+    resource: datasetHandle.resource
+  }), t3 = [instance, datasetHandle.resource, stableHandler], $[6] = datasetHandle.resource, $[7] = instance, $[8] = t2, $[9] = t3) : (t2 = $[8], t3 = $[9]), useEffect(t2, t3);
 }
+const noopSubscribe = () => () => {
+}, returnUndefined = () => {
+};
 function useDocumentPermissions(actionOrActions) {
-  const $ = c(15);
-  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, source;
-  if ($[2] !== actions || $[3] !== dataset || $[4] !== projectId || $[5] !== source) {
-    for (const action of actions) {
-      if (action.projectId) {
-        if (source)
-          throw new Error(`Mismatches between projectId/dataset options and source in actions. Found projectId "${action.projectId}" and dataset "${action.dataset}" but expected source "${source}".`);
-        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 (action.source) {
-        if (source || (source = action.source), action.source !== source)
-          throw new Error(`Mismatched sources found in actions. All actions must belong to the same source. Found "${action.source}" but expected "${source}".`);
-        if (projectId || dataset)
-          throw new Error(`Mismatches between projectId/dataset options and source in actions. Found "${action.source}" but expected project "${projectId}" and dataset "${dataset}".`);
-      }
-    }
-    $[2] = actions, $[3] = dataset, $[4] = projectId, $[5] = source, $[6] = projectId, $[7] = dataset, $[8] = source;
-  } else
-    projectId = $[6], dataset = $[7], source = $[8];
-  let t2;
-  $[9] !== dataset || $[10] !== projectId ? (t2 = {
-    projectId,
-    dataset
-  }, $[9] = dataset, $[10] = projectId, $[11] = t2) : t2 = $[11];
-  const instance = useSanityInstance(t2);
-  if (trackHookUsage(instance, "useDocumentPermissions"), getPermissionsState(instance, {
-    actions
-  }).getCurrent() === void 0)
-    throw firstValueFrom(getPermissionsState(instance, {
-      actions
-    }).observable.pipe(filter(_temp$2)));
-  let t3, t4;
-  $[12] !== actions || $[13] !== instance ? (t4 = getPermissionsState(instance, {
-    actions
-  }), $[12] = actions, $[13] = instance, $[14] = t4) : t4 = $[14], t3 = t4;
-  const {
-    subscribe,
-    getCurrent
-  } = t3;
-  return useSyncExternalStore(subscribe, getCurrent);
-}
-function _temp$2(result) {
-  return result !== void 0;
+  const instance = useSanityInstance();
+  trackHookUsage(instance, "useDocumentPermissions");
+  const effectiveContextResource = useEffectiveContextResource(), resources = useContext(ResourcesContext), {
+    actions: normalizedActions,
+    resource: actionResource,
+    error: validationError
+  } = useMemo(() => {
+    const normalized = Array.isArray(actionOrActions) ? actionOrActions.map((action) => normalizeResourceOptions(action, resources, effectiveContextResource)) : [normalizeResourceOptions(actionOrActions, resources, effectiveContextResource)];
+    let resource;
+    for (const action_0 of normalized)
+      if (action_0.resource && (resource || (resource = action_0.resource), !isDeepEqual(action_0.resource, resource)))
+        return {
+          actions: normalized,
+          resource,
+          error: 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)}".`)
+        };
+    return {
+      actions: normalized,
+      resource,
+      error: void 0
+    };
+  }, [actionOrActions, resources, effectiveContextResource]), effectiveResource = actionResource ?? effectiveContextResource, permissionsOptions = useMemo(() => effectiveResource ? {
+    resource: effectiveResource,
+    // `Omit<>` on `DocumentAction` loses the discriminant; runtime values are still actions.
+    actions: normalizedActions
+  } : void 0, [effectiveResource, normalizedActions]), stateSource = useMemo(() => permissionsOptions ? getPermissionsState(instance, permissionsOptions) : void 0, [permissionsOptions, instance]), isDocumentReady = useCallback(() => stateSource !== void 0 && stateSource.getCurrent() !== void 0, [stateSource]), result = useSyncExternalStore(stateSource?.subscribe ?? noopSubscribe, stateSource?.getCurrent ?? returnUndefined);
+  if (validationError) throw validationError;
+  if (!effectiveResource)
+    throw new Error("No resource found. Provide a resource via the action handle or wrap with a resource context.");
+  if (!isDocumentReady())
+    throw firstValueFrom(stateSource.observable.pipe(filter((permissions) => permissions !== void 0)));
+  return result;
 }
 const useDocumentSyncStatusValue = createStateSourceHook({
   getState: getDocumentSyncStatus,
@@ -1156,7 +1360,7 @@ const useDocumentSyncStatusValue = createStateSourceHook({
   suspender: (instance, doc) => resolveDocument(instance, doc),
   getConfig: identity
 }), useDocumentSyncStatus = (options) => {
-  const normalizedOptions = useNormalizedSourceOptions(options);
+  const normalizedOptions = useNormalizedResourceOptions(options);
   return useDocumentSyncStatusValue(normalizedOptions);
 }, ignoredKeys = ["_id", "_type", "_createdAt", "_updatedAt", "_rev"];
 function useEditDocument(t0) {
@@ -1166,9 +1370,9 @@ function useEditDocument(t0) {
     path,
     ...doc
   } = t0, $[0] = t0, $[1] = doc, $[2] = path) : (doc = $[1], path = $[2]);
-  const instance = useSanityInstance(doc);
+  const instance = useSanityInstance();
   trackHookUsage(instance, "useEditDocument");
-  const normalizedDoc = useNormalizedSourceOptions(doc), apply = useApplyDocumentActions();
+  const normalizedDoc = useNormalizedResourceOptions(doc), apply = useApplyDocumentActions();
   if (getDocumentState(instance, normalizedDoc).getCurrent() === void 0)
     throw resolveDocument(instance, normalizedDoc);
   let t1;
@@ -1208,9 +1412,9 @@ function _temp$1(key) {
   return !ignoredKeys.includes(key);
 }
 function useQuery(options) {
-  const instance = useSanityInstance(options);
+  const instance = useSanityInstance();
   trackHookUsage(instance, "useQuery");
-  const normalized = useNormalizedSourceOptions(options), [isPending, startTransition] = useTransition(), queryKey = getQueryKey(normalized), [deferredQueryKey, setDeferredQueryKey] = useState(queryKey), ref = useRef(new AbortController());
+  const 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);
@@ -1244,10 +1448,10 @@ function useDocuments({
   filter: filter2,
   orderings,
   documentType,
-  ...options
+  ...rawOptions
 }) {
   useTrackHookUsage("useDocuments");
-  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,
@@ -1255,10 +1459,8 @@ function useDocuments({
     batchSize,
     types: documentTypes,
     ...options
-  });
-  useEffect(() => {
-    setLimit(batchSize);
-  }, [key, batchSize]);
+  }), [prevKey, setPrevKey] = useState(key);
+  prevKey !== key && (setPrevKey(key), setLimit(batchSize));
   const filterClause = useMemo(() => {
     const conditions = [], trimmedSearch = search?.trim();
     if (trimmedSearch) {
@@ -1277,9 +1479,12 @@ function useDocuments({
     query: `{"count":${countQuery},"data":${dataQuery}}`,
     params: {
       ...params,
+      // these are passed back to the user as part of each document handle
       __handle: {
-        ...pick(instance.config, "projectId", "dataset", "perspective"),
-        ...pick(options, "projectId", "dataset", "perspective")
+        // keep projectId/dataset for backward compat until v4; resource is added
+        // intentionally so that hook consumers can resolve the correct resource
+        ...options.resource && isDatasetResource(options.resource) ? pickProperties(options.resource, ["projectId", "dataset"]) : {},
+        ...pickProperties(options, ["perspective", "resource"])
       },
       __types: documentTypes
     }
@@ -1294,9 +1499,18 @@ function useDocuments({
     loadMore
   }), [count, data, hasMore, isPending, loadMore]);
 }
+const useOrganization = createStateSourceHook({
+  getState: getOrganizationState,
+  shouldSuspend: (instance, ...params) => getOrganizationState(instance, ...params).getCurrent() === void 0,
+  suspender: resolveOrganization
+}), useOrganizations = createStateSourceHook({
+  getState: getOrganizationsState,
+  shouldSuspend: (instance, ...params) => getOrganizationsState(instance, ...params).getCurrent() === void 0,
+  suspender: resolveOrganizations
+});
 function usePaginatedDocuments(t0) {
-  const $ = c(62);
-  let documentType, options, orderings, search, t1, t2, t3;
+  const $ = c(60);
+  let documentType, orderings, rawOptions, search, t1, t2, t3;
   $[0] !== t0 ? ({
     documentType,
     filter: t1,
@@ -1304,90 +1518,86 @@ 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;
   useTrackHookUsage("usePaginatedDocuments");
-  const instance = useSanityInstance(options), [pageIndex, setPageIndex] = useState(0);
+  const 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];
-  const key = t5;
+    pageSize,
+    ...options
+  }), $[10] = filter2, $[11] = options, $[12] = orderings, $[13] = pageSize, $[14] = params, $[15] = search, $[16] = t5) : t5 = $[16];
+  const key = t5, [prevKey, setPrevKey] = useState(key);
+  prevKey !== key && (setPrevKey(key), setPageIndex(0));
+  const startIndex = pageIndex * pageSize, endIndex = (pageIndex + 1) * pageSize;
   let t6;
-  $[16] === Symbol.for("react.memo_cache_sentinel") ? (t6 = () => {
-    setPageIndex(0);
-  }, $[16] = t6) : t6 = $[16];
+  $[17] !== documentType ? (t6 = Array.isArray(documentType) ? documentType : [documentType], $[17] = documentType, $[18] = t6) : t6 = $[18];
   let t7;
-  $[17] !== key ? (t7 = [key], $[17] = key, $[18] = t7) : t7 = $[18], useEffect(t6, t7);
-  const startIndex = pageIndex * pageSize, endIndex = (pageIndex + 1) * pageSize;
+  $[19] !== t6 ? (t7 = t6.filter(_temp), $[19] = t6, $[20] = t7) : t7 = $[20];
+  const documentTypes = t7;
   let t8;
-  $[19] !== documentType ? (t8 = Array.isArray(documentType) ? documentType : [documentType], $[19] = documentType, $[20] = t8) : t8 = $[20];
-  let t9;
-  $[21] !== t8 ? (t9 = t8.filter(_temp), $[21] = t8, $[22] = t9) : t9 = $[22];
-  const documentTypes = t9;
-  let t10;
   const conditions = [], trimmedSearch = search?.trim();
   if (trimmedSearch) {
     const searchFilter = createGroqSearchFilter(trimmedSearch);
     searchFilter && conditions.push(searchFilter);
   }
-  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}}`;
+  documentTypes?.length && conditions.push("(_type in $__types)"), filter2 && conditions.push(`(${filter2})`), t8 = conditions.length ? `[${conditions.join(" && ")}]` : "";
+  const filterClause = t8, orderClause = orderings ? `| order(${orderings.map(_temp3).join(",")})` : "", dataQuery = `*${filterClause}${orderClause}[${startIndex}...${endIndex}]{"documentId":_id,"documentType":_type,...$__handle}`, countQuery = `count(*${filterClause})`, t9 = `{"data":${dataQuery},"count":${countQuery}}`;
+  let t10;
+  $[21] !== options.resource ? (t10 = options.resource && isDatasetResource(options.resource) ? pickProperties(options.resource, ["projectId", "dataset"]) : {}, $[21] = options.resource, $[22] = t10) : t10 = $[22];
+  let t11;
+  $[23] !== options ? (t11 = pickProperties(options, ["perspective", "resource"]), $[23] = options, $[24] = t11) : t11 = $[24];
   let t12;
-  $[23] !== instance.config ? (t12 = pick(instance.config, "projectId", "dataset", "perspective"), $[23] = instance.config, $[24] = t12) : t12 = $[24];
+  $[25] !== t10 || $[26] !== t11 ? (t12 = {
+    ...t10,
+    ...t11
+  }, $[25] = t10, $[26] = t11, $[27] = t12) : t12 = $[27];
   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 = {
+  $[28] !== documentTypes || $[29] !== params || $[30] !== 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
+  }, $[28] = documentTypes, $[29] = params, $[30] = t12, $[31] = t13) : t13 = $[31];
+  let t14;
+  $[32] !== options || $[33] !== t13 || $[34] !== t9 ? (t14 = {
     ...options,
-    query: t11,
-    params: t15
-  }, $[34] = options, $[35] = t11, $[36] = t15, $[37] = t16) : t16 = $[37];
+    query: t9,
+    params: t13
+  }, $[32] = options, $[33] = t13, $[34] = t9, $[35] = t14) : t14 = $[35];
   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;
+  $[36] === Symbol.for("react.memo_cache_sentinel") ? (t16 = () => setPageIndex(0), $[36] = t16) : t16 = $[36];
+  const firstPage = t16;
+  let t17;
+  $[37] === Symbol.for("react.memo_cache_sentinel") ? (t17 = () => setPageIndex(_temp4), $[37] = t17) : t17 = $[37];
+  const previousPage = t17;
   let t18;
-  $[38] === Symbol.for("react.memo_cache_sentinel") ? (t18 = () => setPageIndex(0), $[38] = t18) : t18 = $[38];
-  const firstPage = t18;
+  $[38] !== totalPages ? (t18 = () => setPageIndex((prev_0) => Math.min(prev_0 + 1, totalPages - 1)), $[38] = totalPages, $[39] = t18) : t18 = $[39];
+  const nextPage = t18;
   let t19;
-  $[39] === Symbol.for("react.memo_cache_sentinel") ? (t19 = () => setPageIndex(_temp4), $[39] = t19) : t19 = $[39];
-  const previousPage = t19;
+  $[40] !== totalPages ? (t19 = () => setPageIndex(totalPages - 1), $[40] = totalPages, $[41] = t19) : t19 = $[41];
+  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) => {
+  $[42] !== 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 = {
+  }, $[42] = totalPages, $[43] = t20) : t20 = $[43];
+  const goToPage = t20, hasFirstPage = pageIndex > 0, hasPreviousPage = pageIndex > 0, hasNextPage = pageIndex < totalPages - 1, hasLastPage = pageIndex < totalPages - 1;
+  let t21;
+  return $[44] !== count || $[45] !== currentPage || $[46] !== data || $[47] !== endIndex || $[48] !== goToPage || $[49] !== hasFirstPage || $[50] !== hasLastPage || $[51] !== hasNextPage || $[52] !== hasPreviousPage || $[53] !== isPending || $[54] !== lastPage || $[55] !== nextPage || $[56] !== pageSize || $[57] !== startIndex || $[58] !== totalPages ? (t21 = {
     data,
     isPending,
     pageSize,
@@ -1405,7 +1615,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;
+  }, $[44] = count, $[45] = currentPage, $[46] = data, $[47] = endIndex, $[48] = goToPage, $[49] = hasFirstPage, $[50] = hasLastPage, $[51] = hasNextPage, $[52] = hasPreviousPage, $[53] = isPending, $[54] = lastPage, $[55] = nextPage, $[56] = pageSize, $[57] = startIndex, $[58] = totalPages, $[59] = t21) : t21 = $[59], t21;
 }
 function _temp4(prev) {
   return Math.max(prev - 1, 0);
@@ -1419,33 +1629,39 @@ function _temp2(str) {
 function _temp(i) {
   return typeof i == "string";
 }
-function usePresence() {
-  const $ = c(11), sanityInstance = useSanityInstance();
+function usePresence(t0) {
+  const $ = c(14);
+  let t1;
+  $[0] !== t0 ? (t1 = t0 === void 0 ? {} : t0, $[0] = t0, $[1] = t1) : t1 = $[1];
+  const normalizedOptions = useNormalizedResourceOptions(t1);
+  if (normalizedOptions.resource && isMediaLibraryResource(normalizedOptions.resource))
+    throw new Error("usePresence() does not support media library resources. Presence tracking requires a canvas or dataset resource.");
+  const sanityInstance = useSanityInstance();
   trackHookUsage(sanityInstance, "usePresence");
-  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;
+  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);
+  const instance = useSanityInstance();
   trackHookUsage(instance, "useDocumentProjection");
-  const normalizedProjection = useMemo(() => projection.trim(), [projection]), normalizedDocHandle = useNormalizedSourceOptions(docHandle), stateSource = useMemo(() => getProjectionState(instance, {
+  const normalizedProjection = useMemo(() => projection.trim(), [projection]), normalizedDocHandle = useNormalizedResourceOptions(docHandle), stateSource = useMemo(() => getProjectionState(instance, {
     ...normalizedDocHandle,
     projection: normalizedProjection
   }), [instance, normalizedDocHandle, normalizedProjection]);
@@ -1479,9 +1695,9 @@ function useDocumentPreview(t0) {
     ref,
     ...docHandle
   } = t0, $[0] = t0, $[1] = docHandle, $[2] = ref) : (docHandle = $[1], ref = $[2]);
-  const instance = useSanityInstance(docHandle);
+  const instance = useSanityInstance();
   trackHookUsage(instance, "useDocumentPreview");
-  const normalizedDocHandle = useNormalizedSourceOptions(docHandle);
+  const normalizedDocHandle = useNormalizedResourceOptions(docHandle);
   let t1;
   $[3] !== normalizedDocHandle || $[4] !== ref ? (t1 = {
     ...normalizedDocHandle,
@@ -1490,7 +1706,7 @@ function useDocumentPreview(t0) {
   }, $[3] = normalizedDocHandle, $[4] = ref, $[5] = t1) : t1 = $[5];
   const projectionResult = useDocumentProjection(t1);
   let t2, t3;
-  $[6] !== instance || $[7] !== normalizedDocHandle.source || $[8] !== projectionResult.data ? (t3 = transformProjectionToPreview(instance, projectionResult.data, normalizedDocHandle.source), $[6] = instance, $[7] = normalizedDocHandle.source, $[8] = projectionResult.data, $[9] = t3) : t3 = $[9], t2 = t3;
+  $[6] !== instance || $[7] !== normalizedDocHandle.resource || $[8] !== projectionResult.data ? (t3 = transformProjectionToPreview(instance, projectionResult.data, normalizedDocHandle.resource), $[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 = {
@@ -1499,38 +1715,40 @@ function useDocumentPreview(t0) {
   }, $[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,
+  shouldSuspend: (instance, ...params) => getProjectState(instance, ...params).getCurrent() === void 0,
   suspender: resolveProject,
   getConfig: identity
 }), useProjects = createStateSourceHook({
   getState: getProjectsState,
-  shouldSuspend: (instance, options) => getProjectsState(instance, options).getCurrent() === void 0,
+  shouldSuspend: (instance, ...params) => getProjectsState(instance, ...params).getCurrent() === void 0,
   suspender: resolveProjects
 }), useActiveReleasesValue = createStateSourceHook({
   getState: getActiveReleasesState,
   shouldSuspend: (instance, options) => getActiveReleasesState(instance, options ?? {}).getCurrent() === void 0,
   suspender: (instance, options) => firstValueFrom(getActiveReleasesState(instance, options ?? {}).observable.pipe(filter(Boolean)))
-}), useActiveReleases = (options) => {
+});
+function useActiveReleases(options) {
   const $ = c(2);
   let t0;
   $[0] !== options ? (t0 = options ?? {}, $[0] = options, $[1] = t0) : t0 = $[1];
-  const normalizedOptions = useNormalizedSourceOptions(t0);
+  const normalizedOptions = useNormalizedResourceOptions(t0);
   return useActiveReleasesValue(normalizedOptions);
-}, usePerspectiveValue = createStateSourceHook({
+}
+const usePerspectiveValue = createStateSourceHook({
   getState: getPerspectiveState,
   shouldSuspend: (instance, options) => getPerspectiveState(instance, options).getCurrent() === void 0,
   suspender: (instance, _options) => firstValueFrom(getPerspectiveState(instance, _options ?? {}).observable.pipe(filter(Boolean)))
-}), usePerspective = (options) => {
+});
+function usePerspective(perspectiveHandle) {
   const $ = c(2);
   let t0;
-  $[0] !== options ? (t0 = options ?? {}, $[0] = options, $[1] = t0) : t0 = $[1];
-  const normalizedOptions = useNormalizedSourceOptions(t0);
+  $[0] !== perspectiveHandle ? (t0 = perspectiveHandle ?? {}, $[0] = perspectiveHandle, $[1] = t0) : t0 = $[1];
+  const normalizedOptions = useNormalizedResourceOptions(t0);
   return usePerspectiveValue(normalizedOptions);
-};
+}
 function useUser(options) {
-  const instance = useSanityInstance(options);
+  const instance = useSanityInstance();
   trackHookUsage(instance, "useUser");
   const [isPending, startTransition] = useTransition(), key = getUsersKey(instance, options), [deferredKey, setDeferredKey] = useState(key), deferred = useMemo(() => parseUsersKey(deferredKey), [deferredKey]), [ref, setRef] = useState(new AbortController());
   useEffect(() => {
@@ -1553,7 +1771,7 @@ function useUser(options) {
   };
 }
 function useUsers(options) {
-  const instance = useSanityInstance(options);
+  const instance = useSanityInstance();
   trackHookUsage(instance, "useUsers");
   const [isPending, startTransition] = useTransition(), key = getUsersKey(instance, options), [deferredKey, setDeferredKey] = useState(key), deferred = useMemo(() => parseUsersKey(deferredKey), [deferredKey]), [ref, setRef] = useState(new AbortController());
   useEffect(() => {
@@ -1583,7 +1801,7 @@ function useUsers(options) {
     loadMore
   };
 }
-var version = "2.9.0";
+var version = "2.11.0";
 function getEnv(key) {
   if (typeof import.meta < "u" && import.meta.env)
     return import.meta.env[key];
@@ -1601,6 +1819,7 @@ export {
   SDKProvider,
   SDKStudioContext,
   SanityApp,
+  SanityInstanceProvider,
   renderSanityApp,
   useActiveReleases,
   useAgentGenerate,
@@ -1632,6 +1851,8 @@ export {
   useLoginUrl,
   useManageFavorite,
   useNavigateToStudioDocument,
+  useOrganization,
+  useOrganizations,
   usePaginatedDocuments,
   usePerspective,
   usePresence,
@@ -1639,6 +1860,7 @@ export {
   useProjects,
   useQuery,
   useRecordDocumentHistoryEvent,
+  useResource,
   useSanityInstance,
   useStudioWorkspacesByProjectIdDataset,
   useUser,