UNPKG

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
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