@lyit/exceljs 4.4.1

package/dist/es5/doc/pivot-table.js

@@ -0,0 +1,247 @@
+"use strict";
+
+const colCache = require('../utils/col-cache');
+const {
+  objectFromProps,
+  range,
+  toSortedArray
+} = require('../utils/utils');
+
+// TK(2023-10-10): turn this into a class constructor.
+
+// IMPORTANT: Pivot tables are NOT supported with streaming API (WorkbookWriter)
+//
+// Pivot tables require reading ALL source data to generate the pivot cache,
+// which conflicts with streaming's one-pass write model. Excel requires complete
+// pivot cache data (all unique values and all data rows) at file creation time.
+//
+// For large datasets, use the standard (non-streaming) Workbook API with pivot tables.
+
+function makePivotTable(worksheet, model) {
+  // Example `model`:
+  // {
+  //   sourceSheet: worksheet1,
+  //   rows: ['A', 'B'],
+  //   columns: ['C'],
+  //   values: ['E'],
+  //   pages: ['F'], // optional
+  //   pageDefaults: { F: 'value' }, // optional
+  //   metric: 'sum', 'count'
+  //   startRow: 1, // optional: header row number (default: 1)
+  //   startCell: 'A1', // optional: pivot table location (default: 'A1')
+  //   valueNumFmt: '#,##0.00', // optional: number format for value field
+  //   verbose: false, // optional: show progress logs
+  // }
+
+  validate(worksheet, model);
+  const {
+    sourceSheet
+  } = model;
+  let {
+    rows,
+    columns,
+    values,
+    pages = []
+  } = model;
+  const {
+    metric,
+    pageDefaults = {},
+    verbose = false
+  } = model;
+  const startRow = model.startRow || 1;
+
+  // Generate sharedItems only for categorical fields (rows, columns, pages).
+  // Value fields (values) are numeric aggregations and should NOT have sharedItems,
+  // as their raw values are written directly as <n> in cache records.
+  // This significantly reduces processing time for wide datasets (e.g. 26 cols × 60k rows).
+  if (verbose) {
+    // eslint-disable-next-line no-console
+    console.log('Generating cache fields...');
+  }
+  const usedFieldNames = [...model.rows, ...model.columns, ...pages];
+  const cacheFields = makeCacheFields(sourceSheet, usedFieldNames, startRow, verbose);
+  if (verbose) {
+    // eslint-disable-next-line no-console
+    console.log(`  ✓ Generated ${cacheFields.length} cache fields (${usedFieldNames.length} with sharedItems)`);
+  }
+
+  // Calculate the source data range for the pivot cache
+  // The range should start from the header row (startRow) to the last row with data
+  const dimensions = sourceSheet.dimensions;
+  const sourceDataRange = dimensions ? colCache.encode(startRow, dimensions.left, dimensions.bottom, dimensions.right) : null;
+
+  // let {rows, columns, values, pages} use indices instead of names;
+  // names can then be accessed via `pivotTable.cacheFields[index].name`.
+  // *Note*: Using `reduce` as `Object.fromEntries` requires Node 12+;
+  // ExcelJS is >=8.3.0 (as of 2023-10-08).
+  const nameToIndex = cacheFields.reduce((result, cacheField, index) => {
+    result[cacheField.name] = index;
+    return result;
+  }, {});
+  rows = rows.map(row => nameToIndex[row]);
+  columns = columns.map(column => nameToIndex[column]);
+  values = values.map(value => nameToIndex[value]);
+  pages = pages.map(page => nameToIndex[page]);
+
+  // Generate unique cache ID based on the number of existing pivot tables
+  // Each pivot table gets its own cache ID (starting from 10)
+  const cacheId = String(10 + worksheet.workbook.pivotTables.length);
+
+  // Convert pageDefaults from field names to indices with item indices
+  const pageDefaultsIndices = {};
+  for (const [fieldName, defaultValue] of Object.entries(pageDefaults)) {
+    const fieldIndex = nameToIndex[fieldName];
+    if (fieldIndex !== undefined) {
+      const cacheField = cacheFields[fieldIndex];
+      if (cacheField.sharedItems) {
+        // Find the item index for the default value
+        const itemIndex = cacheField.sharedItems.findIndex(item => item === defaultValue);
+        if (itemIndex >= 0) {
+          pageDefaultsIndices[fieldIndex] = itemIndex;
+        }
+      }
+    }
+  }
+
+  // form pivot table object
+  return {
+    sourceSheet,
+    rows,
+    columns,
+    values,
+    pages,
+    pageDefaults: pageDefaultsIndices,
+    metric,
+    cacheFields,
+    // defined in <pivotTableDefinition> of xl/pivotTables/pivotTableN.xml;
+    // also used in xl/workbook.xml
+    cacheId,
+    // Control whether pivot table style overrides worksheet column widths
+    // '0' = preserve worksheet column widths (useful for custom sizing)
+    // '1' = apply pivot table style width/height (default Excel behavior)
+    applyWidthHeightFormats: model.applyWidthHeightFormats !== undefined ? model.applyWidthHeightFormats : '1',
+    // Data starts from this row (startRow + 1)
+    dataStartRow: startRow + 1,
+    // Source data range for the pivot cache (from header row to last data row)
+    sourceDataRange,
+    // Pivot table location on the destination sheet
+    startCell: model.startCell || 'A1',
+    // Number format for the value field (e.g. '#,##0.00' for currency)
+    valueNumFmt: model.valueNumFmt || null
+  };
+}
+function validate(worksheet, model) {
+  // Note: Multiple pivot tables are now supported
+
+  if (model.metric && model.metric !== 'sum' && model.metric !== 'count') {
+    throw new Error('Only the "sum" and "count" metric is supported at this time.');
+  }
+  const startRow = model.startRow || 1;
+  const headerNames = model.sourceSheet.getRow(startRow).values.slice(1);
+  const isInHeaderNames = objectFromProps(headerNames, true);
+  const pages = model.pages || [];
+  for (const name of [...model.rows, ...model.columns, ...model.values, ...pages]) {
+    if (!isInHeaderNames[name]) {
+      throw new Error(`The header name "${name}" was not found in ${model.sourceSheet.name}.`);
+    }
+  }
+  if (!model.rows.length) {
+    throw new Error('No pivot table rows specified.');
+  }
+  if (!model.columns.length) {
+    throw new Error('No pivot table columns specified.');
+  }
+  if (model.values.length !== 1) {
+    throw new Error('Exactly 1 value needs to be specified at this time.');
+  }
+
+  // Validate page fields don't overlap with rows/columns/values
+  const allFields = [...model.rows, ...model.columns, ...model.values];
+  for (const pageField of pages) {
+    if (allFields.includes(pageField)) {
+      throw new Error(`Page field "${pageField}" cannot also be used as a row, column, or value field.`);
+    }
+  }
+
+  // Validate pageDefaults reference valid page fields and values
+  if (model.pageDefaults) {
+    for (const [fieldName, defaultValue] of Object.entries(model.pageDefaults)) {
+      if (!pages.includes(fieldName)) {
+        throw new Error(`pageDefaults field "${fieldName}" is not in the pages array.`);
+      }
+    }
+  }
+}
+function makeCacheFields(worksheet, fieldNamesWithSharedItems) {
+  let startRow = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 1;
+  let verbose = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
+  // Cache fields are used in pivot tables to reference source data.
+  //
+  // Example
+  // -------
+  // Turn
+  //
+  //  `worksheet` sheet values [
+  //    ['A', 'B', 'C', 'D', 'E'],
+  //    ['a1', 'b1', 'c1', 4, 5],
+  //    ['a1', 'b2', 'c1', 4, 5],
+  //    ['a2', 'b1', 'c2', 14, 24],
+  //    ['a2', 'b2', 'c2', 24, 35],
+  //    ['a3', 'b1', 'c3', 34, 45],
+  //    ['a3', 'b2', 'c3', 44, 45]
+  //  ];
+  //  fieldNamesWithSharedItems = ['A', 'B', 'C'];
+  //  startRow = 1 (default, header row)
+  //
+  // into
+  //
+  //  [
+  //    { name: 'A', sharedItems: ['a1', 'a2', 'a3'] },
+  //    { name: 'B', sharedItems: ['b1', 'b2'] },
+  //    { name: 'C', sharedItems: ['c1', 'c2', 'c3'] },
+  //    { name: 'D', sharedItems: null },
+  //    { name: 'E', sharedItems: null }
+  //  ]
+
+  const names = worksheet.getRow(startRow).values;
+  const nameToHasSharedItems = objectFromProps(fieldNamesWithSharedItems, true);
+  const totalColumns = names.length - 1;
+  const aggregate = (columnIndex, fieldName) => {
+    if (verbose && nameToHasSharedItems[fieldName]) {
+      // eslint-disable-next-line no-console
+      console.log(`    Processing column ${columnIndex}/${totalColumns}: ${fieldName}`);
+    }
+    const columnValues = worksheet.getColumn(columnIndex).values.slice(startRow + 1);
+
+    // Deduplicate case-insensitively for Excel compatibility
+    // Excel treats pivot table values as case-insensitive, so "Apple" and "apple"
+    // are considered the same value. We keep the first occurrence of each case-insensitive variant.
+    const seen = new Map(); // lowercase -> first occurrence
+    const uniqueValues = [];
+    for (const value of columnValues) {
+      if (value === null || value === undefined) continue;
+      const key = typeof value === 'string' ? value.toLowerCase() : value;
+      if (!seen.has(key)) {
+        seen.set(key, value);
+        uniqueValues.push(value);
+      }
+    }
+    return toSortedArray(uniqueValues);
+  };
+
+  // make result
+  const result = [];
+  for (const columnIndex of range(1, names.length)) {
+    const name = names[columnIndex];
+    const sharedItems = nameToHasSharedItems[name] ? aggregate(columnIndex, name) : null;
+    result.push({
+      name,
+      sharedItems
+    });
+  }
+  return result;
+}
+module.exports = {
+  makePivotTable
+};
+//# sourceMappingURL=pivot-table.js.map

