@sanity/sdk 2.0.2 → 2.1.1-canary.0

package/dist/index.d.ts

@@ -1,2647 +1,1960 @@
-import {AuthStoreState as AuthStoreState_2} from './authStore'
-import {BoundStoreAction} from '../store/createActionBinder'
-import {BoundStoreAction as BoundStoreAction_2} from '../../store/createActionBinder'
-import {CanvasResource} from '@sanity/message-protocol'
-import {ChannelInput} from '@sanity/comlink'
-import {ChannelInstance} from '@sanity/comlink'
-import {ClientConfig} from '@sanity/client'
-import {ClientPerspective} from '@sanity/client'
-import {Controller} from '@sanity/comlink'
-import {CurrentUser} from '@sanity/types'
-import {DatasetsResponse} from '@sanity/client'
-import {DocumentPermissionsResult as DocumentPermissionsResult_2} from './permissions'
-import {FetcherStoreState as FetcherStoreState_2} from '../_exports'
-import {IndexTuple} from '@sanity/types'
-import {ListenEvent} from '@sanity/client'
-import {MediaResource} from '@sanity/message-protocol'
-import {Message} from '@sanity/comlink'
-import {Mutation} from '@sanity/types'
-import {Node as Node_2} from '@sanity/comlink'
-import {NodeInput} from '@sanity/comlink'
-import {Observable} from 'rxjs'
-import {PatchMutation} from '@sanity/mutate/_unstable_store'
-import {PatchOperations} from '@sanity/types'
-import {PathSegment} from '@sanity/types'
-import {PreviewStoreState as PreviewStoreState_2} from './previewStore'
-import {ResponseQueryOptions} from '@sanity/client'
-import {Role} from '@sanity/types'
-import {SanityClient} from '@sanity/client'
-import {SanityDocument} from '@sanity/types'
-import {SanityDocument as SanityDocument_2} from 'groq'
-import {SanityDocument as SanityDocument_3} from '@sanity/client'
-import {SanityDocumentLike} from '@sanity/types'
-import {SanityProject as SanityProject_2} from '@sanity/client'
-import {SanityProjectionResult} from 'groq'
-import {SanityQueryResult} from 'groq'
-import {SanityUser as SanityUser_2} from './types'
-import {StackablePerspective} from '@sanity/client'
-import {StateSource as StateSource_2} from '../_exports'
-import {StateSource as StateSource_3} from '../../_exports'
-import {Status} from '@sanity/comlink'
-import {StudioResource} from '@sanity/message-protocol'
-import {Subject} from 'rxjs'
-import {ValuePending as ValuePending_2} from './previewStore'
-
-declare interface AccessAttributeNode extends BaseNode {
-  type: 'AccessAttribute'
-  base?: ExprNode
-  name: string
-}
-
-declare interface AccessElementNode extends BaseNode {
-  type: 'AccessElement'
-  base: ExprNode
-  index: number
-}
-
+import * as _sanity_client12 from "@sanity/client";
+import { ClientConfig, ClientPerspective, ListenEvent, ResponseQueryOptions, SanityClient, SanityDocument as SanityDocument$1, SanityProject as SanityProject$1, StackablePerspective } from "@sanity/client";
+import { Observable, Subject } from "rxjs";
+import { CurrentUser, CurrentUser as CurrentUser$1, Mutation, PatchOperations, Role, SanityDocument, SanityDocument as SanityDocument$2, SanityDocumentLike } from "@sanity/types";
+import * as _sanity_comlink3 from "@sanity/comlink";
+import { ChannelInput, ChannelInstance, Controller, Message, Node, NodeInput, Status } from "@sanity/comlink";
+import { PatchMutation } from "@sanity/mutate/_unstable_store";
+import { SanityDocument as SanityDocument$3, SanityProjectionResult, SanityQueryResult } from "groq";
+import { CanvasResource, MediaResource, StudioResource } from "@sanity/message-protocol";
+import { getIndexForKey, getPathDepth, joinPaths, jsonMatch, slicePath, stringifyPath } from "@sanity/json-match";
 /**
- * @beta
- * Event emitted when a precondition to applying an action fails.
- * (For example: when trying to edit a document that no longer exists.)
+ * Represents the various states the authentication type can be in.
+ *
+ * @public
  */
