Merge branch 'next' into toolbar-restructuring-4915

Author: mafanya23

docs/api/api_overview.md

@@ -70,6 +70,7 @@ Parameters:
 | [](api/spreadsheet_afterclear_event.md)         | @getshort(api/spreadsheet_afterclear_event.md)         |
 | [](api/spreadsheet_aftercolumnadd_event.md)     | @getshort(api/spreadsheet_aftercolumnadd_event.md)     |
 | [](api/spreadsheet_aftercolumndelete_event.md)  | @getshort(api/spreadsheet_aftercolumndelete_event.md)  |
+| [](api/spreadsheet_afterdataloaded_event.md)    | @getshort(api/spreadsheet_afterdataloaded_event.md)    |
 | [](api/spreadsheet_aftereditend_event.md)       | @getshort(api/spreadsheet_aftereditend_event.md)       |
 | [](api/spreadsheet_aftereditstart_event.md)     | @getshort(api/spreadsheet_aftereditstart_event.md)     |
 | [](api/spreadsheet_afterfocusset_event.md)      | @getshort(api/spreadsheet_afterfocusset_event.md)      |

docs/api/overview/events_overview.md

@@ -12,6 +12,7 @@ description: You can have an Events overview of the DHTMLX JavaScript Spreadshee
 | [](../spreadsheet_afterclear_event.md)         | @getshort(../spreadsheet_afterclear_event.md)         |
 | [](../spreadsheet_aftercolumnadd_event.md)     | @getshort(../spreadsheet_aftercolumnadd_event.md)     |
 | [](../spreadsheet_aftercolumndelete_event.md)  | @getshort(../spreadsheet_aftercolumndelete_event.md)  |
+| [](../spreadsheet_afterdataloaded_event.md)  	 | @getshort(../spreadsheet_afterdataloaded_event.md)    |
 | [](../spreadsheet_aftereditend_event.md)       | @getshort(../spreadsheet_aftereditend_event.md)       |
 | [](../spreadsheet_aftereditstart_event.md)     | @getshort(../spreadsheet_aftereditstart_event.md)     |
 | [](../spreadsheet_afterfocusset_event.md)      | @getshort(../spreadsheet_afterfocusset_event.md)      |

docs/api/spreadsheet_afterdataloaded_event.md

@@ -0,0 +1,40 @@
+---
+sidebar_label: afterDataLoaded
+title: afterDataLoaded event
+description: You can learn about the afterDataLoaded event in the documentation of the DHTMLX JavaScript Spreadsheet library. Browse developer guides and API reference, try out code examples and live demos, and download a free 30-day evaluation version of DHTMLX Spreadsheet.
+---
+
+# afterDataLoaded
+
+### Description
+
+@short: Fires after data loading is complete
+
+### Usage
+
+~~~jsx
+afterColumnAdd: (cell: string) => void;
+~~~
+
+### Example
+
+~~~jsx 
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {});
+spreadsheet.parse(data);
+
+// subscribe to the "afterDataLoaded" event
+spreadsheet.events.on("afterDataLoaded", () => {
+    dhx.message({
+        text: "Data is successfully loaded into Spreadsheet!",
+        css: "dhx_message--success",
+        expire: 5000
+    });
+});
+~~~
+
+**Change log:** Added in v5.2
+
+**Related article:** [Event handling](handling_events.md)
+
+**Related sample:** [Spreadsheet. Data loaded event](https://snippet.dhtmlx.com/vxr7amz6)
+

docs/migration.md

@@ -8,6 +8,8 @@ description: You can learn about migration in the documentation of the DHTMLX Ja
 
 ## 5.1 -> 5.2
 
+### toolbarBlocks
+
 In v5.2 the [toolbarBlocks](api/spreadsheet_toolbarblocks_config.md) property is modified in the following way:
 
 - the default set of toolbar options is extended by the new *"cell"* option. It includes the *Border* button and the *Merge* button (previously, it was in the *"align"* block) 
@@ -40,6 +42,47 @@ toolbarBlocks: [
 ]
 ~~~
 
+### Freezing/unfreezing functionality
+
+In v5.2 the way of freezing/unfreezing columns and rows has been modified:
+
+- the `leftSplit` and `topSplit` configuration properties that have been used for fixing columns and rows were deprecated
+- new API methods `freezeCols()`, `unfreezeCols()`, `freezeRows()`, `unfreezeRows()` and a new action `toggleFreeze` were introduced
+
+~~~jsx title="Before v5.0"
+const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
+    topSplit: 1, // the number of row to "freeze"
+    leftSplit: 1 // the number of columns to "freeze"
+});
+~~~
+
+~~~jsx title="From v5.0" 
+// for rows
+spreadsheet.freezeRows("B2"); // the rows up to the second row will be fixed
+spreadsheet.freezeRows("sheet2!B2"); // the rows up to the second row in "sheet2" will be fixed
+spreadsheet.unfreezeRows(); // fixed rows in the current sheet will be unfrozen
+spreadsheet.unfreezeRows("sheet2!A1"); // fixed rows in "sheet2" will be unfrozen
+
+// for columns
+spreadsheet.freezeCols("B2"); // the columns up to the "B" column will be fixed
+spreadsheet.freezeCols("sheet2!B2"); // the columns up to the "B" column in "sheet2" will be fixed
+spreadsheet.unfreezeCols(); // fixed columns in the current sheet will be unfrozen
+spreadsheet.unfreezeCols("sheet2!A1"); // fixed columns in "sheet2" will be unfrozen
+
+// using the `toggleFreeze` action with the beforeAction/afterAction events
+spreadsheet.events.on("afterAction", (actionName, config) => {
+    if (actionName === "toggleFreeze") {
+        console.log(actionName, config);
+    }
+});
+
+spreadsheet.events.on("beforeAction", (actionName, config) => {
+    if (actionName === "toggleFreeze") {
+        console.log(actionName, config);
+    }
+});
+~~~
+
 ## 4.3 -> 5.0
 
 In v5.0, the *"help"* option of the [toolbarBlocks](api/spreadsheet_toolbarblocks_config.md) property is renamed to *"helpers"*. Besides, the default set of options is extended by the new *"actions"* option.

