sanity
Version:
Sanity is a real-time content infrastructure with a scalable, hosted backend featuring a Graph Oriented Query Language (GROQ), asset pipelines and fast edge caches
1,821 lines (1,735 loc) • 259 kB
TypeScript
import {ArraySchemaType} from '@sanity/types'
import {AssetMetadataType} from '@sanity/types'
import {AssetSource} from '@sanity/types'
import {AssetSourceSpec} from '@sanity/types'
import {BooleanSchemaType} from '@sanity/types'
import {ButtonTone} from '@sanity/ui'
import {CardProps} from '@sanity/ui'
import {ClientConfig} from '@sanity/client'
import {ComponentProps} from 'react'
import {ComponentType} from 'react'
import {ConfigContext} from 'sanity'
import {CrossDatasetReferenceValue} from '@sanity/types'
import {CSSProperties} from 'react'
import {CurrentUser} from '@sanity/types'
import {DialogProps} from '@sanity/ui'
import {DocumentActionComponent as DocumentActionComponent_2} from 'sanity'
import {DocumentBadgeComponent as DocumentBadgeComponent_2} from 'sanity'
import {DocumentFieldAction as DocumentFieldAction_2} from 'sanity'
import {DocumentFieldActionNode} from 'sanity'
import {DocumentFormNode} from 'sanity'
import {DocumentInspector as DocumentInspector_2} from 'sanity'
import {DocumentLanguageFilterComponent as DocumentLanguageFilterComponent_2} from 'sanity'
import {DocumentStore} from 'sanity'
import {EditorChange} from '@portabletext/editor'
import {EditorSelection} from '@portabletext/editor'
import {EditStateFor as EditStateFor_2} from 'sanity'
import {ErrorInfo} from 'react'
import {FileValue} from '@sanity/types'
import {FocusEvent as FocusEvent_2} from 'react'
import {FocusEventHandler} from 'react'
import {FormEventHandler} from 'react'
import {FormNodeValidation} from '@sanity/types'
import {GeneralPreviewLayoutKey} from 'sanity'
import {GeopointValue} from '@sanity/types'
import {HotkeyOptions} from '@portabletext/editor'
import {HTMLProps} from 'react'
import {I18nTextRecord} from 'sanity'
import {I18nTextRecord as I18nTextRecord_2} from '@sanity/types'
import {ImageUrlFitMode} from '@sanity/types'
import {ImageValue} from '@sanity/types'
import {InitialValueProperty} from '@sanity/types'
import {InitialValueTemplateItem} from 'sanity'
import {JSX} from 'react'
import {KeyedSegment} from '@sanity/types'
import {LocaleSource} from 'sanity'
import {MarkdownPluginConfig} from '@portabletext/editor/plugins'
import {MemoExoticComponent} from 'react'
import {MutableRefObject} from 'react'
import {NamedExoticComponent} from 'react'
import {NumberSchemaType} from '@sanity/types'
import {ObjectSchemaType} from '@sanity/types'
import {Observable} from 'rxjs'
import {OnCopyFn} from '@portabletext/editor'
import {OnPasteFn} from '@portabletext/editor'
import {PatchEvent as PatchEvent_2} from 'sanity'
import {Path} from '@sanity/types'
import {PathSegment} from '@sanity/types'
import {PermissionCheckResult} from 'sanity'
import {PerspectiveStack} from 'sanity'
import {PortableTextBlock} from '@sanity/types'
import {PortableTextEditor} from '@portabletext/editor'
import {PortableTextObject} from '@sanity/types'
import {PreviewLayoutKey} from 'sanity'
import {RangeDecoration} from '@portabletext/editor'
import {ReactNode} from 'react'
import {ReferenceValue} from '@sanity/types'
import {ReleaseId} from 'sanity'
import {RootTheme} from '@sanity/ui/theme'
import {Router} from 'sanity/router'
import {RouterState} from 'sanity/router'
import {SanityClient} from '@sanity/client'
import {SanityDocument} from '@sanity/types'
import {SanityDocumentLike} from '@sanity/types'
import {Schema} from '@sanity/types'
import {SchemaType} from '@sanity/types'
import {SchemaTypeDefinition} from '@sanity/types'
import {SearchParam} from 'sanity/router'
import {SearchStrategy} from '@sanity/types'
import {SlugValue} from '@sanity/types'
import {SortOrdering} from '@sanity/types'
import {SortOrderingItem} from '@sanity/types'
import {Source} from 'sanity'
import {StateTree} from 'sanity'
import {StringSchemaType} from '@sanity/types'
import {TFunction} from 'i18next'
import {TimelineStore} from 'sanity'
import {User} from '@sanity/types'
import {ValidationMarker} from '@sanity/types'
declare interface Action extends NavbarActionBase {
onAction: () => void
selected: boolean
title: string
render?: undefined
}
/**
* @hidden
* @beta */
declare interface ActionComponent<ActionProps> {
(props: ActionProps): DocumentActionDescription | null
}
declare interface ActionWithCustomRender extends NavbarActionBase {
render: () => React.ReactElement
}
/**
* @hidden
* @beta */
declare interface ActiveToolLayoutProps {
renderDefault: (props: ActiveToolLayoutProps) => React.JSX.Element
activeTool: Tool
}
/**
* @public
* Config for the apps that are available in the studio.
*/
declare type AppsOptions = {
canvas?: {
enabled: boolean
/**
* To allow the "Link to canvas" action on localhost, or in studios not listed under Studios in sanity.io/manage
* provide a fallback origin as a string.
*
* The string must be the exactly equal `name` as shown for the Studio in manage, and the studio must have create-manifest.json available.
*
* If the provided fallback Studio does not expose create-manifest.json "Link to canvas" will fail when using the fallback.
*
* Example: `wonderful.sanity.studio`
*
* Keep in mind that when fallback origin is used, Canvas will use the schema types and dataset in the *deployed* Studio,
* not from localhost.
*
* To see data synced from Canvas in your localhost Studio, you must ensure that the deployed fallback studio uses the same
* workspace and schemas as your local configuration.
*
*/
fallbackStudioOrigin?: string
}
}
/**
* @hidden
* @public */
declare interface ArrayFieldProps extends BaseFieldProps {
schemaType: ArraySchemaType
value: unknown[] | undefined
collapsed?: boolean
collapsible?: boolean
onCollapse: () => void
onExpand: () => void
inputProps: ArrayOfObjectsInputProps
}
/**
* @hidden
* @beta */
declare interface ArrayInputCopyEvent<Item> {
items: Item[]
}
/**
* These are the props an implementation of the ArrayFunctions component will receive
*
*
* @hidden
* @beta
*/
declare interface ArrayInputFunctionsProps<Item, SchemaType extends ArraySchemaType> {
children?: ReactNode
onItemAppend: (itemValue: Item) => void
onChange: (event: PatchEvent) => void
onValueCreate: (type: SchemaType) => Item
onItemPrepend: (itemValue: Item) => void
readOnly?: boolean
schemaType: SchemaType
value?: Item[]
}
/**
* @hidden
* @beta */
declare interface ArrayInputInsertEvent<Item> {
items: Item[]
position: 'before' | 'after'
referenceItem: KeyedSegment | number
skipInitialValue?: boolean
open?: boolean
}
/**
* @hidden
* @beta */
declare interface ArrayInputMoveItemEvent {
fromIndex: number
toIndex: number
}
/**
* @hidden
* @beta */
declare interface ArrayItemError {
kind: 'error'
key: string
index: number
error: InvalidItemTypeError
}
/** @public */
declare interface ArrayOfObjectsFormNode<
T extends any[] = unknown[],
S extends ArraySchemaType = ArraySchemaType,
> extends BaseFormNode<T, S> {
/** The focus path of the form node. */
focusPath: Path
/**
* @hidden
* @beta */
members: ArrayOfObjectsMember[]
}
/**
* @hidden
* @public */
declare interface ArrayOfObjectsInputProps<
T extends {
_key: string
} = {
_key: string
},
S extends ArraySchemaType = ArraySchemaType,
> extends BaseInputProps,
ArrayOfObjectsFormNode<T[], S> {
/**
* @hidden
* @beta */
arrayFunctions?: ComponentType<ArrayInputFunctionsProps<T, S>>
/**
* @hidden
* @beta */
onChange: (patch: FormPatch | FormPatch[] | PatchEvent) => void
/**
* @hidden
* @beta */
onItemAppend: (item: T) => void
/**
* @hidden
* @beta */
onItemPrepend: (item: T) => void
/**
* @hidden
* @beta */
onItemRemove: (itemKey: string) => void
/**
* @hidden
* @beta */
onItemMove: (event: ArrayInputMoveItemEvent) => void
/**
* @hidden
* @beta */
onInsert: (event: ArrayInputInsertEvent<T>) => void
/**
* @hidden
* @beta */
resolveInitialValue: (type: SchemaType, params: Record<string, unknown>) => Promise<T>
/**
* @hidden
* @beta */
resolveUploader: UploaderResolver<ObjectSchemaType>
/**
* @hidden
* @beta */
onUpload: (event: UploadEvent) => void
/**
* @hidden
* @beta */
onPathFocus: (path: Path, payload?: OnPathFocusPayload) => void
/**
* for array inputs using expand/collapse semantics for items
*
* @hidden
* @beta
*/
onItemCollapse: (itemKey: string) => void
/**
* @hidden
* @beta */
onItemExpand: (itemKey: string) => void
/**
* for array inputs using modal open/close semantics for items
*
* @hidden
* @beta
*/
onItemOpen: (path: Path) => void
/**
* @hidden
* @beta */
onItemClose: () => void
/**
* @hidden
* @beta */
renderAnnotation?: RenderAnnotationCallback
/**
* @hidden
* @beta */
renderBlock?: RenderBlockCallback
/**
* @hidden
* @beta */
renderInlineBlock?: RenderBlockCallback
/**
* @hidden
* @beta */
renderField: RenderFieldCallback
/**
* @hidden
* @beta */
renderInput: RenderInputCallback
/**
* @hidden
* @beta */
renderItem: RenderArrayOfObjectsItemCallback
/**
* @hidden
* @beta */
renderPreview: RenderPreviewCallback
/**
* @hidden
* @beta */
elementProps: ComplexElementProps
}
/**
* @hidden
* @beta */
declare interface ArrayOfObjectsItemMember<Node extends ObjectArrayFormNode = ObjectArrayFormNode> {
kind: 'item'
key: string
index: number
collapsed: boolean | undefined
collapsible: boolean | undefined
open: boolean
parentSchemaType: ArraySchemaType
/**
* @hidden
* @beta */
item: Node
}
/**
* @hidden
* @beta */
declare type ArrayOfObjectsMember = ArrayOfObjectsItemMember | ArrayItemError
/**
* @hidden
* @beta */
declare type ArrayOfPrimitivesElementType<T extends any[]> = T extends (infer K)[] ? K : unknown
/** @public */
declare interface ArrayOfPrimitivesFormNode<
T extends (string | number | boolean)[] = (string | number | boolean)[],
S extends ArraySchemaType = ArraySchemaType,
> extends BaseFormNode<T, S> {
/** The focus path of the form node. */
focusPath: Path
/**
* @hidden
* @beta */
members: ArrayOfPrimitivesMember[]
}
/**
* @hidden
* @public */
declare interface ArrayOfPrimitivesInputProps<
T extends string | boolean | number = string | boolean | number,
S extends ArraySchemaType = ArraySchemaType,
> extends BaseInputProps,
ArrayOfPrimitivesFormNode<T[], S> {
/**
* @hidden
* @beta */
arrayFunctions?: ComponentType<ArrayInputFunctionsProps<T, S>>
onSetCollapsed: (collapsed: boolean) => void
/**
* @hidden
* @beta */
onChange: (patch: FormPatch | FormPatch[] | PatchEvent) => void
/**
* @hidden
* @beta */
onItemAppend: (item: ArrayOfPrimitivesElementType<T[]>) => void
/**
* @hidden
* @beta */
onItemPrepend: (item: ArrayOfPrimitivesElementType<T[]>) => void
/**
* @hidden
* @beta */
onItemRemove: (index: number) => void
/**
* @hidden
* @beta */
onMoveItem: (event: ArrayInputMoveItemEvent) => void
/**
* @hidden
* @beta */
onInsert: (event: {items: T[]; position: 'before' | 'after'; referenceIndex: number}) => void
/**
* @hidden
* @beta */
resolveUploader: UploaderResolver<NumberSchemaType | BooleanSchemaType | StringSchemaType>
/**
* @hidden
* @beta */
onUpload: (event: UploadEvent) => void
/**
* @hidden
* @beta */
onIndexFocus: (index: number) => void
/**
* @hidden
* @beta */
renderAnnotation?: RenderAnnotationCallback
/**
* @hidden
* @beta */
renderBlock?: RenderBlockCallback
/**
* @hidden
* @beta */
renderInlineBlock?: RenderBlockCallback
/**
* @hidden
* @beta */
renderInput: RenderInputCallback
/**
* @hidden
* @beta */
renderItem: RenderArrayOfPrimitivesItemCallback
/**
* @hidden
* @beta */
renderPreview: RenderPreviewCallback
/**
* @hidden
* @beta */
elementProps: ComplexElementProps
}
/**
* @hidden
* @beta */
declare interface ArrayOfPrimitivesItemMember<Node extends PrimitiveFormNode = PrimitiveFormNode> {
kind: 'item'
key: string
index: number
open: boolean
parentSchemaType: ArraySchemaType
/**
* @hidden
* @beta */
item: Node
}
/**
* @hidden
* @beta */
declare type ArrayOfPrimitivesMember = ArrayOfPrimitivesItemMember | ArrayItemError
/**
* @hidden
* @beta
*/
declare type AssetSourceResolver = ComposableOption<AssetSource[], ConfigContext_2>
/**
* @hidden
* @beta
*/
declare type AsyncComposableOption<TValue, TContext> = (
prev: TValue,
context: TContext,
) => Promise<TValue>
/**
* Authentication options
*
* @public
*/
declare interface AuthConfig {
/**
* Login method to use for the studio. Can be one of:
* - `dual` (default) - attempt to use cookies where possible, falling back to
* storing authentication token in `localStorage` otherwise
* - `cookie` - explicitly disable `localStorage` method, relying only on cookies. May fail due
* to cookies being treated as third-party cookies in some browsers, thus the default is `dual`.
* - `token` - explicitly disable cookies, relying only on `localStorage` method
*/
loginMethod?: LoginMethod
/**
* Whether to append the providers specified in `providers` with the default providers from the
* API, or replace the default providers with the ones specified.
*
* @deprecated Use the function form of `providers` instead for more control
*/
mode?: 'append' | 'replace'
/**
* If true, the "Choose login provider" (eg "Google, "GitHub", "E-mail/password") screen
* will be skipped if only a single provider is configured in the `providers` array -
* instead it will redirect unauthenticated users straight to the authentication URL.
*/
redirectOnSingle?: boolean
/**
* Array of authentication providers to use, or a function that takes an array of default
* authentication providers (fetched from the Sanity API) and should return a new list of
* providers. This can be used to selectively replace, add or remove providers from the
* list of choices.
*
* @remarks If a static array of providers is provided, the `mode` property is taken into account
* when determining what to do with it - `append` will append the providers to the default set
* of providers, while `replace` will replace the default providers with the ones specified.
*
* If not set, the default providers will be used.
*/
providers?: AuthProvider[] | ((prev: AuthProvider[]) => AuthProvider[] | Promise<AuthProvider[]>)
/**
* The API hostname for requests. Should usually be left undefined,
* but can be set if using custom cname for API domain.
*/
apiHost?: string
}
/**
* A provider of authentication.
*
* By default, a list of providers for a project will be fetched from the
* {@link https://api.sanity.io/v1/auth/providers | Sanity API}, but you may choose to limit this
* list by explicitly defining the providers you want to allow, or add additional custom providers
* that conforms to the authentication provider specification outlined in
* {@link https://www.sanity.io/docs/third-party-login | the documentation}.
*
* @public
*/
declare interface AuthProvider {
/**
* URL-friendly identifier/name for the provider, eg `github`
*/
name: string
/**
* Human friendly title for the provider, eg `GitHub`
*/
title: string
/**
* URL for the authentication endpoint that will trigger the authentication flow
*/
url: string
/**
* URL for a logo to display next to the provider in the login screen
*/
logo?: string
}
/**
* The unit an `AuthStore` emits to determine the user's authentication state.
*
* @beta
* @hidden
*/
declare interface AuthState {
/**
* Similar to a logged-in flag. This state is used in places like the
* `AuthBoundary` to determine whether or not it should render the
* `NotAuthenticatedComponent`. Implementers may choose to set this to `true`
* while also also emitting a `currentUser` of `null` if a `null` user is
* accepted (e.g. a project that doesn't require a login)
*/
authenticated: boolean
/**
* The value of the user logged in or `null` if none is provided
*/
currentUser: CurrentUser | null
/**
* A client that is expected to be pre-configured to allow for any downstream
* requests in the Studio
*/
client: SanityClient
}
/**
* The interface used by the Studio that produces a `SanityClient` and
* `CurrentUser` that gets passed to the resulting `Workspace`s and `Source`s.
*
* NOTE: This interface is primarily for internal use. Refer to
* `createAuthStore` instead.
*
* @beta
* @hidden
*/
declare interface AuthStore {
/**
* Emits `AuthState`s. This should update when the user's auth state changes.
* E.g. After a login, a new `AuthState` could be emitted with a non-null
* `currentUser` and `authenticated: true`
*
* NOTE: all auth store implementations should emit on subscribe using
* something like shareReplay(1) to ensure all new subscribers get an
* `AuthState` value on subscribe
*/
state: Observable<AuthState>
/**
* Emits auth tokens, or `null` if not configured to use them or they do not exist
*/
token?: Observable<string | null>
/**
* Custom auth stores are expected to implement a UI that initiates the user's
* authentication. For the typical case in `createAuthStore`, this means
* loading the providers and showing them as options to the user.
*/
LoginComponent?: ComponentType<LoginComponentProps>
/**
* Custom auth stores can implement a function that runs when the user logs
* out. The implementation is expected to remove all credentials both locally
* and on the server.
*/
logout?: () => void
/**
* Custom auth stores can implement a function that is designated to run when
* the Studio loads (e.g. to trade a session ID for a token in cookie-less
* mode). Within the Studio, this is called within the `AuthBoundary`.
*/
handleCallbackUrl?: () => Promise<void>
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type BackLinkProps = BackLinkProps_2
/**
* @hidden
* @beta */
declare interface BackLinkProps_2 {
children?: ReactNode
}
/**
* @hidden
* @public */
declare interface BaseFieldProps {
/** @beta */
actions?: DocumentFieldAction[]
/** @internal @deprecated DO NOT USE */
__internal_comments?: FieldCommentsProps
/** @internal @deprecated ONLY USED BY AI ASSIST PLUGIN */
__internal_slot?: ReactNode
schemaType: SchemaType
title: string | undefined
description: string | undefined
/**
* @hidden
* @beta */
presence: FormNodePresence[]
validation: FormNodeValidation[]
level: number
inputId: string
value: unknown | undefined
path: Path
name: string
index: number
changed: boolean
children: ReactNode
version?: string
renderDefault: (props: FieldProps) => React.JSX.Element
}
/**
* @hidden
* @public
*/
declare interface BaseFormNode<T = unknown, S extends SchemaType = SchemaType> {
/** The unique identifier of the node. */
id: string
/** The schema type of the node. */
schemaType: S
/** The level of the node in the form hierarchy. */
level: number
/** The path of the node in the form hierarchy. */
path: Path
/**
* @hidden
* @beta */
presence: FormNodePresence[]
/** The validation markers of the node. */
validation: FormNodeValidation[]
/** The value of the node. */
value: T | undefined
/** Whether the node is read-only. */
readOnly?: boolean
/** Whether the node is focused. */
focused?: boolean
/** Whether the node has changes in a draft. */
changed: boolean
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type BaseGenericList = BaseGenericList_2
/**
* Interface for base generic list
*
* @public
*/
declare interface BaseGenericList_2 extends StructureNode_2 {
/** List layout key. */
defaultLayout?: PreviewLayoutKey
/** Can handle intent. See {@link IntentChecker} */
canHandleIntent?: IntentChecker_2
/** List display options. See {@link ListDisplayOptions} */
displayOptions?: ListDisplayOptions_2
/** List child. See {@link Child} */
child: Child_2
/** List initial values array. See {@link InitialValueTemplateItem} and {@link InitialValueTemplateItemBuilder} */
initialValueTemplates?: (InitialValueTemplateItem | InitialValueTemplateItemBuilder_2)[]
}
/**
* @hidden
* @public */
declare interface BaseInputProps {
renderDefault: (props: InputProps) => React.JSX.Element
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type BaseIntentParams = BaseIntentParams_2
/**
* Base intent parameters
*
* @public
* @todo dedupe with core
*/
declare interface BaseIntentParams_2 {
/**
* Document schema type name to create/edit.
* Required for `create` intents, optional for `edit` (but encouraged, safer and faster)
*/
type?: string
/**
* ID of the document to create/edit.
* Required for `edit` intents, optional for `create`.
*/
id?: string
/**
* Name (ID) of initial value template to use for `create` intent. Optional.
*/
template?: string
/**
* Experimental field path
*
* @beta
* @experimental
* @hidden
*/
path?: string
/**
* Optional "mode" to use for edit intent.
* Known modes are `structure` and `presentation`.
*/
mode?: string
/**
* Arbitrary/custom parameters are generally discouraged - try to keep them to a minimum,
* or use `payload` (arbitrary JSON-serializable object) instead.
*/
[key: string]: string | undefined
}
/**
* Props for the base item component.
*
* @public
*/
declare interface BaseItemProps<T> {
/** The schema type of the item. */
schemaType: SchemaType
/** The key of the item. */
key: string
/** The index of the item. */
index: number
/** The level of the item. */
level: number
/** The value of the item. */
value: unknown
/** The path of the item. */
path: Path
/** The title of the item. */
title: string | undefined
/** The description of the item. */
description: string | undefined
/** The ID of the input element. */
inputId: string
/** The function to call when the item receives focus. */
onFocus: (event: FocusEvent_2) => void
/** The function to call when the item loses focus. */
onBlur: (event: FocusEvent_2) => void
/** Whether the item is read-only. */
readOnly?: boolean
/** Whether the item is focused. */
focused?: boolean
/** The function to call when the item is removed. */
onRemove: () => void
/**
* @hidden
* @beta */
onInsert: (event: Omit<ArrayInputInsertEvent<T>, 'referenceItem'>) => void
/**
* @hidden
* @beta */
onCopy: (event: Omit<ArrayInputCopyEvent<T>, 'referenceItem'>) => void
/** The children of the item. */
children: ReactNode
/** The validation markers for the item. */
validation: FormNodeValidation[]
/**
* @hidden
* @beta */
presence: FormNodePresence[]
/** The function to call to render the default item. See {@link ItemProps} */
renderDefault: (props: ItemProps) => React.JSX.Element
}
/** @internal */
export declare interface BaseResolvedPaneNode<T extends PaneNode_2['type']> {
id: string
type: T
title: string
i18n?: I18nTextRecord<'title'>
menuItems?: PaneMenuItem_2[]
menuItemGroups?: PaneMenuItemGroup_2[]
canHandleIntent?: (
intentName: string,
params: Record<string, string | undefined>,
options: {
pane: PaneNode_2
index: number
},
) => boolean
child?: UnresolvedPaneNode_2
}
declare interface BaseStructureToolPaneProps<T extends PaneNode_2['type']> {
paneKey: string
index: number
itemId: string
childItemId?: string
isSelected?: boolean
isActive?: boolean
pane: Extract<
PaneNode_2,
{
type: T
}
>
/**
* TODO: COREL - Remove this after updating sanity-assist to use <PerspectiveProvider>
*
* Allows to override the global version with a specific version or release.
* @deprecated use <PerspectiveProvider> instead
* @beta
*/
forcedVersion?: {
selectedPerspectiveName: ReleaseId | 'published' | undefined
isReleaseLocked: boolean
selectedReleaseId: ReleaseId | undefined
}
/**
* @deprecated Avoid specifying a key, instead use `paneKey` if need be
*/
key?: string
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type BaseView = BaseView_2
/**
* Interface for base view
*
* @public */
declare interface BaseView_2 {
/** View id */
id: string
/** View Title */
title: string
/** View Icon */
icon?: React.ComponentType | React.ReactNode
}
/**
* @internal
* Configuration for studio beta features.
* */
declare interface BetaFeatures {
/**
* @beta
* @hidden
* @deprecated beta feature is no longer available.
* */
treeArrayEditing?: {
/**
* @deprecated beta feature is no longer available.
*/
enabled: boolean
}
/**
* @deprecated - The Start in Create flow has been removed and will be updated in an upcoming studio release.
*/
create?: {
/**
* When true, a "Start in Sanity Create" action will be shown for all new documents, in place of regular document actions,
* when the following are true:
* - the origin of the current url is listed under Studios in sanity.to/manage (OR fallbackStudioOrigin is provided)
* - [origin]/static/create-manifest.json is available over HTTP GET
*
* The manifest file is automatically created and deployed when deploying studios with `sanity deploy`
*
* @see #fallbackStudioOrigin
*/
startInCreateEnabled?: boolean
/**
* To show the "Start in Create" button on localhost, or in studios not listed under Studios in sanity.io/manage
* provide a fallback origin as a string.
*
* The string must be the exactly equal `name` as shown for the Studio in manage, and the studio must have create-manifest.json available.
*
* If the provided fallback Studio does not expose create-manifest.json "Start in Sanity Create" will fail when using the fallback.
*
* Example: `wonderful.sanity.studio`
*
* Keep in mind that when fallback origin is used, Sanity Create will used the schema types and dataset in the *deployed* Studio,
* not from localhost.
*
* To see data synced from Sanity Create in your localhost Studio, you must ensure that the deployed fallback studio uses the same
* workspace and schemas as your local configuration.
*
* @see #startInCreateEnabled
*/
fallbackStudioOrigin?: string
}
/**
* Config for the history events API .
*
* If enabled, it will use the new events API to fetch document history.
*
* If it is not enabled, it will continue using the legacy Timeline.
*/
eventsAPI?: {
documents?: boolean
releases?: boolean
}
}
/**
* Props for rendering a Portable Text annotation
*
* @public
* @remarks If you want to render a mix of the annotated text and non-text content, you have to attribute
* the non-text containers with `contentEditable={false}`. See the second example.
* @example Simple example of customizing the annotation text to render yellow.
* ```ts
* (props: BlockAnnotationProps) =>
* props.renderDefault({
* ...props,
* textElement: <span style={{color: 'yellow'}}>{props.textElement}</span>,
* })
* ```
* @example Simple example of rendering the annotation with a custom modal for editing.
* Note that the form content container is attributed as `contentEditable={false}`.
* This is to signal to the text editor that this content isn't part of the editable text.
* ```ts
* (props: BlockAnnotationProps) => {
* return (
* <>
* // Render the annotated text
* <span onClick={props.onOpen}>
* {props.textElement}
* </span>
* // Render the editing form if the object is opened
* {props.open && (
* <Dialog
* contentEditable={false} // Attribute this as non-editable to the text editor
* header={`Edit ${props.schemaType.title}`}
* id={`dialog-${props.value._key}`}
* onClickOutside={props.onClose}
* onClose={props.onClose}
* >
* <Box margin={2} padding={2}>
* {props.children}
* </Box>
* </Dialog>
* )}
* </>
* )
* }
* ```
* */
declare interface BlockAnnotationProps {
/**
* Boundary element of the floating toolbar element.
*/
__unstable_floatingBoundary: HTMLElement | null
/**
* Boundary element where the text for this annotation appears.
*/
__unstable_referenceBoundary: HTMLElement | null
/**
* DOM element for the annotated text.
*/
__unstable_referenceElement: HTMLElement | null
/**
* Wether the annotated text node has editor focus.
* @remarks differs from `focused` which is wether the annotation object has form focus.
*/
__unstable_textElementFocus?: boolean
/**
* The input form for the annotation object.
* @remarks If you wrap this in something, you must make sure to put `contentEditable={false}` on the root container.
* Otherwise the editor will think content is part of the editable text and will error.
*/
children: ReactNode
/**
* If the editor form for this annotation object currently have form focus.
*/
focused: boolean
/**
* Markers (meta data) connected to this annotation.
* @deprecated - use `renderBlock` and `renderInlineBlock` interfaces instead
*/
markers: PortableTextMarker[]
/**
* Closes the editing form connected to this annotation.
*/
onClose: () => void
/**
* Opens the editing form connected to this annotation.
*/
onOpen: () => void
/**
* Focus a form node in the object for this annotation.
* @param path - the relative path to the form node to put focus on.
*/
onPathFocus: (path: Path) => void
/**
* Removes the annotation object from the text.
*/
onRemove: () => void
/**
* If the annotation is currently opened for editing.
*/
open: boolean
/**
* The parent schema type. For annotations this this the block type.
*/
parentSchemaType: SchemaType
/**
* The full form path to this annotation from document root.
*/
path: Path
/**
* Form presence for this annotation.
*/
presence: FormNodePresence[]
/**
* Is the annotation object read only?
*/
readOnly: boolean
/**
* Plugin chain render callback.
*/
renderAnnotation?: RenderAnnotationCallback
/**
* Plugin chain render callback.
*/
renderBlock?: RenderBlockCallback
/**
* Plugin chain render callback.
*/
renderDefault: (props: BlockAnnotationProps) => React.JSX.Element
/**
* Plugin chain render callback.
*/
renderField: RenderFieldCallback
/**
* Plugin chain render callback.
*/
renderInlineBlock?: RenderBlockCallback
/**
* Plugin chain render callback.
*/
renderInput: RenderInputCallback
/**
* Plugin chain render callback.
*/
renderItem: RenderArrayOfObjectsItemCallback
/**
* Plugin chain render callback.
*/
renderPreview: RenderPreviewCallback
/**
* The schema type for the annotation object.
*/
schemaType: ObjectSchemaType & {
i18nTitleKey?: string
}
/**
* If the annotated text currently is selected by the user.
*/
selected: boolean
/**
* React element of the text that is being annotated.
*/
textElement: React.JSX.Element
/**
* Form validation for the annotation object.
*/
validation: FormNodeValidation[]
/**
* Value of the annotation object.
*/
value: PortableTextObject
}
/**
* Props for rendering a Portable Text block
*
* @public
*/
declare interface BlockProps {
/**
* Boundary element of the floating toolbar element.
*/
__unstable_floatingBoundary: HTMLElement | null
/**
* Boundary element for the block.
*/
__unstable_referenceBoundary: HTMLElement | null
/**
* DOM element for the block.
*/
__unstable_referenceElement: HTMLElement | null
/**
* The default rendering of the block (the text).
*/
children: ReactNode
/**
* If the block currently is focused by the user.
*/
focused: boolean
/**
* Markers (meta data) connected to this annotation.
* @deprecated - use `renderBlock` and `renderInlineBlock` interfaces instead
*/
markers: PortableTextMarker[]
/**
* Closes the editing form connected to this block.
* For regular text blocks this is not relevant.
*/
onClose: () => void
/**
* Opens the editing form connected to this block.
* For regular text blocks this is not relevant.
*/
onOpen: () => void
/**
* Focus a form node in this block.
* @param path - the relative path to the form node to put focus on.
*/
onPathFocus: (path: Path) => void
/**
* Removes the block.
*/
onRemove: () => void
/**
* If the block is currently opened for editing.
*/
open: boolean
/**
* The parent schema type (array type).
*/
parentSchemaType: ArraySchemaType | ObjectSchemaType
/**
* The full form path to this block from document root.
*/
path: Path
/**
* Form presence for this block.
*/
presence: FormNodePresence[]
/**
* Is the block object read only?
*/
readOnly: boolean
/**
* Plugin chain render callback.
*/
renderAnnotation?: RenderAnnotationCallback
/**
* Plugin chain render callback.
*/
renderBlock?: RenderBlockCallback
/**
* Plugin chain render callback (default rendering function of the block).
*/
renderDefault: (props: BlockProps) => React.JSX.Element
/**
* Plugin chain render callback.
*/
renderField: RenderFieldCallback
/**
* Plugin chain render callback.
*/
renderInlineBlock?: RenderBlockCallback
/**
* Plugin chain render callback.
*/
renderInput: RenderInputCallback
/**
* Plugin chain render callback.
*/
renderItem: RenderArrayOfObjectsItemCallback
/**
* Plugin chain render callback.
*/
renderPreview: RenderPreviewCallback
/**
* The schema type for the block.
*/
schemaType: ObjectSchemaType
/**
* If the block is in the user's selection.
*/
selected: boolean
/**
* Form validation for the block object.
*/
validation: FormNodeValidation[]
/**
* Value of the block.
*/
value: PortableTextBlock
}
/**
* @hidden
* @public */
declare interface BooleanFieldProps extends BaseFieldProps {
schemaType: BooleanSchemaType
value: boolean | undefined
inputProps: BooleanInputProps
}
/** @public */
declare type BooleanFormNode<S extends BooleanSchemaType = BooleanSchemaType> = BaseFormNode<
boolean,
S
>
/**
* @hidden
* @public */
declare interface BooleanInputProps<S extends BooleanSchemaType = BooleanSchemaType>
extends BaseInputProps,
BooleanFormNode<S> {
/**
* @hidden
* @beta */
onChange: (patch: FormPatch | FormPatch[] | PatchEvent) => void
/**
* A shorthand aggregation of any validation errors the input currently have
* Will be falsey if no error.
* In the case of multiple errors it will be a newline delimited string of each error message
* For advanced use cases use the ´validation´ prop which contains more levels and details
*/
validationError?: string
/**
* @hidden
* @beta */
elementProps: PrimitiveInputElementProps
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type BuildableComponent = BuildableComponent_2
/**
* Interface for buildable component
*
* @public
*/
declare interface BuildableComponent_2 extends Partial<StructureNode_2> {
/** Component of type {@link UserComponent} */
component?: UserComponent_2
/** Component child of type {@link Child} */
child?: Child_2
/** Component options */
options?: {
[key: string]: unknown
}
/** Component menu items. See {@link MenuItem} and {@link MenuItemBuilder} */
menuItems?: (MenuItem_2 | MenuItemBuilder_2)[]
/** Component menu item groups. See {@link MenuItemGroup} and {@link MenuItemGroupBuilder} */
menuItemGroups?: (MenuItemGroup_2 | MenuItemGroupBuilder_2)[]
canHandleIntent?: IntentChecker_2
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type BuildableGenericList = BuildableGenericList_2
/**
* Interface for buildable generic list
*
* @public
*/
declare interface BuildableGenericList_2 extends Partial<BaseGenericList_2> {
/** List menu items array. See {@link MenuItem} and {@link MenuItemBuilder} */
menuItems?: (MenuItem_2 | MenuItemBuilder_2)[]
/** List menu items groups array. See {@link MenuItemGroup} and {@link MenuItemGroupBuilder} */
menuItemGroups?: (MenuItemGroup_2 | MenuItemGroupBuilder_2)[]
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type BuildableList = BuildableList_2
/**
* Interface for buildable list
*
* @public
*/
declare interface BuildableList_2 extends BuildableGenericList_2 {
/** List items. See {@link ListItem}, {@link ListItemBuilder} and {@link Divider} */
items?: (ListItem_2 | ListItemBuilder_2 | Divider_2 | DividerBuilder)[]
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type Builder = Builder_2
/** @internal */
declare type Builder_2 =
| CollectionBuilder_2
| ComponentBuilder_2
| DocumentBuilder_2
| DocumentListBuilder_2
| DocumentListItemBuilder_2
| ListItemBuilder_2
| MenuItemBuilder_2
| MenuItemGroupBuilder_2
| InitialValueTemplateItemBuilder_2
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type Child = Child_2
/**
* Child of a structure node
* See {@link Collection}, {@link CollectionBuilder} and {@link ChildResolver}
*
* @public
*/
declare type Child_2 = Collection_2 | CollectionBuilder_2 | ChildResolver_2
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type ChildLinkProps = ChildLinkProps_2
/**
* @hidden
* @beta */
declare interface ChildLinkProps_2 {
childId: string
childParameters?: Record<string, string>
childPayload?: unknown
children?: ReactNode
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type ChildObservable = ChildObservable_2
/**
* Interface for child observable
*
* @public
*/
declare interface ChildObservable_2 {
/** Subscribes to the child observable. See {@link ItemChild} */
subscribe: (child: ItemChild_2 | Promise<ItemChild_2>) => Record<string, unknown>
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type ChildResolver = ChildResolver_2
/**
* Interface for child resolver
*
* @public */
declare interface ChildResolver_2 {
(
itemId: string,
options: ChildResolverOptions_2,
): ItemChild_2 | Promise<ItemChild_2> | ChildObservable_2 | Observable<ItemChild_2> | undefined
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type ChildResolverOptions = ChildResolverOptions_2
/**
* Interface for child resolver options
*
* @public
*/
declare interface ChildResolverOptions_2 {
/** Child parent */
parent: unknown
/** Child index */
index: number
splitIndex: number
/** Child path */
path: string[]
/** Child parameters */
params: Record<string, string | undefined>
/** Structure context. See {@link StructureContext} */
structureContext: StructureContext_2
/** Serialize options. See {@link SerializeOptions} */
serializeOptions?: SerializeOptions_2
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type Collection = Collection_2
/**
* Collection
* See {@link List}, {@link DocumentList}, {@link EditorNode}, {@link DocumentNode} and {@link Component}
*
* @public
*/
declare type Collection_2 = List_2 | DocumentList_2 | EditorNode_2 | DocumentNode_2 | Component_2
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type CollectionBuilder = CollectionBuilder_2
/**
* Collection builder
* See {@link ListBuilder}, {@link DocumentListBuilder}, {@link DocumentTypeListBuilder}, {@link DocumentBuilder} and {@link ComponentBuilder}
*
* @public
*/
declare type CollectionBuilder_2 =
| ListBuilder_2
| DocumentListBuilder_2
| DocumentTypeListBuilder_2
| DocumentBuilder_2
| ComponentBuilder_2
/**
* @hidden
* @beta */
declare interface ComplexElementProps {
'id': string
'onFocus': FocusEventHandler
'onBlur': FocusEventHandler
'ref': MutableRefObject<any>
'aria-describedby': string | undefined
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type Component = Component_2
/**
* @deprecated Import from `sanity/structure` instead!
* @hidden
* @beta
*/
export declare const component: (
componentOrSpec?: UserViewComponent_2 | Partial<ComponentView_2>,
) => ComponentViewBuilder_2
/**
* Interface for component
*
* @public
*/
declare interface Component_2 extends StructureNode_2 {
/** Component of type {@link UserComponent} */
component: UserComponent_2
/** Component child of type {@link Child} */
child?: Child_2
/** Component menu items, array of type {@link MenuItem} */
menuItems: MenuItem_2[]
/** Component menu item group, array of type {@link MenuItemGroup} */
menuItemGroups: MenuItemGroup_2[]
/** Component options */
options: {
[key: string]: unknown
}
canHandleIntent?: IntentChecker_2
}
/**
* @deprecated Import from `sanity/structure` instead!
* @hidden
* @beta
*/
export declare const ComponentBuilder: typeof ComponentBuilder_2
/**
* Class for building components
*
* @public
*/
declare class ComponentBuilder_2 implements Serializable<Component_2> {
/** component builder option object */
protected spec: BuildableComponent_2
constructor(spec?: ComponentInput_2)
/** Set Component ID
* @param id - component ID
* @returns component builder based on ID provided
*/
id(id: string): ComponentBuilder_2
/** Get ID
* @returns ID
*/
getId(): BuildableComponent_2['id']
/** Set Component title
* @param title - component title
* @returns component builder based on title provided (and ID)
*/
title(title: string): ComponentBuilder_2
/** Get Component title
* @returns title
*/
getTitle(): BuildableComponent_2['title']
/** Set the i18n key and namespace used to populate the localized title.
* @param i18n - the key and namespaced used to populate the localized title.
* @returns component builder based on i18n key and ns provided
*/
i18n(i18n: I18nTextRecord<'title'>): ComponentBuilder_2
/** Get i18n key and namespace used to populate the localized title
* @returns the i18n key and namespace used to populate the localized title
*/
getI18n(): I18nTextRecord<'title'> | undefined
/** Set Component child
* @param child - child component
* @returns component builder based on child component provided
*/
child(child: Child_2): ComponentBuilder_2
/** Get Component child
* @returns child component
*/
getChild(): BuildableComponent_2['child']
/** Set component
* @param component - user built component
* @returns component builder based on component provided
*/
component(component: UserComponent_2): ComponentBuilder_2
/** Get Component
* @returns component
*/
getComponent(): BuildableComponent_2['component']
/** Set Component options
* @param options - component options
* @returns component builder based on options provided
*/
options(options: {[key: string]: unknown}): ComponentBuilder_2
/** Get Component options
* @returns component options
*/
getOptions(): NonNullable<BuildableComponent_2['options']>
/** Set Component menu items
* @param menuItems - component menu items
* @returns component builder based on menuItems provided
*/
menuItems(menuItems: (MenuItem_2 | MenuItemBuilder_2)[]): ComponentBuilder_2
/** Get Component menu items
* @returns menu items
*/
getMenuItems(): BuildableComponent_2['menuItems']
/** Set Component menu item groups
* @param menuItemGroups - component menu item groups
* @returns component builder based on menuItemGroups provided
*/
menuItemGroups(menuItemGroups: (MenuItemGroup_2 | MenuItemGroupBuilder_2)[]): ComponentBuilder_2
/** Get Component menu item groups
* @returns menu item groups
*/
getMenuItemGroups(): BuildableComponent_2['menuItemGroups']
canHandleIntent(canHandleIntent: IntentChecker_2): ComponentBuilder_2
/** Serialize component
* @param options - serialization options
* @returns component object based on path provided in options
*
*/
serialize(options?: SerializeOptions_2): Component_2
/** Clone component builder (allows for options overriding)
* @param withSpec - component builder options
* @returns cloned builder
*/
clone(withSpec?: BuildableComponent_2): ComponentBuilder_2
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type ComponentInput = ComponentInput_2
/**
* Interface for component input
*
* @public
*/
declare interface ComponentInput_2 extends StructureNode_2 {
/** Component of type {@link UserComponent} */
component: UserComponent_2
/** Component child of type {@link Child} */
child?: Child_2
/** Component options */
options?: {
[key: string]: unknown
}
/** Component menu items. See {@link MenuItem} and {@link MenuItemBuilder} */
menuItems?: (MenuItem_2 | MenuItemBuilder_2)[]
/** Component menu item groups. See {@link MenuItemGroup} and {@link MenuItemGroupBuilder} */
menuItemGroups?: (MenuItemGroup_2 | MenuItemGroupBuilder_2)[]
}
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type ComponentView = ComponentView_2
/**
* Interface for component views.
*
* @public */
declare interface ComponentView_2<TOptions = Record<string, any>> extends BaseView_2 {
type: 'component'
/** Component view components. See {@link UserViewComponent} */
component: UserViewComponent_2
/** Component view options */
options: TOptions
}
/**
* @deprecated Import from `sanity/structure` instead!
* @hidden
* @beta
*/
export declare const ComponentViewBuilder: typeof ComponentViewBuilder_2
/**
* Class for building a component view.
*
* @public */
declare class ComponentViewBuilder_2 extends GenericViewBuilder_2<
Partial<ComponentView_2>,
ComponentViewBuilder_2
> {
/** Partial Component view option object. See {@link ComponentView} */
protected spec: Partial<ComponentView_2>
constructor(
/**
* Component view component or spec
* @param componentOrSpec - user view component or partial component view. See {@link UserViewComponent} and {@link ComponentView}
*/
componentOrSpec?: UserViewComponent_2 | Partial<ComponentView_2>,
)
/** Set view Component
* @param component - component view component. See {@link UserViewComponent}
* @returns component view builder based on component view provided. See {@link ComponentViewBuilder}
*/
component(component: UserViewComponent_2): ComponentViewBuilder_2
/** Get view Component
* @returns Partial component view. See {@link ComponentView}
*/
getComponent(): Partial<ComponentView_2>['component']
/** Set view Component options
* @param options - component view options
* @returns component view builder based on options provided. See {@link ComponentViewBuilder}
*/
options(options: {[key: string]: any}): ComponentViewBuilder_2
/** Get view Component options
* @returns component view options. See {@link ComponentView}
*/
getOptions(): ComponentView_2['options']
/** Serialize view Component
* @param options - serialization options. See {@link SerializeOptions}
* @returns component view based on path provided in options. See {@link ComponentView}
*
*/
serialize(options?: SerializeOptions_2): ComponentView_2
/** Clone Component view builder (allows for options overriding)
* @param withSpec - partial for component view option. See {@link ComponentView}
* @returns component view builder. See {@link ComponentViewBuilder}
*/
clone(withSpec?: Partial<ComponentView_2>): ComponentViewBuilder_2
}
/** @public */
declare type ComposableOption<TValue, TContext> = (prev: TValue, context: TContext) => TValue
/** @public */
declare interface ConfigContext_2 {
/**
* The ID of the project.
*/
projectId: string
/**
* The name of the dataset.
*/
dataset: string
/**
* The schema for this source.
*/
schema: Schema
/**
* The current user or `null` if not authenticated.
*/
currentUser: CurrentUser | null
/**
* A function that returns a Sanity client with the {@link SourceClientOptions | specified options}.
*/
getClient: (options: SourceClientOptions) => SanityClient
/**
* Localization resources
*/
i18n: LocaleSource_2
}
/**
* @deprecated Import from `sanity/structure` instead!
* @hidden
* @beta
*/
export declare const ConfirmDeleteDialog: typeof ConfirmDeleteDialogContainer
/** @internal */
declare function ConfirmDeleteDialogContainer(props: ConfirmDeleteDialogProps_2): JSX.Element
/**
* @deprecated Import from `sanity/structure` instead
* @hidden
* @beta
*/
export declare type ConfirmDeleteDialogProps = ConfirmDeleteDialogProps_2
/** @internal */
declare interface