@sanity/sdk-react 2.4.0 → 2.6.0

package/dist/index.d.ts

@@ -52,6 +52,24 @@ import {StudioResource} from '@sanity/message-protocol'
 import {UserPresence} from '@sanity/sdk'
 import {WindowMessage} from '@sanity/sdk'
 
+/**
+ * @public
+ */
+export declare interface AgentResourceContextOptions {
+  /**
+   * The project ID of the current context
+   */
+  projectId: string
+  /**
+   * The dataset of the current context
+   */
+  dataset: string
+  /**
+   * Optional document ID if the user is viewing/editing a specific document
+   */
+  documentId?: string
+}
+
 /**
  * A component that handles authentication flow and error boundaries for a
  * protected section of the application.
@@ -158,18 +176,6 @@ declare interface DispatchIntent {
   dispatchIntent: () => void
 }
 
-/**
- * Document handle that optionally includes a source (e.g., media library source)
- * or projectId and dataset for traditional dataset sources
- * (but now marked optional since it's valid to just use a source)
- * @beta
- */
-declare interface DocumentHandleWithSource extends Omit<DocumentHandle, 'projectId' | 'dataset'> {
-  source?: DocumentSource
-  projectId?: string
-  dataset?: string
-}
-
 declare interface DocumentInteractionHistory {
   recordEvent: (eventType: 'viewed' | 'edited' | 'created' | 'deleted') => void
 }
@@ -200,6 +206,7 @@ export declare interface DocumentsOptions<
   batchSize?: number
   /**
    * Sorting configuration for the results
+   * @beta
    */
   orderings?: SortOrderingItem[]
   /**
@@ -289,6 +296,13 @@ export declare type MessageHandler<TWindowMessage extends WindowMessage> = (
   event: TWindowMessage['data'],
 ) => TWindowMessage['response'] | Promise<TWindowMessage['response']>
 
+/** In-flight CLI PR is using named sources since it's aspirational.
+ *  We can transform the shape in this function until it's finalized.
+ */
+declare interface NamedSources {
+  [key: string]: SanityConfig
+}
+
 /**
  * @public
  * @category Types
@@ -325,6 +339,7 @@ export declare interface PaginatedDocumentsOptions<
   pageSize?: number
   /**
    * Sorting configuration for the results
+   * @beta
    */
   orderings?: SortOrderingItem[]
   /**
@@ -428,6 +443,18 @@ export declare type ProjectWithoutMembers = Omit<SanityProject_2, 'members'>
  */
 export declare const REACT_SDK_VERSION: {}
 
+/** @internal */
+export declare function renderSanityApp(
+  rootElement: HTMLElement | null,
+  namedSources: NamedSources,
+  options: RenderSanitySDKAppOptions,
+  children: React.ReactNode,
+): () => void
+
+declare interface RenderSanitySDKAppOptions {
+  reactStrictMode?: boolean
+}
+
 /**
  * Provides a Sanity instance to child components through React Context
  *
@@ -565,6 +592,7 @@ export declare interface SanityAppProps {
   config: SanityConfig | SanityConfig[]
   /** @deprecated use the `config` prop instead. */
   sanityConfigs?: SanityConfig[]
+  sources?: Record<string, DocumentSource>
   children: React.ReactNode
   fallback: React.ReactNode
 }
@@ -594,6 +622,7 @@ export declare interface SDKProviderProps extends AuthBoundaryProps {
   children: ReactNode
   config: SanityConfig | SanityConfig[]
   fallback: ReactNode
+  sources?: Record<string, DocumentSource>
 }
 
 export {SortOrderingItem}
@@ -679,6 +708,38 @@ export declare const useAgentPrompt: () => (
   options: AgentPromptOptions,
 ) => Promise<AgentPromptResult>
 
