@refinitiv-ui/efx-grid 6.0.20 → 6.0.22

package/lib/rt-grid/es6/Grid.d.ts

@@ -80,7 +80,8 @@ declare namespace Grid {
         scrollbarParent?: Element|null,
         formulaEngine?: boolean|null,
         adcPollingInterval?: number|null,
-        fieldCaching?: boolean|null
+        fieldCaching?: boolean|null,
+        childDataField?: string|null
     };
 
     type RowReference = number|string|RowDefinition|null;
@@ -143,6 +144,8 @@ declare class Grid extends EventDispatcher {
 
     public moveColumnById(srcCol: number|string|null, destCol?: (number|string)|null): boolean;
 
+    public reorderColumns(colRefs: number|string|(number|string)[]|null, destCol: number|string|null): boolean;
+
     public hideColumn(colRef: Grid.ColumnReference|null, hidden?: boolean|null): void;
 
     public hideColumns(colRefs: (Grid.ColumnReference)[]|null, hidden?: boolean|null): void;
@@ -257,6 +260,12 @@ declare class Grid extends EventDispatcher {
 
     public freezeColumn(colIndex?: number|null, pinnedRightColumns?: number|null): void;
 
+    public pinColumn(colRef: Grid.ColumnReference|(Grid.ColumnReference)[]|null): boolean;
+
+    public unpinColumn(colRef: Grid.ColumnReference|(Grid.ColumnReference)[]|null, dest?: Grid.ColumnReference|null): boolean;
+
+    public unpinAllColumns(): boolean;
+
     public updateColumnTitle(): void;
 
     public isSorting(): boolean;

package/lib/rt-grid/es6/Grid.js

@@ -84,6 +84,7 @@ import { ElementWrapper } from "../../core/es6/grid/components/ElementWrapper.js
 * @property {boolean=} formulaEngine=false If enabled, field with leading equal sign will be treated as a formula and rows will be filled with the calculated values.
 * @property {number=} adcPollingInterval=0 Length of polling interval for refreshing ADC data in milliseconds. The default value (0) means no polling.
 * @property {boolean=} fieldCaching=false If enabled, field definition will be caching internal mechanism
+* @property {string=} childDataField=CHILD_VALUES The given field will be used to store children's static data, such as row color assignment.
 */
 
 /** @typedef {number|string|RowDefinition} Grid~RowReference
@@ -546,6 +547,10 @@ Grid.prototype._pollingEnabled = true;
 * @private
 */
 Grid.prototype._fieldCaching = false;
+/** @type {string}
+* @private
+*/
+Grid.prototype._childDataField = "";
 
 
 /** @public
@@ -960,6 +965,9 @@ Grid.prototype.initialize = function(gridOption) {
 	}
 
 	// Row operations
+	if(gridOption["childDataField"] != null) {
+		this._childDataField = RowDefinition._childDataField = gridOption["childDataField"];
+	}
 	var rows = gridOption["rows"];
 	if(!rows) {
 		rows = gridOption["rics"] || null; // Make "rics" an alias to "rows"
@@ -1115,6 +1123,10 @@ Grid.prototype.getConfigObject = function (gridOptions) {
 		obj["fieldCaching"] = this._fieldCaching;
 	}
 
+	if(this._childDataField) {
+		obj["childDataField"] = this._childDataField;
+	}
+
 	// get all rows config
 	var rowDefs = this.getAllRowDefinitions();
 	var rows = obj["rows"] = [];
@@ -1252,9 +1264,8 @@ Grid.prototype._onFieldAdded = function(e) {
 
 	// JET
 	if (this._subs) {
-		var colDefs = this.getColumnDefinitions();
-		var fields = colDefs.reduce(ColumnDefinition.getRealTimeFields, []);
-		this._subs["addFields"](fields);
+		var realtimeFields = addedFields.filter(ColumnDefinition.isRealTimeField);
+		this._subs["addFields"](realtimeFields);
 	}
 
 	this._dispatch(e.type, e);
@@ -1265,6 +1276,7 @@ Grid.prototype._onFieldAdded = function(e) {
 Grid.prototype._onFieldRemoved = function(e) {
 	var removedFields = e.removedFields;
 
+	// TODO: ADC fields have an interval load. Currently, we only keep the field but do not delete it.
 	// JET
 	if(this._subs) {
 		this._subs["removeFields"](removedFields);
@@ -1518,15 +1530,7 @@ Grid.prototype._onFieldLoadedError = function (err) {
  * @param {string} referrer
  */
 Grid.prototype._onFieldLoaded = function (field, referrer) {
-	// async process, the field can be remove before column added
-	var colIndex = this.getColumnIndex(field);
-	if(colIndex > -1) {
-		var colDef = this._getColumnDefinition(field);
-		if(colDef.isTimeSeriesField()) {
-			this._insertTimeSeriesChildren(colDef);
-		}
-		this._connector.addFields(field, referrer);
-	}
+	this._connector.addFields(field, referrer);
 };
 
 /**
@@ -1845,6 +1849,62 @@ Grid.prototype.moveColumnById = function (srcCol, destCol) {
 	return this.moveColumn(srcIndex, destIndex);
 };
 
+/** @public
+* @param {number|string|Array.<number|string>} colRefs List of column index or column id to be moved
+* @param {number|string} destCol Destination position where the moved columns will be placed BEFORE the specified position. This can be column id or index
+* @return {boolean} Return true if there is any change, and false otherwise
+*/
+Grid.prototype.reorderColumns = function (colRefs, destCol) {
+	var destId = (typeof destCol === "number") ? this.getColumnId(destCol) : destCol;
+
+	if(Array.isArray(colRefs)) {
+		var srcLen = colRefs.length;
+		if(srcLen > 1) {
+			var colIds = this.getColumnIds();
+			var srcIds = [];
+			var invalidDest = false;
+			var i;
+			for(i = 0; i < srcLen; ++i) {
+				var colRef = colRefs[i];
+				var srcId = (typeof colRef === "number") ? colIds[colRef] : colRef;
+				if(srcId) {
+					srcIds.push(srcId);
+					if(destId === srcId) {
+						invalidDest = true; // Destination must not exist in source columns
+					}
+				}
+			}
+			srcLen = srcIds.length;
+			if(invalidDest) { // Find the next valid destination where it is not contained in the source columns
+				var colCount = colIds.length;
+				var destIdx = this.getColumnIndex(destId);
+				if(destIdx >= 0) {
+					while(++destIdx < colCount) {
+						destId = colIds[destIdx];
+						if(srcIds.indexOf(destId) < 0) {
+							break;
+						}
+					}
+				}
+				if(destIdx < 0 || destIdx >= colCount) {
+					destId = "";
+				}
+			}
+
+			var dirty = 0;
+			for(i = 0; i < srcLen; ++i) {
+				dirty |= this.moveColumnById(srcIds[i], destId);
+			}
+			// TODO: Handle the case where all columns stay in the same place
+			return dirty ? true : false;
+		} else {
+			return this.moveColumnById(colRefs[0], destId);
+		}
+	}
+
+	// colRefs will be a number or string
+	return this.moveColumnById(colRefs, destId);
+};
 
 /** The hidden column still occupies the same index.
 * @public
@@ -2965,17 +3025,136 @@ Grid.prototype.getAllFields = function() {
 	return this._connector.getAllFields();
 };
 /** Freeze the column at the left side of the table starting from index 0 to the specified colIndex
- * If no index is specified (null or undefined index), unfreeze all columns.
- * @public
- * @param {number=} colIndex Negative index is equivalent to null value
- * @param {number=} pinnedRightColumns Number of columns to be pinned/snapped on the right side
- */
+* If no index is specified (null or undefined index), unfreeze all columns.
+* @public
+* @param {number=} colIndex Negative index is equivalent to null value
+* @param {number=} pinnedRightColumns Number of columns to be pinned/snapped on the right side
+*/
 Grid.prototype.freezeColumn = function(colIndex, pinnedRightColumns) {
 	if(colIndex == null) {
 		colIndex = -1;
 	}
 	this._grid.freezeColumn(colIndex, pinnedRightColumns);
 };
+/** Pin column to the left side by moving the specified column to the rightmost of the frozen columns. <br>
+* The method will do nothing if the specified column is already pinned to the left side
+* @public
+* @param {Grid~ColumnReference|Array.<Grid~ColumnReference>} colRef
+* @return {boolean}
+*/
+Grid.prototype.pinColumn = function(colRef) {
+	if(Array.isArray(colRef)) {
+		var ary = colRef;
+		var len = ary.length;
+
+		var dirty = 0;
+		for(var i = 0; i < len; ++i) {
+			dirty |= this._pinColumn(ary[i]);
+		}
+		return dirty ? true : false;
+	}
+	return this._pinColumn(colRef);
+};
+/** @private
+* @param {Grid~ColumnReference} colRef
+* @return {boolean}
+*/
+Grid.prototype._pinColumn = function(colRef) {
+	var colIndex = this.getColumnIndex(colRef);
+	if(colIndex < 0) {
+		return false;
+	}
+	var pinnedCount = this._grid.getFrozenColumnCount();
+	if(colIndex < pinnedCount) {
+		return false; // The column is already pinned area
+	}
+	if(!pinnedCount) {
+		var stationaryIdx = this._grid.getStationaryColumnIndex();
+		if(stationaryIdx >= 0) {
+			pinnedCount = stationaryIdx;
+			if(colIndex > stationaryIdx) {
+				pinnedCount++;
+			}
+		}
+	}
+
+	this.moveColumnById(colIndex, pinnedCount);
+	this._grid.freezeColumn(pinnedCount);
+	return true;
+};
+/** Unpin column from the left side by moving the specified column to the end of the frozen columns. <br>
+* The method will do nothing if the specified column is not pinned on the left side.
+* @public
+* @param {Grid~ColumnReference|Array.<Grid~ColumnReference>} colRef
+* @param {Grid~ColumnReference=} dest The unpinned column will be placed before the destination position after the operation
+* @return {boolean}
+*/
+Grid.prototype.unpinColumn = function(colRef, dest) {
+	if(Array.isArray(colRef)) {
+		var ary = colRef;
+		var len = ary.length;
+
+		var dirty = 0;
+		for(var i = len; --i >= 0;) { // WARNING: unpinning is done in reversed order
+			dirty |= this._unpinColumn(ary[i], dest);
+		}
+		return dirty ? true : false;
+	}
+	return this._unpinColumn(colRef, dest);
+};
+/** @private
+* @param {Grid~ColumnReference} colRef
+* @param {Grid~ColumnReference=} dest The unpinned column will be placed before the destination position after the operation
+* @return {boolean}
+*/
+Grid.prototype._unpinColumn = function(colRef, dest) {
+	var colIndex = this.getColumnIndex(colRef);
+	if(colIndex < 0) {
+		return false;
+	}
+	var pinnedCount = this._grid.getFrozenColumnCount();
+	if(!pinnedCount) {
+		return false;
+	}
+	if(colIndex >= pinnedCount) {
+		return false; // The column is outside of frozen area
+	}
+	var srcId = null;
+	var destId = null;
+	if(dest != null) {
+		var destIdx = this.getColumnIndex(dest);
+		destId = this.getColumnId(destIdx);
+		srcId = this.getColumnId(colIndex);
+	}
+
+	var stationaryIdx = this._grid.getStationaryColumnIndex();
+
+	if(colIndex > stationaryIdx) {
+		this.moveColumnById(colIndex, pinnedCount);
+	}
+
+	this._grid.freezeColumn(pinnedCount - 2); // Column index is used for freezing
+
+	if(colIndex > stationaryIdx) {
+		if(destId != null) {
+			this.moveColumnById(srcId, destId);
+		}
+	}
+
+	return true;
+};
+/** A shorthand to unpin all columns from the left hand side
+* @public
+* @return {boolean}
+*/
+Grid.prototype.unpinAllColumns = function() {
+	var pinnedCount = this._grid.getFrozenColumnCount();
+	if(!pinnedCount) {
+		return false;
+	}
+	this._grid.freezeColumn(-1); // Column index is used for freezing
+	return true;
+};
 
 /** @private
 * @param {Object} e

package/lib/rt-grid/es6/ReferenceCounter.js

@@ -66,6 +66,7 @@ ReferenceCounter.prototype.getSession = function() {
 		} else if(val < 0) {
 			removedEntries.push(key);
 		}
+		// else {} // when val 0 do nothing, doesn't change anything
 	}
 	return {
 		newEntries: newEntries.filter(Boolean),
@@ -94,9 +95,15 @@ ReferenceCounter.prototype.addReference = function(key, referer) {
 
 		if(this._counter[key]) {
 			++this._counter[key];
+			// The session will not change when a field already exists and a counter is attempted to be added
 		} else {
 			this._counter[key] = 1;
-			this._session[key] = 1;
+			if(this._session[key] === -1) {
+				this._session[key] = 0;
+			} else {
+				this._session[key] = 1;
+			}
+
 			return true;
 		}
 	}
@@ -146,7 +153,11 @@ ReferenceCounter.prototype.removeReference = function(key, referer, count) {
 	val -= count;
 	if(!val || val < 0) {
 		delete this._counter[key];
-		this._session[key] = -1;
+		if(this._session[key] === 1) {
+			this._session[key] = 0;
+		} else {
+			this._session[key] = -1;
+		}
 		return true;
 	}
 

package/lib/rt-grid/es6/RowDefinition.d.ts

@@ -45,6 +45,8 @@ declare class RowDefinition {
 
     public setStaticRowData(data: { [key: string]:  any }|any[], opt_fields?: (string)[]|null): void;
 
+    public _getStaticRowData(): { [key: string]:  any };
+
     public updateRowData(data: { [key: string]:  any }|any[], opt_fields?: (string)[]|null): void;
 
     public setStaticData(field: string, value: any): void;

package/lib/rt-grid/es6/RowDefinition.js

@@ -50,6 +50,10 @@ var RowDefinition = function(rowOptions) {
 * @private
 */
 RowDefinition._runningId = 0;
+/** @type {string}
+* @private
+*/
+RowDefinition._childDataField = "CHILD_VALUES";
 //#region Private Members
 /** @type {string}
 * @private
@@ -240,7 +244,11 @@ RowDefinition.prototype._initializeAsConstituent = function(rowOptions) {
 			}
 		}
 	}
-	// TODO: Allow constituent to have predefined static values
+	var val = rowOptions["values"];
+	// eslint-disable-next-line no-undefined
+	if(val !== undefined) {
+		this.setStaticRowData(val, rowOptions["fields"]);
+	}
 };
 /** @public
 * @param {string} userInput
@@ -312,11 +320,6 @@ RowDefinition.prototype.getConfigObject = function(rowOptions) {
 		obj["ric"] = val;
 	}
 
-	val = this._staticValues;
-	if(val) {
-		obj["values"] = cloneObject(val);
-	}
-
 	val = this._chainRic;
 	if(val) {
 		obj["chainRic"] = val;
@@ -348,6 +351,40 @@ RowDefinition.prototype.getConfigObject = function(rowOptions) {
 		obj["hidden"] = val;
 	}
 
+	val = this._getStaticRowData();
+	if(val) {
+		obj["values"] = val;
+	}
+
+	// obtain the static values of constituent rows
+	if(this.isChain()) {
+		var children = this.getChildren();
+		if(children) {
+			var childValues = val ? val[RowDefinition._childDataField] : {};
+			if(!childValues) {
+				childValues = {};
+			}
+			var dirty = false;
+			var len = children.length;
+			var i, rowDef, staticValues;
+			for(i = 0; i < len; i++) {
+				rowDef = children[i];
+				staticValues = rowDef._getStaticRowData();
+				if(staticValues) {
+					dirty = true;
+					childValues[rowDef.getRic()] = staticValues;
+				}
+			}
+
+			if(dirty) {
+				if(!obj["values"]) {
+					obj["values"] = {};
+				}
+				obj["values"][RowDefinition._childDataField] = childValues;
+			}
+		}
+	}
+
 	return obj;
 };
 /** Since an index chain (e.g. .FTSE) can automatically produce rows for its constituent, we need to separate rowId and dataId, so that the constituents still use the same data Id as that of its parent.
@@ -422,6 +459,12 @@ RowDefinition.prototype.setStaticRowData = function(data, opt_fields) {
 	}
 };
 /** @public
+* @return {Object.<string, *>}
+*/
+RowDefinition.prototype._getStaticRowData = function() {
+	return this._staticValues ? cloneObject(this._staticValues) : null;
+};
+/** @public
 * @param {Object.<string, *>|Array} data
 * @param {Array.<string>=} opt_fields In case of the given data is an array, this param will be used for mapping index to field
 */
@@ -722,6 +765,22 @@ RowDefinition.deregisterFromView = function(rowIds, rowDef) {
 	rowDef._deregisterFromView(rowIds);
 	return rowIds;
 };
+/** @private
+* @param {string} ric
+* @return {Object}
+*/
+RowDefinition.prototype._getChildStaticRowData = function(ric) {
+	if(!this._staticValues) {
+		return null;
+	}
+
+	var childValues = this._staticValues[RowDefinition._childDataField];
+	if(!childValues) {
+		return null;
+	}
+
+	return childValues[ric] || null;
+};
 /** @public
 * @ignore
 * @param {string} ric
@@ -749,12 +808,19 @@ RowDefinition.prototype.addConstituent = function(ric) {
 
 	var newChild = !childDef;
 	if(newChild) {
-		childDef = new RowDefinition({
+		var rowOptions = {
 			"asConstituent": true,
 			"dataId": this._subId + ric,
 			"ric": ric,
 			"parent": this
-		});
+		};
+
+		var staticData = this._getChildStaticRowData(ric);
+		if(staticData) {
+			rowOptions["values"] = staticData;
+		}
+
+		childDef = new RowDefinition(rowOptions);
 	}
 
 	if(this._view) {

package/lib/tr-grid-column-grouping/es6/ColumnGrouping.d.ts

@@ -38,19 +38,19 @@ declare class ColumnGroupingPlugin extends GridPlugin {
 
     public addColumnToGroup(column: any, groupId: string, colIndex: number): void;
 
-    public addGroup(groupDef: ColumnGroupingPlugin.GroupDefinition|null): boolean;
+    public addGroup(groupDef: ColumnGroupingPlugin.GroupDefinition|null): string;
 
     public addColumnGrouping(groupDef: ColumnGroupingPlugin.GroupDefinition|null): void;
 
-    public removeGroup(groupId: string): any;
+    public removeGroup(groupId: string): ColumnGroupingPlugin.GroupDefinition|null;
 
-    public setGroupDefinitions(groupDefs: ColumnGroupingPlugin.GroupDefinitions|null): void;
+    public getGroupDefinition(groupId: string): ColumnGroupingPlugin.GroupDefinition|null;
 
     public getGroupDefinitions(): ColumnGroupingPlugin.GroupDefinitions;
 
-    public setGroupDefinition(groupId: string, newDef: ColumnGroupingPlugin.GroupDefinition|null): void;
+    public setGroupDefinition(groupId: string, groupDef?: ColumnGroupingPlugin.GroupDefinition|null): string;
 
-    public getGroupDefinition(groupId: string): ColumnGroupingPlugin.GroupDefinition|null;
+    public setGroupDefinitions(groupDefs: ColumnGroupingPlugin.GroupDefinitions|null): void;
 
     public setGroupChildren(groupId: string, newChildList: (string)[]|null): void;
 
@@ -70,6 +70,10 @@ declare class ColumnGroupingPlugin extends GridPlugin {
 
     public setColumnParent(colRef: number|string|null, groupId: string): void;
 
+    public getValidDestinationIndex(id: string, destCol: number|string|null): number;
+
+    public moveGroup(id: string, destCol: number|string|null): void;
+
 }
 
 export default ColumnGroupingPlugin;