survey-analytics 1.9.84 → 1.9.86

package/survey.analytics.d.ts

@@ -227,6 +227,60 @@ declare module "analytics-localization/french" {
         responses: string;
     };
 }
+declare module "analytics-localization/german" {
+    export var germanStrings: {
+        groupButton: string;
+        ungroupButton: string;
+        selectButton: string;
+        hideColumn: string;
+        showColumn: string;
+        makePrivateColumn: string;
+        makePublicColumn: string;
+        moveToDetail: string;
+        showAsColumn: string;
+        filterPlaceholder: string;
+        removeRows: string;
+        showLabel: string;
+        entriesLabel: string;
+        visualizer_text: string;
+        visualizer_wordcloud: string;
+        chartType_bar: string;
+        chartType_stackedbar: string;
+        chartType_doughnut: string;
+        chartType_pie: string;
+        chartType_scatter: string;
+        chartType_gauge: string;
+        chartType_bullet: string;
+        hideButton: string;
+        makePrivateButton: string;
+        makePublicButton: string;
+        showButton: string;
+        filter: string;
+        resetFilter: string;
+        changeLocale: string;
+        clearButton: string;
+        addElement: string;
+        defaultOrder: string;
+        ascOrder: string;
+        descOrder: string;
+        showMinorColumns: string;
+        otherCommentTitle: string;
+        showPercentages: string;
+        hidePercentages: string;
+        pdfDownloadCaption: string;
+        xlsxDownloadCaption: string;
+        csvDownloadCaption: string;
+        saveDiagramAsPNG: string;
+        hideEmptyAnswers: string;
+        showEmptyAnswers: string;
+        "topNValueText-1": string;
+        topNValueText5: string;
+        topNValueText10: string;
+        topNValueText20: string;
+        noVisualizerForQuestion: string;
+        noResults: string;
+    };
+}
 declare module "analytics-localization/norwegian" {
     export var norwegianStrings: {
         groupButton: string;
@@ -621,16 +675,8 @@ declare module "analytics-localization/arabic" {
 }
 declare module "dataProvider" {
     import { Event } from "survey-core";
-    /**
-     * Describes data info:
-     * dataName - question name, used as a key to obtain question data
-     * getValues - function returning an array of all possible values
-     * getLabels - function returning an array of human-friendly descriptions for values
-     * getSeriesValues - function returning an array of all possible series values
-     * getSeriesLabels - function returning an array of human-friendly descriptions for series values
-     */
     export interface IDataInfo {
-        dataName: string | Array<string>;
+        name: string | Array<string>;
         getValues(): Array<any>;
         getLabels(): Array<string>;
         getSeriesValues(): Array<string>;
@@ -675,7 +721,9 @@ declare module "visualizationManager" {
         [index: string]: any;
     }>, options?: Object) => any;
     /**
-     * Visualizers repository. You need to register a visualizer, link it to the question type name in order to visualize the question answers with the certain representation.
+     * An object with methods used to register and unregister visualizers for individual question types.
+     *
+     * [View Demo](https://surveyjs.io/dashboard/examples/visualize-answers-from-text-entry-fields-with-charts/ (linkStyle))
      */
     export class VisualizationManager {
         static alternativesVisualizer: any;
@@ -683,27 +731,39 @@ declare module "visualizationManager" {
             [index: string]: Array<VisualizerConstructor>;
         };
         /**
-         * Register visualizer (constructor) for question type.
+         * Registers a visualizer for a specified question type.
+         *
+         * [View Demo](https://surveyjs.io/dashboard/examples/visualize-answers-from-text-entry-fields-with-charts/ (linkStyle))
+         * @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 register.
          */
-        static registerVisualizer(typeName: string, constructor: VisualizerConstructor): void;
+        static registerVisualizer(questionType: string, constructor: VisualizerConstructor): void;
         /**
-         * Unregister visualizer (constructor) for question type.
+         * Unregisters a visualizer for a specified question type.
+         *
+         * [View Demo](https://surveyjs.io/dashboard/examples/visualize-answers-from-text-entry-fields-with-charts/ (linkStyle))
+         * @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(typeName: string, constructor: VisualizerConstructor): void;
+        static unregisterVisualizer(questionType: string, constructor: VisualizerConstructor): void;
         /**
-         * Unregister visualizer (constructor) for all question types.
+         * Unregisters a visualizer for all question types.
+         * @param constructor A function that returns a visualizer constructor to unregister.
          */
         static unregisterVisualizerForAll(constructor: VisualizerConstructor): void;
         /**
-         * Get visualizers (constructors) for question type.
+         * Returns all visualizer constructors for a specified question type.
+         * @param questionType A question [type](https://surveyjs.io/form-library/documentation/api-reference/question#getType).
          */
-        static getVisualizersByType(typeName: string): VisualizerConstructor[];
+        static getVisualizersByType(questionType: string): VisualizerConstructor[];
         /**
-         * Get visualizers (constructors) for question type.
+         * Returns a constructor for an alternative visualizer selector.
+         * @see registerAlternativesVisualizer
          */
         static getAlternativesVisualizer(): any;
         /**
-         * Register visualizer (constructor) for question type.
+         * Registers an alternative visualizer selector.
+         * @param constructor A function that returns a constructor for an alternative visualizer selector.
          */
         static registerAlternativesVisualizer(constructor: any): void;
     }
@@ -712,12 +772,16 @@ declare module "visualizerFactory" {
     import { Question } from "survey-core";
     import { VisualizerBase } from "visualizerBase";
     /**
-     * Visualizers factory. Creates visualizer for the given question.
+     * An object that allows you to create individual visualizers without creating a [visualization panel](https://surveyjs.io/dashboard/documentation/api-reference/visualizationpanel).
      */
     export class VisualizerFactory {
         /**
-         * Create visualizer by question. You can pass data and options to the created visualizer as well.
-         * If more then one visualizer are registered for the question, then they are combined using wrapper for showing alternative viaualizers.
+         * Creates a visualizer for a specified question.
+         *
+         * If a question has more than one [registered](https://surveyjs.io/dashboard/documentation/api-reference/visualizationmanager#registerVisualizer) visualizer, users can switch between them using a drop-down menu.
+         * @param question A question for which to create a visualizer.
+         * @param data A data array with survey results to be visualized.
+         * @param options An object with any custom properties you need within the visualizer.
          */
         static createVisualizer(question: Question, data: Array<{
             [index: string]: any;
@@ -770,28 +834,36 @@ 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;
         options: {
             [index: string]: any;
         };
-        private _name?;
-        private _showHeader;
+        private _type?;
+        private _showToolbar;
         private _footerVisualizer;
         private _dataProvider;
         labelTruncateLength: number;
@@ -803,14 +875,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;
@@ -822,63 +911,56 @@ declare module "visualizerBase" {
             [index: string]: any;
         }>, options?: {
             [index: string]: any;
-        }, _name?: string);
+        }, _type?: string);
         protected get questionOptions(): any;
         protected onDataChanged(): void;
+        get name(): string | Array<string>;
         /**
-         * 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;
+        get type(): 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 +968,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, header, 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 +989,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 +1008,41 @@ declare module "visualizerBase" {
         private static colors;
         getColors(count?: number): any;
         /**
-         * Returns whether the visualizer renders it header.
-         */
-        get showHeader(): boolean;
-        /**
-         * Sets whether the visualizer renders it header.
+         * Gets or sets the visibility of the visualizer's toolbar.
+         *
+         * Default value: `true`
          */
-        set showHeader(newValue: boolean);
+        get showToolbar(): boolean;
+        set showToolbar(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;
     }
@@ -1205,7 +1296,7 @@ declare module "alternativeVizualizersWrapper" {
         * quiet - set it to true if you don't want to rise a notification event
         *
         **/
-        setVisualizer(name: string, quiet?: boolean): void;
+        setVisualizer(type: string, quiet?: boolean): void;
         updateData(data: Array<{
             [index: string]: any;
         }>): void;
@@ -1218,12 +1309,31 @@ declare module "alternativeVizualizersWrapper" {
     }
 }
 declare module "config" {
+    /**
+     * An interface that describes a visualization item (chart, gauge, etc.).
+     *
+     * To access `IVisualizerPanelElement` objects, you can use the following properties and methods of `VisualizationPanel`:
+     *
+     * - [`getElements()`](https://surveyjs.io/dashboard/documentation/api-reference/visualizationpanel#getElements)
+     * - [`visibleElements`](https://surveyjs.io/dashboard/documentation/api-reference/visualizationpanel#visibleElements)
+     * - [`hiddenElements`](https://surveyjs.io/dashboard/documentation/api-reference/visualizationpanel#hiddenElements)
+     */
     export interface IVisualizerPanelElement {
+        /**
+         * The name of a survey question visualized by this item.
+         */
         name: string;
+        /**
+         * The title of a survey question visualized by this item. The visualization item displays the same title.
+         */
         displayName: string;
+        /**
+         * Indicates whether the visualization item is currently visible.
+         *
+         * If you want to disallow users to hide visualization items, set the [`allowHideQuestions`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizationpaneloptions#allowHideQuestions) property to `false`.
+         */
         isVisible: boolean;
         isPublic: boolean;
-        type?: string;
         chartType?: string;
         answersOrder?: string;
         hideEmptyAnswers?: boolean;
@@ -1253,8 +1363,7 @@ declare module "filterInfo" {
 }
 declare module "layoutEngine" {
     /**
-     * LayoutEngine controls visualizer layoput in a visualization panel.
-     * You can create a descendant of this class in order to override layout.
+     * A base class used to implement custom layout engines or integrate third-party layout engines with SurveyJS Dashboard.
      */
     export class LayoutEngine {
         protected _allowed: boolean;
@@ -1264,15 +1373,17 @@ declare module "layoutEngine" {
         protected updateCore(): void;
         get allowed(): boolean;
         /**
-         * Initilizes layout engine in the given HTML element.
+         * Enables the dynamic layout in a given HTML element.
+         *
+         * This method should arrange visualization items based on the available screen space and allow users to reorder them via drag and drop.
          */
         start(container: HTMLElement): void;
         /**
-         * Deactivates layouting: stops elements auto-positioning
+         * Disables the dynamic layout.
          */
         stop(): void;
         /**
-         * Updates layout: performs elements auto-positioning
+         * Updates the dynamic layout.
          */
         update(): void;
         add(elements: Array<HTMLElement>, options?: any): void;
@@ -1303,10 +1414,16 @@ declare module "visualizationPanel" {
         renderedElement?: HTMLElement;
     }
     /**
-     * Visualization Panel configuration. Pass it as the third argument to the `VisualizationPanel` constructor:
+     * Visualization Panel configuration. Pass it as the third argument to the [`VisualizationPanel`](https://surveyjs.io/dashboard/documentation/api-reference/visualizationpanel) constructor:
      *
      * ```js
-     * const vizPanel = new SurveyAnalytics.VisualizationPanel(surveyQuestions, surveyResults, vizPanelOptions);
+     * import { VisualizationPanel } from "survey-analytics";
+     *
+     * const vizPanel = new VisualizationPanel(
+     *   surveyQuestions,
+     *   surveyResults,
+     *   vizPanelOptions
+     * );
      * ```
      */
     export interface IVisualizationPanelOptions {
@@ -1516,14 +1633,18 @@ declare module "visualizationPanel" {
         stripHtmlFromTitles?: boolean;
     }
     /**
-     * VisualizationPanel is responsible for visualizing an array of survey questions
-     * <br/>
-     * <br/> constructor parameters:
-     * <br/> questions - an array of survey questions to visualize,
-     * <br/> data - an array of answers in format of survey result,
-     * <br/> options - object of the IVisualizationPanelOptions type, @see IVisualizationPanelOptions
-     * <br/> elements - list of visual element descriptions
+     * An object that visualizes survey results and allows users to analyze them.
+     *
+     * Constructor parameters:
      *
+     * - `questions`: Array\<[`Question`](https://surveyjs.io/form-library/documentation/api-reference/question)\>\
+     * Survey questions to visualize. Call `SurveyModel`'s [`getAllQuestions()`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#getQuestionByName) method to access all survey questions and pass its result as the `questions` parameter.
+     * - `data`: `Array<any>`\
+     * Survey results.
+     * - `options`: [`IVisualizationPanelOptions`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizationpaneloptions)\
+     * Visualization Panel configuration.
+     *
+     * [View Demo](https://surveyjs.io/dashboard/examples/interactive-survey-data-dashboard/ (linkStyle))
      */
     export class VisualizationPanel extends VisualizerBase {
         protected questions: Array<any>;
@@ -1560,43 +1681,43 @@ declare module "visualizationPanel" {
         private destroyVisualizers;
         protected setLocale(newLocale: string): void;
         /**
-         * Returns whether the VisualizationPanel allows dynamic layouting - rearrange items via drap/drop. Set via options.
+         * Returns the [`allowDynamicLayout`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizationpaneloptions#allowDynamicLayout) property value of the [`IVisualizationPanelOptions`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizationpaneloptions) object.
          */
         get allowDynamicLayout(): boolean;
         /**
-         * Returns whether the VisualizationPanel allows to hide/show individual inner visualizers.
+         * Returns the [`allowHideQuestions`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizationpaneloptions#allowHideQuestions) property value of the [`IVisualizationPanelOptions`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizationpaneloptions) object.
          */
         get allowHideQuestions(): boolean;
-        /**
-         * Returns whether the VisualizationPanel allows to make private/public individual inner visualizers for work with permissions.
-         */
         get allowMakeQuestionsPrivate(): boolean;
         private _layoutEngine;
         /**
-         * Returns the layout engine instance if any.
+         * Returns a [`LayoutEngine`](https://surveyjs.io/dashboard/documentation/api-reference/layoutengine) instance used to arrange visualization items on `VisualizationPanel`.
          */
         get layoutEngine(): LayoutEngine;
         protected buildElements(questions: any[]): IVisualizerPanelElement[];
         /**
-         * Returns panel elements descriptions array.
-         * Inner visualizers are rendered in the order of this array and with titles from the displayName property
+         * Returns an array of [`IVisualizerPanelElement`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizerpanelelement) objects with information about visualization items.
+         * @see visibleElements
+         * @see hiddenElements
          */
         getElements(): IVisualizerPanelElement[];
         /**
-         * Returns panel's visible elements.
+         * Returns an array of [`IVisualizerPanelElement`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizerpanelelement) objects with information about currently visible visualization items.
+         *
+         * If you want to disallow users to hide visualization items, set the [`allowHideQuestions`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizationpaneloptions#allowHideQuestions) property to `false`.
+         * @see hiddenElements
+         * @see getElements
          */
         get visibleElements(): IVisualizerPanelRenderedElement[];
         /**
-         * Returns panel's hidden elements.
+         * Returns an array of [`IVisualizerPanelElement`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizerpanelelement) objects with information about currently hidden visualization items.
+         *
+         * If you want to disallow users to hide visualization items, set the [`allowHideQuestions`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizationpaneloptions#allowHideQuestions) property to `false`.
+         * @see visibleElements
+         * @see getElements
          */
         get hiddenElements(): IVisualizerPanelRenderedElement[];
-        /**
-         * Returns panel's public elements.
-         */
         get publicElements(): IVisualizerPanelRenderedElement[];
-        /**
-         * Returns panel's private elements.
-         */
         get privateElements(): IVisualizerPanelRenderedElement[];
         protected get locales(): any;
         /**
@@ -1604,63 +1725,53 @@ declare module "visualizationPanel" {
          */
         getElement(name: string): IVisualizerPanelRenderedElement;
         /**
-         * Returns panel element visualizer by the question name.
+         * 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(visualizerName: string): VisualizerBase;
+        getVisualizer(questionName: string): VisualizerBase;
         /**
-         * Fires when element visibility has been changed.
-         * options:
-         * elements - panel elements array
-         * changed - changed element
-         * reason - reason (string) why event fired: "ADDED", "MOVED" or "REMOVED"
+         * 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).
+         *
+         * 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 visualization items rendered by this `VisualizationPanel`.
+         *
+         * - `options.changed`: [`IVisualizerPanelElement`](https://surveyjs.io/dashboard/documentation/api-reference/ivisualizerpanelelement)\
+         * A visualization item that has been changed.
+         *
+         * - `options.reason`: `"ADDED"` | `"REMOVED"` | `"MOVED"`\
+         * Indicates the reason why the event has been raised.
          */
         onVisibleElementsChanged: Event<(sender: VisualizationPanel, options: any) => any, VisualizationPanel, any>;
         protected visibleElementsChanged(element: IVisualizerPanelElement, reason: string): void;
-        /**
-         * Fires when vizualization panel state changed.
-         * sender - this panel
-         * state - new state of the panel
-         */
         onStateChanged: Event<(sender: VisualizationPanel, state: IState) => any, VisualizationPanel, any>;
-        /**
-         * Fires when permissions changed
-         */
         onPermissionsChangedCallback: any;
         protected renderPanelElement(element: IVisualizerPanelRenderedElement, container: HTMLElement): HTMLElement;
         protected renderToolbar(container: HTMLElement): void;
-        /**
-         * Renders all questions into given HTML container element.
-         * container - HTML element to render the panel
-         */
         renderContent(container: HTMLElement): void;
         protected destroyContent(container: HTMLElement): void;
         /**
-         * Redraws visualizer toobar and all inner content.
+         * Redraws the `VisualizationPanel` and all its content.
          */
         refresh(): void;
-        /**
-         * Updates layout of visualizer inner content.
-         */
         layout(): void;
         /**
-         * Sets filter by question name and value.
+         * Filters visualized data based on a specified question name and value. This method is called when a user clicks a chart point.
+         * @param questionName A question [name](https://surveyjs.io/form-library/documentation/api-reference/question#name).
+         * @param selectedValue
+         * @see IVisualizationPanelOptions.allowSelection
          */
         setFilter(questionName: string, selectedValue: any): void;
-        /**
-         * Gets vizualization panel state.
-         */
         get state(): IState;
         /**
          * Sets vizualization panel state.
          */
         set state(newState: IState);
-        /**
-         * Gets vizualization panel permissions.
-         */
         get permissions(): IPermission[];
-        /**
-         * Sets vizualization panel permissions.
-         */
         set permissions(permissions: IPermission[]);
         destroy(): void;
     }
@@ -1678,7 +1789,7 @@ declare module "visualizationPanelDynamic" {
         }, name?: string);
         protected setLocale(newLocale: string): void;
         private onAfterRenderPanelCallback;
-        get name(): string;
+        get type(): string;
         private updatePanelVisualizerData;
         updateData(data: Array<{
             [index: string]: any;
@@ -1697,7 +1808,7 @@ declare module "visualizationMatrixDynamic" {
         constructor(question: Question, data: Array<{
             [index: string]: any;
         }>, options?: Object);
-        get name(): string;
+        get type(): string;
         getQuestions(): Question[];
     }
 }
@@ -1831,7 +1942,7 @@ declare module "matrixDropdownGrouped" {
             [index: string]: any;
         }>, options?: Object, name?: string);
         protected get matrixQuestion(): QuestionMatrixDropdownModel;
-        get dataName(): string | Array<string>;
+        get name(): string | Array<string>;
         getSeriesValues(): Array<string>;
         getSeriesLabels(): Array<string>;
         valuesSource(): Array<ItemValue>;
@@ -1988,6 +2099,7 @@ declare module "entries/summary" {
     export * from "localizationManager";
     import "analytics-localization/farsi";
     import "analytics-localization/french";
+    import "analytics-localization/german";
     import "analytics-localization/norwegian";
     import "analytics-localization/portuguese";
     import "analytics-localization/russian";