-export declare interface ActionErrorEvent {
-  type: 'error'
-  documentId: string
-  transactionId: string
-  message: string
-  error: unknown
-}
-
-declare type ActionMap = {
-  create: 'sanity.action.document.version.create'
-  discard: 'sanity.action.document.version.discard'
-  unpublish: 'sanity.action.document.unpublish'
-  delete: 'sanity.action.document.delete'
-  edit: 'sanity.action.document.edit'
-  publish: 'sanity.action.document.publish'
-}
-
-/** @beta */
-export declare interface ActionsResult<TDocument extends SanityDocument_2 = SanityDocument_2> {
-  transactionId: string
-  documents: DocumentSet<TDocument>
-  previous: DocumentSet<TDocument>
-  previousRevs: {
-    [documentId: string]: string | undefined
-  }
-  appeared: string[]
-  updated: string[]
-  disappeared: string[]
-  submitted: () => ReturnType<SanityClient['action']>
-}
-
-declare type AllowedClientConfigKey =
-  | 'useCdn'
-  | 'token'
-  | 'perspective'
-  | 'apiHost'
-  | 'proxy'
-  | 'withCredentials'
-  | 'timeout'
-  | 'maxRetries'
-  | 'dataset'
-  | 'projectId'
-  | 'requestTagPrefix'
-  | 'useProjectHostname'
-
-declare interface AndNode extends BaseNode {
-  type: 'And'
-  left: ExprNode
-  right: ExprNode
+declare enum AuthStateType {
+  LOGGED_IN = "logged-in",
+  LOGGING_IN = "logging-in",
+  ERROR = "error",
+  LOGGED_OUT = "logged-out",
 }
-
-declare type AnyStaticValue =
-  | StringValue
-  | NumberValue
-  | NullValue
-  | BooleanValue
-  | DateTimeValue
-  | ObjectValue
-  | ArrayValue
-  | PathValue
-
 /**
- * Represents a transaction that has been applied locally but has not been
- * committed/transitioned-to-outgoing. These transactions are visible to the
- * user but may be rebased upon a new working document set. Applied transactions
- * also contain the resulting `outgoingActions` that will be submitted to
- * Content Lake. These `outgoingActions` depend on the state of the working
- * documents so they are recomputed on rebase and are only relevant to applied
- * actions (we cannot compute `outgoingActions` for queued transactions because
- * we haven't resolved the set of documents the actions are dependent on yet).
- *
- * In order to support better conflict resolution, the original `previous` set
- * is saved as the `base` set.
+ * Configuration for an authentication provider
+ * @public
  */
-declare interface AppliedTransaction extends QueuedTransaction {
-  /**
-   * the resulting set of documents after the actions have been applied
-   */
-  working: DocumentSet
-  /**
-   * the previous set of documents before the action was applied
-   */
-  previous: DocumentSet
-  /**
-   * the original `previous` document set captured when this action was
-   * originally applied. this is used as a reference point to do a 3-way merge
-   * if this applied transaction ever needs to be reapplied on a different
-   * set of documents.
-   */
-  base: DocumentSet
-  /**
-   * the `_rev`s from `previous` document set
-   */
-  previousRevs: {
-    [TDocumentId in string]?: string
-  }
-  /**
-   * a timestamp for when this transaction was applied locally
-   */
-  timestamp: string
+interface AuthProvider {
   /**
-   * the resulting HTTP actions derived from the state of the `working` document
-   * set. these are sent to Content Lake as-is when this transaction is batched
-   * and transitioned into an outgoing transaction.
+   * Unique identifier for the auth provider (e.g., 'google', 'github')
    */
-  outgoingActions: HttpAction[]
+  name: string;
   /**
-   * similar to `outgoingActions` but comprised of mutations instead of action.
-   * this left here for debugging purposes but could be used to send mutations
-   * to Content Lake instead of actions.
+   * Display name for the auth provider in the UI
    */
-  outgoingMutations: Mutation[]
-}
-
-/** @beta */
-export declare function applyDocumentActions<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  instance: SanityInstance,
-  action:
-    | DocumentAction<TDocumentType, TDataset, TProjectId>
-    | DocumentAction<TDocumentType, TDataset, TProjectId>[],
-  options?: ApplyDocumentActionsOptions,
-): Promise<ActionsResult<SanityDocument_2<TDocumentType, `${TProjectId}.${TDataset}`>>>
-
-/** @beta */
-export declare function applyDocumentActions(
-  instance: SanityInstance,
-  action: DocumentAction | DocumentAction[],
-  options?: ApplyDocumentActionsOptions,
-): Promise<ActionsResult>
-
-/** @beta */
-export declare interface ApplyDocumentActionsOptions {
+  title: string;
   /**
-   * Optionally provide an ID to be used as this transaction ID
+   * Complete authentication URL including callback and token parameters
    */
-  transactionId?: string
+  url: string;
   /**
-   * Set this to true to prevent this action from being batched with others.
+   * Optional URL for direct sign-up flow
    */
-  disableBatching?: boolean
-}
-
-declare interface ArrayCoerceNode extends BaseNode {
-  type: 'ArrayCoerce'
-  base: ExprNode
-}
-
-declare interface ArrayElementNode extends BaseNode {
-  type: 'ArrayElement'
-  value: ExprNode
-  isSplat: boolean
-}
-
-declare interface ArrayNode extends BaseNode {
-  type: 'Array'
-  elements: ArrayElementNode[]
-}
-
-declare type ArrayValue = StaticValue<unknown[], 'array'>
-
-declare interface AscNode extends BaseNode {
-  type: 'Asc'
-  base: ExprNode
+  signUpUrl?: string;
 }
-
 /**
  * Configuration options for creating an auth store.
  *
  * @public
  */
-export declare interface AuthConfig {
+interface AuthConfig {
   /**
    * The initial location href to use when handling auth callbacks.
    * Defaults to the current window location if available.
    */
-  initialLocationHref?: string
+  initialLocationHref?: string;
   /**
    * Factory function to create a SanityClient instance.
    * Defaults to the standard Sanity client factory if not provided.
    */
-  clientFactory?: (config: ClientConfig) => SanityClient
+  clientFactory?: (config: ClientConfig) => SanityClient;
   /**
    * Custom authentication providers to use instead of or in addition to the default ones.
    * Can be an array of providers or a function that takes the default providers and returns
    * a modified array or a Promise resolving to one.
    */
-  providers?: AuthProvider[] | ((prev: AuthProvider[]) => AuthProvider[] | Promise<AuthProvider[]>)
+  providers?: AuthProvider[] | ((prev: AuthProvider[]) => AuthProvider[] | Promise<AuthProvider[]>);
   /**
    * The API hostname for requests. Usually leave this undefined, but it can be set
    * if using a custom domain or CNAME for the API endpoint.
    */
-  apiHost?: string
+  apiHost?: string;
   /**
    * Storage implementation to persist authentication state.
    * Defaults to `localStorage` if available.
    */
-  storageArea?: Storage
+  storageArea?: Storage;
   /**
    * A callback URL for your application.
    * If none is provided, the auth API will redirect back to the current location (`location.href`).
    * When handling callbacks, this URL's pathname is checked to ensure it matches the callback.
    */
-  callbackUrl?: string
+  callbackUrl?: string;
   /**
    * A static authentication token to use instead of handling the OAuth flow.
    * When provided, the auth store will remain in a logged-in state with this token,
    * ignoring any storage or callback handling.
    */
-  token?: string
+  token?: string;
 }
-
-declare type AuthMethodOptions = 'localstorage' | 'cookie' | undefined
-
 /**
- * Configuration for an authentication provider
+ * Represents the minimal configuration required to identify a Sanity project.
  * @public
  */
-export declare interface AuthProvider {
-  /**
-   * Unique identifier for the auth provider (e.g., 'google', 'github')
-   */
-  name: string
-  /**
-   * Display name for the auth provider in the UI
-   */
-  title: string
-  /**
-   * Complete authentication URL including callback and token parameters
-   */
-  url: string
-  /**
-   * Optional URL for direct sign-up flow
-   */
-  signUpUrl?: string
+interface ProjectHandle<TProjectId extends string = string> {
+  projectId?: TProjectId;
 }
-
 /**
- * Represents the various states the authentication can be in.
- *
  * @public
  */
-export declare type AuthState =
-  | LoggedInAuthState
-  | LoggedOutAuthState
-  | LoggingInAuthState
-  | ErrorAuthState
-
+type ReleasePerspective = {
+  releaseName: string;
+  excludedPerspectives?: StackablePerspective[];
+};
 /**
- * Represents the various states the authentication type can be in.
- *
  * @public
  */
-export declare enum AuthStateType {
-  LOGGED_IN = 'logged-in',
-  LOGGING_IN = 'logging-in',
-  ERROR = 'error',
-  LOGGED_OUT = 'logged-out',
+interface PerspectiveHandle {
+  perspective?: ClientPerspective | ReleasePerspective;
 }
-
 /**
  * @public
  */
-export declare interface AuthStoreState {
-  authState: AuthState
-  providers?: AuthProvider[]
-  options: {
-    initialLocationHref: string
-    clientFactory: (config: ClientConfig) => SanityClient
-    customProviders: AuthConfig['providers']
-    storageKey: string
-    storageArea: Storage | undefined
-    apiHost: string | undefined
-    loginUrl: string
-    callbackUrl: string | undefined
-    providedToken: string | undefined
-    authMethod: AuthMethodOptions
-  }
-  dashboardContext?: DashboardContext
+interface DatasetHandle<TDataset extends string = string, TProjectId extends string = string> extends ProjectHandle<TProjectId>, PerspectiveHandle {
+  dataset?: TDataset;
 }
-
-/** The base interface for SyntaxNode. */
-declare interface BaseNode {
-  type: string
+/**
+ * Identifies a specific document type within a Sanity dataset and project.
+ * Includes `projectId`, `dataset`, and `documentType`.
+ * Optionally includes a `documentId`, useful for referencing a specific document type context, potentially without a specific document ID.
+ * @public
+ */
+interface DocumentTypeHandle<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DatasetHandle<TDataset, TProjectId> {
+  documentId?: string;
+  documentType: TDocumentType;
 }
-
-declare type BooleanValue = StaticValue<boolean, 'boolean'>
-
 /**
- * Represents a store action that has been bound to a specific store instance
+ * Uniquely identifies a specific document within a Sanity dataset and project.
+ * Includes `projectId`, `dataset`, `documentType`, and the required `documentId`.
+ * Commonly used by document-related hooks and components to reference a document without fetching its full content initially.
+ * @public
  */
-declare type BoundStoreAction_3<_TState, TParams extends unknown[], TReturn> = (
-  instance: SanityInstance,
-  ...params: TParams
-) => TReturn
-
+interface DocumentHandle<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentTypeHandle<TDocumentType, TDataset, TProjectId> {
+  documentId: string;
+}
 /**
- * Individual channel with its relevant options
+ * Represents the complete configuration for a Sanity SDK instance
  * @public
  */
-declare interface ChannelEntry {
-  channel: ChannelInstance<FrameMessage, WindowMessage>
-  options: ChannelInput
-  refCount: number
+interface SanityConfig extends DatasetHandle, PerspectiveHandle {
+  /**
+   * Authentication configuration for the instance
+   * @remarks Merged with parent configurations when using createChild
+   */
+  auth?: AuthConfig;
+  /**
+   * Studio mode configuration for use of the SDK in a Sanity Studio
+   * @remarks Controls whether studio mode features are enabled
+   */
+  studioMode?: {
+    enabled: boolean;
+  };
 }
-
 /**
- * Options used when retrieving a client instance from the client store.
- *
- * This interface extends the base {@link ClientConfig} and adds:
- *
- * - **apiVersion:** A required string indicating the API version for the client.
- * - **scope:** An optional flag to choose between the project-specific client
- *   ('project') and the global client ('global'). When set to `'global'`, the
- *   global client is used.
- *
- * These options are utilized by `getClient` and `getClientState` to configure and
- * return appropriate client instances that automatically handle authentication
- * updates and configuration changes.
+ * Represents a Sanity.io resource instance with its own configuration and lifecycle
+ * @remarks Instances form a hierarchy through parent/child relationships
  *
  * @public
  */
-export declare interface ClientOptions extends Pick<ClientConfig, AllowedClientConfigKey> {
+interface SanityInstance {
   /**
-   * An optional flag to choose between the default client (typically project-level)
-   * and the global client ('global'). When set to `'global'`, the global client
-   * is used.
+   * Unique identifier for this instance
+   * @remarks Generated using crypto.randomUUID()
    */
-  'scope'?: 'default' | 'global'
+  readonly instanceId: string;
   /**
-   * A required string indicating the API version for the client.
+   * Resolved configuration for this instance
+   * @remarks Merges values from parent instances where appropriate
    */
-  'apiVersion': string
+  readonly config: SanityConfig;
   /**
-   * @internal
+   * Checks if the instance has been disposed
+   * @returns true if dispose() has been called
+   */
+  isDisposed(): boolean;
+  /**
+   * Disposes the instance and cleans up associated resources
+   * @remarks Triggers all registered onDispose callbacks
+   */
+  dispose(): void;
+  /**
+   * Registers a callback to be invoked when the instance is disposed
+   * @param cb - Callback to execute on disposal
+   * @returns Function to unsubscribe the callback
+   */
+  onDispose(cb: () => void): () => void;
+  /**
+   * Gets the parent instance in the hierarchy
+   * @returns Parent instance or undefined if this is the root
+   */
+  getParent(): SanityInstance | undefined;
+  /**
+   * Creates a child instance with merged configuration
+   * @param config - Configuration to merge with parent values
+   * @remarks Child instances inherit parent configuration but can override values
+   */
+  createChild(config: SanityConfig): SanityInstance;
+  /**
+   * Traverses the instance hierarchy to find the first instance whose configuration
+   * matches the given target config using a shallow comparison.
+   * @param targetConfig - A partial configuration object containing key-value pairs to match.
+   * @returns The first matching instance or undefined if no match is found.
    */
-  '~experimental_resource'?: ClientConfig['~experimental_resource']
+  match(targetConfig: Partial<SanityConfig>): SanityInstance | undefined;
 }
-
 /**
- * States tracked by the client store
+ * Creates a new Sanity resource instance
+ * @param config - Configuration for the instance (optional)
+ * @returns A configured SanityInstance
+ * @remarks When creating child instances, configurations are merged with parent values
+ *
  * @public
  */
-export declare interface ClientState {
-  token: string | null
-  clients: {
-    [TKey in string]?: SanityClient
-  }
-  authMethod?: 'localstorage' | 'cookie'
-}
-
+declare function createSanityInstance(config?: SanityConfig): SanityInstance;
 /**
- * Internal state tracking comlink connections
+ * Represents a store action that has been bound to a specific store instance
+ */
+type BoundStoreAction<_TState, TParams extends unknown[], TReturn> = (instance: SanityInstance, ...params: TParams) => TReturn;
+/**
+ * Creates an action binder function that uses the provided key function
+ * to determine how store instances are shared between Sanity instances
+ *
+ * @param keyFn - Function that generates a key from a Sanity config
+ * @returns A function that binds store actions to Sanity instances
+ *
+ * @remarks
+ * Action binders determine how store instances are shared across multiple
+ * Sanity instances. The key function determines which instances share state.
+ *
+ * @example
+ * ```ts
+ * // Create a custom binder that uses a tenant ID for isolation
+ * const bindActionByTenant = createActionBinder(config => config.tenantId || 'default')
+ *
+ * // Use the custom binder with a store definition
+ * const getTenantUsers = bindActionByTenant(
+ *   userStore,
+ *   ({state}) => state.get().users
+ * )
+ * ```
+ */
+/**
+ * Represents the various states the authentication can be in.
+ *
  * @public
  */
-export declare interface ComlinkControllerState {
-  controller: Controller | null
-  controllerOrigin: string | null
-  channels: Map<string, ChannelEntry>
-}
-
+type AuthState = LoggedInAuthState | LoggedOutAuthState | LoggingInAuthState | ErrorAuthState;
 /**
- * Internal state tracking comlink connections
+ * Logged-in state from the auth state.
  * @public
  */
-export declare interface ComlinkNodeState {
-  nodes: Map<string, NodeEntry>
-  subscriptions: Map<string, Set<symbol>>
-}
-
-declare interface Context {
-  timestamp: Date
-  identity: string
-  before: Value | null
-  after: Value | null
-  sanity?: {
-    projectId: string
-    dataset: string
-  }
-  dereference?: DereferenceFunction
-}
-
-declare interface ContextNode extends BaseNode {
-  type: 'Context'
-  key: string
-}
-
+type LoggedInAuthState = {
+  type: AuthStateType.LOGGED_IN;
+  token: string;
+  currentUser: CurrentUser$1 | null;
+};
 /**
- * This version is provided by pkg-utils at build time
- * @internal
+ * Logged-out state from the auth state.
+ * @public
  */
-export declare const CORE_SDK_VERSION: {}
-
+type LoggedOutAuthState = {
+  type: AuthStateType.LOGGED_OUT;
+  isDestroyingSession: boolean;
+};
 /**
- * Creates or validates a `DatasetHandle` object.
- * Ensures the provided object conforms to the `DatasetHandle` interface.
- * @param handle - The object containing dataset identification properties.
- * @returns The validated `DatasetHandle` object.
+ * Logging-in state from the auth state.
  * @public
  */
-export declare function createDatasetHandle<
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(handle: DatasetHandle<TDataset, TProjectId>): DatasetHandle<TDataset, TProjectId>
-
+type LoggingInAuthState = {
+  type: AuthStateType.LOGGING_IN;
+  isExchangingToken: boolean;
+};
 /**
- * Creates a `CreateDocumentAction` object.
- * @param doc - A handle identifying the document type, dataset, and project. An optional `documentId` can be provided.
- * @returns A `CreateDocumentAction` object ready for dispatch.
- * @beta
+ * Error state from the auth state.
+ * @public
  */
-export declare function createDocument<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  doc: DocumentTypeHandle<TDocumentType, TDataset, TProjectId>,
-): CreateDocumentAction<TDocumentType, TDataset, TProjectId>
-
+type ErrorAuthState = {
+  type: AuthStateType.ERROR;
+  error: unknown;
+};
 /**
- * Represents an action to create a new document.
- * Specifies the document type and optionally a document ID (which will be treated as the published ID).
- * @beta
+ * Represents the various states the authentication can be in.
+ *
+ * @public
  */
-export declare interface CreateDocumentAction<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
-> extends DocumentTypeHandle<TDocumentType, TDataset, TProjectId> {
-  type: 'document.create'
+interface DashboardContext {
+  mode?: string;
+  env?: string;
+  orgId?: string;
 }
-
+type AuthMethodOptions = 'localstorage' | 'cookie' | undefined;
 /**
- * Creates or validates a `DocumentHandle` object.
- * Ensures the provided object conforms to the `DocumentHandle` interface.
- * @param handle - The object containing document identification properties.
- * @returns The validated `DocumentHandle` object.
  * @public
  */
-export declare function createDocumentHandle<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  handle: DocumentHandle<TDocumentType, TDataset, TProjectId>,
-): DocumentHandle<TDocumentType, TDataset, TProjectId>
-
+interface AuthStoreState {
+  authState: AuthState;
+  providers?: AuthProvider[];
+  options: {
+    initialLocationHref: string;
+    clientFactory: (config: ClientConfig) => SanityClient;
+    customProviders: AuthConfig['providers'];
+    storageKey: string;
+    storageArea: Storage | undefined;
+    apiHost: string | undefined;
+    loginUrl: string;
+    callbackUrl: string | undefined;
+    providedToken: string | undefined;
+    authMethod: AuthMethodOptions;
+  };
+  dashboardContext?: DashboardContext;
+}
 /**
- * Creates or validates a `DocumentTypeHandle` object.
- * Ensures the provided object conforms to the `DocumentTypeHandle` interface.
- * @param handle - The object containing document type identification properties.
- * @returns The validated `DocumentTypeHandle` object.
  * @public
  */
-export declare function createDocumentTypeHandle<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  handle: DocumentTypeHandle<TDocumentType, TDataset, TProjectId>,
-): DocumentTypeHandle<TDocumentType, TDataset, TProjectId>
-
+declare const getCurrentUserState: BoundStoreAction<AuthStoreState, [], StateSource<CurrentUser$1 | null>>;
+/**
+ * @public
+ */
+declare const getTokenState: BoundStoreAction<AuthStoreState, [], StateSource<string | null>>;
 /**
- * Creates a GROQ search filter string (`[@] match text::query("...")`)
- * from a raw search query string.
- *
- * It applies wildcard ('*') logic to the last eligible token and escapes
- * double quotes within the search term.
- *
- * If the input query is empty or only whitespace, it returns an empty string.
- *
- * @param query - The raw input search string.
- * @returns The GROQ search filter string, or an empty string.
  * @internal
  */
-export declare function createGroqSearchFilter(query: string): string
 
 /**
- * Creates or validates a `ProjectHandle` object.
- * Ensures the provided object conforms to the `ProjectHandle` interface.
- * @param handle - The object containing project identification properties.
- * @returns The validated `ProjectHandle` object.
  * @public
  */
-export declare function createProjectHandle<TProjectId extends string = string>(
-  handle: ProjectHandle<TProjectId>,
-): ProjectHandle<TProjectId>
-
+declare const getLoginUrlState: BoundStoreAction<AuthStoreState, [], StateSource<string>>;
 /**
- * Creates a new Sanity resource instance
- * @param config - Configuration for the instance (optional)
- * @returns A configured SanityInstance
- * @remarks When creating child instances, configurations are merged with parent values
- *
  * @public
  */
-export declare function createSanityInstance(config?: SanityConfig): SanityInstance
-
-export {CurrentUser}
-
+declare const getAuthState: BoundStoreAction<AuthStoreState, [], StateSource<AuthState>>;
 /**
- * Represents the various states the authentication can be in.
- *
  * @public
  */
-declare interface DashboardContext {
-  mode?: string
-  env?: string
-  orgId?: string
-}
-
+declare const getDashboardOrganizationId: BoundStoreAction<AuthStoreState, [], StateSource<string | undefined>>;
 /**
+ * Returns a state source indicating if the SDK is running within a dashboard context.
  * @public
  */
-export declare interface DatasetHandle<
-  TDataset extends string = string,
-  TProjectId extends string = string,
-> extends ProjectHandle<TProjectId>,
-    PerspectiveHandle {
-  dataset?: TDataset
-}
-
-declare class DateTime {
-  date: Date
-  constructor(date: Date)
-  static parseToValue(str: string): Value
-  equals(other: DateTime): boolean
-  add(secs: number): DateTime
-  difference(other: DateTime): number
-  compareTo(other: DateTime): number
-  toString(): string
-  toJSON(): string
+declare const getIsInDashboardState: BoundStoreAction<AuthStoreState, [], StateSource<boolean>>;
+/**
+ * Action to explicitly set the authentication token.
+ * Used internally by the Comlink token refresh.
+ * @internal
+ */
+declare const setAuthToken: BoundStoreAction<AuthStoreState, [token: string | null], void>;
+/**
+ * Error message returned by the organization verification
+ * @public
+ */
+interface OrgVerificationResult {
+  error: string | null;
 }
-
-declare type DateTimeValue = StaticValue<DateTime, 'datetime'>
-
 /**
- * Given a type T and an array of "access keys" Parts, recursively index into T.
- *
- * If a part is a key, it looks up that property.
- * If T is an array and the part is a number, it "indexes" into the element type.
+ * Compares a project's actual organization ID with the expected organization ID.
+ * @public
  */
-declare type DeepGet<TValue, TPath extends readonly (string | number)[]> = TPath extends []
-  ? TValue
-  : TPath extends readonly [infer THead, ...infer TTail]
-    ? DeepGet<
-        TValue extends undefined | null
-          ? undefined
-          : THead extends keyof TValue
-            ? TValue[THead]
-            : THead extends number
-              ? TValue extends readonly (infer TElement)[]
-                ? TElement | undefined
-                : undefined
-              : undefined, // Key/index doesn't exist
-        TTail extends readonly (string | number)[] ? TTail : []
-      >
-    : never
-
 /**
- * Creates a `DeleteDocumentAction` object.
- * @param doc - A handle uniquely identifying the document to be deleted.
- * @returns A `DeleteDocumentAction` object ready for dispatch.
- * @beta
+ * Creates an observable that emits the organization verification state for a given instance.
+ * It combines the dashboard organization ID (from auth context) with the
+ * project's actual organization ID (fetched via getProjectState) and compares them.
+ * @public
  */
-export declare function deleteDocument<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  doc: DocumentHandle<TDocumentType, TDataset, TProjectId>,
-): DeleteDocumentAction<TDocumentType, TDataset, TProjectId>
-
+declare function observeOrganizationVerificationState(instance: SanityInstance, projectIds: string[]): Observable<OrgVerificationResult>;
 /**
- * Represents an action to delete an existing document.
- * Requires the full document handle including the document ID.
- * @beta
+ * @public
  */
-export declare interface DeleteDocumentAction<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
-> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
-  type: 'document.delete'
-}
-
-declare type DereferenceFunction = (obj: {
-  _ref: string
-}) => PromiseLike<Document_2 | null | undefined>
-
-declare interface DerefNode extends BaseNode {
-  type: 'Deref'
-  base: ExprNode
+declare const handleAuthCallback: BoundStoreAction<AuthStoreState, [locationHref?: string | undefined], Promise<string | false>>;
+/**
+ * @public
+ */
+declare const logout: BoundStoreAction<AuthStoreState, [], Promise<void>>;
+type AllowedClientConfigKey = 'useCdn' | 'token' | 'perspective' | 'apiHost' | 'proxy' | 'withCredentials' | 'timeout' | 'maxRetries' | 'dataset' | 'projectId' | 'requestTagPrefix' | 'useProjectHostname';
+/**
+ * States tracked by the client store
+ * @public
+ */
+interface ClientStoreState {
+  token: string | null;
+  clients: { [TKey in string]?: SanityClient };
+  authMethod?: 'localstorage' | 'cookie';
 }
-
-declare interface DescNode extends BaseNode {
-  type: 'Desc'
-  base: ExprNode
+/**
+ * Options used when retrieving a client instance from the client store.
+ *
+ * This interface extends the base {@link ClientConfig} and adds:
+ *
+ * - **apiVersion:** A required string indicating the API version for the client.
+ * - **scope:** An optional flag to choose between the project-specific client
+ *   ('project') and the global client ('global'). When set to `'global'`, the
+ *   global client is used.
+ *
+ * These options are utilized by `getClient` and `getClientState` to configure and
+ * return appropriate client instances that automatically handle authentication
+ * updates and configuration changes.
+ *
+ * @public
+ */
+interface ClientOptions extends Pick<ClientConfig, AllowedClientConfigKey> {
+  /**
+   * An optional flag to choose between the default client (typically project-level)
+   * and the global client ('global'). When set to `'global'`, the global client
+   * is used.
+   */
+  'scope'?: 'default' | 'global';
+  /**
+   * A required string indicating the API version for the client.
+   */
+  'apiVersion': string;
+  /**
+   * @internal
+   */
+  '~experimental_resource'?: ClientConfig['~experimental_resource'];
 }
-
 /**
- * Calls the destroy method on the controller and resets the controller state.
+ * Retrieves a Sanity client instance configured with the provided options.
+ *
+ * This function returns a client instance configured for the project or as a
+ * global client based on the options provided. It ensures efficient reuse of
+ * client instances by returning the same instance for the same options.
+ * For automatic handling of authentication token updates, consider using
+ * `getClientState`.
+ *
  * @public
  */
-export declare const destroyController: BoundStoreAction_2<ComlinkControllerState, [], void>
-
+declare const getClient: BoundStoreAction<ClientStoreState, [options: ClientOptions], SanityClient>;
 /**
- * Creates a `DiscardDocumentAction` object.
- * @param doc - A handle uniquely identifying the document whose draft changes are to be discarded.
- * @returns A `DiscardDocumentAction` object ready for dispatch.
- * @beta
+ * Returns a state source for the Sanity client instance.
+ *
+ * This function provides a subscribable state source that emits updated client
+ * instances whenever relevant configurations change (such as authentication tokens).
+ * Use this when you need to react to client configuration changes in your application.
+ *
+ * @public
  */
-export declare function discardDocument<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  doc: DocumentHandle<TDocumentType, TDataset, TProjectId>,
-): DiscardDocumentAction<TDocumentType, TDataset, TProjectId>
-
+declare const getClientState: BoundStoreAction<ClientStoreState, [options: ClientOptions], StateSource<SanityClient>>;
 /**
- * Represents an action to discard the draft changes of a document.
- * Requires the full document handle.
- * @beta
+ * Message sent from a containing app to an iframe
+ * @public
  */
-export declare interface DiscardDocumentAction<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
-> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
-  type: 'document.discard'
-}
-
-declare type Document_2 = {
-  _id?: string
-  _type?: string
-  [T: string]: unknown
-}
-
+type FrameMessage = Message;
 /**
- * Union type representing all possible document actions within the SDK.
- * @beta
+ * Message sent from an iframe to a containing app
+ * @public
  */
-export declare type DocumentAction<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
-> =
-  | CreateDocumentAction<TDocumentType, TDataset, TProjectId>
-  | DeleteDocumentAction<TDocumentType, TDataset, TProjectId>
-  | EditDocumentAction<TDocumentType, TDataset, TProjectId>
-  | PublishDocumentAction<TDocumentType, TDataset, TProjectId>
-  | UnpublishDocumentAction<TDocumentType, TDataset, TProjectId>
-  | DiscardDocumentAction<TDocumentType, TDataset, TProjectId>
-
+type WindowMessage = Message;
 /**
- * @beta
- * Event emitted when a document is created.
+ * Message from SDK (iframe) to Parent (dashboard) to request a new token
+ * @internal
  */
-export declare interface DocumentCreatedEvent {
-  type: 'created'
-  documentId: string
-  outgoing: OutgoingTransaction
-}
-
+type RequestNewTokenMessage = {
+  type: 'dashboard/v1/auth/tokens/create';
+  payload?: undefined;
+};
 /**
- * @beta
- * Event emitted when a document is deleted.
+ * Message from Parent (dashboard) to SDK (iframe) with the new token
+ * @internal
  */
-export declare interface DocumentDeletedEvent {
-  type: 'deleted'
-  documentId: string
-  outgoing: OutgoingTransaction
-}
-
+type NewTokenResponseMessage = {
+  type: 'dashboard/v1/auth/tokens/create';
+  payload: {
+    token: string | null;
+    error?: string;
+  };
+};
 /**
- * @beta
- * Event emitted when a document version is discarded.
+ * Individual channel with its relevant options
+ * @public
  */
-export declare interface DocumentDiscardedEvent {
-  type: 'discarded'
-  documentId: string
-  outgoing: OutgoingTransaction
+interface ChannelEntry {
+  channel: ChannelInstance<FrameMessage, WindowMessage>;
+  options: ChannelInput;
+  refCount: number;
 }
-
 /**
- * @beta
- * Event emitted when a document is edited.
+ * Internal state tracking comlink connections
+ * @public
  */
-export declare interface DocumentEditedEvent {
-  type: 'edited'
-  documentId: string
-  outgoing: OutgoingTransaction
+interface ComlinkControllerState {
+  controller: Controller | null;
+  controllerOrigin: string | null;
+  channels: Map<string, ChannelEntry>;
 }
-
-/** @beta */
-export declare type DocumentEvent =
-  | ActionErrorEvent
-  | TransactionRevertedEvent
-  | TransactionAcceptedEvent
-  | DocumentRebaseErrorEvent
-  | DocumentEditedEvent
-  | DocumentCreatedEvent
-  | DocumentDeletedEvent
-  | DocumentPublishedEvent
-  | DocumentUnpublishedEvent
-  | DocumentDiscardedEvent
-
 /**
- * Uniquely identifies a specific document within a Sanity dataset and project.
- * Includes `projectId`, `dataset`, `documentType`, and the required `documentId`.
- * Commonly used by document-related hooks and components to reference a document without fetching its full content initially.
+ * Calls the destroy method on the controller and resets the controller state.
  * @public
  */
-export declare interface DocumentHandle<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
-> extends DocumentTypeHandle<TDocumentType, TDataset, TProjectId> {
-  documentId: string
-}
-
+declare const destroyController: BoundStoreAction<ComlinkControllerState, [], void>;
 /**
- * @beta
- * Options for specifying a document and optionally a path within it.
+ * Retrieve or create a channel to be used for communication between
+ * an application and the controller.
+ * @public
  */
-export declare interface DocumentOptions<
-  TPath extends string | undefined = undefined,
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
-> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
-  path?: TPath
-}
-
-/** @beta */
-export declare type DocumentPermissionsResult =
-  | {
-      allowed: false
-      message: string
-      reasons: PermissionDeniedReason[]
-    }
-  | {
-      allowed: true
-      message?: undefined
-      reasons?: undefined
-    }
-
+declare const getOrCreateChannel: BoundStoreAction<ComlinkControllerState, [options: ChannelInput], ChannelInstance<_sanity_comlink3.Message, _sanity_comlink3.Message>>;
 /**
- * @beta
- * Event emitted when a document is published.
+ * Initializes or fetches a controller to handle communication
+ * between an application and iframes.
+ * @public
  */
-export declare interface DocumentPublishedEvent {
-  type: 'published'
-  documentId: string
-  outgoing: OutgoingTransaction
-}
-
+declare const getOrCreateController: BoundStoreAction<ComlinkControllerState, [targetOrigin: string], Controller>;
 /**
- * @beta
- * Event emitted when an attempt to apply local changes to a modified remote document fails.
+ * Signals to the store that the consumer has stopped using the channel
+ * @public
  */
-declare interface DocumentRebaseErrorEvent {
-  type: 'rebase-error'
-  documentId: string
-  transactionId: string
-  message: string
-  error: unknown
-}
-
+declare const releaseChannel: BoundStoreAction<ComlinkControllerState, [name: string], void>;
 /**
- * Represents a set of document that will go into `applyMutations`. Before
- * applying a mutation, it's expected that all relevant documents that the
- * mutations affect are included, including those that do not exist yet.
- * Documents that don't exist have a `null` value.
+ * Individual node with its relevant options
+ * @public
  */
-declare type DocumentSet<TDocument extends SanityDocument = SanityDocument> = {
-  [TDocumentId in string]?: TDocument | null
-}
-
-declare interface DocumentState {
-  id: string
-  /**
-   * the "remote" local copy that matches the server. represents the last known
-   * server state. this gets updated every time we confirm remote patches
-   */
-  remote?: SanityDocument_2 | null
-  /**
-   * the current ephemeral working copy that includes local optimistic changes
-   * that have not yet been confirmed by the server
-   */
-  local?: SanityDocument_2 | null
-  /**
-   * the revision that our remote document is at
-   */
-  remoteRev?: string | null
-  /**
-   * Array of subscription IDs. This document state will be deleted if there are
-   * no subscribers.
-   */
-  subscriptions: string[]
-  /**
-   * An object keyed by transaction ID of revisions sent out but that have not
-   * yet been verified yet. When an applied transaction is transitioned to an
-   * outgoing transaction, it also adds unverified revisions for each document
-   * that is part of that outgoing transaction. Transactions are submitted to
-   * the server with a locally generated transaction ID. This way we can observe
-   * when our transaction comes back through the shared listener. Each listener
-   * event that comes back contains a `previousRev`. If we see our own
-   * transaction with a different `previousRev` than expected, we can rebase our
-   * local transactions on top of this new remote.
-   */
-  unverifiedRevisions?: {
-    [TTransactionId in string]?: UnverifiedDocumentRevision
-  }
-}
-
-declare interface DocumentStoreState {
-  documentStates: {
-    [TDocumentId in string]?: DocumentState
-  }
-  queued: QueuedTransaction[]
-  applied: AppliedTransaction[]
-  outgoing?: OutgoingTransaction
-  grants?: Record<Grant, ExprNode>
-  error?: unknown
-  sharedListener: SharedListener
-  fetchDocument: (documentId: string) => Observable<SanityDocument_2 | null>
-  events: Subject<DocumentEvent>
+interface NodeEntry {
+  node: Node<WindowMessage, FrameMessage>;
+  options: NodeInput;
+  status: Status;
+  statusUnsub?: () => void;
 }
-
 /**
- * Identifies a specific document type within a Sanity dataset and project.
- * Includes `projectId`, `dataset`, and `documentType`.
- * Optionally includes a `documentId`, useful for referencing a specific document type context, potentially without a specific document ID.
+ * Internal state tracking comlink connections
  * @public
  */
-export declare interface DocumentTypeHandle<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
-> extends DatasetHandle<TDataset, TProjectId> {
-  documentId?: string
-  documentType: TDocumentType
+interface ComlinkNodeState {
+  nodes: Map<string, NodeEntry>;
+  subscriptions: Map<string, Set<symbol>>;
 }
-
 /**
- * @beta
- * Event emitted when a document is unpublished.
+ * Signals to the store that the consumer has stopped using the node
+ * @public
  */
-export declare interface DocumentUnpublishedEvent {
-  type: 'unpublished'
-  documentId: string
-  outgoing: OutgoingTransaction
-}
-
-/**
- * Creates an `EditDocumentAction` object with patches for modifying a document.
- * Accepts patches in either the standard `PatchOperations` format or as a `SanityMutatePatchMutation` from `@sanity/mutate`.
- *
- * @param doc - A handle uniquely identifying the document to be edited.
- * @param sanityMutatePatch - A patch mutation object from `@sanity/mutate`.
- * @returns An `EditDocumentAction` object ready for dispatch.
- * @beta
- */
-export declare function editDocument<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  doc: DocumentHandle<TDocumentType, TDataset, TProjectId>,
-  sanityMutatePatch: PatchMutation,
-): EditDocumentAction<TDocumentType, TDataset, TProjectId>
-
-/**
- * Creates an `EditDocumentAction` object with patches for modifying a document.
- *
- * @param doc - A handle uniquely identifying the document to be edited.
- * @param patches - A single patch operation or an array of patch operations.
- * @returns An `EditDocumentAction` object ready for dispatch.
- * @beta
- */
-export declare function editDocument<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  doc: DocumentHandle<TDocumentType, TDataset, TProjectId>,
-  patches?: PatchOperations | PatchOperations[],
-): EditDocumentAction<TDocumentType, TDataset, TProjectId>
-
-/**
- * Represents an action to edit an existing document using patches.
- * Requires the full document handle and an array of patch operations.
- * @beta
- */
-export declare interface EditDocumentAction<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
-> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
-  type: 'document.edit'
-  patches?: PatchOperations[]
-}
-
-/**
- * Error state from the auth state.
- * @public
- */
-export declare type ErrorAuthState = {
-  type: AuthStateType.ERROR
-  error: unknown
-}
-
-declare interface EverythingNode extends BaseNode {
-  type: 'Everything'
-}
-
-declare type Executor<N = ExprNode> = (node: N, scope: Scope) => Value | PromiseLike<Value>
-
-/**
- * A node which can be evaluated into a value.
- * @public
- */
-declare type ExprNode =
-  | AccessAttributeNode
-  | AccessElementNode
-  | AndNode
-  | ArrayNode
-  | ArrayCoerceNode
-  | AscNode
-  | ContextNode
-  | DerefNode
-  | DescNode
-  | EverythingNode
-  | FilterNode
-  | FlatMapNode
-  | FuncCallNode
-  | GroupNode
-  | InRangeNode
-  | MapNode
-  | NegNode
-  | NotNode
-  | ObjectNode
-  | OpCallNode
-  | OrNode
-  | ParameterNode
-  | ParentNode_2
-  | PipeFuncCallNode
-  | PosNode
-  | ProjectionNode
-  | SelectNode
-  | SelectorNode
-  | SliceNode
-  | ThisNode
-  | TupleNode
-  | ValueNode
-
+declare const releaseNode: BoundStoreAction<ComlinkNodeState, [name: string], void>;
 /**
+ * Retrieve or create a node to be used for communication between
+ * an application and the controller -- specifically, a node should
+ * be created within a frame / window to communicate with the controller.
  * @public
  */
-declare interface FavoriteDocumentContext extends DocumentHandle {
-  resourceId: string
-  resourceType: StudioResource['type'] | MediaResource['type'] | CanvasResource['type']
-  schemaName?: string
-}
-
+declare const getOrCreateNode: BoundStoreAction<ComlinkNodeState, [options: NodeInput], Node<_sanity_comlink3.Message, _sanity_comlink3.Message>>;
 /**
  * @public
  */
-export declare interface FavoriteStatusResponse {
-  isFavorited: boolean
+interface NodeState {
+  node: Node<WindowMessage, FrameMessage>;
+  status: Status | undefined;
 }
-
 /**
- * Internal helper type
- * @public
- */
-export declare interface FetcherStore<TParams extends unknown[], TData> {
-  getState: BoundStoreAction_3<
-    FetcherStoreState<TParams, TData>,
-    TParams,
-    StateSource<TData | undefined>
-  >
-  resolveState: BoundStoreAction_3<FetcherStoreState<TParams, TData>, TParams, Promise<TData>>
-}
+ * Provides a subscribable state source for a node by name
+ * @param instance - The Sanity instance to get the node state for
+ * @param nodeInput - The configuration for the node to get the state for
 
-/**
- * Internal helper type
+ * @returns A subscribable state source for the node
  * @public
  */
-export declare interface FetcherStoreState<TParams extends unknown[], TData> {
-  stateByParams: {
-    [TSerializedKey in string]?: StoreEntry<TParams, TData>
-  }
-  error?: unknown
-}
-
-declare interface FilterNode extends BaseNode {
-  type: 'Filter'
-  base: ExprNode
-  expr: ExprNode
-}
-
-declare interface FlatMapNode extends BaseNode {
-  type: 'FlatMap'
-  base: ExprNode
-  expr: ExprNode
-}
-
+declare const getNodeState: BoundStoreAction<ComlinkNodeState, [NodeInput], StateSource<NodeState | undefined>>;
 /**
- * Message sent from a containing app to an iframe
+ * Creates or validates a `DocumentHandle` object.
+ * Ensures the provided object conforms to the `DocumentHandle` interface.
+ * @param handle - The object containing document identification properties.
+ * @returns The validated `DocumentHandle` object.
  * @public
  */
-export declare type FrameMessage = Message
-
-declare interface FuncCallNode extends BaseNode {
-  type: 'FuncCall'
-  func: GroqFunction
-  namespace: string
-  name: string
-  args: ExprNode[]
-}
-
-/**
- * Get the active releases from the store.
- * @internal
- */
-export declare const getActiveReleasesState: BoundStoreAction<
-  ReleasesStoreState,
-  [],
-  StateSource_2<ReleaseDocument[] | undefined>
->
-
+declare function createDocumentHandle<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(handle: DocumentHandle<TDocumentType, TDataset, TProjectId>): DocumentHandle<TDocumentType, TDataset, TProjectId>;
 /**
+ * Creates or validates a `DocumentTypeHandle` object.
+ * Ensures the provided object conforms to the `DocumentTypeHandle` interface.
+ * @param handle - The object containing document type identification properties.
+ * @returns The validated `DocumentTypeHandle` object.
  * @public
  */
-export declare const getAuthState: BoundStoreAction<AuthStoreState, [], StateSource_2<AuthState>>
-
+declare function createDocumentTypeHandle<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(handle: DocumentTypeHandle<TDocumentType, TDataset, TProjectId>): DocumentTypeHandle<TDocumentType, TDataset, TProjectId>;
 /**
- * Retrieves a Sanity client instance configured with the provided options.
- *
- * This function returns a client instance configured for the project or as a
- * global client based on the options provided. It ensures efficient reuse of
- * client instances by returning the same instance for the same options.
- * For automatic handling of authentication token updates, consider using
- * `getClientState`.
- *
+ * Creates or validates a `ProjectHandle` object.
+ * Ensures the provided object conforms to the `ProjectHandle` interface.
+ * @param handle - The object containing project identification properties.
+ * @returns The validated `ProjectHandle` object.
  * @public
  */
-export declare const getClient: BoundStoreAction<
-  ClientState,
-  [options: ClientOptions],
-  SanityClient
->
-
+declare function createProjectHandle<TProjectId extends string = string>(handle: ProjectHandle<TProjectId>): ProjectHandle<TProjectId>;
 /**
- * Returns a state source for the Sanity client instance.
- *
- * This function provides a subscribable state source that emits updated client
- * instances whenever relevant configurations change (such as authentication tokens).
- * Use this when you need to react to client configuration changes in your application.
- *
+ * Creates or validates a `DatasetHandle` object.
+ * Ensures the provided object conforms to the `DatasetHandle` interface.
+ * @param handle - The object containing dataset identification properties.
+ * @returns The validated `DatasetHandle` object.
  * @public
  */
-export declare const getClientState: BoundStoreAction<
-  ClientState,
-  [options: ClientOptions],
-  StateSource_2<SanityClient>
->
-
+declare function createDatasetHandle<TDataset extends string = string, TProjectId extends string = string>(handle: DatasetHandle<TDataset, TProjectId>): DatasetHandle<TDataset, TProjectId>;
+/** @public */
+declare const getDatasetsState: BoundStoreAction<FetcherStoreState<[options?: ProjectHandle<string> | undefined], _sanity_client12.DatasetsResponse>, [options?: ProjectHandle<string> | undefined], StateSource<_sanity_client12.DatasetsResponse | undefined>>;
+/** @public */
+declare const resolveDatasets: BoundStoreAction<FetcherStoreState<[options?: ProjectHandle<string> | undefined], _sanity_client12.DatasetsResponse>, [options?: ProjectHandle<string> | undefined], Promise<_sanity_client12.DatasetsResponse>>;
 /**
- * @public
+ * Represents an action to create a new document.
+ * Specifies the document type and optionally a document ID (which will be treated as the published ID).
+ * @beta
  */
-export declare const getCurrentUserState: BoundStoreAction<
-  AuthStoreState,
-  [],
-  StateSource_2<CurrentUser | null>
->
-
+interface CreateDocumentAction<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentTypeHandle<TDocumentType, TDataset, TProjectId> {
+  type: 'document.create';
+}
 /**
- * @public
+ * Represents an action to delete an existing document.
+ * Requires the full document handle including the document ID.
+ * @beta
  */
-export declare const getDashboardOrganizationId: BoundStoreAction<
-  AuthStoreState,
-  [],
-  StateSource_2<string | undefined>
->
-
-/** @public */
-export declare const getDatasetsState: BoundStoreAction<
-  FetcherStoreState_2<[options?: ProjectHandle<string> | undefined], DatasetsResponse>,
-  [options?: ProjectHandle<string> | undefined],
-  StateSource_2<DatasetsResponse | undefined>
->
-
-/** @beta */
-export declare function getDocumentState<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  instance: SanityInstance,
-  options: DocumentOptions<undefined, TDocumentType, TDataset, TProjectId>,
-): StateSource<SanityDocument_2<TDocumentType, `${TProjectId}.${TDataset}`> | undefined | null>
-
-/** @beta */
-export declare function getDocumentState<
-  TPath extends string = string,
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  instance: SanityInstance,
-  options: DocumentOptions<TPath, TDocumentType, TDataset, TProjectId>,
-): StateSource<
-  JsonMatch<SanityDocument_2<TDocumentType, `${TProjectId}.${TDataset}`>, TPath> | undefined
->
-
-/** @beta */
-export declare function getDocumentState<TData>(
-  instance: SanityInstance,
-  options: DocumentOptions<string | undefined>,
-): StateSource<TData | undefined | null>
-
-/** @beta */
-export declare const getDocumentSyncStatus: BoundStoreAction<
-  DocumentStoreState,
-  [doc: DocumentHandle<string, string, string>],
-  StateSource<boolean | undefined>
->
-
+interface DeleteDocumentAction<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
+  type: 'document.delete';
+}
 /**
- * Gets a StateSource for the favorite status of a document.
- * @param instance - The Sanity instance.
- * @param context - The document context including ID, type, and resource information.
- * @returns A StateSource emitting `{ isFavorited: boolean }`.
- * @public
+ * Represents an action to edit an existing document using patches.
+ * Requires the full document handle and an array of patch operations.
+ * @beta
  */
-export declare const getFavoritesState: BoundStoreAction<
-  FetcherStoreState_2<[FavoriteDocumentContext], FavoriteStatusResponse>,
-  [FavoriteDocumentContext],
-  StateSource_2<FavoriteStatusResponse | undefined>
->
-
+interface EditDocumentAction<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
+  type: 'document.edit';
+  patches?: PatchOperations[];
+}
 /**
- * Returns a state source indicating if the SDK is running within a dashboard context.
- * @public
+ * Represents an action to publish the draft version of a document.
+ * Requires the full document handle.
+ * @beta
  */
-export declare const getIsInDashboardState: BoundStoreAction<
-  AuthStoreState,
-  [],
-  StateSource_2<boolean>
->
-
+interface PublishDocumentAction<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
+  type: 'document.publish';
+}
 /**
- * @public
+ * Represents an action to unpublish a document, moving its published content to a draft.
+ * Requires the full document handle.
+ * @beta
  */
-export declare const getLoginUrlState: BoundStoreAction<AuthStoreState, [], StateSource_2<string>>
-
+interface UnpublishDocumentAction<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
+  type: 'document.unpublish';
+}
 /**
- * Provides a subscribable state source for a node by name
- * @param instance - The Sanity instance to get the node state for
- * @param nodeInput - The configuration for the node to get the state for
-
- * @returns A subscribable state source for the node
- * @public
+ * Represents an action to discard the draft changes of a document.
+ * Requires the full document handle.
+ * @beta
  */