docs/whats_new.md

@@ -14,14 +14,35 @@ Released on May X, 2025
 
 [Review of release on the blog](https://dhtmlx.com/blog/dhtmlx-spreadsheet-5-2/)
 
+### Breaking changes
+
+The new release introduces some changes to the `toolbarBlocks` property and the freezing/unfreezing functionality for columns and rows. Check the [Migration guide](migration.md/#51---52) to keep in step with the latest version.
+
+### Deprecated
+
+- The `leftSplit` and `topSplit` configuration properties are removed
+
 ### New functionality
 
-- Ability to create a styled border for a group of cells
-- Ability to freeze columns and rows (both via the API and from the UI)
-- Ability to hide columns and rows (both via the API and from the UI)
-- A popup with descriptions for formulas is added
-    - a new locale: `formulas`
-- A new `afterDataLoaded` event is added to indicate that the file import is complete 
+- Editing cells:
+    - the ability to create a styled border for a group of cells via UI
+- Freezing/unfreezing columns/rows:
+    - the ability to freeze/unfreeze columns and rows via UI
+    - the ability to freeze/unfreeze columns and rows via API
+        - new methods: `freezeCols()`, `unfreezeCols()`, `freezeRows()`, `unfreezeRows()`
+        - new action: `toggleFreeze` 
+        - new `freeze` property for the *sheets* object of the `parse()` method
+- Hiding/showing columns/rows:
+    - the ability to hide/show columns and rows via UI
+    - the ability to hide/show columns and rows via API
+        - new methods: `hideCols()`, `showCols()`, `hideRows()`, `showRows()`
+        - new action: `toggleVisibility` 
+        - new `hidden` property for the *cols* and *rows* configs of the *sheets* object of the `parse()` method
+- Working with formulas:
+    - a popup with descriptions for formulas is added
+    - a new locale: `formulas` is added
+- File import: 
+    - a new [`afterDataLoaded`](api/spreadsheet_afterdataloaded_event.md) event is added  
 
 ### Fixes
 

sidebars.js

@@ -102,6 +102,7 @@ module.exports = {
                         "api/spreadsheet_afterclear_event",
                         "api/spreadsheet_aftercolumnadd_event",
                         "api/spreadsheet_aftercolumndelete_event",
+                        "api/spreadsheet_afterdataloaded_event",
                         "api/spreadsheet_aftereditend_event",
                         "api/spreadsheet_aftereditstart_event",
                         "api/spreadsheet_afterfocusset_event",