package/dist/es5/doc/pivot-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pivot-table.js","names":["colCache","require","objectFromProps","range","toSortedArray","makePivotTable","worksheet","model","validate","sourceSheet","rows","columns","values","pages","metric","pageDefaults","verbose","startRow","console","log","usedFieldNames","cacheFields","makeCacheFields","length","dimensions","sourceDataRange","encode","left","bottom","right","nameToIndex","reduce","result","cacheField","index","name","map","row","column","value","page","cacheId","String","workbook","pivotTables","pageDefaultsIndices","fieldName","defaultValue","Object","entries","fieldIndex","undefined","sharedItems","itemIndex","findIndex","item","applyWidthHeightFormats","dataStartRow","startCell","valueNumFmt","Error","headerNames","getRow","slice","isInHeaderNames","allFields","pageField","includes","fieldNamesWithSharedItems","arguments","names","nameToHasSharedItems","totalColumns","aggregate","columnIndex","columnValues","getColumn","seen","Map","uniqueValues","key","toLowerCase","has","set","push","module","exports"],"sources":["../../../lib/doc/pivot-table.js"],"sourcesContent":["const colCache = require('../utils/col-cache');\r\nconst {objectFromProps, range, toSortedArray} = require('../utils/utils');\r\n\r\n// TK(2023-10-10): turn this into a class constructor.\r\n\r\n// IMPORTANT: Pivot tables are NOT supported with streaming API (WorkbookWriter)\r\n//\r\n// Pivot tables require reading ALL source data to generate the pivot cache,\r\n// which conflicts with streaming's one-pass write model. Excel requires complete\r\n// pivot cache data (all unique values and all data rows) at file creation time.\r\n//\r\n// For large datasets, use the standard (non-streaming) Workbook API with pivot tables.\r\n\r\nfunction makePivotTable(worksheet, model) {\r\n  // Example `model`:\r\n  // {\r\n  //   sourceSheet: worksheet1,\r\n  //   rows: ['A', 'B'],\r\n  //   columns: ['C'],\r\n  //   values: ['E'],\r\n  //   pages: ['F'], // optional\r\n  //   pageDefaults: { F: 'value' }, // optional\r\n  //   metric: 'sum', 'count'\r\n  //   startRow: 1, // optional: header row number (default: 1)\r\n  //   startCell: 'A1', // optional: pivot table location (default: 'A1')\r\n  //   valueNumFmt: '#,##0.00', // optional: number format for value field\r\n  //   verbose: false, // optional: show progress logs\r\n  // }\r\n\r\n  validate(worksheet, model);\r\n\r\n  const {sourceSheet} = model;\r\n  let {rows, columns, values, pages = []} = model;\r\n  const {metric, pageDefaults = {}, verbose = false} = model;\r\n  const startRow = model.startRow || 1;\r\n\r\n  // Generate sharedItems only for categorical fields (rows, columns, pages).\r\n  // Value fields (values) are numeric aggregations and should NOT have sharedItems,\r\n  // as their raw values are written directly as <n> in cache records.\r\n  // This significantly reduces processing time for wide datasets (e.g. 26 cols × 60k rows).\r\n  if (verbose) {\r\n    // eslint-disable-next-line no-console\r\n    console.log('Generating cache fields...');\r\n  }\r\n  const usedFieldNames = [...model.rows, ...model.columns, ...pages];\r\n  const cacheFields = makeCacheFields(sourceSheet, usedFieldNames, startRow, verbose);\r\n  if (verbose) {\r\n    // eslint-disable-next-line no-console\r\n    console.log(`  ✓ Generated ${cacheFields.length} cache fields (${usedFieldNames.length} with sharedItems)`);\r\n  }\r\n\r\n  // Calculate the source data range for the pivot cache\r\n  // The range should start from the header row (startRow) to the last row with data\r\n  const dimensions = sourceSheet.dimensions;\r\n  const sourceDataRange = dimensions\r\n    ? colCache.encode(startRow, dimensions.left, dimensions.bottom, dimensions.right)\r\n    : null;\r\n\r\n  // let {rows, columns, values, pages} use indices instead of names;\r\n  // names can then be accessed via `pivotTable.cacheFields[index].name`.\r\n  // *Note*: Using `reduce` as `Object.fromEntries` requires Node 12+;\r\n  // ExcelJS is >=8.3.0 (as of 2023-10-08).\r\n  const nameToIndex = cacheFields.reduce((result, cacheField, index) => {\r\n    result[cacheField.name] = index;\r\n    return result;\r\n  }, {});\r\n  rows = rows.map(row => nameToIndex[row]);\r\n  columns = columns.map(column => nameToIndex[column]);\r\n  values = values.map(value => nameToIndex[value]);\r\n  pages = pages.map(page => nameToIndex[page]);\r\n\r\n  // Generate unique cache ID based on the number of existing pivot tables\r\n  // Each pivot table gets its own cache ID (starting from 10)\r\n  const cacheId = String(10 + worksheet.workbook.pivotTables.length);\r\n\r\n  // Convert pageDefaults from field names to indices with item indices\r\n  const pageDefaultsIndices = {};\r\n  for (const [fieldName, defaultValue] of Object.entries(pageDefaults)) {\r\n    const fieldIndex = nameToIndex[fieldName];\r\n    if (fieldIndex !== undefined) {\r\n      const cacheField = cacheFields[fieldIndex];\r\n      if (cacheField.sharedItems) {\r\n        // Find the item index for the default value\r\n        const itemIndex = cacheField.sharedItems.findIndex(item => item === defaultValue);\r\n        if (itemIndex >= 0) {\r\n          pageDefaultsIndices[fieldIndex] = itemIndex;\r\n        }\r\n      }\r\n    }\r\n  }\r\n\r\n  // form pivot table object\r\n  return {\r\n    sourceSheet,\r\n    rows,\r\n    columns,\r\n    values,\r\n    pages,\r\n    pageDefaults: pageDefaultsIndices,\r\n    metric,\r\n    cacheFields,\r\n    // defined in <pivotTableDefinition> of xl/pivotTables/pivotTableN.xml;\r\n    // also used in xl/workbook.xml\r\n    cacheId,\r\n    // Control whether pivot table style overrides worksheet column widths\r\n    // '0' = preserve worksheet column widths (useful for custom sizing)\r\n    // '1' = apply pivot table style width/height (default Excel behavior)\r\n    applyWidthHeightFormats:\r\n      model.applyWidthHeightFormats !== undefined ? model.applyWidthHeightFormats : '1',\r\n    // Data starts from this row (startRow + 1)\r\n    dataStartRow: startRow + 1,\r\n    // Source data range for the pivot cache (from header row to last data row)\r\n    sourceDataRange,\r\n    // Pivot table location on the destination sheet\r\n    startCell: model.startCell || 'A1',\r\n    // Number format for the value field (e.g. '#,##0.00' for currency)\r\n    valueNumFmt: model.valueNumFmt || null,\r\n  };\r\n}\r\n\r\nfunction validate(worksheet, model) {\r\n  // Note: Multiple pivot tables are now supported\r\n\r\n  if (model.metric && model.metric !== 'sum' && model.metric !== 'count') {\r\n    throw new Error('Only the \"sum\" and \"count\" metric is supported at this time.');\r\n  }\r\n\r\n  const startRow = model.startRow || 1;\r\n  const headerNames = model.sourceSheet.getRow(startRow).values.slice(1);\r\n  const isInHeaderNames = objectFromProps(headerNames, true);\r\n  const pages = model.pages || [];\r\n  for (const name of [...model.rows, ...model.columns, ...model.values, ...pages]) {\r\n    if (!isInHeaderNames[name]) {\r\n      throw new Error(`The header name \"${name}\" was not found in ${model.sourceSheet.name}.`);\r\n    }\r\n  }\r\n\r\n  if (!model.rows.length) {\r\n    throw new Error('No pivot table rows specified.');\r\n  }\r\n\r\n  if (!model.columns.length) {\r\n    throw new Error('No pivot table columns specified.');\r\n  }\r\n\r\n  if (model.values.length !== 1) {\r\n    throw new Error('Exactly 1 value needs to be specified at this time.');\r\n  }\r\n\r\n  // Validate page fields don't overlap with rows/columns/values\r\n  const allFields = [...model.rows, ...model.columns, ...model.values];\r\n  for (const pageField of pages) {\r\n    if (allFields.includes(pageField)) {\r\n      throw new Error(\r\n        `Page field \"${pageField}\" cannot also be used as a row, column, or value field.`,\r\n      );\r\n    }\r\n  }\r\n\r\n  // Validate pageDefaults reference valid page fields and values\r\n  if (model.pageDefaults) {\r\n    for (const [fieldName, defaultValue] of Object.entries(model.pageDefaults)) {\r\n      if (!pages.includes(fieldName)) {\r\n        throw new Error(`pageDefaults field \"${fieldName}\" is not in the pages array.`);\r\n      }\r\n    }\r\n  }\r\n}\r\n\r\nfunction makeCacheFields(worksheet, fieldNamesWithSharedItems, startRow = 1, verbose = false) {\r\n  // Cache fields are used in pivot tables to reference source data.\r\n  //\r\n  // Example\r\n  // -------\r\n  // Turn\r\n  //\r\n  //  `worksheet` sheet values [\r\n  //    ['A', 'B', 'C', 'D', 'E'],\r\n  //    ['a1', 'b1', 'c1', 4, 5],\r\n  //    ['a1', 'b2', 'c1', 4, 5],\r\n  //    ['a2', 'b1', 'c2', 14, 24],\r\n  //    ['a2', 'b2', 'c2', 24, 35],\r\n  //    ['a3', 'b1', 'c3', 34, 45],\r\n  //    ['a3', 'b2', 'c3', 44, 45]\r\n  //  ];\r\n  //  fieldNamesWithSharedItems = ['A', 'B', 'C'];\r\n  //  startRow = 1 (default, header row)\r\n  //\r\n  // into\r\n  //\r\n  //  [\r\n  //    { name: 'A', sharedItems: ['a1', 'a2', 'a3'] },\r\n  //    { name: 'B', sharedItems: ['b1', 'b2'] },\r\n  //    { name: 'C', sharedItems: ['c1', 'c2', 'c3'] },\r\n  //    { name: 'D', sharedItems: null },\r\n  //    { name: 'E', sharedItems: null }\r\n  //  ]\r\n\r\n  const names = worksheet.getRow(startRow).values;\r\n  const nameToHasSharedItems = objectFromProps(fieldNamesWithSharedItems, true);\r\n  const totalColumns = names.length - 1;\r\n\r\n  const aggregate = (columnIndex, fieldName) => {\r\n    if (verbose && nameToHasSharedItems[fieldName]) {\r\n      // eslint-disable-next-line no-console\r\n      console.log(`    Processing column ${columnIndex}/${totalColumns}: ${fieldName}`);\r\n    }\r\n    const columnValues = worksheet.getColumn(columnIndex).values.slice(startRow + 1);\r\n\r\n    // Deduplicate case-insensitively for Excel compatibility\r\n    // Excel treats pivot table values as case-insensitive, so \"Apple\" and \"apple\"\r\n    // are considered the same value. We keep the first occurrence of each case-insensitive variant.\r\n    const seen = new Map(); // lowercase -> first occurrence\r\n    const uniqueValues = [];\r\n\r\n    for (const value of columnValues) {\r\n      if (value === null || value === undefined) continue;\r\n\r\n      const key = typeof value === 'string' ? value.toLowerCase() : value;\r\n      if (!seen.has(key)) {\r\n        seen.set(key, value);\r\n        uniqueValues.push(value);\r\n      }\r\n    }\r\n\r\n    return toSortedArray(uniqueValues);\r\n  };\r\n\r\n  // make result\r\n  const result = [];\r\n  for (const columnIndex of range(1, names.length)) {\r\n    const name = names[columnIndex];\r\n    const sharedItems = nameToHasSharedItems[name] ? aggregate(columnIndex, name) : null;\r\n    result.push({name, sharedItems});\r\n  }\r\n  return result;\r\n}\r\n\r\nmodule.exports = {makePivotTable};\r\n"],"mappings":"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","ignoreList":[]}

