@nebula.js/stardust 4.0.0-alpha.9 → 4.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebula.js/stardust",
-  "version": "4.0.0-alpha.9",
+  "version": "4.0.1",
   "description": "Product and framework agnostic integration API for Qlik's Associative Engine",
   "license": "MIT",
   "author": "QlikTech International AB",
@@ -34,25 +34,27 @@
     "build:dev": "rollup --config ../../rollup.config.js",
     "build:watch": "rollup --config ../../rollup.config.js -w",
     "prepublishOnly": "rm -rf dist && yarn run build",
-    "spec": "sy from-jsdoc -c ./api-spec/spec.conf.js",
+    "spec:stardust": "sy from-jsdoc -c ./api-spec/spec.conf.js",
+    "spec:listbox": "sy from-jsdoc -c ./api-spec/listbox-spec.conf.js",
+    "spec": "yarn run spec:stardust && yarn run spec:listbox",
     "ts": "sy to-dts -c ./api-spec/spec.conf.js",
-    "version": "yarn run spec && yarn run ts && git add ./api-spec/spec.json ./types/index.d.ts"
+    "version": "yarn run spec && yarn run ts && git add ./api-spec/spec.json ./api-spec/listbox-spec.json ./types/index.d.ts"
   },
   "dependencies": {
     "@types/qlik-engineapi": "12.67.12"
   },
   "devDependencies": {
-    "@emotion/react": "^11.10.6",
-    "@emotion/styled": "^11.10.6",
-    "@mui/icons-material": "^5.11.11",
-    "@mui/material": "^5.11.15",
-    "@nebula.js/conversion": "^4.0.0-alpha.9",
-    "@nebula.js/enigma-mocker": "^4.0.0-alpha.9",
-    "@nebula.js/locale": "^4.0.0-alpha.9",
-    "@nebula.js/nucleus": "^4.0.0-alpha.9",
-    "@nebula.js/supernova": "^4.0.0-alpha.9",
-    "@nebula.js/theme": "^4.0.0-alpha.9",
-    "@nebula.js/ui": "^4.0.0-alpha.9",
+    "@emotion/react": "^11.11.0",
+    "@emotion/styled": "^11.11.0",
+    "@mui/icons-material": "^5.11.16",
+    "@mui/material": "^5.12.3",
+    "@nebula.js/conversion": "^4.0.1",
+    "@nebula.js/enigma-mocker": "^4.0.1",
+    "@nebula.js/locale": "^4.0.1",
+    "@nebula.js/nucleus": "^4.0.1",
+    "@nebula.js/supernova": "^4.0.1",
+    "@nebula.js/theme": "^4.0.1",
+    "@nebula.js/ui": "^4.0.1",
     "@scriptappy/cli": "0.6.0",
     "@scriptappy/to-dts": "1.0.0-beta.4",
     "extend": "3.0.2",
@@ -60,11 +62,11 @@
     "react": "18.2.0",
     "react-dom": "18.2.0",
     "react-test-renderer": "18.2.0",
-    "react-virtualized-auto-sizer": "1.0.7",
-    "react-window": "1.8.8",
-    "react-window-infinite-loader": "1.0.8",
+    "react-virtualized-auto-sizer": "1.0.15",
+    "react-window": "1.8.9",
+    "react-window-infinite-loader": "1.0.9",
     "regenerator-runtime": "0.13.11",
     "semver": "6.3.0"
   },
-  "gitHead": "4041f477f85702b2e55626d5920ca5604a45fbf2"
+  "gitHead": "c105707099dc79c405f01d65cc338f1614ea9750"
 }

package/types/index.d.ts

