survey-analytics 1.9.94 → 1.9.96

package/package.json

@@ -20,7 +20,7 @@
     "lint": "eslint ./src --quiet",
     "pre-push-check": "npm run lint && npm run test"
   },
-  "version": "1.9.94",
+  "version": "1.9.96",
   "name": "survey-analytics",
   "description": "SurveyJS analytics Library.",
   "main": "survey.analytics.js",
@@ -58,7 +58,7 @@
     "jquery": "3.5.0",
     "muuri": "^0.8.0",
     "plotly.js-dist-min": "^2.11.1",
-    "survey-core": "1.9.94",
+    "survey-core": "1.9.96",
     "tabulator-tables": "4.8.4",
     "wordcloud": "^1.2.2"
   },

package/survey-analytics.types/visualizationManager.d.ts

@@ -27,9 +27,9 @@ export declare class VisualizationManager {
      * @param questionType A question [type](https://surveyjs.io/form-library/documentation/api-reference/question#getType).
      * @param constructor A function that returns a visualizer constructor to unregister.
      */
-    static unregisterVisualizer(questionType: string, constructor: VisualizerConstructor): void;
+    static unregisterVisualizer(questionType: string | undefined, constructor: VisualizerConstructor): void;
     /**
-     * Unregisters a visualizer for all question types.
+     * Obsolete. Pass `undefined` to the [`unregisterVisualizer`](https://surveyjs.io/dashboard/documentation/api-reference/visualizationmanager#unregisterVisualizer) method instead.
      * @param constructor A function that returns a visualizer constructor to unregister.
      */
     static unregisterVisualizerForAll(constructor: VisualizerConstructor): void;
@@ -40,13 +40,13 @@ export declare class VisualizationManager {
     static getVisualizersByType(questionType: string): VisualizerConstructor[];
     /**
      * Returns a constructor for an alternative visualizer selector.
-     * @see registerAlternativesVisualizer
+     * @see registerAltVisualizerSelector
      */
-    static getAlternativesVisualizer(): any;
+    static getAltVisualizerSelector(): any;
     /**
      * Registers an alternative visualizer selector.
      * @param constructor A function that returns a constructor for an alternative visualizer selector.
      */
-    static registerAlternativesVisualizer(constructor: any): void;
+    static registerAltVisualizerSelector(constructor: any): void;
 }
 export {};

package/survey-analytics.types/visualizationPanel.d.ts

@@ -306,10 +306,11 @@ export declare class VisualizationPanel extends VisualizerBase {
     protected buildElements(questions: any[]): IVisualizerPanelElement[];
     /**
      * Returns an array of [`IVisualizerPanelElement`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizerpanelelement) objects with information about visualization items.
+     * @param questionNames Question [names](https://surveyjs.io/form-library/documentation/api-reference/question#name). Do not specify this parameter to get an array of all visualization items.
      * @see visibleElements
      * @see hiddenElements
      */
-    getElements(): IVisualizerPanelElement[];
+    getElements(questionNames?: Array<string>): IVisualizerPanelElement[];
     /**
      * Returns an array of [`IVisualizerPanelElement`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizerpanelelement) objects with information about currently visible visualization items.
      *
@@ -330,16 +331,21 @@ export declare class VisualizationPanel extends VisualizerBase {
     get privateElements(): IVisualizerPanelRenderedElement[];
     protected get locales(): any;
     /**
-     * Returns panel element description by the question name.
+     * Returns a visualization item with a specified question name.
+     * @param name A question [name](https://surveyjs.io/form-library/documentation/api-reference/question#name).
      */
-    getElement(name: string): IVisualizerPanelRenderedElement;
+    getElement(questionName: string): IVisualizerPanelRenderedElement;
     /**
      * Returns a [visualizer](https://surveyjs.io/dashboard/documentation/api-reference/visualizerbase) that visualizes a specified survey question.
      * @param questionName A question [name](https://surveyjs.io/form-library/documentation/api-reference/question#name).
      */
     getVisualizer(questionName: string): VisualizerBase;
     /**
-     * An event that is raised when users [move a visualization item](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizationpaneloptions#allowDynamicLayout) or [toggle its visibility](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizationpaneloptions#allowHideQuestions).
+     * Obsolete. Use [`onElementShown`](https://surveyjs.io/dashboard/documentation/api-reference/visualizationpanel#onElementShown), [`onElementHidden`](https://surveyjs.io/dashboard/documentation/api-reference/visualizationpanel#onElementHidden), or [`onElementMoved`](https://surveyjs.io/dashboard/documentation/api-reference/visualizationpanel#onElementMoved) instead.
+     */
+    onVisibleElementsChanged: Event<(sender: VisualizationPanel, options: any) => any, VisualizationPanel, any>;
+    /**
+     * An event that is raised when users [show a visualization item](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizationpaneloptions#allowHideQuestions).
      *
      * Parameters:
      *
@@ -347,15 +353,42 @@ export declare class VisualizationPanel extends VisualizerBase {
      * A `VisualizationPanel` that raised the event.
      *
      * - `options.elements`: Array\<[`IVisualizerPanelElement`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizerpanelelement)\>\
-     * Information about visualization items rendered by this `VisualizationPanel`.
+     * Information about all visualization items rendered by this `VisualizationPanel`.
+     *
+     * - `options.element`: [`IVisualizerPanelElement`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizerpanelelement)\
+     * A visualization item that has been shown.
+     */
+    onElementShown: Event<(sender: VisualizationPanel, options: any) => any, VisualizationPanel, any>;
+    /**
+     * An event that is raised when users [hide a visualization item](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizationpaneloptions#allowHideQuestions).
      *
-     * - `options.changed`: [`IVisualizerPanelElement`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizerpanelelement)\
-     * A visualization item that has been changed.
+     * Parameters:
+     *
+     * - `sender`: [`VisualizationPanel`](https://surveyjs.io/dashboard/documentation/api-reference/visualizationpanel)\
+     * A `VisualizationPanel` that raised the event.
+     *
+     * - `options.elements`: Array\<[`IVisualizerPanelElement`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizerpanelelement)\>\
+     * Information about all visualization items rendered by this `VisualizationPanel`.
      *
-     * - `options.reason`: `"ADDED"` | `"REMOVED"` | `"MOVED"`\
-     * Indicates the reason why the event has been raised.
+     * - `options.element`: [`IVisualizerPanelElement`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizerpanelelement)\
+     * A visualization item that has been hidden.
      */
-    onVisibleElementsChanged: Event<(sender: VisualizationPanel, options: any) => any, VisualizationPanel, any>;
+    onElementHidden: Event<(sender: VisualizationPanel, options: any) => any, VisualizationPanel, any>;
+    /**
+     * An event that is raised when users [move a visualization item](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizationpaneloptions#allowDynamicLayout).
+     *
+     * Parameters:
+     *
+     * - `sender`: [`VisualizationPanel`](https://surveyjs.io/dashboard/documentation/api-reference/visualizationpanel)\
+     * A `VisualizationPanel` that raised the event.
+     *
+     * - `options.elements`: Array\<[`IVisualizerPanelElement`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizerpanelelement)\>\
+     * Information about all visualization items rendered by this `VisualizationPanel`.
+     *
+     * - `options.element`: [`IVisualizerPanelElement`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizerpanelelement)\
+     * A visualization item that has been moved.
+     */
+    onElementMoved: Event<(sender: VisualizationPanel, options: any) => any, VisualizationPanel, any>;
     protected visibleElementsChanged(element: IVisualizerPanelElement, reason: string): void;
     onStateChanged: Event<(sender: VisualizationPanel, state: IState) => any, VisualizationPanel, any>;
     onPermissionsChangedCallback: any;

package/survey-analytics.types/visualizerBase.d.ts

@@ -158,12 +158,18 @@ export declare class VisualizerBase implements IDataInfo {
      * Returns the visualizer's type.
      */
     get type(): string;
+    /**
+     * Obsolete. Use [`surveyData`](https://surveyjs.io/dashboard/documentation/api-reference/visualizationpanel#surveyData) instead.
+     */
+    protected get data(): {
+        [index: string]: any;
+    }[];
     /**
      * Returns an array of survey results used to calculate values for visualization. If a user applies a filter, the array is also filtered.
      *
-     * To get an array of calculated and visualized values, call the [`getData()`](https://surveyjs.io/dashboard/documentation/api-reference/visualizerbase#getData) method.
+     * To get an array of calculated and visualized values, call the [`getCalculatedValues()`](https://surveyjs.io/dashboard/documentation/api-reference/visualizerbase#getCalculatedValues) method.
      */
-    protected get data(): {
+    protected get surveyData(): {
         [index: string]: any;
     }[];
     protected get dataProvider(): DataProvider;
@@ -223,12 +229,16 @@ export declare class VisualizerBase implements IDataInfo {
      */
     get showToolbar(): boolean;
     set showToolbar(newValue: boolean);
+    /**
+     * Obsolete. Use [`getCalculatedValues()`](https://surveyjs.io/dashboard/documentation/api-reference/visualizationpanel#getCalculatedValues) instead.
+     */
+    getData(): any;
     /**
      * Returns an array of calculated and visualized values. If a user applies a filter, the array is also filtered.
      *
-     * To get an array of source survey results, use the [`data`](https://surveyjs.io/dashboard/documentation/api-reference/visualizerbase#data) property.
+     * To get an array of source survey results, use the [`surveyData`](https://surveyjs.io/dashboard/documentation/api-reference/visualizerbase#surveyData) property.
      */
-    getData(): any;
+    getCalculatedValues(): any;
     /**
      * Returns an object with properties that describe a current visualizer state. The properties are different for each individual visualizer.
      *

package/survey.analytics.css

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - SurveyJS Dashboard library v1.9.94
+ * surveyjs - SurveyJS Dashboard library v1.9.96
  * Copyright (c) 2015-2023 Devsoft Baltic OÜ  - http://surveyjs.io/
  * License: MIT (http://www.opensource.org/licenses/mit-license.php)
  */

package/survey.analytics.datatables.css

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - SurveyJS Dashboard library v1.9.94
+ * surveyjs - SurveyJS Dashboard library v1.9.96
  * Copyright (c) 2015-2023 Devsoft Baltic OÜ  - http://surveyjs.io/
  * License: MIT (http://www.opensource.org/licenses/mit-license.php)
  */

package/survey.analytics.datatables.js

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - SurveyJS Dashboard library v1.9.94
+ * surveyjs - SurveyJS Dashboard library v1.9.96
  * Copyright (c) 2015-2023 Devsoft Baltic OÜ  - http://surveyjs.io/
  * License: MIT (http://www.opensource.org/licenses/mit-license.php)
  */

package/survey.analytics.datatables.min.css

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - SurveyJS Dashboard library v1.9.94
+ * surveyjs - SurveyJS Dashboard library v1.9.96
  * Copyright (c) 2015-2023 Devsoft Baltic OÜ  - http://surveyjs.io/
  * License: MIT (http://www.opensource.org/licenses/mit-license.php)
  */

package/survey.analytics.datatables.min.js

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - SurveyJS Dashboard library v1.9.94
+ * surveyjs - SurveyJS Dashboard library v1.9.96
  * Copyright (c) 2015-2023 Devsoft Baltic OÜ  - http://surveyjs.io/
  * License: MIT (http://www.opensource.org/licenses/mit-license.php)
  */