@portabletext/editor 7.10.19 → 7.11.0

package/lib/{behavior.types.action-CYtiRDck.d.ts → behavior.types.action-DXkAaEGS.d.ts}

@@ -1,5 +1,5 @@
 import React$1, { BaseSyntheticEvent, ClipboardEvent as ClipboardEvent$1, FocusEvent, JSX, PropsWithChildren, ReactElement, RefObject, TextareaHTMLAttributes } from "react";
-import { AnnotationDefinition, AnnotationSchemaType, AnnotationSchemaType as AnnotationSchemaType$1, BaseDefinition, BlockObjectDefinition, BlockObjectSchemaType, BlockObjectSchemaType as BlockObjectSchemaType$1, DecoratorDefinition, DecoratorSchemaType, DecoratorSchemaType as DecoratorSchemaType$1, FieldDefinition, FieldDefinition as FieldDefinition$1, InlineObjectDefinition, InlineObjectSchemaType, InlineObjectSchemaType as InlineObjectSchemaType$1, ListDefinition, ListSchemaType, ListSchemaType as ListSchemaType$1, OfDefinition, PortableTextBlock, PortableTextBlock as PortableTextBlock$1, PortableTextChild, PortableTextChild as PortableTextChild$1, PortableTextObject, PortableTextObject as PortableTextObject$1, PortableTextSpan, PortableTextSpan as PortableTextSpan$1, PortableTextTextBlock, PortableTextTextBlock as PortableTextTextBlock$1, Schema, SchemaDefinition, SchemaDefinition as SchemaDefinition$1, StyleDefinition, StyleSchemaType, StyleSchemaType as StyleSchemaType$1, TypedObject, defineSchema } from "@portabletext/schema";
+import { AnnotationDefinition, AnnotationSchemaType, AnnotationSchemaType as AnnotationSchemaType$1, BaseDefinition, BlockObjectDefinition, BlockObjectSchemaType, BlockObjectSchemaType as BlockObjectSchemaType$1, DecoratorDefinition, DecoratorSchemaType, DecoratorSchemaType as DecoratorSchemaType$1, FieldDefinition, FieldDefinition as FieldDefinition$1, InlineObjectDefinition, InlineObjectSchemaType, InlineObjectSchemaType as InlineObjectSchemaType$1, ListDefinition, ListSchemaType, ListSchemaType as ListSchemaType$1, OfDefinition, OfDefinition as OfDefinition$1, PortableTextBlock, PortableTextBlock as PortableTextBlock$1, PortableTextChild, PortableTextChild as PortableTextChild$1, PortableTextObject, PortableTextObject as PortableTextObject$1, PortableTextSpan, PortableTextSpan as PortableTextSpan$1, PortableTextTextBlock, PortableTextTextBlock as PortableTextTextBlock$1, Schema, SchemaDefinition, SchemaDefinition as SchemaDefinition$1, StyleDefinition, StyleSchemaType, StyleSchemaType as StyleSchemaType$1, TypedObject, defineSchema } from "@portabletext/schema";
 import { ActorRefFrom } from "xstate";
 import { Patch, Patch as Patch$1 } from "@portabletext/patches";
 type MIMEType = `${string}/${string}`;
