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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebula.js/stardust",
-  "version": "5.0.0-alpha.2",
+  "version": "5.0.0-alpha.3",
   "description": "Product and framework agnostic integration API for Qlik's Associative Engine",
   "license": "MIT",
   "author": "QlikTech International AB",
@@ -46,15 +46,15 @@
   "devDependencies": {
     "@emotion/react": "^11.11.3",
     "@emotion/styled": "^11.11.0",
-    "@mui/icons-material": "^5.15.2",
-    "@mui/material": "^5.15.2",
-    "@nebula.js/conversion": "^5.0.0-alpha.2",
-    "@nebula.js/enigma-mocker": "^5.0.0-alpha.2",
-    "@nebula.js/locale": "^5.0.0-alpha.2",
-    "@nebula.js/nucleus": "^5.0.0-alpha.2",
-    "@nebula.js/supernova": "^5.0.0-alpha.2",
-    "@nebula.js/theme": "^5.0.0-alpha.2",
-    "@nebula.js/ui": "^5.0.0-alpha.2",
+    "@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": "8fb8959ca3f42da1a11e0ac6beda1ada8dce076f"
+  "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;
@@ -525,6 +536,16 @@ declare namespace stardust {
 
     }
 
+    /**
+     * An object literal containing meta information about the plugin and a function containing the plugin implementation.
+     */
+    interface Plugin {
+        info: {
+            name: string;
+        };
+        fn: ()=>void;
+    }
+
     type Field = string | EngineAPI.INxDimension | EngineAPI.INxMeasure | stardust.LibraryField;
 
     /**
@@ -557,16 +578,6 @@ declare namespace stardust {
         type: "dimension" | "measure";
     }
 
-    /**
-     * An object literal containing meta information about the plugin and a function containing the plugin implementation.
-     */
-    interface Plugin {
-        info: {
-            name: string;
-        };
-        fn: ()=>void;
-    }
-
     interface LoadType {
         (type: {
             name: string;
@@ -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 {