package/dist/es5/doc/range.js

@@ -0,0 +1,229 @@
+"use strict";
+
+const colCache = require('../utils/col-cache');
+
+// used by worksheet to calculate sheet dimensions
+class Range {
+  constructor() {
+    this.decode(arguments);
+  }
+  setTLBR(t, l, b, r, s) {
+    if (arguments.length < 4) {
+      // setTLBR(tl, br, s)
+      const tl = colCache.decodeAddress(t);
+      const br = colCache.decodeAddress(l);
+      this.model = {
+        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),
+        sheetName: b
+      };
+      this.setTLBR(tl.row, tl.col, br.row, br.col, s);
+    } else {
+      // setTLBR(t, l, b, r, s)
+      this.model = {
+        top: Math.min(t, b),
+        left: Math.min(l, r),
+        bottom: Math.max(t, b),
+        right: Math.max(l, r),
+        sheetName: s
+      };
+    }
+  }
+  decode(argv) {
+    switch (argv.length) {
+      case 5:
+        // [t,l,b,r,s]
+        this.setTLBR(argv[0], argv[1], argv[2], argv[3], argv[4]);
+        break;
+      case 4:
+        // [t,l,b,r]
+        this.setTLBR(argv[0], argv[1], argv[2], argv[3]);
+        break;
+      case 3:
+        // [tl,br,s]
+        this.setTLBR(argv[0], argv[1], argv[2]);
+        break;
+      case 2:
+        // [tl,br]
+        this.setTLBR(argv[0], argv[1]);
+        break;
+      case 1:
+        {
+          const value = argv[0];
+          if (value instanceof Range) {
+            // copy constructor
+            this.model = {
+              top: value.model.top,
+              left: value.model.left,
+              bottom: value.model.bottom,
+              right: value.model.right,
+              sheetName: value.sheetName
+            };
+          } else if (value instanceof Array) {
+            // an arguments array
+            this.decode(value);
+          } else if (value.top && value.left && value.bottom && value.right) {
+            // a model
+            this.model = {
+              top: value.top,
+              left: value.left,
+              bottom: value.bottom,
+              right: value.right,
+              sheetName: value.sheetName
+            };
+          } else {
+            // [sheetName!]tl:br
+            const tlbr = colCache.decodeEx(value);
+            if (tlbr.top) {
+              this.model = {
+                top: tlbr.top,
+                left: tlbr.left,
+                bottom: tlbr.bottom,
+                right: tlbr.right,
+                sheetName: tlbr.sheetName
+              };
+            } else {
+              this.model = {
+                top: tlbr.row,
+                left: tlbr.col,
+                bottom: tlbr.row,
+                right: tlbr.col,
+                sheetName: tlbr.sheetName
+              };
+            }
+          }
+          break;
+        }
+      case 0:
+        this.model = {
+          top: 0,
+          left: 0,
+          bottom: 0,
+          right: 0
+        };
+        break;
+      default:
+        throw new Error(`Invalid number of arguments to _getDimensions() - ${argv.length}`);
+    }
+  }
+  get top() {
+    return this.model.top || 1;
+  }
+  set top(value) {
+    this.model.top = value;
+  }
+  get left() {
+    return this.model.left || 1;
+  }
+  set left(value) {
+    this.model.left = value;
+  }
+  get bottom() {
+    return this.model.bottom || 1;
+  }
+  set bottom(value) {
+    this.model.bottom = value;
+  }
+  get right() {
+    return this.model.right || 1;
+  }
+  set right(value) {
+    this.model.right = value;
+  }
+  get sheetName() {
+    return this.model.sheetName;
+  }
+  set sheetName(value) {
+    this.model.sheetName = value;
+  }
+  get _serialisedSheetName() {
+    const {
+      sheetName
+    } = this.model;
+    if (sheetName) {
+      if (/^[a-zA-Z0-9]*$/.test(sheetName)) {
+        return `${sheetName}!`;
+      }
+      return `'${sheetName}'!`;
+    }
+    return '';
+  }
+  expand(top, left, bottom, right) {
+    if (!this.model.top || top < this.top) this.top = top;
+    if (!this.model.left || left < this.left) this.left = left;
+    if (!this.model.bottom || bottom > this.bottom) this.bottom = bottom;
+    if (!this.model.right || right > this.right) this.right = right;
+  }
+  expandRow(row) {
+    if (row) {
+      const {
+        dimensions,
+        number
+      } = row;
+      if (dimensions) {
+        this.expand(number, dimensions.min, number, dimensions.max);
+      }
+    }
+  }
+  expandToAddress(addressStr) {
+    const address = colCache.decodeEx(addressStr);
+    this.expand(address.row, address.col, address.row, address.col);
+  }
+  get tl() {
+    return colCache.n2l(this.left) + this.top;
+  }
+  get $t$l() {
+    return `$${colCache.n2l(this.left)}$${this.top}`;
+  }
+  get br() {
+    return colCache.n2l(this.right) + this.bottom;
+  }
+  get $b$r() {
+    return `$${colCache.n2l(this.right)}$${this.bottom}`;
+  }
+  get range() {
+    return `${this._serialisedSheetName + this.tl}:${this.br}`;
+  }
+  get $range() {
+    return `${this._serialisedSheetName + this.$t$l}:${this.$b$r}`;
+  }
+  get shortRange() {
+    return this.count > 1 ? this.range : this._serialisedSheetName + this.tl;
+  }
+  get $shortRange() {
+    return this.count > 1 ? this.$range : this._serialisedSheetName + this.$t$l;
+  }
+  get count() {
+    return (1 + this.bottom - this.top) * (1 + this.right - this.left);
+  }
+  toString() {
+    return this.range;
+  }
+  intersects(other) {
+    if (other.sheetName && this.sheetName && other.sheetName !== this.sheetName) return false;
+    if (other.bottom < this.top) return false;
+    if (other.top > this.bottom) return false;
+    if (other.right < this.left) return false;
+    if (other.left > this.right) return false;
+    return true;
+  }
+  contains(addressStr) {
+    const address = colCache.decodeEx(addressStr);
+    return this.containsEx(address);
+  }
+  containsEx(address) {
+    if (address.sheetName && this.sheetName && address.sheetName !== this.sheetName) return false;
+    return address.row >= this.top && address.row <= this.bottom && address.col >= this.left && address.col <= this.right;
+  }
+  forEachAddress(cb) {
+    for (let col = this.left; col <= this.right; col++) {
+      for (let row = this.top; row <= this.bottom; row++) {
+        cb(colCache.encodeAddress(row, col), row, col);
+      }
+    }
+  }
+}
+module.exports = Range;
+//# sourceMappingURL=range.js.map