+/**
+ * @public
+ * Hook for emitting agent resource context updates to the Dashboard.
+ * This allows the Agent to understand what resource the user is currently
+ * interacting with (e.g., which document they're editing).
+ *
+ * The hook will automatically emit the context when it changes, and also
+ * emit the initial context when the hook is first mounted.
+ *
+ * @category Agent
+ * @param options - The resource context options containing projectId, dataset, and optional documentId
+ *
+ * @example
+ * ```tsx
+ * import {useAgentResourceContext} from '@sanity/sdk-react'
+ *
+ * function MyComponent() {
+ *   const documentId = 'my-document-id'
+ *
+ *   // Automatically updates the Agent's context whenever the document changes
+ *   useAgentResourceContext({
+ *     projectId: 'my-project',
+ *     dataset: 'production',
+ *     documentId,
+ *   })
+ *
+ *   return <div>Editing document: {documentId}</div>
+ * }
+ * ```
+ */
+export declare function useAgentResourceContext(options: AgentResourceContextOptions): void
+
 /**
  * @alpha
  * Transforms an existing document or selected fields using Sanity Agent Actions.
@@ -1096,7 +1157,7 @@ export declare function useDispatchIntent(params: UseDispatchIntentParams): Disp
 declare interface UseDispatchIntentParams {
   action?: 'edit'
   intentId?: string
-  documentHandle: DocumentHandleWithSource
+  documentHandle: DocumentHandle
   parameters?: Record<string, unknown>
 }
 
@@ -2408,8 +2469,9 @@ export declare function useQuery<
   TQuery extends string = string,
   TDataset extends string = string,
   TProjectId extends string = string,
+  TSourceName extends string = string,
 >(
-  options: QueryOptions<TQuery, TDataset, TProjectId>,
+  options: UseQueryOptions<TQuery, TDataset, TProjectId, TSourceName>,
 ): {
   /** The query result, typed based on the GROQ query string */
   data: SanityQueryResult<TQuery, `${TProjectId}.${TDataset}`>
@@ -2452,6 +2514,15 @@ export declare function useQuery<TData>(options: QueryOptions): {
   isPending: boolean
 }
 
