@divkitframework/jsonbuilder 29.3.0 → 29.5.0

package/dist/jsonbuilder.d.ts

@@ -327,8 +327,8 @@ interface IDivAction {
      */
     download_callbacks?: Type<IDivDownloadCallbacks>;
     /**
-     * This parameter allows you to disable the action for any reason. When an action is disabled, it
-     * stops responding to the event associated with it (click, change in visibility, etc.).
+     * The parameter disables the action. Disabled actions stop listening to their associated event
+     * (clicks, changes in visibility, and so on).
      */
     is_enabled?: Type<IntBoolean | DivExpression>;
     /**
@@ -796,29 +796,30 @@ interface DivCircleShapeProps {
 
 interface IDivCollectionItemBuilder {
     /**
-     * Data that will be used to create collection items.
+     * Data that will be used to create collection elements.
      */
     data: Type<unknown[] | DivExpression>;
     /**
-     * Prefix for accessing the next `data` element in the prototype.
+     * Name for accessing the next `data` element in the prototype. Working with this element is like
+     * working with DivKit dictionaries.
      */
-    data_element_prefix?: Type<string>;
+    data_element_name?: Type<string>;
     /**
-     * Array of `div` from which the collection items will be created.
+     * Array of `div` elements from which the collection elements will be created.
      */
     prototypes: Type<NonEmptyArray<IDivCollectionItemBuilderPrototype>>;
 }
 interface IDivCollectionItemBuilderPrototype {
     /**
-     * `Div` from which the collection items will be created. In `Div`, you can use expressions using
-     * data from `data`, to access the next `data` element, you need to use the same prefix as in
-     * `data_element_prefix`.
+     * `Div` from which the collection elements will be created. In `Div`, you can use expressions
+     * using data from `data`. To access the next `data` element, you need to use the same prefix as
+     * in `data_element_prefix`.
      */
     div: Type<Div>;
     /**
-     * A condition that is used to select a prototype for the next item in the collection. If there
-     * is more than 1 true condition, the prototype that is earlier will be selected. If none of the
-     * conditions are met, the data element will be skipped.
+     * A condition that is used to select the prototype for the next element in the collection. If
+     * there is more than 1 true condition, the earlier prototype is selected. If none of the
+     * conditions are met, the element from `data` is skipped.
      */
     selector?: Type<IntBoolean | DivExpression>;
 }
@@ -876,7 +877,7 @@ declare class DivContainer<T extends DivContainerProps = DivContainerProps> {
      */
     border?: Type<IDivBorder>;
     /**
-     * Parameter that determines whether child elements are bounded by the parent's boundaries.
+     * Enables the bounding of child elements by the parent's borders.
      */
     clip_to_bounds?: Type<IntBoolean | DivExpression>;
     /**
@@ -924,7 +925,7 @@ declare class DivContainer<T extends DivContainerProps = DivContainerProps> {
      */
     id?: Type<string>;
     /**
-     * A way to set collection items dynamically using data and prototypes.
+     * Sets collection elements dynamically using `data` and `prototypes`.
      */
     item_builder?: Type<IDivCollectionItemBuilder>;
     /**
@@ -1071,7 +1072,7 @@ interface DivContainerPropsBase {
      */
     border?: Type<IDivBorder>;
     /**
-     * Parameter that determines whether child elements are bounded by the parent's boundaries.
+     * Enables the bounding of child elements by the parent's borders.
      */
     clip_to_bounds?: Type<IntBoolean | DivExpression>;
     /**
@@ -1119,7 +1120,7 @@ interface DivContainerPropsBase {
      */
     id?: Type<string>;
     /**
-     * A way to set collection items dynamically using data and prototypes.
+     * Sets collection elements dynamically using `data` and `prototypes`.
      */
     item_builder?: Type<IDivCollectionItemBuilder>;
     /**
@@ -1227,7 +1228,7 @@ interface DivContainerProps0 extends DivContainerPropsBase {
 }
 interface DivContainerProps1 extends DivContainerPropsBase {
     /**
-     * A way to set collection items dynamically using data and prototypes.
+     * Sets collection elements dynamically using `data` and `prototypes`.
      */
     item_builder: Type<IDivCollectionItemBuilder>;
 }