-export declare const getNodeState: BoundStoreAction_2<
-  ComlinkNodeState,
-  [NodeInput],
-  StateSource_3<NodeState | undefined>
->
-
+interface DiscardDocumentAction<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
+  type: 'document.discard';
+}
 /**
- * Retrieve or create a channel to be used for communication between
- * an application and the controller.
- * @public
+ * Union type representing all possible document actions within the SDK.
+ * @beta
  */
-export declare const getOrCreateChannel: BoundStoreAction_2<
-  ComlinkControllerState,
-  [options: ChannelInput],
-  ChannelInstance<Message, Message>
->
-
+type DocumentAction<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> = CreateDocumentAction<TDocumentType, TDataset, TProjectId> | DeleteDocumentAction<TDocumentType, TDataset, TProjectId> | EditDocumentAction<TDocumentType, TDataset, TProjectId> | PublishDocumentAction<TDocumentType, TDataset, TProjectId> | UnpublishDocumentAction<TDocumentType, TDataset, TProjectId> | DiscardDocumentAction<TDocumentType, TDataset, TProjectId>;
 /**
- * Initializes or fetches a controller to handle communication
- * between an application and iframes.
- * @public
+ * Creates a `CreateDocumentAction` object.
+ * @param doc - A handle identifying the document type, dataset, and project. An optional `documentId` can be provided.
+ * @returns A `CreateDocumentAction` object ready for dispatch.
+ * @beta
  */
