@refinitiv-ui/efx-grid 6.0.2 → 6.0.5

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

@@ -14,7 +14,7 @@ declare class ColumnStats {
 
     public setColumnDataGetter(func: ((...params: any[]) => any)): void;
 
-    public getColumnDataGetter(): ((...params: any[]) => any);
+    public getColumnDataGetter(): ((...params: any[]) => any)|null;
 
     public getSum(): number;
 
@@ -32,7 +32,7 @@ declare class ColumnStats {
 
     public getMidRange(): number;
 
-    public getCachedColumnData(): (number)[];
+    public getCachedColumnData(): (number)[]|null;
 
     public markDirty(): boolean;
 

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

@@ -29,9 +29,9 @@ declare class DataCache extends EventDispatcher {
 
     public getData(rid: string, cid: string): any;
 
-    public getAllRics(): { [key: string]:  any };
+    public getAllRics(): { [key: string]:  any }|null;
 
-    public getAllRowIds(): (string)[];
+    public getAllRowIds(): (string)[]|null;
 
     public hasRowId(rid: string): boolean;
 
@@ -57,7 +57,7 @@ declare class DataCache extends EventDispatcher {
 
     public resetStaticFields(): void;
 
-    public getStaticFields(): { [key: string]:  number };
+    public getStaticFields(): { [key: string]:  number }|null;
 
     public dump(options?: any): (any)[];
 
@@ -65,7 +65,7 @@ declare class DataCache extends EventDispatcher {
 
     public setDataCloudSettings(userId: string, productId: string, url: string, opt_lang?: string): void;
 
-    public getDataCloudFields(): (string)[];
+    public getDataCloudFields(): (string)[]|null;
 
     public addDataCloudFields(fields: (string)[]|string): boolean;
 

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

@@ -51,9 +51,9 @@ declare class DataTable extends DataCache {
 
     public removeAllRows(suppressEvent?: boolean): void;
 
-    public moveRow(fromIndex: (number)[]|number, toIndex: number, suppressEvent?: boolean): (string)[]|string;
+    public moveRow(fromIndex: (number)[]|number, toIndex: number, suppressEvent?: boolean): (string)[]|string|null;
 
-    public moveRows(startIndex: number|string, toIndex: number|string, opt_count?: number, suppressEvent?: boolean): (string)[];
+    public moveRows(startIndex: number|string, toIndex: number|string, opt_count?: number, suppressEvent?: boolean): (string)[]|null;
 
     public swapRow(fromIndex: number, toIndex: number): void;
 
@@ -85,7 +85,7 @@ declare class DataTable extends DataCache {
 
     public getSegmentParentRowId(rid: string): string;
 
-    public getSegmentValues(rids?: (string)[]): (number)[];
+    public getSegmentValues(rids?: (string)[]): (number)[]|null;
 
     public fillSegment(segmentId: string): void;
 
@@ -101,9 +101,9 @@ declare class DataTable extends DataCache {
 
     public removeAllSegmentChildren(): boolean;
 
-    public getSegmentIds(): (string)[];
+    public getSegmentIds(): (string)[]|null;
 
-    public getSegmentChildIds(segmentId: string): (string)[];
+    public getSegmentChildIds(segmentId: string): (string)[]|null;
 
     public sortSegments(compare: ((...params: any[]) => any)): void;
 

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

@@ -841,7 +841,7 @@ DataTable.prototype.setColumnSortingLogic = function(cid, func) {
 * @example
 * var prevState = dt.freeze();
 * for(var i = 0; i < 100; ++i) {
-*   dt.insertRow({}); // no event is fired
+*   dt.insertRow(); // no event is fired
 * }
 * dt.freeze(prevState); // Restore previous freeze states
 */
@@ -878,6 +878,7 @@ DataTable.prototype.isFrozen = function() {
 */
 DataTable.prototype.setSegmentSeparator = function(rid, enabled) {
 	var change = false;
+	var memberCount = 0;
 	if(typeof rid === "string") {
 		if(enabled !== false) {
 			if(!this._segments) {
@@ -887,16 +888,20 @@ DataTable.prototype.setSegmentSeparator = function(rid, enabled) {
 				change = true;
 			}
 		} else if(this._segments) {
-			if(this._segments.removeSegment(rid)) {
-				change = true;
-				if(!this._segments.getSegmentCount()) {
-					this._segments = null;
+			var segment = this._segments.getSegment(rid);
+			if(segment) {
+				memberCount = segment.getChildCount();
+				if(this._segments.removeSegment(rid)) {
+					change = true;
+					if(!this._segments.getSegmentCount()) {
+						this._segments = null;
+					}
 				}
 			}
 		}
 	}
 	if(change && this._needFiring()) {
-		if(this._autoFillSegments()) {
+		if(this._autoFillSegments() || memberCount) {
 			this.dispatchGlobalChange();
 		} else {
 			var rowData = this._rows[rid] || null;
@@ -1008,13 +1013,14 @@ DataTable.prototype._autoFillSegments = function() {
 	}
 	return false;
 };
-/** Remove existing segment children and fill the segments with all contnet rows before the next segment separator
+/** Remove existing segment children and fill the segments with all content rows before the next segment separator
 * @public
 * @param {string} segmentId Row id
 */
 DataTable.prototype.fillSegment = function(segmentId) {
 	if(this._segments) {
 		this._segments.fillSegment(segmentId, this._rids);
+		this.dispatchGlobalChange();
 	}
 };
 /** Remove all existing segment children in each segment and fill the segments with all contnet rows before the next segment separator
@@ -1023,7 +1029,11 @@ DataTable.prototype.fillSegment = function(segmentId) {
 */
 DataTable.prototype.fillSegments = function() {
 	if(this._segments) {
-		return this._segments.fillSegments(this._rids);
+		var dirty = this._segments.fillSegments(this._rids);
+		if(dirty) {
+			this.dispatchGlobalChange();
+		}
+		return dirty;
 	}
 	return false;
 };
@@ -1068,7 +1078,11 @@ DataTable.prototype.addSegmentChildren = function(segmentId, rids) {
 */
 DataTable.prototype.removeSegmentChild = function(segmentId, rid) {
 	if(this._segments) {
-		return this._segments.removeSegmentChild(segmentId, rid);
+		var dirty = this._segments.removeSegmentChild(segmentId, rid);
+		if(dirty) {
+			this.dispatchGlobalChange();
+		}
+		return dirty;
 	}
 	return false;
 };
@@ -1079,7 +1093,11 @@ DataTable.prototype.removeSegmentChild = function(segmentId, rid) {
 */
 DataTable.prototype.removeSegmentChildren = function(segmentId, rids) {
 	if(this._segments) {
-		return this._segments.removeSegmentChildren(segmentId, rids);
+		var dirty = this._segments.removeSegmentChildren(segmentId, rids);
+		if(dirty) {
+			this.dispatchGlobalChange();
+		}
+		return dirty;
 	}
 	return false;
 };
@@ -1088,7 +1106,11 @@ DataTable.prototype.removeSegmentChildren = function(segmentId, rids) {
 */
 DataTable.prototype.removeAllSegmentChildren = function() {
 	if(this._segments) {
-		return this._segments.removeAllSegmentChildren();
+		var dirty = this._segments.removeAllSegmentChildren();
+		if (dirty) {
+			this.dispatchGlobalChange();
+		}
+		return dirty;
 	}
 	return false;
 };

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

@@ -7,12 +7,6 @@ import EventDispatcher from "../grid/event/EventDispatcher.js";
 import Util from "../grid/util/util.js";
 import { Conflator } from "../../../tr-grid-util/es6/Conflator.js";
 
-declare namespace DataView {
-
-    type IDataView = DataTable|WrappedView|DataView;
-
-}
-
 declare class DataView extends EventDispatcher {
 
     constructor(source?: DataTable|DataView);
@@ -63,13 +57,13 @@ declare class DataView extends EventDispatcher {
 
     public removeRows(rowRefs: (number|string)[]): void;
 
-    public moveRow(fromRef: (number|string)[]|number|string, toRef: number|string): (string)[]|string;
+    public moveRow(fromRef: (number|string)[]|number|string, toRef: number|string): (string)[]|string|null;
 
     public swapRow(fromIndex: number, toIndex: number): void;
 
-    public getDataTable(): DataTable;
+    public getDataTable(): DataTable|null;
 
-    public getDataSource(): DataTable|DataView;
+    public getDataSource(): DataTable|DataView|null;
 
     public setDataSource(source?: (DataTable|DataView)): void;
 
@@ -153,13 +147,13 @@ declare class DataView extends EventDispatcher {
 
     public removeFooter(): void;
 
-    public getGroupByRowId(rowId: string): DataView;
+    public getGroupByRowId(rowId: string): DataView|null;
 
-    public getGroup(groupRef: number|string): DataView;
+    public getGroup(groupRef: number|string): DataView|null;
 
     public getAllGroups(out_ary?: any[]): (DataView)[];
 
-    public getGroupList(): (string)[];
+    public getGroupList(): (string)[]|null;
 
     public getGroupId(): string;
 
@@ -173,9 +167,9 @@ declare class DataView extends EventDispatcher {
 
     public getGroupLevel(rowRef?: (number|string)): number;
 
-    public enableColumnStats(cid: string, opt_enabled?: boolean, opt_refId?: string): ColumnStats;
+    public enableColumnStats(cid: string, opt_enabled?: boolean, opt_refId?: string): ColumnStats|null;
 
-    public getColumnStats(cid: string): ColumnStats;
+    public getColumnStats(cid: string): ColumnStats|null;
 
     public hide(opt_hidden?: boolean): boolean;
 
@@ -207,7 +201,7 @@ declare class DataView extends EventDispatcher {
 
     public removeAllRowExpansions(): void;
 
-    public getExpansionParents(from?: number, to?: number): (string)[];
+    public getExpansionParents(from?: number, to?: number): (string)[]|null;
 
     public isRowExpansion(rid: string): boolean;
 
@@ -263,15 +257,15 @@ declare class DataView extends EventDispatcher {
 
     public removeAllSegmentChildren(): boolean;
 
-    public getSegmentIds(): (string)[];
+    public getSegmentIds(): (string)[]|null;
 
-    public getSegmentChildIds(segmentRef: string|number): (string)[];
+    public getSegmentChildIds(segmentRef: string|number): (string)[]|null;
 
     public sortSegments(compare: ((...params: any[]) => any)): void;
 
     public getWrapSize(): number;
 
-    public getWrappedViews(): (WrappedView)[];
+    public getWrappedViews(): (WrappedView)[]|null;
 
     public wrapView(wrapSize?: number): void;
 

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

@@ -7,10 +7,6 @@ import EventDispatcher from "../grid/event/EventDispatcher.js";
 import Util from "../grid/util/util.js";
 import { Conflator } from "../../../tr-grid-util/es6/Conflator.js";
 
-/** @typedef {DataTable|WrappedView|DataView} DataView~IDataView
-* @description DataView like classes
-*/
-
 /** @event DataView#dataChanged
 * @description Trigger when data within the data view has been changed. Not only actual change in data, but also position change will trigger this event.
 * @property {boolean} globalChange Indicates a big change. User should expect all data has been change. With active sorting or filtering, this flag will always be true due to multiple changes in row position.

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

@@ -20,6 +20,8 @@ declare class Segment {
 
     public getChildIds(): (string)[];
 
+    public getChildCount(): number;
+
     public collapse(bool?: boolean): boolean;
 
     public expand(bool?: boolean): boolean;

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

@@ -131,6 +131,13 @@ Segment.prototype.removeAllChildren = function(objMap) {
 Segment.prototype.getChildIds = function() {
 	return this._childCount ? Object.keys(this._children) : [];
 };
+/** @public
+* @return {number}
+*/
+Segment.prototype.getChildCount = function() {
+	return this._childCount;
+};
+
 
 
 /** @public

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

@@ -18,9 +18,9 @@ declare class SegmentCollection {
 
     public getSegmentCount(): number;
 
-    public getSegment(rid: string): Segment;
+    public getSegment(rid: string): Segment|null;
 
-    public getSegments(): { [key: string]:  Segment };
+    public getSegments(): { [key: string]:  Segment }|null;
 
     public getSegmentIds(): (string)[];
 
@@ -50,7 +50,7 @@ declare class SegmentCollection {
 
     public fillSegments(rids: (string)[]): boolean;
 
-    public getSegmentValues(rids: (string)[]): (number)[];
+    public getSegmentValues(rids: (string)[]): (number)[]|null;
 
 }
 

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

@@ -63,11 +63,11 @@ declare class WrappedView extends EventDispatcher {
 
     public removeRows(rowRefs: (number|string)[]): void;
 
-    public moveRow(fromRef: (number|string)[]|number|string, toRef: number|string): (string)[]|string;
+    public moveRow(fromRef: (number|string)[]|number|string, toRef: number|string): (string)[]|string|null;
 
-    public getDataTable(): DataTable;
+    public getDataTable(): DataTable|null;
 
-    public getDataSource(): DataView;
+    public getDataSource(): DataView|null;
 
     public setDataSource(source?: DataView): void;
 
@@ -151,13 +151,13 @@ declare class WrappedView extends EventDispatcher {
 
     public removeFooter(): void;
 
-    public getGroupByRowId(rowId: string): DataView;
+    public getGroupByRowId(rowId: string): DataView|null;
 
-    public getGroup(groupRef: number|string): DataView;
+    public getGroup(groupRef: number|string): DataView|null;
 
     public getAllGroups(out_ary?: any[]): (DataView)[];
 
-    public getGroupList(): (string)[];
+    public getGroupList(): (string)[]|null;
 
     public getGroupId(): string;
 
@@ -171,9 +171,9 @@ declare class WrappedView extends EventDispatcher {
 
     public getGroupLevel(rowRef?: (number|string)): number;
 
-    public enableColumnStats(cid: string, opt_enabled?: boolean, opt_refId?: string): ColumnStats;
+    public enableColumnStats(cid: string, opt_enabled?: boolean, opt_refId?: string): ColumnStats|null;
 
-    public getColumnStats(cid: string): ColumnStats;
+    public getColumnStats(cid: string): ColumnStats|null;
 
     public hide(opt_hidden?: boolean): boolean;
 
@@ -205,7 +205,7 @@ declare class WrappedView extends EventDispatcher {
 
     public removeAllRowExpansions(): void;
 
-    public getExpansionParents(from?: number, to?: number): (string)[];
+    public getExpansionParents(from?: number, to?: number): (string)[]|null;
 
     public isRowExpansion(rid: string): boolean;
 
@@ -261,15 +261,15 @@ declare class WrappedView extends EventDispatcher {
 
     public removeAllSegmentChildren(): boolean;
 
-    public getSegmentIds(): (string)[];
+    public getSegmentIds(): (string)[]|null;
 
-    public getSegmentChildIds(segmentRef: string|number): (string)[];
+    public getSegmentChildIds(segmentRef: string|number): (string)[]|null;
 
     public sortSegments(compare: ((...params: any[]) => any)): void;
 
     public getWrapSize(): number;
 
-    public getWrappedViews(): (WrappedView)[];
+    public getWrappedViews(): (WrappedView)[]|null;
 
     public wrapView(wrapSize?: number): void;
 
@@ -281,7 +281,7 @@ declare class WrappedView extends EventDispatcher {
 
 }
 
-declare function fromRids(): DataTable;
+declare function fromRids(): DataTable|null;
 
 declare function complexData(opt_options?: any): void;
 

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

@@ -958,7 +958,7 @@ WrappedView.prototype.addRowExpansion = function(rid, count) {
 * @param {string} rid Row Id
 */
 WrappedView.prototype.removeRowExpansion = function(rid) {
-	this._dv.removeRowExpansion(rid, count);
+	this._dv.removeRowExpansion(rid);
 };
 /**
 * @public
@@ -1165,7 +1165,7 @@ WrappedView.prototype.setSegmentCollapsingLogic = function() {};
 */
 WrappedView.prototype.isSegmentCollapsed = function(rowRef) {
 	var rid = this._toRowId(rowRef);
-	return this._dv.isSegmentCollapsed(rid, collapsed);
+	return this._dv.isSegmentCollapsed(rid);
 };
 /** Remove existing segment children and fill the segments with all contnet rows before the next segment separator
 * @public
@@ -1198,8 +1198,8 @@ WrappedView.prototype.addSegmentChild = function(segmentRef, rowRef) {
 */
 WrappedView.prototype.addSegmentChildren = function(segmentRef, rowRefs) {
 	var segmentId = this._toRowId(segmentRef);
-	var rowId = this._toRowId(rowRef);
-	return this._dv.addSegmentChildren(segmentId, rowId);
+	var rowIds = this._toRowIds(rowRefs);
+	return this._dv.addSegmentChildren(segmentId, rowIds);
 };
 /** @public
 * @param {string|number} segmentRef Row id or row index
@@ -1218,8 +1218,8 @@ WrappedView.prototype.removeSegmentChild = function(segmentRef, rowRef) {
 */
 WrappedView.prototype.removeSegmentChildren = function(segmentRef, rowRefs) {
 	var segmentId = this._toRowId(segmentRef);
-	var rowId = this._toRowId(rowRef);
-	return this._dv.removeSegmentChildren(segmentId, rowId);
+	var rowIds = this._toRowIds(rowRefs);
+	return this._dv.removeSegmentChildren(segmentId, rowIds);
 };
 /** @public
 * @return {boolean} Return true if there is any change

package/lib/core/es6/grid/Core.d.ts

@@ -68,23 +68,23 @@ declare class Core extends ElementWrapper {
 
     public getSectionCount(): number;
 
-    public addSection(opt_type?: string, opt_sectionName?: string): ILayoutGrid|null;
+    public addSection(opt_type?: string, opt_sectionName?: string): ILayoutGrid|null|null;
 
-    public addSectionAt(at: number, opt_type?: string, opt_sectionName?: string): ILayoutGrid|null;
+    public addSectionAt(at: number, opt_type?: string, opt_sectionName?: string): ILayoutGrid|null|null;
 
-    public removeSection(sectionRef: Core.SectionReference): ILayoutGrid;
+    public removeSection(sectionRef: Core.SectionReference): ILayoutGrid|null;
 
-    public removeSectionAt(at: number): ILayoutGrid;
+    public removeSectionAt(at: number): ILayoutGrid|null;
 
-    public removeLastSection(): ILayoutGrid;
+    public removeLastSection(): ILayoutGrid|null;
 
     public removeAllSections(): void;
 
     public setBottomPaddingSection(paddingSize: boolean|number): void;
 
-    public getSection(sectionRef: Core.SectionReference): ILayoutGrid;
+    public getSection(sectionRef: Core.SectionReference): ILayoutGrid|null;
 
-    public getSectionSettings(sectionRef: Core.SectionReference): SectionSettings;
+    public getSectionSettings(sectionRef: Core.SectionReference): SectionSettings|null;
 
     public getAllSections(opt_type?: string): (ILayoutGrid)[];
 
@@ -94,23 +94,23 @@ declare class Core extends ElementWrapper {
 
     public getSectionTop(sectionRef: Core.SectionReference): number;
 
-    public getPreviousSection(identifier?: (MouseEvent|Core.SectionReference), opt_type?: string): ILayoutGrid;
+    public getPreviousSection(identifier?: (MouseEvent|Core.SectionReference), opt_type?: string): ILayoutGrid|null;
 
-    public getNextSection(identifier?: (MouseEvent|Core.SectionReference), opt_type?: string): ILayoutGrid;
+    public getNextSection(identifier?: (MouseEvent|Core.SectionReference), opt_type?: string): ILayoutGrid|null;
 
-    public getLastSection(): ILayoutGrid;
+    public getLastSection(): ILayoutGrid|null;
 
-    public getCell(sectionRef: Core.SectionReference, colIndex: number, rowIndex: number, opt_includeSpan?: boolean): ElementWrapper;
+    public getCell(sectionRef: Core.SectionReference, colIndex: number, rowIndex: number, opt_includeSpan?: boolean): ElementWrapper|null;
 
-    public getCellInfo(cellRef: Core.CellReference): Core.MouseInfo;
+    public getCellInfo(cellRef: Core.CellReference): Core.MouseInfo|null;
 
-    public getNextCellInRow(cellRef: Core.CellReference, step?: number): Core.MouseInfo;
+    public getNextCellInRow(cellRef: Core.CellReference, step?: number): Core.MouseInfo|null;
 
-    public getPrevCellInRow(cellRef: Core.CellReference, step?: number): Core.MouseInfo;
+    public getPrevCellInRow(cellRef: Core.CellReference, step?: number): Core.MouseInfo|null;
 
-    public getNextCell(cellRef: Core.CellReference): Core.MouseInfo;
+    public getNextCell(cellRef: Core.CellReference): Core.MouseInfo|null;
 
-    public getPrevCell(cellRef: Core.CellReference): Core.MouseInfo;
+    public getPrevCell(cellRef: Core.CellReference): Core.MouseInfo|null;
 
     public getColumnCount(): number;
 
@@ -146,13 +146,13 @@ declare class Core extends ElementWrapper {
 
     public setDefaultRowHeight(val: number, opt_includeTitle?: boolean): void;
 
-    public getDataSource(): DataView;
+    public getDataSource(): DataView|null;
 
     public setDataConflationRate(milliSecond: number): void;
 
     public getDataConflationRate(): number;
 
-    public setDataSource(dataSource: DataTable|DataView): DataView;
+    public setDataSource(dataSource: DataTable|DataView): DataView|null;
 
     public getColumnRenderEvent(): void;
 
@@ -272,7 +272,7 @@ declare class Core extends ElementWrapper {
 
     public toggleHorizontalLines(forcedVal?: boolean): void;
 
-    public getDataColumnMap(): (string)[];
+    public getDataColumnMap(): (string)[]|null;
 
     public setDataColumnMap(opt_dataMap?: (string)[]): void;
 
@@ -288,9 +288,9 @@ declare class Core extends ElementWrapper {
 
     public setColumnDataBindingHandler(c: number, func: any): void;
 
-    public getColumnRenderingHandler(c: number): ((...params: any[]) => any);
+    public getColumnRenderingHandler(c: number): ((...params: any[]) => any)|null;
 
-    public getColumnDataBindingHandler(c: number): ((...params: any[]) => any);
+    public getColumnDataBindingHandler(c: number): ((...params: any[]) => any)|null;
 
     public enableRowHighlighting(opt_enabled?: boolean): void;
 
@@ -314,7 +314,7 @@ declare class Core extends ElementWrapper {
 
     public getScrollWidth(): number;
 
-    public getYScrollVal(sectionRef: Core.SectionReference, rowIndex: number, topOfView?: boolean): number|null;
+    public getYScrollVal(sectionRef: Core.SectionReference, rowIndex: number, topOfView?: boolean): number|null|null;
 
     public scrollToRow(sectionRef: Core.SectionReference, rowIndex: number, topOfView?: boolean): void;
 
@@ -328,6 +328,8 @@ declare class Core extends ElementWrapper {
 
     public getScrollHeight(): number;
 
+    public restoreScrollbars(): void;
+
     public getRowVirtualizer(): Virtualizer;
 
     public getColumnVirtualizer(): Virtualizer;
@@ -338,7 +340,7 @@ declare class Core extends ElementWrapper {
 
     public setRowScrollingStep(rowCount: number): void;
 
-    public getVMouseWheelHandler(): ((...params: any[]) => any);
+    public getVMouseWheelHandler(): ((...params: any[]) => any)|null;
 
     public synchronizeVScrollbar(subGrid: Core): void;
 
@@ -348,11 +350,13 @@ declare class Core extends ElementWrapper {
 
     public requestRowRefresh(): void;
 
+    public _requestScrollbarUpdate(): void;
+
     public deactivateRendering(disabled?: boolean): void;
 
     public reserveRightSpace(size: number): boolean;
 
-    public getHiddenInput(): Element;
+    public getHiddenInput(): Element|null;
 
     public focus(): void;
 
@@ -384,11 +388,11 @@ declare function num(opt_type?: string): (ILayoutGrid)[];
 
 declare function mPos(sectionRef: Core.SectionReference): number;
 
-declare function rowIndex(cellRef: Core.CellReference, step?: number): Core.MouseInfo;
+declare function rowIndex(cellRef: Core.CellReference, step?: number): Core.MouseInfo|null;
 
-declare function rowIndex(cellRef: Core.CellReference): Core.MouseInfo;
+declare function rowIndex(cellRef: Core.CellReference): Core.MouseInfo|null;
 
-declare function section(cellRef: Core.CellReference): Core.MouseInfo;
+declare function section(cellRef: Core.CellReference): Core.MouseInfo|null;
 
 declare function section(): number;