+declare interface UseQueryOptions<
+  TQuery extends string = string,
+  TDataset extends string = string,
+  TProjectId extends string = string,
+  TSourceName extends string = string,
+> extends QueryOptions<TQuery, TDataset, TProjectId> {
+  sourceName?: TSourceName
+}
+
 /**
  * @internal
  * Hook for managing document interaction history in Sanity Studio.

package/dist/index.js

@@ -1,12 +1,13 @@
 import { jsx, jsxs, Fragment } from "react/jsx-runtime";
 import { c } from "react-compiler-runtime";
 import { ClientError, CorsOriginError } from "@sanity/client";
-import { getAuthState, getNodeState, getIsInDashboardState, setAuthToken, AuthStateType, getLoginUrlState, observeOrganizationVerificationState, handleAuthCallback, logout, isProjectUserNotFoundClientError, getClientErrorApiDescription, getClientErrorApiBody, getCorsErrorProjectId, createSanityInstance, agentGenerate, agentTransform, agentTranslate, agentPrompt, agentPatch, getTokenState, getCurrentUserState, getDashboardOrganizationId, getClientState, getOrCreateController, getOrCreateChannel, releaseChannel, getFavoritesState, resolveFavoritesState, resolveDatasets, getDatasetsState, applyDocumentActions, resolveDocument, getDocumentState, subscribeDocumentEvents, getPermissionsState, getDocumentSyncStatus, editDocument, getQueryKey, parseQueryKey, getQueryState, resolveQuery, createGroqSearchFilter, getPresence, getPreviewState, resolvePreview, getProjectionState, resolveProjection, resolveProject, getProjectState, resolveProjects, getProjectsState, getActiveReleasesState, getPerspectiveState, getUsersKey, parseUsersKey, getUsersState, resolveUsers, loadMoreUsers } from "@sanity/sdk";
+import { getAuthState, getNodeState, getIsInDashboardState, setAuthToken, AuthStateType, getLoginUrlState, observeOrganizationVerificationState, handleAuthCallback, logout, isProjectUserNotFoundClientError, getClientErrorApiDescription, getClientErrorApiBody, getCorsErrorProjectId, createSanityInstance, agentGenerate, agentTransform, agentTranslate, agentPrompt, agentPatch, getTokenState, getCurrentUserState, getDashboardOrganizationId, getClientState, getOrCreateController, getOrCreateChannel, releaseChannel, isDatasetSource, isMediaLibrarySource, isCanvasSource, getFavoritesState, resolveFavoritesState, resolveDatasets, getDatasetsState, applyDocumentActions, resolveDocument, getDocumentState, subscribeDocumentEvents, getPermissionsState, getDocumentSyncStatus, editDocument, getQueryKey, parseQueryKey, getQueryState, resolveQuery, createGroqSearchFilter, getPresence, getPreviewState, resolvePreview, getProjectionState, resolveProjection, resolveProject, getProjectState, resolveProjects, getProjectsState, getActiveReleasesState, getPerspectiveState, getUsersKey, parseUsersKey, getUsersState, resolveUsers, loadMoreUsers } from "@sanity/sdk";
 export * from "@sanity/sdk";
-import { createContext, useContext, useSyncExternalStore, useRef, useEffect, useState, Suspense, useCallback, useMemo, 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 { createRoot } from "react-dom/client";
 import { pick } from "lodash-es";
 const SanityInstanceContext = createContext(null), useSanityInstance = (config) => {
   const $ = c(3), instance = useContext(SanityInstanceContext);
@@ -65,7 +66,7 @@ function useWindowConnection(t0) {
     const [type, handler] = t42, messageUnsubscribe = node.on(type, handler);
     messageUnsubscribe && messageUnsubscribers.current.push(messageUnsubscribe);
   }), () => {
-    messageUnsubscribers.current.forEach(_temp$7), 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);
@@ -83,7 +84,7 @@ function useWindowConnection(t0) {
     fetch
   }, $[16] = fetch, $[17] = sendMessage, $[18] = t7) : t7 = $[18], t7;
 }
-function _temp$7(unsubscribe) {
+function _temp$8(unsubscribe) {
   return unsubscribe();
 }
 const DEFAULT_RESPONSE_TIMEOUT = 1e4;
@@ -113,7 +114,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$6) && errorContainer.remove();
+          errorContainer && Array.from(errorContainer.getElementsByTagName("div")).some(_temp$7) && errorContainer.remove();
         }
         isTokenRefreshInProgress.current = !1;
       } catch {
@@ -134,7 +135,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$6(div) {
+function _temp$7(div) {
   return div.textContent?.includes("Uncaught error: Unauthorized - A valid session is required for this endpoint");
 }
 const ComlinkTokenRefreshProvider = (t0) => {
@@ -289,10 +290,10 @@ function LoginCallback() {
   let t0, t1;
   return $[0] !== handleAuthCallback2 ? (t0 = () => {
     const url = new URL(location.href);
-    handleAuthCallback2(url.toString()).then(_temp$5);
+    handleAuthCallback2(url.toString()).then(_temp$6);
   }, t1 = [handleAuthCallback2], $[0] = handleAuthCallback2, $[1] = t0, $[2] = t1) : (t0 = $[1], t1 = $[2]), useEffect(t0, t1), null;
 }
-function _temp$5(replacementLocation) {
+function _temp$6(replacementLocation) {
   replacementLocation && history.replaceState(null, "", replacementLocation);
 }
 const useLogOut = createCallbackHook(logout);
@@ -419,14 +420,37 @@ function ResourceProvider(t0) {
   let t7;
   return $[13] !== instance || $[14] !== t6 ? (t7 = /* @__PURE__ */ jsx(SanityInstanceContext.Provider, { value: instance, children: t6 }), $[13] = instance, $[14] = t6, $[15] = t7) : t7 = $[15], t7;
 }