-export declare const getOrCreateController: BoundStoreAction_2<
-  ComlinkControllerState,
-  [targetOrigin: string],
-  Controller
->
-
+declare function createDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentTypeHandle<TDocumentType, TDataset, TProjectId>): CreateDocumentAction<TDocumentType, TDataset, TProjectId>;
 /**
- * Retrieve or create a node to be used for communication between
- * an application and the controller -- specifically, a node should
- * be created within a frame / window to communicate with the controller.
- * @public
+ * Creates a `DeleteDocumentAction` object.
+ * @param doc - A handle uniquely identifying the document to be deleted.
+ * @returns A `DeleteDocumentAction` object ready for dispatch.
+ * @beta
  */
-export declare const getOrCreateNode: BoundStoreAction_2<
-  ComlinkNodeState,
-  [options: NodeInput],
-  Node_2<Message, Message>
->
-
-/** @beta */
-export declare const getPermissionsState: BoundStoreAction<
-  DocumentStoreState,
-  [DocumentAction | DocumentAction[]],
-  StateSource<DocumentPermissionsResult_2 | undefined>
->
-
+declare function deleteDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentHandle<TDocumentType, TDataset, TProjectId>): DeleteDocumentAction<TDocumentType, TDataset, TProjectId>;
 /**
- * Provides a subscribable state source for a "perspective" for the Sanity client,
- * which is used to fetch documents as though certain Content Releases are active.
- *
- * @param instance - The Sanity instance to get the perspective for
- * @param options - The options for the perspective -- usually a release name
- *
- * @returns A subscribable perspective value, usually a list of applicable release names,
- * or a single release name / default perspective (such as 'drafts').
+ * Creates an `EditDocumentAction` object with patches for modifying a document.
+ * Accepts patches in either the standard `PatchOperations` format or as a `SanityMutatePatchMutation` from `@sanity/mutate`.
  *
- * @public
- */
-export declare const getPerspectiveState: BoundStoreAction<
-  ReleasesStoreState,
-  [options?: PerspectiveHandle | undefined],
-  StateSource_2<string[] | 'published' | 'drafts' | 'previewDrafts' | 'raw' | undefined>
->
-
-/**
+ * @param doc - A handle uniquely identifying the document to be edited.
+ * @param sanityMutatePatch - A patch mutation object from `@sanity/mutate`.
+ * @returns An `EditDocumentAction` object ready for dispatch.
  * @beta
  */
-export declare function getPreviewState<TResult extends object>(
-  instance: SanityInstance,
-  options: GetPreviewStateOptions,
-): StateSource<ValuePending<TResult>>
-
+declare function editDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentHandle<TDocumentType, TDataset, TProjectId>, sanityMutatePatch: PatchMutation): EditDocumentAction<TDocumentType, TDataset, TProjectId>;
 /**
+ * Creates an `EditDocumentAction` object with patches for modifying a document.
+ *
+ * @param doc - A handle uniquely identifying the document to be edited.
+ * @param patches - A single patch operation or an array of patch operations.
+ * @returns An `EditDocumentAction` object ready for dispatch.
  * @beta
  */
-export declare function getPreviewState(
-  instance: SanityInstance,
-  options: GetPreviewStateOptions,
-): StateSource<ValuePending<PreviewValue>>
-
+declare function editDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentHandle<TDocumentType, TDataset, TProjectId>, patches?: PatchOperations | PatchOperations[]): EditDocumentAction<TDocumentType, TDataset, TProjectId>;
 /**
+ * Creates a `PublishDocumentAction` object.
+ * @param doc - A handle uniquely identifying the document to be published.
+ * @returns A `PublishDocumentAction` object ready for dispatch.
  * @beta
  */
-export declare type GetPreviewStateOptions = DocumentHandle
-
+declare function publishDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentHandle<TDocumentType, TDataset, TProjectId>): PublishDocumentAction<TDocumentType, TDataset, TProjectId>;
 /**
+ * Creates an `UnpublishDocumentAction` object.
+ * @param doc - A handle uniquely identifying the document to be unpublished.
+ * @returns An `UnpublishDocumentAction` object ready for dispatch.
  * @beta
  */
-export declare function getProjectionState<
-  TProjection extends ValidProjection = ValidProjection,
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  instance: SanityInstance,
-  options: ProjectionOptions<TProjection, TDocumentType, TDataset, TProjectId>,
-): StateSource<
-  | ProjectionValuePending<
-      SanityProjectionResult<TProjection, TDocumentType, `${TProjectId}.${TDataset}`>
-    >
-  | undefined
->
-
+declare function unpublishDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentHandle<TDocumentType, TDataset, TProjectId>): UnpublishDocumentAction<TDocumentType, TDataset, TProjectId>;
 /**
+ * Creates a `DiscardDocumentAction` object.
+ * @param doc - A handle uniquely identifying the document whose draft changes are to be discarded.
+ * @returns A `DiscardDocumentAction` object ready for dispatch.
  * @beta
  */
-export declare function getProjectionState<TData extends object>(
-  instance: SanityInstance,
-  options: ProjectionOptions,
-): StateSource<ProjectionValuePending<TData> | undefined>
-
+declare function discardDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(doc: DocumentHandle<TDocumentType, TDataset, TProjectId>): DiscardDocumentAction<TDocumentType, TDataset, TProjectId>;
 /**
- * @beta
+ * Represents a set of document that will go into `applyMutations`. Before
+ * applying a mutation, it's expected that all relevant documents that the
+ * mutations affect are included, including those that do not exist yet.
+ * Documents that don't exist have a `null` value.
  */
-export declare function getProjectionState(
-  instance: SanityInstance,
-  options: ProjectionOptions,
-): StateSource<ProjectionValuePending<Record<string, unknown>> | undefined>
-
-/** @public */
-export declare const getProjectsState: BoundStoreAction<
-  FetcherStoreState_2<[], Omit<SanityProject_2, 'members'>[]>,
-  [],
-  StateSource_2<Omit<SanityProject_2, 'members'>[] | undefined>
->
-
-/** @public */
-export declare const getProjectState: BoundStoreAction<
-  FetcherStoreState_2<[options?: ProjectHandle<string> | undefined], SanityProject_2>,
-  [options?: ProjectHandle<string> | undefined],
-  StateSource_2<SanityProject_2 | undefined>
->
-
-/** @beta */
-export declare const getQueryKey: (options: QueryOptions) => string
-
+type DocumentSet<TDocument extends SanityDocument$2 = SanityDocument$2> = { [TDocumentId in string]?: TDocument | null };
 /**
- * Returns the state source for a query.
+ * Implements ID generation:
  *
- * This function returns a state source that represents the current result of a GROQ query.
- * Subscribing to the state source will instruct the SDK to fetch the query (if not already fetched)
- * and will keep the query live using the Live content API (considering sync tags) to provide up-to-date results.
- * When the last subscriber is removed, the query state is automatically cleaned up from the store.
+ * A create mutation creates a new document. It takes the literal document
+ * content as its argument. The rules for the new document's identifier are as
+ * follows:
  *
- * Note: This functionality is for advanced users who want to build their own framework integrations.
- * Our SDK also provides a React integration (useQuery hook) for convenient usage.
- *
- * Note: Automatic cleanup can interfere with React Suspense because if a component suspends while being the only subscriber,
- * cleanup might occur unexpectedly. In such cases, consider using `resolveQuery` instead.
+ * - If the `_id` attribute is missing, then a new, random, unique ID is
+ *   generated.
+ * - If the `_id` attribute is present but ends with `.`, then it is used as a
+ *   prefix for a new, random, unique ID.
+ * - If the _id attribute is present, it is used as-is.
  *
- * @beta
+ * [- source](https://www.sanity.io/docs/http-mutations#c732f27330a4)
  */
-export declare function getQueryState<
-  TQuery extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  instance: SanityInstance,
-  queryOptions: QueryOptions<TQuery, TDataset, TProjectId>,
-): StateSource<SanityQueryResult<TQuery, `${TProjectId}.${TDataset}`> | undefined>
-
 /** @beta */
-export declare function getQueryState<TData>(
-  instance: SanityInstance,
-  queryOptions: QueryOptions,
-): StateSource<TData | undefined>
-
+interface ActionsResult<TDocument extends SanityDocument$3 = SanityDocument$3> {
+  transactionId: string;
+  documents: DocumentSet<TDocument>;
+  previous: DocumentSet<TDocument>;
+  previousRevs: {
+    [documentId: string]: string | undefined;
+  };
+  appeared: string[];
+  updated: string[];
+  disappeared: string[];
+  submitted: () => ReturnType<SanityClient['action']>;
+}
 /** @beta */
