@sanity/sdk-react 2.10.0 → 2.11.0

package/dist/index.js

@@ -1,40 +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, isImportError, getCorsErrorProjectId, createSanityInstance, agentGenerate, agentTransform, agentTranslate, agentPrompt, agentPatch, getTokenState, getCurrentUserState, getDashboardOrganizationId, getClientState, getOrCreateController, getOrCreateChannel, releaseChannel, isDatasetResource, 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";
+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, Suspense, useMemo, 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";
-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;
@@ -66,7 +60,7 @@ function useWindowConnection(t0) {
     const [type, handler] = t42, messageUnsubscribe = node.on(type, handler);
     messageUnsubscribe && messageUnsubscribers.current.push(messageUnsubscribe);
   }), () => {
-    messageUnsubscribers.current.forEach(_temp$9), messageUnsubscribers.current = [];
+    messageUnsubscribers.current.forEach(_temp$8), 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 +78,7 @@ function useWindowConnection(t0) {
     fetch
   }, $[16] = fetch, $[17] = sendMessage, $[18] = t7) : t7 = $[18], t7;
 }
-function _temp$9(unsubscribe) {
+function _temp$8(unsubscribe) {
   return unsubscribe();
 }
 const DEFAULT_RESPONSE_TIMEOUT = 1e4;
@@ -114,7 +108,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$8) && errorContainer.remove();
+          errorContainer && Array.from(errorContainer.getElementsByTagName("div")).some(_temp$7) && errorContainer.remove();
         }
         isTokenRefreshInProgress.current = !1;
       } catch {
@@ -135,7 +129,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$8(div) {
+function _temp$7(div) {
   return div.textContent?.includes("Uncaught error: Unauthorized - A valid session is required for this endpoint");
 }
 const ComlinkTokenRefreshProvider = (t0) => {
@@ -272,10 +266,10 @@ function ChunkLoadError(_props) {
   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$7
+    onClick: _temp$6
   } }), $[3] = t3) : t3 = $[3], t3;
 }
