[update] correct and complete docs for v5.2

Author: mafanya23

docs/api/spreadsheet_parse_method.md

@@ -137,9 +137,8 @@ If you need to create a data set *for several sheets* at once, specify data as a
             - `column` - the index of the column
             - `row` - the index of the row
     - `freeze` - (optional) an object that sets and adjusts fixed columns/rows for particular sheets. It may contain the following properties:
-        - `col` - (optional) specifies the number of fixed columns, for example, 2 
-        - `row` - (optional) specifies the number of fixed rows, for example, 2 
-        The default value of the parameter is `freeze: {col: 0, row: 0}`
+        - `col` - (optional) specifies the number of fixed columns (e.g. 2), *0* by default
+        - `row` - (optional) specifies the number of fixed rows, (e.g. 2), *0* by default
 
 :::info
 In case the [`multisheets`](api/spreadsheet_multisheets_config.md) configuration option is set to *false*, only one sheet will be created.
@@ -172,7 +171,7 @@ const spreadsheet = new dhx.Spreadsheet("spreadsheet", {});
 spreadsheet.parse(data);
 ~~~
 
-~~~jsx {38} title="Example 2. Load data into several sheets"
+~~~jsx title="Example 2. Load data into several sheets"
 const data = {
     sheets : [
         { 
@@ -197,7 +196,11 @@ const data = {
                 { from: { column: 0, row: 0 }, to: { column: 1, row: 0 } },
                 // merge cells A2, A3, A4, and A5
                 { from: { column: 0, row: 1 }, to: { column: 0, row: 4 } }
-            ]
+            ],
+            freeze: {
+                col: 2,
+                row: 2
+            },
         }, 
         { 
             name: "sheet 2", 
@@ -278,10 +281,11 @@ but in some cases they may not work in the way you expect (for example, when app
 
 **Change log:**
 
+- The **freeze** property and the **hidden** parameter for the **rows** and **cols** properties of the **sheets** object were added in v5.2
 - The **locked** and **link** properties of the **cell** object were added in v5.1
-- The **merged** property of the **sheet** object was added in v5.0
+- The **merged** property of the **sheets** object was added in v5.0
 - The **editor** property of the **cell** object was added in v4.3
-- The **rows** and **cols** properties of the **sheet** object were added in v4.2
+- The **rows** and **cols** properties of the **sheets** object were added in v4.2
 - The ability to prepare data for several sheets was added in v4.1
 
 **Related articles:** [Data loading and export](loading_data.md)

docs/api/spreadsheet_sortcells_method.md

@@ -27,7 +27,7 @@ sortCells(cell: string, dir: number): void;
 
 ~~~jsx {7,10}
 const spreadsheet = new dhx.Spreadsheet("spreadsheet", {
-    topSplit: 1
+    // configuration parameters
 });
 spreadsheet.parse(data);
 
@@ -38,9 +38,6 @@ spreadsheet.sortCells("B2:B11", -1);
 spreadsheet.sortCells("Income!B2:B11, Report!B2:B11, Expenses!C2:C11", 1);
 ~~~
 
-:::info
-Use the [topSplit](api/spreadsheet_topsplit_config.md) property if you need to exclude the top rows from sorting.
-:::
 
 **Related sample:** [Spreadsheet. Initialization with multiple sheets](https://snippet.dhtmlx.com/ihtkdcoc)
 

docs/api/spreadsheet_toolbarblocks_config.md

@@ -24,7 +24,7 @@ toolbarBlocks: ["undo", "colors", "decoration", "align", "cell", "format", "acti
 
 ### Example
 
-~~~jsx {3-15}
+~~~jsx {3-17}
 const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
     // full toolbar
     toolbarBlocks: [
@@ -58,8 +58,9 @@ const spreadsheet = new dhx.Spreadsheet("spreadsheet_container", {
 Check how you can [customize the toolbar](customization.md/#toolbar).
 
 **Change log:**
-- The *"actions"* block is added in v5.0 
-- The *"cell"* block is added in v5.2
+
+- The *"cell"* block was added in v5.2
+- The *"actions"* block was added in v5.0 
 
 **Related articles:**
 - [Configuration](configuration.md#toolbar)

docs/customization.md

@@ -158,9 +158,15 @@ It is also possible to add the blocks enumerated below:
 - the **Rows** block
   - the *Add row* button (id: "add-row")
   - the *Remove row* button (id: "remove-row")
+  - the *Unfreeze rows* button (id: "unfreeze-rows")
+  - the *Freeze up to row [id]* (id: "freeze-rows")
+  - the *Hide row(s) [id]* (id: "hide-rows")
 - the **Columns** block
   - the *Add column* button (id: "add-col")
   - the *Remove column* button (id: "remove-col")
+  - the *Unfreeze columns* button (id: "unfreeze-cols")
+  - the *Freeze up to column [id]* (id: "freeze-cols")
+  - the *Hide column(s) [id]* (id: "hide-cols")
 - the **File** block
   - the *Export* menuItem (id: "export")
     - the *"Microsoft Excel(.xlsx)"* menuItem (id: "export-xlsx")
@@ -234,34 +240,40 @@ spreadsheet.toolbar.data.remove("undo");
 
 The [default menu](/#menu) has the following structure:
 
-- the **File** menuItem (id:"edit")
-  - the *Export* menuItem (id:"download")
-    - the *"Microsoft Excel(.xlsx)"* menuItem (id:"export-xlsx")
-  - the *Import* menuItem (id:"import")
-    - the *"Microsoft Excel(.xlsx)"* menuItem (id:"import-xlsx")
-- the **Edit** menuItem (id:"edit")
-  - the *Undo* menuItem (id:"undo")
-  - the *Redo* menuItem (id:"redo")
+- the **File** menuItem (id: "edit")
+  - the *Import as...* menuItem (id: "import")
+    - the *"Microsoft Excel(.xlsx)"* menuItem (id: "import-xlsx")
+  - the *Download as...* menuItem (id: "download")
+    - the *"Microsoft Excel(.xlsx)"* menuItem (id: "export-xlsx")
+- the **Edit** menuItem (id: "edit")
+  - the *Undo* menuItem (id: "undo")
+  - the *Redo* menuItem (id: "redo")
   - the separator
-  - the *Lock* menuItem (id:"lock")
+  - the *Freeze* menuItem (id: "freeze")
+    - the *Unfreeze columns* menuItem (id: "unfreeze-cols")
+    - the *Freeze up to column [id]* (id: "freeze-cols")
+    - the separator (id: "freeze-sep")
+    - the *Unfreeze rows* menuItem (id: "unfreeze-rows")
+    - the *Freeze up to row [id]* (id: "freeze-rows")
+  - the *Lock* menuItem (id: "lock")
   - the separator
-  - the *Clear* menuItem (id:"clear")
-    - the *Clear value* menuItem (id:"clear-value")
-    - the *Clear styles* menuItem (id:"clear-styles")
-    - the *Clear all* menuItem (id:"clear-all")
-- the **Insert** menuItem (id:"insert")
-  - the *Columns* menuItem (id:"columns")
-    - the *Add column* menuItem (id:"add-col")
-    - the *Remove column* menuItem (id:"remove-col")
-  - the *Rows* menuItem (id:"rows")
-    - the *Add row* menuItem (id:"add-row")
-    - the *Remove row* menuItem (id:"remove-row")
-  - the *Insert link* menuItem (id:"link")
-- the **Format** menuItem (id:"configuration")
-  - the *Bold* menuItem (id:"font-weight-bold")
-  - the *Italic* menuItem (id:"font-style-italic")
-  - the *Underline* menuItem (id:"text-decoration-underline")
-  - the *Strikethrough* menuItem (id:"text-decoration-line-through")
+  - the *Clear* menuItem (id: "clear")
+    - the *Clear value* menuItem (id: "clear-value")
+    - the *Clear styles* menuItem (id: "clear-styles")
+    - the *Clear all* menuItem (id: "clear-all")
+- the **Insert** menuItem (id: "insert")
+  - the *Columns* menuItem (id: "columns")
+    - the *Add column* menuItem (id: "add-col")
+    - the *Remove column* menuItem (id: "remove-col")
+  - the *Rows* menuItem (id: "rows")
+    - the *Add row* menuItem (id: "add-row")
+    - the *Remove row* menuItem (id: "remove-row")
+  - the *Insert link* menuItem (id: "link")
+- the **Format** menuItem (id: "configuration")
+  - the *Bold* menuItem (id: "font-weight-bold")
+  - the *Italic* menuItem (id: "font-style-italic")
+  - the *Underline* menuItem (id: "text-decoration-underline")
+  - the *Strikethrough* menuItem (id: "text-decoration-line-through")
   - the separator
   - the *Horizontal align* menuItem (id: "halign")
     - the *Left* menuItem (id: "halign-left")
@@ -274,16 +286,16 @@ The [default menu](/#menu) has the following structure:
   - the *Text wrapping* menuItem (id: "multiline")
     - the *Clip* menuItem (id: "multiline-clip")
     - the *Wrap* menuItem (id: "multiline-wrap")
-  - the *Format* menuItem (id:"format")
+  - the *Format* menuItem (id: "format")
   - the *Merge/Unmerge* menuItem (id: "merge")
-- the **Data** menuItem (id:"data")
-  - the *Data validation* menuItem (id:"validation")
-  - the *Search* menuItem (id:"search")
-  - the *Filter* menuItem (id:"filter")
-  - the *Sort* menuItem (id:"sort")
-    - the *Sort A to Z* menuItem (id:"asc-sort")
-    - the *Sort Z to A* menuItem (id:"desc-sort")
-- the **Help** menuItem (id:"help")
+- the **Data** menuItem (id: "data")
+  - the *Data validation* menuItem (id: "validation")
+  - the *Search* menuItem (id: "search")
+  - the *Filter* menuItem (id: "filter")
+  - the *Sort* menuItem (id: "sort")
+    - the *Sort A to Z* menuItem (id: "asc-sort")
+    - the *Sort Z to A* menuItem (id: "desc-sort")
+- the **Help** menuItem (id: "help")
 
 ### Adding controls
 
@@ -335,22 +347,30 @@ spreadsheet.menu.data.remove("undo");
 
 The [default context menu](/#context-menu) has the following structure:
 
-- the **Lock** menuItem (id:"lock")
-- the **Clear** menuItem (id:"clear")
-  - the *Clear value* menuItem (id:"clear-value")
-  - the *Clear styles* menuItem (id:"clear-styles")
-  - the *Clear all* menuItem (id:"clear-all")
-- the **Columns** menuItem (id:"columns")
-  - the *Add column* menuItem (id:"add-col")
-  - the *Remove column* menuItem (id:"remove-col")
-  - the *Fit to data* menuItem (id:"fit-col")
-- the **Rows** menuItem (id:"rows")
-  - the *Add row* menuItem (id:"add-row")
-  - the *Remove row* menuItem (id:"remove-row")
-- the **Sort** menuItem (id:"sort")
-  - the *Sort A to Z* menuItem (id:"asc-sort")
-  - the *Sort Z to A* menuItem (id:"desc-sort")
-- the **Insert link** menuItem (id:"link")
+- the **Lock** menuItem (id: "lock")
+- the **Clear** menuItem (id: "clear")
+  - the *Clear value* menuItem (id: "clear-value")
+  - the *Clear styles* menuItem (id: "clear-styles")
+  - the *Clear all* menuItem (id: "clear-all")
+- the **Columns** menuItem (id: "columns")
+  - the *Add column* menuItem (id: "add-col")
+  - the *Remove column* menuItem (id: "remove-col")
+  - the *Fit to data* menuItem (id: "fit-col")
+  - the separator
+  - the *Unfreeze columns* menuItem (id: "unfreeze-cols")
+  - the *Freeze up to column [id]* menuItem (id: "freeze-cols")
+  - the *Hide column(s) [id]* menuItem (id: "hide-cols")
+- the **Rows** menuItem (id: "rows")
+  - the *Add row* menuItem (id: "add-row")
+  - the *Remove row* menuItem (id: "remove-row")
+  - the separator
+  - the *Unfreeze rows* menuItem (id: "unfreeze-rows")
+  - the *Freeze up to row [id]* menuItem (id: "freeze-rows")
+  - the *Hide row(s) [id]* menuItem (id: "hide-rows")
+- the **Sort** menuItem (id: "sort")
+  - the *Sort A to Z* menuItem (id: "asc-sort")
+  - the *Sort Z to A* menuItem (id: "desc-sort")
+- the **Insert link** menuItem (id: "link")
 
 ### Adding controls
 

docs/localization.md

@@ -199,7 +199,7 @@ const spreadsheet = new dhx.Spreadsheet("spreadsheet_container");
 
 ## Default locale for formulas
 
-The i18n locale for the Spreadsheet popup with formulas is contained in the `dhx.i18n.formulas` object. The default locale for formulas is the following:
+The i18n locale for the Spreadsheet popup with descriptions for formulas is contained in the `dhx.i18n.formulas` object. The default locale for formulas is the following:
 
 ~~~jsx
 const en = {

docs/migration.md

@@ -8,55 +8,21 @@ 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) 
-- the *"actions"* toolbar block is extended with the *Insert link* button (previously, it was in the *"helpers"* block) 
-- the *"helpers"* toolbar block is renamed to *"help"* and isn't included in the default set of toolbar options
-
-~~~jsx title="Before v5.2" {9}
-// default configuration
-toolbarBlocks: [
-    "undo", 
-    "colors", 
-    "decoration", 
-    "align", 
-    "format", 
-    "actions",
-    "helpers"
-]
-~~~
-
-~~~jsx title="From v5.2" {7}
-// default configuration
-toolbarBlocks: [
-    "undo", 
-    "colors", 
-    "decoration", 
-    "align", 
-    "cell",
-    "format", 
-    "actions"
-]
-~~~
-
 ### 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"
+~~~jsx title="Before v5.2"
 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" 
+~~~jsx title="From v5.2" 
 // 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

docs/whats_new.md

@@ -10,7 +10,7 @@ If you are updating Spreadsheet from an older version, check [Migration to Newer
 
 ## Version 5.2
 
-Released on May X, 2025
+Released on May 20, 2025
 
 [Review of release on the blog](https://dhtmlx.com/blog/dhtmlx-spreadsheet-5-2/)
 
@@ -25,24 +25,24 @@ The new release introduces some changes to the `toolbarBlocks` property and the
 ### New functionality
 
 - Editing cells:
-    - the ability to create a styled border for a group of cells via UI
+    - the ability to [create a styled border for a group of cells via UI](data_formatting.md/#styled-borders-for-cells)
 - 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
+    - the ability to freeze/unfreeze columns and rows via [UI](work_with_rows_cols.md/#freezingunfreezing-rows-and-columns)
+    - the ability to freeze/unfreeze columns and rows via [API](working_with_ssheet.md/#freezingunfreezing-rows-and-columns)
+        - new methods: [`freezeCols()`](api/spreadsheet_freezecols_method.md), [`unfreezeCols()`](api/spreadsheet_unfreezecols_method.md), [`freezeRows()`](api/spreadsheet_freezerows_method.md), [`unfreezeRows()`](api/spreadsheet_unfreezerows_method.md)
+        - new action: [`toggleFreeze`](api/overview/actions_overview.md/#list-of-actions) 
+        - new `freeze` property for the *sheets* object of the [`parse()`](api/spreadsheet_parse_method.md) 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
+    - the ability to hide/show columns and rows via [UI](work_with_rows_cols.md/#hidingshowing-rows-and-columns)
+    - the ability to hide/show columns and rows via [API](working_with_ssheet.md/#hidingshowing-rows-and-columns)
+        - new methods: [`hideCols()`](api/spreadsheet_hidecols_method.md), [`showCols()`](api/spreadsheet_showcols_method.md), [`hideRows()`](api/spreadsheet_hiderows_method.md), [`showRows()`](api/spreadsheet_showrows_method.md)
+        - new action: [`toggleVisibility`](api/overview/actions_overview.md/#list-of-actions) 
+        - new `hidden` property for the *cols* and *rows* configs of the *sheets* object of the [`parse()`](api/spreadsheet_parse_method.md) method
 - Working with formulas:
-    - a popup with descriptions for formulas is added
-    - a new locale: `formulas` is added
+    - [popup with descriptions for formulas](functions.md/#popup-with-formula-description) is added
+    - new locale: [`formulas`](localization.md/#default-locale-for-formulas) is added
 - File import: 
-    - a new [`afterDataLoaded`](api/spreadsheet_afterdataloaded_event.md) event is added  
+    - new [`afterDataLoaded`](api/spreadsheet_afterdataloaded_event.md) event is added  
 
 ### Fixes
 
@@ -353,7 +353,7 @@ Version 4.3 doesn't bring any breaking changes but introduces a new way of handl
 ### New functionality
 
 - The ability to add a drop-down list of options into the cells via the [`setValidation()`](api/spreadsheet_setvalidation_method.md) method or via [UI](work_with_cells.md#using-drop-down-lists-in-cells)
-- The ability to fix rows on the top of the spreadsheet via the [`topSplit`](api/spreadsheet_topsplit_config.md) property
+- The ability to fix rows on the top of the spreadsheet via the `topSplit` property
 - The ability to sort data via the [`sortCells()`](api/spreadsheet_sortcells_method.md) method or via [UI](sorting_data.md)
 - [The ability to split long text into multiple lines](data_formatting.md#wrap-text-in-a-cell) (*Text wrapping* button is added into the toolbar)
 - Significantly extended list of supported [Date, Financial, Math, String functions](functions.md#information-functions) (marked with *added in v4.3* label)
@@ -540,7 +540,7 @@ Released on October 19, 2020
 
 - [Math functions](functions.md)
 - [TypeScript Support](using_typescript.md)
-- The ability [to freeze columns on the left side of the spreadsheet](configuration.md#frozen-rows-and-columns) via the [leftSplit](api/spreadsheet_leftsplit_config.md) configuration property
+- The ability to freeze columns on the left side of the spreadsheet via the `leftSplit` configuration property
 - [The Text format for displaying the content of a cell as text is added to default number formats](number_formatting.md#default-number-formats)
 - The ability to select multiple scattered ranges of cells by using ["Ctrl+Shift+Left Click"](hotkeys.md#selection) combination