@@ -94,15 +94,7 @@ type AnnotationPath = Path;
  */
 type ChildPath = Path;
 /**
- * @alpha
- *
- * Narrow the container node type by the registered `_type`. Containers
- * always render portable text objects: `'span'` is always a leaf and
- * `'block'` is always a text block; both are excluded.
- */
-type ContainerNodeForType<TType extends string> = TType extends 'span' | 'block' ? never : PortableTextObject;
-/**
- * @alpha
+ * @public
  *
  * A container's render function receives a node and renders an element
  * that wraps its editable children. The render is positional: it fires for
@@ -136,11 +128,11 @@ type ContainerRenderProps = {
   renderDefault: (props: ContainerRenderProps) => ReactElement;
 };
 /**
- * @alpha
+ * @public
  */
 type ContainerRender = (props: ContainerRenderProps) => ReactElement;
 /**
- * @alpha
+ * @public
  *
  * A span's render function. Receives a portable text span node and
  * wraps it. `children` carries the styled text already decorated by
@@ -161,11 +153,11 @@ type SpanRenderProps = {
   renderDefault: (props: SpanRenderProps) => ReactElement;
 };
 /**
- * @alpha
+ * @public
  */
 type SpanRender = (props: SpanRenderProps) => ReactElement;
 /**
- * @alpha
+ * @public
  *
  * A block object's render function. Receives a non-editable block-level
  * portable text object. `children` carries an engine-emitted void
@@ -188,11 +180,11 @@ type BlockObjectRenderProps = {
   renderDefault: (props: BlockObjectRenderProps) => ReactElement;
 };
 /**
- * @alpha
+ * @public
  */
 type BlockObjectRender = (props: BlockObjectRenderProps) => ReactElement;
 /**
- * @alpha
+ * @public
  *
  * An inline object's render function. Receives a non-editable inline
  * portable text object. `children` carries an engine-emitted void
@@ -215,11 +207,11 @@ type InlineObjectRenderProps = {
   renderDefault: (props: InlineObjectRenderProps) => ReactElement;
 };
 /**
- * @alpha
+ * @public
  */
 type InlineObjectRender = (props: InlineObjectRenderProps) => ReactElement;
 /**
- * @alpha
+ * @public
  *
  * A container registration. Identifies a block object `_type` whose value
  * holds editable children in `arrayField`. The optional `of` array carries
@@ -250,7 +242,7 @@ type Container = {
   of?: ReadonlyArray<Container | TextBlock | BlockObject>;
 };
 /**
- * @alpha
+ * @public
  *
  * A text block registration. The text block `_type` is `'block'` at the
  * top level. Positional overrides nested in a container's `of` array can
@@ -286,7 +278,7 @@ type TextBlock = {
   of?: ReadonlyArray<Span | InlineObject>;
 };
 /**
- * @alpha
+ * @public
  *
  * Text block render function. `children` carries the rendered spans -
  * `renderDecorator`, `renderAnnotation`, `renderPlaceholder`, and range
@@ -309,11 +301,11 @@ type TextBlockRenderProps = {
   renderDefault: (props: TextBlockRenderProps) => ReactElement;
 };
 /**
- * @alpha
+ * @public
  */
 type TextBlockRender = (props: TextBlockRenderProps) => ReactElement;
 /**
- * @alpha
+ * @public
  *
  * A span registration. The span `_type` is `'span'` at the top level.
  * Positional overrides nested in a container's `of` array can register
@@ -332,7 +324,7 @@ type Span = {
   render?: SpanRender;
 };
 /**
- * @alpha
+ * @public
  *
  * A non-editable block-level object registration. Identifies a `_type`
  * whose value renders as a block-level void node (image, embed, etc.).
@@ -349,7 +341,7 @@ type BlockObject = {
   render?: BlockObjectRender;
 };
 /**
- * @alpha
+ * @public
  *
  * A non-editable inline object registration. Identifies a `_type` whose
  * value renders as an inline void node (mention, inline image, etc.).
@@ -366,14 +358,14 @@ type InlineObject = {
   render?: InlineObjectRender;
 };
 /**
- * @alpha
+ * @public
  *
  * The discriminated union of every registration accepted by
  * `editor.registerNode` and the `<NodePlugin>` component.
  */
 type RegistrableNode = Container | TextBlock | Span | BlockObject | InlineObject;
 /**
- * @alpha
+ * @public
  *
  * Define a container renderer. The returned registration is mounted via
  * the `<NodePlugin>` component at the top level, or nested inside
@@ -411,7 +403,7 @@ declare function defineContainer<const TType extends string>(config: {
     attributes: Record<string, unknown>;
     children: ReactElement;
     focused: boolean;
-    node: ContainerNodeForType<TType>;
+    node: TType extends 'span' | 'block' ? never : PortableTextObject;
     path: Path;
     readOnly: boolean;
     selected: boolean;
@@ -420,7 +412,7 @@ declare function defineContainer<const TType extends string>(config: {
   of?: ReadonlyArray<Container | TextBlock | BlockObject>;
 }): Container;
 /**
- * @alpha
+ * @public
  *
  * Define a span renderer. The returned registration is mounted via the
  * `<NodePlugin>` component at the top level, or nested inside a
@@ -446,7 +438,7 @@ declare function defineSpan<const TType extends string>(config: {
   render?: SpanRender;
 }): Span;
 /**
- * @alpha
+ * @public
  *
  * Define a non-editable block-level object renderer for a `_type`
  * declared in the schema's `blockObjects` array.
@@ -474,7 +466,7 @@ declare function defineBlockObject<const TType extends string>(config: {
   render?: BlockObjectRender;
 }): BlockObject;
 /**
- * @alpha
+ * @public
  *
  * Define a non-editable inline object renderer for a `_type` declared
  * in the schema's `inlineObjects` array.
@@ -502,7 +494,7 @@ declare function defineInlineObject<const TType extends string>(config: {
   render?: InlineObjectRender;
 }): InlineObject;
 /**
- * @alpha
+ * @public
  *
  * Define a text block renderer. The returned registration is mounted
  * via the `<NodePlugin>` component, or nested inside a container's
@@ -575,10 +567,6 @@ type TextBlockConfig = {
   textBlock: TextBlock;
   of?: ReadonlyArray<SpanConfig | InlineObjectConfig>;
 };
-type ChildArrayField = FieldDefinition & {
-  type: 'array';
-  of: ReadonlyArray<OfDefinition>;
-};
 /**
  * Public view of a registered editable container, surfaced on
  * {@link EditorContext.containers}.
@@ -597,8 +585,8 @@ type ChildArrayField = FieldDefinition & {
  *   scoped to this parent.
  *
  * The full container registration (including the render callback)
- * lives on the editor's internal {@link ResolvedContainers} map and
- * is not exposed on the public context.
+ * lives on an engine-internal map and is not exposed on the public
+ * context.
  *
  * Two top-level entries with the same `_type` cannot coexist - the
  * register handler warns on duplicates. But the SAME `_type`
@@ -606,20 +594,24 @@ type ChildArrayField = FieldDefinition & {
  * a feature; `resolveContainerAt` walks the positional tree using
  * the path to return the entry that applies at a given position.
  *
- * @alpha
+ * @public
  */
 type RegisteredContainer = {
   kind: 'container';
   type: string;
-  field: ChildArrayField;
+  field: FieldDefinition & {
+    type: 'array';
+    of: ReadonlyArray<OfDefinition>;
+  };
   of?: ReadonlyArray<RegisteredContainer | RegisteredPositional>;
 };
