@wix/ricos 10.110.0 → 10.112.0

package/dist/src/ricos-schema/next-schema/generated/ricos_document.d.ts

@@ -1,8 +1,8 @@
 export type RicosDocument = {
     nodes: RootNode[];
-    /** Data about the Ricos document, such as version. This property is applicable only when using the ricos content editor and is auto-generated. */
+    /** Information about the Ricos document itself, such as its version. Only relevant when building the Ricos document using the [Ricos playground](https:/ricos.dev), in which case it is auto-generated. */
     metadata?: Metadata;
-    /** Defines styles for nodes. For example, you can define general styling for `headerOne`, and then override some of the properties separately for a specific header. */
+    /** Includes styling to be applied throughout the Ricos document for the specified node types. For example, you can define general styling for `headerOne`, and then override some of the properties separately for a specific header. */
     documentStyle?: DocumentStyle;
 };
 export type NodeStyle = {
@@ -13,8 +13,8 @@ export type NodeStyle = {
     backgroundColor?: string;
 };
 /**
- * This object sets a default styling for a type of node throughout the entire Ricos Document. For example, we can set the text color for all Heading 1 nodes.
- * You can override the styling of Text nodes separately using [Decorations](#decorations).
+ * Sets a default styling for specific node types throughout the entire Ricos Document. For example, you can set the text color for all Heading 1 nodes.
+ * You can override the styling of specific Text nodes separately using [decorations](#decorations).
  */
 export type DocumentStyle = {
     /** Style for the H1 nodes. */
@@ -40,7 +40,7 @@ export type TextNodeStyle = {
     decorations?: Decoration[];
     /**
      * Node style, such as padding.
-     *  **Note:** This node requires the [lineSpacing](#plugins) plugin.
+     *  **Note:** This node requires the [lineSpacing](#plugins) plugin to be enabled.
      */
     nodeStyle?: NodeStyle;
     /** Text line height. */
@@ -54,7 +54,7 @@ export type Metadata = {
     updatedTimestamp?: any;
 };
 export type TextStyle = {
-    /** Text alignment. Possible values: <br> - `AUTO`: Text aligns itself automatically. <br> - `LEFT`: Text is aligned to the left. <br> - `RIGHT`: Text is aligned to the right. <br> - `CENTER`: Text is centered. <br> - `JUSTIFY`: Text is justified to both margins. Default: `AUTO`. */
+    /** Text alignment. Supported values: <br> - `AUTO`: Text aligns itself automatically. <br> - `LEFT`: Text is aligned to the left. <br> - `RIGHT`: Text is aligned to the right. <br> - `CENTER`: Text is centered. <br> - `JUSTIFY`: Text is justified to both margins. <br> Default: `AUTO`. */
     textAlignment?: TextStyle_TextAlignment;
     /** Vertical spacing between lines of text in an element. */
     lineHeight?: string;
@@ -69,13 +69,13 @@ export declare const TextStyle_TextAlignment: {
 };
 /** Link object. */
 export type Link = {
-    /** Absolute URL for the linked document. */
+    /** Absolute URL to link to. */
     url?: string;
-    /** Target Node ID, where the user is redirected after clicking the anchor. */
+    /** Target [Node ID](#node-ids) to link to. */
     anchor?: string;
-    /** The HTML `target` attribute value for the link. This property defines where the linked document opens. Possible values: <br> `SELF` - Default. Opens the linked document in the same frame as the link.<br> `BLANK` - Opens the linked document in a new browser tab or window.<br> `PARENT` - Opens the linked document in the link's parent frame.<br> `TOP` - Opens the linked document in the full body of the link's browser tab or window. */
+    /** The HTML `target` attribute value for the link. This property defines where the link opens. <br> Supported values: <br> `SELF` - Opens the link in the same frame.<br> `BLANK` - Opens the link in a new browser tab or window.<br> `PARENT` - Opens the link in the parent frame.<br> `TOP` - Opens the link in the full body of the link's browser tab or window. <br> Default: `SELF` */
     target?: Link_Target;
-    /** This object specifies the relationship between the current document and the linked document. */
+    /** Relationship between the current document and the linked document. */
     rel?: Link_Rel;
     /** A serialized object used for a custom or external link panel. */
     customData?: string;
@@ -108,18 +108,18 @@ export type Link_Rel = {
 };
 /** File source object. */
 export type FileSource = {
-    /** Absolute URL for the file's source. */
+    /** File source URL. */
     url?: string;
     /** ID that's resolved to a URL by a resolver function. */
     id?: string;
     /**
-     * Indicates whether the file's source is private.
+     * Whether the file's source is private. Learn more about private files in Wix ([SDK](https://dev.wix.com/docs/sdk/backend-modules/media/files/private-files) | [REST](https://dev.wix.com/docs/rest/assets/media/media-manager/files/private-files)).
      *  Default: `false`
      */
     private?: boolean;
 };
 export type Media = {
-    /** Media data source. */
+    /** File source. */
     src: FileSource;
     /** Media width in pixels. */
     width?: number;
@@ -132,21 +132,16 @@ export type Never = {
     _neverCreatedElement: any;
 };
 export type PluginContainerData = {
-    /** Node width in a container when it's displayed. */
+    /** Node display width. */
     width?: PluginContainerData_Width;
-    /**
-     * Node alignment in its container. Possible values:
-     *  - `CENTER`
-     *  - `LEFT`
-     *  - `RIGHT`
-     */
+    /** Node alignment in its container. */
     alignment?: PluginContainerData_Alignment;
     /** Spoiler cover settings. */
     spoiler?: PluginContainerData_Spoiler;
-    /** Node height in a container when it's displayed. */
+    /** Node display height. */
     height?: PluginContainerData_Height;
     /**
-     * Whether the text should wrap around the node when it's displayed. If `textWrap` is `false`, the node takes up the width of its container.
+     * Whether the text should wrap around the node when it's displayed. If `textWrap` is `false`, the node fills the width of its container.
      *  Default: `true` for all node types except `DIVIDER`.
      */
     textWrap?: boolean;
@@ -163,19 +158,19 @@ export type PluginContainerData_Spoiler = {
      *  Default: `false`
      */
     enabled?: boolean;
-    /** Description displayed on top of the spoiler cover. */
+    /** Text displayed on the spoiler cover. */
     description?: string;
-    /** Text of a button that removes the spoiler cover. */
+    /** Text that appears on the button that removes the spoiler cover. */
     buttonText?: string;
 };
-/** The width of the node when it's displayed. */
+/** Node display width. */
 export type PluginContainerData_Width = {
     /**
-     * Width size of a node in a container. Possible values:
-     *  - `CONTENT`: The width of the container matches the content width.
-     *  - `SMALL`: A small width.
-     *  - `ORIGINAL`: The width of the container matches the original image width. **Note:** This value is applicable for `imageData` containers only.
-     *  `FULL_WIDTH`: The image container takes up the full width of the screen. **Note:** This value is applicable for `imageData` containers only.
+     * Width of a node in a container. Supported values:
+     *  - `CONTENT`: Width of the container matches the content width.
+     *  - `SMALL`: Small width.
+     *  - `ORIGINAL`: Width of the container matches the original image width. **Note:** This value is only applicable for `imageData` containers.
+     *  `FULL_WIDTH`: Image container takes up the full width of the screen. **Note:** This value is only applicable for `imageData` containers.
      */
     size?: PluginContainerData_Width_Type;
     /** A custom width value in pixels. */
@@ -189,7 +184,7 @@ export declare const PluginContainerData_Width_Type: {
     readonly FULL_WIDTH: "FULL_WIDTH";
 };
 export type PluginContainerData_Height = {
-    /** A custom height value in pixels. */
+    /** Node display height in pixels. */
     custom?: string;
 };
 export type Decoration = BoldDecoration | ItalicDecoration | UnderlineDecoration | SpoilerDecoration | AnchorDecoration | MentionDecoration | LinkDecoration | ColorDecoration | FontSizeDecoration;
@@ -205,77 +200,77 @@ export declare const Decoration_Type: {
     readonly COLOR: "COLOR";
     readonly FONT_SIZE: "FONT_SIZE";
 };
-/** Text that is styled to appear thicker and more prominent than normal text. */
+/** Bolds text, which makes it appear thicker and more prominent than normal text. */
 export type BoldDecoration = {
     /**
      * Decoration type.
-     *  Value: `BOLD`
+     *  Must be `BOLD`.
      */
     type: 'BOLD';
-    /** Font weight. Values are from `100` to `900`. */
+    /** Font weight. */
     fontWeightValue?: number;
 };
-/** Text that is styled to appear slanted or italicized, which is typically used for emphasis, citations, or to distinguish certain types of content. */
+/** Italicizes text, which makes it appear slanted or italicized. Italics are typically used for emphasis, citations, or to distinguish certain types of content. */
 export type ItalicDecoration = {
     /**
      * Decoration type.
-     *  Value: `ITALIC`
+     *  Must be `ITALIC`.
      */
     type: 'ITALIC';
     /** Whether to enable the italic text. */
     italicData?: boolean;
 };
-/** Text that is styled with a line underneath it. */
+/** Underlines text. */
 export type UnderlineDecoration = {
     /**
      * Decoration type.
-     *  Value: `UNDERLINE`
+     * Must be `UNDERLINE`.
      */
     type: 'UNDERLINE';
-    /** Whether to enable the underlined text. */
+    /** Whether to underline the text. */
     underlineData?: boolean;
 };
-/** Text that is styled to appear blurred. <br> **Note:** This decoration requires the [spoiler](#plugins) plugin. */
+/** Blurs text. <br> **Note:** This decoration requires the [`spoiler`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled. */
 export type SpoilerDecoration = {
     /**
      * Decoration type.
-     *  Value: `SPOILER`
+     *  Must be `SPOILER`.
      */
     type: 'SPOILER';
     /** Spoiler details. */
     spoilerData?: SpoilerData;
 };
-/** Clickable text in a hyperlink. Rendered in a different color, indicating that it is a link that users can click to navigate to section in the same page. */
+/** Makes clickable text a different color. The link navigates to another section of the same page. */
 export type AnchorDecoration = {
     /**
      * Decoration type.
-     *  Value: `ANCHOR`
+     *  Must be `ANCHOR`.
      */
     type: 'ANCHOR';
     /** Anchor details. */
     anchorData?: AnchorData;
 };
-/** A piece of text that mentions a specific user, often in social media platforms, forums, or content management systems. <br> **Note:** This decoration requires the [mention](#plugins) plugin. */
+/** Text that mentions a specific user, often in social media platforms, forums, or content management systems. <br> **Note:** This decoration requires the [`mention`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled. */
 export type MentionDecoration = {
     /**
      * Decoration type.
-     *  Value: `MENTION`
+     *  Must be `MENTION`.
      */
     type: 'MENTION';
     /** Anchor details. */
     mentionData?: MentionData;
 };
-/** Clickable text in a hyperlink. This text is what users see and click on to navigate to another web page or another resource. <br> **Note:** This decoration requires the [link](#plugins) plugin. */
+/** Makes clickable text a different color. The link navigates to another webpage or resource. <br> **Note:** This decoration requires the [`link`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled. */
 export type LinkDecoration = {
     /**
      * Decoration type.
-     *  Value: `LINK`
+     *  Must be `LINK`.
      */
     type: 'LINK';
     /** Link details. */
     linkData?: LinkData;
 };
-/** Text that is styled using background and text colors. <br> **Note:** This decoration requires the [colorDecoration](#plugins) plugin. */
+/** Styles text using background and text colors. <br> **Note:** This decoration requires the [`colorDecoration`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled. */
 export type ColorDecoration = {
     /**
      * Decoration type.
@@ -289,20 +284,20 @@ export type ColorDecoration = {
 export type FontSizeDecoration = {
     /**
      * Decoration type.
-     *  Value: `FONT_SIZE`
+     *  Must be `FONT_SIZE`.
      */
     type: 'FONT_SIZE';
     /** Font size details. */
     fontSizeData?: FontSizeData;
 };
 export type AnchorData = {
-    /** Target Node ID, where the user is redirected after clicking the anchor. */
+    /** Target Node ID to redirect to. */
     anchor?: string;
 };
 export type ColorData = {
-    /** Background color in a hexadecimal value. */
+    /** Background color as a hexadecimal value. */
     background?: string;
-    /** Text color in a hexadecimal value. */
+    /** Text color as a hexadecimal value. */
     foreground?: string;
 };
 export type LinkData = {
@@ -310,19 +305,15 @@ export type LinkData = {
     link?: Link;
 };
 export type MentionData = {
-    /** The display name of the mentioned user. */
+    /** Display name of the mentioned user. */
     name?: string;
-    /** The username of the mentioned user, appearing after the "@" character. */
+    /** Username of the mentioned user. This is th text that appears after the "@". */
     slug?: string;
     /** ID of the mentioned user. */
     id?: string;
 };
 export type FontSizeData = {
-    /**
-     * Font size units. Possible values:
-     *  - `PX`: Size in pixels.
-     *  - `EM`: Relative to the font size of the element (2em means 2 times the size of the current font)
-     */
+    /** Font size units. */
     unit?: FontSizeData_fontType;
     /** Font size value. */
     value?: number;
@@ -336,11 +327,11 @@ export type SpoilerData = {
     /** [Node ID](#node-ids). */
     id?: string;
 };
-/** Used to visually distinguish quoted or cited content from the surrounding text. When rendered, it is displayed as the quoted text with indentation or other styling to visually separate it from the surrounding content. */
+/** Used to visually distinguish quoted or cited content from the surrounding text. When rendered, it displays as the quoted text with indentation or other styling to visually separate it from the surrounding content. */
 export type BlockquoteNode = {
     /**
      * Node type.
-     *  Value: `BLOCKQUOTE`
+     *  Must be `BLOCKQUOTE`.
      */
     type: 'BLOCKQUOTE';
     nodes: ParagraphNode[];
@@ -350,44 +341,44 @@ export type BlockquoteNode = {
     blockquoteData?: BlockquoteData;
     /**
      * Defines the blockquote style, such as padding and background color.
-     *  **Note:** This node requires the [lineSpacing](#plugins) plugin for styling.
+     *  **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled.
      */
     style?: NodeStyle;
 };
 export type BlockquoteData = {
     /**
-     * Blockquote margin from the left side. Possible values are from `1` to `4`.
-     *  The indentation is measured in relative to the font size *em* units, by the following formula: **indentation * 1.5**. For example, if indentation is `2`, then margin is equal to **3em**. Therefore the margin is 3 times the size of the font.
+     * Blockquote margin from the left side.
+     *  The indentation is measured relative to the font size *em* units by a ratio of 1.5. For example, if the indentation is `2`, then the margin is equal to **3em**. Therefore the margin is 3 times the size of the font.
      */
     indentation?: number;
 };
-/** Represents a caption container that can be attached to media elements like images. Captions support formatted text content and can be styled independently from their parent nodes. */
+/** Caption container to be attached to media elements, such as images. Captions support formatted text content and can be styled independently from their parent nodes. */
 export type CaptionNode = {
     /**
      * Node type.
-     *  Value: `CAPTION`
+     *  Must be `CAPTION`.
      */
     type: 'CAPTION';
     nodes: TextNode[];
-    /** Caption node ID. The editor generates the ID automatically. If you're using the Ricos object in an API, you have to add this ID manually, if needed. */
+    /** Caption [node ID](#node-ids). */
     id?: string;
     /**
-     * Defines the caption style, such as padding and background color.
-     *  **Note:** This node requires the [lineSpacing](#plugins) plugin for styling.
+     * Defines the caption styling, such as padding and background color.
+     *  **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled.
      */
     style?: NodeStyle;
-    /** Caption options node. */
+    /** Caption options. */
     captionData?: CaptionData;
 };
 export type CaptionData = {
-    /** Styling for the caption text. */
+    /** Caption text styling. */
     textStyle?: TextStyle;
 };
-/** Used to present programming code snippets, markup, or other text-based content that should be displayed exactly as it appears, without any interpretation or formatting applied by the browser. When rendered, it is displayed as the code block with a monospaced font, preserving indentation, line breaks, and spacing as specified in the code. */
+/** Presents code snippets, markup, or other text-based content that should be displayed exactly as it appears, without any interpretation or formatting applied by the browser. When rendered, it is displayed as the code block with a monospaced font, preserving indentation, line breaks, and spacing as specified in the code. */
 export type CodeBlockNode = {
     /**
      * Node type.
-     *  Value: `CODE_BLOCK`
+     *  VMust be `CODE_BLOCK`.
      */
     type: 'CODE_BLOCK';
     nodes?: TextNode[];
@@ -396,49 +387,49 @@ export type CodeBlockNode = {
     /** Code block details. */
     codeBlockData?: CodeBlockData;
     /**
-     * Defines the blockquote style, such as padding and background color.
-     *  **Note:** This node requires the [lineSpacing](#plugins) plugin for styling.
+     * Code block styling, such as padding and background color.
+     *  **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled.
      */
     style?: NodeStyle;
 };
 export type CodeBlockData = {
-    /** Defines the text style, such as alignment and line height. */
+    /** Defines the text styling, such as alignment and line height. */
     textStyle?: TextStyle;
 };
-/** Used to denote the heading or title of a section. Headings are hierarchical, with different levels indicating the relative importance of the heading in the content's structure. There are 6 levels of headings, where `1` is the highest level and `6` is the lowest. */
+/** Indicates a heading or title of a section. There are 6 levels of headings, with `1` being the most prominent and `6` being the least. */
 export type HeadingNode = {
     /**
      * Node type.
-     *  Value: `HEADING`
+     *  Must be `HEADING`.
      */
     type: 'HEADING';
     nodes?: TextNode[];
     /** [Node ID](#node-ids). */
     id?: string;
     /**
-     * Defines the heading style, such as padding and background color.
-     *  **Note:** This node requires the [lineSpacing](#plugins) plugin for styling.
+     * Heading styling, such as padding and background color.
+     *  **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled.
      */
     style?: NodeStyle;
     /** Heading options. */
     headingData?: HeadingData;
 };
 export type HeadingData = {
-    /** Heading size from `1` to `6`, where `1` is the highest level and `6` is the lowest. */
+    /** Heading size. <br> Mi: `1` <br> Max: `6` */
     level?: number;
-    /** Defines the heading text style, such as text alignment and line height. */
+    /** Heading text styling, such as text alignment and line height. */
     textStyle?: TextStyle;
     /**
-     * Heading margin from the left side. Possible values are from `1` to `4`.
-     *  The indentation is measured in relative to the font size *em* units, by the following formula: **indentation * 1.5**. For example, if indentation is `2`, then margin is equal to **3em**. Therefore the margin is 3 times the size of the font.
+     * Heading margin from the left side.
+     *  The indentation is measured relative to the font size *em* units by a ratio of 1.5. For example, if the indentation is `2`, then the margin is equal to **3em**. Therefore the margin is 3 times the size of the font.
      */
     indentation?: number;
 };
-/** Presents a group of items in a sequentially numbered or lettered manner. Ordered lists are used to represent information that has a specific order or sequence. */
+/** Numbered list. */
 export type OrderedListNode = {
     /**
      * Node type.
-     *  Value: `ORDERED_LIST`
+     *  Must be `ORDERED_LIST`.
      */
     type: 'ORDERED_LIST';
     nodes: ListItemNode[];
@@ -449,20 +440,20 @@ export type OrderedListNode = {
 };
 export type OrderedListData = {
     /**
-     * List margin from the left side. Possible values are from `1` to `4`.
-     *  The indentation is measured in relative to the font size *em* units, by the following formula: **indentation * 1.5**. For example, if indentation is `2`, then margin is equal to **3em**. Therefore the margin is 3 times the size of the font.
+     * List margin from the left side.
+     *  The indentation is measured relative to the font size *em* units by a ratio of 1.5. For example, if the indentation is `2`, then the margin is equal to **3em**. Therefore the margin is 3 times the size of the font.
      */
     indentation?: number;
-    /** An integer (ranging from 0 to 4) used to control the additional indentation level of an ordered or bulleted list node, beyond its original HTML-defined nesting. When offset is 0, the list node appears at its default nesting level; as the value increases from 1 to 4, the node is indented further, creating the visual impression of deeper nesting without altering the actual HTML structure. */
+    /** Additional indentation of a list node. When offset is `0`, the list node appears at its default nesting level. Higher values cause increased indentation. */
     offset?: number;
-    /** An integer to start counting from for the list items, overriding the default start of 1. */
+    /** Number at the top of the numbered list. <br> Default: `1` */
     start?: number;
 };
-/** Presents a group of items in a visually organized manner, where each item is preceded by a bullet point. Bulleted lists are commonly used to present unordered information. */
+/** Bulleted list. */
 export type BulletedListNode = {
     /**
      * Node type.
-     *  Value: `BULLETED_LIST`
+     *  Must be `BULLETED_LIST`.
      */
     type: 'BULLETED_LIST';
     nodes: ListItemNode[];
@@ -473,7 +464,7 @@ export type BulletedListNode = {
 };
 export type BulletedListData = {
     indentation?: number;
-    /** An integer (ranging from 0 to 4) used to control the additional indentation level of an ordered or bulleted list node, beyond its original HTML-defined nesting. When `offset` is `0`, the list node appears at its default nesting level; as the value increases from 1 to 4, the node is indented further, creating the visual impression of deeper nesting without altering the actual HTML structure. */
+    /** Additional indentation of a list node. When offset is `0`, the list node appears at its default nesting level. Higher values cause increased indentation. */
     offset?: number;
 };
 export type ListItemNode = {
@@ -487,37 +478,40 @@ export type ListItemNode = {
     id?: string;
 };
 export type ListItemChildNode = ParagraphNode | HeadingNode | OrderedListNode | BulletedListNode | ImageNode | VideoNode | GifNode | GalleryNode;
-/** Used to structure text content, providing a clear separation between different ideas or sections of text. They are rendered with default styling that typically includes some space above and below the paragraph, making it visually distinct from the surrounding content. */
+/** Structures text content, providing a clear separation between different ideas or sections of text. Paragraphs are rendered with default styling that typically includes some space above and below the paragraph, making it visually distinct from the surrounding content. */
 export type ParagraphNode = {
     /**
      * Node type.
-     *  Value: `PARAGRAPH`
+     *  Must be `PARAGRAPH`.
      */
     type: 'PARAGRAPH';
     nodes?: TextNode[];
     /** [Node ID](#node-ids). */
     id?: string;
     /**
-     * Paragraphs vertical padding.
-     *  **Note:** This node requires the [lineSpacing](#plugins) plugin for styling.
+     * Vertical padding.
+     *  **Note:** This node requires the [`lineSpacing`](https://dev.wix.com/docs/ricos/getting-started/introduction#plugins) plugin to be enabled.
      */
     style?: NodeStyle;
     /** Paragraph node attributes. */
     paragraphData?: ParagraphData;
 };
 export type ParagraphData = {
-    /** Styling for the paragraph text. */
+    /** Paragraph text styling. */
     textStyle?: TextStyle;
-    /** Paragraph margin from the left side. Possible values are from `1` to `4`. <br>Actual indentation is equal to **indentation * 40px**. */
+    /**
+     * Paragraph margin from the left side.
+     *  The indentation is measured relative to 40px. For example, if the indentation is `2`, then the margin is equal to **80px**.
+     */
     indentation?: number;
-    /** Paragraph level for future different paragraphs */
+    /** Paragraph level for future different paragraphs. */
     level?: number;
 };
-/** Text nodes hold the text itself (think `span` tag in HTML). The difference between `TextNode` and HTML `span` is that text nodes can't be nested and must contain non-empty string. Their appearance and behavior can be modified using [decorations](#decorations). */
+/** Text nodes hold the text itself, similar to how `span` tags hold text in HTML. Text nodes can't be nested and must contain a non-empty string. Their appearance and behavior can be modified using [decorations](#decorations). */
 export type TextNode = {
     /**
      * Node type.
-     *  Value: `TEXT`
+     *  Must be `TEXT`.
      */
     type: 'TEXT';
     /** Text options. */
@@ -527,18 +521,18 @@ export type TextNode = {
     nodes?: never[];
 };
 export type TextData = {
-    /** A piece of text, possibly enhanced with additional decorations. Must not be empty. */
+    /** Non-empty string to display as text. */
     text: string;
     decorations?: Decoration[];
 };
-/** Similar to `LinkPreviewNode`, this node is used to embed external content preview, but from Wix business solutions. You can embed previews from the Wix Bookings, Wix Stores and Wix Events apps. */
+/** Embeds an external content preview from Wix business solutions. For example, you can embed previews from the Wix Bookings, Wix Stores and Wix Events apps. */
 export type AppEmbedNode = {
     /**
      * Node type.
-     *  Value: `APP_EMBED`
+     *  Must be `APP_EMBED`.
      */
     type: 'APP_EMBED';
-    /** Embedded Wix app details. */
+    /** Embedded Wix app. */
     appEmbedData: AppEmbedData;
     /** [Node ID](#node-ids). */
     id?: string;
@@ -551,14 +545,9 @@ export declare const AppEmbedData_AppType: {
     readonly EVENT: "EVENT";
     readonly BOOKING: "BOOKING";
 };
-/** Wix Stores app. Embeds a particular product. */
+/** Embedded a product from Wix Stores. */
 export type AppEmbedDataProduct = {
-    /**
-     * Which Wix App to embed. Possible values:
-     *  - `PRODUCT`: Wix Stores app. Embeds a particular product.
-     *  - `EVENT`: Wix Events app. Embeds a particular event.
-     *  - `BOOKINGS`: Wix Bookings app. Embeds a particular booking.
-     */
+    /** Must be `PRODUCT`. */
     type: 'PRODUCT';
     /** Embedded content name. */
     name: string;
@@ -571,14 +560,15 @@ export type AppEmbedDataProduct = {
     /** Deprecated: Use `image` instead. */
     imageSrc?: string;
 };
-/** Wix Events app. Embeds a particular event. */
+/** Embeds an event from Wix Events. */
 export type AppEmbedDataEvent = {
+    /** Must be `EVENT`. */
     type: 'EVENT';
     /** Embedded content name. */
     name: string;
     /** Embedded content URL. */
     url: string;
-    /** Embedded Wix Events app content. */
+    /** Embedded event content. */
     eventData?: AppEmbedData_EventData;
     /** Embedded content thumbnail. */
     image?: Media;
@@ -587,7 +577,7 @@ export type AppEmbedDataEvent = {
     /** Deprecated: Use `image` instead. */
     imageSrc?: string;
 };
-/** Wix Bookings app. Embeds a particular booking. */
+/** Embeds a booking from Wix Bookings. */
 export type AppEmbedDataBooking = {
     type: 'BOOKING';
     /** Embedded content name. */
@@ -598,7 +588,7 @@ export type AppEmbedDataBooking = {
     image?: Media;
     /** Embedded content ID. */
     itemId?: string;
-    /** Embedded Wix Bookings app content. */
+    /** Embedded booking content. */
     bookingData?: AppEmbedData_BookingData;
     /** Deprecated: Use `image` instead. */
     imageSrc?: string;
@@ -613,11 +603,11 @@ export type AppEmbedData_EventData = {
     /** Event location. */
     location?: string;
 };
-/** A multimedia node used to embed and play audio content directly in a webpage. When rendered, it is displayed as the audio player with the specified audio file (can be a platform such as Spotify or Soundloud, and Wix Media). Users can interact with the controls to play, pause, rewind, and adjust the volume of the audio. */
+/** Embeds and plays audio content directly in a webpage. Users can interact with the controls to play, pause, rewind, and adjust the volume of the audio. */
 export type AudioNode = {
     /**
      * Node type.
-     *  Value: `AUDIO`
+     *  Must be `AUDIO`.
      */
     type: 'AUDIO';
     /** [Node ID](#node-ids). */
@@ -632,7 +622,7 @@ export type AudioData = {
     /** Audio file details. */
     audio?: Media;
     /**
-     * Sets whether the audio download button is disabled.
+     * Whether the audio download button is disabled.
      *  Default: `false`
      */
     disableDownload?: boolean;
@@ -642,14 +632,14 @@ export type AudioData = {
     name?: string;
     /** Author name. */
     authorName?: string;
-    /** An HTML version of the audio node. */
+    /** HTML version of the audio node. */
     html?: string;
 };
-/** A node that is used to trigger an action when clicked or activated. */
+/** Button to trigger an action. */
 export type ButtonNode = {
     /**
      * Node type.
-     *  Value: `BUTTON`
+     *  Must be `BUTTON`
      */
     type: 'BUTTON';
     /** Button details. */
@@ -659,11 +649,11 @@ export type ButtonNode = {
     nodes?: never[];
 };
 export type ButtonData = {
-    /** Button type. Possible values: <br> - `LINK`: When clicked, a user is redirected. <br> - `ACTION`: When clicked, performs an action. */
+    /** Button type. Supported values: <br> - `LINK`: Redirects to a webpage. <br> - `ACTION`: Performs an action. */
     type: ButtonData_Type;
     /** Button text. */
     text: string;
-    /**  Button container styling. */
+    /** Button container styling. */
     containerData?: PluginContainerData;
     /** Button styling. */
     styles?: ButtonData_Styles;
@@ -682,11 +672,11 @@ export type ButtonData_Styles = {
     colors?: ButtonData_Styles_Colors;
 };
 export type ButtonData_Styles_Colors = {
-    /** The text color in a hexadecimal value. */
+    /** Text color as a hexadecimal value. */
     text?: string;
-    /** The border color in a hexadecimal value. */
+    /** Border color as a hexadecimal value. */
     border?: string;
-    /** The background color in a hexadecimal value. */
+    /** Background color as a hexadecimal value. */
     background?: string;
 };
 export type ButtonData_Styles_Border = {
@@ -695,11 +685,11 @@ export type ButtonData_Styles_Border = {
     /** Border radius in pixels. */
     radius?: number;
 };
-/** A list of items where each item can be expanded or collapsed to reveal or hide additional content associated with it. */
+/** List of items where each item can be expanded or collapsed. */
 export type CollapsibleListNode = {
     /**
      * Node type.
-     *  Value: `COLLAPSIBLE_LIST`
+     *  Must be `COLLAPSIBLE_LIST`
      */
     type: 'COLLAPSIBLE_LIST';
     nodes: CollapsibleItemNode[];
@@ -713,23 +703,18 @@ export type CollapsibleListData = {
     containerData?: PluginContainerData;
     /**
      * Whether only one item can be expanded at a time.
-     *  Default: `false`
+     *  Default: `false`.
      */
     expandOnlyOne?: boolean;
-    /**
-     * Sets which items are automatically expanded after the page loads. Possible values:
-     *  - `FIRST`
-     *  - `ALL`
-     *  - `NONE`
-     */
+    /** Sets which items are automatically expanded after the page loads. */
     initialExpandedItems?: 'FIRST' | 'ALL' | 'NONE';
     /**
-     * Direction of the text in the list. Possible values:
+     * Direction of the text in the list. Supported values:
      *  - `LTR`: Left to right.
      *  - `RTL`: Right to left.
      */
     direction?: CollapsibleListData_Direction;
-    /** Whether the collapsible item will appear in search results as a FAQ. */
+    /** Whether the collapsible item will appear in search results as an FAQ. */
     isQapageData?: boolean;
 };
 export type CollapsibleListData_Direction = 'LTR' | 'RTL';
@@ -740,7 +725,7 @@ export declare const CollapsibleListData_Direction: {
 export type CollapsibleItemNode = {
     /**
      * Node type.
-     *  Value: `COLLAPSIBLE_ITEM`
+     *  Must be `COLLAPSIBLE_ITEM`
      */
     type: 'COLLAPSIBLE_ITEM';
     nodes: CollapsibleItemChildNode[];
@@ -748,11 +733,11 @@ export type CollapsibleItemNode = {
     id?: string;
 };
 export type CollapsibleItemChildNode = CollapsibleItemTitleNode | CollapsibleItemBodyNode;
-/** Collapsible list item title node. */
+/** Collapsible list item title. */
 export type CollapsibleItemTitleNode = {
     /**
      * Node type.
-     *  Value: `COLLAPSIBLE_ITEM_TITLE`
+     *  Must be `COLLAPSIBLE_ITEM_TITLE`.
      */
     type: 'COLLAPSIBLE_ITEM_TITLE';
     nodes: CollapsibleTitleChildNode[];
@@ -760,24 +745,24 @@ export type CollapsibleItemTitleNode = {
     id?: string;
 };
 export type CollapsibleTitleChildNode = ParagraphNode | HeadingNode | BulletedListNode | OrderedListNode | BlockquoteNode | CodeBlockNode;
-/** Collapsible list item body node. */
+/** Collapsible list item body. */
 export type CollapsibleItemBodyNode = {
     /**
      * Node type.
-     *  Value: `COLLAPSIBLE_ITEM_BODY`
+     *  Must be `COLLAPSIBLE_ITEM_BODY`.
      */
     type: 'COLLAPSIBLE_ITEM_BODY';
     nodes: CollapsibleItemBodyChildNode[];
     /** [Node ID](#node-ids). */
     id?: string;
 };
-/** Collapsible list item body node. */
+/** Collapsible list item body. */
 export type CollapsibleItemBodyChildNode = ParagraphNode | HeadingNode | BulletedListNode | OrderedListNode | BlockquoteNode | AudioNode | FileNode | ImageNode | VideoNode | GifNode | DividerNode | CodeBlockNode | AppEmbedNode | LinkPreviewNode | GalleryNode | ButtonNode | CollapsibleListNode | TableNode | EmbedNode | PollNode | HtmlNode;
-/** A visual node that is used to separate content sections in a page. When rendered, it is displayed as a horizontal line between the paragraphs, acting as a divider between them. */
+/** Horizontal line between different content. */
 export type DividerNode = {
     /**
      * Node type.
-     *  Value: `DIVIDER`
+     *  Must be `DIVIDER`.
      */
     type: 'DIVIDER';
     /** [Node ID](#node-ids). */
@@ -789,11 +774,11 @@ export type DividerNode = {
 export type DividerData = {
     /** Divider container styling. */
     containerData?: PluginContainerData;
-    /** Divider line style. Possible values: <br> - `SINGLE` <br> - `DOUBLE` <br> - `DASHED` <br> - `DOTTED` */
+    /** Divider line style. */
     lineStyle?: DividerData_LineStyle;
-    /** Divider width. Possible values: <br> - `LARGE` <br> - `MEDIUM` <br> - `SMALL` */
+    /** Divider width. */
     width?: DividerData_Width;
-    /** Divider alignment. Possible values: <br> - `CENTER` <br> - `LEFT` <br> - `RIGHT` */
+    /** Divider alignment. */
     alignment?: DividerData_Alignment;
 };
 export type DividerData_LineStyle = 'SINGLE' | 'DOUBLE' | 'DASHED' | 'DOTTED';
@@ -815,11 +800,11 @@ export declare const DividerData_Alignment: {
     readonly LEFT: "LEFT";
     readonly RIGHT: "RIGHT";
 };
-/** Similar to `HtmlNode`, this node is used to display embedded content when you post a link to that resource, without having to parse the resource directly. It provides a standardized way for web developers to include content such as videos, images, and other multimedia elements from supported providers without needing to handle the complex embedding code themselves. For more information, read [oembed](https://oembed.com/). */
+/** Embedded content when you include a link to a resource, without having to parse the resource directly. This provides a standardized way for web developers to include content such as videos, images, and other multimedia elements from supported providers. To learn more, see [oembed](https://oembed.com/). */
 export type EmbedNode = {
     /**
      * Node type.
-     *  Value: `EMBED`
+     *  Must be `EMBED`.
      */
     type: 'EMBED';
     /** oEmbed details. */
@@ -837,17 +822,17 @@ export type EmbedData = {
     src?: string;
 };
 export type Oembed = {
-    /** Resource type. For more information read the [oEmbed](https://www.oembed.com) official website. */
+    /** Resource type. */
     type?: string;
     /** Width of the resource specified in the `url` field in pixels. */
     width?: number;
     /** Height of the resource specified in the `url` field in pixels. */
     height?: number;
-    /** A text title, describing the resource. */
+    /** Resource title. */
     title?: string;
-    /** The source URL for the resource. */
+    /** Resource source URL. */
     url?: string;
-    /** HTML required to embed a video player. The HTML should have no padding or margins. */
+    /** HTML to embed a video player. The HTML should have no padding or margins. */
     html?: string;
     /** Name of the author or owner of the resource. */
     authorName?: string;
@@ -857,22 +842,22 @@ export type Oembed = {
     providerName?: string;
     /** URL for the resource provider. */
     providerUrl?: string;
-    /** URL for a thumbnail image for the resource. If this property is defined, `thumbnailWidth` and `thumbnailHeight` must also be defined. */
+    /** Thumbnail image URL for the resource. If defined, `thumbnailWidth` and `thumbnailHeight` must also be defined. */
     thumbnailUrl?: string;
-    /** Width of the resource's thumbnail image. If this property is defined, `thumbnailUrl` and `thumbnailHeight` must also be defined. */
+    /** Resource's thumbnail image width. If defined, `thumbnailUrl` and `thumbnailHeight` must also be defined. */
     thumbnailWidth?: string;
-    /** Height of the resource's thumbnail image. If this property is defined, `thumbnailUrl` and `thumbnailWidth`must also be defined. */
+    /** Resource's thumbnail image height. If defined, `thumbnailUrl` and `thumbnailWidth`must also be defined. */
     thumbnailHeight?: string;
-    /** URL for an embedded video. */
+    /** Embedded video URL. */
     videoUrl?: string;
-    /** The oEmbed version number.  This value must be `1.0`. */
+    /** The oEmbed version number. Must be `1.0`. */
     version?: string;
 };
-/** A digital file stored on a computer that is uploaded and accessed in a page. Files can include various types of content, such as text documents, images, videos, and so on. */
+/** File that is uploaded and accessed in a page. Files can be different types of content, such as text documents, images, and videos. */
 export type FileNode = {
     /**
      * Node type.
-     *  Value: `FILE`
+     *  Must be `FILE`.
      */
     type: 'FILE';
     /** File details. */
@@ -890,7 +875,7 @@ export type FileData = {
     name?: string;
     /** File type. */
     type?: string;
-    /** Deprecated. Replaced by sizeInKb */
+    /** Deprecated. Replaced by `sizeInKb` */
     size?: number;
     /** File size in KB. */
     sizeInKb?: string;
@@ -903,10 +888,10 @@ export type FileData = {
 };
 export type FileData_PDFSettings = {
     /**
-     * PDF view mode. Possible values:
-     *  - `NONE`: The PDF isn't displayed.
-     *  - `FULL`: A full PDF page view is displayed.
-     *  - `MINI`: A mini view of the PDF is displayed.
+     * PDF view mode. Supported values:
+     *  - `NONE`: PDF isn't displayed.
+     *  - `FULL`: Full PDF page view is displayed.
+     *  - `MINI`: Mini view of the PDF is displayed.
      */
     viewMode?: FileData_PDFSettings_ViewMode;
     /**
@@ -926,11 +911,11 @@ export declare const FileData_PDFSettings_ViewMode: {
     readonly FULL: "FULL";
     readonly MINI: "MINI";
 };
-/** A collection of images displayed together in a visually appealing and organized manner. */
+/** Collection of images displayed together. */
 export type GalleryNode = {
     /**
      * Node type.
-     *  Value: `GALLERY`
+     *  Must be `GALLERY`.
      */
     type: 'GALLERY';
     /** Gallery node details. */
@@ -945,9 +930,15 @@ export type GalleryData = {
     containerData?: PluginContainerData;
     /** Gallery appearance options. */
     options?: GalleryOptions;
-    /** Whether the expand button is disabled. Default: `false` */
+    /**
+     * Whether the expand button is disabled.
+     * Default: `false`
+     */
     disableExpand?: boolean;
-    /** Whether the download button is disabled. Default: `false` */
+    /**
+     * Whether the download button is disabled.
+     * Default: `false`
+     */
     disableDownload?: boolean;
 };
 export type GalleryOptions = {
@@ -959,15 +950,18 @@ export type GalleryOptions = {
     thumbnails?: GalleryOptions_Thumbnails;
 };
 export type GalleryOptions_Layout = {
-    /** Gallery layout type. Possible values: <br> - `COLLAGE`: Presents images in various sizes and positions, creating an artistic or dynamic layout. <br> - `MASONRY`: A grid-based design that places items in optimal positions based on available vertical space, creating an arrangement where items of varying heights fit together like bricks in a wall. <br> - `GRID`: A layout structure that organizes items into rows and columns, creating a clean, uniform, and visually appealing arrangement of images. <br> - `THUMBNAIL`: A smaller, scaled-down version of an image that serves as a preview. <br> - `SLIDER`: A component that allows users to browse through a set of images by sliding or swiping through them, typically in a confined viewing area. <br> - `SLIDESHOW`: A component that automatically or manually transitions through a set of images in a designated area. <br> - `PANORAMA`: Wide-angle or 360-degree image that allows users to view an extended horizontal view of a scene. <br> - `COLUMN`: Arrangement of the gallery items in vertical sections. <br> - `MAGIC`: Visually stunning, dynamic effects that enhance the user experience. <br> - `FULLSIZE`: A layout where each image or item is displayed at its full size, taking up the entire viewport or a significant portion of the screen.. */
+    /** Gallery layout. Supported values: <br> - `COLLAGE`: Presents images in various sizes and positions, creating an artistic or dynamic layout. <br> - `MASONRY`: Grid-based design that places items in optimal positions based on available vertical space, creating an arrangement where items of varying heights fit together like bricks in a wall. <br> - `GRID`: A layout structure that organizes items into rows and columns, creating a uniform arrangement of images. <br> - `THUMBNAIL`: Smaller, scaled-down version of an image that serves as a preview. <br> - `SLIDER`: Component that allows users to browse through a set of images by sliding or swiping through them, typically in a confined viewing area. <br> - `SLIDESHOW`: A component that automatically or manually transitions through a set of images in a designated area. <br> - `PANORAMA`: Wide-angle or 360-degree image that allows users to view an extended horizontal view of a scene. <br> - `COLUMN`: Arrangement of the gallery items in vertical sections. <br> - `MAGIC`: Visually stunning, dynamic effects that enhance the user experience. <br> - `FULLSIZE`: A layout where each image or item is displayed at its full size, sometimes  taking up the entire viewport or a significant portion of the screen. */
     type?: GalleryOptions_Layout_Type;
-    /** Whether the horizontal scroll is enabled. Default: `true`, unless the `type` field is set to `GRID` or `COLLAGE`. */
+    /**
+     * Whether the horizontal scroll is enabled.
+     * Default: `true`, unless the `type` field is set to `GRID` or `COLLAGE`.
+     */
     horizontalScroll?: boolean;
-    /** Gallery orientation. Possible values: <br> - `ROWS`: Gallery items are arranged horizontally in rows. <br> - `COLUMNS`: Gallery items are arranged vertically in columns. */
+    /** Gallery orientation. */
     orientation?: GalleryOptions_Layout_Orientation;
-    /** The number of columns to display on computer screens. */
+    /** Number of columns to display on computer screens. */
     numberOfColumns?: number;
-    /** The number of columns to display on mobile phone screens. */
+    /** Number of columns to display on mobile phone screens. */
     mobileNumberOfColumns?: number;
 };
 export type GalleryOptions_Layout_Type = 'COLLAGE' | 'MASONRY' | 'GRID' | 'THUMBNAIL' | 'SLIDER' | 'SLIDESHOW' | 'PANORAMA' | 'COLUMN' | 'MAGIC' | 'FULLSIZE';
@@ -989,13 +983,13 @@ export declare const GalleryOptions_Layout_Orientation: {
     readonly COLUMNS: "COLUMNS";
 };
 export type GalleryOptions_ItemStyle = {
-    /** Dimension for each gallery item in pixels (behavaior changes according to a gallery type). */
+    /** Dimensions for each gallery item in pixels. Behavior may change with gallery type. */
     targetSize?: number;
-    /** Item ratio */
+    /** Height to width ratio. */
     ratio?: number;
-    /** Sets how gallery item images are cropped. Possible values: <br> - `FILL`: Each item in the gallery is cropped and resized to completely fill its container, ensuring that no empty space is left while maintaining the aspect ratio of the original image. <br> - `FIT`: Each item in the gallery is resized to fit entirely in its container without any cropping. */
+    /** Cropping strategy. Supported values: <br> - `FILL`: Each item in the gallery is cropped and resized to completely fill its container. <br> - `FIT`: Each item in the gallery is resized to fit exactly in its container without cropping. */
     crop?: GalleryOptions_ItemStyle_Crop;
-    /** The spacing between gallery items in pixels. */
+    /** Spacing between gallery items in pixels. */
     spacing?: number;
 };
 export type GalleryOptions_ItemStyle_Crop = 'FILL' | 'FIT';
@@ -1004,7 +998,7 @@ export declare const GalleryOptions_ItemStyle_Crop: {
     readonly FIT: "FIT";
 };
 export type GalleryOptions_Thumbnails = {
-    /** Thumbnail alignment. Possible values: <br> - `TOP` <br> - `RIGHT` <br> - `BOTTOM` <br> - `LEFT` <br> - `NONE` */
+    /** Thumbnail alignment. */
     placement?: GalleryOptions_Thumbnails_Alignment;
     /** Spacing between thumbnails in pixels. */
     spacing?: number;
@@ -1036,14 +1030,14 @@ export type GalleryData_Item_Video = {
 export type GalleryData_Item_Image = {
     /** Image file details. */
     media: Media;
-    /** Link details for images that are links. */
+    /** Link details for images, if relevant. */
     link?: Link;
 };
-/** GIF images are made up of a series of frames, allowing them to display animations or short video clips without the need for additional plugins or technologies. */
+/** GIF images. */
 export type GifNode = {
     /**
      * Node type.
-     *  Value: `GIF`
+     *  Must be `GIF`.
      */
     type: 'GIF';
     /** GIF details. */
@@ -1053,7 +1047,7 @@ export type GifNode = {
     nodes?: CaptionNode[];
 };
 export type GIFData = {
-    /** Styling for the GIF container, such as dimensions and alignment. */
+    /** GIF container styling. */
     containerData?: PluginContainerData;
     /** Source for the full size GIF. */
     original?: GIF;
@@ -1065,18 +1059,18 @@ export type GIFData = {
     width?: number;
 };
 export type GIF = {
-    /** URL for a file in GIF format. */
+    /** GIF source URL. */
     gif?: string;
-    /** URL for a file in MP4 format. */
+    /** MP4 source URL. */
     mp4?: string;
     /** GIF thumbnail URL. */
     still?: string;
 };
-/** Incorporates external content, such as interactive maps, or entire web pages. */
+/** HTML block that incorporates external content, such as interactive maps or entire web pages. */
 export type HtmlNode = {
     /**
      * Node type.
-     *  Value: `HTML`
+     *  Mst be `HTML`.
      */
     type: 'HTML';
     /** HTML details. */
@@ -1091,7 +1085,7 @@ export type HTMLData = {
     /**
      * HTML code type. Possible values:
      *  - `HTML`: HTML code.
-     *  - [`ADSENSE`](https://adsense.google.com/start/): A service provided by Google for serving advertisements on web pages.
+     *  - [`ADSENSE`](https://adsense.google.com/start/): Service provided by Google for rendering advertisements on web pages.
      */
     source?: HTMLData_Source;
     /** HTML code URL. */
@@ -1104,11 +1098,11 @@ export declare const HTMLData_Source: {
     readonly HTML: "HTML";
     readonly ADSENSE: "ADSENSE";
 };
-/** Displays standalone pictures in a page. */
+/** Standalone images in a page. */
 export type ImageNode = {
     /**
      * Node type.
-     *  Value: `IMAGE`
+     *  Must be `IMAGE`.
      */
     type: 'IMAGE';
     /** Image options. */
@@ -1118,18 +1112,18 @@ export type ImageNode = {
     nodes?: CaptionNode[];
 };
 export type ImageData = {
-    /** Image file details, such as source and dimensions. */
+    /** Image file details. */
     image: Media;
-    /** Styling for the image container, such as dimensions and alignment. */
+    /** Image container styling. */
     containerData?: PluginContainerData;
-    /** Link details, such as URL, or anchor, if image is also used as a link. */
+    /** Image link details. */
     link?: Link;
     /**
      * Whether the image expands to the full screen when clicked.
      *  Default: `false`
      */
     disableExpand?: boolean;
-    /** An alternate text for an image. Used for improved accessibility and shown when the image can't be displayed. */
+    /** Alternate text to display when the image doesn't load. */
     altText?: string;
     /** Deprecated. Use `CaptionNode` instead. */
     caption?: string;
@@ -1139,11 +1133,11 @@ export type ImageData = {
      */
     disableDownload?: boolean;
 };
-/** A preview or summary of a webpage. Link previews include elements such as the title of the linked page, a brief description or excerpt of the content, and possibly a thumbnail image or other relevant information. */
+/** Preview or summary of a webpage. Link previews include elements such as the title of the linked page, a brief description or excerpt of the content, and sometimes a thumbnail image or other relevant information. */
 export type LinkPreviewNode = {
     /**
      * Node type.
-     *  Value: `LINK_PREVIEW`
+     *  Must be `LINK_PREVIEW`.
      */
     type: 'LINK_PREVIEW';
     /** Link preview details. */
@@ -1166,11 +1160,11 @@ export type LinkPreviewData = {
     /** Preview content as HTML. */
     html?: string;
 };
-/** A node that allows users to vote or express their opinions on a particular question, topic, or issue. */
+/** Provides a question with several options, where the options' cumulative total may be shown. */
 export type PollNode = {
     /**
      * Node type.
-     *  Value: `POLL`
+     *  Must be `POLL`.
      */
     type: 'POLL';
     /** Poll details. */
@@ -1211,7 +1205,7 @@ export type PollData_Poll_Option = {
     image?: Media;
 };
 export type PollData_Poll_Settings = {
-    /** Permission settings for voting. */
+    /** Voting permission settings. */
     permissions?: PollData_Poll_Settings_Permissions;
     /**
      * Whether to display the voters in the vote results.
@@ -1225,21 +1219,12 @@ export type PollData_Poll_Settings = {
     showVotesCount?: boolean;
 };
 export type PollData_Poll_Settings_Permissions = {
-    /**
-     * Who can view the poll results. Possible values:
-     *  - `CREATOR`: Only poll creator can see the results.
-     *  - `VOTERS`: Only voters can see the results.
-     *  - `EVERYONE`: Anyone who visits the site can see the results.
-     */
+    /** Who can view the poll results. */
     view?: PollData_Poll_Settings_Permissions_ViewRole;
-    /**
-     * Who can vote. Possble values:
-     *  - `SITE_MEMBERS`: Only site members can vote.
-     *  - `ALL`: All site visitors can vote.
-     */
+    /** Who can vote. */
     vote?: PollData_Poll_Settings_Permissions_VoteRole;
     /**
-     * Whether one site visitor can vote multiple times.
+     * Whether a user can vote multiple times.
      *  Default: `false`
      */
     allowMultipleVotes?: boolean;
@@ -1262,9 +1247,9 @@ export type PollData_Layout = {
     options?: PollData_Layout_OptionLayout;
 };
 export type PollData_Layout_PollLayout = {
-    /** Voting options layout. Possible values: <br> - `LIST`: Options are displayed as a list. <br> - `GRID`: Options are displayed in a grid.. */
+    /** Voting options layout. */
     type?: PollData_Layout_PollLayout_Type;
-    /** Direction of the text in the poll. Possible values: <br> - `LTR`: Left to right. <br> - `RTL`: Right to left. */
+    /** Direction of the text in the poll. Supported values: <br> - `LTR`: Left to right. <br> - `RTL`: Right to left. */
     direction?: PollData_Layout_PollLayout_Direction;
     /**
      * Whether to display the main poll image.
@@ -1310,7 +1295,7 @@ export declare const PollData_Design_PollDesign_Background_Type: {
 };
 export type PollData_Background_ColorVariant = {
     type: 'COLOR';
-    /** The background color in a hexademical value. */
+    /** Background color as a hexademical value. */
     color?: string;
 };
 export type PollData_Background_ImageVariant = {
@@ -1328,18 +1313,18 @@ export type PollData_Design_PollDesign_Background_Gradient = {
     angle?: number;
     /** Start color as a hexadecimal value. */
     startColor?: string;
-    /** end color as a hexadecimal value. */
+    /** End color as a hexadecimal value. */
     lastColor?: string;
 };
 export type PollData_Design_OptionDesign = {
     /** Border radius in pixels. */
     borderRadius?: number;
 };
-/** A structural node used to display data in rows and columns. */
+/** Data in rows and columns. */
 export type TableNode = {
     /**
      * Node type.
-     *  Value: `TABLE`
+     *  Must be `TABLE`.
      */
     type: 'TABLE';
     nodes: TableRowNode[];
@@ -1351,7 +1336,7 @@ export type TableNode = {
 export type TableRowNode = {
     /**
      * Node type.
-     *  Value: `TABLE_ROW`
+     *  Must be `TABLE_ROW`.
      */
     type: 'TABLE_ROW';
     nodes: TableCellNode[];
@@ -1359,7 +1344,7 @@ export type TableRowNode = {
     id?: string;
 };
 export type TableData = {
-    /** Styling for the table container, such as dimensions and alignment. */
+    /** Table container styling. */
     containerData?: PluginContainerData;
     /** Table dimensions. */
     dimensions?: TableData_Dimensions;
@@ -1376,7 +1361,7 @@ export type TableData_Dimensions = {
 export type TableCellNode = {
     /**
      * Node type.
-     *  Value: `TABLE_CELL`
+     *  Must be `TABLE_CELL`.
      */
     type: 'TABLE_CELL';
     nodes: TableCellChildNode[];
@@ -1388,20 +1373,15 @@ export type TableCellNode = {
 /** Table cell content node. */
 export type TableCellChildNode = ParagraphNode | HeadingNode | BulletedListNode | OrderedListNode | BlockquoteNode | AudioNode | FileNode | ImageNode | VideoNode | GifNode | DividerNode | CodeBlockNode | HtmlNode | LinkPreviewNode | AppEmbedNode | ButtonNode | EmbedNode;
 export type TableCellData = {
-    /** Styling for the cell, such as background color and text alignment. */
+    /** Cell styling. */
     cellStyle?: TableCellData_CellStyle;
     /** Cell border colors. */
     borderColors?: TableCellData_BorderColors;
 };
 export type TableCellData_CellStyle = {
-    /**
-     * Vertical alignment for the cell's text. Possible values:
-     *  - `TOP`: Aligns the top padding edge of the cell with the top of the row.
-     *  - `MIDDLE`: Centers the padding box of the cell in the row.
-     *  - `BOTTOM`: Aligns the bottom padding edge of the cell with the bottom of the row.
-     */
+    /** Vertical alignment for the cell's text. */
     verticalAlignment?: TableCellData_VerticalAlignment;
-    /** Cell background color in a hexadecimal value, for example `#4287f5`. */
+    /** Cell background color as a hexadecimal value. */
     backgroundColor?: string;
 };
 export type TableCellData_VerticalAlignment = 'TOP' | 'MIDDLE' | 'BOTTOM';
@@ -1411,20 +1391,20 @@ export declare const TableCellData_VerticalAlignment: {
     readonly BOTTOM: "BOTTOM";
 };
 export type TableCellData_BorderColors = {
-    /** Left border color in a hexadecimal value. */
+    /** Left border color as a hexadecimal value. */
     left?: string;
-    /** Right border color in a hexadecimal value. */
+    /** Right border color as a hexadecimal value. */
     right?: string;
-    /** Top border color in a hexadecimal value. */
+    /** Top border color as a hexadecimal value. */
     top?: string;
-    /** Bottom border color in a hexadecimal value. */
+    /** Bottom border color as a hexadecimal value. */
     bottom?: string;
 };
-/** A multimedia node that is used to embed and play video content directly in a page. When rendered, it is displayed as the video player with the specified video file. Users can interact with the controls to play, pause, rewind, and adjust the volume of the video. */
+/** Embeds and plays video content directly in a page. When rendered, it is displayed as the video player with the specified video file. Users can interact with the controls to play, pause, rewind, and adjust the volume of the video. */
 export type VideoNode = {
     /**
      * Node type.
-     *  Value: `VIDEO`
+     *  Must be `VIDEO`.
      */
     type: 'VIDEO';
     /** Video details. */
@@ -1434,11 +1414,11 @@ export type VideoNode = {
     nodes?: CaptionNode[];
 };
 export type VideoData = {
-    /** Video file details, such as source and dimensions. */
+    /** Video file details. */
     video: Media;
-    /** Styling for the video container, such as dimensions and alignment. */
+    /** Video container styling. */
     containerData?: PluginContainerData;
-    /** Video thumbnail details, such as dimensions. */
+    /** Video thumbnail details. */
     thumbnail?: Media;
     /**
      * Whether the video download button is disabled.
@@ -1458,7 +1438,7 @@ export type PlaybackOptions = {
     /** Whether to show the media controls. */
     showControls?: boolean;
 };
-/** Represents nodes that can be added to the root level of `nodes` array. */
+/** Nodes that can be added to the root level of `nodes` array. */
 export type RootNode = ParagraphNode | HeadingNode | BulletedListNode | OrderedListNode | BlockquoteNode | CodeBlockNode | VideoNode | DividerNode | FileNode | GalleryNode | GifNode | HtmlNode | ImageNode | LinkPreviewNode | PollNode | AppEmbedNode | ButtonNode | CollapsibleListNode | TableNode | EmbedNode | AudioNode;
 export declare const LATEST_VERSION = 1;
 export type RicosDocumentNode = ParagraphNode | TextNode | HeadingNode | BulletedListNode | OrderedListNode | ListItemNode | BlockquoteNode | CodeBlockNode | VideoNode | DividerNode | FileNode | GalleryNode | GifNode | HtmlNode | ImageNode | LinkPreviewNode | PollNode | AppEmbedNode | ButtonNode | CollapsibleListNode | CollapsibleItemNode | CollapsibleItemTitleNode | CollapsibleItemBodyNode | TableNode | EmbedNode | TableCellNode | TableRowNode | AudioNode;