@nebula.js/stardust 5.0.0-alpha.1 → 5.0.0-alpha.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebula.js/stardust",
-  "version": "5.0.0-alpha.1",
+  "version": "5.0.0-alpha.3",
   "description": "Product and framework agnostic integration API for Qlik's Associative Engine",
   "license": "MIT",
   "author": "QlikTech International AB",
@@ -44,17 +44,17 @@
     "@types/qlik-engineapi": "12.67.16"
   },
   "devDependencies": {
-    "@emotion/react": "^11.11.1",
+    "@emotion/react": "^11.11.3",
     "@emotion/styled": "^11.11.0",
-    "@mui/icons-material": "^5.15.0",
-    "@mui/material": "^5.15.0",
-    "@nebula.js/conversion": "^5.0.0-alpha.1",
-    "@nebula.js/enigma-mocker": "^5.0.0-alpha.1",
-    "@nebula.js/locale": "^5.0.0-alpha.1",
-    "@nebula.js/nucleus": "^5.0.0-alpha.1",
-    "@nebula.js/supernova": "^5.0.0-alpha.1",
-    "@nebula.js/theme": "^5.0.0-alpha.1",
-    "@nebula.js/ui": "^5.0.0-alpha.1",
+    "@mui/icons-material": "^5.15.7",
+    "@mui/material": "^5.15.7",
+    "@nebula.js/conversion": "^5.0.0-alpha.3",
+    "@nebula.js/enigma-mocker": "^5.0.0-alpha.3",
+    "@nebula.js/locale": "^5.0.0-alpha.3",
+    "@nebula.js/nucleus": "^5.0.0-alpha.3",
+    "@nebula.js/supernova": "^5.0.0-alpha.3",
+    "@nebula.js/theme": "^5.0.0-alpha.3",
+    "@nebula.js/ui": "^5.0.0-alpha.3",
     "@scriptappy/cli": "0.10.0",
     "@scriptappy/from-jsdoc": "0.19.0",
     "@scriptappy/to-dts": "1.0.0-beta.4",
@@ -63,11 +63,11 @@
     "react": "18.2.0",
     "react-dom": "18.2.0",
     "react-test-renderer": "18.2.0",
-    "react-virtualized-auto-sizer": "1.0.20",
+    "react-virtualized-auto-sizer": "1.0.22",
     "react-window": "1.8.10",
     "react-window-infinite-loader": "1.0.9",
     "regenerator-runtime": "0.14.1",
     "semver": "7.5.4"
   },
-  "gitHead": "4208cf7d22ebf54742fa929b7e604a2cfefc2106"
+  "gitHead": "3520861f5ab7543f57fb873049dabecf9e132e17"
 }

package/types/index.d.ts

@@ -26,6 +26,9 @@ export function useState<S>(initialState: S | (()=>S)): [S, stardust.SetStateFn<
 
 /**
  * Triggers a callback function when a dependent value changes.
+ * 
+ * Omitting the dependency array will have the hook run on each update
+ * and an empty dependency array runs only once.
  * @param effect The callback.
  * @param deps The dependencies that should trigger the callback.
  */
@@ -40,6 +43,9 @@ export function useMemo<T>(factory: ()=>T, deps: any[]): T;
 
 /**
  * Runs a callback function when a dependent changes.
+ * 
+ * Useful for async operations that otherwise cause no side effects.
+ * Do not add for example listeners withing the callback as there is no teardown function.
  * @param factory The factory function that calls the promise.
  * @param deps The dependencies.
  */
@@ -227,7 +233,11 @@ declare namespace stardust {
     }
 
     interface Configuration {
-        load?: stardust.LoadType;
+        /**
+         * Fallback load function for missing types
+         * @param $
+         */
+        load($: stardust.LoadType): Promise<stardust.Visualization>;
         context?: stardust.Context;
         types?: stardust.TypeInfo[];
         themes?: stardust.ThemeInfo[];
@@ -339,6 +349,7 @@ declare namespace stardust {
             frequencyMode?: stardust.FrequencyMode;
             histogram?: boolean;
             search?: stardust.SearchMode;
+            showLock?: boolean;
             toolbar?: boolean;
             checkboxes?: boolean;
             dense?: boolean;
@@ -634,6 +645,11 @@ declare namespace stardust {
         (newState: S | (($: S)=>S)): void;
     }
 
+    /**
+     * Callback function that should return a function that in turns gets
+     * called before the hook runs again or when the component is destroyed.
+     * For example to remove any listeners added in the callback itself.
+     */
     type EffectCallback = ()=>void | (()=>void);
 
     interface Rect {