-function _temp$7() {
+function _temp$6() {
   clearChunkReloadFlag(), reload();
 }
 function CorsErrorComponent(t0) {
@@ -336,10 +330,10 @@ 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);
@@ -491,6 +485,7 @@ 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,
@@ -503,36 +498,72 @@ function SanityInstanceProvider(t0) {
   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(SanityInstanceProvider, { instance, 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$5, t0), null;
+  return $[0] === Symbol.for("react.memo_cache_sentinel") ? (t0 = [], $[0] = t0) : t0 = $[0], useEffect(_temp$4, t0), null;
 }
-function _temp$5() {
+function _temp$4() {
   clearChunkReloadFlag();
 }
 function SDKProvider(t0) {
-  const $ = c(20);
+  const $ = c(29);
   let children, config, fallback, props;
   $[0] !== t0 ? ({
     children,
@@ -542,23 +573,42 @@ 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(_temp2$1).filter(_temp3$1), $[7] = t1, $[8] = configs, $[9] = t2) : (configs = $[8], t2 = $[9]);
-  const projectIds = t2;
-  let t3, t4;
-  $[10] !== props.resources ? (t4 = props.resources ?? {}, $[10] = props.resources, $[11] = t4) : t4 = $[11], t3 = t4;
+  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] !== resourcesValue) {
-    const createNestedProviders = (index) => index >= configs.length ? /* @__PURE__ */ jsx(AuthBoundary, { ...props, projectIds, children: /* @__PURE__ */ jsx(ResourcesContext.Provider, { value: resourcesValue, children }) }) : /* @__PURE__ */ jsx(ResourceProvider, { ...configs[index], fallback, children: createNestedProviders(index + 1) });
-    let t6;
-    $[19] === Symbol.for("react.memo_cache_sentinel") ? (t6 = /* @__PURE__ */ jsx(ResetChunkReloadFlagOnMount, {}), $[19] = t6) : t6 = $[19], t5 = /* @__PURE__ */ jsxs(ErrorBoundary, { FallbackComponent: ChunkAwareFallback, children: [
-      t6,
-      createNestedProviders(0)
-    ] }), $[12] = children, $[13] = configs, $[14] = fallback, $[15] = projectIds, $[16] = props, $[17] = resourcesValue, $[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 _temp3$1(id) {
   return !!id;
@@ -616,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) {
@@ -632,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;
+}
+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;
 }
-const useAgentPrompt = createCallbackHook(promptAdapter);
-function patchAdapter(instance, options) {
-  return firstValueFrom(agentPatch(instance, options));
+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,
@@ -729,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;
@@ -751,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;
@@ -767,39 +926,12 @@ function useDashboardNavigate(navigateFn) {
     }
   }, $[0] = navigateFn, $[1] = t0) : t0 = $[1], useWindowConnection(t0);
 }
-function normalizeResourceOptions(options, resources) {
-  const {
-    resourceName,
-    sourceName,
-    source,
-    ...rest
-  } = options, effectiveResourceName = resourceName ?? sourceName, effectiveResource = options.resource ?? source;
-  if (!effectiveResourceName && !effectiveResource)
-    return rest;
-  const hasNameKey = Object.hasOwn(options, "resourceName") || Object.hasOwn(options, "sourceName"), hasResourceKey = Object.hasOwn(options, "resource") || Object.hasOwn(options, "source");
-  if (hasNameKey && hasResourceKey)
-    throw new Error(`Resource name ${JSON.stringify(effectiveResourceName)} and resource ${JSON.stringify(effectiveResource)} cannot be used together.`);
-  let resolvedResource;
-  if (effectiveResource && (resolvedResource = effectiveResource), effectiveResourceName && !Object.hasOwn(resources, effectiveResourceName))
-    throw new Error(`There's no resource named ${JSON.stringify(effectiveResourceName)} in context. Please use <ResourceProvider>.`);
-  return effectiveResourceName && resources[effectiveResourceName] && (resolvedResource = resources[effectiveResourceName]), {
-    ...rest,
-    resource: resolvedResource
-  };
-}
-function useNormalizedResourceOptions(options) {
-  const $ = c(3), resources = useContext(ResourcesContext);
-  let t0;
-  return $[0] !== options || $[1] !== resources ? (t0 = normalizeResourceOptions(options, resources), $[0] = options, $[1] = resources, $[2] = t0) : t0 = $[2], t0;
-}
 function useResourceIdFromDocumentHandle(documentHandle) {
   const $ = c(3), options = useNormalizedResourceOptions(documentHandle), {
-    projectId,
-    dataset,
     resource
   } = options;
   let resourceId = "", resourceType;
-  projectId && dataset && (resourceId = `${projectId}.${dataset}`), 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"));
+  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,
@@ -1113,50 +1245,24 @@ const useDatasets = createStateSourceHook({
   suspender: resolveDatasets,
   getConfig: identity
 }), useApplyDocumentActions = () => {
-  const $ = c(3), instance = useSanityInstance(), resources = useContext(ResourcesContext);
+  const $ = c(4), instance = useSanityInstance(), resources = useContext(ResourcesContext), effectiveContextResource = useEffectiveContextResource();
   let t0;
-  return $[0] !== instance || $[1] !== resources ? (t0 = (actionOrActions, options) => {
-    const actions = Array.isArray(actionOrActions) ? actionOrActions : [actionOrActions], normalizedOptions = options ? normalizeResourceOptions(options, resources) : void 0;
-    let projectId, dataset, resource;
-    for (const action of actions) {
-      if (action.projectId) {
-        if (resource)
-          throw new Error(`Mismatches between projectId/dataset options and resource in actions. Found projectId "${action.projectId}" and dataset "${action.dataset}" but expected resource "${resource}".`);
-        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.resource) {
-        if (resource || (resource = action.resource), action.resource !== resource)
-          throw new Error(`Mismatched resources found in actions. All actions must belong to the same resource. Found "${action.resource}" but expected "${resource}".`);
-        if (projectId || dataset)
-          throw new Error(`Mismatches between projectId/dataset options and resource in actions. Found "${action.resource}" 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,
-        resource,
-        ...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,
-      resource,
-      ...normalizedOptions
+      actions: normalizedActions,
+      resource: effectiveResource
     });
-  }, $[0] = instance, $[1] = resources, $[2] = t0) : t0 = $[2], t0;
+  }, $[0] = effectiveContextResource, $[1] = instance, $[2] = resources, $[3] = t0) : t0 = $[3], t0;
 };
 function useTrackHookUsage(hookName) {
   const instance = useSanityInstance(), tracked = useRef(null);
@@ -1204,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.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);
 }
+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, resource;
-  if ($[2] !== actions || $[3] !== dataset || $[4] !== projectId || $[5] !== resource) {
-    for (const action of actions) {
-      if (action.projectId) {
-        if (resource)
-          throw new Error(`Mismatches between projectId/dataset options and resource in actions. Found projectId "${action.projectId}" and dataset "${action.dataset}" but expected resource "${resource}".`);
-        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.resource) {
-        if (resource || (resource = action.resource), action.resource !== resource)
-          throw new Error(`Mismatched resources found in actions. All actions must belong to the same resource. Found "${action.resource}" but expected "${resource}".`);
-        if (projectId || dataset)
-          throw new Error(`Mismatches between projectId/dataset options and resource in actions. Found "${action.resource}" but expected project "${projectId}" and dataset "${dataset}".`);
-      }
-    }
-    $[2] = actions, $[3] = dataset, $[4] = projectId, $[5] = resource, $[6] = projectId, $[7] = dataset, $[8] = resource;
-  } else
-    projectId = $[6], dataset = $[7], resource = $[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,
@@ -1278,7 +1370,7 @@ 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 = useNormalizedResourceOptions(doc), apply = useApplyDocumentActions();
   if (getDocumentState(instance, normalizedDoc).getCurrent() === void 0)
@@ -1320,7 +1412,7 @@ function _temp$1(key) {
   return !ignoredKeys.includes(key);
 }
 function useQuery(options) {
-  const instance = useSanityInstance(options);
+  const instance = useSanityInstance();
   trackHookUsage(instance, "useQuery");
   const normalized = useNormalizedResourceOptions(options), [isPending, startTransition] = useTransition(), queryKey = getQueryKey(normalized), [deferredQueryKey, setDeferredQueryKey] = useState(queryKey), ref = useRef(new AbortController());
   useEffect(() => {
@@ -1356,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,
@@ -1389,9 +1481,10 @@ function useDocuments({
       ...params,
       // these are passed back to the user as part of each document handle
       __handle: {
-        projectId: options.projectId ?? instance.config.projectId,
-        dataset: options.dataset ?? instance.config.dataset,
-        perspective: options.perspective ?? instance.config.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
     }
@@ -1406,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(56);
-  let documentType, options, orderings, search, t1, t2, t3;
+  const $ = c(60);
+  let documentType, orderings, rawOptions, search, t1, t2, t3;
   $[0] !== t0 ? ({
     documentType,
     filter: t1,
@@ -1416,29 +1518,30 @@ 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];
+    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] !== documentType ? (t6 = Array.isArray(documentType) ? documentType : [documentType], $[16] = documentType, $[17] = t6) : t6 = $[17];
+  $[17] !== documentType ? (t6 = Array.isArray(documentType) ? documentType : [documentType], $[17] = documentType, $[18] = t6) : t6 = $[18];
   let t7;
-  $[18] !== t6 ? (t7 = t6.filter(_temp), $[18] = t6, $[19] = t7) : t7 = $[19];
+  $[19] !== t6 ? (t7 = t6.filter(_temp), $[19] = t6, $[20] = t7) : t7 = $[20];
   const documentTypes = t7;
   let t8;
   const conditions = [], trimmedSearch = search?.trim();
@@ -1447,51 +1550,54 @@ function usePaginatedDocuments(t0) {
     searchFilter && conditions.push(searchFilter);
   }
   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}}`, t10 = options.projectId ?? instance.config.projectId, t11 = options.dataset ?? instance.config.dataset, t12 = options.perspective ?? instance.config.perspective;
+  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;
+  $[25] !== t10 || $[26] !== t11 ? (t12 = {
+    ...t10,
+    ...t11
+  }, $[25] = t10, $[26] = t11, $[27] = t12) : t12 = $[27];
   let t13;
-  $[20] !== t10 || $[21] !== t11 || $[22] !== t12 ? (t13 = {
-    projectId: t10,
-    dataset: t11,
-    perspective: t12
-  }, $[20] = t10, $[21] = t11, $[22] = t12, $[23] = t13) : t13 = $[23];
-  let t14;
-  $[24] !== documentTypes || $[25] !== params || $[26] !== t13 ? (t14 = {
+  $[28] !== documentTypes || $[29] !== params || $[30] !== t12 ? (t13 = {
     ...params,
     __types: documentTypes,
-    __handle: t13
-  }, $[24] = documentTypes, $[25] = params, $[26] = t13, $[27] = t14) : t14 = $[27];
-  let t15;
-  $[28] !== options || $[29] !== t14 || $[30] !== t9 ? (t15 = {
+    __handle: t12
+  }, $[28] = documentTypes, $[29] = params, $[30] = t12, $[31] = t13) : t13 = $[31];
+  let t14;
+  $[32] !== options || $[33] !== t13 || $[34] !== t9 ? (t14 = {
     ...options,
     query: t9,
-    params: t14
-  }, $[28] = options, $[29] = t14, $[30] = t9, $[31] = t15) : t15 = $[31];
+    params: t13
+  }, $[32] = options, $[33] = t13, $[34] = t9, $[35] = t14) : t14 = $[35];
   const {
-    data: t16,
+    data: t15,
     isPending
-  } = useQuery(t15), {
+  } = useQuery(t14), {
     data,
     count
-  } = t16, 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;
-  $[32] === Symbol.for("react.memo_cache_sentinel") ? (t17 = () => setPageIndex(0), $[32] = t17) : t17 = $[32];
-  const firstPage = t17;
+  $[37] === Symbol.for("react.memo_cache_sentinel") ? (t17 = () => setPageIndex(_temp4), $[37] = t17) : t17 = $[37];
+  const previousPage = t17;
   let t18;
-  $[33] === Symbol.for("react.memo_cache_sentinel") ? (t18 = () => setPageIndex(_temp4), $[33] = t18) : t18 = $[33];
-  const previousPage = 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;
-  $[34] !== totalPages ? (t19 = () => setPageIndex((prev_0) => Math.min(prev_0 + 1, totalPages - 1)), $[34] = totalPages, $[35] = t19) : t19 = $[35];
-  const nextPage = t19;
+  $[40] !== totalPages ? (t19 = () => setPageIndex(totalPages - 1), $[40] = totalPages, $[41] = t19) : t19 = $[41];
+  const lastPage = t19;
   let t20;
-  $[36] !== totalPages ? (t20 = () => setPageIndex(totalPages - 1), $[36] = totalPages, $[37] = t20) : t20 = $[37];
-  const lastPage = t20;
-  let t21;
-  $[38] !== totalPages ? (t21 = (pageNumber) => {
+  $[42] !== totalPages ? (t20 = (pageNumber) => {
     pageNumber < 1 || pageNumber > totalPages || setPageIndex(pageNumber - 1);
-  }, $[38] = totalPages, $[39] = t21) : t21 = $[39];
-  const goToPage = t21, hasFirstPage = pageIndex > 0, hasPreviousPage = pageIndex > 0, hasNextPage = pageIndex < totalPages - 1, hasLastPage = pageIndex < totalPages - 1;
-  let t22;
-  return $[40] !== count || $[41] !== currentPage || $[42] !== data || $[43] !== endIndex || $[44] !== goToPage || $[45] !== hasFirstPage || $[46] !== hasLastPage || $[47] !== hasNextPage || $[48] !== hasPreviousPage || $[49] !== isPending || $[50] !== lastPage || $[51] !== nextPage || $[52] !== pageSize || $[53] !== startIndex || $[54] !== totalPages ? (t22 = {
+  }, $[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,
@@ -1509,7 +1615,7 @@ function usePaginatedDocuments(t0) {
     lastPage,
     hasLastPage,
     goToPage
-  }, $[40] = count, $[41] = currentPage, $[42] = data, $[43] = endIndex, $[44] = goToPage, $[45] = hasFirstPage, $[46] = hasLastPage, $[47] = hasNextPage, $[48] = hasPreviousPage, $[49] = isPending, $[50] = lastPage, $[51] = nextPage, $[52] = pageSize, $[53] = startIndex, $[54] = totalPages, $[55] = t22) : t22 = $[55], t22;
+  }, $[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);
@@ -1553,7 +1659,7 @@ function useDocumentProjection({
   projection,
   ...docHandle
 }) {
-  const instance = useSanityInstance(docHandle);
+  const instance = useSanityInstance();
   trackHookUsage(instance, "useDocumentProjection");
   const normalizedProjection = useMemo(() => projection.trim(), [projection]), normalizedDocHandle = useNormalizedResourceOptions(docHandle), stateSource = useMemo(() => getProjectionState(instance, {
     ...normalizedDocHandle,
@@ -1589,7 +1695,7 @@ 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 = useNormalizedResourceOptions(docHandle);
   let t1;
@@ -1609,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 = 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];
+  $[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(() => {
@@ -1663,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(() => {
@@ -1693,7 +1801,7 @@ function useUsers(options) {
     loadMore
   };
 }
-var version = "2.10.0";
+var version = "2.11.0";
 function getEnv(key) {
   if (typeof import.meta < "u" && import.meta.env)
     return import.meta.env[key];
@@ -1743,6 +1851,8 @@ export {
   useLoginUrl,
   useManageFavorite,
   useNavigateToStudioDocument,
+  useOrganization,
+  useOrganizations,
   usePaginatedDocuments,
   usePerspective,
   usePresence,
@@ -1750,6 +1860,7 @@ export {
   useProjects,
   useQuery,
   useRecordDocumentHistoryEvent,
+  useResource,
   useSanityInstance,
   useStudioWorkspacesByProjectIdDataset,
   useUser,