-export declare function getQueryState(
-  instance: SanityInstance,
-  queryOptions: QueryOptions,
-): StateSource<unknown>
-
-/**
- * @public
- */
-export declare const getTokenState: BoundStoreAction<
-  AuthStoreState,
-  [],
-  StateSource_2<string | null>
->
-
-/** @internal */
-export declare const getUsersKey: (
-  instance: SanityInstance,
-  {resourceType, organizationId, batchSize, projectId}?: GetUsersOptions,
-) => string
-
-/**
- * @public
- */
-export declare interface GetUsersOptions extends ProjectHandle {
-  resourceType?: 'organization' | 'project'
-  batchSize?: number
-  organizationId?: string
+interface ApplyDocumentActionsOptions {
+  /**
+   * Optionally provide an ID to be used as this transaction ID
+   */
+  transactionId?: string;
+  /**
+   * Set this to true to prevent this action from being batched with others.
+   */
+  disableBatching?: boolean;
 }
-
-/**
- * Returns the state source for users associated with a specific resource.
- *
- * This function returns a state source that represents the current list of users for a given
- * resource. Subscribing to the state source will instruct the SDK to fetch the users (if not
- * already fetched) and will load more from this state source as well. When the last subscriber is
- * removed, the users state is automatically cleaned up from the store after a delay.
- *
- * Note: This functionality is for advanced users who want to build their own framework
- * integrations. Our SDK also provides a React integration for convenient usage.
- *
- * @beta
- */
-export declare const getUsersState: BoundStoreAction<
-  UsersStoreState,
-  [options?: GetUsersOptions | undefined],
-  StateSource_2<
-    | {
-        data: SanityUser_2[]
-        totalCount: number
-        hasMore: boolean
-      }
-    | undefined
-  >
->
-
-declare type Grant = 'read' | 'update' | 'create' | 'history'
-
-/** @public */
-declare type GroqFunction = (
-  args: GroqFunctionArg[],
-  scope: Scope,
-  execute: Executor,
-) => PromiseLike<Value>
-
-/** @public */
-declare type GroqFunctionArg = ExprNode
-
-declare type GroqPipeFunction = (
-  base: Value,
-  args: ExprNode[],
-  scope: Scope,
-  execute: Executor,
-) => PromiseLike<Value>
-
-/**
- * A type of a value in GROQ.
- */
-declare type GroqType =
-  | 'null'
-  | 'boolean'
-  | 'number'
-  | 'string'
-  | 'array'
-  | 'object'
-  | 'path'
-  | 'datetime'
-
-declare interface GroupNode extends BaseNode {
-  type: 'Group'
-  base: ExprNode
+/** @beta */
+declare function applyDocumentActions<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(instance: SanityInstance, action: DocumentAction<TDocumentType, TDataset, TProjectId> | DocumentAction<TDocumentType, TDataset, TProjectId>[], options?: ApplyDocumentActionsOptions): Promise<ActionsResult<SanityDocument$3<TDocumentType, `${TProjectId}.${TDataset}`>>>;
+/** @beta */
+declare function applyDocumentActions(instance: SanityInstance, action: DocumentAction | DocumentAction[], options?: ApplyDocumentActionsOptions): Promise<ActionsResult>;
+declare interface AccessAttributeNode extends BaseNode {
+  type: 'AccessAttribute';
+  base?: ExprNode;
+  name: string;
+}
+declare interface AccessElementNode extends BaseNode {
+  type: 'AccessElement';
+  base: ExprNode;
+  index: number;
+}
+declare interface AndNode extends BaseNode {
+  type: 'And';
+  left: ExprNode;
+  right: ExprNode;
+}
+declare type AnyStaticValue = StringValue | NumberValue | NullValue | BooleanValue | DateTimeValue | ObjectValue | ArrayValue | PathValue;
+declare interface ArrayCoerceNode extends BaseNode {
+  type: 'ArrayCoerce';
+  base: ExprNode;
+}
+declare interface ArrayElementNode extends BaseNode {
+  type: 'ArrayElement';
+  value: ExprNode;
+  isSplat: boolean;
+}
+declare interface ArrayNode extends BaseNode {
+  type: 'Array';
+  elements: ArrayElementNode[];
 }
 
-/**
- * @public
- */
-export declare const handleAuthCallback: BoundStoreAction<
-  AuthStoreState,
-  [locationHref?: string | undefined],
-  Promise<string | false>
->
-
-declare type HttpAction =
-  | {
-      actionType: ActionMap['create']
-      publishedId: string
-      attributes: SanityDocumentLike
-    }
-  | {
-      actionType: ActionMap['discard']
-      versionId: string
-      purge?: boolean
-    }
-  | {
-      actionType: ActionMap['unpublish']
-      draftId: string
-      publishedId: string
-    }
-  | {
-      actionType: ActionMap['delete']
-      publishedId: string
-      includeDrafts?: string[]
-    }
-  | {
-      actionType: ActionMap['edit']
-      draftId: string
-      publishedId: string
-      patch: PatchOperations
-    }
-  | ({
-      actionType: ActionMap['publish']
-      draftId: string
-      publishedId: string
-    } & OptimisticLock)
+/** Describes a type node for array values. */
 
-declare interface InRangeNode extends BaseNode {
-  type: 'InRange'
-  base: ExprNode
-  left: ExprNode
-  right: ExprNode
-  isInclusive: boolean
+declare type ArrayValue = StaticValue<unknown[], 'array'>;
+declare interface AscNode extends BaseNode {
+  type: 'Asc';
+  base: ExprNode;
 }
 
-/**
- * Given a document type TDocument and a JSON Match path string TPath,
- * compute the type found at that path.
- * @beta
- */
-export declare type JsonMatch<TDocument, TPath extends string> = DeepGet<
-  TDocument,
-  PathParts<TPath>
->
+/** The base interface for SyntaxNode. */
+declare interface BaseNode {
+  type: string;
+}
 
-/**
- * A very simplified implementation of [JSONMatch][0] that only supports:
- * - descent e.g. `friend.name`
- * - array index e.g. `items[-1]`
- * - array matching with `_key` e.g. `items[_key=="dd9efe09"]`
- * - array matching with a range e.g. `items[4:]`
- *
- * E.g. `friends[_key=="dd9efe09"].address.zip`
- *
- * [0]: https://www.sanity.io/docs/json-match
- *
- * @beta
- */
-export declare function jsonMatch<TDocument, TPath extends string>(
-  input: TDocument,
-  path: TPath,
-): MatchEntry<JsonMatch<TDocument, TPath>>[]
+/** Describes a type node for boolean values, optionally including a value. If a value is provided it will always be the given boolean value. */
 
-/** @beta */
-export declare function jsonMatch<TValue>(input: unknown, path: string): MatchEntry<TValue>[]
+declare type BooleanValue = StaticValue<boolean, 'boolean'>;
+declare interface Context {
+  timestamp: Date;
+  identity: string;
+  before: Value | null;
+  after: Value | null;
+  sanity?: {
+    projectId: string;
+    dataset: string;
+  };
+  dereference?: DereferenceFunction;
+}
+declare interface ContextNode extends BaseNode {
+  type: 'Context';
+  key: string;
+}
 
 /**
- * Loads more users for a specific resource.
- *
- * This function triggers a request to fetch the next page of users for a given resource. It
- * requires that users have already been loaded for the resource (via `resolveUsers` or
- * `getUsersState`), and that there are more users available to load (as indicated by the `hasMore`
- * property).
- *
- * The function returns a promise that resolves when the next page of users has been loaded.
- *
- * @beta
+ * createReferenceTypeNode creates a ObjectTypeNode representing a reference type
+ * it adds required attributes for a reference type.
+ * @param name - The name of the reference type
+ * @param inArray - Whether the reference is in an array
+ * @returns A ObjectTypeNode representing a reference type
+ * @internal
  */
-export declare const loadMoreUsers: BoundStoreAction<
-  UsersStoreState,
-  [options?: GetUsersOptions | undefined],
-  Promise<{
-    data: SanityUser_2[]
-    totalCount: number
-    hasMore: boolean
-  }>
->
 
-/**
- * Logged-in state from the auth state.
- * @public
- */
-export declare type LoggedInAuthState = {
-  type: AuthStateType.LOGGED_IN
-  token: string
-  currentUser: CurrentUser | null
+declare class DateTime {
+  date: Date;
+  constructor(date: Date);
+  static parseToValue(str: string): Value;
+  equals(other: DateTime): boolean;
+  add(secs: number): DateTime;
+  difference(other: DateTime): number;
+  compareTo(other: DateTime): number;
+  toString(): string;
+  toJSON(): string;
+}
+declare type DateTimeValue = StaticValue<DateTime, 'datetime'>;
+declare type DereferenceFunction = (obj: {
+  _ref: string;
+}) => PromiseLike<Document_2 | null | undefined>;
+declare interface DerefNode extends BaseNode {
+  type: 'Deref';
+  base: ExprNode;
 }
-
-/**
- * Logged-out state from the auth state.
- * @public
- */
-export declare type LoggedOutAuthState = {
-  type: AuthStateType.LOGGED_OUT
-  isDestroyingSession: boolean
+declare interface DescNode extends BaseNode {
+  type: 'Desc';
+  base: ExprNode;
 }
-
-/**
- * Logging-in state from the auth state.
- * @public
- */
-export declare type LoggingInAuthState = {
-  type: AuthStateType.LOGGING_IN
-  isExchangingToken: boolean
+declare type Document_2 = {
+  _id?: string;
+  _type?: string;
+  [T: string]: unknown;
+};
+declare interface EverythingNode extends BaseNode {
+  type: 'Everything';
 }
+declare type Executor<N = ExprNode> = (node: N, scope: Scope) => Value | PromiseLike<Value>;
 
 /**
+ * A node which can be evaluated into a value.
  * @public
  */
-export declare const logout: BoundStoreAction<AuthStoreState_2, [], Promise<void>>
-
-declare interface MapNode extends BaseNode {
-  type: 'Map'
-  base: ExprNode
-  expr: ExprNode
+declare type ExprNode = AccessAttributeNode | AccessElementNode | AndNode | ArrayNode | ArrayCoerceNode | AscNode | ContextNode | DerefNode | DescNode | EverythingNode | FilterNode | FlatMapNode | FuncCallNode | GroupNode | InRangeNode | MapNode | NegNode | NotNode | ObjectNode | OpCallNode | OrNode | ParameterNode | ParentNode_2 | PipeFuncCallNode | PosNode | ProjectionNode | SelectNode | SelectorNode | SliceNode | ThisNode | TupleNode | ValueNode;
+declare interface FilterNode extends BaseNode {
+  type: 'Filter';
+  base: ExprNode;
+  expr: ExprNode;
 }
-
-declare type MatchEntry<T = unknown> = {
-  value: T
-  path: SingleValuePath
+declare interface FlatMapNode extends BaseNode {
+  type: 'FlatMap';
+  base: ExprNode;
+  expr: ExprNode;
 }
-
-/**
- * @public
- */
-export declare interface Membership {
-  addedAt?: string
-  resourceType: string
-  resourceId: string
-  roleNames: Array<string>
-  lastSeenAt?: string | null
+declare interface FuncCallNode extends BaseNode {
+  type: 'FuncCall';
+  func: GroqFunction;
+  namespace: string;
+  name: string;
+  args: ExprNode[];
 }
 
-declare interface NegNode extends BaseNode {
-  type: 'Neg'
-  base: ExprNode
-}
+/** @public */
+declare type GroqFunction = (args: GroqFunctionArg[], scope: Scope, execute: Executor) => PromiseLike<Value>;
 
-/**
- * Message from Parent (dashboard) to SDK (iframe) with the new token
- * @internal
- */
-export declare type NewTokenResponseMessage = {
-  type: 'dashboard/v1/auth/tokens/create'
-  payload: {
-    token: string | null
-    error?: string
-  }
-}
+/** @public */
+declare type GroqFunctionArg = ExprNode;
+declare type GroqPipeFunction = (base: Value, args: ExprNode[], scope: Scope, execute: Executor) => PromiseLike<Value>;
 
 /**
- * Individual node with its relevant options
- * @public
+ * A type of a value in GROQ.
  */
-declare interface NodeEntry {
-  node: Node_2<WindowMessage, FrameMessage>
-  options: NodeInput
-  status: Status
-  statusUnsub?: () => void
+declare type GroqType = 'null' | 'boolean' | 'number' | 'string' | 'array' | 'object' | 'path' | 'datetime';
+declare interface GroupNode extends BaseNode {
+  type: 'Group';
+  base: ExprNode;
 }
 
-/**
- * @public
- */
-export declare interface NodeState {
-  node: Node_2<WindowMessage, FrameMessage>
-  status: Status | undefined
-}
+/** Describes a type node for inline values, including a name that references another type. */
 
+declare interface InRangeNode extends BaseNode {
+  type: 'InRange';
+  base: ExprNode;
+  left: ExprNode;
+  right: ExprNode;
+  isInclusive: boolean;
+}
+declare interface MapNode extends BaseNode {
+  type: 'Map';
+  base: ExprNode;
+  expr: ExprNode;
+}
+declare interface NegNode extends BaseNode {
+  type: 'Neg';
+  base: ExprNode;
+}
 declare interface NotNode extends BaseNode {
-  type: 'Not'
-  base: ExprNode
+  type: 'Not';
+  base: ExprNode;
 }
 
-declare type NullValue = StaticValue<null, 'null'>
+/** Describes a type node for null values, always being the null value. */
+
+declare type NullValue = StaticValue<null, 'null'>;
 
-declare type NumberValue = StaticValue<number, 'number'>
+/** Describes a type node for number values, optionally including a value. If a value is provided it will always be the given numeric value.*/
 
-declare type ObjectAttributeNode =
-  | ObjectAttributeValueNode
-  | ObjectConditionalSplatNode
-  | ObjectSplatNode
+declare type NumberValue = StaticValue<number, 'number'>;
 
+/** Describes a type node for object attributes, including a type and an optional flag for being optional. */
+
+declare type ObjectAttributeNode = ObjectAttributeValueNode | ObjectConditionalSplatNode | ObjectSplatNode;
 declare interface ObjectAttributeValueNode extends BaseNode {
-  type: 'ObjectAttributeValue'
-  name: string
-  value: ExprNode
+  type: 'ObjectAttributeValue';
+  name: string;
+  value: ExprNode;
 }
-
 declare interface ObjectConditionalSplatNode extends BaseNode {
-  type: 'ObjectConditionalSplat'
-  condition: ExprNode
-  value: ExprNode
+  type: 'ObjectConditionalSplat';
+  condition: ExprNode;
+  value: ExprNode;
 }
-
 declare interface ObjectNode extends BaseNode {
-  type: 'Object'
-  attributes: ObjectAttributeNode[]
+  type: 'Object';
+  attributes: ObjectAttributeNode[];
 }
-
 declare interface ObjectSplatNode extends BaseNode {
-  type: 'ObjectSplat'
-  value: ExprNode
+  type: 'ObjectSplat';
+  value: ExprNode;
 }
 
-declare type ObjectValue = StaticValue<Record<string, unknown>, 'object'>
-
 /**
- * Creates an observable that emits the organization verification state for a given instance.
- * It combines the dashboard organization ID (from auth context) with the
- * project's actual organization ID (fetched via getProjectState) and compares them.
- * @public
+ * Describes a type node for object values, including a collection of attributes and an optional rest value.
+ * The rest value can be another ObjectTypeNode, an UnknownTypeNode, or an InlineTypeNode.
+ * If the rest value is an ObjectTypeNode, it means that the object can have additional attributes.
+ * If the rest value is an UnknownTypeNode, the entire object is unknown.
+ * If the rest value is an InlineTypeNode, it means that the object has additional attributes from the referenced type.
  */
-export declare function observeOrganizationVerificationState(
-  instance: SanityInstance,
-  projectIds: string[],
-): Observable<OrgVerificationResult>
-
-declare type OpCall =
-  | '=='
-  | '!='
-  | '>'
-  | '>='
-  | '<'
-  | '<='
-  | '+'
-  | '-'
-  | '*'
-  | '/'
-  | '%'
-  | '**'
-  | 'in'
-  | 'match'
 
+declare type ObjectValue = StaticValue<Record<string, unknown>, 'object'>;
+declare type OpCall = '==' | '!=' | '>' | '>=' | '<' | '<=' | '+' | '-' | '*' | '/' | '%' | '**' | 'in' | 'match';
 declare interface OpCallNode extends BaseNode {
-  type: 'OpCall'
-  op: OpCall
-  left: ExprNode
-  right: ExprNode
-}
-
-declare type OptimisticLock = {
-  ifDraftRevisionId?: string
-  ifPublishedRevisionId?: string
-}
-
-/**
- * Error message returned by the organization verification
- * @public
- */
-export declare interface OrgVerificationResult {
-  error: string | null
+  type: 'OpCall';
+  op: OpCall;
+  left: ExprNode;
+  right: ExprNode;
 }
-
 declare interface OrNode extends BaseNode {
-  type: 'Or'
-  left: ExprNode
-  right: ExprNode
-}
-
-/**
- * Represents a set of applied transactions batched into a single outgoing
- * transaction. An outgoing transaction is the result of batching many applied
- * actions. An outgoing transaction may be reverted locally if the server
- * does not accept it.
- */
-declare interface OutgoingTransaction extends AppliedTransaction {
-  disableBatching: boolean
-  batchedTransactionIds: string[]
+  type: 'Or';
+  left: ExprNode;
+  right: ExprNode;
 }
-
 declare interface ParameterNode extends BaseNode {
-  type: 'Parameter'
-  name: string
+  type: 'Parameter';
+  name: string;
 }
-
 declare interface ParentNode_2 extends BaseNode {
-  type: 'Parent'
-  n: number
+  type: 'Parent';
+  n: number;
+}
+declare class Path {
+  private pattern;
+  private patternRe;
+  constructor(pattern: string);
+  matches(str: string): boolean;
+  toJSON(): string;
+}
+declare type PathValue = StaticValue<Path, 'path'>;
+declare interface PipeFuncCallNode extends BaseNode {
+  type: 'PipeFuncCall';
+  func: GroqPipeFunction;
+  base: ExprNode;
+  name: string;
+  args: ExprNode[];
+}
+declare interface PosNode extends BaseNode {
+  type: 'Pos';
+  base: ExprNode;
 }
 
-/** @beta */
-export declare const parseQueryKey: (key: string) => QueryOptions
+/** Union of any primitive type nodes. */
 
-/** @internal */
-export declare const parseUsersKey: (key: string) => {
-  batchSize: number
-  resourceType?: 'organization' | 'project'
-  projectId?: string
-  organizationId?: string
+declare interface ProjectionNode extends BaseNode {
+  type: 'Projection';
+  base: ExprNode;
+  expr: ExprNode;
 }
 
-declare class Path {
-  private pattern
-  private patternRe
-  constructor(pattern: string)
-  matches(str: string): boolean
-  toJSON(): string
-}
+/** A schema consisting of a list of Document or TypeDeclaration items, allowing for complex type definitions. */
 
-/**
- * Split the entire path string on dots "outside" of any brackets.
- *
- * For example:
- * ```
- * "friends[0].name"
- * ```
- *
- * becomes:
- *
- * ```
- * [...ParseSegment<"friends[0]">, ...ParseSegment<"name">]
- * ```
- *
- * (We use a simple recursion that splits on the first dot.)
- */
-declare type PathParts<TPath extends string> = TPath extends `${infer Head}.${infer Tail}`
-  ? [Head, ...PathParts<Tail>]
-  : TPath extends ''
-    ? []
-    : [TPath]
+declare class Scope {
+  params: Record<string, unknown>;
+  source: Value;
+  value: Value;
+  parent: Scope | null;
+  context: Context;
+  isHidden: boolean;
+  constructor(params: Record<string, unknown>, source: Value, value: Value, context: Context, parent: Scope | null);
+  createNested(value: Value): Scope;
+  createHidden(value: Value): Scope;
+}
+declare interface SelectAlternativeNode extends BaseNode {
+  type: 'SelectAlternative';
+  condition: ExprNode;
+  value: ExprNode;
+}
+declare interface SelectNode extends BaseNode {
+  type: 'Select';
+  alternatives: SelectAlternativeNode[];
+  fallback?: ExprNode;
+}
+declare interface SelectorNode extends BaseNode {
+  type: 'Selector';
+}
+declare interface SliceNode extends BaseNode {
+  type: 'Slice';
+  base: ExprNode;
+  left: number;
+  right: number;
+  isInclusive: boolean;
+}
+declare class StaticValue<P, T extends GroqType> {
+  data: P;
+  type: T;
+  constructor(data: P, type: T);
+  isArray(): boolean;
+  get(): Promise<any>;
+  [Symbol.asyncIterator](): Generator<Value, void, unknown>;
+}
+declare class StreamValue {
+  type: 'stream';
+  private generator;
+  private ticker;
+  private isDone;
+  private data;
+  constructor(generator: () => AsyncGenerator<Value, void, unknown>);
+  isArray(): boolean;
+  get(): Promise<any>;
+  [Symbol.asyncIterator](): AsyncGenerator<Value, void, unknown>;
+  _nextTick(): Promise<void>;
+}
 
-declare type PathValue = StaticValue<Path, 'path'>
+/** Describes a type node for string values, optionally including a value. If a value is provided it will always be the given string value. */
 
-/** @beta */
-export declare interface PermissionDeniedReason {
-  type: 'precondition' | 'access'
-  message: string
-  documentId?: string
-}
+declare type StringValue = StaticValue<string, 'string'>;
 
-/**
- * @public
- */
-export declare interface PerspectiveHandle {
-  perspective?: ClientPerspective | ReleasePerspective
-}
+/** Any sort of node which appears as syntax */
 
-declare interface PipeFuncCallNode extends BaseNode {
-  type: 'PipeFuncCall'
-  func: GroqPipeFunction
-  base: ExprNode
-  name: string
-  args: ExprNode[]
+declare interface ThisNode extends BaseNode {
+  type: 'This';
 }
-
-declare interface PosNode extends BaseNode {
-  type: 'Pos'
-  base: ExprNode
+declare interface TupleNode extends BaseNode {
+  type: 'Tuple';
+  members: Array<ExprNode>;
 }
 
-/**
- * Represents a media asset in a preview.
- *
- * @public
- */
-declare interface PreviewMedia {
-  type: 'image-asset'
-  _ref: string
-  url: string
-}
+/** Defines a type declaration with a specific name and a value that describes the structure of the type using a TypeNode. */
 
 /**
- * @public
+ * The result of an expression.
  */
-export declare interface PreviewStoreState {
-  values: {
-    [TDocumentId in string]?: ValuePending<PreviewValue>
-  }
-  subscriptions: {
-    [TDocumentId in string]?: {
-      [TSubscriptionId in string]?: true
-    }
-  }
+declare type Value = AnyStaticValue | StreamValue;
+declare interface ValueNode<P = any> {
+  type: 'Value';
+  value: P;
 }
-
 /**
- * Represents the set of values displayed as a preview for a given Sanity document.
- * This includes a primary title, a secondary subtitle, an optional piece of media associated
- * with the document, and the document's status.
+ * Represents a reactive state source that provides synchronized access to store data
+ *
+ * @remarks
+ * Designed to work with React's useSyncExternalStore hook. Provides three ways to access data:
+ * 1. `getCurrent()` for synchronous current value access
+ * 2. `subscribe()` for imperative change notifications
+ * 3. `observable` for reactive stream access
  *
  * @public
  */
-export declare interface PreviewValue {
-  /**
-   * The primary text displayed for the document preview.
-   */
-  title: string
+interface StateSource<T> {
   /**
-   * A secondary line of text providing additional context about the document.
+   * Subscribes to state changes with optional callback
+   * @param onStoreChanged - Called whenever relevant state changes occur
+   * @returns Unsubscribe function to clean up the subscription
    */
-  subtitle?: string
+  subscribe: (onStoreChanged?: () => void) => () => void;
   /**
-   * An optional piece of media representing the document within its preview.
-   * Currently, only image assets are available.
+   * Gets the current derived state value
+   *
+   * @remarks
+   * Safe to call without subscription. Will always return the latest value
+   * based on the current store state and selector parameters.
    */
-  media?: PreviewMedia | null
+  getCurrent: () => T;
   /**
-   * The status of the document.
+   * Observable stream of state values
+   *
+   * @remarks
+   * Shares a single underlying subscription between all observers. Emits:
+   * - Immediately with current value on subscription
+   * - On every relevant state change
+   * - Errors if selector throws
    */
-  _status?: {
-    /** The date of the last published edit */
-    lastEditedPublishedAt?: string
-    /** The date of the last draft edit */
-    lastEditedDraftAt?: string
-  }
+  observable: Observable<T>;
 }
-
 /**
- * Represents the minimal configuration required to identify a Sanity project.
- * @public
+ * Context passed to selectors when deriving state
+ *
+ * @remarks
+ * Provides access to both the current state value and the Sanity instance,
+ * allowing selectors to use configuration values when computing derived state.
+ * The context is memoized for each state object and instance combination
+ * to optimize performance and prevent unnecessary recalculations.
+ *
+ * @example
+ * ```ts
+ * // Using both state and instance in a selector (psuedo example)
+ * const getUserByProjectId = createStateSourceAction(
+ *   ({ state, instance }: SelectorContext<UsersState>, options?: ProjectHandle) => {
+ *     const allUsers = state.users
+ *     const projectId = options?.projectId ?? instance.config.projectId
+ *     return allUsers.filter(user => user.projectId === projectId)
+ *   }
+ * )
+ * ```
  */
-export declare interface ProjectHandle<TProjectId extends string = string> {
-  projectId?: TProjectId
-}
-
-declare interface ProjectionNode extends BaseNode {
-  type: 'Projection'
-  base: ExprNode
-  expr: ExprNode
-}
-
-declare interface ProjectionOptions<
-  TProjection extends ValidProjection = ValidProjection,
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
-> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
-  projection: TProjection
+interface SelectorContext<TState> {
+  /**
+   * The current state object from the store
+   */
+  state: TState;
+  /**
+   * The Sanity instance associated with this state
+   */
+  instance: SanityInstance;
 }
-
 /**
+ * Function type for selecting derived state from store state and parameters
  * @public
- * The result of a projection query
- */
-export declare interface ProjectionValuePending<TValue extends object> {
-  data: TValue | null
-  isPending: boolean
-}
-
-/**
- * Creates a `PublishDocumentAction` object.
- * @param doc - A handle uniquely identifying the document to be published.
- * @returns A `PublishDocumentAction` object ready for dispatch.
- * @beta
- */
-export declare function publishDocument<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  doc: DocumentHandle<TDocumentType, TDataset, TProjectId>,
-): PublishDocumentAction<TDocumentType, TDataset, TProjectId>
-
-/**
- * Represents an action to publish the draft version of a document.
- * Requires the full document handle.
- * @beta
- */
-export declare interface PublishDocumentAction<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
-> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
-  type: 'document.publish'
-}
-
-/**
- * @beta
  */
-export declare interface QueryOptions<
-  TQuery extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
-> extends Pick<ResponseQueryOptions, 'useCdn' | 'cache' | 'next' | 'cacheMode' | 'tag'>,
-    DatasetHandle<TDataset, TProjectId> {
-  query: TQuery
-  params?: Record<string, unknown>
-}
-
+type Selector<TState, TParams extends unknown[], TReturn> = (context: SelectorContext<TState>, ...params: TParams) => TReturn;
+/**
+ * Configuration options for creating a state source action
+ */
+type ActionMap = {
+  create: 'sanity.action.document.version.create';
+  discard: 'sanity.action.document.version.discard';
+  unpublish: 'sanity.action.document.unpublish';
+  delete: 'sanity.action.document.delete';
+  edit: 'sanity.action.document.edit';
+  publish: 'sanity.action.document.publish';
+};
+type OptimisticLock = {
+  ifDraftRevisionId?: string;
+  ifPublishedRevisionId?: string;
+};
+type HttpAction = {
+  actionType: ActionMap['create'];
+  publishedId: string;
+  attributes: SanityDocumentLike;
+} | {
+  actionType: ActionMap['discard'];
+  versionId: string;
+  purge?: boolean;
+} | {
+  actionType: ActionMap['unpublish'];
+  draftId: string;
+  publishedId: string;
+} | {
+  actionType: ActionMap['delete'];
+  publishedId: string;
+  includeDrafts?: string[];
+} | {
+  actionType: ActionMap['edit'];
+  draftId: string;
+  publishedId: string;
+  patch: PatchOperations;
+} | ({
+  actionType: ActionMap['publish'];
+  draftId: string;
+  publishedId: string;
+} & OptimisticLock);
 /**
  * Represents a transaction that is queued to be applied but has not yet been
  * applied. A transaction will remain in a queued state until all required
  * documents for the transactions are available locally.
  */
-declare interface QueuedTransaction {
+interface QueuedTransaction {
   /**
    * the ID of this transaction. this is generated client-side.
    */
-  transactionId: string
+  transactionId: string;
   /**
    * the high-level actions associated with this transaction. note that these
    * actions don't mention draft IDs and is meant to abstract away the draft
    * model from users.
    */
-  actions: DocumentAction[]
+  actions: DocumentAction[];
   /**
    * An optional flag set to disable this transaction from being batched with
    * other transactions.
    */
-  disableBatching?: boolean
+  disableBatching?: boolean;
 }
-
 /**
- * Signals to the store that the consumer has stopped using the channel
- * @public
+ * Represents a transaction that has been applied locally but has not been
+ * committed/transitioned-to-outgoing. These transactions are visible to the
+ * user but may be rebased upon a new working document set. Applied transactions
+ * also contain the resulting `outgoingActions` that will be submitted to
+ * Content Lake. These `outgoingActions` depend on the state of the working
+ * documents so they are recomputed on rebase and are only relevant to applied
+ * actions (we cannot compute `outgoingActions` for queued transactions because
+ * we haven't resolved the set of documents the actions are dependent on yet).
+ *
+ * In order to support better conflict resolution, the original `previous` set
+ * is saved as the `base` set.
  */
-export declare const releaseChannel: BoundStoreAction_2<
-  ComlinkControllerState,
-  [name: string],
-  void
->
-
+interface AppliedTransaction extends QueuedTransaction {
+  /**
+   * the resulting set of documents after the actions have been applied
+   */
+  working: DocumentSet;
+  /**
+   * the previous set of documents before the action was applied
+   */
+  previous: DocumentSet;
+  /**
+   * the original `previous` document set captured when this action was
+   * originally applied. this is used as a reference point to do a 3-way merge
+   * if this applied transaction ever needs to be reapplied on a different
+   * set of documents.
+   */
+  base: DocumentSet;
+  /**
+   * the `_rev`s from `previous` document set
+   */
+  previousRevs: { [TDocumentId in string]?: string };
+  /**
+   * a timestamp for when this transaction was applied locally
+   */
+  timestamp: string;
+  /**
+   * the resulting HTTP actions derived from the state of the `working` document
+   * set. these are sent to Content Lake as-is when this transaction is batched
+   * and transitioned into an outgoing transaction.
+   */
+  outgoingActions: HttpAction[];
+  /**
+   * similar to `outgoingActions` but comprised of mutations instead of action.
+   * this left here for debugging purposes but could be used to send mutations
+   * to Content Lake instead of actions.
+   */
+  outgoingMutations: Mutation[];
+}
 /**
- * Represents a document in a Sanity dataset that represents release options.
- * @internal
+ * Represents a set of applied transactions batched into a single outgoing
+ * transaction. An outgoing transaction is the result of batching many applied
+ * actions. An outgoing transaction may be reverted locally if the server
+ * does not accept it.
  */
-export declare type ReleaseDocument = SanityDocument & {
-  name: string
-  publishAt?: string
-  state: 'active' | 'scheduled'
-  metadata: {
-    title: string
-    releaseType: 'asap' | 'scheduled' | 'undecided'
-    intendedPublishAt?: string
-    description?: string
-  }
+interface OutgoingTransaction extends AppliedTransaction {
+  disableBatching: boolean;
+  batchedTransactionIds: string[];
 }
-
+interface UnverifiedDocumentRevision {
+  transactionId: string;
+  documentId: string;
+  previousRev: string | undefined;
+  timestamp: string;
+}
+type Grant = 'read' | 'update' | 'create' | 'history';
+/** @beta */
+interface PermissionDeniedReason {
+  type: 'precondition' | 'access';
+  message: string;
+  documentId?: string;
+}
+/** @beta */
+type DocumentPermissionsResult = {
+  allowed: false;
+  message: string;
+  reasons: PermissionDeniedReason[];
+} | {
+  allowed: true;
+  message?: undefined;
+  reasons?: undefined;
+};
+/** @beta */
+type DocumentEvent = ActionErrorEvent | TransactionRevertedEvent | TransactionAcceptedEvent | DocumentRebaseErrorEvent | DocumentEditedEvent | DocumentCreatedEvent | DocumentDeletedEvent | DocumentPublishedEvent | DocumentUnpublishedEvent | DocumentDiscardedEvent;
 /**
- * Signals to the store that the consumer has stopped using the node
- * @public
+ * @beta
+ * Event emitted when a precondition to applying an action fails.
+ * (For example: when trying to edit a document that no longer exists.)
  */
-export declare const releaseNode: BoundStoreAction_2<ComlinkNodeState, [name: string], void>
-
+interface ActionErrorEvent {
+  type: 'error';
+  documentId: string;
+  transactionId: string;
+  message: string;
+  error: unknown;
+}
 /**
- * @public
+ * @beta
+ * Event emitted when a transaction is accepted.
  */
-export declare type ReleasePerspective = {
-  releaseName: string
-  excludedPerspectives?: StackablePerspective[]
+interface TransactionAcceptedEvent {
+  type: 'accepted';
+  outgoing: OutgoingTransaction;
+  result: Awaited<ReturnType<SanityClient['action']>>;
 }
-
-declare interface ReleasesStoreState {
-  activeReleases?: ReleaseDocument[]
-  error?: unknown
+/**
+ * @beta
+ * Event emitted when a transaction is reverted.
+ */
+interface TransactionRevertedEvent {
+  type: 'reverted';
+  message: string;
+  error: unknown;
+  outgoing: OutgoingTransaction;
 }
-
 /**
- * Message from SDK (iframe) to Parent (dashboard) to request a new token
- * @internal
+ * @beta
+ * Event emitted when an attempt to apply local changes to a modified remote document fails.
  */
-export declare type RequestNewTokenMessage = {
-  type: 'dashboard/v1/auth/tokens/create'
-  payload?: undefined
+interface DocumentRebaseErrorEvent {
+  type: 'rebase-error';
+  documentId: string;
+  transactionId: string;
+  message: string;
+  error: unknown;
 }
-
-/** @public */
-export declare const resolveDatasets: BoundStoreAction<
-  FetcherStoreState_2<[options?: ProjectHandle<string> | undefined], DatasetsResponse>,
-  [options?: ProjectHandle<string> | undefined],
-  Promise<DatasetsResponse>
->
-
-/** @beta */
-export declare function resolveDocument<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  instance: SanityInstance,
-  docHandle: DocumentHandle<TDocumentType, TDataset, TProjectId>,
-): Promise<SanityDocument_2<TDocumentType, `${TProjectId}.${TDataset}`> | null>
-
-/** @beta */
-export declare function resolveDocument<TData extends SanityDocument_2>(
-  instance: SanityInstance,
-  docHandle: DocumentHandle<string, string, string>,
-): Promise<TData | null>
-
 /**
- * Resolves the favorite status for a document.
- * @param instance - The Sanity instance.
- * @param context - The document context including ID, type, and resource information.
- * @returns A Promise resolving to `{ isFavorited: boolean }`.
- * @public
+ * @beta
+ * Event emitted when a document is edited.
  */
-export declare const resolveFavoritesState: BoundStoreAction<
-  FetcherStoreState_2<[FavoriteDocumentContext], FavoriteStatusResponse>,
-  [FavoriteDocumentContext],
-  Promise<FavoriteStatusResponse>
->
-
-/** @beta */
-export declare const resolvePermissions: BoundStoreAction<
-  DocumentStoreState,
-  [actions: DocumentAction | DocumentAction[]],
-  Promise<DocumentPermissionsResult_2>
->
-
+interface DocumentEditedEvent {
+  type: 'edited';
+  documentId: string;
+  outgoing: OutgoingTransaction;
+}
 /**
  * @beta
+ * Event emitted when a document is created.
  */
-export declare const resolvePreview: BoundStoreAction<
-  PreviewStoreState_2,
-  [docHandle: ResolvePreviewOptions],
-  Promise<ValuePending_2<object>>
->
-
+interface DocumentCreatedEvent {
+  type: 'created';
+  documentId: string;
+  outgoing: OutgoingTransaction;
+}
 /**
  * @beta
+ * Event emitted when a document is deleted.
  */
-export declare type ResolvePreviewOptions = DocumentHandle
-
-/** @public */
-export declare const resolveProject: BoundStoreAction<
-  FetcherStoreState_2<[options?: ProjectHandle<string> | undefined], SanityProject_2>,
-  [options?: ProjectHandle<string> | undefined],
-  Promise<SanityProject_2>
->
-
-/** @beta */
-export declare function resolveProjection<
-  TProjection extends ValidProjection = ValidProjection,
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  instance: SanityInstance,
-  options: ProjectionOptions<TProjection, TDocumentType, TDataset, TProjectId>,
-): Promise<
-  ProjectionValuePending<
-    SanityProjectionResult<TProjection, TDocumentType, `${TProjectId}.${TDataset}`>
-  >
->
-
-/** @beta */
-export declare function resolveProjection<TData extends object>(
-  instance: SanityInstance,
-  options: ProjectionOptions,
-): Promise<ProjectionValuePending<TData>>
-
-/** @public */
-export declare const resolveProjects: BoundStoreAction<
-  FetcherStoreState_2<[], Omit<SanityProject_2, 'members'>[]>,
-  [],
-  Promise<Omit<SanityProject_2, 'members'>[]>
->
-
+interface DocumentDeletedEvent {
+  type: 'deleted';
+  documentId: string;
+  outgoing: OutgoingTransaction;
+}
 /**
- * Resolves the result of a query without registering a lasting subscriber.
- *
- * This function fetches the result of a GROQ query and returns a promise that resolves with the query result.
- * Unlike `getQueryState`, which registers subscribers to keep the query live and performs automatic cleanup,
- * `resolveQuery` does not track subscribers. This makes it ideal for use with React Suspense, where the returned
- * promise is thrown to delay rendering until the query result becomes available.
- * Once the promise resolves, it is expected that a real subscriber will be added via `getQueryState` to manage ongoing updates.
- *
- * Additionally, an optional AbortSignal can be provided to cancel the query and immediately clear the associated state
- * if there are no active subscribers.
- *
  * @beta
+ * Event emitted when a document is published.
  */
-export declare function resolveQuery<
-  TQuery extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  instance: SanityInstance,
-  queryOptions: ResolveQueryOptions<TQuery, TDataset, TProjectId>,
-): Promise<SanityQueryResult<TQuery, `${TProjectId}.${TDataset}`>>
-
-/** @beta */
-export declare function resolveQuery<TData>(
-  instance: SanityInstance,
-  queryOptions: ResolveQueryOptions,
-): Promise<TData>
-
+interface DocumentPublishedEvent {
+  type: 'published';
+  documentId: string;
+  outgoing: OutgoingTransaction;
+}
 /**
  * @beta
+ * Event emitted when a document is unpublished.
  */
-declare interface ResolveQueryOptions<
-  TQuery extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
-> extends QueryOptions<TQuery, TDataset, TProjectId> {
-  signal?: AbortSignal
+interface DocumentUnpublishedEvent {
+  type: 'unpublished';
+  documentId: string;
+  outgoing: OutgoingTransaction;
 }
-
 /**
- * Resolves the users for a specific resource without registering a lasting subscriber.
+ * @beta
+ * Event emitted when a document version is discarded.
+ */
+interface DocumentDiscardedEvent {
+  type: 'discarded';
+  documentId: string;
+  outgoing: OutgoingTransaction;
+}
+/**
+ * Split the entire path string on dots "outside" of any brackets.
  *
- * This function fetches the users for a given resource and returns a promise that resolves with
- * the users result. Unlike `getUsersState`, which registers subscribers to keep the data live and
- * performs automatic cleanup, `resolveUsers` does not track subscribers. This makes it ideal for
- * use with React Suspense, where the returned promise is thrown to delay rendering until the users
- * result becomes available. Once the promise resolves, it is expected that a real subscriber will
- * be added via `getUsersState` to manage ongoing updates.
+ * For example:
+ * ```
+ * "friends[0].name"
+ * ```
  *
- * Additionally, an optional AbortSignal can be provided to cancel the request and immediately
- * clear the associated state if there are no active subscribers.
+ * becomes:
  *
- * @beta
+ * ```
+ * [...ParseSegment<"friends[0]">, ...ParseSegment<"name">]
+ * ```
+ *
+ * (We use a simple recursion that splits on the first dot.)
  */
-export declare const resolveUsers: BoundStoreAction<
-  UsersStoreState,
-  [ResolveUsersOptions],
-  Promise<{
-    data: SanityUser_2[]
-    totalCount: number
-    hasMore: boolean
-  }>
->
-
+type PathParts<TPath extends string> = TPath extends `${infer Head}.${infer Tail}` ? [Head, ...PathParts<Tail>] : TPath extends '' ? [] : [TPath];
 /**
- * @public
+ * Given a type T and an array of "access keys" Parts, recursively index into T.
+ *
+ * If a part is a key, it looks up that property.
+ * If T is an array and the part is a number, it "indexes" into the element type.
  */
-export declare interface ResolveUsersOptions extends GetUsersOptions {
-  signal?: AbortSignal
-}
-
-export {Role}
-
+type DeepGet<TValue, TPath extends readonly (string | number)[]> = TPath extends [] ? TValue : TPath extends readonly [infer THead, ...infer TTail] ? DeepGet<TValue extends undefined | null ? undefined : THead extends keyof TValue ? TValue[THead] : THead extends number ? TValue extends readonly (infer TElement)[] ? TElement | undefined : undefined : undefined,
+// Key/index doesn't exist
+TTail extends readonly (string | number)[] ? TTail : []> : never;
 /**
- * Represents the complete configuration for a Sanity SDK instance
- * @public
+ * Given a document type TDocument and a JSON Match path string TPath,
+ * compute the type found at that path.
+ * @beta
  */
-export declare interface SanityConfig extends DatasetHandle, PerspectiveHandle {
+type JsonMatch<TDocument, TPath extends string> = DeepGet<TDocument, PathParts<TPath>>;
+/**
+ * Recursively traverse a value. When an array is encountered, ensure that
+ * each object item has a _key property. Memoized such that sub-objects that
+ * have not changed aren't re-computed.
+ */
+interface SharedListener {
+  events: Observable<ListenEvent<SanityDocument$1>>;
+  dispose: () => void;
+}
+interface DocumentStoreState {
+  documentStates: { [TDocumentId in string]?: DocumentState };
+  queued: QueuedTransaction[];
+  applied: AppliedTransaction[];
+  outgoing?: OutgoingTransaction;
+  grants?: Record<Grant, ExprNode>;
+  error?: unknown;
+  sharedListener: SharedListener;
+  fetchDocument: (documentId: string) => Observable<SanityDocument$3 | null>;
+  events: Subject<DocumentEvent>;
+}
+interface DocumentState {
+  id: string;
   /**
-   * Authentication configuration for the instance
-   * @remarks Merged with parent configurations when using createChild
+   * the "remote" local copy that matches the server. represents the last known
+   * server state. this gets updated every time we confirm remote patches
    */
-  auth?: AuthConfig
+  remote?: SanityDocument$3 | null;
   /**
-   * Studio mode configuration for use of the SDK in a Sanity Studio
-   * @remarks Controls whether studio mode features are enabled
+   * the current ephemeral working copy that includes local optimistic changes
+   * that have not yet been confirmed by the server
    */
-  studioMode?: {
-    enabled: boolean
-  }
-}
-
-export {SanityDocument}
-
-/**
- * Represents a Sanity.io resource instance with its own configuration and lifecycle
- * @remarks Instances form a hierarchy through parent/child relationships
- *
- * @public
- */
-export declare interface SanityInstance {
+  local?: SanityDocument$3 | null;
   /**
-   * Unique identifier for this instance
-   * @remarks Generated using crypto.randomUUID()
-   */
-  readonly instanceId: string
-  /**
-   * Resolved configuration for this instance
-   * @remarks Merges values from parent instances where appropriate
-   */
-  readonly config: SanityConfig
-  /**
-   * Checks if the instance has been disposed
-   * @returns true if dispose() has been called
-   */
-  isDisposed(): boolean
-  /**
-   * Disposes the instance and cleans up associated resources
-   * @remarks Triggers all registered onDispose callbacks
-   */
-  dispose(): void
-  /**
-   * Registers a callback to be invoked when the instance is disposed
-   * @param cb - Callback to execute on disposal
-   * @returns Function to unsubscribe the callback
-   */
-  onDispose(cb: () => void): () => void
-  /**
-   * Gets the parent instance in the hierarchy
-   * @returns Parent instance or undefined if this is the root
+   * the revision that our remote document is at
    */
-  getParent(): SanityInstance | undefined
+  remoteRev?: string | null;
   /**
-   * Creates a child instance with merged configuration
-   * @param config - Configuration to merge with parent values
-   * @remarks Child instances inherit parent configuration but can override values
+   * Array of subscription IDs. This document state will be deleted if there are
+   * no subscribers.
    */
-  createChild(config: SanityConfig): SanityInstance
+  subscriptions: string[];
   /**
-   * Traverses the instance hierarchy to find the first instance whose configuration
-   * matches the given target config using a shallow comparison.
-   * @param targetConfig - A partial configuration object containing key-value pairs to match.
-   * @returns The first matching instance or undefined if no match is found.
+   * An object keyed by transaction ID of revisions sent out but that have not
+   * yet been verified yet. When an applied transaction is transitioned to an
+   * outgoing transaction, it also adds unverified revisions for each document
+   * that is part of that outgoing transaction. Transactions are submitted to
+   * the server with a locally generated transaction ID. This way we can observe
+   * when our transaction comes back through the shared listener. Each listener
+   * event that comes back contains a `previousRev`. If we see our own
+   * transaction with a different `previousRev` than expected, we can rebase our
+   * local transactions on top of this new remote.
    */
-  match(targetConfig: Partial<SanityConfig>): SanityInstance | undefined
+  unverifiedRevisions?: { [TTransactionId in string]?: UnverifiedDocumentRevision };
 }
-
 /**
- * @public
+ * @beta
+ * Options for specifying a document and optionally a path within it.
  */
-export declare type SanityProject = SanityProject_2
-
+interface DocumentOptions<TPath extends string | undefined = undefined, TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
+  path?: TPath;
+}
+/** @beta */
+declare function getDocumentState<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(instance: SanityInstance, options: DocumentOptions<undefined, TDocumentType, TDataset, TProjectId>): StateSource<SanityDocument$3<TDocumentType, `${TProjectId}.${TDataset}`> | undefined | null>;
+/** @beta */
+declare function getDocumentState<TPath extends string = string, TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(instance: SanityInstance, options: DocumentOptions<TPath, TDocumentType, TDataset, TProjectId>): StateSource<JsonMatch<SanityDocument$3<TDocumentType, `${TProjectId}.${TDataset}`>, TPath> | undefined>;
+/** @beta */
+declare function getDocumentState<TData>(instance: SanityInstance, options: DocumentOptions<string | undefined>): StateSource<TData | undefined | null>;
+/** @beta */
+declare function resolveDocument<TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(instance: SanityInstance, docHandle: DocumentHandle<TDocumentType, TDataset, TProjectId>): Promise<SanityDocument$3<TDocumentType, `${TProjectId}.${TDataset}`> | null>;
+/** @beta */
+declare function resolveDocument<TData extends SanityDocument$3>(instance: SanityInstance, docHandle: DocumentHandle<string, string, string>): Promise<TData | null>;
+/** @beta */
+declare const getDocumentSyncStatus: BoundStoreAction<DocumentStoreState, [doc: DocumentHandle<string, string, string>], StateSource<boolean | undefined>>;
+/** @beta */
+declare const getPermissionsState: BoundStoreAction<DocumentStoreState, [DocumentAction | DocumentAction[]], StateSource<DocumentPermissionsResult | undefined>>;
+/** @beta */
+declare const resolvePermissions: BoundStoreAction<DocumentStoreState, [actions: DocumentAction | DocumentAction[]], Promise<DocumentPermissionsResult>>;
+/** @beta */
+declare const subscribeDocumentEvents: BoundStoreAction<DocumentStoreState, [eventHandler: (e: DocumentEvent) => void], () => void>;
 /**
  * @public
  */
-export declare interface SanityUser {
-  sanityUserId: string
-  profile: UserProfile
-  memberships: Membership[]
-}
-
-declare class Scope {
-  params: Record<string, unknown>
-  source: Value
-  value: Value
-  parent: Scope | null
-  context: Context
-  isHidden: boolean
-  constructor(
-    params: Record<string, unknown>,
-    source: Value,
-    value: Value,
-    context: Context,
-    parent: Scope | null,
-  )
-  createNested(value: Value): Scope
-  createHidden(value: Value): Scope
-}
-
-declare interface SelectAlternativeNode extends BaseNode {
-  type: 'SelectAlternative'
-  condition: ExprNode
-  value: ExprNode
+interface FavoriteStatusResponse {
+  isFavorited: boolean;
 }
-
-declare interface SelectNode extends BaseNode {
-  type: 'Select'
-  alternatives: SelectAlternativeNode[]
-  fallback?: ExprNode
+/**
+ * @public
+ */
+interface FavoriteDocumentContext extends DocumentHandle {
+  resourceId: string;
+  resourceType: StudioResource['type'] | MediaResource['type'] | CanvasResource['type'];
+  schemaName?: string;
 }
-
 /**
- * Function type for selecting derived state from store state and parameters
+ * Gets a StateSource for the favorite status of a document.
+ * @param instance - The Sanity instance.
+ * @param context - The document context including ID, type, and resource information.
+ * @returns A StateSource emitting `{ isFavorited: boolean }`.
  * @public
  */
-export declare type Selector<TState, TParams extends unknown[], TReturn> = (
-  context: SelectorContext<TState>,
-  ...params: TParams
-) => TReturn
-
+declare const getFavoritesState: BoundStoreAction<FetcherStoreState<[FavoriteDocumentContext], FavoriteStatusResponse>, [FavoriteDocumentContext], StateSource<FavoriteStatusResponse | undefined>>;
 /**
- * Context passed to selectors when deriving state
- *
- * @remarks
- * Provides access to both the current state value and the Sanity instance,
- * allowing selectors to use configuration values when computing derived state.
- * The context is memoized for each state object and instance combination
- * to optimize performance and prevent unnecessary recalculations.
- *
- * @example
- * ```ts
- * // Using both state and instance in a selector (psuedo example)
- * const getUserByProjectId = createStateSourceAction(
- *   ({ state, instance }: SelectorContext<UsersState>, options?: ProjectHandle) => {
- *     const allUsers = state.users
- *     const projectId = options?.projectId ?? instance.config.projectId
- *     return allUsers.filter(user => user.projectId === projectId)
- *   }
- * )
- * ```
+ * Resolves the favorite status for a document.
+ * @param instance - The Sanity instance.
+ * @param context - The document context including ID, type, and resource information.
+ * @returns A Promise resolving to `{ isFavorited: boolean }`.
+ * @public
  */
-declare interface SelectorContext<TState> {
-  /**
-   * The current state object from the store
-   */
-  state: TState
-  /**
-   * The Sanity instance associated with this state
-   */
-  instance: SanityInstance
-}
-
-declare interface SelectorNode extends BaseNode {
-  type: 'Selector'
-}
-
+declare const resolveFavoritesState: BoundStoreAction<FetcherStoreState<[FavoriteDocumentContext], FavoriteStatusResponse>, [FavoriteDocumentContext], Promise<FavoriteStatusResponse>>;
 /**
- * Action to explicitly set the authentication token.
- * Used internally by the Comlink token refresh.
- * @internal
+ * Represents a media asset in a preview.
+ *
+ * @public
  */
-export declare const setAuthToken: BoundStoreAction<AuthStoreState, [token: string | null], void>
-
-declare interface SharedListener {
-  events: Observable<ListenEvent<SanityDocument_3>>
-  dispose: () => void
-}
-
-declare type SingleValuePath = Exclude<PathSegment, IndexTuple>[]
-
-declare interface SliceNode extends BaseNode {
-  type: 'Slice'
-  base: ExprNode
-  left: number
-  right: number
-  isInclusive: boolean
+interface PreviewMedia {
+  type: 'image-asset';
+  _ref: string;
+  url: string;
 }
-
 /**
- * Represents a reactive state source that provides synchronized access to store data
- *
- * @remarks
- * Designed to work with React's useSyncExternalStore hook. Provides three ways to access data:
- * 1. `getCurrent()` for synchronous current value access
- * 2. `subscribe()` for imperative change notifications
- * 3. `observable` for reactive stream access
+ * Represents the set of values displayed as a preview for a given Sanity document.
+ * This includes a primary title, a secondary subtitle, an optional piece of media associated
+ * with the document, and the document's status.
  *
  * @public
  */
-export declare interface StateSource<T> {
+interface PreviewValue {
   /**
-   * Subscribes to state changes with optional callback
-   * @param onStoreChanged - Called whenever relevant state changes occur
-   * @returns Unsubscribe function to clean up the subscription
+   * The primary text displayed for the document preview.
    */
-  subscribe: (onStoreChanged?: () => void) => () => void
+  title: string;
   /**
-   * Gets the current derived state value
-   *
-   * @remarks
-   * Safe to call without subscription. Will always return the latest value
-   * based on the current store state and selector parameters.
+   * A secondary line of text providing additional context about the document.
    */
-  getCurrent: () => T
+  subtitle?: string;
   /**
-   * Observable stream of state values
-   *
-   * @remarks
-   * Shares a single underlying subscription between all observers. Emits:
-   * - Immediately with current value on subscription
-   * - On every relevant state change
-   * - Errors if selector throws
+   * An optional piece of media representing the document within its preview.
+   * Currently, only image assets are available.
+   */
+  media?: PreviewMedia | null;
+  /**
+   * The status of the document.
    */
-  observable: Observable<T>
+  _status?: {
+    /** The date of the last published edit */
+    lastEditedPublishedAt?: string;
+    /** The date of the last draft edit */
+    lastEditedDraftAt?: string;
+  };
 }
-
-declare class StaticValue<P, T extends GroqType> {
-  data: P
-  type: T
-  constructor(data: P, type: T)
-  isArray(): boolean
-  get(): Promise<any>
-  [Symbol.asyncIterator](): Generator<Value, void, unknown>
+/**
+ * Represents the current state of a preview value along with a flag indicating whether
+ * the preview data is still being fetched or is fully resolved.
+ *
+ * The tuple contains a preview value or null, and a boolean indicating if the data is
+ * pending. A `true` value means a fetch is ongoing; `false` indicates that the
+ * currently provided preview value is up-to-date.
+ *
+ * @public
+ */
+type ValuePending<T> = {
+  data: T | null;
+  isPending: boolean;
+};
+/**
+ * @public
+ */
+interface PreviewStoreState {
+  values: { [TDocumentId in string]?: ValuePending<PreviewValue> };
+  subscriptions: { [TDocumentId in string]?: { [TSubscriptionId in string]?: true } };
 }
-
-declare interface StoreEntry<TParams extends unknown[], TData> {
-  params: TParams
-  instance: SanityInstance
-  key: string
-  data?: TData
-  error?: unknown
-  subscriptions: string[]
-  lastFetchInitiatedAt?: string
+/**
+ * @beta
+ */
+type GetPreviewStateOptions = DocumentHandle;
+/**
+ * @beta
+ */
+declare function getPreviewState<TResult extends object>(instance: SanityInstance, options: GetPreviewStateOptions): StateSource<ValuePending<TResult>>;
+/**
+ * @beta
+ */
+declare function getPreviewState(instance: SanityInstance, options: GetPreviewStateOptions): StateSource<ValuePending<PreviewValue>>;
+/**
+ * @beta
+ */
+/**
+ * @beta
+ */
+type ResolvePreviewOptions = DocumentHandle;
+/**
+ * @beta
+ */
+declare const resolvePreview: BoundStoreAction<PreviewStoreState, [docHandle: ResolvePreviewOptions], Promise<ValuePending<object>>>;
+/** @public */
+declare const getProjectState: BoundStoreAction<FetcherStoreState<[options?: ProjectHandle<string> | undefined], _sanity_client12.SanityProject>, [options?: ProjectHandle<string> | undefined], StateSource<_sanity_client12.SanityProject | undefined>>;
+/** @public */
+declare const resolveProject: BoundStoreAction<FetcherStoreState<[options?: ProjectHandle<string> | undefined], _sanity_client12.SanityProject>, [options?: ProjectHandle<string> | undefined], Promise<_sanity_client12.SanityProject>>;
+/**
+ * @public
+ */
+type ValidProjection = `{${string}}`;
+/**
+ * @public
+ * The result of a projection query
+ */
+interface ProjectionValuePending<TValue extends object> {
+  data: TValue | null;
+  isPending: boolean;
 }
-
-declare class StreamValue {
-  type: 'stream'
-  private generator
-  private ticker
-  private isDone
-  private data
-  constructor(generator: () => AsyncGenerator<Value, void, unknown>)
-  isArray(): boolean
-  get(): Promise<any>
-  [Symbol.asyncIterator](): AsyncGenerator<Value, void, unknown>
-  _nextTick(): Promise<void>
+interface ProjectionOptions<TProjection extends ValidProjection = ValidProjection, TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
+  projection: TProjection;
 }
-
-declare type StringValue = StaticValue<string, 'string'>
-
+/**
+ * @beta
+ */
+declare function getProjectionState<TProjection extends ValidProjection = ValidProjection, TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(instance: SanityInstance, options: ProjectionOptions<TProjection, TDocumentType, TDataset, TProjectId>): StateSource<ProjectionValuePending<SanityProjectionResult<TProjection, TDocumentType, `${TProjectId}.${TDataset}`>> | undefined>;
+/**
+ * @beta
+ */
+declare function getProjectionState<TData extends object>(instance: SanityInstance, options: ProjectionOptions): StateSource<ProjectionValuePending<TData> | undefined>;
+/**
+ * @beta
+ */
+declare function getProjectionState(instance: SanityInstance, options: ProjectionOptions): StateSource<ProjectionValuePending<Record<string, unknown>> | undefined>;
+/**
+ * @beta
+ */
 /** @beta */
-export declare const subscribeDocumentEvents: BoundStoreAction<
-  DocumentStoreState,
-  [eventHandler: (e: DocumentEvent) => void],
-  () => void
->
-
-declare interface ThisNode extends BaseNode {
-  type: 'This'
-}
-
+declare function resolveProjection<TProjection extends ValidProjection = ValidProjection, TDocumentType extends string = string, TDataset extends string = string, TProjectId extends string = string>(instance: SanityInstance, options: ProjectionOptions<TProjection, TDocumentType, TDataset, TProjectId>): Promise<ProjectionValuePending<SanityProjectionResult<TProjection, TDocumentType, `${TProjectId}.${TDataset}`>>>;
+/** @beta */
+declare function resolveProjection<TData extends object>(instance: SanityInstance, options: ProjectionOptions): Promise<ProjectionValuePending<TData>>;
+/** @public */
+declare const getProjectsState: BoundStoreAction<FetcherStoreState<[], Omit<_sanity_client12.SanityProject, "members">[]>, [], StateSource<Omit<_sanity_client12.SanityProject, "members">[] | undefined>>;
+/** @public */
+declare const resolveProjects: BoundStoreAction<FetcherStoreState<[], Omit<_sanity_client12.SanityProject, "members">[]>, [], Promise<Omit<_sanity_client12.SanityProject, "members">[]>>;
 /**
  * @beta
- * Event emitted when a transaction is accepted.
  */
-export declare interface TransactionAcceptedEvent {
-  type: 'accepted'
-  outgoing: OutgoingTransaction
-  result: Awaited<ReturnType<SanityClient['action']>>
+interface QueryOptions<TQuery extends string = string, TDataset extends string = string, TProjectId extends string = string> extends Pick<ResponseQueryOptions, 'useCdn' | 'cache' | 'next' | 'cacheMode' | 'tag'>, DatasetHandle<TDataset, TProjectId> {
+  query: TQuery;
+  params?: Record<string, unknown>;
 }
-
 /**
  * @beta
- * Event emitted when a transaction is reverted.
  */
-export declare interface TransactionRevertedEvent {
-  type: 'reverted'
-  message: string
-  error: unknown
-  outgoing: OutgoingTransaction
-}
-
-declare interface TupleNode extends BaseNode {
-  type: 'Tuple'
-  members: Array<ExprNode>
+interface ResolveQueryOptions<TQuery extends string = string, TDataset extends string = string, TProjectId extends string = string> extends QueryOptions<TQuery, TDataset, TProjectId> {
+  signal?: AbortSignal;
 }
-
+/** @beta */
+declare const getQueryKey: (options: QueryOptions) => string;
+/** @beta */
+declare const parseQueryKey: (key: string) => QueryOptions;
 /**
- * Creates an `UnpublishDocumentAction` object.
- * @param doc - A handle uniquely identifying the document to be unpublished.
- * @returns An `UnpublishDocumentAction` object ready for dispatch.
+ * Returns the state source for a query.
+ *
+ * This function returns a state source that represents the current result of a GROQ query.
+ * Subscribing to the state source will instruct the SDK to fetch the query (if not already fetched)
+ * and will keep the query live using the Live content API (considering sync tags) to provide up-to-date results.
+ * When the last subscriber is removed, the query state is automatically cleaned up from the store.
+ *
+ * Note: This functionality is for advanced users who want to build their own framework integrations.
+ * Our SDK also provides a React integration (useQuery hook) for convenient usage.
+ *
+ * Note: Automatic cleanup can interfere with React Suspense because if a component suspends while being the only subscriber,
+ * cleanup might occur unexpectedly. In such cases, consider using `resolveQuery` instead.
+ *
  * @beta
  */
-export declare function unpublishDocument<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
->(
-  doc: DocumentHandle<TDocumentType, TDataset, TProjectId>,
-): UnpublishDocumentAction<TDocumentType, TDataset, TProjectId>
-
+declare function getQueryState<TQuery extends string = string, TDataset extends string = string, TProjectId extends string = string>(instance: SanityInstance, queryOptions: QueryOptions<TQuery, TDataset, TProjectId>): StateSource<SanityQueryResult<TQuery, `${TProjectId}.${TDataset}`> | undefined>;
+/** @beta */
+declare function getQueryState<TData>(instance: SanityInstance, queryOptions: QueryOptions): StateSource<TData | undefined>;
+/** @beta */
+declare function getQueryState(instance: SanityInstance, queryOptions: QueryOptions): StateSource<unknown>;
 /**
- * Represents an action to unpublish a document, moving its published content to a draft.
- * Requires the full document handle.
+ * Resolves the result of a query without registering a lasting subscriber.
+ *
+ * This function fetches the result of a GROQ query and returns a promise that resolves with the query result.
+ * Unlike `getQueryState`, which registers subscribers to keep the query live and performs automatic cleanup,
+ * `resolveQuery` does not track subscribers. This makes it ideal for use with React Suspense, where the returned
+ * promise is thrown to delay rendering until the query result becomes available.
+ * Once the promise resolves, it is expected that a real subscriber will be added via `getQueryState` to manage ongoing updates.
+ *
+ * Additionally, an optional AbortSignal can be provided to cancel the query and immediately clear the associated state
+ * if there are no active subscribers.
+ *
  * @beta
  */
-export declare interface UnpublishDocumentAction<
-  TDocumentType extends string = string,
-  TDataset extends string = string,
-  TProjectId extends string = string,
-> extends DocumentHandle<TDocumentType, TDataset, TProjectId> {
-  type: 'document.unpublish'
+declare function resolveQuery<TQuery extends string = string, TDataset extends string = string, TProjectId extends string = string>(instance: SanityInstance, queryOptions: ResolveQueryOptions<TQuery, TDataset, TProjectId>): Promise<SanityQueryResult<TQuery, `${TProjectId}.${TDataset}`>>;
+/** @beta */
+declare function resolveQuery<TData>(instance: SanityInstance, queryOptions: ResolveQueryOptions): Promise<TData>;
+/**
+ * Represents a document in a Sanity dataset that represents release options.
+ * @internal
+ */
+type ReleaseDocument = SanityDocument$2 & {
+  name: string;
+  publishAt?: string;
+  state: 'active' | 'scheduled';
+  metadata: {
+    title: string;
+    releaseType: 'asap' | 'scheduled' | 'undecided';
+    intendedPublishAt?: string;
+    description?: string;
+  };
+};
+interface ReleasesStoreState {
+  activeReleases?: ReleaseDocument[];
+  error?: unknown;
 }
-
-declare interface UnverifiedDocumentRevision {
-  transactionId: string
-  documentId: string
-  previousRev: string | undefined
-  timestamp: string
+/**
+ * Get the active releases from the store.
+ * @internal
+ */
+declare const getActiveReleasesState: BoundStoreAction<ReleasesStoreState, [], StateSource<ReleaseDocument[] | undefined>>;
+/**
+ * Provides a subscribable state source for a "perspective" for the Sanity client,
+ * which is used to fetch documents as though certain Content Releases are active.
+ *
+ * @param instance - The Sanity instance to get the perspective for
+ * @param options - The options for the perspective -- usually a release name
+ *
+ * @returns A subscribable perspective value, usually a list of applicable release names,
+ * or a single release name / default perspective (such as 'drafts').
+ *
+ * @public
+ */
+declare const getPerspectiveState: BoundStoreAction<ReleasesStoreState, [options?: PerspectiveHandle | undefined], StateSource<string[] | "previewDrafts" | "published" | "drafts" | "raw" | undefined>>;
+/**
+ * @public
+ */
+interface SanityUser {
+  sanityUserId: string;
+  profile: UserProfile;
+  memberships: Membership[];
 }
-
 /**
  * @public
  */
-export declare interface UserProfile {
-  id: string
-  displayName: string
-  email: string
-  familyName?: string
-  givenName?: string
-  middleName?: string | null
-  imageUrl?: string
-  provider: string
-  tosAcceptedAt?: string
-  createdAt: string
-  updatedAt?: string
-  isCurrentUser?: boolean
-  providerId?: string
+interface Membership {
+  addedAt?: string;
+  resourceType: string;
+  resourceId: string;
+  roleNames: Array<string>;
+  lastSeenAt?: string | null;
 }
-
 /**
  * @public
  */
-declare interface UsersGroupState {
-  subscriptions: string[]
-  totalCount?: number
-  nextCursor?: string | null
-  lastLoadMoreRequest?: string
-  users?: SanityUser[]
-  error?: unknown
+interface UserProfile {
+  id: string;
+  displayName: string;
+  email: string;
+  familyName?: string;
+  givenName?: string;
+  middleName?: string | null;
+  imageUrl?: string;
+  provider: string;
+  tosAcceptedAt?: string;
+  createdAt: string;
+  updatedAt?: string;
+  isCurrentUser?: boolean;
+  providerId?: string;
 }
-
 /**
  * @public
  */
-declare interface UsersStoreState {
-  users: {
-    [TUsersKey in string]?: UsersGroupState
-  }
-  error?: unknown
+interface GetUsersOptions extends ProjectHandle {
+  resourceType?: 'organization' | 'project';
+  batchSize?: number;
+  organizationId?: string;
 }
-
 /**
  * @public
  */
-export declare type ValidProjection = `{${string}}`
-
+interface UsersGroupState {
+  subscriptions: string[];
+  totalCount?: number;
+  nextCursor?: string | null;
+  lastLoadMoreRequest?: string;
+  users?: SanityUser[];
+  error?: unknown;
+}
 /**
- * The result of an expression.
+ * @public
  */
-declare type Value = AnyStaticValue | StreamValue
 
-declare interface ValueNode<P = any> {
-  type: 'Value'
-  value: P
+/**
+ * @public
+ */
+interface UsersStoreState {
+  users: { [TUsersKey in string]?: UsersGroupState };
+  error?: unknown;
 }
-
 /**
- * Represents the current state of a preview value along with a flag indicating whether
- * the preview data is still being fetched or is fully resolved.
+ * @public
+ */
+interface ResolveUsersOptions extends GetUsersOptions {
+  signal?: AbortSignal;
+}
+/** @internal */
+declare const getUsersKey: (instance: SanityInstance, {
+  resourceType,
+  organizationId,
+  batchSize,
+  projectId
+}?: GetUsersOptions) => string;
+/** @internal */
+declare const parseUsersKey: (key: string) => {
+  batchSize: number;
+  resourceType?: "organization" | "project";
+  projectId?: string;
+  organizationId?: string;
+};
+/**
+ * Returns the state source for users associated with a specific resource.
  *
- * The tuple contains a preview value or null, and a boolean indicating if the data is
- * pending. A `true` value means a fetch is ongoing; `false` indicates that the
- * currently provided preview value is up-to-date.
+ * This function returns a state source that represents the current list of users for a given
+ * resource. Subscribing to the state source will instruct the SDK to fetch the users (if not
+ * already fetched) and will load more from this state source as well. When the last subscriber is
+ * removed, the users state is automatically cleaned up from the store after a delay.
+ *
+ * Note: This functionality is for advanced users who want to build their own framework
+ * integrations. Our SDK also provides a React integration for convenient usage.
+ *
+ * @beta
+ */
+declare const getUsersState: BoundStoreAction<UsersStoreState, [options?: GetUsersOptions], StateSource<{
+  data: SanityUser[];
+  totalCount: number;
+  hasMore: boolean;
+} | undefined>>;
+/**
+ * Resolves the users for a specific resource without registering a lasting subscriber.
+ *
+ * This function fetches the users for a given resource and returns a promise that resolves with
+ * the users result. Unlike `getUsersState`, which registers subscribers to keep the data live and
+ * performs automatic cleanup, `resolveUsers` does not track subscribers. This makes it ideal for
+ * use with React Suspense, where the returned promise is thrown to delay rendering until the users
+ * result becomes available. Once the promise resolves, it is expected that a real subscriber will
+ * be added via `getUsersState` to manage ongoing updates.
+ *
+ * Additionally, an optional AbortSignal can be provided to cancel the request and immediately
+ * clear the associated state if there are no active subscribers.
+ *
+ * @beta
+ */
+declare const resolveUsers: BoundStoreAction<UsersStoreState, [ResolveUsersOptions], Promise<{
+  data: SanityUser[];
+  totalCount: number;
+  hasMore: boolean;
+}>>;
+/**
+ * Loads more users for a specific resource.
+ *
+ * This function triggers a request to fetch the next page of users for a given resource. It
+ * requires that users have already been loaded for the resource (via `resolveUsers` or
+ * `getUsersState`), and that there are more users available to load (as indicated by the `hasMore`
+ * property).
+ *
+ * The function returns a promise that resolves when the next page of users has been loaded.
  *
+ * @beta
+ */
+declare const loadMoreUsers: BoundStoreAction<UsersStoreState, [options?: GetUsersOptions | undefined], Promise<{
+  data: SanityUser[];
+  totalCount: number;
+  hasMore: boolean;
+}>>;
+interface StoreEntry<TParams extends unknown[], TData> {
+  params: TParams;
+  instance: SanityInstance;
+  key: string;
+  data?: TData;
+  error?: unknown;
+  subscriptions: string[];
+  lastFetchInitiatedAt?: string;
+}
+/**
+ * Internal helper type
  * @public
  */
-export declare type ValuePending<T> = {
-  data: T | null
-  isPending: boolean
+interface FetcherStoreState<TParams extends unknown[], TData> {
+  stateByParams: { [TSerializedKey in string]?: StoreEntry<TParams, TData> };
+  error?: unknown;
 }
-
 /**
- * Message sent from an iframe to a containing app
+ * Internal helper type
  * @public
  */
-export declare type WindowMessage = Message
-
-export {}
+interface FetcherStore<TParams extends unknown[], TData> {
+  getState: BoundStoreAction<FetcherStoreState<TParams, TData>, TParams, StateSource<TData | undefined>>;
+  resolveState: BoundStoreAction<FetcherStoreState<TParams, TData>, TParams, Promise<TData>>;
+}
+/**
+ * Creates a store from a function that returns an observable that fetches data
+ * that supports parameterized state caching.
+ *
+ * This function creates a resource store keyed by parameter values (using the
+ * provided `getKey` function) and returns a state source (via `getState`)
+ * that components can subscribe to. When a new subscription is added, and if
+ * enough time has passed since the last fetch (controlled by
+ * `fetchThrottleInternal`), it invokes the observable factory (via
+ * `getObservable`) to fetch fresh data. The data is stored in state and can be
+ * accessed reactively.
+ *
+ * Additionally, the store provides a `resolveState` function that returns a
+ * Promise resolving with the next non-undefined value from the state source.
+ *
+ * State expiration is implemented: after the last subscription for a key is
+ * removed, its state is cleared after `stateExpirationDelay` ms, causing
+ * components to suspend until fresh data is fetched.
+ */
+/**
+ * Creates a GROQ search filter string (`[@] match text::query("...")`)
+ * from a raw search query string.
+ *
+ * It applies wildcard ('*') logic to the last eligible token and escapes
+ * double quotes within the search term.
+ *
+ * If the input query is empty or only whitespace, it returns an empty string.
+ *
+ * @param query - The raw input search string.
+ * @returns The GROQ search filter string, or an empty string.
+ * @internal
+ */
+declare function createGroqSearchFilter(query: string): string;
+/**
+ * This version is provided by pkg-utils at build time
+ * @internal
+ */
+declare const CORE_SDK_VERSION: {};
+/**
+ * @public
+ */
+type SanityProject = SanityProject$1;
+export { type ActionErrorEvent, type ActionsResult, type ApplyDocumentActionsOptions, type AuthConfig, type AuthProvider, type AuthState, AuthStateType, type AuthStoreState, CORE_SDK_VERSION, type ClientOptions, type ClientStoreState as ClientState, type ComlinkControllerState, type ComlinkNodeState, type CreateDocumentAction, type CurrentUser, type DatasetHandle, type DeleteDocumentAction, type DiscardDocumentAction, type DocumentAction, type DocumentCreatedEvent, type DocumentDeletedEvent, type DocumentDiscardedEvent, type DocumentEditedEvent, type DocumentEvent, type DocumentHandle, type DocumentOptions, type DocumentPermissionsResult, type DocumentPublishedEvent, type DocumentTypeHandle, type DocumentUnpublishedEvent, type EditDocumentAction, type ErrorAuthState, type FavoriteStatusResponse, type FetcherStore, type FetcherStoreState, type FrameMessage, type GetPreviewStateOptions, type GetUsersOptions, type JsonMatch, type LoggedInAuthState, type LoggedOutAuthState, type LoggingInAuthState, type Membership, type NewTokenResponseMessage, type NodeState, type OrgVerificationResult, type PermissionDeniedReason, type PerspectiveHandle, type PreviewStoreState, type PreviewValue, type ProjectHandle, type ProjectionValuePending, type PublishDocumentAction, type QueryOptions, type ReleaseDocument, type ReleasePerspective, type RequestNewTokenMessage, type ResolvePreviewOptions, type ResolveUsersOptions, type Role, type SanityConfig, type SanityDocument, type SanityInstance, SanityProject, type SanityUser, type Selector, type StateSource, type TransactionAcceptedEvent, type TransactionRevertedEvent, type UnpublishDocumentAction, type UserProfile, type ValidProjection, type ValuePending, type WindowMessage, applyDocumentActions, createDatasetHandle, createDocument, createDocumentHandle, createDocumentTypeHandle, createGroqSearchFilter, createProjectHandle, createSanityInstance, deleteDocument, destroyController, discardDocument, editDocument, getActiveReleasesState, getAuthState, getClient, getClientState, getCurrentUserState, getDashboardOrganizationId, getDatasetsState, getDocumentState, getDocumentSyncStatus, getFavoritesState, getIndexForKey, getIsInDashboardState, getLoginUrlState, getNodeState, getOrCreateChannel, getOrCreateController, getOrCreateNode, getPathDepth, getPermissionsState, getPerspectiveState, getPreviewState, getProjectState, getProjectionState, getProjectsState, getQueryKey, getQueryState, getTokenState, getUsersKey, getUsersState, handleAuthCallback, joinPaths, jsonMatch, loadMoreUsers, logout, observeOrganizationVerificationState, parseQueryKey, parseUsersKey, publishDocument, releaseChannel, releaseNode, resolveDatasets, resolveDocument, resolveFavoritesState, resolvePermissions, resolvePreview, resolveProject, resolveProjection, resolveProjects, resolveQuery, resolveUsers, setAuthToken, slicePath, stringifyPath, subscribeDocumentEvents, unpublishDocument };