@@ -1626,8 +1627,8 @@ interface IDivDisappearAction {
      */
     download_callbacks?: Type<IDivDownloadCallbacks>;
     /**
-     * This parameter allows you to disable the action for any reason. When an action is disabled, it
-     * stops responding to the event associated with it (click, change in visibility, etc.).
+     * The parameter disables the action. Disabled actions stop listening to their associated event
+     * (clicks, changes in visibility, and so on).
      */
     is_enabled?: Type<IntBoolean | DivExpression>;
     /**
@@ -2051,10 +2052,10 @@ declare class DivGallery<T extends DivGalleryProps = DivGalleryProps> {
      */
     scroll_mode?: Type<DivGalleryScrollMode | DivExpression>;
     /**
-     * Scrollbar behaviour. Hidden by default. On different platforms, the scrollbar may occupy a
-     * different space, since this is a user setting. Consider this in sizes. `none` — scrollbar is
-     * hidden.`auto` — scrollbar is shown if there is not enough space and is necessary out the
-     * current platform.
+     * Scrollbar behavior. Hidden by default. When choosing a gallery size, keep in mind that the
+     * scrollbar may have a different height and width depending on the platform and user settings.
+     * `none` — the scrollbar is hidden.`auto` — the scrollbar is shown if there isn't enough space
+     * and it needs to be displayed on the current platform.
      */
     scrollbar?: Type<DivGalleryScrollbar | DivExpression>;
     /**
@@ -2228,10 +2229,10 @@ interface DivGalleryProps {
      */
     scroll_mode?: Type<DivGalleryScrollMode | DivExpression>;
     /**
-     * Scrollbar behaviour. Hidden by default. On different platforms, the scrollbar may occupy a
-     * different space, since this is a user setting. Consider this in sizes. `none` — scrollbar is
-     * hidden.`auto` — scrollbar is shown if there is not enough space and is necessary out the
-     * current platform.
+     * Scrollbar behavior. Hidden by default. When choosing a gallery size, keep in mind that the
+     * scrollbar may have a different height and width depending on the platform and user settings.
+     * `none` — the scrollbar is hidden.`auto` — the scrollbar is shown if there isn't enough space
+     * and it needs to be displayed on the current platform.
      */
     scrollbar?: Type<DivGalleryScrollbar | DivExpression>;
     /**
@@ -5857,8 +5858,8 @@ interface IDivSightAction {
      */
     download_callbacks?: Type<IDivDownloadCallbacks>;
     /**
-     * This parameter allows you to disable the action for any reason. When an action is disabled, it
-     * stops responding to the event associated with it (click, change in visibility, etc.).
+     * The parameter disables the action. Disabled actions stop listening to their associated event
+     * (clicks, changes in visibility, and so on).
      */
     is_enabled?: Type<IntBoolean | DivExpression>;
     /**
@@ -8362,8 +8363,8 @@ interface IDivVisibilityAction {
      */
     download_callbacks?: Type<IDivDownloadCallbacks>;
     /**
-     * This parameter allows you to disable the action for any reason. When an action is disabled, it
-     * stops responding to the event associated with it (click, change in visibility, etc.).
+     * The parameter disables the action. Disabled actions stop listening to their associated event
+     * (clicks, changes in visibility, and so on).
      */
     is_enabled?: Type<IntBoolean | DivExpression>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@divkitframework/jsonbuilder",
-    "version": "29.3.0",
+    "version": "29.5.0",
     "description": "DivKit TypeScript JSON Builder",
     "main": "./dist/jsonbuilder.js",
     "module": "./dist/es/jsonbuilder.js",