+type ChildArrayField = RegisteredContainer['field'];
 /**
  * Public view of a registered span, surfaced inside a containing
  * {@link RegisteredContainer}'s `of` array as a positional
  * registration. The render function is engine-internal.
  *
- * @alpha
+ * @public
  */
 type RegisteredSpan = {
   kind: 'span';
@@ -630,7 +622,7 @@ type RegisteredSpan = {
  * containing {@link RegisteredContainer}'s `of` array as a positional
  * registration. The render function is engine-internal.
  *
- * @alpha
+ * @public
  */
 type RegisteredBlockObject = {
   kind: 'blockObject';
@@ -641,7 +633,7 @@ type RegisteredBlockObject = {
  * containing {@link RegisteredContainer}'s `of` array as a positional
  * registration. The render function is engine-internal.
  *
- * @alpha
+ * @public
  */
 type RegisteredInlineObject = {
   kind: 'inlineObject';
@@ -650,10 +642,9 @@ type RegisteredInlineObject = {
 /**
  * Union of non-container positional registrations that may appear in
  * a {@link RegisteredContainer}'s `of` array. Text-block registrations
- * are NOT included here; they surface on `EditorContext.textBlocks`,
- * not on the containers tree.
+ * are NOT included here and do not appear on the containers tree.
  *
- * @alpha
+ * @public
  */
 type RegisteredPositional = RegisteredSpan | RegisteredBlockObject | RegisteredInlineObject;
 /**
@@ -673,7 +664,7 @@ type RegisteredPositional = RegisteredSpan | RegisteredBlockObject | RegisteredI
  * does not find a positional override, the resolver falls back to the
  * top-level entry for the type if one is registered.
  *
- * @alpha
+ * @public
  */
 type Containers = ReadonlyMap<string, RegisteredContainer>;
 /**
@@ -1138,11 +1129,34 @@ type PortableTextEditableProps = Omit<TextareaHTMLAttributes<HTMLDivElement>, 'o
   onCopy?: OnCopyFn;
   rangeDecorations?: RangeDecoration[];
   renderAnnotation?: RenderAnnotationFunction;
+  /**
+   * @deprecated Register your block objects and text blocks with
+   * `defineBlockObject` / `defineTextBlock` mounted through `NodePlugin`
+   * instead. See the migration guide:
+   * https://www.portabletext.org/editor/guides/migrate-render-props/
+   */
   renderBlock?: RenderBlockFunction;
+  /**
+   * @deprecated Register your inline objects and spans with
+   * `defineInlineObject` / `defineSpan` mounted through `NodePlugin`
+   * instead. See the migration guide:
+   * https://www.portabletext.org/editor/guides/migrate-render-props/
+   */
   renderChild?: RenderChildFunction;
   renderDecorator?: RenderDecoratorFunction;
+  /**
+   * @deprecated Render list items with `defineTextBlock` mounted through
+   * `NodePlugin`, with list numbering from
+   * `@portabletext/plugin-list-index`. See the migration guide:
+   * https://www.portabletext.org/editor/guides/migrate-render-props/
+   */
   renderListItem?: RenderListItemFunction;
   renderPlaceholder?: RenderPlaceholderFunction;
+  /**
+   * @deprecated Render text-block styles with `defineTextBlock` mounted
+   * through `NodePlugin` instead. See the migration guide:
+   * https://www.portabletext.org/editor/guides/migrate-render-props/
+   */
   renderStyle?: RenderStyleFunction;
   scrollSelectionIntoView?: ScrollSelectionIntoViewFunction;
   selection?: EditorSelection;
@@ -1169,7 +1183,12 @@ type PortableTextEditableProps = Omit<TextareaHTMLAttributes<HTMLDivElement>, 'o
  * @group Components
  */
 declare const PortableTextEditable: import("react").ForwardRefExoticComponent<Omit<PortableTextEditableProps, "ref"> & import("react").RefAttributes<Omit<HTMLDivElement, "as" | "onPaste" | "onBeforeInput">>>;
-/** @beta */
+/**
+ * @beta
+ * @deprecated `EditableAPIDeleteOptions` is deprecated together with the
+ * `PortableTextEditor.delete` static. Send a `delete` behavior event (with
+ * an optional `unit`) or a `delete.block` event via `editor.send` instead.
+ */
 interface EditableAPIDeleteOptions {
   mode?: 'blocks' | 'children' | 'selected';
 }
@@ -1190,7 +1209,7 @@ type AddedAnnotationPaths = {
    */
   spanPath: Path;
 };
-/** @beta */
+/** @internal */
 interface EditableAPI {
   activeAnnotations: () => PortableTextObject[];
   isAnnotationActive: (annotationType: PortableTextObject['_type']) => boolean;
@@ -1251,7 +1270,7 @@ type EditorSelection = {
 } | null;
 /**
  * The editor has invalid data in the value that can be resolved by the user
- * @beta */
+ * @public */
 type InvalidValueResolution = {
   autoResolve?: boolean;
   patches: Patch[];
@@ -1296,7 +1315,14 @@ interface PasteData {
 type OnPasteFn = (data: PasteData) => OnPasteResultOrPromise;
 /** @beta */
 type OnCopyFn = (event: ClipboardEvent$1<HTMLDivElement | HTMLSpanElement>) => undefined | unknown;
-/** @beta */
+/**
+ * @beta
+ * @deprecated `BlockRenderProps` is deprecated together with the
+ * `renderBlock` render prop it serves. Type against
+ * `BlockObjectRenderProps` / `TextBlockRenderProps` from the node
+ * registration API instead. See the migration guide:
+ * https://www.portabletext.org/editor/guides/migrate-render-props/
+ */
 interface BlockRenderProps {
   children: ReactElement<any>;
   editorElementRef: RefObject<HTMLElement | null>;
@@ -1309,7 +1335,14 @@ interface BlockRenderProps {
   schemaType: BlockObjectSchemaType;
   value: PortableTextBlock;
 }
-/** @beta */
+/**
+ * @beta
+ * @deprecated `BlockChildRenderProps` is deprecated together with the
+ * `renderChild` render prop it serves. Type against
+ * `InlineObjectRenderProps` / `SpanRenderProps` from the node
+ * registration API instead. See the migration guide:
+ * https://www.portabletext.org/editor/guides/migrate-render-props/
+ */
 interface BlockChildRenderProps {
   annotations: PortableTextObject[];
   children: ReactElement<any>;
@@ -1341,7 +1374,14 @@ interface BlockDecoratorRenderProps {
   selected: boolean;
   value: string;
 }
-/** @beta */
+/**
+ * @beta
+ * @deprecated `BlockListItemRenderProps` is deprecated together with the
+ * `renderListItem` render prop it serves. Render list items with
+ * `defineTextBlock` mounted through `NodePlugin` instead. See the
+ * migration guide:
+ * https://www.portabletext.org/editor/guides/migrate-render-props/
+ */
 interface BlockListItemRenderProps {
   block: PortableTextTextBlock;
   children: ReactElement<any>;
@@ -1353,19 +1393,45 @@ interface BlockListItemRenderProps {
   selected: boolean;
   value: string;
 }
-/** @beta */
+/**
+ * @beta
+ * @deprecated The `renderBlock` render prop is deprecated. Register your
+ * block objects and text blocks with `defineBlockObject` /
+ * `defineTextBlock` mounted through `NodePlugin` instead. See the
+ * migration guide:
+ * https://www.portabletext.org/editor/guides/migrate-render-props/
+ */
 type RenderBlockFunction = (props: BlockRenderProps) => JSX.Element;
-/** @beta */
+/**
+ * @beta
+ * @deprecated The `renderChild` render prop is deprecated. Register your
+ * inline objects and spans with `defineInlineObject` / `defineSpan`
+ * mounted through `NodePlugin` instead. See the migration guide:
+ * https://www.portabletext.org/editor/guides/migrate-render-props/
+ */
 type RenderChildFunction = (props: BlockChildRenderProps) => JSX.Element;
-/** @beta */
+/** @public */
 type RenderEditableFunction = (props: PortableTextEditableProps) => JSX.Element;
 /** @beta */
 type RenderAnnotationFunction = (props: BlockAnnotationRenderProps) => JSX.Element;
-/** @beta */
+/** @public */
 type RenderPlaceholderFunction = () => React.ReactNode;
-/** @beta */
+/**
+ * @beta
+ * @deprecated The `renderStyle` render prop is deprecated. Render
+ * text-block styles with `defineTextBlock` mounted through `NodePlugin`
+ * instead. See the migration guide:
+ * https://www.portabletext.org/editor/guides/migrate-render-props/
+ */
 type RenderStyleFunction = (props: BlockStyleRenderProps) => JSX.Element;
-/** @beta */
+/**
+ * @beta
+ * @deprecated `BlockStyleRenderProps` is deprecated together with the
+ * `renderStyle` render prop it serves. Render text-block styles with
+ * `defineTextBlock` mounted through `NodePlugin` instead. See the
+ * migration guide:
+ * https://www.portabletext.org/editor/guides/migrate-render-props/
+ */
 interface BlockStyleRenderProps {
   block: PortableTextTextBlock;
   children: ReactElement<any>;
@@ -1376,32 +1442,39 @@ interface BlockStyleRenderProps {
   schemaType: StyleSchemaType;
   value: string;
 }
-/** @beta */
+/**
+ * @beta
+ * @deprecated The `renderListItem` render prop is deprecated. Render list
+ * items with `defineTextBlock` mounted through `NodePlugin`, with list
+ * numbering from `@portabletext/plugin-list-index`. See the migration
+ * guide:
+ * https://www.portabletext.org/editor/guides/migrate-render-props/
+ */
 type RenderListItemFunction = (props: BlockListItemRenderProps) => JSX.Element;
 /** @beta */
 type RenderDecoratorFunction = (props: BlockDecoratorRenderProps) => JSX.Element;
-/** @beta */
+/** @public */
 type ScrollSelectionIntoViewFunction = (editor: PortableTextEditor, domRange: globalThis.Range) => void;
 /**
- * Parameters for the callback that will be called for a RangeDecoration's onMoved.
- * @alpha */
+ * Details passed to a `RangeDecoration`'s `onMoved` callback.
+ * @public */
 interface RangeDecorationOnMovedDetails {
   rangeDecoration: RangeDecoration;
   newSelection: EditorSelection;
   origin: 'remote' | 'local';
 }
 /**
- * A range decoration is a UI affordance that wraps a given selection range in the editor
- * with a custom component. This can be used to highlight search results,
- * mark validation errors on specific words, draw user presence and similar.
- * @alpha */
+ * A UI affordance that wraps a selection range in the editor with a custom
+ * component, for example to highlight search results, mark validation
+ * errors on specific words, or draw user presence.
+ * @public */
 interface RangeDecoration {
   /**
-   * A component for rendering the range decoration.
-   * The component will receive the children (text) of the range decoration as its children.
+   * The component that renders the range decoration. It receives the
+   * decorated text as its children.
    *
    * @example
-   * ```ts
+   * ```tsx
    * (rangeComponentProps: PropsWithChildren) => (
    *    <SearchResultHighlight>
    *      {rangeComponentProps.children}
@@ -1411,15 +1484,17 @@ interface RangeDecoration {
    */
   component: (props: PropsWithChildren) => ReactElement<any>;
   /**
-   * The editor content selection range
+   * The editor content selection range to decorate.
    */
   selection: EditorSelection;
   /**
-   * A optional callback that will be called when the range decoration potentially moves according to user edits.
+   * Called when edits move the decorated range. The details carry the new
+   * selection (`null` when the range is lost) and whether the edit was
+   * `local` or `remote`.
    */
   onMoved?: (details: RangeDecorationOnMovedDetails) => void;
   /**
-   * A custom payload that can be set on the range decoration
+   * A custom payload that can be set on the range decoration.
    */
   payload?: Record<string, unknown>;
 }
@@ -1959,7 +2034,7 @@ type EditorContext = {
    * `resolveContainerAt(containers, value, path)` for position-aware
    * resolution that handles both top-level and positional entries.
    *
-   * @alpha
+   * @public
    */
   containers: Containers;
 };
@@ -1976,7 +2051,7 @@ type EditorSnapshot = {
   decoratorState: Record<string, boolean | undefined>;
 };
 /**
- * @beta
+ * @public
  */
 type BehaviorGuard<TBehaviorEvent, TGuardResponse> = (payload: {
   snapshot: EditorSnapshot;
@@ -1984,7 +2059,7 @@ type BehaviorGuard<TBehaviorEvent, TGuardResponse> = (payload: {
   dom: EditorDom;
 }) => TGuardResponse | false;
 /**
- * @beta
+ * @public
  */
 type Behavior<TBehaviorEventType extends '*' | `${BehaviorEventTypeNamespace}.*` | BehaviorEvent['type'] = '*' | `${BehaviorEventTypeNamespace}.*` | BehaviorEvent['type'], TGuardResponse = true, TBehaviorEvent extends ResolveBehaviorEvent<TBehaviorEventType> = ResolveBehaviorEvent<TBehaviorEventType>> = {
   /**
@@ -2004,7 +2079,7 @@ type Behavior<TBehaviorEventType extends '*' | `${BehaviorEventTypeNamespace}.*`
   actions: Array<BehaviorActionSet<TBehaviorEvent, TGuardResponse>>;
 };
 /**
- * @beta
+ * @public
  *
  * @example
  *
@@ -2134,9 +2209,6 @@ type PatchEvent = {
  * @public
  */
 type EditorConfig = {
-  /**
-   * @beta
-   */
   keyGenerator?: () => string;
   readOnly?: boolean;
   initialValue?: Array<PortableTextBlock>;
@@ -2176,7 +2248,7 @@ type Editor = {
   dom: EditorDom;
   getSnapshot: () => EditorSnapshot;
   /**
-   * @beta
+   * @public
    */
   registerBehavior: (config: {
     behavior: Behavior;
@@ -2187,7 +2259,7 @@ type Editor = {
    * `defineSpan`, `defineBlockObject`, `defineInlineObject`). Returns
    * a function that unregisters the node when called.
    *
-   * @alpha
+   * @public
    */
   registerNode: (config: {
     node: RegistrableNode;
@@ -2333,7 +2405,7 @@ declare const defaultKeyGenerator: () => string;
  */
 declare function useEditor(): Editor;
 /**
- * @beta
+ * @public
  */
 type BlockOffset = {
   path: BlockPath;
@@ -2652,7 +2724,7 @@ type SpanWithOptionalKey = Omit<PortableTextSpan, '_key'> & {
 };
 type ChildWithOptionalKey = SpanWithOptionalKey | ObjectBlockWithOptionalKey;
 /**
- * @beta
+ * @public
  */
 type BehaviorEvent = SyntheticBehaviorEvent | NativeBehaviorEvent | CustomBehaviorEvent;
 type BehaviorEventTypeNamespace = SyntheticBehaviorEventNamespace | NativeBehaviorEventNamespace | CustomBehaviorEventNamespace;
@@ -2683,7 +2755,7 @@ declare const syntheticBehaviorEventTypes: readonly ["annotation.add", "annotati
 type SyntheticBehaviorEventType = (typeof syntheticBehaviorEventTypes)[number] | (typeof abstractBehaviorEventTypes)[number];
 type SyntheticBehaviorEventNamespace = ExtractNamespace<SyntheticBehaviorEventType>;
 /**
- * @beta
+ * @public
  */
 type SyntheticBehaviorEvent = {
   type: StrictExtract<SyntheticBehaviorEventType, 'annotation.add'>;
@@ -2893,7 +2965,7 @@ type SyntheticBehaviorEvent = {
   at: Path;
 } | AbstractBehaviorEvent;
 /**
- * @beta
+ * @public
  */
 type InsertPlacement = 'auto' | 'after' | 'before';
 /**************************************
@@ -3043,7 +3115,7 @@ declare const nativeBehaviorEventTypes: readonly ["clipboard.copy", "clipboard.c
 type NativeBehaviorEventType = (typeof nativeBehaviorEventTypes)[number];
 type NativeBehaviorEventNamespace = ExtractNamespace<NativeBehaviorEventType>;
 /**
- * @beta
+ * @public
  */
 type NativeBehaviorEvent = ClipboardBehaviorEvent | DragBehaviorEvent | InputBehaviorEvent | KeyboardBehaviorEvent | MouseBehaviorEvent;
 type ClipboardBehaviorEvent = {
@@ -3143,7 +3215,7 @@ type MouseBehaviorEvent = {
 type CustomBehaviorEventNamespace = 'custom';
 type CustomBehaviorEventType<TNamespace extends CustomBehaviorEventNamespace, TType extends string = ''> = TType extends '' ? `${TNamespace}` : `${TNamespace}.${TType}`;
 /**
- * @beta
+ * @public
  */
 type CustomBehaviorEvent<TPayload extends Record<string, unknown> = Record<string, unknown>, TType extends string = string, TInternalType extends CustomBehaviorEventType<'custom', TType> = CustomBehaviorEventType<'custom', TType>> = {
   type: TInternalType;
@@ -3189,7 +3261,7 @@ type EditorDom = {
   }) => void;
 };
 /**
- * @beta
+ * @public
  */
 type BehaviorAction = {
   type: 'execute';
@@ -3243,7 +3315,7 @@ type BehaviorAction = {
  * })
  * ```
  *
- * @beta
+ * @public
  */
 declare function execute(event: SyntheticBehaviorEvent): PickFromUnion<BehaviorAction, 'type', 'execute'>;
 /**
@@ -3281,7 +3353,7 @@ declare function execute(event: SyntheticBehaviorEvent): PickFromUnion<BehaviorA
  * })
  * ```
  *
- * @beta
+ * @public
  */
 declare function forward(event: NativeBehaviorEvent | SyntheticBehaviorEvent | CustomBehaviorEvent): PickFromUnion<BehaviorAction, 'type', 'forward'>;
 /**
@@ -3315,7 +3387,7 @@ declare function forward(event: NativeBehaviorEvent | SyntheticBehaviorEvent | C
  * })
  * ```
  *
- * @beta
+ * @public
  */
 declare function raise$1(event: SyntheticBehaviorEvent | CustomBehaviorEvent): PickFromUnion<BehaviorAction, 'type', 'raise'>;
 /**
@@ -3358,16 +3430,16 @@ declare function raise$1(event: SyntheticBehaviorEvent | CustomBehaviorEvent): P
  * })
  * ```
  *
- * @beta
+ * @public
  */
 declare function effect(effect: PickFromUnion<BehaviorAction, 'type', 'effect'>['effect']): PickFromUnion<BehaviorAction, 'type', 'effect'>;
 /**
- * @beta
+ * @public
  */
 type BehaviorActionSet<TBehaviorEvent, TGuardResponse> = (payload: {
   snapshot: EditorSnapshot;
   event: TBehaviorEvent;
   dom: EditorDom;
 }, guardResponse: TGuardResponse) => Array<BehaviorAction>;
-export { EditorContext as $, SpanRender as $t, PortableTextTextBlock$1 as A, HotkeyOptions as At, EditorSelector as B, RegisteredPositional as Bt, ListDefinition as C, RenderEditableFunction as Ct, PortableTextChild$1 as D, ScrollSelectionIntoViewFunction as Dt, PortableTextBlock$1 as E, RenderStyleFunction as Et, BlockOffset as F, EditorSchema as Ft, EditorConfig as G, Container as Gt, EditorProvider as H, BlockObject as Ht, useEditor as I, Containers as It, MutationEvent as J, InlineObject as Jt, EditorEvent as K, ContainerRender as Kt, defaultKeyGenerator as L, RegisteredBlockObject as Lt, StyleDefinition as M, resolveContainerAt as Mt, StyleSchemaType$1 as N, TraversalSnapshot as Nt, PortableTextObject$1 as O, PortableTextEditable as Ot, defineSchema as P, Node$1 as Pt, BehaviorGuard as Q, Span as Qt, usePortableTextEditorSelection as R, RegisteredContainer as Rt, InlineObjectSchemaType$1 as S, RenderDecoratorFunction as St, Patch$1 as T, RenderPlaceholderFunction as Tt, EditorProviderProps as U, BlockObjectRender as Ut, useEditorSelector as V, RegisteredSpan as Vt, Editor as W, BlockObjectRenderProps as Wt, Behavior as X, InlineObjectRenderProps as Xt, Operation as Y, InlineObjectRender as Yt, defineBehavior as Z, RegistrableNode as Zt, BlockObjectSchemaType$1 as _, RangeDecoration as _t, forward as a, defineContainer as an, BlockListItemRenderProps as at, FieldDefinition$1 as b, RenderBlockFunction as bt, CustomBehaviorEvent as c, defineTextBlock as cn, EditableAPIDeleteOptions as ct, SyntheticBehaviorEvent as d, ChildPath as dn, InvalidValueResolution as dt, SpanRenderProps as en, EditorSnapshot as et, PatchesEvent as f, KeyedSegment as fn, OnCopyFn as ft, BlockObjectDefinition as g, PasteData as gt, BaseDefinition as h, OnPasteResultOrPromise as ht, execute as i, defineBlockObject as in, BlockDecoratorRenderProps as it, SchemaDefinition$1 as j, PortableTextEditor as jt, PortableTextSpan$1 as k, PortableTextEditableProps as kt, InsertPlacement as l, AnnotationPath as ln, EditorSelection as lt, AnnotationSchemaType$1 as m, PathSegment as mn, OnPasteResult as mt, BehaviorActionSet as n, TextBlockRender as nn, BlockAnnotationRenderProps as nt, raise$1 as o, defineInlineObject as on, BlockRenderProps as ot, AnnotationDefinition as p, Path as pn, OnPasteFn as pt, EditorEmittedEvent as q, ContainerRenderProps as qt, effect as r, TextBlockRenderProps as rn, BlockChildRenderProps as rt, BehaviorEvent as s, defineSpan as sn, BlockStyleRenderProps as st, BehaviorAction as t, TextBlock as tn, AddedAnnotationPaths as tt, NativeBehaviorEvent as u, BlockPath as un, EditorSelectionPoint as ut, DecoratorDefinition as v, RangeDecorationOnMovedDetails as vt, ListSchemaType$1 as w, RenderListItemFunction as wt, InlineObjectDefinition as x, RenderChildFunction as xt, DecoratorSchemaType$1 as y, RenderAnnotationFunction as yt, usePortableTextEditor as z, RegisteredInlineObject as zt };
-//# sourceMappingURL=behavior.types.action-CYtiRDck.d.ts.map
+export { BehaviorGuard as $, Span as $t, PortableTextSpan$1 as A, PortableTextEditableProps as At, usePortableTextEditor as B, RegisteredInlineObject as Bt, ListDefinition as C, RenderDecoratorFunction as Ct, PortableTextBlock$1 as D, RenderStyleFunction as Dt, Patch$1 as E, RenderPlaceholderFunction as Et, defineSchema as F, Node$1 as Ft, Editor as G, BlockObjectRenderProps as Gt, useEditorSelector as H, RegisteredSpan as Ht, BlockOffset as I, EditorSchema as It, EditorEmittedEvent as J, ContainerRenderProps as Jt, EditorConfig as K, Container as Kt, useEditor as L, Containers as Lt, SchemaDefinition$1 as M, PortableTextEditor as Mt, StyleDefinition as N, resolveContainerAt as Nt, PortableTextChild$1 as O, ScrollSelectionIntoViewFunction as Ot, StyleSchemaType$1 as P, TraversalSnapshot as Pt, defineBehavior as Q, RegistrableNode as Qt, defaultKeyGenerator as R, RegisteredBlockObject as Rt, InlineObjectSchemaType$1 as S, RenderChildFunction as St, OfDefinition$1 as T, RenderListItemFunction as Tt, EditorProvider as U, BlockObject as Ut, EditorSelector as V, RegisteredPositional as Vt, EditorProviderProps as W, BlockObjectRender as Wt, Operation as X, InlineObjectRender as Xt, MutationEvent as Y, InlineObject as Yt, Behavior as Z, InlineObjectRenderProps as Zt, BlockObjectSchemaType$1 as _, PasteData as _t, forward as a, defineBlockObject as an, BlockDecoratorRenderProps as at, FieldDefinition$1 as b, RenderAnnotationFunction as bt, CustomBehaviorEvent as c, defineSpan as cn, BlockStyleRenderProps as ct, SyntheticBehaviorEvent as d, BlockPath as dn, EditorSelectionPoint as dt, SpanRender as en, EditorContext as et, PatchesEvent as f, ChildPath as fn, InvalidValueResolution as ft, BlockObjectDefinition as g, OnPasteResultOrPromise as gt, BaseDefinition as h, PathSegment as hn, OnPasteResult as ht, execute as i, TextBlockRenderProps as in, BlockChildRenderProps as it, PortableTextTextBlock$1 as j, HotkeyOptions as jt, PortableTextObject$1 as k, PortableTextEditable as kt, InsertPlacement as l, defineTextBlock as ln, EditableAPIDeleteOptions as lt, AnnotationSchemaType$1 as m, Path as mn, OnPasteFn as mt, BehaviorActionSet as n, TextBlock as nn, AddedAnnotationPaths as nt, raise$1 as o, defineContainer as on, BlockListItemRenderProps as ot, AnnotationDefinition as p, KeyedSegment as pn, OnCopyFn as pt, EditorEvent as q, ContainerRender as qt, effect as r, TextBlockRender as rn, BlockAnnotationRenderProps as rt, BehaviorEvent as s, defineInlineObject as sn, BlockRenderProps as st, BehaviorAction as t, SpanRenderProps as tn, EditorSnapshot as tt, NativeBehaviorEvent as u, AnnotationPath as un, EditorSelection as ut, DecoratorDefinition as v, RangeDecoration as vt, ListSchemaType$1 as w, RenderEditableFunction as wt, InlineObjectDefinition as x, RenderBlockFunction as xt, DecoratorSchemaType$1 as y, RangeDecorationOnMovedDetails as yt, usePortableTextEditorSelection as z, RegisteredContainer as zt };
+//# sourceMappingURL=behavior.types.action-DXkAaEGS.d.ts.map