@cosmotech/core 1.11.6 → 1.13.0

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+## **1.13.0** <sub><sup>2023-09-22 (9dd046f...45122b9)</sup></sub>
+
+### Features
+
+- add utils functions for dates and timezones ([f784395](https://github.com/Cosmo-Tech/webapp-component-core/commit/f784395))
+
+## **1.12.0** <sub><sup>2023-09-05 (e96188d...05e2b63)</sup></sub>
+
+### Features
+
+- add new function getFlattenColumnsWithoutGroups ([e96188d](https://github.com/Cosmo-Tech/webapp-component-core/commit/e96188d))
+
+### Bug Fixes
+
+- fix import & export of CSV/XLSX files when some columns are grouped ([193ac62](https://github.com/Cosmo-Tech/webapp-component-core/commit/193ac62))
+
 ## **1.11.6** <sub><sup>2023-08-28 (a1a83d2...a1a83d2)</sup></sub>
 
 ### Bug Fixes

package/dist/index.cjs.js

@@ -3985,7 +3985,7 @@ var pdre1 = /^(\d+):(\d+)(:\d+)?(\.\d+)?$/; // HH:MM[:SS[.UUU]]
 var pdre2 = /^(\d+)-(\d+)-(\d+)$/; // YYYY-mm-dd
 var pdre3 = /^(\d+)-(\d+)-(\d+)[T ](\d+):(\d+)(:\d+)?(\.\d+)?$/; // YYYY-mm-dd(T or space)HH:MM[:SS[.UUU]], sans "Z"
 /* parses a date string as a UTC date */
-function parseDate(str/*:string*/, date1904/*:boolean*/)/*:Date*/ {
+function parseDate$1(str/*:string*/, date1904/*:boolean*/)/*:Date*/ {
 	if(str instanceof Date) return str;
 	var m = str.match(pdre1);
 	if(m) return new Date((date1904 ? dnthresh2 : dnthresh1) + ((parseInt(m[1], 10)*60 + parseInt(m[2], 10))*60 + (m[3] ? parseInt(m[3].slice(1), 10) : 0))*1000 + (m[4] ? parseInt((m[4]+"000").slice(1,4), 10) : 0));
@@ -6203,7 +6203,7 @@ function parse_core_props(data) {
 	for(var i = 0; i < CORE_PROPS.length; ++i) {
 		var f = CORE_PROPS[i], cur = data.match(CORE_PROPS_REGEX[i]);
 		if(cur != null && cur.length > 0) p[f[1]] = unescapexml(cur[1]);
-		if(f[2] === 'date' && p[f[1]]) p[f[1]] = parseDate(p[f[1]]);
+		if(f[2] === 'date' && p[f[1]]) p[f[1]] = parseDate$1(p[f[1]]);
 	}
 
 	return p;
@@ -6389,7 +6389,7 @@ function parse_cust_props(data/*:string*/, opts) {
 						p[name] = parseFloat(text);
 						break;
 					case 'filetime': case 'date':
-						p[name] = parseDate(text);
+						p[name] = parseDate$1(text);
 						break;
 					case 'cy': case 'error':
 						p[name] = unescapexml(text);
@@ -6754,7 +6754,7 @@ function parse_PropertySet(blob, PIDSI) {
 					case 0x13 /*VT_UI4*/: blob.l += 4; val = blob.read_shift(4); break;
 					case 0x05 /*VT_R8*/: blob.l += 4; val = blob.read_shift(8, 'f'); break;
 					case 0x0B /*VT_BOOL*/: blob.l += 4; val = parsebool(blob, 4); break;
-					case 0x40 /*VT_FILETIME*/: blob.l += 4; val = parseDate(parse_FILETIME(blob)); break;
+					case 0x40 /*VT_FILETIME*/: blob.l += 4; val = parseDate$1(parse_FILETIME(blob)); break;
 					default: throw new Error("unparsed value: " + blob[blob.l]);
 				}
 				PropH[name] = val;
@@ -8930,7 +8930,7 @@ var SYLK = /*#__PURE__*/(function() {
 				if(cell.f && !cell.F) o += ";E" + a1_to_rc(cell.f, {r:R, c:C}); break;
 			case 'b': o += cell.v ? "TRUE" : "FALSE"; break;
 			case 'e': o += cell.w || cell.v; break;
-			case 'd': o += datenum(parseDate(cell.v, date1904), date1904); break;
+			case 'd': o += datenum(parseDate$1(cell.v, date1904), date1904); break;
 			case 's': o += '"' + (cell.v == null ? "" : String(cell.v)).replace(/"/g,"").replace(/;/g, ";;") + '"'; break;
 		}
 		return o;
@@ -9053,7 +9053,7 @@ var DIF = /*#__PURE__*/(function() {
 					else if(data === 'FALSE') arr[R][C] = false;
 					else if(!isNaN(fuzzynum(value))) arr[R][C] = fuzzynum(value);
 					else if(!isNaN(fuzzydate(value).getDate())) {
-						arr[R][C] = parseDate(value);
+						arr[R][C] = parseDate$1(value);
 						if(!(opts && opts.UTC)) { arr[R][C] = utc_to_local(arr[R][C]); }
 					}
 					else arr[R][C] = value;
@@ -9111,7 +9111,7 @@ var DIF = /*#__PURE__*/(function() {
 						p +=(make_value_str((isNaN(+cell.v)) ? cell.v : '="' + cell.v + '"'));
 						break;
 					case 'd':
-						if(!cell.w) cell.w = SSF_format(cell.z || table_fmt[14], datenum(parseDate(cell.v)));
+						if(!cell.w) cell.w = SSF_format(cell.z || table_fmt[14], datenum(parseDate$1(cell.v)));
 						p +=(make_value(cell.w, "V"));
 						break;
 					default: p +=("1,0\r\n\"\"");
@@ -9202,7 +9202,7 @@ var ETH = /*#__PURE__*/(function() {
 						oo[5] = encode(cell.f||(cell.v?'TRUE':'FALSE'));
 						break;
 					case 'd':
-						var t = datenum(parseDate(cell.v));
+						var t = datenum(parseDate$1(cell.v));
 						oo[2] = 'vtc'; oo[3] = 'nd'; oo[4] = ""+t;
 						oo[5] = cell.w || SSF_format(cell.z || table_fmt[14], t);
 						break;
@@ -9236,7 +9236,7 @@ var PRN = /*#__PURE__*/(function() {
 		else if(data === 'TRUE') arr[R][C] = true;
 		else if(data === 'FALSE') arr[R][C] = false;
 		else if(!isNaN(fuzzynum(data))) arr[R][C] = fuzzynum(data);
-		else if(!isNaN(fuzzydate(data).getDate())) arr[R][C] = parseDate(data);
+		else if(!isNaN(fuzzydate(data).getDate())) arr[R][C] = parseDate$1(data);
 		else arr[R][C] = data;
 	}
 
@@ -9347,7 +9347,7 @@ var PRN = /*#__PURE__*/(function() {
 			else if(!isNaN(v = fuzzynum(s))) { cell.t = 'n'; cell.v = v; }
 			else if(!isNaN((v = fuzzydate(s)).getDate()) || _re && s.match(_re)) {
 				cell.z = o.dateNF || table_fmt[14];
-				if(_re && s.match(_re)){ var news=dateNF_fix(s, o.dateNF, (s.match(_re)||[])); v = parseDate(news); if(o && o.UTC === false) v = utc_to_local(v); }
+				if(_re && s.match(_re)){ var news=dateNF_fix(s, o.dateNF, (s.match(_re)||[])); v = parseDate$1(news); if(o && o.UTC === false) v = utc_to_local(v); }
 				else if(o && o.UTC === false) v = utc_to_local(v);
 				else if(o.cellText !== false && o.dateNF) cell.w = SSF_format(cell.z, v);
 				if(o.cellDates) { cell.t = 'd'; cell.v = v; }
@@ -16044,7 +16044,7 @@ function safe_format(p/*:Cell*/, fmtid/*:number*/, fillid/*:?number*/, opts, the
 		if(opts.cellNF) p.z = table_fmt[fmtid];
 	} catch(e) { if(opts.WTF) throw e; }
 	if(p.t === 'z' && !opts.cellStyles) return;
-	if(p.t === 'd' && typeof p.v === 'string') p.v = parseDate(p.v);
+	if(p.t === 'd' && typeof p.v === 'string') p.v = parseDate$1(p.v);
 	if((!opts || opts.cellText !== false) && p.t !== 'z') try {
 		if(table_fmt[fmtid] == null) SSF__load(SSFImplicit[fmtid] || "General", fmtid);
 		if(p.t === 'e') p.w = p.w || BErr[p.v];
@@ -16361,13 +16361,13 @@ function write_ws_xml_cell(cell/*:Cell*/, ref, ws, opts, idx, wb, date1904)/*:st
 		case 'e': vv = BErr[cell.v]; break;
 		case 'd':
 			if(opts && opts.cellDates) {
-				var _vv = parseDate(cell.v, date1904);
+				var _vv = parseDate$1(cell.v, date1904);
 				vv = _vv.toISOString();
 				if(_vv.getUTCFullYear() < 1900) vv = vv.slice(vv.indexOf("T") + 1).replace("Z","");
 			} else {
 				cell = dup(cell);
 				cell.t = 'n';
-				vv = ''+(cell.v = datenum(parseDate(cell.v, date1904), date1904));
+				vv = ''+(cell.v = datenum(parseDate$1(cell.v, date1904), date1904));
 			}
 			if(typeof cell.z === 'undefined') cell.z = table_fmt[14];
 			break;
@@ -16566,8 +16566,8 @@ return function parse_ws_xml_data(sdata/*:string*/, s, opts, guess/*:Range*/, th
 					break;
 				case 'b': p.v = parsexmlbool(p.v); break;
 				case 'd':
-					if(opts.cellDates) p.v = parseDate(p.v, date1904);
-					else { p.v = datenum(parseDate(p.v, date1904), date1904); p.t = 'n'; }
+					if(opts.cellDates) p.v = parseDate$1(p.v, date1904);
+					else { p.v = datenum(parseDate$1(p.v, date1904), date1904); p.t = 'n'; }
 					break;
 				/* error string in .w, number in .v */
 				case 'e':
@@ -17589,7 +17589,7 @@ function write_ws_bin_cell(ba/*:BufArray*/, cell/*:Cell*/, R/*:number*/, C/*:num
 		case 'd': // no BrtCellDate :(
 			cell = dup(cell);
 			cell.z = cell.z || table_fmt[14];
-			cell.v = datenum(parseDate(cell.v, date1904), date1904); cell.t = 'n';
+			cell.v = datenum(parseDate$1(cell.v, date1904), date1904); cell.t = 'n';
 			break;
 		/* falls through */
 		case 'n': case 'e': vv = ''+cell.v; break;
@@ -18826,7 +18826,7 @@ function xlml_set_custprop(Custprops, key, cp, val/*:string*/) {
 		case "boolean": oval = parsexmlbool(val); break;
 		case "i2": case "int": oval = parseInt(val, 10); break;
 		case "r4": case "float": oval = parseFloat(val); break;
-		case "date": case "dateTime.tz": oval = parseDate(val); break;
+		case "date": case "dateTime.tz": oval = parseDate$1(val); break;
 		case "i8": case "string": case "fixed": case "uuid": case "bin.base64": break;
 		default: throw new Error("bad custprop:" + cp[0]);
 	}
@@ -18889,7 +18889,7 @@ function parse_xlml_data(xml, ss, data, cell/*:any*/, base, styles, csty, row, a
 			break;
 		case 'DateTime':
 			if(xml.slice(-1) != "Z") xml += "Z";
-			cell.v = datenum(parseDate(xml, date1904), date1904);
+			cell.v = datenum(parseDate$1(xml, date1904), date1904);
 			if(cell.v !== cell.v) cell.v = unescapexml(xml);
 			if(!nf || nf == "General") nf = "yyyy-mm-dd";
 			/* falls through */
@@ -22169,7 +22169,7 @@ function write_ws_biff2_cell(ba/*:BufArray*/, cell/*:Cell*/, R/*:number*/, C/*:n
 	}
 	if(cell.v != null) switch(cell.t) {
 		case 'd': case 'n':
-			var v = cell.t == 'd' ? datenum(parseDate(cell.v, date1904), date1904) : cell.v;
+			var v = cell.t == 'd' ? datenum(parseDate$1(cell.v, date1904), date1904) : cell.v;
 			if(opts.biff == 2 && (v == (v|0)) && (v >= 0) && (v < 65536))
 				// 0x027E (RK) in BIFF3/4
 				write_biff_rec(ba, 0x0002, write_BIFF2INT(R, C, v, ixfe, ifmt));
@@ -22579,7 +22579,7 @@ function write_ws_biff8_cell(ba/*:BufArray*/, cell/*:Cell*/, R/*:number*/, C/*:n
 	if(cell.bf) write_biff_rec(ba, 0x0006 /* Formula */, write_Formula(cell, R, C, opts, os));
 	else switch(cell.t) {
 		case 'd': case 'n':
-			var v = cell.t == 'd' ? datenum(parseDate(cell.v, date1904), date1904) : cell.v;
+			var v = cell.t == 'd' ? datenum(parseDate$1(cell.v, date1904), date1904) : cell.v;
 			if(isNaN(v)) write_biff_rec(ba, 0x0205 /* BoolErr */, write_BoolErr(R, C, 0x24, os, opts, "e")); // #NUM!
 			else if(!isFinite(v)) write_biff_rec(ba, 0x0205 /* BoolErr */, write_BoolErr(R, C, 0x07, os, opts, "e")); // #DIV/0!
 			/* TODO: emit RK as appropriate */
@@ -22853,7 +22853,7 @@ function html_to_sheet(str/*:string*/, _opts)/*:Workbook*/ {
 			else if(m === 'FALSE') o = {t:'b', v:false};
 			else if(!isNaN(fuzzynum(m))) o = {t:'n', v:fuzzynum(m)};
 			else if(!isNaN(fuzzydate(m).getDate())) {
-				o = ({t:'d', v:parseDate(m)}/*:any*/);
+				o = ({t:'d', v:parseDate$1(m)}/*:any*/);
 				if(opts.UTC === false) o.v = utc_to_local(o.v);
 				if(!opts.cellDates) o = ({t:'n', v:datenum(o.v)}/*:any*/);
 				o.z = opts.dateNF || table_fmt[14];
@@ -22998,7 +22998,7 @@ function sheet_add_dom(ws/*:Worksheet*/, table/*:HTMLElement*/, _opts/*:?any*/)/
 				else if(v === 'FALSE') o = {t:'b', v:false};
 				else if(!isNaN(fuzzynum(v))) o = {t:'n', v:fuzzynum(v)};
 				else if(!isNaN(fuzzydate(v).getDate())) {
-					o = ({t:'d', v:parseDate(v)}/*:any*/);
+					o = ({t:'d', v:parseDate$1(v)}/*:any*/);
 					if(opts.UTC) o.v = local_to_utc(o.v);
 					if(!opts.cellDates) o = ({t:'n', v:datenum(o.v)}/*:any*/);
 					o.z = opts.dateNF || table_fmt[14];
@@ -23428,7 +23428,7 @@ function parse_content_xml(d/*:string*/, _opts, _nfm)/*:Workbook*/ {
 							break;
 						case 'percentage': q.t = 'n'; q.v = parseFloat(ctag.value); break;
 						case 'currency': q.t = 'n'; q.v = parseFloat(ctag.value); break;
-						case 'date': q.t = 'd'; q.v = parseDate(ctag['date-value'], WB.WBProps.date1904);
+						case 'date': q.t = 'd'; q.v = parseDate$1(ctag['date-value'], WB.WBProps.date1904);
 							if(!opts.cellDates) { q.t = 'n'; q.v = datenum(q.v, WB.WBProps.date1904); }
 							if(!q.z) q.z = 'm/d/yy'; break;
 						/* NOTE: for `time`, Excel ODS export incorrectly uses durations relative to 1900 epoch even if 1904 is specified */
@@ -24114,9 +24114,9 @@ var write_content_ods/*:{(wb:any, opts:any):string}*/ = /* @__PURE__ */(function
 						ct['office:value-type'] = "string";
 						break;
 					case 'd':
-						textp = (cell.w||(parseDate(cell.v, date1904).toISOString()));
+						textp = (cell.w||(parseDate$1(cell.v, date1904).toISOString()));
 						ct['office:value-type'] = "date";
-						ct['office:date-value'] = (parseDate(cell.v, date1904).toISOString());
+						ct['office:date-value'] = (parseDate$1(cell.v, date1904).toISOString());
 						ct['table:style-name'] = "ce1";
 						break;
 					//case 'e': // TODO: translate to ODS errors
@@ -30680,7 +30680,7 @@ function normalizeTwoDigitYear(twoDigitYear, currentYear) {
   }
   return isCommonEra ? result : 1 - result;
 }
-function isLeapYearIndex(year) {
+function isLeapYearIndex$1(year) {
   return year % 400 === 0 || year % 4 === 0 && year % 100 !== 0;
 }
 
@@ -31319,7 +31319,7 @@ var DateParser = /*#__PURE__*/function (_Parser) {
     key: "validate",
     value: function validate(date, value) {
       var year = date.getUTCFullYear();
-      var isLeapYear = isLeapYearIndex(year);
+      var isLeapYear = isLeapYearIndex$1(year);
       var month = date.getUTCMonth();
       if (isLeapYear) {
         return value >= 1 && value <= DAYS_IN_MONTH_LEAP_YEAR[month];
@@ -31372,7 +31372,7 @@ var DayOfYearParser = /*#__PURE__*/function (_Parser) {
     key: "validate",
     value: function validate(date, value) {
       var year = date.getUTCFullYear();
-      var isLeapYear = isLeapYearIndex(year);
+      var isLeapYear = isLeapYearIndex$1(year);
       if (isLeapYear) {
         return value >= 1 && value <= 366;
       } else {
@@ -33274,9 +33274,256 @@ function isMatch(dateString, formatString, options) {
   return isValid$2(parse$1(dateString, formatString, new Date(), options));
 }
 
+/**
+ * @name parseISO
+ * @category Common Helpers
+ * @summary Parse ISO string
+ *
+ * @description
+ * Parse the given string in ISO 8601 format and return an instance of Date.
+ *
+ * Function accepts complete ISO 8601 formats as well as partial implementations.
+ * ISO 8601: http://en.wikipedia.org/wiki/ISO_8601
+ *
+ * If the argument isn't a string, the function cannot parse the string or
+ * the values are invalid, it returns Invalid Date.
+ *
+ * @param {String} argument - the value to convert
+ * @param {Object} [options] - an object with options.
+ * @param {0|1|2} [options.additionalDigits=2] - the additional number of digits in the extended year format
+ * @returns {Date} the parsed date in the local time zone
+ * @throws {TypeError} 1 argument required
+ * @throws {RangeError} `options.additionalDigits` must be 0, 1 or 2
+ *
+ * @example
+ * // Convert string '2014-02-11T11:30:30' to date:
+ * const result = parseISO('2014-02-11T11:30:30')
+ * //=> Tue Feb 11 2014 11:30:30
+ *
+ * @example
+ * // Convert string '+02014101' to date,
+ * // if the additional number of digits in the extended year format is 1:
+ * const result = parseISO('+02014101', { additionalDigits: 1 })
+ * //=> Fri Apr 11 2014 00:00:00
+ */
+function parseISO$1(argument, options) {
+  var _options$additionalDi;
+  requiredArgs(1, arguments);
+  var additionalDigits = toInteger((_options$additionalDi = options === null || options === void 0 ? void 0 : options.additionalDigits) !== null && _options$additionalDi !== void 0 ? _options$additionalDi : 2);
+  if (additionalDigits !== 2 && additionalDigits !== 1 && additionalDigits !== 0) {
+    throw new RangeError('additionalDigits must be 0, 1 or 2');
+  }
+  if (!(typeof argument === 'string' || Object.prototype.toString.call(argument) === '[object String]')) {
+    return new Date(NaN);
+  }
+  var dateStrings = splitDateString(argument);
+  var date;
+  if (dateStrings.date) {
+    var parseYearResult = parseYear(dateStrings.date, additionalDigits);
+    date = parseDate(parseYearResult.restDateString, parseYearResult.year);
+  }
+  if (!date || isNaN(date.getTime())) {
+    return new Date(NaN);
+  }
+  var timestamp = date.getTime();
+  var time = 0;
+  var offset;
+  if (dateStrings.time) {
+    time = parseTime(dateStrings.time);
+    if (isNaN(time)) {
+      return new Date(NaN);
+    }
+  }
+  if (dateStrings.timezone) {
+    offset = parseTimezone(dateStrings.timezone);
+    if (isNaN(offset)) {
+      return new Date(NaN);
+    }
+  } else {
+    var dirtyDate = new Date(timestamp + time);
+    // js parsed string assuming it's in UTC timezone
+    // but we need it to be parsed in our timezone
+    // so we use utc values to build date in our timezone.
+    // Year values from 0 to 99 map to the years 1900 to 1999
+    // so set year explicitly with setFullYear.
+    var result = new Date(0);
+    result.setFullYear(dirtyDate.getUTCFullYear(), dirtyDate.getUTCMonth(), dirtyDate.getUTCDate());
+    result.setHours(dirtyDate.getUTCHours(), dirtyDate.getUTCMinutes(), dirtyDate.getUTCSeconds(), dirtyDate.getUTCMilliseconds());
+    return result;
+  }
+  return new Date(timestamp + time + offset);
+}
+var patterns$1 = {
+  dateTimeDelimiter: /[T ]/,
+  timeZoneDelimiter: /[Z ]/i,
+  timezone: /([Z+-].*)$/
+};
+var dateRegex = /^-?(?:(\d{3})|(\d{2})(?:-?(\d{2}))?|W(\d{2})(?:-?(\d{1}))?|)$/;
+var timeRegex = /^(\d{2}(?:[.,]\d*)?)(?::?(\d{2}(?:[.,]\d*)?))?(?::?(\d{2}(?:[.,]\d*)?))?$/;
+var timezoneRegex = /^([+-])(\d{2})(?::?(\d{2}))?$/;
+function splitDateString(dateString) {
+  var dateStrings = {};
+  var array = dateString.split(patterns$1.dateTimeDelimiter);
+  var timeString;
+
+  // The regex match should only return at maximum two array elements.
+  // [date], [time], or [date, time].
+  if (array.length > 2) {
+    return dateStrings;
+  }
+  if (/:/.test(array[0])) {
+    timeString = array[0];
+  } else {
+    dateStrings.date = array[0];
+    timeString = array[1];
+    if (patterns$1.timeZoneDelimiter.test(dateStrings.date)) {
+      dateStrings.date = dateString.split(patterns$1.timeZoneDelimiter)[0];
+      timeString = dateString.substr(dateStrings.date.length, dateString.length);
+    }
+  }
+  if (timeString) {
+    var token = patterns$1.timezone.exec(timeString);
+    if (token) {
+      dateStrings.time = timeString.replace(token[1], '');
+      dateStrings.timezone = token[1];
+    } else {
+      dateStrings.time = timeString;
+    }
+  }
+  return dateStrings;
+}
+function parseYear(dateString, additionalDigits) {
+  var regex = new RegExp('^(?:(\\d{4}|[+-]\\d{' + (4 + additionalDigits) + '})|(\\d{2}|[+-]\\d{' + (2 + additionalDigits) + '})$)');
+  var captures = dateString.match(regex);
+  // Invalid ISO-formatted year
+  if (!captures) return {
+    year: NaN,
+    restDateString: ''
+  };
+  var year = captures[1] ? parseInt(captures[1]) : null;
+  var century = captures[2] ? parseInt(captures[2]) : null;
+
+  // either year or century is null, not both
+  return {
+    year: century === null ? year : century * 100,
+    restDateString: dateString.slice((captures[1] || captures[2]).length)
+  };
+}
+function parseDate(dateString, year) {
+  // Invalid ISO-formatted year
+  if (year === null) return new Date(NaN);
+  var captures = dateString.match(dateRegex);
+  // Invalid ISO-formatted string
+  if (!captures) return new Date(NaN);
+  var isWeekDate = !!captures[4];
+  var dayOfYear = parseDateUnit(captures[1]);
+  var month = parseDateUnit(captures[2]) - 1;
+  var day = parseDateUnit(captures[3]);
+  var week = parseDateUnit(captures[4]);
+  var dayOfWeek = parseDateUnit(captures[5]) - 1;
+  if (isWeekDate) {
+    if (!validateWeekDate(year, week, dayOfWeek)) {
+      return new Date(NaN);
+    }
+    return dayOfISOWeekYear(year, week, dayOfWeek);
+  } else {
+    var date = new Date(0);
+    if (!validateDate(year, month, day) || !validateDayOfYearDate(year, dayOfYear)) {
+      return new Date(NaN);
+    }
+    date.setUTCFullYear(year, month, Math.max(dayOfYear, day));
+    return date;
+  }
+}
+function parseDateUnit(value) {
+  return value ? parseInt(value) : 1;
+}
+function parseTime(timeString) {
+  var captures = timeString.match(timeRegex);
+  if (!captures) return NaN; // Invalid ISO-formatted time
+
+  var hours = parseTimeUnit(captures[1]);
+  var minutes = parseTimeUnit(captures[2]);
+  var seconds = parseTimeUnit(captures[3]);
+  if (!validateTime(hours, minutes, seconds)) {
+    return NaN;
+  }
+  return hours * millisecondsInHour + minutes * millisecondsInMinute + seconds * 1000;
+}
+function parseTimeUnit(value) {
+  return value && parseFloat(value.replace(',', '.')) || 0;
+}
+function parseTimezone(timezoneString) {
+  if (timezoneString === 'Z') return 0;
+  var captures = timezoneString.match(timezoneRegex);
+  if (!captures) return 0;
+  var sign = captures[1] === '+' ? -1 : 1;
+  var hours = parseInt(captures[2]);
+  var minutes = captures[3] && parseInt(captures[3]) || 0;
+  if (!validateTimezone(hours, minutes)) {
+    return NaN;
+  }
+  return sign * (hours * millisecondsInHour + minutes * millisecondsInMinute);
+}
+function dayOfISOWeekYear(isoWeekYear, week, day) {
+  var date = new Date(0);
+  date.setUTCFullYear(isoWeekYear, 0, 4);
+  var fourthOfJanuaryDay = date.getUTCDay() || 7;
+  var diff = (week - 1) * 7 + day + 1 - fourthOfJanuaryDay;
+  date.setUTCDate(date.getUTCDate() + diff);
+  return date;
+}
+
+// Validation functions
+
+// February is null to handle the leap year (using ||)
+var daysInMonths = [31, null, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+function isLeapYearIndex(year) {
+  return year % 400 === 0 || year % 4 === 0 && year % 100 !== 0;
+}
+function validateDate(year, month, date) {
+  return month >= 0 && month <= 11 && date >= 1 && date <= (daysInMonths[month] || (isLeapYearIndex(year) ? 29 : 28));
+}
+function validateDayOfYearDate(year, dayOfYear) {
+  return dayOfYear >= 1 && dayOfYear <= (isLeapYearIndex(year) ? 366 : 365);
+}
+function validateWeekDate(_year, week, day) {
+  return week >= 1 && week <= 53 && day >= 0 && day <= 6;
+}
+function validateTime(hours, minutes, seconds) {
+  if (hours === 24) {
+    return minutes === 0 && seconds === 0;
+  }
+  return seconds >= 0 && seconds < 60 && minutes >= 0 && minutes < 60 && hours >= 0 && hours < 25;
+}
+function validateTimezone(_hours, minutes) {
+  return minutes >= 0 && minutes <= 59;
+}
+
 // Copyright (c) Cosmo Tech.
 // Licensed under the MIT license.
 
+var decreaseDateByOffset = (date, offset) => {
+  if (date instanceof Date === false) throw new TypeError('"date" parameter must be a Date object');
+  return new Date(date - offset * 60 * 1000);
+};
+var increaseDateByOffset = (date, offset) => {
+  return decreaseDateByOffset(date, -offset);
+};
+var addLocalDateToUTCOffset = date => {
+  if (date instanceof Date === false) throw new TypeError('"date" parameter must be a Date object');
+  // Example: if local time is 15:00, UTC time is 13:00, timezoneOffset is -120, then we need to "increase" the local
+  // datetime by -120 to find UTC time
+  return increaseDateByOffset(date, date.getTimezoneOffset());
+};
+var addUTCToLocalDateOffset = date => {
+  if (date instanceof Date === false) throw new TypeError('"date" parameter must be a Date object');
+  return decreaseDateByOffset(date, date.getTimezoneOffset());
+};
+var getDateAtMidnightUTC = date => {
+  if (date instanceof Date === false) throw new TypeError('"date" parameter must be a Date object');
+  return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), 0, 0, 0));
+};
 var parse = (dateStr, dateFormat) => {
   try {
     return parse$1(dateStr, dateFormat, new Date());
@@ -33284,6 +33531,7 @@ var parse = (dateStr, dateFormat) => {
     console.error(error);
   }
 };
+var parseISO = dateStr => parseISO$1(dateStr);
 var format = function format(date) {
   var dateFormat = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "yyyy-MM-dd'T'HH:mm:ss.SSSX";
   if (date) {
@@ -33295,9 +33543,24 @@ var format = function format(date) {
   }
   return '';
 };
+var formatUTCDateAsLocal = function formatUTCDateAsLocal(date) {
+  var dateFormat = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "yyyy-MM-dd'T'HH:mm:ss.SSSX";
+  try {
+    var dateWithReverseOffset = addLocalDateToUTCOffset(date);
+    return format(dateWithReverseOffset, dateFormat);
+  } catch (error) {
+    console.error(error);
+  }
+  return '';
+};
+
+// TODO: (breaking change) rename to something like "isFormatValid" to prevent confusion with the check of invalid dates
 var isValid$1 = (dateStr, dateFormat) => {
   return isMatch(dateStr, dateFormat);
 };
+var isValidDate = date => {
+  return isValid$2(date);
+};
 var min = (dateA, dateB) => {
   if (dateA && dateB) {
     return dateA < dateB ? dateA : dateB;
@@ -33327,9 +33590,17 @@ var strMax = (dateStrA, dateStrB, dateFormat) => {
   }
 };
 var DateUtils = {
+  decreaseDateByOffset,
+  increaseDateByOffset,
+  addLocalDateToUTCOffset,
+  addUTCToLocalDateOffset,
+  getDateAtMidnightUTC,
   parse,
+  parseISO,
   format,
+  formatUTCDateAsLocal,
   isValid: isValid$1,
+  isValidDate,
   min,
   max,
   strMin,
@@ -41495,6 +41766,18 @@ let Error$1 = class Error {
   }
 };
 
+var getFlattenColumnsWithoutGroups = columns => {
+  if (columns == null) {
+    console.warn("Columns list shouldn't be null or undefined");
+    return [];
+  }
+  return columns.flatMap(columnOrGroup => {
+    if (columnOrGroup == null) {
+      console.warn('Null or undefined values found in columns list');
+    }
+    return columnOrGroup !== null && columnOrGroup !== void 0 && columnOrGroup.children ? getFlattenColumnsWithoutGroups(columnOrGroup.children) : columnOrGroup;
+  }).filter(column => column != null);
+};
 var _buildEmptyFieldError = (rowLineNumber, expectedCols, colIndex) => {
   var errorSummary = "Empty field";
   var errorLoc = "Line ".concat(rowLineNumber, ", Column ").concat(colIndex + 1, " (\"").concat(expectedCols[colIndex].field, "\")");
@@ -41637,9 +41920,9 @@ var _buildRows = (rows, hasHeader, cols) => {
 };
 var fromCSV = function fromCSV(dataStr) {
   var hasHeader = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
-  var cols = arguments.length > 2 ? arguments[2] : undefined;
+  var nestedCols = arguments.length > 2 ? arguments[2] : undefined;
   var options = arguments.length > 3 ? arguments[3] : undefined;
-  if (!hasHeader && !cols) {
+  if (!hasHeader && !nestedCols) {
     return {
       error: [new Error$1('cols must be defined if hasHeader=false', null, null)]
     };
@@ -41650,6 +41933,7 @@ var fromCSV = function fromCSV(dataStr) {
       rows: []
     };
   }
+  var cols = getFlattenColumnsWithoutGroups(nestedCols);
   var rows = [];
   var csvLines;
   var emptyCols = _calculateEmptyCols(cols);
@@ -41660,7 +41944,7 @@ var fromCSV = function fromCSV(dataStr) {
       error: [err]
     };
   }
-  if (!cols) {
+  if (!cols || cols.length === 0) {
     cols = _buildCols(csvLines[0]);
   }
   var errors = _validateFormat(csvLines, hasHeader, cols, options);
@@ -41689,12 +41973,13 @@ var _generateRows = function _generateRows(rows, cols) {
   var rowSep = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : '\n';
   return rows.map(row => _generateRow(row, cols, colSep)).join(rowSep);
 };
-var toCSV = (rows, cols, options) => {
-  if (cols == null || cols.length === 0) {
+var toCSV = (rows, nestedCols, options) => {
+  if (nestedCols == null || nestedCols.length === 0) {
     return {
       error: ["Cols must be defined"]
     };
   }
+  var cols = getFlattenColumnsWithoutGroups(nestedCols);
   if (!rows) {
     rows = [];
   }
@@ -41712,10 +41997,11 @@ var toCSV = (rows, cols, options) => {
 
 // TODO: some metadata of cols & options ('acceptsEmptyFields', columns types, dates format, ...) are not used right
 // now, but they could be used in a future version to improve the format of the exported Excel file
-var toXLSX = (rows, cols, options) => {
+var toXLSX = (rows, nestedCols, options) => {
   if (!rows) {
     rows = [];
   }
+  var cols = getFlattenColumnsWithoutGroups(nestedCols);
   options = _objectSpread2(_objectSpread2({}, DEFAULT_XLSX_EXPORT_OPTIONS), options);
   var header = options.writeHeader ? cols.map(col => col.field) : null;
   return XLSXUtils.write(rows, header);
@@ -41723,9 +42009,9 @@ var toXLSX = (rows, cols, options) => {
 var fromXLSX = /*#__PURE__*/function () {
   var _ref2 = _asyncToGenerator(function* (fileBlob) {
     var hasHeader = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
-    var cols = arguments.length > 2 ? arguments[2] : undefined;
+    var nestedCols = arguments.length > 2 ? arguments[2] : undefined;
     var options = arguments.length > 3 ? arguments[3] : undefined;
-    if (!hasHeader && !cols) {
+    if (!hasHeader && !nestedCols) {
       return {
         error: [new Error$1('cols must be defined if hasHeader=false', null, null)]
       };
@@ -41736,6 +42022,7 @@ var fromXLSX = /*#__PURE__*/function () {
         rows: []
       };
     }
+    var cols = getFlattenColumnsWithoutGroups(nestedCols);
     var rows = [];
     var xlsxLines;
     var emptyCols = _calculateEmptyCols(cols);
@@ -41747,7 +42034,7 @@ var fromXLSX = /*#__PURE__*/function () {
         error: [new Error$1((err === null || err === void 0 ? void 0 : err.message) || err, fileBlob.name, (err === null || err === void 0 ? void 0 : err.stack) || null)]
       };
     }
-    if (!cols) {
+    if (!cols || cols.length === 0) {
       cols = _buildCols(xlsxLines[0]);
     }
     var errors = _validateFormat(xlsxLines, hasHeader, cols, options);
@@ -41767,6 +42054,7 @@ var fromXLSX = /*#__PURE__*/function () {
 var AgGridUtils = {
   fromCSV,
   fromXLSX,
+  getFlattenColumnsWithoutGroups,
   toCSV,
   toXLSX
 };

package/dist/index.esm.js

@@ -3983,7 +3983,7 @@ var pdre1 = /^(\d+):(\d+)(:\d+)?(\.\d+)?$/; // HH:MM[:SS[.UUU]]
 var pdre2 = /^(\d+)-(\d+)-(\d+)$/; // YYYY-mm-dd
 var pdre3 = /^(\d+)-(\d+)-(\d+)[T ](\d+):(\d+)(:\d+)?(\.\d+)?$/; // YYYY-mm-dd(T or space)HH:MM[:SS[.UUU]], sans "Z"
 /* parses a date string as a UTC date */
-function parseDate(str/*:string*/, date1904/*:boolean*/)/*:Date*/ {
+function parseDate$1(str/*:string*/, date1904/*:boolean*/)/*:Date*/ {
 	if(str instanceof Date) return str;
 	var m = str.match(pdre1);
 	if(m) return new Date((date1904 ? dnthresh2 : dnthresh1) + ((parseInt(m[1], 10)*60 + parseInt(m[2], 10))*60 + (m[3] ? parseInt(m[3].slice(1), 10) : 0))*1000 + (m[4] ? parseInt((m[4]+"000").slice(1,4), 10) : 0));
@@ -6201,7 +6201,7 @@ function parse_core_props(data) {
 	for(var i = 0; i < CORE_PROPS.length; ++i) {
 		var f = CORE_PROPS[i], cur = data.match(CORE_PROPS_REGEX[i]);
 		if(cur != null && cur.length > 0) p[f[1]] = unescapexml(cur[1]);
-		if(f[2] === 'date' && p[f[1]]) p[f[1]] = parseDate(p[f[1]]);
+		if(f[2] === 'date' && p[f[1]]) p[f[1]] = parseDate$1(p[f[1]]);
 	}
 
 	return p;
@@ -6387,7 +6387,7 @@ function parse_cust_props(data/*:string*/, opts) {
 						p[name] = parseFloat(text);
 						break;
 					case 'filetime': case 'date':
-						p[name] = parseDate(text);
+						p[name] = parseDate$1(text);
 						break;
 					case 'cy': case 'error':
 						p[name] = unescapexml(text);
@@ -6752,7 +6752,7 @@ function parse_PropertySet(blob, PIDSI) {
 					case 0x13 /*VT_UI4*/: blob.l += 4; val = blob.read_shift(4); break;
 					case 0x05 /*VT_R8*/: blob.l += 4; val = blob.read_shift(8, 'f'); break;
 					case 0x0B /*VT_BOOL*/: blob.l += 4; val = parsebool(blob, 4); break;
-					case 0x40 /*VT_FILETIME*/: blob.l += 4; val = parseDate(parse_FILETIME(blob)); break;
+					case 0x40 /*VT_FILETIME*/: blob.l += 4; val = parseDate$1(parse_FILETIME(blob)); break;
 					default: throw new Error("unparsed value: " + blob[blob.l]);
 				}
 				PropH[name] = val;
@@ -8928,7 +8928,7 @@ var SYLK = /*#__PURE__*/(function() {
 				if(cell.f && !cell.F) o += ";E" + a1_to_rc(cell.f, {r:R, c:C}); break;
 			case 'b': o += cell.v ? "TRUE" : "FALSE"; break;
 			case 'e': o += cell.w || cell.v; break;
-			case 'd': o += datenum(parseDate(cell.v, date1904), date1904); break;
+			case 'd': o += datenum(parseDate$1(cell.v, date1904), date1904); break;
 			case 's': o += '"' + (cell.v == null ? "" : String(cell.v)).replace(/"/g,"").replace(/;/g, ";;") + '"'; break;
 		}
 		return o;
@@ -9051,7 +9051,7 @@ var DIF = /*#__PURE__*/(function() {
 					else if(data === 'FALSE') arr[R][C] = false;
 					else if(!isNaN(fuzzynum(value))) arr[R][C] = fuzzynum(value);
 					else if(!isNaN(fuzzydate(value).getDate())) {
-						arr[R][C] = parseDate(value);
+						arr[R][C] = parseDate$1(value);
 						if(!(opts && opts.UTC)) { arr[R][C] = utc_to_local(arr[R][C]); }
 					}
 					else arr[R][C] = value;
@@ -9109,7 +9109,7 @@ var DIF = /*#__PURE__*/(function() {
 						p +=(make_value_str((isNaN(+cell.v)) ? cell.v : '="' + cell.v + '"'));
 						break;
 					case 'd':
-						if(!cell.w) cell.w = SSF_format(cell.z || table_fmt[14], datenum(parseDate(cell.v)));
+						if(!cell.w) cell.w = SSF_format(cell.z || table_fmt[14], datenum(parseDate$1(cell.v)));
 						p +=(make_value(cell.w, "V"));
 						break;
 					default: p +=("1,0\r\n\"\"");
@@ -9200,7 +9200,7 @@ var ETH = /*#__PURE__*/(function() {
 						oo[5] = encode(cell.f||(cell.v?'TRUE':'FALSE'));
 						break;
 					case 'd':
-						var t = datenum(parseDate(cell.v));
+						var t = datenum(parseDate$1(cell.v));
 						oo[2] = 'vtc'; oo[3] = 'nd'; oo[4] = ""+t;
 						oo[5] = cell.w || SSF_format(cell.z || table_fmt[14], t);
 						break;
@@ -9234,7 +9234,7 @@ var PRN = /*#__PURE__*/(function() {
 		else if(data === 'TRUE') arr[R][C] = true;
 		else if(data === 'FALSE') arr[R][C] = false;
 		else if(!isNaN(fuzzynum(data))) arr[R][C] = fuzzynum(data);
-		else if(!isNaN(fuzzydate(data).getDate())) arr[R][C] = parseDate(data);
+		else if(!isNaN(fuzzydate(data).getDate())) arr[R][C] = parseDate$1(data);
 		else arr[R][C] = data;
 	}
 
@@ -9345,7 +9345,7 @@ var PRN = /*#__PURE__*/(function() {
 			else if(!isNaN(v = fuzzynum(s))) { cell.t = 'n'; cell.v = v; }
 			else if(!isNaN((v = fuzzydate(s)).getDate()) || _re && s.match(_re)) {
 				cell.z = o.dateNF || table_fmt[14];
-				if(_re && s.match(_re)){ var news=dateNF_fix(s, o.dateNF, (s.match(_re)||[])); v = parseDate(news); if(o && o.UTC === false) v = utc_to_local(v); }
+				if(_re && s.match(_re)){ var news=dateNF_fix(s, o.dateNF, (s.match(_re)||[])); v = parseDate$1(news); if(o && o.UTC === false) v = utc_to_local(v); }
 				else if(o && o.UTC === false) v = utc_to_local(v);
 				else if(o.cellText !== false && o.dateNF) cell.w = SSF_format(cell.z, v);
 				if(o.cellDates) { cell.t = 'd'; cell.v = v; }
@@ -16042,7 +16042,7 @@ function safe_format(p/*:Cell*/, fmtid/*:number*/, fillid/*:?number*/, opts, the
 		if(opts.cellNF) p.z = table_fmt[fmtid];
 	} catch(e) { if(opts.WTF) throw e; }
 	if(p.t === 'z' && !opts.cellStyles) return;
-	if(p.t === 'd' && typeof p.v === 'string') p.v = parseDate(p.v);
+	if(p.t === 'd' && typeof p.v === 'string') p.v = parseDate$1(p.v);
 	if((!opts || opts.cellText !== false) && p.t !== 'z') try {
 		if(table_fmt[fmtid] == null) SSF__load(SSFImplicit[fmtid] || "General", fmtid);
 		if(p.t === 'e') p.w = p.w || BErr[p.v];
@@ -16359,13 +16359,13 @@ function write_ws_xml_cell(cell/*:Cell*/, ref, ws, opts, idx, wb, date1904)/*:st
 		case 'e': vv = BErr[cell.v]; break;
 		case 'd':
 			if(opts && opts.cellDates) {
-				var _vv = parseDate(cell.v, date1904);
+				var _vv = parseDate$1(cell.v, date1904);
 				vv = _vv.toISOString();
 				if(_vv.getUTCFullYear() < 1900) vv = vv.slice(vv.indexOf("T") + 1).replace("Z","");
 			} else {
 				cell = dup(cell);
 				cell.t = 'n';
-				vv = ''+(cell.v = datenum(parseDate(cell.v, date1904), date1904));
+				vv = ''+(cell.v = datenum(parseDate$1(cell.v, date1904), date1904));
 			}
 			if(typeof cell.z === 'undefined') cell.z = table_fmt[14];
 			break;
@@ -16564,8 +16564,8 @@ return function parse_ws_xml_data(sdata/*:string*/, s, opts, guess/*:Range*/, th
 					break;
 				case 'b': p.v = parsexmlbool(p.v); break;
 				case 'd':
-					if(opts.cellDates) p.v = parseDate(p.v, date1904);
-					else { p.v = datenum(parseDate(p.v, date1904), date1904); p.t = 'n'; }
+					if(opts.cellDates) p.v = parseDate$1(p.v, date1904);
+					else { p.v = datenum(parseDate$1(p.v, date1904), date1904); p.t = 'n'; }
 					break;
 				/* error string in .w, number in .v */
 				case 'e':
@@ -17587,7 +17587,7 @@ function write_ws_bin_cell(ba/*:BufArray*/, cell/*:Cell*/, R/*:number*/, C/*:num
 		case 'd': // no BrtCellDate :(
 			cell = dup(cell);
 			cell.z = cell.z || table_fmt[14];
-			cell.v = datenum(parseDate(cell.v, date1904), date1904); cell.t = 'n';
+			cell.v = datenum(parseDate$1(cell.v, date1904), date1904); cell.t = 'n';
 			break;
 		/* falls through */
 		case 'n': case 'e': vv = ''+cell.v; break;
@@ -18824,7 +18824,7 @@ function xlml_set_custprop(Custprops, key, cp, val/*:string*/) {
 		case "boolean": oval = parsexmlbool(val); break;
 		case "i2": case "int": oval = parseInt(val, 10); break;
 		case "r4": case "float": oval = parseFloat(val); break;
-		case "date": case "dateTime.tz": oval = parseDate(val); break;
+		case "date": case "dateTime.tz": oval = parseDate$1(val); break;
 		case "i8": case "string": case "fixed": case "uuid": case "bin.base64": break;
 		default: throw new Error("bad custprop:" + cp[0]);
 	}
@@ -18887,7 +18887,7 @@ function parse_xlml_data(xml, ss, data, cell/*:any*/, base, styles, csty, row, a
 			break;
 		case 'DateTime':
 			if(xml.slice(-1) != "Z") xml += "Z";
-			cell.v = datenum(parseDate(xml, date1904), date1904);
+			cell.v = datenum(parseDate$1(xml, date1904), date1904);
 			if(cell.v !== cell.v) cell.v = unescapexml(xml);
 			if(!nf || nf == "General") nf = "yyyy-mm-dd";
 			/* falls through */
@@ -22167,7 +22167,7 @@ function write_ws_biff2_cell(ba/*:BufArray*/, cell/*:Cell*/, R/*:number*/, C/*:n
 	}
 	if(cell.v != null) switch(cell.t) {
 		case 'd': case 'n':
-			var v = cell.t == 'd' ? datenum(parseDate(cell.v, date1904), date1904) : cell.v;
+			var v = cell.t == 'd' ? datenum(parseDate$1(cell.v, date1904), date1904) : cell.v;
 			if(opts.biff == 2 && (v == (v|0)) && (v >= 0) && (v < 65536))
 				// 0x027E (RK) in BIFF3/4
 				write_biff_rec(ba, 0x0002, write_BIFF2INT(R, C, v, ixfe, ifmt));
@@ -22577,7 +22577,7 @@ function write_ws_biff8_cell(ba/*:BufArray*/, cell/*:Cell*/, R/*:number*/, C/*:n
 	if(cell.bf) write_biff_rec(ba, 0x0006 /* Formula */, write_Formula(cell, R, C, opts, os));
 	else switch(cell.t) {
 		case 'd': case 'n':
-			var v = cell.t == 'd' ? datenum(parseDate(cell.v, date1904), date1904) : cell.v;
+			var v = cell.t == 'd' ? datenum(parseDate$1(cell.v, date1904), date1904) : cell.v;
 			if(isNaN(v)) write_biff_rec(ba, 0x0205 /* BoolErr */, write_BoolErr(R, C, 0x24, os, opts, "e")); // #NUM!
 			else if(!isFinite(v)) write_biff_rec(ba, 0x0205 /* BoolErr */, write_BoolErr(R, C, 0x07, os, opts, "e")); // #DIV/0!
 			/* TODO: emit RK as appropriate */
@@ -22851,7 +22851,7 @@ function html_to_sheet(str/*:string*/, _opts)/*:Workbook*/ {
 			else if(m === 'FALSE') o = {t:'b', v:false};
 			else if(!isNaN(fuzzynum(m))) o = {t:'n', v:fuzzynum(m)};
 			else if(!isNaN(fuzzydate(m).getDate())) {
-				o = ({t:'d', v:parseDate(m)}/*:any*/);
+				o = ({t:'d', v:parseDate$1(m)}/*:any*/);
 				if(opts.UTC === false) o.v = utc_to_local(o.v);
 				if(!opts.cellDates) o = ({t:'n', v:datenum(o.v)}/*:any*/);
 				o.z = opts.dateNF || table_fmt[14];
@@ -22996,7 +22996,7 @@ function sheet_add_dom(ws/*:Worksheet*/, table/*:HTMLElement*/, _opts/*:?any*/)/
 				else if(v === 'FALSE') o = {t:'b', v:false};
 				else if(!isNaN(fuzzynum(v))) o = {t:'n', v:fuzzynum(v)};
 				else if(!isNaN(fuzzydate(v).getDate())) {
-					o = ({t:'d', v:parseDate(v)}/*:any*/);
+					o = ({t:'d', v:parseDate$1(v)}/*:any*/);
 					if(opts.UTC) o.v = local_to_utc(o.v);
 					if(!opts.cellDates) o = ({t:'n', v:datenum(o.v)}/*:any*/);
 					o.z = opts.dateNF || table_fmt[14];
@@ -23426,7 +23426,7 @@ function parse_content_xml(d/*:string*/, _opts, _nfm)/*:Workbook*/ {
 							break;
 						case 'percentage': q.t = 'n'; q.v = parseFloat(ctag.value); break;
 						case 'currency': q.t = 'n'; q.v = parseFloat(ctag.value); break;
-						case 'date': q.t = 'd'; q.v = parseDate(ctag['date-value'], WB.WBProps.date1904);
+						case 'date': q.t = 'd'; q.v = parseDate$1(ctag['date-value'], WB.WBProps.date1904);
 							if(!opts.cellDates) { q.t = 'n'; q.v = datenum(q.v, WB.WBProps.date1904); }
 							if(!q.z) q.z = 'm/d/yy'; break;
 						/* NOTE: for `time`, Excel ODS export incorrectly uses durations relative to 1900 epoch even if 1904 is specified */
@@ -24112,9 +24112,9 @@ var write_content_ods/*:{(wb:any, opts:any):string}*/ = /* @__PURE__ */(function
 						ct['office:value-type'] = "string";
 						break;
 					case 'd':
-						textp = (cell.w||(parseDate(cell.v, date1904).toISOString()));
+						textp = (cell.w||(parseDate$1(cell.v, date1904).toISOString()));
 						ct['office:value-type'] = "date";
-						ct['office:date-value'] = (parseDate(cell.v, date1904).toISOString());
+						ct['office:date-value'] = (parseDate$1(cell.v, date1904).toISOString());
 						ct['table:style-name'] = "ce1";
 						break;
 					//case 'e': // TODO: translate to ODS errors
@@ -30678,7 +30678,7 @@ function normalizeTwoDigitYear(twoDigitYear, currentYear) {
   }
   return isCommonEra ? result : 1 - result;
 }
-function isLeapYearIndex(year) {
+function isLeapYearIndex$1(year) {
   return year % 400 === 0 || year % 4 === 0 && year % 100 !== 0;
 }
 
@@ -31317,7 +31317,7 @@ var DateParser = /*#__PURE__*/function (_Parser) {
     key: "validate",
     value: function validate(date, value) {
       var year = date.getUTCFullYear();
-      var isLeapYear = isLeapYearIndex(year);
+      var isLeapYear = isLeapYearIndex$1(year);
       var month = date.getUTCMonth();
       if (isLeapYear) {
         return value >= 1 && value <= DAYS_IN_MONTH_LEAP_YEAR[month];
@@ -31370,7 +31370,7 @@ var DayOfYearParser = /*#__PURE__*/function (_Parser) {
     key: "validate",
     value: function validate(date, value) {
       var year = date.getUTCFullYear();
-      var isLeapYear = isLeapYearIndex(year);
+      var isLeapYear = isLeapYearIndex$1(year);
       if (isLeapYear) {
         return value >= 1 && value <= 366;
       } else {
@@ -33272,9 +33272,256 @@ function isMatch(dateString, formatString, options) {
   return isValid$2(parse$1(dateString, formatString, new Date(), options));
 }
 
+/**
+ * @name parseISO
+ * @category Common Helpers
+ * @summary Parse ISO string
+ *
+ * @description
+ * Parse the given string in ISO 8601 format and return an instance of Date.
+ *
+ * Function accepts complete ISO 8601 formats as well as partial implementations.
+ * ISO 8601: http://en.wikipedia.org/wiki/ISO_8601
+ *
+ * If the argument isn't a string, the function cannot parse the string or
+ * the values are invalid, it returns Invalid Date.
+ *
+ * @param {String} argument - the value to convert
+ * @param {Object} [options] - an object with options.
+ * @param {0|1|2} [options.additionalDigits=2] - the additional number of digits in the extended year format
+ * @returns {Date} the parsed date in the local time zone
+ * @throws {TypeError} 1 argument required
+ * @throws {RangeError} `options.additionalDigits` must be 0, 1 or 2
+ *
+ * @example
+ * // Convert string '2014-02-11T11:30:30' to date:
+ * const result = parseISO('2014-02-11T11:30:30')
+ * //=> Tue Feb 11 2014 11:30:30
+ *
+ * @example
+ * // Convert string '+02014101' to date,
+ * // if the additional number of digits in the extended year format is 1:
+ * const result = parseISO('+02014101', { additionalDigits: 1 })
+ * //=> Fri Apr 11 2014 00:00:00
+ */
+function parseISO$1(argument, options) {
+  var _options$additionalDi;
+  requiredArgs(1, arguments);
+  var additionalDigits = toInteger((_options$additionalDi = options === null || options === void 0 ? void 0 : options.additionalDigits) !== null && _options$additionalDi !== void 0 ? _options$additionalDi : 2);
+  if (additionalDigits !== 2 && additionalDigits !== 1 && additionalDigits !== 0) {
+    throw new RangeError('additionalDigits must be 0, 1 or 2');
+  }
+  if (!(typeof argument === 'string' || Object.prototype.toString.call(argument) === '[object String]')) {
+    return new Date(NaN);
+  }
+  var dateStrings = splitDateString(argument);
+  var date;
+  if (dateStrings.date) {
+    var parseYearResult = parseYear(dateStrings.date, additionalDigits);
+    date = parseDate(parseYearResult.restDateString, parseYearResult.year);
+  }
+  if (!date || isNaN(date.getTime())) {
+    return new Date(NaN);
+  }
+  var timestamp = date.getTime();
+  var time = 0;
+  var offset;
+  if (dateStrings.time) {
+    time = parseTime(dateStrings.time);
+    if (isNaN(time)) {
+      return new Date(NaN);
+    }
+  }
+  if (dateStrings.timezone) {
+    offset = parseTimezone(dateStrings.timezone);
+    if (isNaN(offset)) {
+      return new Date(NaN);
+    }
+  } else {
+    var dirtyDate = new Date(timestamp + time);
+    // js parsed string assuming it's in UTC timezone
+    // but we need it to be parsed in our timezone
+    // so we use utc values to build date in our timezone.
+    // Year values from 0 to 99 map to the years 1900 to 1999
+    // so set year explicitly with setFullYear.
+    var result = new Date(0);
+    result.setFullYear(dirtyDate.getUTCFullYear(), dirtyDate.getUTCMonth(), dirtyDate.getUTCDate());
+    result.setHours(dirtyDate.getUTCHours(), dirtyDate.getUTCMinutes(), dirtyDate.getUTCSeconds(), dirtyDate.getUTCMilliseconds());
+    return result;
+  }
+  return new Date(timestamp + time + offset);
+}
+var patterns$1 = {
+  dateTimeDelimiter: /[T ]/,
+  timeZoneDelimiter: /[Z ]/i,
+  timezone: /([Z+-].*)$/
+};
+var dateRegex = /^-?(?:(\d{3})|(\d{2})(?:-?(\d{2}))?|W(\d{2})(?:-?(\d{1}))?|)$/;
+var timeRegex = /^(\d{2}(?:[.,]\d*)?)(?::?(\d{2}(?:[.,]\d*)?))?(?::?(\d{2}(?:[.,]\d*)?))?$/;
+var timezoneRegex = /^([+-])(\d{2})(?::?(\d{2}))?$/;
+function splitDateString(dateString) {
+  var dateStrings = {};
+  var array = dateString.split(patterns$1.dateTimeDelimiter);
+  var timeString;
+
+  // The regex match should only return at maximum two array elements.
+  // [date], [time], or [date, time].
+  if (array.length > 2) {
+    return dateStrings;
+  }
+  if (/:/.test(array[0])) {
+    timeString = array[0];
+  } else {
+    dateStrings.date = array[0];
+    timeString = array[1];
+    if (patterns$1.timeZoneDelimiter.test(dateStrings.date)) {
+      dateStrings.date = dateString.split(patterns$1.timeZoneDelimiter)[0];
+      timeString = dateString.substr(dateStrings.date.length, dateString.length);
+    }
+  }
+  if (timeString) {
+    var token = patterns$1.timezone.exec(timeString);
+    if (token) {
+      dateStrings.time = timeString.replace(token[1], '');
+      dateStrings.timezone = token[1];
+    } else {
+      dateStrings.time = timeString;
+    }
+  }
+  return dateStrings;
+}
+function parseYear(dateString, additionalDigits) {
+  var regex = new RegExp('^(?:(\\d{4}|[+-]\\d{' + (4 + additionalDigits) + '})|(\\d{2}|[+-]\\d{' + (2 + additionalDigits) + '})$)');
+  var captures = dateString.match(regex);
+  // Invalid ISO-formatted year
+  if (!captures) return {
+    year: NaN,
+    restDateString: ''
+  };
+  var year = captures[1] ? parseInt(captures[1]) : null;
+  var century = captures[2] ? parseInt(captures[2]) : null;
+
+  // either year or century is null, not both
+  return {
+    year: century === null ? year : century * 100,
+    restDateString: dateString.slice((captures[1] || captures[2]).length)
+  };
+}
+function parseDate(dateString, year) {
+  // Invalid ISO-formatted year
+  if (year === null) return new Date(NaN);
+  var captures = dateString.match(dateRegex);
+  // Invalid ISO-formatted string
+  if (!captures) return new Date(NaN);
+  var isWeekDate = !!captures[4];
+  var dayOfYear = parseDateUnit(captures[1]);
+  var month = parseDateUnit(captures[2]) - 1;
+  var day = parseDateUnit(captures[3]);
+  var week = parseDateUnit(captures[4]);
+  var dayOfWeek = parseDateUnit(captures[5]) - 1;
+  if (isWeekDate) {
+    if (!validateWeekDate(year, week, dayOfWeek)) {
+      return new Date(NaN);
+    }
+    return dayOfISOWeekYear(year, week, dayOfWeek);
+  } else {
+    var date = new Date(0);
+    if (!validateDate(year, month, day) || !validateDayOfYearDate(year, dayOfYear)) {
+      return new Date(NaN);
+    }
+    date.setUTCFullYear(year, month, Math.max(dayOfYear, day));
+    return date;
+  }
+}
+function parseDateUnit(value) {
+  return value ? parseInt(value) : 1;
+}
+function parseTime(timeString) {
+  var captures = timeString.match(timeRegex);
+  if (!captures) return NaN; // Invalid ISO-formatted time
+
+  var hours = parseTimeUnit(captures[1]);
+  var minutes = parseTimeUnit(captures[2]);
+  var seconds = parseTimeUnit(captures[3]);
+  if (!validateTime(hours, minutes, seconds)) {
+    return NaN;
+  }
+  return hours * millisecondsInHour + minutes * millisecondsInMinute + seconds * 1000;
+}
+function parseTimeUnit(value) {
+  return value && parseFloat(value.replace(',', '.')) || 0;
+}
+function parseTimezone(timezoneString) {
+  if (timezoneString === 'Z') return 0;
+  var captures = timezoneString.match(timezoneRegex);
+  if (!captures) return 0;
+  var sign = captures[1] === '+' ? -1 : 1;
+  var hours = parseInt(captures[2]);
+  var minutes = captures[3] && parseInt(captures[3]) || 0;
+  if (!validateTimezone(hours, minutes)) {
+    return NaN;
+  }
+  return sign * (hours * millisecondsInHour + minutes * millisecondsInMinute);
+}
+function dayOfISOWeekYear(isoWeekYear, week, day) {
+  var date = new Date(0);
+  date.setUTCFullYear(isoWeekYear, 0, 4);
+  var fourthOfJanuaryDay = date.getUTCDay() || 7;
+  var diff = (week - 1) * 7 + day + 1 - fourthOfJanuaryDay;
+  date.setUTCDate(date.getUTCDate() + diff);
+  return date;
+}
+
+// Validation functions
+
+// February is null to handle the leap year (using ||)
+var daysInMonths = [31, null, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+function isLeapYearIndex(year) {
+  return year % 400 === 0 || year % 4 === 0 && year % 100 !== 0;
+}
+function validateDate(year, month, date) {
+  return month >= 0 && month <= 11 && date >= 1 && date <= (daysInMonths[month] || (isLeapYearIndex(year) ? 29 : 28));
+}
+function validateDayOfYearDate(year, dayOfYear) {
+  return dayOfYear >= 1 && dayOfYear <= (isLeapYearIndex(year) ? 366 : 365);
+}
+function validateWeekDate(_year, week, day) {
+  return week >= 1 && week <= 53 && day >= 0 && day <= 6;
+}
+function validateTime(hours, minutes, seconds) {
+  if (hours === 24) {
+    return minutes === 0 && seconds === 0;
+  }
+  return seconds >= 0 && seconds < 60 && minutes >= 0 && minutes < 60 && hours >= 0 && hours < 25;
+}
+function validateTimezone(_hours, minutes) {
+  return minutes >= 0 && minutes <= 59;
+}
+
 // Copyright (c) Cosmo Tech.
 // Licensed under the MIT license.
 
+var decreaseDateByOffset = (date, offset) => {
+  if (date instanceof Date === false) throw new TypeError('"date" parameter must be a Date object');
+  return new Date(date - offset * 60 * 1000);
+};
+var increaseDateByOffset = (date, offset) => {
+  return decreaseDateByOffset(date, -offset);
+};
+var addLocalDateToUTCOffset = date => {
+  if (date instanceof Date === false) throw new TypeError('"date" parameter must be a Date object');
+  // Example: if local time is 15:00, UTC time is 13:00, timezoneOffset is -120, then we need to "increase" the local
+  // datetime by -120 to find UTC time
+  return increaseDateByOffset(date, date.getTimezoneOffset());
+};
+var addUTCToLocalDateOffset = date => {
+  if (date instanceof Date === false) throw new TypeError('"date" parameter must be a Date object');
+  return decreaseDateByOffset(date, date.getTimezoneOffset());
+};
+var getDateAtMidnightUTC = date => {
+  if (date instanceof Date === false) throw new TypeError('"date" parameter must be a Date object');
+  return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), 0, 0, 0));
+};
 var parse = (dateStr, dateFormat) => {
   try {
     return parse$1(dateStr, dateFormat, new Date());
@@ -33282,6 +33529,7 @@ var parse = (dateStr, dateFormat) => {
     console.error(error);
   }
 };
+var parseISO = dateStr => parseISO$1(dateStr);
 var format = function format(date) {
   var dateFormat = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "yyyy-MM-dd'T'HH:mm:ss.SSSX";
   if (date) {
@@ -33293,9 +33541,24 @@ var format = function format(date) {
   }
   return '';
 };
+var formatUTCDateAsLocal = function formatUTCDateAsLocal(date) {
+  var dateFormat = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "yyyy-MM-dd'T'HH:mm:ss.SSSX";
+  try {
+    var dateWithReverseOffset = addLocalDateToUTCOffset(date);
+    return format(dateWithReverseOffset, dateFormat);
+  } catch (error) {
+    console.error(error);
+  }
+  return '';
+};
+
+// TODO: (breaking change) rename to something like "isFormatValid" to prevent confusion with the check of invalid dates
 var isValid$1 = (dateStr, dateFormat) => {
   return isMatch(dateStr, dateFormat);
 };
+var isValidDate = date => {
+  return isValid$2(date);
+};
 var min = (dateA, dateB) => {
   if (dateA && dateB) {
     return dateA < dateB ? dateA : dateB;
@@ -33325,9 +33588,17 @@ var strMax = (dateStrA, dateStrB, dateFormat) => {
   }
 };
 var DateUtils = {
+  decreaseDateByOffset,
+  increaseDateByOffset,
+  addLocalDateToUTCOffset,
+  addUTCToLocalDateOffset,
+  getDateAtMidnightUTC,
   parse,
+  parseISO,
   format,
+  formatUTCDateAsLocal,
   isValid: isValid$1,
+  isValidDate,
   min,
   max,
   strMin,
@@ -41493,6 +41764,18 @@ let Error$1 = class Error {
   }
 };
 
+var getFlattenColumnsWithoutGroups = columns => {
+  if (columns == null) {
+    console.warn("Columns list shouldn't be null or undefined");
+    return [];
+  }
+  return columns.flatMap(columnOrGroup => {
+    if (columnOrGroup == null) {
+      console.warn('Null or undefined values found in columns list');
+    }
+    return columnOrGroup !== null && columnOrGroup !== void 0 && columnOrGroup.children ? getFlattenColumnsWithoutGroups(columnOrGroup.children) : columnOrGroup;
+  }).filter(column => column != null);
+};
 var _buildEmptyFieldError = (rowLineNumber, expectedCols, colIndex) => {
   var errorSummary = "Empty field";
   var errorLoc = "Line ".concat(rowLineNumber, ", Column ").concat(colIndex + 1, " (\"").concat(expectedCols[colIndex].field, "\")");
@@ -41635,9 +41918,9 @@ var _buildRows = (rows, hasHeader, cols) => {
 };
 var fromCSV = function fromCSV(dataStr) {
   var hasHeader = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
-  var cols = arguments.length > 2 ? arguments[2] : undefined;
+  var nestedCols = arguments.length > 2 ? arguments[2] : undefined;
   var options = arguments.length > 3 ? arguments[3] : undefined;
-  if (!hasHeader && !cols) {
+  if (!hasHeader && !nestedCols) {
     return {
       error: [new Error$1('cols must be defined if hasHeader=false', null, null)]
     };
@@ -41648,6 +41931,7 @@ var fromCSV = function fromCSV(dataStr) {
       rows: []
     };
   }
+  var cols = getFlattenColumnsWithoutGroups(nestedCols);
   var rows = [];
   var csvLines;
   var emptyCols = _calculateEmptyCols(cols);
@@ -41658,7 +41942,7 @@ var fromCSV = function fromCSV(dataStr) {
       error: [err]
     };
   }
-  if (!cols) {
+  if (!cols || cols.length === 0) {
     cols = _buildCols(csvLines[0]);
   }
   var errors = _validateFormat(csvLines, hasHeader, cols, options);
@@ -41687,12 +41971,13 @@ var _generateRows = function _generateRows(rows, cols) {
   var rowSep = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : '\n';
   return rows.map(row => _generateRow(row, cols, colSep)).join(rowSep);
 };
-var toCSV = (rows, cols, options) => {
-  if (cols == null || cols.length === 0) {
+var toCSV = (rows, nestedCols, options) => {
+  if (nestedCols == null || nestedCols.length === 0) {
     return {
       error: ["Cols must be defined"]
     };
   }
+  var cols = getFlattenColumnsWithoutGroups(nestedCols);
   if (!rows) {
     rows = [];
   }
@@ -41710,10 +41995,11 @@ var toCSV = (rows, cols, options) => {
 
 // TODO: some metadata of cols & options ('acceptsEmptyFields', columns types, dates format, ...) are not used right
 // now, but they could be used in a future version to improve the format of the exported Excel file
-var toXLSX = (rows, cols, options) => {
+var toXLSX = (rows, nestedCols, options) => {
   if (!rows) {
     rows = [];
   }
+  var cols = getFlattenColumnsWithoutGroups(nestedCols);
   options = _objectSpread2(_objectSpread2({}, DEFAULT_XLSX_EXPORT_OPTIONS), options);
   var header = options.writeHeader ? cols.map(col => col.field) : null;
   return XLSXUtils.write(rows, header);
@@ -41721,9 +42007,9 @@ var toXLSX = (rows, cols, options) => {
 var fromXLSX = /*#__PURE__*/function () {
   var _ref2 = _asyncToGenerator(function* (fileBlob) {
     var hasHeader = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
-    var cols = arguments.length > 2 ? arguments[2] : undefined;
+    var nestedCols = arguments.length > 2 ? arguments[2] : undefined;
     var options = arguments.length > 3 ? arguments[3] : undefined;
-    if (!hasHeader && !cols) {
+    if (!hasHeader && !nestedCols) {
       return {
         error: [new Error$1('cols must be defined if hasHeader=false', null, null)]
       };
@@ -41734,6 +42020,7 @@ var fromXLSX = /*#__PURE__*/function () {
         rows: []
       };
     }
+    var cols = getFlattenColumnsWithoutGroups(nestedCols);
     var rows = [];
     var xlsxLines;
     var emptyCols = _calculateEmptyCols(cols);
@@ -41745,7 +42032,7 @@ var fromXLSX = /*#__PURE__*/function () {
         error: [new Error$1((err === null || err === void 0 ? void 0 : err.message) || err, fileBlob.name, (err === null || err === void 0 ? void 0 : err.stack) || null)]
       };
     }
-    if (!cols) {
+    if (!cols || cols.length === 0) {
       cols = _buildCols(xlsxLines[0]);
     }
     var errors = _validateFormat(xlsxLines, hasHeader, cols, options);
@@ -41765,6 +42052,7 @@ var fromXLSX = /*#__PURE__*/function () {
 var AgGridUtils = {
   fromCSV,
   fromXLSX,
+  getFlattenColumnsWithoutGroups,
   toCSV,
   toXLSX
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cosmotech/core",
   "private": false,
-  "version": "1.11.6",
+  "version": "1.13.0",
   "description": "",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",
@@ -46,7 +46,8 @@
     "rollup": "^3.12.0",
     "rollup-plugin-peer-deps-external": "^2.2.4",
     "rollup-plugin-postcss": "^4.0.0",
-    "rollup-plugin-visualizer": "^5.5.0"
+    "rollup-plugin-visualizer": "^5.5.0",
+    "timezone-mock": "^1.3.6"
   },
   "dependencies": {
     "csv-string": "^4.0.1",