@refinitiv-ui/efx-grid 6.0.39 → 6.0.40

package/lib/core/es6/grid/Core.js

@@ -31,6 +31,7 @@ import VirtualizedLayoutGrid from "./VirtualizedLayoutGrid.js";
 * @property {string} rowId
 * @property {number} rowIndex
 */
+/** @event Core#beforeContentBinding */
 /** @event Core#postSectionDataBinding */
 /** @event Core#rowHighlighted */
 
@@ -193,6 +194,7 @@ var Core = function (opt_initializer) {
 		"postDataSourceChanged",
 		"preSectionRender",
 		"postSectionRender",
+		"beforeContentBinding",
 		"preSectionDataBinding",
 		"postSectionDataBinding",
 		"rowExpansionBinding",
@@ -554,7 +556,7 @@ Core.prototype._batches = null;
 * @return {string}
 */
 Core.getVersion = function () {
-	return "5.1.55";
+	return "5.1.57";
 };
 /** {@link ElementWrapper#dispose}
 * @override
@@ -1356,6 +1358,7 @@ Core.prototype.getColumnCount = function () {
 * @fires Core#columnAdded
 * @fires Core#preSectionRender
 * @fires Core#columnRender
+* @fires Core#beforeContentBinding
 * @fires Core#preSectionDataBinding
 * @fires Core#columnDataBinding
 * @fires Core#postSectionDataBinding
@@ -1383,6 +1386,7 @@ Core.prototype.setColumnCount = function(num) {
 * @fires Core#columnAdded
 * @fires Core#preSectionRender
 * @fires Core#columnRender
+* @fires Core#beforeContentBinding
 * @fires Core#preSectionDataBinding
 * @fires Core#columnDataBinding
 * @fires Core#postSectionDataBinding
@@ -2001,6 +2005,7 @@ Core.prototype._deserializeColumn = function (index, jsonObj) {
 * @param {number=} opt_num Default is one row
 * @fires Core#preSectionRender
 * @fires Core#columnRender
+* @fires Core#beforeContentBinding
 * @fires Core#preSectionDataBinding
 * @fires Core#columnDataBinding
 * @fires Core#postSectionDataBinding
@@ -3804,6 +3809,7 @@ Core.prototype.synchronizeHScrollbar = function (subGrid) {
 * @param {number=} fromRowIndex INCLUSIVE If the value is undefined, the first row index will be used
 * @param {number=} lastRowIndex INCLUSIVE If the value is undefined, the last row index will be used
 * @param {Object=} userParam Addtional parameters to be fired with the event
+* @fires Core#beforeContentBinding
 * @fires Core#preSectionDataBinding
 * @fires Core#columnDataBinding
 * @fires Core#postSectionDataBinding
@@ -4881,6 +4887,9 @@ Core.prototype._onSectionDataChanged = function (e) {
 		rowDataCollection = dataView.getMultipleRowData(rids, fromR, toR);
 		e["dataRows"] = rowDataCollection;
 	}
+	if(e["sectionType"] === "content"){
+		this._dispatch("beforeContentBinding", e);
+	}
 	this._dispatch("preSectionDataBinding", e);
 
 	var dataMap = this.getDataColumnMap();

package/lib/core/es6/grid/plugins/SortableTitlePlugin.js

@@ -1525,8 +1525,11 @@ SortableTitlePlugin.prototype._onColumnAdded = function (e) {
 
 	var sortOrder = column["sortOrder"] || column["sort"];
 	if(sortOrder != null) {
-		t.clearSortState(); // clear previous sorting state
-		t.sortColumn(colIndex, sortOrder);
+		sortOrder = SortableTitlePlugin._toSortOrder(sortOrder); // Invalid input will return "n"
+		if(sortOrder !== "n") {
+			t.clearSortState(); // clear previous sorting state
+			t.sortColumn(colIndex, sortOrder);
+		}
 	}
 };
 

package/lib/grid/index.js

@@ -1,3 +1,3 @@
 import {Grid} from "./lib/efx-grid.js";
 export {Grid}
-window.EFX_GRID = { version: "6.0.39" };
+window.EFX_GRID = { version: "6.0.40" };

package/lib/row-segmenting/es6/RowSegmenting.js

@@ -33,7 +33,7 @@ import { injectCss, prettifyCss } from "../../tr-grid-util/es6/Util.js";
 */
 var RowSegmentingPlugin = function (options) {
 	var t = this;
-	t._onPostSectionDataBinding = t._onPostSectionDataBinding.bind(t);
+	t._onPreSectionDataBinding = t._onPreSectionDataBinding.bind(t);
 	t._updateHeader = t._updateHeader.bind(t);
 	t._onArrowClick = t._onArrowClick.bind(t);
 	t._rtSortingLogic = t._rtSortingLogic.bind(t);
@@ -128,7 +128,7 @@ RowSegmentingPlugin.prototype.initialize = function (host, options) {
 	ExpanderIcon.injectExpanderStyles(host.getElement());
 
 	this._hosts.push(host);
-	host.listen("postSectionDataBinding", this._onPostSectionDataBinding);
+	host.listen("preSectionDataBinding", this._onPreSectionDataBinding);
 
 	this.config(options);
 
@@ -182,7 +182,7 @@ RowSegmentingPlugin.prototype.unload = function (host) {
 	if (at < 0) {
 		return;
 	}
-	host.unlisten("postSectionDataBinding", this._onPostSectionDataBinding);
+	host.unlisten("preSectionDataBinding", this._onPreSectionDataBinding);
 	this._hosts.splice(at, 1);
 	this._dispose();
 };
@@ -338,7 +338,7 @@ RowSegmentingPlugin.prototype._injectStyles = function(predefinedColors) {
 /** @private
 * @param {Object} e
 */
-RowSegmentingPlugin.prototype._onPostSectionDataBinding = function (e) {
+RowSegmentingPlugin.prototype._onPreSectionDataBinding = function (e) {
 	this._updateHeader(
 		e.sectionSettings,
 		e.fromRowIndex,

package/lib/rt-grid/dist/rt-grid.js

@@ -13198,7 +13198,7 @@ DataTable._proto = DataTable.prototype;
 * @property {boolean=} collapsed=true Chain is collapsed by default
 * @property {(string|null)=} label=null
 * @property {boolean=} hidden=true When this row is hidden
-* @pro // realTime
+* @property {boolean=} realTime=true Realtime row, able to request for JET/RTK
 */
 
 /** @typedef {Object} RowDefinition~RowTypes
@@ -13400,6 +13400,8 @@ RowDefinition.prototype.initialize = function(rowOptions) {
 		return;
 	}
 
+	var extractedOptions = RowDefinition.extractRowOptions(rowOptions);
+
 	var val = rowOptions["permId"];
 	if(val != null) {
 		this._permId = val;
@@ -13417,13 +13419,8 @@ RowDefinition.prototype.initialize = function(rowOptions) {
 	if(val != null) {
 		this._chainRic = val;
 	}
-	val = rowOptions["values"];
-	// eslint-disable-next-line no-undefined
-	if(val !== undefined) {
-		this.setStaticRowData(val, rowOptions["fields"]);
-	}
 
-	val = rowOptions["asChain"];
+	val = extractedOptions["asChain"];
 	if(val !== null) {
 		this._isChain = val;
 	}
@@ -13435,28 +13432,22 @@ RowDefinition.prototype.initialize = function(rowOptions) {
 
 	val = rowOptions["collapsed"];
 	if(val != null){
-		this._expanded = !val;
+		this._expanded = extractedOptions["collapsed"];
 	}
 	val = rowOptions["keepModel"];
 	if(val) {
 		this._userModel = rowOptions;
 	}
 
-	var expanded = this._expanded;
 	var symbol = this._ric || this._chainRic;
-	var asChain = this._isChain || !!this._chainRic;
-	if(this._ric && this._ric.indexOf("0#") >= 0){
-		asChain = true;
-		expanded = true;
-	}
-	if(this._isChain === false){
-		asChain = false;
-	}
-	if(this._expanded === false){
-		expanded = false;
-	}
 	if(symbol || this._permId){
-		this.setContent(symbol, this._permId, asChain, expanded); // this._dataId is modified
+		this.setContent(symbol, this._permId, this._isChain, this._expanded); // this._dataId is modified
+	}
+
+	val = rowOptions["values"];
+	// eslint-disable-next-line no-undefined
+	if(val !== undefined) {
+		this.setStaticRowData(val, rowOptions["fields"]);
 	}
 };
 /** @private
@@ -13483,11 +13474,11 @@ RowDefinition.prototype._initializeAsConstituent = function(rowOptions) {
 	}
 };
 /** @public
+* @ignore
 * @param {string} userInput RIC
 * @param {string=} permId=null Organization PermId, which use for getting ADC data for private  company
 * @param {boolean=} asChain
 * @param {boolean=} expanded
-* @param {boolean=} realTime
 * @return {boolean} True if there is any change otherwise false
 */
 RowDefinition.prototype.setContent = function(userInput, permId, asChain, expanded) {
@@ -13510,33 +13501,40 @@ RowDefinition.prototype.setContent = function(userInput, permId, asChain, expand
 		return false;
 	}
 
-	this.unsubscribeForUpdates();
+	if(!this.unsubscribeForUpdates()){
+		this._clearStaticData();
+	}
 	this.resetUpdates(); // Remove all previous data updates because a new content is just entered
 
-	// TODO: handle changing between chain and ric row
 	this._userInput = userInput;
 	if(this._userInput.charAt(0) === "'") { // This is a row header
 		this._ric = this._chainRic = ""; // No ric for realtime request
 	} else {
-		if(this._userInput.indexOf("0#") >= 0) {
-			if(asChain === false){
-				this._ric = this._userInput;
-			} else {
-				this._ric = expanded === false ? this._userInput : this._userInput.replace("0#", "");
-				this._expanded = expanded;
-				this._isChain = true; // Only chain can be expanded by 0#
-				this._chainRic = this._userInput;
-				if(this._view) {
-					this._view.setSegmentSeparator(this._rowId);
-					this.expandChain();
-				}
-			}
+		if(asChain === true){
+			this._ric = expanded === false ? this._userInput : this._userInput.replace("0#", "");
+			this._expanded = expanded;
+			this._isChain = true; // Only chain can be expanded by 0#
+			this._chainRic = this._userInput;
 		} else {
 			this._ric = this._userInput;
-			if(asChain){
-				this._isChain = true;
+			this._isChain = asChain;
+		}
+	}
+
+	if(this._view) {
+		if(this._isChain){
+			var rid = this.getRowId();
+			var segmentId = this._view.getSegmentParentRowId(rid);
+			if(segmentId){
+				this._view.removeSegmentChild(segmentId, rid);
 			}
 		}
+		this._view.setSegmentSeparator(this._rowId, !!this._isChain);
+		if(this._expanded && this.isChainCollapsed()){
+			this.expandChain();
+		} else if (!this._expanded && this.isChainExpanded()){
+			this.collapseChain();
+		}
 	}
 
 	this._dataId = this._rowId + this.getSymbol(); // JET/RTK will generate data id to be rowId (given from this rowDef) + ric;
@@ -13981,7 +13979,7 @@ RowDefinition.prototype.unsubscribeForUpdates = function() {
 	this.resetUpdates();
 	// TODO: Reset only if this is the last ric
 	this._dc.setRowData(this._dataId, null); // Trigger data update immediately
-	// TODO: Handle static values
+	this._clearStaticData();
 	// eslint-disable-next-line consistent-return
 	return prevRowData;
 };
@@ -14393,6 +14391,40 @@ RowDefinition.prototype.getUserModel = function() {
 RowDefinition.toRowId = function(rowDef) {
 	return rowDef.getRowId();
 };
+/** For transforming row options into standard format
+* @public
+* @ignore
+* @function
+* @param {RowDefinition~Options} rowOptions
+* @return {RowDefinition~Options}
+*/
+RowDefinition.extractRowOptions = function(rowOptions) {
+	var ric = rowOptions["ric"];
+	var chainRic = rowOptions["chainRic"];
+	var collapsed = rowOptions["collapsed"];
+	var asChain = rowOptions["asChain"];
+	if(asChain == null && chainRic){
+		asChain = true;
+	}
+	var expanded = null;
+	if(ric && ric.indexOf("0#") >= 0){
+		if(asChain == null){
+			asChain = true;
+		}
+		expanded = true;
+	}
+
+	var extractedOptions = {};
+	if(collapsed == null) {
+		extractedOptions["collapsed"] = !expanded;
+	} else {
+		extractedOptions["collapsed"] = collapsed;
+	}
+	extractedOptions["ric"] = ric;
+	extractedOptions["chainRic"] = chainRic;
+	extractedOptions["asChain"] = asChain;
+	return extractedOptions;
+};
 /** For mapping row Id by Array.map()
 * @public
 * @function
@@ -15028,7 +15060,8 @@ PredefinedFormula.remove = function(field) {
 * @property {ColumnDefinition~SortLogic=} sorter=null Alias to `sortLogic`
 * @property {boolean=} rowSorting=null If set to true, RowDefinition object will be used for sorting comparison. If set to false, data from the given `field` will be used for sorting comparison.
 * @property {boolean=} sortable=true If disabled, the column cannot be sorted by user click
-* @property {string=} sort="" This column will be sorted at the initialization in the specified order (e.g. "asc", "desc")
+* @property {string=} sort="" Deprecated Alias to `sortOrder`
+* @property {string=} sortOrder="" The column can be sorted in ascending and descending order by specifying the order "a", "d". This option will sort the column when it is initialized or inserted at runtime.
 * @property {Object=} styles=null Key/value pair Object specifying CSS styles
 * @property {number=} width=NaN If specified, column will have a fixed width in pixel
 * @property {number=} minWidth=NaN If specified, column will have a minimum width in pixel
@@ -15406,7 +15439,7 @@ ColumnDefinition.prototype.initialize = function(columnOption) {
 	}
 
 	// Deprecate
-	val = columnOption["sort"];
+	val = columnOption["sortOrder"] || columnOption["sort"];
 	if(val) {
 		this._initialOrder = val;
 	}
@@ -15656,11 +15689,13 @@ ColumnDefinition.prototype.isScalable = function() {
 	var colIndex = grid.getColumnIndex(this);
 	return core.getColumnScalability(colIndex);
 };
-/** @public
- * @deprecated
+/** Deprecated, this function will be return initial sort order of this column, The current sort state may be different from initial sort state.
+* @public
+* @deprecated
 * @return {string}
 */
 ColumnDefinition.prototype.getInitialSortOrder = function() {
+	// WARNING: This state is different from `sortOrder`, it is the state when grid is initialized.
 	return this._initialOrder;
 };
 /** @public
@@ -15764,10 +15799,6 @@ ColumnDefinition.prototype.getConfigObject = function(colOptions) {
 		obj["sortable"] = false;
 	}
 
-	if(this._initialOrder) {
-		obj["sort"] = this._initialOrder;
-	}
-
 	var classes = this._classes;
 	if(classes && classes.length > 0) {
 		obj["className"] = classes.join(" ");
@@ -35947,7 +35978,7 @@ Core.prototype._batches = null;
 * @return {string}
 */
 Core.getVersion = function () {
-	return "5.1.53";
+	return "5.1.56";
 };
 /** {@link ElementWrapper#dispose}
 * @override
@@ -38326,7 +38357,7 @@ Core.prototype.freezeColumn = function (frozenColIndex, numRightColumn) {
 	}
 	if(numRightColumn != null) {
 		rightPinnedCount = numRightColumn > 0 ? numRightColumn : 0;
-		if (this._pinnedLeftColumnCount !== rightPinnedCount) {
+		if (this._pinnedRightColumnCount !== rightPinnedCount) {
 			dirty = true;
 			this._pinnedRightColumnCount = rightPinnedCount; // This variable is used for caching
 		}
@@ -42115,6 +42146,7 @@ Ext["b" /* default */].inherits(SortableTitlePlugin, event_EventDispatcher);
 /** The sorting object which will be used for initialSort config.
  * @typedef {Object} SortableTitlePlugin~InitialSort
  * @property {number} colIndex Index of the column
+ * @property {string} field field of the column
  * @property {SortableTitlePlugin~SortOrder=} sortOrder=null Set to "d" for descending order and "a" for ascending order
  * @property {SortableTitlePlugin~SortOrder=} order Alias of sortOrder
  */
@@ -42124,6 +42156,8 @@ SortableTitlePlugin.InitialSort;
  * @typedef {Object} SortableTitlePlugin~ColumnOptions
  * @property {boolean=} sortable=false If enable, the column can be sorted by user click
  * @property {string=} sortBy Field to be used for sorting. If defined, user can click at the header section to sort the column
+ * @property {string=} sort="" Deprecated Alias to `sortOrder`
+ * @property {string=} sortOrder="" The column can be sorted in ascending and descending order by specifying the order "a", "d". This option will sort the column when it is initialized or inserted at runtime.
  * @property {DataTable.SortLogic=} sortLogic=null Custom compare function for sorting
  * @property {DataTable.SortLogic=} sortingLogic Alias to `sortLogic`
  * @property {DataTable.SortLogic=} sorter Alias to `sortLogic`
@@ -42328,7 +42362,7 @@ SortableTitlePlugin.prototype.afterInit = function () {
 	// Set logic to the data source, since the data source not available during the initialization
 	t.setSortLogics(t._sortLogic);
 
-	var userInput = t._initialSort;
+	var userInput = t._initialSort; // This will be passed from the user when they want to start with initialize sort
 	if (userInput != null) {
 		if(Array.isArray(userInput)) {
 			if(t._maxCount === 1) { // TODO: max count could be part of sortColumns method
@@ -42477,14 +42511,32 @@ SortableTitlePlugin.prototype.getConfigObject = function (gridOptions) {
 
 	if (!host) return obj;
 
-	var len = host.getColumnCount();
-	var col, opt, field;
-	for(var i = 0; i < len; ++i) {
+	var sortedColumns = this.getSortedColumns();
+	var col, i, len;
+	// Multiple column sorting cannot retain the sort order in the column option.
+	if(this._maxCount === 1 && sortedColumns != null) {
+		// assign sorting state to each columns
+		len = sortedColumns.length;
+		for (i = 0; i < len; i++) {
+			var sortedColumn = sortedColumns[i];
+			var colIndex = sortedColumn["colIndex"];
+			col = columns[colIndex];
+			if (!col) {
+				col = columns[colIndex] = {};
+			}
+			col["sortOrder"] = sortedColumn["sortOrder"];
+		}
+	}
+
+	len = host.getColumnCount();
+	var opt, field;
+	for(i = 0; i < len; ++i) {
 		col = columns[i];
 		if (!col) {
 			col = columns[i] = {};
 		}
 
+		// TODO: We should get the state from the core, instead of getting the sort options.
 		opt = this._getSortOptions(i);
 
 		if (!opt) { continue; }
@@ -42498,7 +42550,7 @@ SortableTitlePlugin.prototype.getConfigObject = function (gridOptions) {
 		}
 		field = opt["field"];
 		if (field) {
-			if(col["field"] !== field) {
+			if(col["field"] != null && col["field"] !== field) { // Core does not have field properties, so when you try to call getConfigObject in Core, it will return sortBy too.
 				col["sortBy"] = field;
 			} // else The default value is an empty sortBy, which refers to the same column field by default.
 
@@ -42514,7 +42566,7 @@ SortableTitlePlugin.prototype.getConfigObject = function (gridOptions) {
 		extOptions = obj["sorting"] = {};
 	}
 
-	var val = this.getSortedColumns();
+	var val = sortedColumns;
 	if(val != null) {
 		extOptions["initialSort"] = val;
 	}
@@ -43021,7 +43073,14 @@ SortableTitlePlugin.prototype.disableTwoStateSorting = function (disabled) {
 * @param {boolean=} bool=true, if set to false it will be unfreeze indicator
 */
 SortableTitlePlugin.prototype.freezeIndicator = function (bool) {
+	var prevState = this._frozenIndicator;
 	this._frozenIndicator = bool !== false;
+	if(prevState && !this._frozenIndicator) { // from frozen to unfrozen, update the ui
+		for (var i = this._hosts.length; --i >= 0;) {
+			this._updateSortableIndicator(i);
+		}
+	}
+
 };
 /** @public
 * @param {boolean=} disabled
@@ -43097,7 +43156,7 @@ SortableTitlePlugin.prototype._initialSortByColumnField = function (options) {
 	var colCount = columns ?  columns.length : 0;
 	for (var i = 0; i < colCount; i++) {
 		var column = columns[i];
-		var sortOrder = column["defaultSort"] || column["sort"]; // composite and rt grid option for default sort order
+		var sortOrder = column["defaultSort"]; // composite and rt grid option for default sort order
 		if (sortOrder) {
 			// TODO: Support multi-column sorting
 			return {
@@ -43527,6 +43586,15 @@ SortableTitlePlugin.prototype._onColumnAdded = function (e) {
 	} else {
 		t.disableColumnSorting(colIndex, true);
 	}
+
+	var sortOrder = column["sortOrder"] || column["sort"];
+	if(sortOrder != null) {
+		sortOrder = SortableTitlePlugin._toSortOrder(sortOrder); // Invalid input will return "n"
+		if(sortOrder !== "n") {
+			t.clearSortState(); // clear previous sorting state
+			t.sortColumn(colIndex, sortOrder);
+		}
+	}
 };
 
 /** @private
@@ -45374,6 +45442,9 @@ Grid.prototype.replaceColumn = function (columnOption, colRef) {
 		colConfig["hidden"] = false;
 	}
 
+	if(colConfig.id == null) {
+		colConfig.id =  colDef.getId(); // retain ID
+	}
 	this._grid.startBatch("reset");
 	this.insertColumn(colConfig, colIndex);
 	this.removeColumn(colIndex + 1); // remove existing column after insert
@@ -45524,12 +45595,6 @@ Grid.prototype.restoreColumns = function(columns) {
 		}
 	}
 
-	var sortingStates;
-	var removeLen = removingFields.length;
-	if(removeLen > 0 && this._stp) {
-		sortingStates = this._stp.getSortingStates().slice(); // We need to clone array for avoid object reference in remove column
-	}
-
 	this.removeColumns(removingFields);
 
 	var keepingLen = keepingColumns.length;
@@ -45557,10 +45622,6 @@ Grid.prototype.restoreColumns = function(columns) {
 		this._grid.freezeLayout(prevState);
 	}
 
-	if(removeLen > 0 && this._stp) {
-		this._stp.sortColumns(sortingStates);
-	}
-
 	grid.reorderColumns(columnOrdering);
 	grid.stopBatch("reset");
 };
@@ -46447,37 +46508,35 @@ Grid.prototype.hasHiddenRow = function(){
 /** Set RIC to the specified row
 * @public
 * @param {Grid~RowReference} rowRef
-* @param {string} str
+* @param {string} str RIC to be set to a row
 * @param {RowDefinition~Options=} options
 */
 Grid.prototype.setRic = function(rowRef, str, options) {
 	if(this._mainGrid) {
-		this._mainGrid.setRic(this._toRowId(rowRef), str);
+		this._mainGrid.setRic(this._toRowId(rowRef), str, options);
 		return;
 	}
 	var rowDef = this._getRowDefinitionByRef(rowRef);
 	if(rowDef) {
 		options = options || {};
-		var newChain = false;
-		if(str.indexOf("0#") > 0 || options["asChain"]) {
-			newChain = true;
+		options["ric"] = str;
+		var extractedOptions = RowDefinition.extractRowOptions(options);
+		var oldRic = rowDef.getSymbol();
+		var permId = options["permId"];
+		var expanded = null;
+		var collapsed = options["collapsed"];
+		if(collapsed != null){
+			expanded = !extractedOptions["collapsed"];
+		}
+		if(rowDef.setContent(str, permId, extractedOptions["asChain"], expanded)) { // The given string may not be a RIC
+			this._connector.removeRic(rowDef, oldRic);
+			this._initDuplicateRicData(rowDef);
+			this._connector.addRic(rowDef);
 		}
-		if(rowDef.isChain() || newChain) {
-			if(rowDef.getRic() !== str.replace("0#", "")) {
-				var rowIndex = this._dv.getRowIndex(rowDef.getRowId());
-				this.removeRow(rowDef);
 
-				options["ric"] = str;
-				this.insertRow(options, rowIndex);
-			}
-		} else {
-			var oldRic = rowDef.getSymbol();
-			var permId = options["permId"] || "";
-			if(rowDef.setContent(str, permId)) { // The given string may not be a RIC
-				this._connector.removeRic(rowDef, oldRic);
-				this._initDuplicateRicData(rowDef);
-				this._connector.addRic(rowDef);
-			}
+		var values = options["values"];
+		if(values != null) {
+			rowDef.setStaticRowData(values, options["fields"]);
 		}
 	}
 };
@@ -47728,6 +47787,28 @@ Grid.prototype._logData = function(rowDefs, options) {
 
 	console.table(tbl); // eslint-disable-line
 };
+/** @public
+* @description Replace existing row with a new row. Row ID would be changed, after row is replaced.
+* @param {Grid~RowReference} rowRef Reference (i.e. row index, row id, or row definition) of the insert position
+* @param {Object=} rowOption
+* @returns {Object}
+*/
+Grid.prototype.replaceRow = function(rowRef, rowOption) {
+	var rowId = this._getRowId(rowRef);
+	var rowDef = this._getRowDefinitionByRef(rowRef);
+	if(rowDef.isAutoGenerated()) { // Users cannot replace auto-generated
+		return  null;
+	}
+	var configObj = rowDef.getConfigObject();
+
+	if(Object(Util["c" /* deepEqual */])(configObj, rowOption)){
+		return null;
+	} else {
+		var insertedRow = this.insertRow(rowOption, rowId);
+		this.removeRow(rowId);
+		return insertedRow;
+	}
+};
 
 
 /* harmony default export */ var js_Grid = (Grid);