@nebula.js/stardust 5.10.1 → 5.11.0

package/core/esm/dev.js

@@ -1,5 +1,5 @@
 /*
-* @nebula.js/stardust v5.10.1
+* @nebula.js/stardust v5.11.0
 * Copyright (c) 2025 QlikTech International AB
 * Released under the MIT license.
 */
@@ -10754,7 +10754,7 @@ function create$3(definition) {
   return cache[key];
 }
 
-const NEBULA_VERSION_HASH = "a207";
+const NEBULA_VERSION_HASH = "a481";
 ClassNameGenerator.configure(componentName => {
   return "njs-".concat(NEBULA_VERSION_HASH, "-").concat(componentName.replace('Mui', ''));
 });
@@ -10986,7 +10986,7 @@ function boot(_ref2) {
   const appRef = React__default.createRef();
   const element = document.createElement('div');
   element.style.display = 'none';
-  element.setAttribute('data-nebulajs-version', "5.10.1");
+  element.setAttribute('data-nebulajs-version', "5.11.0");
   element.setAttribute('data-app-id', app.id);
   document.body.appendChild(element);
   if (context) {
@@ -27041,7 +27041,7 @@ const SheetElement = {
   /** @type {'njs-sheet'} */
   className: 'njs-sheet'
 };
-function getCellRenderer(cell, halo, initialSnOptions, initialSnPlugins, initialError, onMount, navigation) {
+function getCellRenderer(cell, halo, initialSnOptions, initialSnPlugins, initialError, onMount, navigation, onError) {
   const {
     x,
     y,
@@ -27066,7 +27066,8 @@ function getCellRenderer(cell, halo, initialSnOptions, initialSnPlugins, initial
     initialSnPlugins: initialSnPlugins,
     initialError: initialError,
     onMount: onMount,
-    navigation: navigation
+    navigation: navigation,
+    onError: onError
   }));
 }
 function getBounds(pos, columns, rows) {
@@ -27090,7 +27091,8 @@ const Sheet = forwardRef((_ref, ref) => {
     initialError,
     onMount,
     unmount,
-    navigation
+    navigation,
+    onError
   } = _ref;
   const {
     root
@@ -27105,6 +27107,11 @@ const Sheet = forwardRef((_ref, ref) => {
   const [bgColor, setBgColor] = useState$1(undefined);
   const [bgImage, setBgImage] = useState$1(undefined);
   const [deepHash, setDeepHash] = useState$1('');
+  const renderState = useRef$1({
+    cellCount: 0,
+    cellsRendered: 0,
+    initialRender: false
+  });
   navigation === null || navigation === void 0 || (_navigation$setCurren = navigation.setCurrentSheetId) === null || _navigation$setCurren === void 0 || _navigation$setCurren.call(navigation, model.id);
   /// For each object
   useEffect$1(() => {
@@ -27125,6 +27132,15 @@ const Sheet = forwardRef((_ref, ref) => {
           root.removeCell(c.currentId);
         });
         const lCells = layout.cells;
+        renderState.cellCount = lCells.length;
+        renderState.cellsRendered = 0;
+        const renderCallback = () => {
+          renderState.cellsRendered++;
+          if (renderState.cellsRendered === renderState.cellCount && !renderState.initialRender) {
+            renderState.initialRender = true;
+            initialSnOptions.onInitialRender();
+          }
+        };
         const {
           columns,
           rows
@@ -27152,7 +27168,10 @@ const Sheet = forwardRef((_ref, ref) => {
             cellRef: React__default.createRef(),
             currentId: uid(),
             mounted,
-            mountedPromise
+            mountedPromise,
+            options: _objectSpread2(_objectSpread2({}, initialSnOptions), {
+              onInitialRender: renderCallback
+            })
           };
         }));
         cs.forEach(c => root.addCell(c.currentId, c.cellRef));
@@ -27169,7 +27188,7 @@ const Sheet = forwardRef((_ref, ref) => {
     model.on('closed', onModelClose);
     return () => model.removeListener('closed', onModelClose);
   }, [model]);
-  const cellRenderers = useMemo$1(() => cells ? cells.map(c => getCellRenderer(c, halo, initialSnOptions, initialSnPlugins, initialError, c.mounted, navigation)) : [], [cells]);
+  const cellRenderers = useMemo$1(() => cells ? cells.map(c => getCellRenderer(c, halo, c.options, initialSnPlugins, initialError, c.mounted, navigation, onError)) : [], [cells]);
   useEffect$1(() => {
     const bgComp = layout !== null && layout !== void 0 && layout.components ? layout.components.find(comp => comp.key === 'general') : null;
     setBgColor(resolveBgColor(bgComp, halo.public.theme));
@@ -27219,7 +27238,8 @@ function glue(_ref) {
     initialSnPlugins,
     onMount,
     initialError,
-    navigation
+    navigation,
+    onError
   } = _ref;
   const {
     root
@@ -27238,7 +27258,8 @@ function glue(_ref) {
     initialError: initialError,
     onMount: onMount,
     unmount: unmount,
-    navigation: navigation
+    navigation: navigation,
+    onError: onError
   }), element, model.id);
   navigation.setSheetRef(sheetRef);
   root.add(portal);
@@ -27252,26 +27273,42 @@ function sheet() {
     halo,
     navigation,
     initialError,
-    onDestroy = async () => {}
+    onDestroy = async () => {},
+    onRender = () => {},
+    onError = () => {}
   } = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
   let unmountSheet = noopi;
   let sheetRef = null;
   let mountedReference = null;
   let onMount = null;
+  let onRenderResolve = null;
   const mounted = new Promise(resolve => {
     onMount = resolve;
   });
+  const rendered = new Promise(resolve => {
+    onRenderResolve = resolve;
+  });
+  const createOnInitialRender = override => () => {
+    override === null || override === void 0 || override(); // from options.onInitialRender
+    onRenderResolve(); // internal promise in viz to wait for render
+    onRender(); // from RenderConfig
+  };
   let initialSnOptions = {};
   let initialSnPlugins = [];
   const setSnOptions = async opts => {
+    const override = opts.onInitialRender;
     if (mountedReference) {
       (async () => {
         await mounted;
-        sheetRef.current.setSnOptions(_objectSpread2(_objectSpread2({}, initialSnOptions), opts));
+        sheetRef.current.setSnOptions(_objectSpread2(_objectSpread2(_objectSpread2({}, initialSnOptions), opts), {
+          onInitialRender: createOnInitialRender(override)
+        }));
       })();
     } else {
       // Handle setting options before mount
-      initialSnOptions = _objectSpread2(_objectSpread2({}, initialSnOptions), opts);
+      initialSnOptions = _objectSpread2(_objectSpread2(_objectSpread2({}, initialSnOptions), opts), {
+        onInitialRender: createOnInitialRender(override)
+      });
     }
   };
   const setSnPlugins = async plugins => {
@@ -27318,6 +27355,15 @@ function sheet() {
      * @type {Navigation}
      */
     navigation,
+    /**
+     * Gets the specific api that a Viz exposes.
+     * @private currently empty and private
+     * @returns {Promise<object>} object that contains the internal Viz api.
+     */
+    async getImperativeHandle() {
+      await rendered;
+      return sheetRef.current.getImperativeHandle();
+    },
     /**
      * Destroys the sheet and removes it from the the DOM.
      * @example
@@ -27350,7 +27396,8 @@ function sheet() {
           initialSnPlugins,
           initialError,
           onMount,
-          navigation
+          navigation,
+          onError
         });
         return mounted;
       },
@@ -27385,12 +27432,18 @@ function sheet() {
 /* eslint no-underscore-dangle:0 */
 async function initSheet(model, optional, halo, navigation, initialError) {
   let onDestroy = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : async () => {};
+  const {
+    onRender,
+    onError
+  } = optional;
   const api = sheet({
     model,
     halo,
     navigation,
     initialError,
-    onDestroy
+    onDestroy,
+    onRender,
+    onError
   });
   if (optional.options) {
     api.__DO_NOT_USE__.options(optional.options);
@@ -27533,7 +27586,9 @@ async function getObject(_ref, halo, store) {
     return initSheet(model, {
       options,
       plugins,
-      element
+      element,
+      onRender,
+      onError
     }, halo, navigation);
   }
   return init(model, {