You can not select more than 25 topics
			Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
		
		
		
		
		
			
		
			
				
					1073 lines
				
				34 KiB
			
		
		
			
		
	
	
					1073 lines
				
				34 KiB
			| 
											2 years ago
										 | "use strict"; | ||
|  | 
 | ||
|  | function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; } | ||
|  | 
 | ||
|  | function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; } | ||
|  | 
 | ||
|  | function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; } | ||
|  | 
 | ||
|  | function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); } | ||
|  | 
 | ||
|  | function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } | ||
|  | 
 | ||
|  | function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); } | ||
|  | 
 | ||
|  | function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && Symbol.iterator in Object(iter)) return Array.from(iter); } | ||
|  | 
 | ||
|  | function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); } | ||
|  | 
 | ||
|  | function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) { arr2[i] = arr[i]; } return arr2; } | ||
|  | 
 | ||
|  | function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } } | ||
|  | 
 | ||
|  | function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } } | ||
|  | 
 | ||
|  | function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; } | ||
|  | 
 | ||
|  | var _ = require('../utils/under-dash'); | ||
|  | 
 | ||
|  | var colCache = require('../utils/col-cache'); | ||
|  | 
 | ||
|  | var Range = require('./range'); | ||
|  | 
 | ||
|  | var Row = require('./row'); | ||
|  | 
 | ||
|  | var Column = require('./column'); | ||
|  | 
 | ||
|  | var Enums = require('./enums'); | ||
|  | 
 | ||
|  | var Image = require('./image'); | ||
|  | 
 | ||
|  | var Table = require('./table'); | ||
|  | 
 | ||
|  | var DataValidations = require('./data-validations'); | ||
|  | 
 | ||
|  | var Encryptor = require('../utils/encryptor'); // Worksheet requirements
 | ||
|  | //  Operate as sheet inside workbook or standalone
 | ||
|  | //  Load and Save from file and stream
 | ||
|  | //  Access/Add/Delete individual cells
 | ||
|  | //  Manage column widths and row heights
 | ||
|  | 
 | ||
|  | 
 | ||
