@hrforte/react-pivottable 2.1.2 → 2.2.0

package/README.md

@@ -122,7 +122,7 @@ but the main thread is used. Verify with `workerDebug`:
 - `workerUrl` (`string`, default `'pivot-worker.js'`): URL of the worker bundle
   (see above).
 - `workerDebug` (`bool`, default `false`): prints the whole worker pipeline
-  (worker creation, data staging, progress, compute, result, errors and the
+  (worker creation, data staging, compute, result, errors and the
   fallback to the main thread) to the browser console with a
   `[pivottable worker]` prefix. Logs emitted inside the worker thread are
   forwarded to the page console as well. Can also be enabled globally with
@@ -130,5 +130,7 @@ but the main thread is used. Verify with `workerDebug`:
 - `isShowProcessing` (`bool`, default `false`): testing/debugging hook. When
   `true` the loading overlay is forced on top of the table even if nothing is
   being computed, so the `PivotLoadingOverlay` can be inspected without
-  generating a large dataset. A sample progress value is supplied so the
-  progress bar and percentage are rendered as well.
+  generating a large dataset. The overlay shows only a spinner and a label;
+  during real computations it is turned off only after the worker has posted
+  its result event **and** PivotTableUI has rendered the new table (the
+  removal happens before the browser paints, so no empty frame is shown).

package/dist/PivotDataWorker.js

@@ -20,7 +20,7 @@ var DEFAULT_WORKER_URL = exports.DEFAULT_WORKER_URL = 'pivot-worker.js'; /* esli
  *
  * Responsibilities:
  *   - lazily create a single shared Worker (at `workerUrl`, overrideable),
- *   - route progress/result/error messages to the matching request,
+ *   - route result/error messages to the matching request,
  *   - transparently fall back to a synchronous main-thread computation when
  *     workers are unavailable or the worker bundle fails to load.
  *
@@ -126,11 +126,9 @@ var handleWorkerMessage = function handleWorkerMessage(event) {
     return;
   }
   if (message.type === 'pivot:progress') {
-    var percent = message.total > 0 ? Math.round(message.processed / message.total * 100) : null;
-    log('#' + message.id + ' progress ' + message.phase + ': ' + message.processed + (message.total ? '/' + message.total : '') + (percent === null ? '' : ' (' + percent + '%)'));
-    if (entry.onProgress) {
-      entry.onProgress(message.processed, message.total, message.phase);
-    }
+    // Progress reporting was removed: the UI only shows a loading overlay
+    // until `pivot:result` arrives. Ignore messages from older worker
+    // bundles that still emit progress so the request is not corrupted.
     return;
   }
   clearTimeout(entry.timer);
@@ -193,7 +191,7 @@ var ensureWorker = function ensureWorker() {
  * worker reuse the materialized dataset across consecutive computations and
  * lets the client skip re-staging identical data.
  */
-function computePivotInWorker(data, dataKey, config, onProgress) {
+function computePivotInWorker(data, dataKey, config) {
   var worker = ensureWorker();
   if (!worker) {
     log('worker unavailable -> synchronous fallback');
@@ -209,7 +207,6 @@ function computePivotInWorker(data, dataKey, config, onProgress) {
     pendingRequests.set(id, {
       resolve: resolve,
       reject: reject,
-      onProgress: onProgress,
       timer: timer,
       startedAt: Date.now()
     });
@@ -228,16 +225,14 @@ function computePivotInWorker(data, dataKey, config, onProgress) {
  * automatic fallback whenever the worker path is unavailable. Deferred by
  * one tick so a loading indicator can paint before the blocking work starts.
  */
-function computePivotSynchronously(data, config, onProgress) {
+function computePivotSynchronously(data, config) {
   return new Promise(function (resolve, reject) {
     setTimeout(function () {
       var startedAt = Date.now();
       log('running synchronous computation on the main thread...');
       try {
-        var materialized = (0, _pivotCompute.materializeData)(data, {}, function (processed, total) {
-          onProgress(processed, total, 'materialize');
-        });
-        var result = (0, _pivotCompute.computePivotState)(materialized, config, onProgress);
+        var materialized = (0, _pivotCompute.materializeData)(data, {});
+        var result = (0, _pivotCompute.computePivotState)(materialized, config);
         log('synchronous computation finished in ' + (Date.now() - startedAt) + 'ms', {
           totalRecords: result.totalRecords,
           rowKeys: result.rowKeys.length,
@@ -257,10 +252,10 @@ function computePivotSynchronously(data, config, onProgress) {
  * produces the exact same serialized shape, so callers render identically
  * either way.
  */
-function computePivotWithFallback(data, dataKey, config, onProgress) {
-  return computePivotInWorker(data, dataKey, config, onProgress).catch(function (error) {
+function computePivotWithFallback(data, dataKey, config) {
+  return computePivotInWorker(data, dataKey, config).catch(function (error) {
     log('worker request failed, falling back to the main thread:', error && error.message || error);
-    return computePivotSynchronously(data, config, onProgress);
+    return computePivotSynchronously(data, config);
   });
 }
 //# sourceMappingURL=PivotDataWorker.js.map

package/dist/PivotDataWorker.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/PivotDataWorker.js"],"names":["setWorkerDebug","configureWorkerUrl","computePivotInWorker","computePivotSynchronously","computePivotWithFallback","DEFAULT_WORKER_URL","REQUEST_TIMEOUT_MS","workerUrl","sharedWorker","sharedWorkerBroken","hasResultEver","nextRequestId","lastStagedDataKey","workerDebug","pendingRequests","Map","enabled","next","Boolean","wasEnabled","log","postMessage","type","isDebugEnabled","window","__PVT_WORKER_DEBUG__","args","describeConfig","config","rows","join","cols","aggregations","length","countOf","Array","isArray","value","undefined","failAllPending","forEach","clearTimeout","entry","timer","reject","error","clear","url","Error","terminate","handleWorkerMessage","message","event","data","detail","get","id","percent","total","Math","round","processed","phase","onProgress","delete","result","Date","now","startedAt","totalRecords","rowKeys","colKeys","resolve","ensureWorker","Worker","onmessage","onerror","dataKey","worker","Promise","setTimeout","set","mustStage","materialized","catch"],"mappings":"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","file":"PivotDataWorker.js","sourcesContent":["/* eslint-disable valid-jsdoc */\n/* eslint-disable no-console */\n/* eslint-disable no-undefined */\n/*\n * Main-thread client for the pivot Web Worker (src/pivotWorker.js).\n *\n * Responsibilities:\n *   - lazily create a single shared Worker (at `workerUrl`, overrideable),\n *   - route progress/result/error messages to the matching request,\n *   - transparently fall back to a synchronous main-thread computation when\n *     workers are unavailable or the worker bundle fails to load.\n *\n * Debug logging is off by default. Turn it on with the `workerDebug` prop of\n * PivotTableUI (or by setting `window.__PVT_WORKER_DEBUG__ = true` before\n * rendering) to trace worker creation, staging, computation, progress,\n * results, errors and fallbacks in the browser console.\n */\nimport {materializeData, computePivotState} from './pivotCompute';\n\nexport const DEFAULT_WORKER_URL = 'pivot-worker.js';\n\nconst REQUEST_TIMEOUT_MS = 300000;\n\nlet workerUrl = DEFAULT_WORKER_URL;\nlet sharedWorker = null;\n// The worker is marked broken only if it fails before ever producing a\n// result (e.g. a 404 worker script); runtime hiccups later on just reject\n// the affected request and fall back once.\nlet sharedWorkerBroken = false;\nlet hasResultEver = false;\nlet nextRequestId = 1;\nlet lastStagedDataKey = null;\nlet workerDebug = false;\nconst pendingRequests = new Map();\n\nexport function setWorkerDebug(enabled) {\n  const next = Boolean(enabled);\n  const wasEnabled = workerDebug;\n  if (next === wasEnabled) {\n    return;\n  }\n  if (next) {\n    workerDebug = true;\n    log('debug logging enabled');\n  } else {\n    // Log while logging is still active, so the \"disabled\" notice is shown.\n    log('debug logging disabled');\n    workerDebug = false;\n  }\n  if (sharedWorker) {\n    sharedWorker.postMessage({type: 'pivot:debug', enabled: workerDebug});\n  }\n}\n\nconst isDebugEnabled = () =>\n  workerDebug ||\n  (typeof window !== 'undefined' && window.__PVT_WORKER_DEBUG__ === true);\n\nfunction log(...args) {\n  if (!isDebugEnabled()) {\n    return;\n  }\n  console.log(\n    '%c[pivottable worker]',\n    'color:#ff6600;font-weight:bold',\n    ...args\n  );\n}\n\nconst describeConfig = config =>\n  `rows=[${(config.rows || []).join(', ')}] cols=[${(config.cols || []).join(\n    ', '\n  )}] aggregations=${(config.aggregations || []).length}`;\n\n// Length of an optional array field, used for defensive debug logging.\nconst countOf = value => (Array.isArray(value) ? value.length : undefined);\n\nconst failAllPending = error => {\n  pendingRequests.forEach(entry => {\n    clearTimeout(entry.timer);\n    entry.reject(error);\n  });\n  pendingRequests.clear();\n};\n\nexport function configureWorkerUrl(url) {\n  if (url && url !== workerUrl) {\n    workerUrl = url;\n    if (sharedWorker) {\n      // Reject in-flight requests first so callers fall back to the\n      // synchronous path instead of waiting for the request timeout.\n      failAllPending(new Error('Pivot worker was reconfigured'));\n      sharedWorker.terminate();\n      sharedWorker = null;\n      sharedWorkerBroken = false;\n      hasResultEver = false;\n      lastStagedDataKey = null;\n    }\n  }\n}\n\nconst handleWorkerMessage = event => {\n  const message = event.data || {};\n  if (message.type === 'pivot:log') {\n    log('(in worker)', message.message, message.detail || '');\n    return;\n  }\n  const entry = pendingRequests.get(message.id);\n  if (!entry) {\n    return;\n  }\n  if (message.type === 'pivot:progress') {\n    const percent =\n      message.total > 0\n        ? Math.round((message.processed / message.total) * 100)\n        : null;\n    log(\n      `#${message.id} progress ${message.phase}: ${message.processed}` +\n        (message.total ? `/${message.total}` : '') +\n        (percent === null ? '' : ` (${percent}%)`)\n    );\n    if (entry.onProgress) {\n      entry.onProgress(message.processed, message.total, message.phase);\n    }\n    return;\n  }\n  clearTimeout(entry.timer);\n  pendingRequests.delete(message.id);\n  if (message.type === 'pivot:result') {\n    hasResultEver = true;\n    const result = message.result;\n    log(`#${message.id} result received in ${Date.now() - entry.startedAt}ms`, {\n      totalRecords: result && result.totalRecords,\n      rowKeys: countOf(result && result.rowKeys),\n      colKeys: countOf(result && result.colKeys),\n      aggregations: countOf(result && result.aggregations),\n    });\n    entry.resolve(message.result);\n  } else if (message.type === 'pivot:error') {\n    log(`#${message.id} worker reported an error:`, message.message);\n    entry.reject(new Error(message.message || 'Pivot worker error'));\n  }\n};\n\nconst ensureWorker = () => {\n  if (sharedWorkerBroken) {\n    return null;\n  }\n\n  if (typeof Worker === 'undefined') {\n    log('no Worker support in this environment');\n    return null;\n  }\n\n  if (!sharedWorker) {\n    try {\n      sharedWorker = new Worker(workerUrl);\n      log('worker created:', workerUrl);\n    } catch (error) {\n      sharedWorkerBroken = true;\n      log('worker creation failed:', error && error.message);\n      return null;\n    }\n    sharedWorker.onmessage = handleWorkerMessage;\n    sharedWorker.onerror = event => {\n      log(\n        'worker error event (script failed to load / runtime error):',\n        (event && event.message) || ''\n      );\n      failAllPending(new Error('Pivot worker failed to load'));\n      if (!hasResultEver) {\n        sharedWorkerBroken = true;\n        log('worker marked unusable -> will use the synchronous fallback');\n      }\n    };\n    if (isDebugEnabled()) {\n      sharedWorker.postMessage({type: 'pivot:debug', enabled: true});\n    }\n  }\n  return sharedWorker;\n};\n\n/*\n * Runs a full computation inside the shared worker.\n *\n * `dataKey` must change whenever the underlying dataset changes. It lets the\n * worker reuse the materialized dataset across consecutive computations and\n * lets the client skip re-staging identical data.\n */\nexport function computePivotInWorker(data, dataKey, config, onProgress) {\n  const worker = ensureWorker();\n  if (!worker) {\n    log('worker unavailable -> synchronous fallback');\n    return Promise.reject(new Error('Web worker unavailable'));\n  }\n  const id = nextRequestId++;\n  return new Promise((resolve, reject) => {\n    const timer = setTimeout(() => {\n      pendingRequests.delete(id);\n      log(`#${id} timed out after ${REQUEST_TIMEOUT_MS}ms`);\n      reject(new Error('Pivot worker timed out'));\n    }, REQUEST_TIMEOUT_MS);\n    pendingRequests.set(id, {\n      resolve,\n      reject,\n      onProgress,\n      timer,\n      startedAt: Date.now(),\n    });\n    const mustStage = lastStagedDataKey !== dataKey;\n    log(\n      `#${id} dispatching to worker (dataKey=${dataKey}${\n        mustStage\n          ? ', staging ' + (data || []).length + ' records'\n          : ', cached dataset'\n      }, ${describeConfig(config)})`\n    );\n    if (mustStage) {\n      worker.postMessage({type: 'pivot:setData', id, dataKey, data});\n      lastStagedDataKey = dataKey;\n    }\n    worker.postMessage({type: 'pivot:compute', id, dataKey, config});\n  });\n}\n\n/*\n * Same contract as the worker path, executed on the main thread. Used as the\n * automatic fallback whenever the worker path is unavailable. Deferred by\n * one tick so a loading indicator can paint before the blocking work starts.\n */\nexport function computePivotSynchronously(data, config, onProgress) {\n  return new Promise((resolve, reject) => {\n    setTimeout(() => {\n      const startedAt = Date.now();\n      log('running synchronous computation on the main thread...');\n      try {\n        const materialized = materializeData(data, {}, (processed, total) => {\n          onProgress(processed, total, 'materialize');\n        });\n        const result = computePivotState(materialized, config, onProgress);\n        log(`synchronous computation finished in ${Date.now() - startedAt}ms`, {\n          totalRecords: result.totalRecords,\n          rowKeys: result.rowKeys.length,\n          colKeys: result.colKeys.length,\n        });\n        resolve(result);\n      } catch (error) {\n        log('synchronous computation failed:', error && error.message);\n        reject(error);\n      }\n    }, 0);\n  });\n}\n\n/*\n * Worker-first entry point with automatic synchronous fallback. The fallback\n * produces the exact same serialized shape, so callers render identically\n * either way.\n */\nexport function computePivotWithFallback(data, dataKey, config, onProgress) {\n  return computePivotInWorker(data, dataKey, config, onProgress).catch(\n    error => {\n      log(\n        'worker request failed, falling back to the main thread:',\n        (error && error.message) || error\n      );\n      return computePivotSynchronously(data, config, onProgress);\n    }\n  );\n}\n"]}
+{"version":3,"sources":["../src/PivotDataWorker.js"],"names":["setWorkerDebug","configureWorkerUrl","computePivotInWorker","computePivotSynchronously","computePivotWithFallback","DEFAULT_WORKER_URL","REQUEST_TIMEOUT_MS","workerUrl","sharedWorker","sharedWorkerBroken","hasResultEver","nextRequestId","lastStagedDataKey","workerDebug","pendingRequests","Map","enabled","next","Boolean","wasEnabled","log","postMessage","type","isDebugEnabled","window","__PVT_WORKER_DEBUG__","args","describeConfig","config","rows","join","cols","aggregations","length","countOf","Array","isArray","value","undefined","failAllPending","forEach","clearTimeout","entry","timer","reject","error","clear","url","Error","terminate","handleWorkerMessage","message","event","data","detail","get","id","delete","result","Date","now","startedAt","totalRecords","rowKeys","colKeys","resolve","ensureWorker","Worker","onmessage","onerror","dataKey","worker","Promise","setTimeout","set","mustStage","materialized","catch"],"mappings":"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","file":"PivotDataWorker.js","sourcesContent":["/* eslint-disable valid-jsdoc */\n/* eslint-disable no-console */\n/* eslint-disable no-undefined */\n/*\n * Main-thread client for the pivot Web Worker (src/pivotWorker.js).\n *\n * Responsibilities:\n *   - lazily create a single shared Worker (at `workerUrl`, overrideable),\n *   - route result/error messages to the matching request,\n *   - transparently fall back to a synchronous main-thread computation when\n *     workers are unavailable or the worker bundle fails to load.\n *\n * Debug logging is off by default. Turn it on with the `workerDebug` prop of\n * PivotTableUI (or by setting `window.__PVT_WORKER_DEBUG__ = true` before\n * rendering) to trace worker creation, staging, computation, progress,\n * results, errors and fallbacks in the browser console.\n */\nimport {materializeData, computePivotState} from './pivotCompute';\n\nexport const DEFAULT_WORKER_URL = 'pivot-worker.js';\n\nconst REQUEST_TIMEOUT_MS = 300000;\n\nlet workerUrl = DEFAULT_WORKER_URL;\nlet sharedWorker = null;\n// The worker is marked broken only if it fails before ever producing a\n// result (e.g. a 404 worker script); runtime hiccups later on just reject\n// the affected request and fall back once.\nlet sharedWorkerBroken = false;\nlet hasResultEver = false;\nlet nextRequestId = 1;\nlet lastStagedDataKey = null;\nlet workerDebug = false;\nconst pendingRequests = new Map();\n\nexport function setWorkerDebug(enabled) {\n  const next = Boolean(enabled);\n  const wasEnabled = workerDebug;\n  if (next === wasEnabled) {\n    return;\n  }\n  if (next) {\n    workerDebug = true;\n    log('debug logging enabled');\n  } else {\n    // Log while logging is still active, so the \"disabled\" notice is shown.\n    log('debug logging disabled');\n    workerDebug = false;\n  }\n  if (sharedWorker) {\n    sharedWorker.postMessage({type: 'pivot:debug', enabled: workerDebug});\n  }\n}\n\nconst isDebugEnabled = () =>\n  workerDebug ||\n  (typeof window !== 'undefined' && window.__PVT_WORKER_DEBUG__ === true);\n\nfunction log(...args) {\n  if (!isDebugEnabled()) {\n    return;\n  }\n  console.log(\n    '%c[pivottable worker]',\n    'color:#ff6600;font-weight:bold',\n    ...args\n  );\n}\n\nconst describeConfig = config =>\n  `rows=[${(config.rows || []).join(', ')}] cols=[${(config.cols || []).join(\n    ', '\n  )}] aggregations=${(config.aggregations || []).length}`;\n\n// Length of an optional array field, used for defensive debug logging.\nconst countOf = value => (Array.isArray(value) ? value.length : undefined);\n\nconst failAllPending = error => {\n  pendingRequests.forEach(entry => {\n    clearTimeout(entry.timer);\n    entry.reject(error);\n  });\n  pendingRequests.clear();\n};\n\nexport function configureWorkerUrl(url) {\n  if (url && url !== workerUrl) {\n    workerUrl = url;\n    if (sharedWorker) {\n      // Reject in-flight requests first so callers fall back to the\n      // synchronous path instead of waiting for the request timeout.\n      failAllPending(new Error('Pivot worker was reconfigured'));\n      sharedWorker.terminate();\n      sharedWorker = null;\n      sharedWorkerBroken = false;\n      hasResultEver = false;\n      lastStagedDataKey = null;\n    }\n  }\n}\n\nconst handleWorkerMessage = event => {\n  const message = event.data || {};\n  if (message.type === 'pivot:log') {\n    log('(in worker)', message.message, message.detail || '');\n    return;\n  }\n  const entry = pendingRequests.get(message.id);\n  if (!entry) {\n    return;\n  }\n  if (message.type === 'pivot:progress') {\n    // Progress reporting was removed: the UI only shows a loading overlay\n    // until `pivot:result` arrives. Ignore messages from older worker\n    // bundles that still emit progress so the request is not corrupted.\n    return;\n  }\n  clearTimeout(entry.timer);\n  pendingRequests.delete(message.id);\n  if (message.type === 'pivot:result') {\n    hasResultEver = true;\n    const result = message.result;\n    log(`#${message.id} result received in ${Date.now() - entry.startedAt}ms`, {\n      totalRecords: result && result.totalRecords,\n      rowKeys: countOf(result && result.rowKeys),\n      colKeys: countOf(result && result.colKeys),\n      aggregations: countOf(result && result.aggregations),\n    });\n    entry.resolve(message.result);\n  } else if (message.type === 'pivot:error') {\n    log(`#${message.id} worker reported an error:`, message.message);\n    entry.reject(new Error(message.message || 'Pivot worker error'));\n  }\n};\n\nconst ensureWorker = () => {\n  if (sharedWorkerBroken) {\n    return null;\n  }\n\n  if (typeof Worker === 'undefined') {\n    log('no Worker support in this environment');\n    return null;\n  }\n\n  if (!sharedWorker) {\n    try {\n      sharedWorker = new Worker(workerUrl);\n      log('worker created:', workerUrl);\n    } catch (error) {\n      sharedWorkerBroken = true;\n      log('worker creation failed:', error && error.message);\n      return null;\n    }\n    sharedWorker.onmessage = handleWorkerMessage;\n    sharedWorker.onerror = event => {\n      log(\n        'worker error event (script failed to load / runtime error):',\n        (event && event.message) || ''\n      );\n      failAllPending(new Error('Pivot worker failed to load'));\n      if (!hasResultEver) {\n        sharedWorkerBroken = true;\n        log('worker marked unusable -> will use the synchronous fallback');\n      }\n    };\n    if (isDebugEnabled()) {\n      sharedWorker.postMessage({type: 'pivot:debug', enabled: true});\n    }\n  }\n  return sharedWorker;\n};\n\n/*\n * Runs a full computation inside the shared worker.\n *\n * `dataKey` must change whenever the underlying dataset changes. It lets the\n * worker reuse the materialized dataset across consecutive computations and\n * lets the client skip re-staging identical data.\n */\nexport function computePivotInWorker(data, dataKey, config) {\n  const worker = ensureWorker();\n  if (!worker) {\n    log('worker unavailable -> synchronous fallback');\n    return Promise.reject(new Error('Web worker unavailable'));\n  }\n  const id = nextRequestId++;\n  return new Promise((resolve, reject) => {\n    const timer = setTimeout(() => {\n      pendingRequests.delete(id);\n      log(`#${id} timed out after ${REQUEST_TIMEOUT_MS}ms`);\n      reject(new Error('Pivot worker timed out'));\n    }, REQUEST_TIMEOUT_MS);\n    pendingRequests.set(id, {\n      resolve,\n      reject,\n      timer,\n      startedAt: Date.now(),\n    });\n    const mustStage = lastStagedDataKey !== dataKey;\n    log(\n      `#${id} dispatching to worker (dataKey=${dataKey}${\n        mustStage\n          ? ', staging ' + (data || []).length + ' records'\n          : ', cached dataset'\n      }, ${describeConfig(config)})`\n    );\n    if (mustStage) {\n      worker.postMessage({type: 'pivot:setData', id, dataKey, data});\n      lastStagedDataKey = dataKey;\n    }\n    worker.postMessage({type: 'pivot:compute', id, dataKey, config});\n  });\n}\n\n/*\n * Same contract as the worker path, executed on the main thread. Used as the\n * automatic fallback whenever the worker path is unavailable. Deferred by\n * one tick so a loading indicator can paint before the blocking work starts.\n */\nexport function computePivotSynchronously(data, config) {\n  return new Promise((resolve, reject) => {\n    setTimeout(() => {\n      const startedAt = Date.now();\n      log('running synchronous computation on the main thread...');\n      try {\n        const materialized = materializeData(data, {});\n        const result = computePivotState(materialized, config);\n        log(`synchronous computation finished in ${Date.now() - startedAt}ms`, {\n          totalRecords: result.totalRecords,\n          rowKeys: result.rowKeys.length,\n          colKeys: result.colKeys.length,\n        });\n        resolve(result);\n      } catch (error) {\n        log('synchronous computation failed:', error && error.message);\n        reject(error);\n      }\n    }, 0);\n  });\n}\n\n/*\n * Worker-first entry point with automatic synchronous fallback. The fallback\n * produces the exact same serialized shape, so callers render identically\n * either way.\n */\nexport function computePivotWithFallback(data, dataKey, config) {\n  return computePivotInWorker(data, dataKey, config).catch(error => {\n    log(\n      'worker request failed, falling back to the main thread:',\n      (error && error.message) || error\n    );\n    return computePivotSynchronously(data, config);\n  });\n}\n"]}

package/dist/PivotTableUI.js

@@ -1114,14 +1114,12 @@ CellFormattingUI.defaultProps = {
 // instances share the same Web Worker.
 var pivotWorkerInstanceCounter = 0;
 
-function PivotLoadingOverlay(props) {
-  var progress = props.progress || {};
-  var percent = progress.total > 0 ? Math.min(100, Math.round(progress.processed / progress.total * 100)) : null;
-  var phaseLabels = {
-    materialize: 'Reading data',
-    aggregate: 'Aggregating data'
-  };
-  var phaseLabel = phaseLabels[progress.phase] || 'Processing';
+// Loading overlay shown while a worker computation is running. It is removed
+// only when both conditions hold: the worker posted its `pivot:result` event
+// AND PivotTableUI has committed the freshly computed table to the DOM (see
+// the resultReady/useLayoutEffect handshake below), so content never appears
+// after the overlay disappears.
+function PivotLoadingOverlay() {
   return _react2.default.createElement(
     'div',
     { className: 'pvtLoadingOverlay', role: 'status' },
@@ -1129,27 +1127,11 @@ function PivotLoadingOverlay(props) {
     _react2.default.createElement(
       'div',
       { className: 'pvtLoadingText' },
-      phaseLabel,
-      '\u2026'
-    ),
-    percent !== null ? _react2.default.createElement(
-      'div',
-      { className: 'pvtLoadingBarWrap' },
-      _react2.default.createElement('div', { className: 'pvtLoadingBar', style: { width: percent + '%' } })
-    ) : null,
-    percent !== null ? _react2.default.createElement(
-      'div',
-      { className: 'pvtLoadingPercent' },
-      percent,
-      '%'
-    ) : null
+      'Processing\u2026'
+    )
   );
 }
 
-PivotLoadingOverlay.propTypes = {
-  progress: _propTypes2.default.object
-};
-
 function PivotTableUI(props) {
   var _useState9 = (0, _react.useState)([]),
       _useState10 = _slicedToArray(_useState9, 2),
@@ -1200,11 +1182,15 @@ function PivotTableUI(props) {
       _useState22 = _slicedToArray(_useState21, 2),
       isProcessing = _useState22[0],
       setIsProcessing = _useState22[1];
+  // True once the worker result has been applied but the overlay is still
+  // showing: the fresh table renders underneath first, then a layout effect
+  // clears `isProcessing` before the browser paints.
 
-  var _useState23 = (0, _react.useState)(null),
+
+  var _useState23 = (0, _react.useState)(false),
       _useState24 = _slicedToArray(_useState23, 2),
-      progress = _useState24[0],
-      setProgress = _useState24[1];
+      resultReady = _useState24[0],
+      setResultReady = _useState24[1];
 
   var _useState25 = (0, _react.useState)(null),
       _useState26 = _slicedToArray(_useState25, 2),
@@ -1288,6 +1274,17 @@ function PivotTableUI(props) {
     }
   });
 
+  // The loading overlay may only be turned off once the new result has been
+  // rendered: the worker's `.then` sets `resultReady` (which makes this
+  // render output the fresh table underneath the still-visible overlay), and
+  // this layout effect runs after that DOM commit but before the browser
+  // paints - so the overlay disappears exactly when the table is on screen.
+  (0, _react.useLayoutEffect)(function () {
+    if (resultReady && isProcessing) {
+      setIsProcessing(false);
+    }
+  }, [resultReady, isProcessing]);
+
   // Schedule an off-main-thread computation whenever the data or the pivot
   // configuration changes. Rapid consecutive changes are debounced and
   // stale responses are discarded.
@@ -1296,11 +1293,6 @@ function PivotTableUI(props) {
     // result is never applied to the new configuration or dataset.
     activeRequestRef.current += 1;
 
-    if (!workerEligible) {
-      setIsProcessing(false);
-      return undefined;
-    }
-
     if (versionedDataRef.current !== props.data) {
       versionedDataRef.current = props.data;
       dataVersionRef.current += 1;
@@ -1314,18 +1306,13 @@ function PivotTableUI(props) {
 
     (0, _PivotDataWorker.configureWorkerUrl)(props.workerUrl || _PivotDataWorker.DEFAULT_WORKER_URL);
     setIsProcessing(true);
+    setResultReady(false);
     setComputeError(null);
-    setProgress({ processed: 0, total: props.data.length, phase: 'queued' });
 
     var timer = setTimeout(function () {
       var requestId = activeRequestRef.current;
       var dataKey = instanceIdRef.current + '-data-' + dataVersionRef.current;
-      (0, _PivotDataWorker.computePivotWithFallback)(props.data, dataKey, (0, _pivotCompute.createWorkerConfig)(props), function (processed, total, phase) {
-        if (unmountedRef.current || requestId !== activeRequestRef.current) {
-          return;
-        }
-        setProgress({ processed: processed, total: total, phase: phase });
-      }).then(function (result) {
+      (0, _PivotDataWorker.computePivotWithFallback)(props.data, dataKey, (0, _pivotCompute.createWorkerConfig)(props)).then(function (result) {
         if (unmountedRef.current || requestId !== activeRequestRef.current) {
           return;
         }
@@ -1334,7 +1321,10 @@ function PivotTableUI(props) {
         setAttrValues(result.attrValues);
         setMaterializedInput(result.materializedInput);
         setComputeError(null);
-        setIsProcessing(false);
+        // Keep the overlay up for one more render: `resultReady` makes the
+        // fresh table render underneath, and the layout effect above turns
+        // `isProcessing` off only after that render has been committed.
+        setResultReady(true);
       }).catch(function (error) {
         if (unmountedRef.current || requestId !== activeRequestRef.current) {
           return;
@@ -1346,8 +1336,7 @@ function PivotTableUI(props) {
     return function () {
       clearTimeout(timer);
     };
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [props.data, workerEligible, computeSignature]);
+  }, [props.data, computeSignature]);
 
   var sendPropUpdate = function sendPropUpdate(command) {
     props.onChange((0, _immutabilityHelper2.default)(props, command));
@@ -1835,7 +1824,7 @@ function PivotTableUI(props) {
   var showProcessing = (isProcessing || props.isShowProcessing) && !computeError;
   // While recomputing, re-render the last valid table (old props matched to
   // their own precomputed result) so the overlay sits on top of real content.
-  var staleView = showProcessing ? lastGoodViewRef.current : null;
+  var staleView = showProcessing && !resultReady ? lastGoodViewRef.current : null;
 
   var outputContent = void 0;
   if (computeError) {
@@ -1862,7 +1851,7 @@ function PivotTableUI(props) {
       onColSort: handleColSort,
       onRowSort: handleRowSort
     }));
-  } else if (showProcessing) {
+  } else if (showProcessing && !resultReady) {
     // First computation: no previous table to keep visible yet.
     outputContent = _react2.default.createElement('div', { className: 'pvtOutputPlaceholder' });
   } else {
@@ -1876,11 +1865,6 @@ function PivotTableUI(props) {
     }));
   }
 
-  // With the `isShowProcessing` testing hook active and no real computation
-  // running there is no progress to report, so feed the overlay a sample
-  // value to exercise its progress-bar and percentage branch as well.
-  var overlayProgress = props.isShowProcessing && !isProcessing ? progress || { processed: 60, total: 100, phase: 'aggregate' } : progress;
-
   var outputCell = _react2.default.createElement(
     'td',
     { className: 'pvtOutput' },
@@ -1891,7 +1875,7 @@ function PivotTableUI(props) {
     return _react2.default.createElement(
       _react2.default.Fragment,
       null,
-      showProcessing ? _react2.default.createElement(PivotLoadingOverlay, { progress: overlayProgress }) : null,
+      showProcessing ? _react2.default.createElement(PivotLoadingOverlay, null) : null,
       _react2.default.createElement(
         'table',
         { className: 'pvtUi' },
@@ -1924,26 +1908,31 @@ function PivotTableUI(props) {
   }
 
   return _react2.default.createElement(
-    'table',
-    { className: 'pvtUi' },
+    _react2.default.Fragment,
+    null,
+    showProcessing ? _react2.default.createElement(PivotLoadingOverlay, null) : null,
     _react2.default.createElement(
-      'tbody',
-      { onClick: function onClick() {
-          return setOpenDropdown(false);
-        } },
-      _react2.default.createElement(
-        'tr',
-        null,
-        rendererCell,
-        aggregatorCell,
-        colAttrsCell
-      ),
+      'table',
+      { className: 'pvtUi' },
       _react2.default.createElement(
-        'tr',
-        null,
-        unusedAttrsCell,
-        rowAttrsCell,
-        outputCell
+        'tbody',
+        { onClick: function onClick() {
+            return setOpenDropdown(false);
+          } },
+        _react2.default.createElement(
+          'tr',
+          null,
+          rendererCell,
+          aggregatorCell,
+          colAttrsCell
+        ),
+        _react2.default.createElement(
+          'tr',
+          null,
+          unusedAttrsCell,
+          rowAttrsCell,
+          outputCell
+        )
       )
     )
   );