package/dist/es5/doc/range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.js","names":["colCache","require","Range","constructor","decode","arguments","setTLBR","t","l","b","r","s","length","tl","decodeAddress","br","model","top","Math","min","row","left","col","bottom","max","right","sheetName","argv","value","Array","tlbr","decodeEx","Error","_serialisedSheetName","test","expand","expandRow","dimensions","number","expandToAddress","addressStr","address","n2l","$t$l","$b$r","range","$range","shortRange","count","$shortRange","toString","intersects","other","contains","containsEx","forEachAddress","cb","encodeAddress","module","exports"],"sources":["../../../lib/doc/range.js"],"sourcesContent":["const colCache = require('../utils/col-cache');\r\n\r\n// used by worksheet to calculate sheet dimensions\r\nclass Range {\r\n  constructor() {\r\n    this.decode(arguments);\r\n  }\r\n\r\n  setTLBR(t, l, b, r, s) {\r\n    if (arguments.length < 4) {\r\n      // setTLBR(tl, br, s)\r\n      const tl = colCache.decodeAddress(t);\r\n      const br = colCache.decodeAddress(l);\r\n      this.model = {\r\n        top: Math.min(tl.row, br.row),\r\n        left: Math.min(tl.col, br.col),\r\n        bottom: Math.max(tl.row, br.row),\r\n        right: Math.max(tl.col, br.col),\r\n        sheetName: b,\r\n      };\r\n\r\n      this.setTLBR(tl.row, tl.col, br.row, br.col, s);\r\n    } else {\r\n      // setTLBR(t, l, b, r, s)\r\n      this.model = {\r\n        top: Math.min(t, b),\r\n        left: Math.min(l, r),\r\n        bottom: Math.max(t, b),\r\n        right: Math.max(l, r),\r\n        sheetName: s,\r\n      };\r\n    }\r\n  }\r\n\r\n  decode(argv) {\r\n    switch (argv.length) {\r\n      case 5: // [t,l,b,r,s]\r\n        this.setTLBR(argv[0], argv[1], argv[2], argv[3], argv[4]);\r\n        break;\r\n      case 4: // [t,l,b,r]\r\n        this.setTLBR(argv[0], argv[1], argv[2], argv[3]);\r\n        break;\r\n\r\n      case 3: // [tl,br,s]\r\n        this.setTLBR(argv[0], argv[1], argv[2]);\r\n        break;\r\n      case 2: // [tl,br]\r\n        this.setTLBR(argv[0], argv[1]);\r\n        break;\r\n\r\n      case 1: {\r\n        const value = argv[0];\r\n        if (value instanceof Range) {\r\n          // copy constructor\r\n          this.model = {\r\n            top: value.model.top,\r\n            left: value.model.left,\r\n            bottom: value.model.bottom,\r\n            right: value.model.right,\r\n            sheetName: value.sheetName,\r\n          };\r\n        } else if (value instanceof Array) {\r\n          // an arguments array\r\n          this.decode(value);\r\n        } else if (value.top && value.left && value.bottom && value.right) {\r\n          // a model\r\n          this.model = {\r\n            top: value.top,\r\n            left: value.left,\r\n            bottom: value.bottom,\r\n            right: value.right,\r\n            sheetName: value.sheetName,\r\n          };\r\n        } else {\r\n          // [sheetName!]tl:br\r\n          const tlbr = colCache.decodeEx(value);\r\n          if (tlbr.top) {\r\n            this.model = {\r\n              top: tlbr.top,\r\n              left: tlbr.left,\r\n              bottom: tlbr.bottom,\r\n              right: tlbr.right,\r\n              sheetName: tlbr.sheetName,\r\n            };\r\n          } else {\r\n            this.model = {\r\n              top: tlbr.row,\r\n              left: tlbr.col,\r\n              bottom: tlbr.row,\r\n              right: tlbr.col,\r\n              sheetName: tlbr.sheetName,\r\n            };\r\n          }\r\n        }\r\n        break;\r\n      }\r\n\r\n      case 0:\r\n        this.model = {\r\n          top: 0,\r\n          left: 0,\r\n          bottom: 0,\r\n          right: 0,\r\n        };\r\n        break;\r\n\r\n      default:\r\n        throw new Error(`Invalid number of arguments to _getDimensions() - ${argv.length}`);\r\n    }\r\n  }\r\n\r\n  get top() {\r\n    return this.model.top || 1;\r\n  }\r\n\r\n  set top(value) {\r\n    this.model.top = value;\r\n  }\r\n\r\n  get left() {\r\n    return this.model.left || 1;\r\n  }\r\n\r\n  set left(value) {\r\n    this.model.left = value;\r\n  }\r\n\r\n  get bottom() {\r\n    return this.model.bottom || 1;\r\n  }\r\n\r\n  set bottom(value) {\r\n    this.model.bottom = value;\r\n  }\r\n\r\n  get right() {\r\n    return this.model.right || 1;\r\n  }\r\n\r\n  set right(value) {\r\n    this.model.right = value;\r\n  }\r\n\r\n  get sheetName() {\r\n    return this.model.sheetName;\r\n  }\r\n\r\n  set sheetName(value) {\r\n    this.model.sheetName = value;\r\n  }\r\n\r\n  get _serialisedSheetName() {\r\n    const {sheetName} = this.model;\r\n    if (sheetName) {\r\n      if (/^[a-zA-Z0-9]*$/.test(sheetName)) {\r\n        return `${sheetName}!`;\r\n      }\r\n      return `'${sheetName}'!`;\r\n    }\r\n    return '';\r\n  }\r\n\r\n  expand(top, left, bottom, right) {\r\n    if (!this.model.top || top < this.top) this.top = top;\r\n    if (!this.model.left || left < this.left) this.left = left;\r\n    if (!this.model.bottom || bottom > this.bottom) this.bottom = bottom;\r\n    if (!this.model.right || right > this.right) this.right = right;\r\n  }\r\n\r\n  expandRow(row) {\r\n    if (row) {\r\n      const {dimensions, number} = row;\r\n      if (dimensions) {\r\n        this.expand(number, dimensions.min, number, dimensions.max);\r\n      }\r\n    }\r\n  }\r\n\r\n  expandToAddress(addressStr) {\r\n    const address = colCache.decodeEx(addressStr);\r\n    this.expand(address.row, address.col, address.row, address.col);\r\n  }\r\n\r\n  get tl() {\r\n    return colCache.n2l(this.left) + this.top;\r\n  }\r\n\r\n  get $t$l() {\r\n    return `$${colCache.n2l(this.left)}$${this.top}`;\r\n  }\r\n\r\n  get br() {\r\n    return colCache.n2l(this.right) + this.bottom;\r\n  }\r\n\r\n  get $b$r() {\r\n    return `$${colCache.n2l(this.right)}$${this.bottom}`;\r\n  }\r\n\r\n  get range() {\r\n    return `${this._serialisedSheetName + this.tl}:${this.br}`;\r\n  }\r\n\r\n  get $range() {\r\n    return `${this._serialisedSheetName + this.$t$l}:${this.$b$r}`;\r\n  }\r\n\r\n  get shortRange() {\r\n    return this.count > 1 ? this.range : this._serialisedSheetName + this.tl;\r\n  }\r\n\r\n  get $shortRange() {\r\n    return this.count > 1 ? this.$range : this._serialisedSheetName + this.$t$l;\r\n  }\r\n\r\n  get count() {\r\n    return (1 + this.bottom - this.top) * (1 + this.right - this.left);\r\n  }\r\n\r\n  toString() {\r\n    return this.range;\r\n  }\r\n\r\n  intersects(other) {\r\n    if (other.sheetName && this.sheetName && other.sheetName !== this.sheetName) return false;\r\n    if (other.bottom < this.top) return false;\r\n    if (other.top > this.bottom) return false;\r\n    if (other.right < this.left) return false;\r\n    if (other.left > this.right) return false;\r\n    return true;\r\n  }\r\n\r\n  contains(addressStr) {\r\n    const address = colCache.decodeEx(addressStr);\r\n    return this.containsEx(address);\r\n  }\r\n\r\n  containsEx(address) {\r\n    if (address.sheetName && this.sheetName && address.sheetName !== this.sheetName) return false;\r\n    return (\r\n      address.row >= this.top &&\r\n      address.row <= this.bottom &&\r\n      address.col >= this.left &&\r\n      address.col <= this.right\r\n    );\r\n  }\r\n\r\n  forEachAddress(cb) {\r\n    for (let col = this.left; col <= this.right; col++) {\r\n      for (let row = this.top; row <= this.bottom; row++) {\r\n        cb(colCache.encodeAddress(row, col), row, col);\r\n      }\r\n    }\r\n  }\r\n}\r\n\r\nmodule.exports = Range;\r\n"],"mappings":";;AAAA,MAAMA,QAAQ,GAAGC,OAAO,CAAC,oBAAoB,CAAC;;AAE9C;AACA,MAAMC,KAAK,CAAC;EACVC,WAAWA,CAAA,EAAG;IACZ,IAAI,CAACC,MAAM,CAACC,SAAS,CAAC;EACxB;EAEAC,OAAOA,CAACC,CAAC,EAAEC,CAAC,EAAEC,CAAC,EAAEC,CAAC,EAAEC,CAAC,EAAE;IACrB,IAAIN,SAAS,CAACO,MAAM,GAAG,CAAC,EAAE;MACxB;MACA,MAAMC,EAAE,GAAGb,QAAQ,CAACc,aAAa,CAACP,CAAC,CAAC;MACpC,MAAMQ,EAAE,GAAGf,QAAQ,CAACc,aAAa,CAACN,CAAC,CAAC;MACpC,IAAI,CAACQ,KAAK,GAAG;QACXC,GAAG,EAAEC,IAAI,CAACC,GAAG,CAACN,EAAE,CAACO,GAAG,EAAEL,EAAE,CAACK,GAAG,CAAC;QAC7BC,IAAI,EAAEH,IAAI,CAACC,GAAG,CAACN,EAAE,CAACS,GAAG,EAAEP,EAAE,CAACO,GAAG,CAAC;QAC9BC,MAAM,EAAEL,IAAI,CAACM,GAAG,CAACX,EAAE,CAACO,GAAG,EAAEL,EAAE,CAACK,GAAG,CAAC;QAChCK,KAAK,EAAEP,IAAI,CAACM,GAAG,CAACX,EAAE,CAACS,GAAG,EAAEP,EAAE,CAACO,GAAG,CAAC;QAC/BI,SAAS,EAAEjB;MACb,CAAC;MAED,IAAI,CAACH,OAAO,CAACO,EAAE,CAACO,GAAG,EAAEP,EAAE,CAACS,GAAG,EAAEP,EAAE,CAACK,GAAG,EAAEL,EAAE,CAACO,GAAG,EAAEX,CAAC,CAAC;IACjD,CAAC,MAAM;MACL;MACA,IAAI,CAACK,KAAK,GAAG;QACXC,GAAG,EAAEC,IAAI,CAACC,GAAG,CAACZ,CAAC,EAAEE,CAAC,CAAC;QACnBY,IAAI,EAAEH,IAAI,CAACC,GAAG,CAACX,CAAC,EAAEE,CAAC,CAAC;QACpBa,MAAM,EAAEL,IAAI,CAACM,GAAG,CAACjB,CAAC,EAAEE,CAAC,CAAC;QACtBgB,KAAK,EAAEP,IAAI,CAACM,GAAG,CAAChB,CAAC,EAAEE,CAAC,CAAC;QACrBgB,SAAS,EAAEf;MACb,CAAC;IACH;EACF;EAEAP,MAAMA,CAACuB,IAAI,EAAE;IACX,QAAQA,IAAI,CAACf,MAAM;MACjB,KAAK,CAAC;QAAE;QACN,IAAI,CAACN,OAAO,CAACqB,IAAI,CAAC,CAAC,CAAC,EAAEA,IAAI,CAAC,CAAC,CAAC,EAAEA,IAAI,CAAC,CAAC,CAAC,EAAEA,IAAI,CAAC,CAAC,CAAC,EAAEA,IAAI,CAAC,CAAC,CAAC,CAAC;QACzD;MACF,KAAK,CAAC;QAAE;QACN,IAAI,CAACrB,OAAO,CAACqB,IAAI,CAAC,CAAC,CAAC,EAAEA,IAAI,CAAC,CAAC,CAAC,EAAEA,IAAI,CAAC,CAAC,CAAC,EAAEA,IAAI,CAAC,CAAC,CAAC,CAAC;QAChD;MAEF,KAAK,CAAC;QAAE;QACN,IAAI,CAACrB,OAAO,CAACqB,IAAI,CAAC,CAAC,CAAC,EAAEA,IAAI,CAAC,CAAC,CAAC,EAAEA,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC;MACF,KAAK,CAAC;QAAE;QACN,IAAI,CAACrB,OAAO,CAACqB,IAAI,CAAC,CAAC,CAAC,EAAEA,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B;MAEF,KAAK,CAAC;QAAE;UACN,MAAMC,KAAK,GAAGD,IAAI,CAAC,CAAC,CAAC;UACrB,IAAIC,KAAK,YAAY1B,KAAK,EAAE;YAC1B;YACA,IAAI,CAACc,KAAK,GAAG;cACXC,GAAG,EAAEW,KAAK,CAACZ,KAAK,CAACC,GAAG;cACpBI,IAAI,EAAEO,KAAK,CAACZ,KAAK,CAACK,IAAI;cACtBE,MAAM,EAAEK,KAAK,CAACZ,KAAK,CAACO,MAAM;cAC1BE,KAAK,EAAEG,KAAK,CAACZ,KAAK,CAACS,KAAK;cACxBC,SAAS,EAAEE,KAAK,CAACF;YACnB,CAAC;UACH,CAAC,MAAM,IAAIE,KAAK,YAAYC,KAAK,EAAE;YACjC;YACA,IAAI,CAACzB,MAAM,CAACwB,KAAK,CAAC;UACpB,CAAC,MAAM,IAAIA,KAAK,CAACX,GAAG,IAAIW,KAAK,CAACP,IAAI,IAAIO,KAAK,CAACL,MAAM,IAAIK,KAAK,CAACH,KAAK,EAAE;YACjE;YACA,IAAI,CAACT,KAAK,GAAG;cACXC,GAAG,EAAEW,KAAK,CAACX,GAAG;cACdI,IAAI,EAAEO,KAAK,CAACP,IAAI;cAChBE,MAAM,EAAEK,KAAK,CAACL,MAAM;cACpBE,KAAK,EAAEG,KAAK,CAACH,KAAK;cAClBC,SAAS,EAAEE,KAAK,CAACF;YACnB,CAAC;UACH,CAAC,MAAM;YACL;YACA,MAAMI,IAAI,GAAG9B,QAAQ,CAAC+B,QAAQ,CAACH,KAAK,CAAC;YACrC,IAAIE,IAAI,CAACb,GAAG,EAAE;cACZ,IAAI,CAACD,KAAK,GAAG;gBACXC,GAAG,EAAEa,IAAI,CAACb,GAAG;gBACbI,IAAI,EAAES,IAAI,CAACT,IAAI;gBACfE,MAAM,EAAEO,IAAI,CAACP,MAAM;gBACnBE,KAAK,EAAEK,IAAI,CAACL,KAAK;gBACjBC,SAAS,EAAEI,IAAI,CAACJ;cAClB,CAAC;YACH,CAAC,MAAM;cACL,IAAI,CAACV,KAAK,GAAG;gBACXC,GAAG,EAAEa,IAAI,CAACV,GAAG;gBACbC,IAAI,EAAES,IAAI,CAACR,GAAG;gBACdC,MAAM,EAAEO,IAAI,CAACV,GAAG;gBAChBK,KAAK,EAAEK,IAAI,CAACR,GAAG;gBACfI,SAAS,EAAEI,IAAI,CAACJ;cAClB,CAAC;YACH;UACF;UACA;QACF;MAEA,KAAK,CAAC;QACJ,IAAI,CAACV,KAAK,GAAG;UACXC,GAAG,EAAE,CAAC;UACNI,IAAI,EAAE,CAAC;UACPE,MAAM,EAAE,CAAC;UACTE,KAAK,EAAE;QACT,CAAC;QACD;MAEF;QACE,MAAM,IAAIO,KAAK,CAAC,qDAAqDL,IAAI,CAACf,MAAM,EAAE,CAAC;IACvF;EACF;EAEA,IAAIK,GAAGA,CAAA,EAAG;IACR,OAAO,IAAI,CAACD,KAAK,CAACC,GAAG,IAAI,CAAC;EAC5B;EAEA,IAAIA,GAAGA,CAACW,KAAK,EAAE;IACb,IAAI,CAACZ,KAAK,CAACC,GAAG,GAAGW,KAAK;EACxB;EAEA,IAAIP,IAAIA,CAAA,EAAG;IACT,OAAO,IAAI,CAACL,KAAK,CAACK,IAAI,IAAI,CAAC;EAC7B;EAEA,IAAIA,IAAIA,CAACO,KAAK,EAAE;IACd,IAAI,CAACZ,KAAK,CAACK,IAAI,GAAGO,KAAK;EACzB;EAEA,IAAIL,MAAMA,CAAA,EAAG;IACX,OAAO,IAAI,CAACP,KAAK,CAACO,MAAM,IAAI,CAAC;EAC/B;EAEA,IAAIA,MAAMA,CAACK,KAAK,EAAE;IAChB,IAAI,CAACZ,KAAK,CAACO,MAAM,GAAGK,KAAK;EAC3B;EAEA,IAAIH,KAAKA,CAAA,EAAG;IACV,OAAO,IAAI,CAACT,KAAK,CAACS,KAAK,IAAI,CAAC;EAC9B;EAEA,IAAIA,KAAKA,CAACG,KAAK,EAAE;IACf,IAAI,CAACZ,KAAK,CAACS,KAAK,GAAGG,KAAK;EAC1B;EAEA,IAAIF,SAASA,CAAA,EAAG;IACd,OAAO,IAAI,CAACV,KAAK,CAACU,SAAS;EAC7B;EAEA,IAAIA,SAASA,CAACE,KAAK,EAAE;IACnB,IAAI,CAACZ,KAAK,CAACU,SAAS,GAAGE,KAAK;EAC9B;EAEA,IAAIK,oBAAoBA,CAAA,EAAG;IACzB,MAAM;MAACP;IAAS,CAAC,GAAG,IAAI,CAACV,KAAK;IAC9B,IAAIU,SAAS,EAAE;MACb,IAAI,gBAAgB,CAACQ,IAAI,CAACR,SAAS,CAAC,EAAE;QACpC,OAAO,GAAGA,SAAS,GAAG;MACxB;MACA,OAAO,IAAIA,SAAS,IAAI;IAC1B;IACA,OAAO,EAAE;EACX;EAEAS,MAAMA,CAAClB,GAAG,EAAEI,IAAI,EAAEE,MAAM,EAAEE,KAAK,EAAE;IAC/B,IAAI,CAAC,IAAI,CAACT,KAAK,CAACC,GAAG,IAAIA,GAAG,GAAG,IAAI,CAACA,GAAG,EAAE,IAAI,CAACA,GAAG,GAAGA,GAAG;IACrD,IAAI,CAAC,IAAI,CAACD,KAAK,CAACK,IAAI,IAAIA,IAAI,GAAG,IAAI,CAACA,IAAI,EAAE,IAAI,CAACA,IAAI,GAAGA,IAAI;IAC1D,IAAI,CAAC,IAAI,CAACL,KAAK,CAACO,MAAM,IAAIA,MAAM,GAAG,IAAI,CAACA,MAAM,EAAE,IAAI,CAACA,MAAM,GAAGA,MAAM;IACpE,IAAI,CAAC,IAAI,CAACP,KAAK,CAACS,KAAK,IAAIA,KAAK,GAAG,IAAI,CAACA,KAAK,EAAE,IAAI,CAACA,KAAK,GAAGA,KAAK;EACjE;EAEAW,SAASA,CAAChB,GAAG,EAAE;IACb,IAAIA,GAAG,EAAE;MACP,MAAM;QAACiB,UAAU;QAAEC;MAAM,CAAC,GAAGlB,GAAG;MAChC,IAAIiB,UAAU,EAAE;QACd,IAAI,CAACF,MAAM,CAACG,MAAM,EAAED,UAAU,CAAClB,GAAG,EAAEmB,MAAM,EAAED,UAAU,CAACb,GAAG,CAAC;MAC7D;IACF;EACF;EAEAe,eAAeA,CAACC,UAAU,EAAE;IAC1B,MAAMC,OAAO,GAAGzC,QAAQ,CAAC+B,QAAQ,CAACS,UAAU,CAAC;IAC7C,IAAI,CAACL,MAAM,CAACM,OAAO,CAACrB,GAAG,EAAEqB,OAAO,CAACnB,GAAG,EAAEmB,OAAO,CAACrB,GAAG,EAAEqB,OAAO,CAACnB,GAAG,CAAC;EACjE;EAEA,IAAIT,EAAEA,CAAA,EAAG;IACP,OAAOb,QAAQ,CAAC0C,GAAG,CAAC,IAAI,CAACrB,IAAI,CAAC,GAAG,IAAI,CAACJ,GAAG;EAC3C;EAEA,IAAI0B,IAAIA,CAAA,EAAG;IACT,OAAO,IAAI3C,QAAQ,CAAC0C,GAAG,CAAC,IAAI,CAACrB,IAAI,CAAC,IAAI,IAAI,CAACJ,GAAG,EAAE;EAClD;EAEA,IAAIF,EAAEA,CAAA,EAAG;IACP,OAAOf,QAAQ,CAAC0C,GAAG,CAAC,IAAI,CAACjB,KAAK,CAAC,GAAG,IAAI,CAACF,MAAM;EAC/C;EAEA,IAAIqB,IAAIA,CAAA,EAAG;IACT,OAAO,IAAI5C,QAAQ,CAAC0C,GAAG,CAAC,IAAI,CAACjB,KAAK,CAAC,IAAI,IAAI,CAACF,MAAM,EAAE;EACtD;EAEA,IAAIsB,KAAKA,CAAA,EAAG;IACV,OAAO,GAAG,IAAI,CAACZ,oBAAoB,GAAG,IAAI,CAACpB,EAAE,IAAI,IAAI,CAACE,EAAE,EAAE;EAC5D;EAEA,IAAI+B,MAAMA,CAAA,EAAG;IACX,OAAO,GAAG,IAAI,CAACb,oBAAoB,GAAG,IAAI,CAACU,IAAI,IAAI,IAAI,CAACC,IAAI,EAAE;EAChE;EAEA,IAAIG,UAAUA,CAAA,EAAG;IACf,OAAO,IAAI,CAACC,KAAK,GAAG,CAAC,GAAG,IAAI,CAACH,KAAK,GAAG,IAAI,CAACZ,oBAAoB,GAAG,IAAI,CAACpB,EAAE;EAC1E;EAEA,IAAIoC,WAAWA,CAAA,EAAG;IAChB,OAAO,IAAI,CAACD,KAAK,GAAG,CAAC,GAAG,IAAI,CAACF,MAAM,GAAG,IAAI,CAACb,oBAAoB,GAAG,IAAI,CAACU,IAAI;EAC7E;EAEA,IAAIK,KAAKA,CAAA,EAAG;IACV,OAAO,CAAC,CAAC,GAAG,IAAI,CAACzB,MAAM,GAAG,IAAI,CAACN,GAAG,KAAK,CAAC,GAAG,IAAI,CAACQ,KAAK,GAAG,IAAI,CAACJ,IAAI,CAAC;EACpE;EAEA6B,QAAQA,CAAA,EAAG;IACT,OAAO,IAAI,CAACL,KAAK;EACnB;EAEAM,UAAUA,CAACC,KAAK,EAAE;IAChB,IAAIA,KAAK,CAAC1B,SAAS,IAAI,IAAI,CAACA,SAAS,IAAI0B,KAAK,CAAC1B,SAAS,KAAK,IAAI,CAACA,SAAS,EAAE,OAAO,KAAK;IACzF,IAAI0B,KAAK,CAAC7B,MAAM,GAAG,IAAI,CAACN,GAAG,EAAE,OAAO,KAAK;IACzC,IAAImC,KAAK,CAACnC,GAAG,GAAG,IAAI,CAACM,MAAM,EAAE,OAAO,KAAK;IACzC,IAAI6B,KAAK,CAAC3B,KAAK,GAAG,IAAI,CAACJ,IAAI,EAAE,OAAO,KAAK;IACzC,IAAI+B,KAAK,CAAC/B,IAAI,GAAG,IAAI,CAACI,KAAK,EAAE,OAAO,KAAK;IACzC,OAAO,IAAI;EACb;EAEA4B,QAAQA,CAACb,UAAU,EAAE;IACnB,MAAMC,OAAO,GAAGzC,QAAQ,CAAC+B,QAAQ,CAACS,UAAU,CAAC;IAC7C,OAAO,IAAI,CAACc,UAAU,CAACb,OAAO,CAAC;EACjC;EAEAa,UAAUA,CAACb,OAAO,EAAE;IAClB,IAAIA,OAAO,CAACf,SAAS,IAAI,IAAI,CAACA,SAAS,IAAIe,OAAO,CAACf,SAAS,KAAK,IAAI,CAACA,SAAS,EAAE,OAAO,KAAK;IAC7F,OACEe,OAAO,CAACrB,GAAG,IAAI,IAAI,CAACH,GAAG,IACvBwB,OAAO,CAACrB,GAAG,IAAI,IAAI,CAACG,MAAM,IAC1BkB,OAAO,CAACnB,GAAG,IAAI,IAAI,CAACD,IAAI,IACxBoB,OAAO,CAACnB,GAAG,IAAI,IAAI,CAACG,KAAK;EAE7B;EAEA8B,cAAcA,CAACC,EAAE,EAAE;IACjB,KAAK,IAAIlC,GAAG,GAAG,IAAI,CAACD,IAAI,EAAEC,GAAG,IAAI,IAAI,CAACG,KAAK,EAAEH,GAAG,EAAE,EAAE;MAClD,KAAK,IAAIF,GAAG,GAAG,IAAI,CAACH,GAAG,EAAEG,GAAG,IAAI,IAAI,CAACG,MAAM,EAAEH,GAAG,EAAE,EAAE;QAClDoC,EAAE,CAACxD,QAAQ,CAACyD,aAAa,CAACrC,GAAG,EAAEE,GAAG,CAAC,EAAEF,GAAG,EAAEE,GAAG,CAAC;MAChD;IACF;EACF;AACF;AAEAoC,MAAM,CAACC,OAAO,GAAGzD,KAAK","ignoreList":[]}