-function SDKProvider({
-  children,
-  config,
-  fallback,
-  ...props
-}) {
-  const configs = (Array.isArray(config) ? config : [config]).slice().reverse(), projectIds = configs.map((c2) => c2.projectId).filter((id) => !!id), createNestedProviders = (index) => index >= configs.length ? /* @__PURE__ */ jsx(AuthBoundary, { ...props, projectIds, children }) : /* @__PURE__ */ jsx(ResourceProvider, { ...configs[index], fallback, children: createNestedProviders(index + 1) });
-  return createNestedProviders(0);
+const SourcesContext = createContext({});
+function SDKProvider(t0) {
+  const $ = c(19);
+  let children, config, fallback, props;
+  $[0] !== t0 ? ({
+    children,
+    config,
+    fallback,
+    ...props
+  } = t0, $[0] = t0, $[1] = children, $[2] = config, $[3] = fallback, $[4] = props) : (children = $[1], config = $[2], fallback = $[3], props = $[4]);
+  let t1;
+  $[5] !== config ? (t1 = Array.isArray(config) ? config : [config], $[5] = config, $[6] = t1) : t1 = $[6];
+  let configs, t2;
+  $[7] !== t1 ? (configs = t1.slice().reverse(), t2 = configs.map(_temp$5).filter(_temp2$1), $[7] = t1, $[8] = configs, $[9] = t2) : (configs = $[8], t2 = $[9]);
+  const projectIds = t2;
+  let t3, t4;
+  $[10] !== props.sources ? (t4 = props.sources ?? {}, $[10] = props.sources, $[11] = t4) : t4 = $[11], t3 = t4;
+  const sourcesValue = t3;
+  let t5;
+  if ($[12] !== children || $[13] !== configs || $[14] !== fallback || $[15] !== projectIds || $[16] !== props || $[17] !== sourcesValue) {
+    const createNestedProviders = (index) => index >= configs.length ? /* @__PURE__ */ jsx(AuthBoundary, { ...props, projectIds, children: /* @__PURE__ */ jsx(SourcesContext.Provider, { value: sourcesValue, children }) }) : /* @__PURE__ */ jsx(ResourceProvider, { ...configs[index], fallback, children: createNestedProviders(index + 1) });
+    t5 = createNestedProviders(0), $[12] = children, $[13] = configs, $[14] = fallback, $[15] = projectIds, $[16] = props, $[17] = sourcesValue, $[18] = t5;
+  } else
+    t5 = $[18];
+  return t5;
+}
+function _temp2$1(id) {
+  return !!id;
+}
+function _temp$5(c2) {
+  return c2.projectId;
 }
 const REDIRECT_URL = "https://sanity.io/welcome";
 function SanityApp(t0) {
@@ -453,6 +477,14 @@ function SanityApp(t0) {
 function _temp$4() {
   console.warn("Redirecting to core", REDIRECT_URL), window.location.replace(REDIRECT_URL);
 }
+function renderSanityApp(rootElement, namedSources, options, children) {
+  if (!rootElement)
+    throw new Error("Missing root element to mount application into");
+  const {
+    reactStrictMode = !1
+  } = options, root = createRoot(rootElement), config = Object.values(namedSources);
+  return root.render(reactStrictMode ? /* @__PURE__ */ jsx(StrictMode, { children: /* @__PURE__ */ jsx(SanityApp, { config, fallback: /* @__PURE__ */ jsx("div", { children: "Loading..." }), children }) }) : /* @__PURE__ */ jsx(SanityApp, { config, fallback: /* @__PURE__ */ jsx("div", { children: "Loading..." }), children })), () => root.unmount();
+}
 const useAgentGenerate = createCallbackHook(agentGenerate), useAgentTransform = createCallbackHook(agentTransform), useAgentTranslate = createCallbackHook(agentTranslate);
 function promptAdapter(instance, options) {
   return firstValueFrom(agentPrompt(instance, options));
@@ -461,7 +493,53 @@ const useAgentPrompt = createCallbackHook(promptAdapter);
 function patchAdapter(instance, options) {
   return firstValueFrom(agentPatch(instance, options));
 }
-const useAgentPatch = createCallbackHook(patchAdapter), useAuthToken = createStateSourceHook(getTokenState), useCurrentUser = createStateSourceHook(getCurrentUserState);
+const useAgentPatch = createCallbackHook(patchAdapter);
+function useAgentResourceContext(options) {
+  const $ = c(9), {
+    projectId,
+    dataset,
+    documentId
+  } = options;
+  let t0;
+  $[0] === Symbol.for("react.memo_cache_sentinel") ? (t0 = {
+    name: SDK_NODE_NAME,
+    connectTo: SDK_CHANNEL_NAME
+  }, $[0] = t0) : t0 = $[0];
+  const {
+    sendMessage
+  } = useWindowConnection(t0), lastContextRef = useRef(null);
+  let t1;
+  $[1] !== dataset || $[2] !== documentId || $[3] !== projectId || $[4] !== sendMessage ? (t1 = () => {
+    if (!projectId || !dataset) {
+      console.warn("[useAgentResourceContext] projectId and dataset are required", {
+        projectId,
+        dataset
+      });
+      return;
+    }
+    const contextKey = `${projectId}:${dataset}:${documentId || ""}`;
+    if (lastContextRef.current !== contextKey)
+      try {
+        const message = {
+          type: "dashboard/v1/events/agent/resource/update",
+          data: {
+            projectId,
+            dataset,
+            documentId
+          }
+        };
+        sendMessage(message.type, message.data), lastContextRef.current = contextKey;
+      } catch (t22) {
+        console.error("[useAgentResourceContext] Failed to update context:", t22);
+      }
+  }, $[1] = dataset, $[2] = documentId, $[3] = projectId, $[4] = sendMessage, $[5] = t1) : t1 = $[5];
+  const updateContext = t1;
+  let t2, t3;
+  $[6] !== updateContext ? (t2 = () => {
+    updateContext();
+  }, t3 = [updateContext], $[6] = updateContext, $[7] = t2, $[8] = t3) : (t2 = $[7], t3 = $[8]), useEffect(t2, t3);
+}
+const useAuthToken = createStateSourceHook(getTokenState), useCurrentUser = createStateSourceHook(getCurrentUserState);
 function useDashboardOrganizationId() {
   const $ = c(2), instance = useSanityInstance();
   let t0, t1;
@@ -542,28 +620,28 @@ function useDashboardNavigate(navigateFn) {
     }
   }, $[0] = navigateFn, $[1] = t0) : t0 = $[1], useWindowConnection(t0);
 }
-const SOURCE_ID = "__sanity_internal_sourceId", isDocumentHandleWithSource = (documentHandle) => "source" in documentHandle;
-function getResourceIdFromDocumentHandle(documentHandle) {
-  let source;
-  const {
+function useSource(options) {
+  const sources = useContext(SourcesContext);
+  if (!(!options.sourceName && !options.source)) {
+    if (options.source)
+      return options.source;
+    if (options.sourceName && !Object.hasOwn(sources, options.sourceName))
+      throw new Error(`There's no source named ${JSON.stringify(options.sourceName)} in context. Please use <SourceProvider>.`);
+    return options.sourceName ? sources[options.sourceName] : void 0;
+  }
+}
+function useResourceIdFromDocumentHandle(documentHandle) {
+  const $ = c(3), source = useSource(documentHandle), {
     projectId,
     dataset
   } = documentHandle;
-  isDocumentHandleWithSource(documentHandle) && (source = documentHandle.source);
-  let resourceId = projectId + "." + dataset, resourceType;
-  if (source) {
-    const sourceId = source[SOURCE_ID];
-    if (Array.isArray(sourceId))
-      (sourceId[0] === "media-library" || sourceId[0] === "canvas") && (resourceType = sourceId[0], resourceId = sourceId[1]);
-    else if (sourceId && typeof sourceId == "object" && "projectId" in sourceId) {
-      const datasetSource = sourceId;
-      resourceId = `${datasetSource.projectId}.${datasetSource.dataset}`;
-    }
-  }
-  return {
+  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"));
+  let t0;
+  return $[0] !== resourceId || $[1] !== resourceType ? (t0 = {
     id: resourceId,
     type: resourceType
-  };
+  }, $[0] = resourceId, $[1] = resourceType, $[2] = t0) : t0 = $[2], t0;
 }
 function useDispatchIntent(params) {
   const {
@@ -576,7 +654,7 @@ function useDispatchIntent(params) {
   } = useWindowConnection({
     name: SDK_NODE_NAME,
     connectTo: SDK_CHANNEL_NAME
-  });
+  }), resource = useResourceIdFromDocumentHandle(documentHandle);
   return {
     dispatchIntent: useCallback(() => {
       try {
@@ -585,11 +663,11 @@ function useDispatchIntent(params) {
         const {
           projectId,
           dataset,
-          source
+          sourceName
         } = documentHandle;
-        if (action && intentId && console.warn("useDispatchIntent: Both `action` and `intentId` were provided. Using `intentId` and ignoring `action`."), !source && (!projectId || !dataset))
-          throw new Error("useDispatchIntent: Either `source` or both `projectId` and `dataset` must be provided in documentHandle.");
-        const resource = getResourceIdFromDocumentHandle(documentHandle), message = {
+        if (action && intentId && console.warn("useDispatchIntent: Both `action` and `intentId` were provided. Using `intentId` and ignoring `action`."), !sourceName && (!projectId || !dataset))
+          throw new Error("useDispatchIntent: Either `sourceName` or both `projectId` and `dataset` must be provided in documentHandle.");
+        const message = {
           type: "dashboard/v1/events/intents/dispatch-intent",
           data: {
             ...action && !intentId ? {
@@ -617,7 +695,7 @@ function useDispatchIntent(params) {
       } catch (error) {
         throw console.error("Failed to dispatch intent:", error), error;
       }
-    }, [action, intentId, documentHandle, parameters, sendMessage])
+    }, [action, intentId, documentHandle, parameters, sendMessage, resource.id, resource.type])
   };
 }
 function useManageFavorite({
@@ -832,7 +910,41 @@ const useDatasets = createStateSourceHook({
   ),
   suspender: resolveDatasets,
   getConfig: identity
-}), useApplyDocumentActions = createCallbackHook(applyDocumentActions), useDocumentValue = createStateSourceHook({
+}), useApplyDocumentActions = () => {
+  const $ = c(2), instance = useSanityInstance();
+  let t0;
+  return $[0] !== instance ? (t0 = (actionOrActions, options) => {
+    const actions = Array.isArray(actionOrActions) ? actionOrActions : [actionOrActions];
+    let projectId, dataset;
+    for (const action of actions)
+      if (action.projectId) {
+        if (projectId || (projectId = action.projectId), action.projectId !== projectId)
+          throw new Error(`Mismatched project IDs found in actions. All actions must belong to the same project. Found "${action.projectId}" but expected "${projectId}".`);
+        if (action.dataset && (dataset || (dataset = action.dataset), action.dataset !== dataset))
+          throw new Error(`Mismatched datasets found in actions. All actions must belong to the same dataset. Found "${action.dataset}" but expected "${dataset}".`);
+      }
+    if (projectId || dataset) {
+      const actualInstance = instance.match({
+        projectId,
+        dataset
+      });
+      if (!actualInstance)
+        throw new Error(`Could not find a matching Sanity instance for the requested action: ${JSON.stringify({
+          projectId,
+          dataset
+        }, null, 2)}.
+  Please ensure there is a ResourceProvider component with a matching configuration in the component hierarchy.`);
+      return applyDocumentActions(actualInstance, {
+        actions,
+        ...options
+      });
+    }
+    return applyDocumentActions(instance, {
+      actions,
+      ...options
+    });
+  }, $[0] = instance, $[1] = t0) : t0 = $[1], t0;
+}, useDocumentValue = createStateSourceHook({
   // Pass options directly to getDocumentState
   getState: (instance, options) => getDocumentState(instance, options),
   // Pass options directly to getDocumentState for checking current value
@@ -871,8 +983,8 @@ function useDocumentEvent(options) {
 }
 function useDocumentPermissions(actionOrActions) {
   const $ = c(13);
-  let t0;
-  $[0] !== actionOrActions ? (t0 = Array.isArray(actionOrActions) ? actionOrActions : [actionOrActions], $[0] = actionOrActions, $[1] = t0) : t0 = $[1];
+  let t0, t1;
+  $[0] !== actionOrActions ? (t1 = Array.isArray(actionOrActions) ? actionOrActions : [actionOrActions], $[0] = actionOrActions, $[1] = t1) : t1 = $[1], t0 = t1;
   const actions = t0;
   let projectId, dataset;
   if ($[2] !== actions || $[3] !== dataset || $[4] !== projectId) {
@@ -886,20 +998,26 @@ function useDocumentPermissions(actionOrActions) {
     $[2] = actions, $[3] = dataset, $[4] = projectId, $[5] = projectId, $[6] = dataset;
   } else
     projectId = $[5], dataset = $[6];
-  let t1;
-  $[7] !== dataset || $[8] !== projectId ? (t1 = {
+  let t2;
+  $[7] !== dataset || $[8] !== projectId ? (t2 = {
     projectId,
     dataset
-  }, $[7] = dataset, $[8] = projectId, $[9] = t1) : t1 = $[9];
-  const instance = useSanityInstance(t1);
-  if (getPermissionsState(instance, actionOrActions).getCurrent() === void 0)
-    throw firstValueFrom(getPermissionsState(instance, actionOrActions).observable.pipe(filter(_temp$2)));
-  let t2, t3;
-  $[10] !== actionOrActions || $[11] !== instance ? (t3 = getPermissionsState(instance, actionOrActions), $[10] = actionOrActions, $[11] = instance, $[12] = t3) : t3 = $[12], t2 = t3;
+  }, $[7] = dataset, $[8] = projectId, $[9] = t2) : t2 = $[9];
+  const instance = useSanityInstance(t2);
+  if (getPermissionsState(instance, {
+    actions
+  }).getCurrent() === void 0)
+    throw firstValueFrom(getPermissionsState(instance, {
+      actions
+    }).observable.pipe(filter(_temp$2)));
+  let t3, t4;
+  $[10] !== actions || $[11] !== instance ? (t4 = getPermissionsState(instance, {
+    actions
+  }), $[10] = actions, $[11] = instance, $[12] = t4) : t4 = $[12], t3 = t4;
   const {
     subscribe,
     getCurrent
-  } = t2;
+  } = t3;
   return useSyncExternalStore(subscribe, getCurrent);
 }
 function _temp$2(result) {
@@ -958,7 +1076,7 @@ function _temp$1(key) {
   return !ignoredKeys.includes(key);
 }
 function useQuery(options) {
-  const instance = useSanityInstance(options), [isPending, startTransition] = useTransition(), queryKey = getQueryKey(options), [deferredQueryKey, setDeferredQueryKey] = useState(queryKey), deferred = useMemo(() => parseQueryKey(deferredQueryKey), [deferredQueryKey]), ref = useRef(new AbortController());
+  const instance = useSanityInstance(options), source = useSource(options), [isPending, startTransition] = useTransition(), queryKey = getQueryKey(options), [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);
@@ -967,11 +1085,18 @@ function useQuery(options) {
   const {
     getCurrent,
     subscribe
-  } = useMemo(() => getQueryState(instance, deferred), [instance, deferred]);
+  } = useMemo(() => {
+    const deferred = parseQueryKey(deferredQueryKey);
+    return getQueryState(instance, {
+      ...deferred,
+      source
+    });
+  }, [instance, deferredQueryKey, source]);
   if (getCurrent() === void 0) {
-    const currentSignal = ref.current.signal;
+    const currentSignal = ref.current.signal, deferred_0 = parseQueryKey(deferredQueryKey);
     throw resolveQuery(instance, {
-      ...deferred,
+      ...deferred_0,
+      source,
       signal: currentSignal
     });
   }
@@ -1320,7 +1445,7 @@ function useUsers(options) {
     loadMore
   };
 }
-var version = "2.4.0";
+var version = "2.6.0";
 function getEnv(key) {
   if (typeof import.meta < "u" && import.meta.env)
     return import.meta.env[key];
@@ -1337,10 +1462,12 @@ export {
   ResourceProvider,
   SDKProvider,
   SanityApp,
+  renderSanityApp,
   useActiveReleases,
   useAgentGenerate,
   useAgentPatch,
   useAgentPrompt,
+  useAgentResourceContext,
   useAgentTransform,
   useAgentTranslate,
   useApplyDocumentActions,