@refinitiv-ui/efx-grid 6.0.5 → 6.0.7

package/lib/core/es6/data/DataView.js

@@ -792,45 +792,65 @@ DataView.prototype.isSorting = function() {
 
 /** Hide rows in the data view
  * @param {string|number} rId Row id to hide. If the rId is a number, it will be treated as a row index
- * @param {boolean=} opt_show show if false
+ * @param {boolean=} hidden=true If the value is false, the specified row will be shown.
  * @public
  */
-DataView.prototype.hideRow = function(rId, opt_show) {
-	this.showRows([rId], opt_show === false);
+DataView.prototype.hideRow = function(rId, hidden) {
+	this.hideRows([rId], hidden);
 };
 /** Hide rows in the data view
  * @param {Array.<string|number>} rowRefs Array of row ids or indices to hide
- * @param {boolean=} opt_show show if false
+ * @param {boolean=} hidden=true If the value is false, the specified rows will be shown.
  * @public
  */
-DataView.prototype.hideRows = function(rowRefs, opt_show) {
-	this.showRows(rowRefs, opt_show === false);
-};
-/**
- * Show/hide rows in the data view
- * @param {Array.<string|number>} rowRefs Array of row ids or indices to hide
- * @param {boolean=} opt_show hide instead show if false
- * @public
- */
-DataView.prototype.showRows = function(rowRefs, opt_show) {
-	var hidden = opt_show === false;
+DataView.prototype.hideRows = function(rowRefs, hidden) {
+	hidden = hidden !== false;
+	var dirty = false;
+	var rids = this._toRowIds(rowRefs);
+	var hiddenRids = this._hiddenRids;
+
 	if(hidden){
-		if(!this._hiddenRids) {
-			this._hiddenRids = {};
+		if(!hiddenRids) {
+			hiddenRids = this._hiddenRids = {};
 		}
-	} else if(!this._hiddenRids) {
+	} else if(!hiddenRids) {
 		return; // All rows are visible
 	}
 
-	var rids = this._toRowIds(rowRefs);
 	for(var i = rids.length; --i >= 0;) {
 		var rid = rids[i];
 		if(rid) { // undefined, null, and an empty string value are not a valid row id
-			this._hiddenRids[rid] = hidden;
+			if(!!hiddenRids[rid] !== hidden) {
+				hiddenRids[rid] = hidden;
+				dirty = true;
+			}
 		}
 	}
 
-	this._refreshAndNotify(); // Very slow
+	if(dirty) {
+		if(!hidden) {
+			var hasHiddenRow = false;
+			for(var key in hiddenRids) {
+				if(hiddenRids[key]) {
+					hasHiddenRow = true;
+					break;
+				}
+			}
+			if(!hasHiddenRow) {
+				hiddenRids = this._hiddenRids = null;
+			}
+		}
+		this._refreshAndNotify(); // Very slow
+	}
+};
+/**
+ * Show/hide rows in the data view
+ * @param {Array.<string|number>} rowRefs Array of row ids or indices to hide
+ * @param {boolean=} shown=true If the value is false, the specified rows will be hidden.
+ * @public
+ */
+DataView.prototype.showRows = function(rowRefs, shown) {
+	this.hideRows(rowRefs, shown === false);
 };
 /** Unhide all rows
 * @public
@@ -846,7 +866,7 @@ DataView.prototype.unhideAllRows = function(){
 * @return {boolean}
 */
 DataView.prototype.hasHiddenRow = function(){
-	return !!this._hiddenRids;
+	return this._hiddenRids ? true : false;
 };
 
 /** @public

package/lib/core/es6/data/Segment.d.ts

@@ -8,13 +8,13 @@ declare class Segment {
 
     public addChild(rid: string, objMap?: any): boolean;
 
-    public addChildren(rids: (string)[], objMap?: any): boolean;
+    public addChildren(rids: (string)[]|null, objMap?: any): boolean;
 
     public containsChild(rid: string): boolean;
 
     public removeChild(rid: string, objMap?: any): boolean;
 
-    public removeChildren(rids: (string)[], objMap?: any): boolean;
+    public removeChildren(rids: (string)[]|null, objMap?: any): boolean;
 
     public removeAllChildren(objMap?: any): boolean;
 
@@ -22,9 +22,9 @@ declare class Segment {
 
     public getChildCount(): number;
 
-    public collapse(bool?: boolean): boolean;
+    public collapse(bool?: boolean|null): boolean;
 
-    public expand(bool?: boolean): boolean;
+    public expand(bool?: boolean|null): boolean;
 
     public isCollapsed(): boolean;
 
@@ -34,6 +34,10 @@ declare class Segment {
 
     public setValue(val: number): void;
 
+    public getOrder(): number;
+
+    public setOrder(val: number): void;
+
 }
 
 export default Segment;

package/lib/core/es6/data/Segment.js

@@ -27,6 +27,10 @@ Segment.prototype._collapsed = false;
 * @private
 */
 Segment.prototype._value = 0;
+/** @type {number}
+* @private
+*/
+Segment.prototype._order = 0;
 
 
 /** @public
@@ -194,6 +198,18 @@ Segment.prototype.getValue = function() {
 Segment.prototype.setValue = function(val) {
 	this._value = val;
 };
+/** @public
+* @return {number}
+*/
+Segment.prototype.getOrder = function() {
+	return this._order;
+};
+/** @public
+* @param {number} val
+*/
+Segment.prototype.setOrder = function(val) {
+	this._order = val;
+};
 
 
 export default Segment;

package/lib/core/es6/data/SegmentCollection.d.ts

@@ -6,7 +6,7 @@ declare class SegmentCollection {
 
     public addSegment(rid: string): boolean;
 
-    public addSegments(rids: (string)[]): boolean;
+    public addSegments(rids: (string)[]|null): boolean;
 
     public containsSegment(rid: string): boolean;
 
@@ -24,9 +24,9 @@ declare class SegmentCollection {
 
     public getSegmentIds(): (string)[];
 
-    public collapseSegment(segmentId: string, bool?: boolean): boolean;
+    public collapseSegment(segmentId: string, bool?: boolean|null): boolean;
 
-    public expandSegment(segmentId: string, bool?: boolean): boolean;
+    public expandSegment(segmentId: string, bool?: boolean|null): boolean;
 
     public expandAllSegments(): boolean;
 
@@ -36,19 +36,21 @@ declare class SegmentCollection {
 
     public addSegmentChild(segmentId: string, rid: string): boolean;
 
-    public addSegmentChildren(segmentId: string, rids: (string)[]): boolean;
+    public addSegmentChildren(segmentId: string, rids: (string)[]|null): boolean;
 
     public containsSegmentChild(segmentId: string, rid: string): boolean;
 
     public removeSegmentChild(segmentId: string, rid: string): boolean;
 
-    public removeSegmentChildren(segmentId: string, rids: (string)[]): boolean;
+    public removeSegmentChildren(segmentId: string, rids: (string)[]|null): boolean;
 
     public removeAllSegmentChildren(): boolean;
 
-    public fillSegment(segmentId: string, rids: (string)[]): void;
+    public fillSegment(segmentId: string, rids: (string)[]|null): void;
 
-    public fillSegments(rids: (string)[]): boolean;
+    public fillSegments(rids: (string)[]|null): boolean;
+
+    public calcSegmentOrder(rids: (string)[]|null): void;
 
     public getSegmentValues(rids: (string)[]): (number)[]|null;
 

package/lib/core/es6/data/SegmentCollection.js

@@ -38,6 +38,7 @@ SegmentCollection.prototype.addSegment = function(rid) {
 	if(rid && !this._segments[rid]) {
 		if(this._childToSegmentId[rid]) {
 			console.log("child of a segment cannot be set as a segment separator");
+			return false;
 		}
 		this._segments[rid] = new Segment(rid);
 		++this._segmentCount;
@@ -368,8 +369,27 @@ SegmentCollection.prototype.fillSegments = function(rids) {
 	return change;
 };
 /** @public
+* @param {Array.<string>} rids
+*/
+SegmentCollection.prototype.calcSegmentOrder = function(rids) {
+	var ridCount = rids ? rids.length : 0;
+	var segmentSeparators = this._segments;
+	var segmentCount = this._segmentCount;
+	var order = 0;
+	for(var i = 0; i < ridCount; ++i) {
+		var rid = rids[i];
+		var segment = segmentSeparators[rid];
+		if(segment) {
+			segment.setOrder(++order);
+			if(order >= segmentCount) {
+				break;
+			}
+		}
+	}
+};
+/** @public
 * @param {!Array.<string>} rids Array of row ids
-* @return {Array.<number>} Returns Array of segment values, if there are at least two segments, otherwise returns null
+* @return {Array.<number>} Returns Array of segment values, if there are at least one segment, otherwise returns null
 */
 SegmentCollection.prototype.getSegmentValues = function(rids) {
 	var rowCount = rids ? rids.length : 0;
@@ -379,51 +399,33 @@ SegmentCollection.prototype.getSegmentValues = function(rids) {
 	var segmentSeparators = this._segments;
 	var childToSegmentId = this._childToSegmentId;
 	var curSegment = null;
+	var prevSegment = null;
 	var segmentValues = new Array(rowCount);
-	var curSegmentCount = 0;
 	var segmentVal = 0;
-	var r = 0;
-	var childToIndex = {};
-	while(r < rowCount) {
+	var offset = 0;
+	for(var r = 0; r < rowCount; ++r) {
 		var rid = rids[r];
-		if(segmentSeparators[rid]) {
-			++curSegmentCount;
-			curSegment = segmentSeparators[rid];
-			segmentVal += 100;
-			segmentValues[r] = segmentVal;
-			curSegment.setValue(segmentVal);
-			if(curSegmentCount >= this._segmentCount) {
-				++r;
-				break;
-			}
+		curSegment = segmentSeparators[rid];
+		if(curSegment) {
+			offset = 0;
 		} else {
-			if(curSegmentCount) {
-				segmentValues[r] = segmentVal + 10;
+			var parentId = childToSegmentId[rid];
+			if(parentId) {
+				curSegment = segmentSeparators[parentId];
+				offset = 1;
 			} else {
-				segmentValues[r] = 0;
-			}
-			if(childToSegmentId[rid]) {
-				childToIndex[rid] = r;
+				offset = prevSegment ? 10 : 0;
 			}
 		}
-		++r;
-	}
-	if(curSegmentCount) {
-		while(r < rowCount) {
-			rid = rids[r];
-			segmentValues[r] = segmentVal + 10;
-			if(childToSegmentId[rid]) {
-				childToIndex[rid] = r;
-			}
-			++r;
-		}
-		for(var childId in childToIndex) {
-			curSegment = segmentSeparators[childToSegmentId[childId]];
-			segmentValues[childToIndex[childId]] = curSegment.getValue() + 1;
+
+		if(curSegment && prevSegment !== curSegment) {
+			prevSegment = curSegment;
+			segmentVal = curSegment.getOrder() * 100;
 		}
+		segmentValues[r] = segmentVal + offset;
 	}
 
-	return curSegmentCount ? segmentValues : null;
+	return prevSegment ? segmentValues : null;
 };
 
 

package/lib/core/es6/data/WrappedView.d.ts

@@ -7,7 +7,7 @@ import ColumnStats from "./ColumnStats.js"; // eslint-disable-line
 declare namespace WrappedView {
 
     type Options = {
-        dataView: DataView,
+        dataView: DataView|null,
         wrapIndex: number
     };
 
@@ -15,7 +15,7 @@ declare namespace WrappedView {
 
 declare class WrappedView extends EventDispatcher {
 
-    constructor(options: WrappedView.Options);
+    constructor(options: WrappedView.Options|null);
 
     public dispose(): void;
 
@@ -23,15 +23,15 @@ declare class WrappedView extends EventDispatcher {
 
     public getRowData(rid: string): { [key: string]:  any };
 
-    public getColumnData(cid: string, inclNonDataRow?: boolean): any[];
+    public getColumnData(cid: string, inclNonDataRow?: boolean|null): any[];
 
     public getRowId(rowIndex: number): string;
 
-    public getAllRowIds(shallowCopy?: boolean, inclNonDataRow?: boolean): (string)[];
+    public getAllRowIds(shallowCopy?: boolean|null, inclNonDataRow?: boolean|null): (string)[];
 
-    public getVisibleRowIds(shallowCopy?: boolean): (string)[];
+    public getVisibleRowIds(shallowCopy?: boolean|null): (string)[];
 
-    public getSortedRowIds(shallowCopy?: boolean): (string)[];
+    public getSortedRowIds(shallowCopy?: boolean|null): (string)[];
 
     public getRowIndex(rid: string): number;
 
@@ -43,69 +43,69 @@ declare class WrappedView extends EventDispatcher {
 
     public getPreviousData(rid: string, cid: string): { [key: string]:  any };
 
-    public getMultipleRowData(rids: (string)[], opt_from?: number, opt_to?: number): (any)[];
+    public getMultipleRowData(rids: (string)[]|null, opt_from?: number|null, opt_to?: number|null): (any)[];
 
     public getAllRowData(): (any)[];
 
     public setData(rid: string, cid: string, value: any): boolean;
 
-    public setRowData(rid: string, values?: { [key: string]:  any }, opt_eventArg?: any): boolean;
+    public setRowData(rid: string, values?: { [key: string]:  any }|null, opt_eventArg?: any): boolean;
 
-    public setColumnData(cid: string, valueList: any[], opt_ridList?: (string)[]): void;
+    public setColumnData(cid: string, valueList: any[]|null, opt_ridList?: (string)[]|null): void;
 
     public setDataAt(rowIndex: number, cid: string, value: any): boolean;
 
-    public setRowDataAt(rowIndex: number, values?: { [key: string]:  any }, opt_eventArg?: any): boolean;
+    public setRowDataAt(rowIndex: number, values?: { [key: string]:  any }|null, opt_eventArg?: any): boolean;
 
-    public insertRow(rowRef: string|number, opt_values?: { [key: string]:  any }, opt_rid?: string|null): string;
+    public insertRow(rowRef: string|number|null, opt_values?: { [key: string]:  any }|null, opt_rid?: string|null|null): string;
 
-    public removeRow(rowRef: number|string): void;
+    public removeRow(rowRef: number|string|null): void;
 
-    public removeRows(rowRefs: (number|string)[]): void;
+    public removeRows(rowRefs: (number|string)[]|null): void;
 
-    public moveRow(fromRef: (number|string)[]|number|string, toRef: number|string): (string)[]|string|null;
+    public moveRow(fromRef: (number|string)[]|number|string|null, toRef: number|string|null): (string)[]|string|null;
 
     public getDataTable(): DataTable|null;
 
     public getDataSource(): DataView|null;
 
-    public setDataSource(source?: DataView): void;
+    public setDataSource(source?: DataView|null): void;
 
     public setConflationRate(milliSecond: number): void;
 
     public getConflationRate(): number;
 
-    public sort(cid: string|(string)[], opt_sortOrder?: string|number|(string|number)[], sortLogics?: ((...params: any[]) => any)|(((...params: any[]) => any))[], noOptimization?: boolean): void;
+    public sort(cid: string|(string)[]|null, opt_sortOrder?: string|number|(string|number)[]|null, sortLogics?: ((...params: any[]) => any)|(((...params: any[]) => any))[]|null, noOptimization?: boolean|null): void;
 
-    public sortOnce(cid: string|(string)[], opt_sortOrder?: string|number|(string|number)[]): void;
+    public sortOnce(cid: string|(string)[]|null, opt_sortOrder?: string|number|(string|number)[]|null): void;
 
-    public setSortingLogic(func: DataTable.SortLogic): void;
+    public setSortingLogic(func: DataTable.SortLogic|null): void;
 
-    public setColumnSortingLogic(cid: string, func: DataTable.SortLogic): void;
+    public setColumnSortingLogic(cid: string, func: DataTable.SortLogic|null): void;
 
     public isSorting(): boolean;
 
-    public hideRow(rId: string|number, opt_show?: boolean): void;
+    public hideRow(rId: string|number|null, opt_show?: boolean|null): void;
 
-    public hideRows(rowRefs: (string|number)[], opt_show?: boolean): void;
+    public hideRows(rowRefs: (string|number)[]|null, opt_show?: boolean|null): void;
 
-    public showRows(rowRefs: (string|number)[], opt_show?: boolean): void;
+    public showRows(rowRefs: (string|number)[]|null, opt_show?: boolean|null): void;
 
     public unhideAllRows(): void;
 
     public hasHiddenRow(): boolean;
 
-    public filterIn(cid: string|((...params: any[]) => any), value?: any, opt_filteringOut?: boolean): boolean;
+    public filterIn(cid: string|((...params: any[]) => any), value?: any, opt_filteringOut?: boolean|null): boolean;
 
     public filterOut(cid: string|((...params: any[]) => any), value?: any): boolean;
 
-    public filterInOnce(cid: string|((...params: any[]) => any), value?: any, opt_filteringOut?: boolean): void;
+    public filterInOnce(cid: string|((...params: any[]) => any)|null, value?: any, opt_filteringOut?: boolean|null): void;
 
     public filterOutOnce(cid: string|((...params: any[]) => any), value?: any): void;
 
     public clearFilter(): void;
 
-    public disablePageCorrection(opt_disable?: boolean): void;
+    public disablePageCorrection(opt_disable?: boolean|null): void;
 
     public setPage(pageIndex: number): boolean;
 
@@ -137,25 +137,25 @@ declare class WrappedView extends EventDispatcher {
 
     public setPageSize(pageSize: number): void;
 
-    public groupBy(cid: string|((...params: any[]) => any)|(string|((...params: any[]) => any))[], opt_predefinedGroups?: any[]): void;
+    public groupBy(cid: string|((...params: any[]) => any)|(string|((...params: any[]) => any))[]|null, opt_predefinedGroups?: any[]|null): void;
 
     public addGroup(value: any|any[]): void;
 
-    public sortGroups(compare?: ((...params: any[]) => any)): void;
+    public sortGroups(compare?: ((...params: any[]) => any)|null): void;
 
-    public moveGroup(groupRef: number|string, destIndex: number): void;
+    public moveGroup(groupRef: number|string|null, destIndex: number): void;
 
-    public setPredefinedGroups(predefinedGroups: any[]): void;
+    public setPredefinedGroups(predefinedGroups: any[]|null): void;
 
-    public addFooter(opt_num?: number): void;
+    public addFooter(opt_num?: number|null): void;
 
     public removeFooter(): void;
 
     public getGroupByRowId(rowId: string): DataView|null;
 
-    public getGroup(groupRef: number|string): DataView|null;
+    public getGroup(groupRef: number|string|null): DataView|null;
 
-    public getAllGroups(out_ary?: any[]): (DataView)[];
+    public getAllGroups(out_ary?: any[]|null): (DataView)[];
 
     public getGroupList(): (string)[]|null;
 
@@ -169,67 +169,67 @@ declare class WrappedView extends EventDispatcher {
 
     public getGroupRows(): null;
 
-    public getGroupLevel(rowRef?: (number|string)): number;
+    public getGroupLevel(rowRef?: (number|string)|null): number;
 
-    public enableColumnStats(cid: string, opt_enabled?: boolean, opt_refId?: string): ColumnStats|null;
+    public enableColumnStats(cid: string, opt_enabled?: boolean|null, opt_refId?: string|null): ColumnStats|null;
 
     public getColumnStats(cid: string): ColumnStats|null;
 
-    public hide(opt_hidden?: boolean): boolean;
+    public hide(opt_hidden?: boolean|null): boolean;
 
     public isHidden(): boolean;
 
     public isHiddenRow(rowId: string): boolean;
 
-    public collapse(opt_collapsed?: boolean): void;
+    public collapse(opt_collapsed?: boolean|null): void;
 
-    public collapseAllGroups(opt_collapsed?: boolean): void;
+    public collapseAllGroups(opt_collapsed?: boolean|null): void;
 
     public toggleCollapsedState(): void;
 
     public isCollapsed(): boolean;
 
-    public enableContentAsHeader(bool?: boolean): void;
+    public enableContentAsHeader(bool?: boolean|null): void;
 
     public getVisibleRowCount(): number;
 
-    public isRowDataInGroup(rowData: any, groupID?: string): boolean;
+    public isRowDataInGroup(rowData: any, groupID?: string|null): boolean;
 
-    public isRowIdInGroup(rowId: string, groupID?: string): boolean;
+    public isRowIdInGroup(rowId: string, groupID?: string|null): boolean;
 
-    public addRowExpansion(rid: string, count?: number): void;
+    public addRowExpansion(rid: string, count?: number|null): void;
 
     public removeRowExpansion(rid: string): void;
 
-    public toggleRowExpansion(rowRef: string|number, force?: boolean, count?: number): void;
+    public toggleRowExpansion(rowRef: string|number|null, force?: boolean|null, count?: number|null): void;
 
     public removeAllRowExpansions(): void;
 
-    public getExpansionParents(from?: number, to?: number): (string)[]|null;
+    public getExpansionParents(from?: number|null, to?: number|null): (string)[]|null;
 
     public isRowExpansion(rid: string): boolean;
 
     public hasRowExpansion(rid: string): boolean;
 
-    public getRowExpansionId(rid: string, idx?: number): string;
+    public getRowExpansionId(rid: string, idx?: number|null): string;
 
     public getRowExpansionIndex(rid: string): number;
 
-    public searchAll(searchLogic: ((...params: any[]) => any), opt_out?: (string)[]): (string)[];
+    public searchAll(searchLogic: ((...params: any[]) => any)|null, opt_out?: (string)[]|null): (string)[];
 
-    public searchPrev(rowRef: number|string, searchLogic: ((...params: any[]) => any)): number;
+    public searchPrev(rowRef: number|string|null, searchLogic: ((...params: any[]) => any)|null): number;
 
-    public searchNext(rowRef: number|string, searchLogic: ((...params: any[]) => any)): number;
+    public searchNext(rowRef: number|string|null, searchLogic: ((...params: any[]) => any)|null): number;
 
-    public stall(opt_bool?: boolean): boolean;
+    public stall(opt_bool?: boolean|null): boolean;
 
-    public enableAutoGroupRemoval(opt_bool?: boolean): boolean;
+    public enableAutoGroupRemoval(opt_bool?: boolean|null): boolean;
 
-    public enableAutoGroupHiding(opt_bool?: boolean): boolean;
+    public enableAutoGroupHiding(opt_bool?: boolean|null): boolean;
 
     public synchronizeRowOrder(): void;
 
-    public setSegmentSeparator(rowRef: string|number, enabled?: boolean): boolean;
+    public setSegmentSeparator(rowRef: string|number|null, enabled?: boolean|null): boolean;
 
     public unsetAllSegmentSeparators(): boolean;
 
@@ -239,39 +239,39 @@ declare class WrappedView extends EventDispatcher {
 
     public getSegmentParentRowId(rid: string): string;
 
-    public collapseSegment(rowRef: string|number, collapsed?: boolean): boolean;
+    public collapseSegment(rowRef: string|number|null, collapsed?: boolean|null): boolean;
 
-    public expandSegment(rowRef: string|number, expanded?: boolean): boolean;
+    public expandSegment(rowRef: string|number|null, expanded?: boolean|null): boolean;
 
     public expandAllSegments(): boolean;
 
-    public isSegmentCollapsed(rowRef: string|number): boolean;
+    public isSegmentCollapsed(rowRef: string|number|null): boolean;
 
-    public fillSegment(segmentRef: string|number): void;
+    public fillSegment(segmentRef: string|number|null): void;
 
     public fillSegments(): void;
 
-    public addSegmentChild(segmentRef: string|number, rowRef: string|number): boolean;
+    public addSegmentChild(segmentRef: string|number|null, rowRef: string|number|null): boolean;
 
-    public addSegmentChildren(segmentRef: string|number, rowRefs: (string|number)[]): boolean;
+    public addSegmentChildren(segmentRef: string|number|null, rowRefs: (string|number)[]|null): boolean;
 
-    public removeSegmentChild(segmentRef: string|number, rowRef: string|number): boolean;
+    public removeSegmentChild(segmentRef: string|number|null, rowRef: string|number|null): boolean;
 
-    public removeSegmentChildren(segmentRef: string|number, rowRefs: (string|number)[]): boolean;
+    public removeSegmentChildren(segmentRef: string|number|null, rowRefs: (string|number)[]|null): boolean;
 
     public removeAllSegmentChildren(): boolean;
 
     public getSegmentIds(): (string)[]|null;
 
-    public getSegmentChildIds(segmentRef: string|number): (string)[]|null;
+    public getSegmentChildIds(segmentRef: string|number|null): (string)[]|null;
 
-    public sortSegments(compare: ((...params: any[]) => any)): void;
+    public sortSegments(compare: ((...params: any[]) => any)|null): void;
 
     public getWrapSize(): number;
 
     public getWrappedViews(): (WrappedView)[]|null;
 
-    public wrapView(wrapSize?: number): void;
+    public wrapView(wrapSize?: number|null): void;
 
     public dump(opt_options?: any): (any)[];