survey-analytics 1.9.84 → 1.9.85

package/package.json

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

package/survey.analytics.css

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

package/survey.analytics.d.ts

@@ -770,20 +770,28 @@ declare module "visualizerBase" {
     import { IDataInfo, DataProvider } from "dataProvider";
     import { Event } from "survey-core";
     /**
-     * VisualizerBase is a base object for all visuzlizers. It responsible for the rendering and destroying visualizer.
+     * A base object for all visualizers. Use it to implement a custom visualizer.
      *
-     * constructor parameters:
-     * question - a survey question to visualize,
-     * data - an array of answers in format of survey result,
-     * options - object with the following options,
-     * name - visualizer name
+     * Constructor parameters:
      *
-     * options:
-     * seriesValues - an array of series values in data to group data by series,
-     * seriesLabels - labels for series to display, if not passed the seriesValues are used as labels,
-     * survey - pass survey instance to use localses from the survey JSON,
-     * dataProvider - dataProvider for this visualizer,
+     * - `question`: [`Question`](https://surveyjs.io/form-library/documentation/api-reference/question)\
+     * A survey question to visualize.
+     * - `data`: `Array<any>`\
+     * Survey results.
+     * - `options`\
+     * An object with the following properties:
+     *    - `seriesValues`: `Array<String>`\
+     *    Series values used to group data.
+     *    - `seriesLabels`: `Array<String>`\
+     *    Series labels to display. If this property is not set, `seriesValues` are used as labels.
+     *    - `survey`: [`SurveyModel`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model)\
+     *    Pass a `SurveyModel` instance if you want to use locales from the survey JSON schema.
+     *    - `dataProvider`: `DataProvider`\
+     *    A data provider for this visualizer.
+     * - `name`: `String`\
+     * *(Optional)* The visualizer's name.
      *
+     * [View Demo](https://surveyjs.io/dashboard/examples/how-to-plot-survey-data-in-custom-bar-chart/ (linkStyle))
      */
     export class VisualizerBase implements IDataInfo {
         question: Question;
@@ -803,14 +811,31 @@ declare module "visualizerBase" {
         protected _supportSelection: boolean;
         static otherCommentCollapsed: boolean;
         /**
-         * The event is fired right after a visualizer's content is rendered in DOM.
+         * An event that is raised after the visualizer's content is rendered.
+         *
+         * Parameters:
+         *
+         * - `sender`: `VisualizerBase`\
+         * A `VisualizerBase` instance that raised the event.
+         *
+         * - `options.htmlElement`: `HTMLElement`\
+         * A page element with the visualizer's content.
+         * @see render
+         * @see refresh
          **/
         onAfterRender: Event<(sender: VisualizerBase, options: any) => any, VisualizerBase, any>;
         protected afterRender(contentContainer: HTMLElement): void;
         /**
-         * Fires when visualizer locale changed.
-         * sender - this visualizer
-         * locale - new locale of the visualizer
+         * An event that is raised after a new locale is set.
+         *
+         * Parameters:
+         *
+         * - `sender`: `VisualizerBase`\
+         * A `VisualizerBase` instance that raised the event.
+         *
+         * - `options.locale`: `String`\
+         * The indentifier of a new locale (for example, "en").
+         * @see locale
          */
         onLocaleChanged: Event<(sender: VisualizerBase, options: {
             locale: string;
@@ -825,60 +850,53 @@ declare module "visualizerBase" {
         }, _name?: string);
         protected get questionOptions(): any;
         protected onDataChanged(): void;
-        /**
-         * Name of the data field of data object from the data array.
-         */
         get dataName(): string | Array<string>;
         /**
-         * Indicates whether visualizer has header. Usually it is true then a question has correct answer.
+         * Indicates whether the visualizer displays a header. This property is `true` when a visualized question has a correct answer.
+         * @see hasFooter
          */
         get hasHeader(): boolean;
         /**
-         * Indicates whether visualizer has footer. Usually it is true then a question has comment or choices question has other item.
+         * Indicates whether the visualizer displays a footer. This property is `true` when a visualized question has a comment.
+         * @see hasHeader
          */
         get hasFooter(): boolean;
         protected createVisualizer<T = VisualizerBase>(question: Question): T;
         /**
-         * Footer visualizer getter.
+         * Allows you to access the footer visualizer. Returns `undefined` if the footer is absent.
+         * @see hasFooter
          */
         get footerVisualizer(): VisualizerBase;
         /**
-         * Indicates whether visualizer supports selection. Visualizers of questions with choices allow to select choice by clicking on the diagram bar and filter other data for the selected item.
+         * Indicates whether users can select series points to cross-filter charts. To allow or disallow selection, set the `allowSelection` property of the `options` object in the constructor.
          */
         get supportSelection(): boolean;
-        /**
-         * Series values getter. Some questions (used in matrices) should be grouped by matrix rows. This groups are called series.
-         */
         getSeriesValues(): Array<string>;
-        /**
-         * Series labels getter. Some questions (used in matrices) should be grouped by matrix rows. This groups are called series.
-         */
         getSeriesLabels(): Array<string>;
-        /**
-         * Available values of question answers (available choices).
-         */
         getValues(): Array<any>;
-        /**
-         * Available labels of question answers (human readable representation of available choices).
-         */
         getLabels(): Array<string>;
         /**
-         * Registers creator of visualizer toolbar item.
+         * Registers a function used to create a toolbar item for this visualizer.
+         * @param name A custom name for the toolbar item.
+         * @param creator A function that accepts the toolbar and should return an `HTMLElement` with the toolbar item.
          */
         registerToolbarItem(name: string, creator: (toolbar?: HTMLDivElement) => HTMLElement): void;
         /**
-         * The name of the visaulizer.
+         * Returns the visualizer's name.
          */
         get name(): string;
         /**
-         * The actual data of the visaulizer.
+         * 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.
          */
         protected get data(): {
             [index: string]: any;
         }[];
         protected get dataProvider(): DataProvider;
         /**
-         * Updates visualizer data.
+         * Updates visualized data.
+         * @param data A data array with survey results to be visualized.
          */
         updateData(data: Array<{
             [index: string]: any;
@@ -886,11 +904,14 @@ declare module "visualizerBase" {
         onUpdate: () => void;
         invokeOnUpdate(): void;
         /**
-         * Destroys visualizer.
+         * Deletes the visualizer and all its elements from the DOM.
+         * @see clear
          */
         destroy(): void;
         /**
-         * Method for clearing all rendered elements from outside.
+         * Empties the toolbar, footer, and content containers.
+         *
+         * If you want to empty and delete the visualizer and all its elements from the DOM, call the [`destroy()`](https://surveyjs.io/dashboard/documentation/api-reference/visualizerbase#destroy) method instead.
          */
         clear(): void;
         protected createToolbarItems(toolbar: HTMLDivElement): void;
@@ -904,11 +925,12 @@ declare module "visualizerBase" {
         protected destroyFooter(container: HTMLElement): void;
         protected renderFooter(container: HTMLElement): void;
         /**
-         * Renders visualizer in the given container.
+         * Renders the visualizer in a specified container.
+         * @param targetElement An `HTMLElement` or an `id` of a page element in which you want to render the visualizer.
          */
         render(targetElement: HTMLElement | string): void;
         /**
-         * Redraws visualizer and all inner content.
+         * Re-renders the visualizer and its content.
          */
         refresh(): void;
         protected processText(text: string): string;
@@ -922,36 +944,41 @@ declare module "visualizerBase" {
         private static colors;
         getColors(count?: number): any;
         /**
-         * Returns whether the visualizer renders it header.
+         * Gets or sets the visibility of the visualizer's toolbar.
+         *
+         * Default value: `true`
          */
         get showHeader(): boolean;
-        /**
-         * Sets whether the visualizer renders it header.
-         */
         set showHeader(newValue: boolean);
         /**
-         * Returns data to be used in the visualizer.
+         * 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.
          */
         getData(): any;
         /**
-         * Returns visualizer state - options control visualizer behavior and rendering.
-         * Overriden in descendants
+         * Returns an object with properties that describe a current visualizer state. The properties are different for each individual visualizer.
+         *
+         * > This method is overriden in descendant classes.
+         * @see setState
          */
         getState(): any;
         /**
-         * Sets visualizer state - options control visualizer behavior and rendering.
-         * Overriden in descendants
+         * Sets the visualizer's state.
+         *
+         * > This method is overriden in descendant classes.
+         * @see getState
          */
         setState(state: any): void;
         /**
-         * Returns current locale of the visualizer.
-         * If locales more than one, the language selection dropdown will be added in the toolbar
-         * In order to use survey locales the survey instance object should be passed as 'survey' option for visualizer
+         * Gets or sets the current locale.
+         *
+         * If you want to inherit the locale from a visualized survey, assign a `SurveyModel` instance to the `survey` property of the `options` object in the constructor.
+         *
+         * If the survey is [translated into more than one language](https://surveyjs.io/form-library/examples/survey-localization/), the toolbar displays a language selection drop-down menu.
+         * @see onLocaleChanged
          */
         get locale(): string;
-        /**
-         * Sets locale for visualization panel.
-         */
         set locale(newLocale: string);
         protected setLocale(newLocale: string): void;
     }
@@ -1223,7 +1250,6 @@ declare module "config" {
         displayName: string;
         isVisible: boolean;
         isPublic: boolean;
-        type?: string;
         chartType?: string;
         answersOrder?: string;
         hideEmptyAnswers?: boolean;
@@ -1306,7 +1332,11 @@ declare module "visualizationPanel" {
      * Visualization Panel configuration. Pass it as the third argument to the `VisualizationPanel` constructor:
      *
      * ```js
-     * const vizPanel = new SurveyAnalytics.VisualizationPanel(surveyQuestions, surveyResults, vizPanelOptions);
+     * const vizPanel = new SurveyAnalytics.VisualizationPanel(
+     *   surveyQuestions,
+     *   surveyResults,
+     *   vizPanelOptions
+     * );
      * ```
      */
     export interface IVisualizationPanelOptions {

package/survey.analytics.datatables.css

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - SurveyJS Dashboard library v1.9.84
+ * surveyjs - SurveyJS Dashboard library v1.9.85
  * 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.84
+ * surveyjs - SurveyJS Dashboard library v1.9.85
  * 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.84
+ * surveyjs - SurveyJS Dashboard library v1.9.85
  * 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.84
+ * surveyjs - SurveyJS Dashboard library v1.9.85
  * Copyright (c) 2015-2023 Devsoft Baltic OÜ  - http://surveyjs.io/
  * License: MIT (http://www.opensource.org/licenses/mit-license.php)
  */