|  | var Worksheet = /*#__PURE__*/function () { | ||
|  |   function Worksheet(options) { | ||
|  |     _classCallCheck(this, Worksheet); | ||
|  | 
 | ||
|  |     options = options || {}; // in a workbook, each sheet will have a number
 | ||
|  | 
 | ||
|  |     this.id = options.id; | ||
|  |     this.orderNo = options.orderNo; // and a name
 | ||
|  | 
 | ||
|  |     this.name = options.name || "Sheet".concat(this.id); // add a state
 | ||
|  | 
 | ||
|  |     this.state = options.state || 'visible'; // rows allows access organised by row. Sparse array of arrays indexed by row-1, col
 | ||
|  |     // Note: _rows is zero based. Must subtract 1 to go from cell.row to index
 | ||
|  | 
 | ||
|  |     this._rows = []; // column definitions
 | ||
|  | 
 | ||
|  |     this._columns = null; // column keys (addRow convenience): key ==> this._collumns index
 | ||
|  | 
 | ||
|  |     this._keys = {}; // keep record of all merges
 | ||
|  | 
 | ||
|  |     this._merges = {}; // record of all row and column pageBreaks
 | ||
|  | 
 | ||
|  |     this.rowBreaks = []; | ||
|  |     this._workbook = options.workbook; // for tabColor, default row height, outline levels, etc
 | ||
|  | 
 | ||
|  |     this.properties = Object.assign({}, { | ||
|  |       defaultRowHeight: 15, | ||
|  |       dyDescent: 55, | ||
|  |       outlineLevelCol: 0, | ||
|  |       outlineLevelRow: 0 | ||
|  |     }, options.properties); // for all things printing
 | ||
|  | 
 | ||
|  |     this.pageSetup = Object.assign({}, { | ||
|  |       margins: { | ||
|  |         left: 0.7, | ||
|  |         right: 0.7, | ||
|  |         top: 0.75, | ||
|  |         bottom: 0.75, | ||
|  |         header: 0.3, | ||
|  |         footer: 0.3 | ||
|  |       }, | ||
|  |       orientation: 'portrait', | ||
|  |       horizontalDpi: 4294967295, | ||
|  |       verticalDpi: 4294967295, | ||
|  |       fitToPage: !!(options.pageSetup && (options.pageSetup.fitToWidth || options.pageSetup.fitToHeight) && !options.pageSetup.scale), | ||
|  |       pageOrder: 'downThenOver', | ||
|  |       blackAndWhite: false, | ||
|  |       draft: false, | ||
|  |       cellComments: 'None', | ||
|  |       errors: 'displayed', | ||
|  |       scale: 100, | ||
|  |       fitToWidth: 1, | ||
|  |       fitToHeight: 1, | ||
|  |       paperSize: undefined, | ||
|  |       showRowColHeaders: false, | ||
|  |       showGridLines: false, | ||
|  |       firstPageNumber: undefined, | ||
|  |       horizontalCentered: false, | ||
|  |       verticalCentered: false, | ||
|  |       rowBreaks: null, | ||
|  |       colBreaks: null | ||
|  |     }, options.pageSetup); | ||
|  |     this.headerFooter = Object.assign({}, { | ||
|  |       differentFirst: false, | ||
|  |       differentOddEven: false, | ||
|  |       oddHeader: null, | ||
|  |       oddFooter: null, | ||
|  |       evenHeader: null, | ||
|  |       evenFooter: null, | ||
|  |       firstHeader: null, | ||
|  |       firstFooter: null | ||
|  |     }, options.headerFooter); | ||
|  |     this.dataValidations = new DataValidations(); // for freezepanes, split, zoom, gridlines, etc
 | ||
|  | 
 | ||
|  |     this.views = options.views || []; | ||
|  |     this.autoFilter = options.autoFilter || null; // for images, etc
 | ||
|  | 
 | ||
|  |     this._media = []; // worksheet protection
 | ||
|  | 
 | ||
|  |     this.sheetProtection = null; // for tables
 | ||
|  | 
 | ||
|  |     this.tables = {}; | ||
|  |     this.conditionalFormattings = []; | ||
|  |   } | ||
|  | 
 | ||
|  |   _createClass(Worksheet, [{ | ||
|  |     key: "destroy", | ||
|  |     // when you're done with this worksheet, call this to remove from workbook
 | ||
|  |     value: function destroy() { | ||
|  |       this._workbook.removeWorksheetEx(this); | ||
|  |     } // Get the bounding range of the cells in this worksheet
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "getColumnKey", | ||
|  |     value: function getColumnKey(key) { | ||
|  |       return this._keys[key]; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "setColumnKey", | ||
|  |     value: function setColumnKey(key, value) { | ||
|  |       this._keys[key] = value; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "deleteColumnKey", | ||
|  |     value: function deleteColumnKey(key) { | ||
|  |       delete this._keys[key]; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "eachColumnKey", | ||
|  |     value: function eachColumnKey(f) { | ||
|  |       _.each(this._keys, f); | ||
|  |     } // get a single column by col number. If it doesn't exist, create it and any gaps before it
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "getColumn", | ||
|  |     value: function getColumn(c) { | ||
|  |       if (typeof c === 'string') { | ||
|  |         // if it matches a key'd column, return that
 | ||
|  |         var col = this._keys[c]; | ||
|  |         if (col) return col; // otherwise, assume letter
 | ||
|  | 
 | ||
|  |         c = colCache.l2n(c); | ||
|  |       } | ||
|  | 
 | ||
|  |       if (!this._columns) { | ||
|  |         this._columns = []; | ||
|  |       } | ||
|  | 
 | ||
|  |       if (c > this._columns.length) { | ||
|  |         var n = this._columns.length + 1; | ||
|  | 
 | ||
|  |         while (n <= c) { | ||
|  |           this._columns.push(new Column(this, n++)); | ||
|  |         } | ||
|  |       } | ||
|  | 
 | ||
|  |       return this._columns[c - 1]; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "spliceColumns", | ||
|  |     value: function spliceColumns(start, count) { | ||
|  |       var _this = this; | ||
|  | 
 | ||
|  |       var rows = this._rows; | ||
|  |       var nRows = rows.length; | ||
|  | 
 | ||
|  |       for (var _len = arguments.length, inserts = new Array(_len > 2 ? _len - 2 : 0), _key = 2; _key < _len; _key++) { | ||
|  |         inserts[_key - 2] = arguments[_key]; | ||
|  |       } | ||
|  | 
 | ||
|  |       if (inserts.length > 0) { | ||
|  |         var _loop = function _loop(i) { | ||
|  |           var rowArguments = [start, count]; // eslint-disable-next-line no-loop-func
 | ||
|  | 
 | ||
|  |           inserts.forEach(function (insert) { | ||
|  |             rowArguments.push(insert[i] || null); | ||
|  |           }); | ||
|  | 
 | ||
|  |           var row = _this.getRow(i + 1); // eslint-disable-next-line prefer-spread
 | ||
|  | 
 | ||
|  | 
 | ||
|  |           row.splice.apply(row, rowArguments); | ||
|  |         }; | ||
|  | 
 | ||
|  |         // must iterate over all rows whether they exist yet or not
 | ||
|  |         for (var i = 0; i < nRows; i++) { | ||
|  |           _loop(i); | ||
|  |         } | ||
|  |       } else { | ||
|  |         // nothing to insert, so just splice all rows
 | ||
|  |         this._rows.forEach(function (r) { | ||
|  |           if (r) { | ||
|  |             r.splice(start, count); | ||
|  |           } | ||
|  |         }); | ||
|  |       } // splice column definitions
 | ||
|  | 
 | ||
|  | 
 | ||
|  |       var nExpand = inserts.length - count; | ||
|  |       var nKeep = start + count; | ||
|  |       var nEnd = this._columns.length; | ||
|  | 
 | ||
|  |       if (nExpand < 0) { | ||
|  |         for (var _i = start + inserts.length; _i <= nEnd; _i++) { | ||
|  |           this.getColumn(_i).defn = this.getColumn(_i - nExpand).defn; | ||
|  |         } | ||
|  |       } else if (nExpand > 0) { | ||
|  |         for (var _i2 = nEnd; _i2 >= nKeep; _i2--) { | ||
|  |           this.getColumn(_i2 + nExpand).defn = this.getColumn(_i2).defn; | ||
|  |         } | ||
|  |       } | ||
|  | 
 | ||
|  |       for (var _i3 = start; _i3 < start + inserts.length; _i3++) { | ||
|  |         this.getColumn(_i3).defn = null; | ||
|  |       } // account for defined names
 | ||
|  | 
 | ||
|  | 
 | ||
|  |       this.workbook.definedNames.spliceColumns(this.name, start, count, inserts.length); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "_commitRow", | ||
|  |     // =========================================================================
 | ||
|  |     // Rows
 | ||
|  |     value: function _commitRow() {// nop - allows streaming reader to fill a document
 | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "findRow", | ||
|  |     // find a row (if exists) by row number
 | ||
|  |     value: function findRow(r) { | ||
|  |       return this._rows[r - 1]; | ||
|  |     } // find multiple rows (if exists) by row number
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "findRows", | ||
|  |     value: function findRows(start, length) { | ||
|  |       return this._rows.slice(start - 1, start - 1 + length); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "getRow", | ||
|  |     // get a row by row number.
 | ||
|  |     value: function getRow(r) { | ||
|  |       var row = this._rows[r - 1]; | ||
|  | 
 | ||
|  |       if (!row) { | ||
|  |         row = this._rows[r - 1] = new Row(this, r); | ||
|  |       } | ||
|  | 
 | ||
|  |       return row; | ||
|  |     } // get multiple rows by row number.
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "getRows", | ||
|  |     value: function getRows(start, length) { | ||
|  |       if (length < 1) return undefined; | ||
|  |       var rows = []; | ||
|  | 
 | ||
|  |       for (var i = start; i < start + length; i++) { | ||
|  |         rows.push(this.getRow(i)); | ||
|  |       } | ||
|  | 
 | ||
|  |       return rows; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "addRow", | ||
|  |     value: function addRow(value) { | ||
|  |       var style = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'n'; | ||
|  |       var rowNo = this._nextRow; | ||
|  |       var row = this.getRow(rowNo); | ||
|  |       row.values = value; | ||
|  | 
 | ||
|  |       this._setStyleOption(rowNo, style[0] === 'i' ? style : 'n'); | ||
|  | 
 | ||
|  |       return row; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "addRows", | ||
|  |     value: function addRows(value) { | ||
|  |       var _this2 = this; | ||
|  | 
 | ||
|  |       var style = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'n'; | ||
|  |       var rows = []; | ||
|  |       value.forEach(function (row) { | ||
|  |         rows.push(_this2.addRow(row, style)); | ||
|  |       }); | ||
|  |       return rows; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "insertRow", | ||
|  |     value: function insertRow(pos, value) { | ||
|  |       var style = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'n'; | ||
|  |       this.spliceRows(pos, 0, value); | ||
|  | 
 | ||
|  |       this._setStyleOption(pos, style); | ||
|  | 
 | ||
|  |       return this.getRow(pos); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "insertRows", | ||
|  |     value: function insertRows(pos, values) { | ||
|  |       var style = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'n'; | ||
|  |       this.spliceRows.apply(this, [pos, 0].concat(_toConsumableArray(values))); | ||
|  | 
 | ||
|  |       if (style !== 'n') { | ||
|  |         // copy over the styles
 | ||
|  |         for (var i = 0; i < values.length; i++) { | ||
|  |           if (style[0] === 'o' && this.findRow(values.length + pos + i) !== undefined) { | ||
|  |             this._copyStyle(values.length + pos + i, pos + i, style[1] === '+'); | ||
|  |           } else if (style[0] === 'i' && this.findRow(pos - 1) !== undefined) { | ||
|  |             this._copyStyle(pos - 1, pos + i, style[1] === '+'); | ||
|  |           } | ||
|  |         } | ||
|  |       } | ||
|  | 
 | ||
|  |       return this.getRows(pos, values.length); | ||
|  |     } // set row at position to same style as of either pervious row (option 'i') or next row (option 'o')
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "_setStyleOption", | ||
|  |     value: function _setStyleOption(pos) { | ||
|  |       var style = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'n'; | ||
|  | 
 | ||
|  |       if (style[0] === 'o' && this.findRow(pos + 1) !== undefined) { | ||
|  |         this._copyStyle(pos + 1, pos, style[1] === '+'); | ||
|  |       } else if (style[0] === 'i' && this.findRow(pos - 1) !== undefined) { | ||
|  |         this._copyStyle(pos - 1, pos, style[1] === '+'); | ||
|  |       } | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "_copyStyle", | ||
|  |     value: function _copyStyle(src, dest) { | ||
|  |       var styleEmpty = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false; | ||
|  |       var rSrc = this.getRow(src); | ||
|  |       var rDst = this.getRow(dest); | ||
|  |       rDst.style = Object.freeze(_objectSpread({}, rSrc.style)); // eslint-disable-next-line no-loop-func
 | ||
|  | 
 | ||
|  |       rSrc.eachCell({ | ||
|  |         includeEmpty: styleEmpty | ||
|  |       }, function (cell, colNumber) { | ||
|  |         rDst.getCell(colNumber).style = Object.freeze(_objectSpread({}, cell.style)); | ||
|  |       }); | ||
|  |       rDst.height = rSrc.height; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "duplicateRow", | ||
|  |     value: function duplicateRow(rowNum, count) { | ||
|  |       var _this3 = this; | ||
|  | 
 | ||
|  |       var insert = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false; | ||
|  |       // create count duplicates of rowNum
 | ||
|  |       // either inserting new or overwriting existing rows
 | ||
|  |       var rSrc = this._rows[rowNum - 1]; | ||
|  |       var inserts = new Array(count).fill(rSrc.values); | ||
|  |       this.spliceRows.apply(this, [rowNum + 1, insert ? 0 : count].concat(_toConsumableArray(inserts))); // now copy styles...
 | ||
|  | 
 | ||
|  |       var _loop2 = function _loop2(i) { | ||
|  |         var rDst = _this3._rows[rowNum + i]; | ||
|  |         rDst.style = rSrc.style; | ||
|  |         rDst.height = rSrc.height; // eslint-disable-next-line no-loop-func
 | ||
|  | 
 | ||
|  |         rSrc.eachCell({ | ||
|  |           includeEmpty: true | ||
|  |         }, function (cell, colNumber) { | ||
|  |           rDst.getCell(colNumber).style = cell.style; | ||
|  |         }); | ||
|  |       }; | ||
|  | 
 | ||
|  |       for (var i = 0; i < count; i++) { | ||
|  |         _loop2(i); | ||
|  |       } | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "spliceRows", | ||
|  |     value: function spliceRows(start, count) { | ||
|  |       var _this4 = this; | ||
|  | 
 | ||
|  |       // same problem as row.splice, except worse.
 | ||
|  |       var nKeep = start + count; | ||
|  | 
 | ||
|  |       for (var _len2 = arguments.length, inserts = new Array(_len2 > 2 ? _len2 - 2 : 0), _key2 = 2; _key2 < _len2; _key2++) { | ||
|  |         inserts[_key2 - 2] = arguments[_key2]; | ||
|  |       } | ||
|  | 
 | ||
|  |       var nInserts = inserts.length; | ||
|  |       var nExpand = nInserts - count; | ||
|  |       var nEnd = this._rows.length; | ||
|  |       var i; | ||
|  |       var rSrc; | ||
|  | 
 | ||
|  |       if (nExpand < 0) { | ||
|  |         // remove rows
 | ||
|  |         for (i = nKeep; i <= nEnd; i++) { | ||
|  |           rSrc = this._rows[i - 1]; | ||
|  | 
 | ||
|  |           if (rSrc) { | ||
|  |             (function () { | ||
|  |               var rDst = _this4.getRow(i + nExpand); | ||
|  | 
 | ||
|  |               rDst.values = rSrc.values; | ||
|  |               rDst.style = rSrc.style; | ||
|  |               rDst.height = rSrc.height; // eslint-disable-next-line no-loop-func
 | ||
|  | 
 | ||
|  |               rSrc.eachCell({ | ||
|  |                 includeEmpty: true | ||
|  |               }, function (cell, colNumber) { | ||
|  |                 rDst.getCell(colNumber).style = cell.style; | ||
|  |               }); | ||
|  |               _this4._rows[i - 1] = undefined; | ||
|  |             })(); | ||
|  |           } else { | ||
|  |             this._rows[i + nExpand - 1] = undefined; | ||
|  |           } | ||
|  |         } | ||
|  |       } else if (nExpand > 0) { | ||
|  |         // insert new cells
 | ||
|  |         for (i = nEnd; i >= nKeep; i--) { | ||
|  |           rSrc = this._rows[i - 1]; | ||
|  | 
 | ||
|  |           if (rSrc) { | ||
|  |             (function () { | ||
|  |               var rDst = _this4.getRow(i + nExpand); | ||
|  | 
 | ||
|  |               rDst.values = rSrc.values; | ||
|  |               rDst.style = rSrc.style; | ||
|  |               rDst.height = rSrc.height; // eslint-disable-next-line no-loop-func
 | ||
|  | 
 | ||
|  |               rSrc.eachCell({ | ||
|  |                 includeEmpty: true | ||
|  |               }, function (cell, colNumber) { | ||
|  |                 rDst.getCell(colNumber).style = cell.style; // remerge cells accounting for insert offset
 | ||
|  | 
 | ||
|  |                 if (cell._value.constructor.name === 'MergeValue') { | ||
|  |                   var cellToBeMerged = _this4.getRow(cell._row._number + nInserts).getCell(colNumber); | ||
|  | 
 | ||
|  |                   var prevMaster = cell._value._master; | ||
|  | 
 | ||
|  |                   var newMaster = _this4.getRow(prevMaster._row._number + nInserts).getCell(prevMaster._column._number); | ||
|  | 
 | ||
|  |                   cellToBeMerged.merge(newMaster); | ||
|  |                 } | ||
|  |               }); | ||
|  |             })(); | ||
|  |           } else { | ||
|  |             this._rows[i + nExpand - 1] = undefined; | ||
|  |           } | ||
|  |         } | ||
|  |       } // now copy over the new values
 | ||
|  | 
 | ||
|  | 
 | ||
|  |       for (i = 0; i < nInserts; i++) { | ||
|  |         var rDst = this.getRow(start + i); | ||
|  |         rDst.style = {}; | ||
|  |         rDst.values = inserts[i]; | ||
|  |       } // account for defined names
 | ||
|  | 
 | ||
|  | 
 | ||
|  |       this.workbook.definedNames.spliceRows(this.name, start, count, nInserts); | ||
|  |     } // iterate over every row in the worksheet, including maybe empty rows
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "eachRow", | ||
|  |     value: function eachRow(options, iteratee) { | ||
|  |       if (!iteratee) { | ||
|  |         iteratee = options; | ||
|  |         options = undefined; | ||
|  |       } | ||
|  | 
 | ||
|  |       if (options && options.includeEmpty) { | ||
|  |         var n = this._rows.length; | ||
|  | 
 | ||
|  |         for (var i = 1; i <= n; i++) { | ||
|  |           iteratee(this.getRow(i), i); | ||
|  |         } | ||
|  |       } else { | ||
|  |         this._rows.forEach(function (row) { | ||
|  |           if (row && row.hasValues) { | ||
|  |             iteratee(row, row.number); | ||
|  |           } | ||
|  |         }); | ||
|  |       } | ||
|  |     } // return all rows as sparse array
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "getSheetValues", | ||
|  |     value: function getSheetValues() { | ||
|  |       var rows = []; | ||
|  | 
 | ||
|  |       this._rows.forEach(function (row) { | ||
|  |         if (row) { | ||
|  |           rows[row.number] = row.values; | ||
|  |         } | ||
|  |       }); | ||
|  | 
 | ||
|  |       return rows; | ||
|  |     } // =========================================================================
 | ||
|  |     // Cells
 | ||
|  |     // returns the cell at [r,c] or address given by r. If not found, return undefined
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "findCell", | ||
|  |     value: function findCell(r, c) { | ||
|  |       var address = colCache.getAddress(r, c); | ||
|  |       var row = this._rows[address.row - 1]; | ||
|  |       return row ? row.findCell(address.col) : undefined; | ||
|  |     } // return the cell at [r,c] or address given by r. If not found, create a new one.
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "getCell", | ||
|  |     value: function getCell(r, c) { | ||
|  |       var address = colCache.getAddress(r, c); | ||
|  |       var row = this.getRow(address.row); | ||
|  |       return row.getCellEx(address); | ||
|  |     } // =========================================================================
 | ||
|  |     // Merge
 | ||
|  |     // convert the range defined by ['tl:br'], [tl,br] or [t,l,b,r] into a single 'merged' cell
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "mergeCells", | ||
|  |     value: function mergeCells() { | ||
|  |       for (var _len3 = arguments.length, cells = new Array(_len3), _key3 = 0; _key3 < _len3; _key3++) { | ||
|  |         cells[_key3] = arguments[_key3]; | ||
|  |       } | ||
|  | 
 | ||
|  |       var dimensions = new Range(cells); | ||
|  | 
 | ||
|  |       this._mergeCellsInternal(dimensions); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "mergeCellsWithoutStyle", | ||
|  |     value: function mergeCellsWithoutStyle() { | ||
|  |       for (var _len4 = arguments.length, cells = new Array(_len4), _key4 = 0; _key4 < _len4; _key4++) { | ||
|  |         cells[_key4] = arguments[_key4]; | ||
|  |       } | ||
|  | 
 | ||
|  |       var dimensions = new Range(cells); | ||
|  | 
 | ||
|  |       this._mergeCellsInternal(dimensions, true); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "_mergeCellsInternal", | ||
|  |     value: function _mergeCellsInternal(dimensions, ignoreStyle) { | ||
|  |       // check cells aren't already merged
 | ||
|  |       _.each(this._merges, function (merge) { | ||
|  |         if (merge.intersects(dimensions)) { | ||
|  |           throw new Error('Cannot merge already merged cells'); | ||
|  |         } | ||
|  |       }); // apply merge
 | ||
|  | 
 | ||
|  | 
 | ||
|  |       var master = this.getCell(dimensions.top, dimensions.left); | ||
|  | 
 | ||
|  |       for (var i = dimensions.top; i <= dimensions.bottom; i++) { | ||
|  |         for (var j = dimensions.left; j <= dimensions.right; j++) { | ||
|  |           // merge all but the master cell
 | ||
|  |           if (i > dimensions.top || j > dimensions.left) { | ||
|  |             this.getCell(i, j).merge(master, ignoreStyle); | ||
|  |           } | ||
|  |         } | ||
|  |       } // index merge
 | ||
|  | 
 | ||
|  | 
 | ||
|  |       this._merges[master.address] = dimensions; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "_unMergeMaster", | ||
|  |     value: function _unMergeMaster(master) { | ||
|  |       // master is always top left of a rectangle
 | ||
|  |       var merge = this._merges[master.address]; | ||
|  | 
 | ||
|  |       if (merge) { | ||
|  |         for (var i = merge.top; i <= merge.bottom; i++) { | ||
|  |           for (var j = merge.left; j <= merge.right; j++) { | ||
|  |             this.getCell(i, j).unmerge(); | ||
|  |           } | ||
|  |         } | ||
|  | 
 | ||
|  |         delete this._merges[master.address]; | ||
|  |       } | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "unMergeCells", | ||
|  |     // scan the range defined by ['tl:br'], [tl,br] or [t,l,b,r] and if any cell is part of a merge,
 | ||
|  |     // un-merge the group. Note this function can affect multiple merges and merge-blocks are
 | ||
|  |     // atomic - either they're all merged or all un-merged.
 | ||
|  |     value: function unMergeCells() { | ||
|  |       for (var _len5 = arguments.length, cells = new Array(_len5), _key5 = 0; _key5 < _len5; _key5++) { | ||
|  |         cells[_key5] = arguments[_key5]; | ||
|  |       } | ||
|  | 
 | ||
|  |       var dimensions = new Range(cells); // find any cells in that range and unmerge them
 | ||
|  | 
 | ||
|  |       for (var i = dimensions.top; i <= dimensions.bottom; i++) { | ||
|  |         for (var j = dimensions.left; j <= dimensions.right; j++) { | ||
|  |           var cell = this.findCell(i, j); | ||
|  | 
 | ||
|  |           if (cell) { | ||
|  |             if (cell.type === Enums.ValueType.Merge) { | ||
|  |               // this cell merges to another master
 | ||
|  |               this._unMergeMaster(cell.master); | ||
|  |             } else if (this._merges[cell.address]) { | ||
|  |               // this cell is a master
 | ||
|  |               this._unMergeMaster(cell); | ||
|  |             } | ||
|  |           } | ||
|  |         } | ||
|  |       } | ||
|  |     } // ===========================================================================
 | ||
|  |     // Shared/Array Formula
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "fillFormula", | ||
|  |     value: function fillFormula(range, formula, results) { | ||
|  |       var shareType = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 'shared'; | ||
|  |       // Define formula for top-left cell and share to rest
 | ||
|  |       var decoded = colCache.decode(range); | ||
|  |       var top = decoded.top, | ||
|  |           left = decoded.left, | ||
|  |           bottom = decoded.bottom, | ||
|  |           right = decoded.right; | ||
|  |       var width = right - left + 1; | ||
|  |       var masterAddress = colCache.encodeAddress(top, left); | ||
|  |       var isShared = shareType === 'shared'; // work out result accessor
 | ||
|  | 
 | ||
|  |       var getResult; | ||
|  | 
 | ||
|  |       if (typeof results === 'function') { | ||
|  |         getResult = results; | ||
|  |       } else if (Array.isArray(results)) { | ||
|  |         if (Array.isArray(results[0])) { | ||
|  |           getResult = function getResult(row, col) { | ||
|  |             return results[row - top][col - left]; | ||
|  |           }; | ||
|  |         } else { | ||
|  |           // eslint-disable-next-line no-mixed-operators
 | ||
|  |           getResult = function getResult(row, col) { | ||
|  |             return results[(row - top) * width + (col - left)]; | ||
|  |           }; | ||
|  |         } | ||
|  |       } else { | ||
|  |         getResult = function getResult() { | ||
|  |           return undefined; | ||
|  |         }; | ||
|  |       } | ||
|  | 
 | ||
|  |       var first = true; | ||
|  | 
 | ||
|  |       for (var r = top; r <= bottom; r++) { | ||
|  |         for (var c = left; c <= right; c++) { | ||
|  |           if (first) { | ||
|  |             this.getCell(r, c).value = { | ||
|  |               shareType: shareType, | ||
|  |               formula: formula, | ||
|  |               ref: range, | ||
|  |               result: getResult(r, c) | ||
|  |             }; | ||
|  |             first = false; | ||
|  |           } else { | ||
|  |             this.getCell(r, c).value = isShared ? { | ||
|  |               sharedFormula: masterAddress, | ||
|  |               result: getResult(r, c) | ||
|  |             } : getResult(r, c); | ||
|  |           } | ||
|  |         } | ||
|  |       } | ||
|  |     } // =========================================================================
 | ||
|  |     // Images
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "addImage", | ||
|  |     value: function addImage(imageId, range) { | ||
|  |       var model = { | ||
|  |         type: 'image', | ||
|  |         imageId: imageId, | ||
|  |         range: range | ||
|  |       }; | ||
|  | 
 | ||
|  |       this._media.push(new Image(this, model)); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "getImages", | ||
|  |     value: function getImages() { | ||
|  |       return this._media.filter(function (m) { | ||
|  |         return m.type === 'image'; | ||
|  |       }); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "addBackgroundImage", | ||
|  |     value: function addBackgroundImage(imageId) { | ||
|  |       var model = { | ||
|  |         type: 'background', | ||
|  |         imageId: imageId | ||
|  |       }; | ||
|  | 
 | ||
|  |       this._media.push(new Image(this, model)); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "getBackgroundImageId", | ||
|  |     value: function getBackgroundImageId() { | ||
|  |       var image = this._media.find(function (m) { | ||
|  |         return m.type === 'background'; | ||
|  |       }); | ||
|  | 
 | ||
|  |       return image && image.imageId; | ||
|  |     } // =========================================================================
 | ||
|  |     // Worksheet Protection
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "protect", | ||
|  |     value: function protect(password, options) { | ||
|  |       var _this5 = this; | ||
|  | 
 | ||
|  |       // TODO: make this function truly async
 | ||
|  |       // perhaps marshal to worker thread or something
 | ||
|  |       return new Promise(function (resolve) { | ||
|  |         _this5.sheetProtection = { | ||
|  |           sheet: true | ||
|  |         }; | ||
|  | 
 | ||
|  |         if (options && 'spinCount' in options) { | ||
|  |           // force spinCount to be integer >= 0
 | ||
|  |           options.spinCount = Number.isFinite(options.spinCount) ? Math.round(Math.max(0, options.spinCount)) : 100000; | ||
|  |         } | ||
|  | 
 | ||
|  |         if (password) { | ||
|  |           _this5.sheetProtection.algorithmName = 'SHA-512'; | ||
|  |           _this5.sheetProtection.saltValue = Encryptor.randomBytes(16).toString('base64'); | ||
|  |           _this5.sheetProtection.spinCount = options && 'spinCount' in options ? options.spinCount : 100000; // allow user specified spinCount
 | ||
|  | 
 | ||
|  |           _this5.sheetProtection.hashValue = Encryptor.convertPasswordToHash(password, 'SHA512', _this5.sheetProtection.saltValue, _this5.sheetProtection.spinCount); | ||
|  |         } | ||
|  | 
 | ||
|  |         if (options) { | ||
|  |           _this5.sheetProtection = Object.assign(_this5.sheetProtection, options); | ||
|  | 
 | ||
|  |           if (!password && 'spinCount' in options) { | ||
|  |             delete _this5.sheetProtection.spinCount; | ||
|  |           } | ||
|  |         } | ||
|  | 
 | ||
|  |         resolve(); | ||
|  |       }); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "unprotect", | ||
|  |     value: function unprotect() { | ||
|  |       this.sheetProtection = null; | ||
|  |     } // =========================================================================
 | ||
|  |     // Tables
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "addTable", | ||
|  |     value: function addTable(model) { | ||
|  |       var table = new Table(this, model); | ||
|  |       this.tables[model.name] = table; | ||
|  |       return table; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "getTable", | ||
|  |     value: function getTable(name) { | ||
|  |       return this.tables[name]; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "removeTable", | ||
|  |     value: function removeTable(name) { | ||
|  |       delete this.tables[name]; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "getTables", | ||
|  |     value: function getTables() { | ||
|  |       return Object.values(this.tables); | ||
|  |     } // ===========================================================================
 | ||
|  |     // Conditional Formatting
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "addConditionalFormatting", | ||
|  |     value: function addConditionalFormatting(cf) { | ||
|  |       this.conditionalFormattings.push(cf); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "removeConditionalFormatting", | ||
|  |     value: function removeConditionalFormatting(filter) { | ||
|  |       if (typeof filter === 'number') { | ||
|  |         this.conditionalFormattings.splice(filter, 1); | ||
|  |       } else if (filter instanceof Function) { | ||
|  |         this.conditionalFormattings = this.conditionalFormattings.filter(filter); | ||
|  |       } else { | ||
|  |         this.conditionalFormattings = []; | ||
|  |       } | ||
|  |     } // ===========================================================================
 | ||
|  |     // Deprecated
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "_parseRows", | ||
|  |     value: function _parseRows(model) { | ||
|  |       var _this6 = this; | ||
|  | 
 | ||
|  |       this._rows = []; | ||
|  |       model.rows.forEach(function (rowModel) { | ||
|  |         var row = new Row(_this6, rowModel.number); | ||
|  |         _this6._rows[row.number - 1] = row; | ||
|  |         row.model = rowModel; | ||
|  |       }); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "_parseMergeCells", | ||
|  |     value: function _parseMergeCells(model) { | ||
|  |       var _this7 = this; | ||
|  | 
 | ||
|  |       _.each(model.mergeCells, function (merge) { | ||
|  |         // Do not merge styles when importing an Excel file
 | ||
|  |         // since each cell may have different styles intentionally.
 | ||
|  |         _this7.mergeCellsWithoutStyle(merge); | ||
|  |       }); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "workbook", | ||
|  |     get: function get() { | ||
|  |       return this._workbook; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "dimensions", | ||
|  |     get: function get() { | ||
|  |       var dimensions = new Range(); | ||
|  | 
 | ||
|  |       this._rows.forEach(function (row) { | ||
|  |         if (row) { | ||
|  |           var rowDims = row.dimensions; | ||
|  | 
 | ||
|  |           if (rowDims) { | ||
|  |             dimensions.expand(row.number, rowDims.min, row.number, rowDims.max); | ||
|  |           } | ||
|  |         } | ||
|  |       }); | ||
|  | 
 | ||
|  |       return dimensions; | ||
|  |     } // =========================================================================
 | ||
|  |     // Columns
 | ||
|  |     // get the current columns array.
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "columns", | ||
|  |     get: function get() { | ||
|  |       return this._columns; | ||
|  |     } // set the columns from an array of column definitions.
 | ||
|  |     // Note: any headers defined will overwrite existing values.
 | ||
|  |     , | ||
|  |     set: function set(value) { | ||
|  |       var _this8 = this; | ||
|  | 
 | ||
|  |       // calculate max header row count
 | ||
|  |       this._headerRowCount = value.reduce(function (pv, cv) { | ||
|  |         var headerCount = cv.header && 1 || cv.headers && cv.headers.length || 0; | ||
|  |         return Math.max(pv, headerCount); | ||
|  |       }, 0); // construct Column objects
 | ||
|  | 
 | ||
|  |       var count = 1; | ||
|  |       var columns = this._columns = []; | ||
|  |       value.forEach(function (defn) { | ||
|  |         var column = new Column(_this8, count++, false); | ||
|  |         columns.push(column); | ||
|  |         column.defn = defn; | ||
|  |       }); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "lastColumn", | ||
|  |     get: function get() { | ||
|  |       return this.getColumn(this.columnCount); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "columnCount", | ||
|  |     get: function get() { | ||
|  |       var maxCount = 0; | ||
|  |       this.eachRow(function (row) { | ||
|  |         maxCount = Math.max(maxCount, row.cellCount); | ||
|  |       }); | ||
|  |       return maxCount; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "actualColumnCount", | ||
|  |     get: function get() { | ||
|  |       // performance nightmare - for each row, counts all the columns used
 | ||
|  |       var counts = []; | ||
|  |       var count = 0; | ||
|  |       this.eachRow(function (row) { | ||
|  |         row.eachCell(function (_ref) { | ||
|  |           var col = _ref.col; | ||
|  | 
 | ||
|  |           if (!counts[col]) { | ||
|  |             counts[col] = true; | ||
|  |             count++; | ||
|  |           } | ||
|  |         }); | ||
|  |       }); | ||
|  |       return count; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "_lastRowNumber", | ||
|  |     get: function get() { | ||
|  |       // need to cope with results of splice
 | ||
|  |       var rows = this._rows; | ||
|  |       var n = rows.length; | ||
|  | 
 | ||
|  |       while (n > 0 && rows[n - 1] === undefined) { | ||
|  |         n--; | ||
|  |       } | ||
|  | 
 | ||
|  |       return n; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "_nextRow", | ||
|  |     get: function get() { | ||
|  |       return this._lastRowNumber + 1; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "lastRow", | ||
|  |     get: function get() { | ||
|  |       if (this._rows.length) { | ||
|  |         return this._rows[this._rows.length - 1]; | ||
|  |       } | ||
|  | 
 | ||
|  |       return undefined; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "rowCount", | ||
|  |     get: function get() { | ||
|  |       return this._lastRowNumber; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "actualRowCount", | ||
|  |     get: function get() { | ||
|  |       // counts actual rows that have actual data
 | ||
|  |       var count = 0; | ||
|  |       this.eachRow(function () { | ||
|  |         count++; | ||
|  |       }); | ||
|  |       return count; | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "hasMerges", | ||
|  |     get: function get() { | ||
|  |       // return true if this._merges has a merge object
 | ||
|  |       return _.some(this._merges, Boolean); | ||
|  |     } | ||
|  |   }, { | ||
|  |     key: "tabColor", | ||
|  |     get: function get() { | ||
|  |       // eslint-disable-next-line no-console
 | ||
|  |       console.trace('worksheet.tabColor property is now deprecated. Please use worksheet.properties.tabColor'); | ||
|  |       return this.properties.tabColor; | ||
|  |     }, | ||
|  |     set: function set(value) { | ||
|  |       // eslint-disable-next-line no-console
 | ||
|  |       console.trace('worksheet.tabColor property is now deprecated. Please use worksheet.properties.tabColor'); | ||
|  |       this.properties.tabColor = value; | ||
|  |     } // ===========================================================================
 | ||
|  |     // Model
 | ||
|  | 
 | ||
|  |   }, { | ||
|  |     key: "model", | ||
|  |     get: function get() { | ||
|  |       var model = { | ||
|  |         id: this.id, | ||
|  |         name: this.name, | ||
|  |         dataValidations: this.dataValidations.model, | ||
|  |         properties: this.properties, | ||
|  |         state: this.state, | ||
|  |         pageSetup: this.pageSetup, | ||
|  |         headerFooter: this.headerFooter, | ||
|  |         rowBreaks: this.rowBreaks, | ||
|  |         views: this.views, | ||
|  |         autoFilter: this.autoFilter, | ||
|  |         media: this._media.map(function (medium) { | ||
|  |           return medium.model; | ||
|  |         }), | ||
|  |         sheetProtection: this.sheetProtection, | ||
|  |         tables: Object.values(this.tables).map(function (table) { | ||
|  |           return table.model; | ||
|  |         }), | ||
|  |         conditionalFormattings: this.conditionalFormattings | ||
|  |       }; // =================================================
 | ||
|  |       // columns
 | ||
|  | 
 | ||
|  |       model.cols = Column.toModel(this.columns); // ==========================================================
 | ||
|  |       // Rows
 | ||
|  | 
 | ||
|  |       var rows = model.rows = []; | ||
|  |       var dimensions = model.dimensions = new Range(); | ||
|  | 
 | ||
|  |       this._rows.forEach(function (row) { | ||
|  |         var rowModel = row && row.model; | ||
|  | 
 | ||
|  |         if (rowModel) { | ||
|  |           dimensions.expand(rowModel.number, rowModel.min, rowModel.number, rowModel.max); | ||
|  |           rows.push(rowModel); | ||
|  |         } | ||
|  |       }); // ==========================================================
 | ||
|  |       // Merges
 | ||
|  | 
 | ||
|  | 
 | ||
|  |       model.merges = []; | ||
|  | 
 | ||
|  |       _.each(this._merges, function (merge) { | ||
|  |         model.merges.push(merge.range); | ||
|  |       }); | ||
|  | 
 | ||
|  |       return model; | ||
|  |     }, | ||
|  |     set: function set(value) { | ||
|  |       var _this9 = this; | ||
|  | 
 | ||
|  |       this.name = value.name; | ||
|  |       this._columns = Column.fromModel(this, value.cols); | ||
|  | 
 | ||
|  |       this._parseRows(value); | ||
|  | 
 | ||
|  |       this._parseMergeCells(value); | ||
|  | 
 | ||
|  |       this.dataValidations = new DataValidations(value.dataValidations); | ||
|  |       this.properties = value.properties; | ||
|  |       this.pageSetup = value.pageSetup; | ||
|  |       this.headerFooter = value.headerFooter; | ||
|  |       this.views = value.views; | ||
|  |       this.autoFilter = value.autoFilter; | ||
|  |       this._media = value.media.map(function (medium) { | ||
|  |         return new Image(_this9, medium); | ||
|  |       }); | ||
|  |       this.sheetProtection = value.sheetProtection; | ||
|  |       this.tables = value.tables.reduce(function (tables, table) { | ||
|  |         var t = new Table(); | ||
|  |         t.model = table; | ||
|  |         tables[table.name] = t; | ||
|  |         return tables; | ||
|  |       }, {}); | ||
|  |       this.conditionalFormattings = value.conditionalFormattings; | ||
|  |     } | ||
|  |   }]); | ||
|  | 
 | ||
|  |   return Worksheet; | ||
|  | }(); | ||
|  | 
 | ||
|  | module.exports = Worksheet; | ||
|  | //# sourceMappingURL=worksheet.js.map
 |