@@ -132,10 +132,19 @@ export function useAction<A>(factory: ()=>stardust.ActionDefinition<A>, deps?: a
  * Gets the desired constraints that should be applied when rendering the visualization.
  * 
  * The constraints are set on the embed configuration before the visualization is rendered
- * and should respected by you when implementing the visualization.
+ * and should be respected when implementing the visualization.
+ * @deprecated
  */
 export function useConstraints(): stardust.Constraints;
 
+/**
+ * Gets the desired interaction states that should be applied when rendering the visualization.
+ * 
+ * The interactions are set on the embed configuration before the visualization is rendered
+ * and should be respected when implementing the visualization.
+ */
+export function useInteractionState(): stardust.Interactions;
+
 /**
  * Gets the options object provided when rendering the visualization.
  * 
@@ -212,15 +221,13 @@ declare namespace stardust {
     }
 
     interface Context {
-        keyboardNavigation?: boolean;
-        constraints?: {
-            active?: boolean;
-            passive?: boolean;
-            select?: boolean;
-        };
         theme?: string;
         language?: string;
         deviceType?: string;
+        constraints?: stardust.Constraints;
+        interactions?: stardust.Interactions;
+        keyboardNavigation?: boolean;
+        disableCellPadding?: boolean;
     }
 
     interface Galaxy {
@@ -389,14 +396,14 @@ declare namespace stardust {
          * @param eventName Event name to listen to
          * @param listener Callback function to invoke
          */
-        on(eventName: string, listener: ()=>void): void;
+        addListener(eventName: string, listener: ()=>void): void;
 
         /**
          * Removes a listener
          * @param eventName Event name to remove from
          * @param listener Callback function to remove
          */
-        off(eventName: string, listener: ()=>void): void;
+        removeListener(eventName: string, listener: ()=>void): void;
 
     }
 
@@ -427,6 +434,20 @@ declare namespace stardust {
     class ObjectSelections {
         constructor();
 
+        /**
+         * Event listener function on instance
+         * @param eventType event type that function needs to listen
+         * @param callback a callback function to run when event emits
+         */
+        addListener(eventType: string, callback: ()=>void): void;
+
+        /**
+         * Remove listener function on instance
+         * @param eventType event type that function needs to listen
+         * @param callback a callback function to run when event emits
+         */
+        removeListener(eventType: string, callback: ()=>void): void;
+
         /**
          * @param paths
          */
@@ -597,10 +618,21 @@ declare namespace stardust {
         };
     }
 
+    /**
+     * @deprecated
+     */
     interface Constraints {
         passive?: boolean;
         active?: boolean;
         select?: boolean;
+        edit?: boolean;
+    }
+
+    interface Interactions {
+        passive?: boolean;
+        active?: boolean;
+        select?: boolean;
+        edit?: boolean;
     }
 
     interface RenderState {
@@ -612,17 +644,19 @@ declare namespace stardust {
         enabled: boolean;
         active: boolean;
         /**
-         * Function used by the visualization to tell Nebula to it wants to relinquish focus
+         * Function used by the visualization to tell Nebula it wants to relinquish focus
+         * @param $
          */
-        blur?(): void;
+        blur?($: boolean): void;
         /**
-         * Function used by the visualization to tell Nebula to it wants focus
+         * Function used by the visualization to tell Nebula it wants to focus
          */
         focus?(): void;
         /**
-         * Function used by the visualization to tell Nebula to focus the selection toolbar
+         * Function used by the visualization to tell Nebula that focus the selection toolbar
+         * @param $
          */
-        focusSelection?(): void;
+        focusSelection?($: boolean): void;
     }
 
     /**
@@ -673,6 +707,12 @@ declare namespace stardust {
     class Translator {
         constructor();
 
+        /**
+         * Returns current locale.
+         * @param lang language Locale to updated the currentLocale value
+         */
+        language(lang?: string): string;
+
         /**
          * Registers a string in multiple locales
          * @param item
@@ -694,6 +734,11 @@ declare namespace stardust {
     class Theme {
         constructor();
 
+        /**
+         * Returns theme name
+         */
+        name(): string;
+
         getDataColorScales(): stardust.Theme.ScalePalette[];
 
         getDataColorPalettes(): stardust.Theme.DataPalette[];