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.
		
		
		
		
		
			
		
			
				
					288 lines
				
				7.4 KiB
			
		
		
			
		
	
	
					288 lines
				
				7.4 KiB
			| 
								 
											3 years ago
										 
									 | 
							
								const addressRegex = /^[A-Z]+\d+$/;
							 | 
						||
| 
								 | 
							
								// =========================================================================
							 | 
						||
| 
								 | 
							
								// Column Letter to Number conversion
							 | 
						||
| 
								 | 
							
								const colCache = {
							 | 
						||
| 
								 | 
							
								  _dictionary: [
							 | 
						||
| 
								 | 
							
								    'A',
							 | 
						||
| 
								 | 
							
								    'B',
							 | 
						||
| 
								 | 
							
								    'C',
							 | 
						||
| 
								 | 
							
								    'D',
							 | 
						||
| 
								 | 
							
								    'E',
							 | 
						||
| 
								 | 
							
								    'F',
							 | 
						||
| 
								 | 
							
								    'G',
							 | 
						||
| 
								 | 
							
								    'H',
							 | 
						||
| 
								 | 
							
								    'I',
							 | 
						||
| 
								 | 
							
								    'J',
							 | 
						||
| 
								 | 
							
								    'K',
							 | 
						||
| 
								 | 
							
								    'L',
							 | 
						||
| 
								 | 
							
								    'M',
							 | 
						||
| 
								 | 
							
								    'N',
							 | 
						||
| 
								 | 
							
								    'O',
							 | 
						||
| 
								 | 
							
								    'P',
							 | 
						||
| 
								 | 
							
								    'Q',
							 | 
						||
| 
								 | 
							
								    'R',
							 | 
						||
| 
								 | 
							
								    'S',
							 | 
						||
| 
								 | 
							
								    'T',
							 | 
						||
| 
								 | 
							
								    'U',
							 | 
						||
| 
								 | 
							
								    'V',
							 | 
						||
| 
								 | 
							
								    'W',
							 | 
						||
| 
								 | 
							
								    'X',
							 | 
						||
| 
								 | 
							
								    'Y',
							 | 
						||
| 
								 | 
							
								    'Z',
							 | 
						||
| 
								 | 
							
								  ],
							 | 
						||
| 
								 | 
							
								  _l2nFill: 0,
							 | 
						||
| 
								 | 
							
								  _l2n: {},
							 | 
						||
| 
								 | 
							
								  _n2l: [],
							 | 
						||
| 
								 | 
							
								  _level(n) {
							 | 
						||
| 
								 | 
							
								    if (n <= 26) {
							 | 
						||
| 
								 | 
							
								      return 1;
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    if (n <= 26 * 26) {
							 | 
						||
| 
								 | 
							
								      return 2;
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    return 3;
							 | 
						||
| 
								 | 
							
								  },
							 | 
						||
| 
								 | 
							
								  _fill(level) {
							 | 
						||
| 
								 | 
							
								    let c;
							 | 
						||
| 
								 | 
							
								    let v;
							 | 
						||
| 
								 | 
							
								    let l1;
							 | 
						||
| 
								 | 
							
								    let l2;
							 | 
						||
| 
								 | 
							
								    let l3;
							 | 
						||
| 
								 | 
							
								    let n = 1;
							 | 
						||
| 
								 | 
							
								    if (level >= 4) {
							 | 
						||
| 
								 | 
							
								      throw new Error('Out of bounds. Excel supports columns from 1 to 16384');
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    if (this._l2nFill < 1 && level >= 1) {
							 | 
						||
| 
								 | 
							
								      while (n <= 26) {
							 | 
						||
| 
								 | 
							
								        c = this._dictionary[n - 1];
							 | 
						||
| 
								 | 
							
								        this._n2l[n] = c;
							 | 
						||
| 
								 | 
							
								        this._l2n[c] = n;
							 | 
						||
| 
								 | 
							
								        n++;
							 | 
						||
| 
								 | 
							
								      }
							 | 
						||
| 
								 | 
							
								      this._l2nFill = 1;
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    if (this._l2nFill < 2 && level >= 2) {
							 | 
						||
| 
								 | 
							
								      n = 27;
							 | 
						||
| 
								 | 
							
								      while (n <= 26 + (26 * 26)) {
							 | 
						||
| 
								 | 
							
								        v = n - (26 + 1);
							 | 
						||
| 
								 | 
							
								        l1 = v % 26;
							 | 
						||
| 
								 | 
							
								        l2 = Math.floor(v / 26);
							 | 
						||
| 
								 | 
							
								        c = this._dictionary[l2] + this._dictionary[l1];
							 | 
						||
| 
								 | 
							
								        this._n2l[n] = c;
							 | 
						||
| 
								 | 
							
								        this._l2n[c] = n;
							 | 
						||
| 
								 | 
							
								        n++;
							 | 
						||
| 
								 | 
							
								      }
							 | 
						||
| 
								 | 
							
								      this._l2nFill = 2;
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    if (this._l2nFill < 3 && level >= 3) {
							 | 
						||
| 
								 | 
							
								      n = 26 + (26 * 26) + 1;
							 | 
						||
| 
								 | 
							
								      while (n <= 16384) {
							 | 
						||
| 
								 | 
							
								        v = n - ((26 * 26) + 26 + 1);
							 | 
						||
| 
								 | 
							
								        l1 = v % 26;
							 | 
						||
| 
								 | 
							
								        l2 = Math.floor(v / 26) % 26;
							 | 
						||
| 
								 | 
							
								        l3 = Math.floor(v / (26 * 26));
							 | 
						||
| 
								 | 
							
								        c = this._dictionary[l3] + this._dictionary[l2] + this._dictionary[l1];
							 | 
						||
| 
								 | 
							
								        this._n2l[n] = c;
							 | 
						||
| 
								 | 
							
								        this._l2n[c] = n;
							 | 
						||
| 
								 | 
							
								        n++;
							 | 
						||
| 
								 | 
							
								      }
							 | 
						||
| 
								 | 
							
								      this._l2nFill = 3;
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								  },
							 | 
						||
| 
								 | 
							
								  l2n(l) {
							 | 
						||
| 
								 | 
							
								    if (!this._l2n[l]) {
							 | 
						||
| 
								 | 
							
								      this._fill(l.length);
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    if (!this._l2n[l]) {
							 | 
						||
| 
								 | 
							
								      throw new Error(`Out of bounds. Invalid column letter: ${l}`);
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    return this._l2n[l];
							 | 
						||
| 
								 | 
							
								  },
							 | 
						||
| 
								 | 
							
								  n2l(n) {
							 | 
						||
| 
								 | 
							
								    if (n < 1 || n > 16384) {
							 | 
						||
| 
								 | 
							
								      throw new Error(`${n} is out of bounds. Excel supports columns from 1 to 16384`);
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    if (!this._n2l[n]) {
							 | 
						||
| 
								 | 
							
								      this._fill(this._level(n));
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    return this._n2l[n];
							 | 
						||
| 
								 | 
							
								  },
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  // =========================================================================
							 | 
						||
| 
								 | 
							
								  // Address processing
							 | 
						||
| 
								 | 
							
								  _hash: {},
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  // check if value looks like an address
							 | 
						||
| 
								 | 
							
								  validateAddress(value) {
							 | 
						||
| 
								 | 
							
								    if (!addressRegex.test(value)) {
							 | 
						||
| 
								 | 
							
								      throw new Error(`Invalid Address: ${value}`);
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    return true;
							 | 
						||
| 
								 | 
							
								  },
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  // convert address string into structure
							 | 
						||
| 
								 | 
							
								  decodeAddress(value) {
							 | 
						||
| 
								 | 
							
								    const addr = value.length < 5 && this._hash[value];
							 | 
						||
| 
								 | 
							
								    if (addr) {
							 | 
						||
| 
								 | 
							
								      return addr;
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    let hasCol = false;
							 | 
						||
| 
								 | 
							
								    let col = '';
							 | 
						||
| 
								 | 
							
								    let colNumber = 0;
							 | 
						||
| 
								 | 
							
								    let hasRow = false;
							 | 
						||
| 
								 | 
							
								    let row = '';
							 | 
						||
| 
								 | 
							
								    let rowNumber = 0;
							 | 
						||
| 
								 | 
							
								    for (let i = 0, char; i < value.length; i++) {
							 | 
						||
| 
								 | 
							
								      char = value.charCodeAt(i);
							 | 
						||
| 
								 | 
							
								      // col should before row
							 | 
						||
| 
								 | 
							
								      if (!hasRow && char >= 65 && char <= 90) {
							 | 
						||
| 
								 | 
							
								        // 65 = 'A'.charCodeAt(0)
							 | 
						||
| 
								 | 
							
								        // 90 = 'Z'.charCodeAt(0)
							 | 
						||
| 
								 | 
							
								        hasCol = true;
							 | 
						||
| 
								 | 
							
								        col += value[i];
							 | 
						||
| 
								 | 
							
								        // colNumber starts from 1
							 | 
						||
| 
								 | 
							
								        colNumber = (colNumber * 26) + char - 64;
							 | 
						||
| 
								 | 
							
								      } else if (char >= 48 && char <= 57) {
							 | 
						||
| 
								 | 
							
								        // 48 = '0'.charCodeAt(0)
							 | 
						||
| 
								 | 
							
								        // 57 = '9'.charCodeAt(0)
							 | 
						||
| 
								 | 
							
								        hasRow = true;
							 | 
						||
| 
								 | 
							
								        row += value[i];
							 | 
						||
| 
								 | 
							
								        // rowNumber starts from 0
							 | 
						||
| 
								 | 
							
								        rowNumber = (rowNumber * 10) + char - 48;
							 | 
						||
| 
								 | 
							
								      } else if (hasRow && hasCol && char !== 36) {
							 | 
						||
| 
								 | 
							
								        // 36 = '$'.charCodeAt(0)
							 | 
						||
| 
								 | 
							
								        break;
							 | 
						||
| 
								 | 
							
								      }
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    if (!hasCol) {
							 | 
						||
| 
								 | 
							
								      colNumber = undefined;
							 | 
						||
| 
								 | 
							
								    } else if (colNumber > 16384) {
							 | 
						||
| 
								 | 
							
								      throw new Error(`Out of bounds. Invalid column letter: ${col}`);
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    if (!hasRow) {
							 | 
						||
| 
								 | 
							
								      rowNumber = undefined;
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    // in case $row$col
							 | 
						||
| 
								 | 
							
								    value = col + row;
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    const address = {
							 | 
						||
| 
								 | 
							
								      address: value,
							 | 
						||
| 
								 | 
							
								      col: colNumber,
							 | 
						||
| 
								 | 
							
								      row: rowNumber,
							 | 
						||
| 
								 | 
							
								      $col$row: `$${col}$${row}`,
							 | 
						||
| 
								 | 
							
								    };
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    // mem fix - cache only the tl 100x100 square
							 | 
						||
| 
								 | 
							
								    if (colNumber <= 100 && rowNumber <= 100) {
							 | 
						||
| 
								 | 
							
								      this._hash[value] = address;
							 | 
						||
| 
								 | 
							
								      this._hash[address.$col$row] = address;
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    return address;
							 | 
						||
| 
								 | 
							
								  },
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  // convert r,c into structure (if only 1 arg, assume r is address string)
							 | 
						||
| 
								 | 
							
								  getAddress(r, c) {
							 | 
						||
| 
								 | 
							
								    if (c) {
							 | 
						||
| 
								 | 
							
								      const address = this.n2l(c) + r;
							 | 
						||
| 
								 | 
							
								      return this.decodeAddress(address);
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    return this.decodeAddress(r);
							 | 
						||
| 
								 | 
							
								  },
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  // convert [address], [tl:br] into address structures
							 | 
						||
| 
								 | 
							
								  decode(value) {
							 | 
						||
| 
								 | 
							
								    const parts = value.split(':');
							 | 
						||
| 
								 | 
							
								    if (parts.length === 2) {
							 | 
						||
| 
								 | 
							
								      const tl = this.decodeAddress(parts[0]);
							 | 
						||
| 
								 | 
							
								      const br = this.decodeAddress(parts[1]);
							 | 
						||
| 
								 | 
							
								      const result = {
							 | 
						||
| 
								 | 
							
								        top: Math.min(tl.row, br.row),
							 | 
						||
| 
								 | 
							
								        left: Math.min(tl.col, br.col),
							 | 
						||
| 
								 | 
							
								        bottom: Math.max(tl.row, br.row),
							 | 
						||
| 
								 | 
							
								        right: Math.max(tl.col, br.col),
							 | 
						||
| 
								 | 
							
								      };
							 | 
						||
| 
								 | 
							
								      // reconstruct tl, br and dimensions
							 | 
						||
| 
								 | 
							
								      result.tl = this.n2l(result.left) + result.top;
							 | 
						||
| 
								 | 
							
								      result.br = this.n2l(result.right) + result.bottom;
							 | 
						||
| 
								 | 
							
								      result.dimensions = `${result.tl}:${result.br}`;
							 | 
						||
| 
								 | 
							
								      return result;
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    return this.decodeAddress(value);
							 | 
						||
| 
								 | 
							
								  },
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  // convert [sheetName!][$]col[$]row[[$]col[$]row] into address or range structures
							 | 
						||
| 
								 | 
							
								  decodeEx(value) {
							 | 
						||
| 
								 | 
							
								    const groups = value.match(/(?:(?:(?:'((?:[^']|'')*)')|([^'^ !]*))!)?(.*)/);
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    const sheetName = groups[1] || groups[2]; // Qouted and unqouted groups
							 | 
						||
| 
								 | 
							
								    const reference = groups[3]; // Remaining address
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    const parts = reference.split(':');
							 | 
						||
| 
								 | 
							
								    if (parts.length > 1) {
							 | 
						||
| 
								 | 
							
								      let tl = this.decodeAddress(parts[0]);
							 | 
						||
| 
								 | 
							
								      let br = this.decodeAddress(parts[1]);
							 | 
						||
| 
								 | 
							
								      const top = Math.min(tl.row, br.row);
							 | 
						||
| 
								 | 
							
								      const left = Math.min(tl.col, br.col);
							 | 
						||
| 
								 | 
							
								      const bottom = Math.max(tl.row, br.row);
							 | 
						||
| 
								 | 
							
								      const right = Math.max(tl.col, br.col);
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								      tl = this.n2l(left) + top;
							 | 
						||
| 
								 | 
							
								      br = this.n2l(right) + bottom;
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								      return {
							 | 
						||
| 
								 | 
							
								        top,
							 | 
						||
| 
								 | 
							
								        left,
							 | 
						||
| 
								 | 
							
								        bottom,
							 | 
						||
| 
								 | 
							
								        right,
							 | 
						||
| 
								 | 
							
								        sheetName,
							 | 
						||
| 
								 | 
							
								        tl: {address: tl, col: left, row: top, $col$row: `$${this.n2l(left)}$${top}`, sheetName},
							 | 
						||
| 
								 | 
							
								        br: {
							 | 
						||
| 
								 | 
							
								          address: br,
							 | 
						||
| 
								 | 
							
								          col: right,
							 | 
						||
| 
								 | 
							
								          row: bottom,
							 | 
						||
| 
								 | 
							
								          $col$row: `$${this.n2l(right)}$${bottom}`,
							 | 
						||
| 
								 | 
							
								          sheetName,
							 | 
						||
| 
								 | 
							
								        },
							 | 
						||
| 
								 | 
							
								        dimensions: `${tl}:${br}`,
							 | 
						||
| 
								 | 
							
								      };
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								    if (reference.startsWith('#')) {
							 | 
						||
| 
								 | 
							
								      return sheetName ? {sheetName, error: reference} : {error: reference};
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    const address = this.decodeAddress(reference);
							 | 
						||
| 
								 | 
							
								    return sheetName ? {sheetName, ...address} : address;
							 | 
						||
| 
								 | 
							
								  },
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  // convert row,col into address string
							 | 
						||
| 
								 | 
							
								  encodeAddress(row, col) {
							 | 
						||
| 
								 | 
							
								    return colCache.n2l(col) + row;
							 | 
						||
| 
								 | 
							
								  },
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  // convert row,col into string address or t,l,b,r into range
							 | 
						||
| 
								 | 
							
								  encode() {
							 | 
						||
| 
								 | 
							
								    switch (arguments.length) {
							 | 
						||
| 
								 | 
							
								      case 2:
							 | 
						||
| 
								 | 
							
								        return colCache.encodeAddress(arguments[0], arguments[1]);
							 | 
						||
| 
								 | 
							
								      case 4:
							 | 
						||
| 
								 | 
							
								        return `${colCache.encodeAddress(arguments[0], arguments[1])}:${colCache.encodeAddress(
							 | 
						||
| 
								 | 
							
								          arguments[2],
							 | 
						||
| 
								 | 
							
								          arguments[3]
							 | 
						||
| 
								 | 
							
								        )}`;
							 | 
						||
| 
								 | 
							
								      default:
							 | 
						||
| 
								 | 
							
								        throw new Error('Can only encode with 2 or 4 arguments');
							 | 
						||
| 
								 | 
							
								    }
							 | 
						||
| 
								 | 
							
								  },
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								  // return true if address is contained within range
							 | 
						||
| 
								 | 
							
								  inRange(range, address) {
							 | 
						||
| 
								 | 
							
								    const [left, top, , right, bottom] = range;
							 | 
						||
| 
								 | 
							
								    const [col, row] = address;
							 | 
						||
| 
								 | 
							
								    return col >= left && col <= right && row >= top && row <= bottom;
							 | 
						||
| 
								 | 
							
								  },
							 | 
						||
| 
								 | 
							
								};
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								module.exports = colCache;
							 |