@hrforte/react-pivottable 1.1.0 → 2.0.0

package/dist/pivotCompute.js

@@ -0,0 +1,274 @@
+'use strict';
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.WORKER_DEBOUNCE_MS = exports.DEFAULT_WORKER_THRESHOLD = exports.PROGRESS_BATCH_SIZE = undefined;
+
+var _typeof = typeof Symbol === "function" && typeof Symbol.iterator === "symbol" ? function (obj) { return typeof obj; } : function (obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; /* eslint-disable valid-jsdoc */
+/*
+ * Shared pivot-computation logic.
+ *
+ * This module contains the pure, DOM-free parts of the pivot computation so
+ * that the exact same code paths can run:
+ *   - on the main thread (classic synchronous rendering path), and
+ *   - inside a Web Worker (src/pivotWorker.js) for large datasets.
+ *
+ * It must stay free of React and of any `window`/`document` references.
+ */
+
+
+exports.materializeData = materializeData;
+exports.computePivotState = computePivotState;
+exports.serializePivotData = serializePivotData;
+exports.sortersHaveFunctions = sortersHaveFunctions;
+exports.sanitizeSorters = sanitizeSorters;
+exports.createWorkerConfig = createWorkerConfig;
+exports.createComputeSignature = createComputeSignature;
+exports.canComputeInWorker = canComputeInWorker;
+
+var _Utilities = require('./Utilities');
+
+// A progress callback fires every N processed records so the UI can render
+// progress without adding measurable overhead to the per-record loop.
+var PROGRESS_BATCH_SIZE = exports.PROGRESS_BATCH_SIZE = 20000;
+
+// Datasets smaller than this are computed synchronously on the main thread;
+// larger ones are handed off to the Web Worker.
+var DEFAULT_WORKER_THRESHOLD = exports.DEFAULT_WORKER_THRESHOLD = 10000;
+
+// Trailing debounce before a worker computation is dispatched, so rapid
+// interactions do not queue one full computation per single change.
+var WORKER_DEBOUNCE_MS = exports.WORKER_DEBOUNCE_MS = 200;
+
+/*
+ * Walks the raw input once and computes the attribute-value inventory plus a
+ * "materialized" copy of the records (with derived attributes applied).
+ * This is an exact extraction of the historical PivotTableUI behavior.
+ *
+ * onProgress receives (processed, total, phase); total is null when it is
+ * unknown upfront (function-based data sources).
+ */
+function materializeData(data, derivedAttributes, onProgress) {
+  var attrValues = {};
+  var materializedInput = [];
+  var total = Array.isArray(data) ? data.length : null;
+  var recordsProcessed = 0;
+  _Utilities.PivotData.forEachRecord(data, derivedAttributes || {}, function (record) {
+    materializedInput.push(record);
+    var _iteratorNormalCompletion = true;
+    var _didIteratorError = false;
+    var _iteratorError = undefined;
+
+    try {
+      for (var _iterator = Object.keys(record)[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true) {
+        var attr = _step.value;
+
+        if (!(attr in attrValues)) {
+          attrValues[attr] = {};
+          if (recordsProcessed > 0) {
+            attrValues[attr].null = recordsProcessed;
+          }
+        }
+      }
+    } catch (err) {
+      _didIteratorError = true;
+      _iteratorError = err;
+    } finally {
+      try {
+        if (!_iteratorNormalCompletion && _iterator.return) {
+          _iterator.return();
+        }
+      } finally {
+        if (_didIteratorError) {
+          throw _iteratorError;
+        }
+      }
+    }
+
+    for (var _attr in attrValues) {
+      var value = _attr in record ? record[_attr] : 'null';
+      if (!(value in attrValues[_attr])) {
+        attrValues[_attr][value] = 0;
+      }
+      attrValues[_attr][value]++;
+    }
+    recordsProcessed++;
+    if (onProgress && recordsProcessed % PROGRESS_BATCH_SIZE === 0) {
+      onProgress(recordsProcessed, total, 'materialize');
+    }
+  });
+  return { attrValues: attrValues, materializedInput: materializedInput, totalRecords: recordsProcessed };
+}
+
+/*
+ * Aggregates an already-materialized dataset into a PivotData instance and
+ * serializes the result into a plain (structured-cloneable) object that can
+ * cross the worker boundary and later hydrate PivotData on the main thread.
+ */
+function computePivotState(materialized, config, onProgress) {
+  var total = materialized.totalRecords;
+  var pivotData = new _Utilities.PivotData(Object.assign({}, config, {
+    data: materialized.materializedInput,
+    derivedAttributes: {},
+    onRecordProcessed: function onRecordProcessed(processed) {
+      if (onProgress) {
+        onProgress(processed, total, 'aggregate');
+      }
+    }
+  }));
+  // Force key sorting to happen while we are (possibly) inside the worker.
+  pivotData.getRowKeys();
+  pivotData.getColKeys();
+  return serializePivotData(pivotData, materialized);
+}
+
+/*
+ * Serializes a fully-built PivotData instance into plain data. Only the final
+ * aggregated value of every cell is kept; `value()` and `format()` behavior
+ * are reconstructed on the main thread by the PivotData hydration step.
+ */
+function serializePivotData(pivotData, materialized) {
+  var serializeCell = function serializeCell(cell) {
+    var values = {};
+    pivotData.aggregations.forEach(function (agg) {
+      var instance = cell.getInstance(agg.key);
+      if (instance) {
+        values[agg.key] = instance.value();
+      }
+    });
+    return { values: values };
+  };
+
+  var tree = {};
+  Object.keys(pivotData.tree).forEach(function (flatRowKey) {
+    var rowBranch = pivotData.tree[flatRowKey];
+    var serializedRow = {};
+    Object.keys(rowBranch).forEach(function (flatColKey) {
+      serializedRow[flatColKey] = serializeCell(rowBranch[flatColKey]);
+    });
+    tree[flatRowKey] = serializedRow;
+  });
+
+  var serializeTotals = function serializeTotals(totals) {
+    var serialized = {};
+    Object.keys(totals).forEach(function (flatKey) {
+      serialized[flatKey] = serializeCell(totals[flatKey]);
+    });
+    return serialized;
+  };
+
+  return {
+    rowKeys: pivotData.rowKeys.map(function (key) {
+      return key.slice();
+    }),
+    colKeys: pivotData.colKeys.map(function (key) {
+      return key.slice();
+    }),
+    tree: tree,
+    rowTotals: serializeTotals(pivotData.rowTotals),
+    colTotals: serializeTotals(pivotData.colTotals),
+    allTotal: serializeCell(pivotData.allTotal),
+    aggregations: pivotData.aggregations.map(function (agg) {
+      return Object.assign({}, agg);
+    }),
+    attrValues: materialized.attrValues,
+    materializedInput: materialized.materializedInput,
+    totalRecords: materialized.totalRecords
+  };
+}
+
+/*
+ * Sorters containing functions cannot be structured-cloned into a worker.
+ * Returns true when the sorters prop itself, or any of its entries, is a
+ * function. In that case PivotData re-sorts on the main thread after
+ * hydration (distinct keys are few, so this stays cheap).
+ */
+function sortersHaveFunctions(sorters) {
+  if (typeof sorters === 'function') {
+    return true;
+  }
+  if (!sorters || (typeof sorters === 'undefined' ? 'undefined' : _typeof(sorters)) !== 'object') {
+    return false;
+  }
+  return Object.keys(sorters).some(function (attr) {
+    return typeof sorters[attr] === 'function';
+  });
+}
+
+/*
+ * Returns a structured-cloneable subset of the sorters prop: data-type names
+ * and sample-value arrays survive the worker boundary, functions do not.
+ */
+function sanitizeSorters(sorters) {
+  if (!sorters || (typeof sorters === 'undefined' ? 'undefined' : _typeof(sorters)) !== 'object' || typeof sorters === 'function') {
+    return {};
+  }
+  var clean = {};
+  Object.keys(sorters).forEach(function (attr) {
+    var sorter = sorters[attr];
+    if (typeof sorter === 'string' || Array.isArray(sorter)) {
+      clean[attr] = sorter;
+    }
+  });
+  return clean;
+}
+
+/*
+ * Extracts exactly the props PivotData needs to compute results, with
+ * everything non-serializable stripped, so the object can be posted to the
+ * worker and fed straight into PivotData.
+ */
+function createWorkerConfig(props) {
+  return {
+    rows: props.rows,
+    cols: props.cols,
+    aggregatorName: props.aggregatorName,
+    aggregations: props.aggregations,
+    vals: props.vals,
+    valueFilter: props.valueFilter,
+    sorters: sanitizeSorters(props.sorters),
+    rowOrder: props.rowOrder,
+    colOrder: props.colOrder,
+    rowSorts: props.rowSorts,
+    colSorts: props.colSorts
+  };
+}
+
+/*
+ * Stable string signature of everything that influences a worker computation.
+ * Data identity is NOT part of it; callers append their own data version.
+ */
+function createComputeSignature(props) {
+  return JSON.stringify(createWorkerConfig(props));
+}
+
+/*
+ * Decides whether the current props can be computed inside the Web Worker.
+ * Anything that cannot be structured-cloned (function data sources, custom
+ * derivedAttributes, custom aggregator maps) forces the classic path.
+ * Function-based sorters are allowed: they are re-applied on the main thread.
+ */
+function canComputeInWorker(props) {
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+
+  if (options.enabled === false) {
+    return false;
+  }
+  if (typeof Worker === 'undefined') {
+    return false;
+  }
+  var threshold = typeof options.threshold === 'number' ? options.threshold : DEFAULT_WORKER_THRESHOLD;
+  var data = props.data;
+  if (!Array.isArray(data) || data.length < threshold) {
+    return false;
+  }
+  if (props.derivedAttributes && Object.keys(props.derivedAttributes).length > 0) {
+    return false;
+  }
+  if (props.aggregators !== _Utilities.PivotData.defaultProps.aggregators) {
+    return false;
+  }
+  return true;
+}
+//# sourceMappingURL=pivotCompute.js.map

package/dist/pivotCompute.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pivotCompute.js"],"names":["materializeData","computePivotState","serializePivotData","sortersHaveFunctions","sanitizeSorters","createWorkerConfig","createComputeSignature","canComputeInWorker","PROGRESS_BATCH_SIZE","DEFAULT_WORKER_THRESHOLD","WORKER_DEBOUNCE_MS","data","derivedAttributes","onProgress","attrValues","materializedInput","total","Array","isArray","length","recordsProcessed","PivotData","forEachRecord","record","push","Object","keys","attr","null","value","totalRecords","materialized","config","pivotData","assign","onRecordProcessed","processed","getRowKeys","getColKeys","serializeCell","values","aggregations","forEach","instance","cell","getInstance","agg","key","tree","rowBranch","flatRowKey","serializedRow","flatColKey","serializeTotals","serialized","totals","flatKey","rowKeys","map","slice","colKeys","rowTotals","colTotals","allTotal","sorters","some","clean","sorter","props","rows","cols","aggregatorName","vals","valueFilter","rowOrder","colOrder","rowSorts","colSorts","JSON","stringify","options","enabled","Worker","threshold","aggregators","defaultProps"],"mappings":"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","file":"pivotCompute.js","sourcesContent":["/* eslint-disable valid-jsdoc */\n/*\n * Shared pivot-computation logic.\n *\n * This module contains the pure, DOM-free parts of the pivot computation so\n * that the exact same code paths can run:\n *   - on the main thread (classic synchronous rendering path), and\n *   - inside a Web Worker (src/pivotWorker.js) for large datasets.\n *\n * It must stay free of React and of any `window`/`document` references.\n */\nimport {PivotData} from './Utilities';\n\n// A progress callback fires every N processed records so the UI can render\n// progress without adding measurable overhead to the per-record loop.\nexport const PROGRESS_BATCH_SIZE = 20000;\n\n// Datasets smaller than this are computed synchronously on the main thread;\n// larger ones are handed off to the Web Worker.\nexport const DEFAULT_WORKER_THRESHOLD = 10000;\n\n// Trailing debounce before a worker computation is dispatched, so rapid\n// interactions do not queue one full computation per single change.\nexport const WORKER_DEBOUNCE_MS = 200;\n\n/*\n * Walks the raw input once and computes the attribute-value inventory plus a\n * \"materialized\" copy of the records (with derived attributes applied).\n * This is an exact extraction of the historical PivotTableUI behavior.\n *\n * onProgress receives (processed, total, phase); total is null when it is\n * unknown upfront (function-based data sources).\n */\nexport function materializeData(data, derivedAttributes, onProgress) {\n  const attrValues = {};\n  const materializedInput = [];\n  const total = Array.isArray(data) ? data.length : null;\n  let recordsProcessed = 0;\n  PivotData.forEachRecord(data, derivedAttributes || {}, function(record) {\n    materializedInput.push(record);\n    for (const attr of Object.keys(record)) {\n      if (!(attr in attrValues)) {\n        attrValues[attr] = {};\n        if (recordsProcessed > 0) {\n          attrValues[attr].null = recordsProcessed;\n        }\n      }\n    }\n    for (const attr in attrValues) {\n      const value = attr in record ? record[attr] : 'null';\n      if (!(value in attrValues[attr])) {\n        attrValues[attr][value] = 0;\n      }\n      attrValues[attr][value]++;\n    }\n    recordsProcessed++;\n    if (onProgress && recordsProcessed % PROGRESS_BATCH_SIZE === 0) {\n      onProgress(recordsProcessed, total, 'materialize');\n    }\n  });\n  return {attrValues, materializedInput, totalRecords: recordsProcessed};\n}\n\n/*\n * Aggregates an already-materialized dataset into a PivotData instance and\n * serializes the result into a plain (structured-cloneable) object that can\n * cross the worker boundary and later hydrate PivotData on the main thread.\n */\nexport function computePivotState(materialized, config, onProgress) {\n  const total = materialized.totalRecords;\n  const pivotData = new PivotData(\n    Object.assign({}, config, {\n      data: materialized.materializedInput,\n      derivedAttributes: {},\n      onRecordProcessed: processed => {\n        if (onProgress) {\n          onProgress(processed, total, 'aggregate');\n        }\n      },\n    })\n  );\n  // Force key sorting to happen while we are (possibly) inside the worker.\n  pivotData.getRowKeys();\n  pivotData.getColKeys();\n  return serializePivotData(pivotData, materialized);\n}\n\n/*\n * Serializes a fully-built PivotData instance into plain data. Only the final\n * aggregated value of every cell is kept; `value()` and `format()` behavior\n * are reconstructed on the main thread by the PivotData hydration step.\n */\nexport function serializePivotData(pivotData, materialized) {\n  const serializeCell = cell => {\n    const values = {};\n    pivotData.aggregations.forEach(agg => {\n      const instance = cell.getInstance(agg.key);\n      if (instance) {\n        values[agg.key] = instance.value();\n      }\n    });\n    return {values};\n  };\n\n  const tree = {};\n  Object.keys(pivotData.tree).forEach(flatRowKey => {\n    const rowBranch = pivotData.tree[flatRowKey];\n    const serializedRow = {};\n    Object.keys(rowBranch).forEach(flatColKey => {\n      serializedRow[flatColKey] = serializeCell(rowBranch[flatColKey]);\n    });\n    tree[flatRowKey] = serializedRow;\n  });\n\n  const serializeTotals = totals => {\n    const serialized = {};\n    Object.keys(totals).forEach(flatKey => {\n      serialized[flatKey] = serializeCell(totals[flatKey]);\n    });\n    return serialized;\n  };\n\n  return {\n    rowKeys: pivotData.rowKeys.map(key => key.slice()),\n    colKeys: pivotData.colKeys.map(key => key.slice()),\n    tree,\n    rowTotals: serializeTotals(pivotData.rowTotals),\n    colTotals: serializeTotals(pivotData.colTotals),\n    allTotal: serializeCell(pivotData.allTotal),\n    aggregations: pivotData.aggregations.map(agg => Object.assign({}, agg)),\n    attrValues: materialized.attrValues,\n    materializedInput: materialized.materializedInput,\n    totalRecords: materialized.totalRecords,\n  };\n}\n\n/*\n * Sorters containing functions cannot be structured-cloned into a worker.\n * Returns true when the sorters prop itself, or any of its entries, is a\n * function. In that case PivotData re-sorts on the main thread after\n * hydration (distinct keys are few, so this stays cheap).\n */\nexport function sortersHaveFunctions(sorters) {\n  if (typeof sorters === 'function') {\n    return true;\n  }\n  if (!sorters || typeof sorters !== 'object') {\n    return false;\n  }\n  return Object.keys(sorters).some(attr => typeof sorters[attr] === 'function');\n}\n\n/*\n * Returns a structured-cloneable subset of the sorters prop: data-type names\n * and sample-value arrays survive the worker boundary, functions do not.\n */\nexport function sanitizeSorters(sorters) {\n  if (\n    !sorters ||\n    typeof sorters !== 'object' ||\n    typeof sorters === 'function'\n  ) {\n    return {};\n  }\n  const clean = {};\n  Object.keys(sorters).forEach(attr => {\n    const sorter = sorters[attr];\n    if (typeof sorter === 'string' || Array.isArray(sorter)) {\n      clean[attr] = sorter;\n    }\n  });\n  return clean;\n}\n\n/*\n * Extracts exactly the props PivotData needs to compute results, with\n * everything non-serializable stripped, so the object can be posted to the\n * worker and fed straight into PivotData.\n */\nexport function createWorkerConfig(props) {\n  return {\n    rows: props.rows,\n    cols: props.cols,\n    aggregatorName: props.aggregatorName,\n    aggregations: props.aggregations,\n    vals: props.vals,\n    valueFilter: props.valueFilter,\n    sorters: sanitizeSorters(props.sorters),\n    rowOrder: props.rowOrder,\n    colOrder: props.colOrder,\n    rowSorts: props.rowSorts,\n    colSorts: props.colSorts,\n  };\n}\n\n/*\n * Stable string signature of everything that influences a worker computation.\n * Data identity is NOT part of it; callers append their own data version.\n */\nexport function createComputeSignature(props) {\n  return JSON.stringify(createWorkerConfig(props));\n}\n\n/*\n * Decides whether the current props can be computed inside the Web Worker.\n * Anything that cannot be structured-cloned (function data sources, custom\n * derivedAttributes, custom aggregator maps) forces the classic path.\n * Function-based sorters are allowed: they are re-applied on the main thread.\n */\nexport function canComputeInWorker(props, options = {}) {\n  if (options.enabled === false) {\n    return false;\n  }\n  if (typeof Worker === 'undefined') {\n    return false;\n  }\n  const threshold =\n    typeof options.threshold === 'number'\n      ? options.threshold\n      : DEFAULT_WORKER_THRESHOLD;\n  const data = props.data;\n  if (!Array.isArray(data) || data.length < threshold) {\n    return false;\n  }\n  if (\n    props.derivedAttributes &&\n    Object.keys(props.derivedAttributes).length > 0\n  ) {\n    return false;\n  }\n  if (props.aggregators !== PivotData.defaultProps.aggregators) {\n    return false;\n  }\n  return true;\n}\n"]}

package/dist/pivotWorker.js

@@ -0,0 +1,91 @@
+'use strict';
+
+var _pivotCompute = require('./pivotCompute');
+
+var MAX_CACHED_DATASETS = 4; /* eslint-disable valid-jsdoc */
+/*
+ * Web Worker entry point for off-main-thread pivot computation.
+ *
+ * Message protocol (plain, structured-cloneable objects):
+ *   main -> worker   {type: 'pivot:setData',  id, dataKey, data}
+ *   main -> worker   {type: 'pivot:compute',  id, dataKey, config}
+ *   worker -> main   {type: 'pivot:progress', id, processed, total, phase}
+ *   worker -> main   {type: 'pivot:result',   id, result}
+ *   worker -> main   {type: 'pivot:error',    id, message}
+ *
+ * The materialized dataset is cached per dataKey, so repeated computations on
+ * the same data (e.g. dragging fields around) do not pay the cost of
+ * re-scanning the raw records.
+ */
+
+
+var datasetCache = new Map();
+
+var cacheDataset = function cacheDataset(dataKey, dataset) {
+  datasetCache.delete(dataKey);
+  datasetCache.set(dataKey, dataset);
+  while (datasetCache.size > MAX_CACHED_DATASETS) {
+    var oldestKey = datasetCache.keys().next().value;
+    datasetCache.delete(oldestKey);
+  }
+  return dataset;
+};
+
+var postToMain = function postToMain(message) {
+  self.postMessage(message);
+};
+
+var toErrorMessage = function toErrorMessage(error) {
+  return String(error && error.message || error);
+};
+
+self.addEventListener('message', function (event) {
+  var message = event.data || {};
+
+  if (message.type === 'pivot:setData') {
+    try {
+      cacheDataset(message.dataKey, (0, _pivotCompute.materializeData)(message.data, {}, function (processed, total) {
+        postToMain({
+          type: 'pivot:progress',
+          id: message.id,
+          processed: processed,
+          total: total,
+          phase: 'materialize'
+        });
+      }));
+    } catch (error) {
+      postToMain({
+        type: 'pivot:error',
+        id: message.id,
+        message: toErrorMessage(error)
+      });
+    }
+    return;
+  }
+
+  if (message.type === 'pivot:compute') {
+    try {
+      var dataset = datasetCache.get(message.dataKey);
+      if (!dataset) {
+        throw new Error('no dataset staged for key ' + message.dataKey);
+      }
+      var result = (0, _pivotCompute.computePivotState)(dataset, message.config, function (processed, total, phase) {
+        postToMain({
+          type: 'pivot:progress',
+          id: message.id,
+          processed: processed,
+          total: total,
+          phase: phase
+        });
+      });
+      postToMain({ type: 'pivot:result', id: message.id, result: result });
+    } catch (error) {
+      postToMain({
+        type: 'pivot:error',
+        id: message.id,
+        message: toErrorMessage(error)
+      });
+    }
+  }
+});
+//# sourceMappingURL=pivotWorker.js.map

package/dist/pivotWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pivotWorker.js"],"names":["MAX_CACHED_DATASETS","datasetCache","Map","cacheDataset","dataKey","dataset","delete","set","size","oldestKey","keys","next","value","postToMain","self","postMessage","message","toErrorMessage","String","error","addEventListener","event","data","type","processed","total","id","phase","get","Error","result","config"],"mappings":";;AAeA;;AAEA,IAAMA,sBAAsB,CAA5B,C,CAjBA;AACA;;;;;;;;;;;;;;;;AAkBA,IAAMC,eAAe,IAAIC,GAAJ,EAArB;;AAEA,IAAMC,eAAe,SAAfA,YAAe,CAACC,OAAD,EAAUC,OAAV,EAAsB;AACzCJ,eAAaK,MAAb,CAAoBF,OAApB;AACAH,eAAaM,GAAb,CAAiBH,OAAjB,EAA0BC,OAA1B;AACA,SAAOJ,aAAaO,IAAb,GAAoBR,mBAA3B,EAAgD;AAC9C,QAAMS,YAAYR,aAAaS,IAAb,GAAoBC,IAApB,GAA2BC,KAA7C;AACAX,iBAAaK,MAAb,CAAoBG,SAApB;AACD;AACD,SAAOJ,OAAP;AACD,CARD;;AAUA,IAAMQ,aAAa,SAAbA,UAAa,UAAW;AAC5BC,OAAKC,WAAL,CAAiBC,OAAjB;AACD,CAFD;;AAIA,IAAMC,iBAAiB,SAAjBA,cAAiB;AAAA,SAASC,OAAQC,SAASA,MAAMH,OAAhB,IAA4BG,KAAnC,CAAT;AAAA,CAAvB;;AAEAL,KAAKM,gBAAL,CAAsB,SAAtB,EAAiC,iBAAS;AACxC,MAAMJ,UAAUK,MAAMC,IAAN,IAAc,EAA9B;;AAEA,MAAIN,QAAQO,IAAR,KAAiB,eAArB,EAAsC;AACpC,QAAI;AACFpB,mBACEa,QAAQZ,OADV,EAEE,mCAAgBY,QAAQM,IAAxB,EAA8B,EAA9B,EAAkC,UAACE,SAAD,EAAYC,KAAZ,EAAsB;AACtDZ,mBAAW;AACTU,gBAAM,gBADG;AAETG,cAAIV,QAAQU,EAFH;AAGTF,8BAHS;AAITC,sBAJS;AAKTE,iBAAO;AALE,SAAX;AAOD,OARD,CAFF;AAYD,KAbD,CAaE,OAAOR,KAAP,EAAc;AACdN,iBAAW;AACTU,cAAM,aADG;AAETG,YAAIV,QAAQU,EAFH;AAGTV,iBAASC,eAAeE,KAAf;AAHA,OAAX;AAKD;AACD;AACD;;AAED,MAAIH,QAAQO,IAAR,KAAiB,eAArB,EAAsC;AACpC,QAAI;AACF,UAAMlB,UAAUJ,aAAa2B,GAAb,CAAiBZ,QAAQZ,OAAzB,CAAhB;AACA,UAAI,CAACC,OAAL,EAAc;AACZ,cAAM,IAAIwB,KAAJ,gCAAuCb,QAAQZ,OAA/C,CAAN;AACD;AACD,UAAM0B,SAAS,qCACbzB,OADa,EAEbW,QAAQe,MAFK,EAGb,UAACP,SAAD,EAAYC,KAAZ,EAAmBE,KAAnB,EAA6B;AAC3Bd,mBAAW;AACTU,gBAAM,gBADG;AAETG,cAAIV,QAAQU,EAFH;AAGTF,8BAHS;AAITC,sBAJS;AAKTE;AALS,SAAX;AAOD,OAXY,CAAf;AAaAd,iBAAW,EAACU,MAAM,cAAP,EAAuBG,IAAIV,QAAQU,EAAnC,EAAuCI,cAAvC,EAAX;AACD,KAnBD,CAmBE,OAAOX,KAAP,EAAc;AACdN,iBAAW;AACTU,cAAM,aADG;AAETG,YAAIV,QAAQU,EAFH;AAGTV,iBAASC,eAAeE,KAAf;AAHA,OAAX;AAKD;AACF;AACF,CAvDD","file":"pivotWorker.js","sourcesContent":["/* eslint-disable valid-jsdoc */\n/*\n * Web Worker entry point for off-main-thread pivot computation.\n *\n * Message protocol (plain, structured-cloneable objects):\n *   main -> worker   {type: 'pivot:setData',  id, dataKey, data}\n *   main -> worker   {type: 'pivot:compute',  id, dataKey, config}\n *   worker -> main   {type: 'pivot:progress', id, processed, total, phase}\n *   worker -> main   {type: 'pivot:result',   id, result}\n *   worker -> main   {type: 'pivot:error',    id, message}\n *\n * The materialized dataset is cached per dataKey, so repeated computations on\n * the same data (e.g. dragging fields around) do not pay the cost of\n * re-scanning the raw records.\n */\nimport {materializeData, computePivotState} from './pivotCompute';\n\nconst MAX_CACHED_DATASETS = 4;\n\nconst datasetCache = new Map();\n\nconst cacheDataset = (dataKey, dataset) => {\n  datasetCache.delete(dataKey);\n  datasetCache.set(dataKey, dataset);\n  while (datasetCache.size > MAX_CACHED_DATASETS) {\n    const oldestKey = datasetCache.keys().next().value;\n    datasetCache.delete(oldestKey);\n  }\n  return dataset;\n};\n\nconst postToMain = message => {\n  self.postMessage(message);\n};\n\nconst toErrorMessage = error => String((error && error.message) || error);\n\nself.addEventListener('message', event => {\n  const message = event.data || {};\n\n  if (message.type === 'pivot:setData') {\n    try {\n      cacheDataset(\n        message.dataKey,\n        materializeData(message.data, {}, (processed, total) => {\n          postToMain({\n            type: 'pivot:progress',\n            id: message.id,\n            processed,\n            total,\n            phase: 'materialize',\n          });\n        })\n      );\n    } catch (error) {\n      postToMain({\n        type: 'pivot:error',\n        id: message.id,\n        message: toErrorMessage(error),\n      });\n    }\n    return;\n  }\n\n  if (message.type === 'pivot:compute') {\n    try {\n      const dataset = datasetCache.get(message.dataKey);\n      if (!dataset) {\n        throw new Error(`no dataset staged for key ${message.dataKey}`);\n      }\n      const result = computePivotState(\n        dataset,\n        message.config,\n        (processed, total, phase) => {\n          postToMain({\n            type: 'pivot:progress',\n            id: message.id,\n            processed,\n            total,\n            phase,\n          });\n        }\n      );\n      postToMain({type: 'pivot:result', id: message.id, result});\n    } catch (error) {\n      postToMain({\n        type: 'pivot:error',\n        id: message.id,\n        message: toErrorMessage(error),\n      });\n    }\n  }\n});\n"]}

package/dist/pivottable.css

@@ -375,3 +375,77 @@ table.pvtTable tbody tr td {
 .pvtAxisLabel:hover .pvtSortButton {
     opacity: 1;
 }
+
+/* ===== Web Worker loading overlay ===== */
+
+.pvtOutput {
+    position: relative;
+    min-height: 220px;
+}
+
+.pvtLoadingOverlay {
+    position: absolute;
+    top: 0;
+    left: 0;
+    right: 0;
+    bottom: 0;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: 10px;
+    background: rgba(255, 255, 255, 0.85);
+    z-index: 20;
+    cursor: wait;
+    font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif;
+}
+
+.pvtOutputPlaceholder {
+    min-height: 220px;
+}
+
+.pvtLoadingSpinner {
+    width: 36px;
+    height: 36px;
+    border: 4px solid #ffeeee;
+    border-top-color: #ff6600;
+    border-radius: 50%;
+    animation: pvtLoadingSpin 0.9s linear infinite;
+}
+
+@keyframes pvtLoadingSpin {
+    to {
+        transform: rotate(360deg);
+    }
+}
+
+.pvtLoadingText {
+    font-size: 14px;
+    color: #333;
+}
+
+.pvtLoadingBarWrap {
+    width: 240px;
+    height: 8px;
+    background: #ffeeee;
+    border-radius: 4px;
+    overflow: hidden;
+}
+
+.pvtLoadingBar {
+    height: 100%;
+    background: #ff6600;
+    transition: width 0.2s ease;
+}
+
+.pvtLoadingPercent {
+    font-size: 12px;
+    font-weight: 600;
+    color: #ff6600;
+}
+
+.pvtComputeError {
+    padding: 20px;
+    color: #8b0000;
+    text-align: center;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hrforte/react-pivottable",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "publishConfig": {
     "access": "public"
   },
@@ -10,7 +10,8 @@
     "dist"
   ],
   "scripts": {
-    "start": "webpack-dev-server",
+    "start": "npm run build:worker && webpack-dev-server",
+    "build:worker": "webpack --config webpack.worker.config.js",
     "test:eslint": "eslint src/*.js* && echo 'eslint: \\033[0;32m'PASS'\\033[0m'",
     "test:eslint:fix": "eslint src/*.js* --fix",
     "test:prettier": "prettier -l \"src/*.js*\" && echo 'prettier: \\033[0;32m'PASS'\\033[0m'",
@@ -18,7 +19,7 @@
     "test:jest": "jest",
     "test": "npm run test:eslint && npm run test:prettier && npm run test:jest",
     "clean": "rm -rf __tests__ PivotTable.js* PivotTableUI.js* PlotlyRenderers.js* TableRenderers.js* Utilities.js* pivottable.css",
-    "build": "npm run clean && mkdir -p dist && cp src/pivottable.css dist/ && babel src --out-dir=dist --source-maps --presets=env,react --plugins babel-plugin-add-module-exports",
+    "build": "npm run clean && mkdir -p dist && cp src/pivottable.css dist/ && babel src --out-dir=dist --source-maps --presets=env,react --plugins babel-plugin-add-module-exports && PIVOT_WORKER_OUT=dist npm run build:worker",
     "doPublish": "npm run build && npm publish",
     "postpublish": "npm run clean",
     "deploy": "webpack -p && mv bundle.js examples && cd examples && git init && git add . && git commit -m build && git push --force git@github.com:plotly/react-pivottable.git master:gh-pages && rm -rf .git bundle.js"