survey-analytics 1.9.88 → 1.9.90

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

@@ -0,0 +1,371 @@
+import { Event, SurveyModel } from "survey-core";
+import { VisualizerBase } from "./visualizerBase";
+import { AlternativeVisualizersWrapper } from "./alternativeVizualizersWrapper";
+import { IVisualizerPanelElement, IState, IPermission } from "./config";
+import { LayoutEngine } from "./layoutEngine";
+import { DataProvider } from "./dataProvider";
+export interface IVisualizerPanelRenderedElement extends IVisualizerPanelElement {
+    renderedElement?: HTMLElement;
+}
+/**
+ * Visualization Panel configuration. Pass it as the third argument to the [`VisualizationPanel`](https://surveyjs.io/dashboard/documentation/api-reference/visualizationpanel) constructor:
+ *
+ * ```js
+ * import { VisualizationPanel } from "survey-analytics";
+ *
+ * const vizPanel = new VisualizationPanel(
+ *   surveyQuestions,
+ *   surveyResults,
+ *   vizPanelOptions
+ * );
+ * ```
+ */
+export interface IVisualizationPanelOptions {
+    /**
+     * The number of label characters after which truncation starts.
+     *
+     * Set this property to -1 to disable truncation.
+     *
+     * Default value: 27
+     */
+    labelTruncateLength?: number;
+    allowMakeQuestionsPrivate?: boolean;
+    seriesValues?: string[];
+    seriesLabels?: string[];
+    useValuesAsLabels?: boolean;
+    /**
+     * Pass a survey instance to use survey locales in the Visualization Panel.
+     */
+    survey?: SurveyModel;
+    /**
+     * A common data provider for all visualizers.
+     */
+    dataProvider?: DataProvider;
+    /**
+     * Allows users to change the visibility of individual charts.
+     *
+     * This property adds a Hide button to each chart.
+     *
+     * Default value: `true`
+     */
+    allowHideQuestions?: boolean;
+    /**
+     * Specifies whether to arrange charts based on the available screen space and allow users to reorder them via drag and drop.
+     *
+     * If this property is disabled, charts are displayed one under the other and users cannot reorder them.
+     *
+     * Default value: `true`
+     *
+     * [View Demo](https://surveyjs.io/Examples/Analytics?id=custom-layout (linkStyle))
+     *
+     * @see layoutEngine
+     */
+    allowDynamicLayout?: boolean;
+    /**
+     * A layout engine used to arrange charts on the Visualization Panel.
+     *
+     * You can use this property to integrate a third-party layout engine with SurveyJS Dashboard.
+     *
+     * @see allowDynamicLayout
+     */
+    layoutEngine?: LayoutEngine;
+    /**
+     * Allows users to switch between absolute and percentage values in bar charts.
+     *
+     * This property adds a Show Percentages button to each bar chart.
+     *
+     * Default value: `false`
+     *
+     * @see showPercentages
+     * @see showOnlyPercentages
+     * @see percentagePrecision
+     */
+    allowShowPercentages?: boolean;
+    /**
+     * Specifies whether bar charts display percentages in addition to absolute values.
+     *
+     * Users can change this property value if you enable the `allowShowPercentages` property.
+     *
+     * Default value: `false`
+     *
+     * @see allowShowPercentages
+     * @see showOnlyPercentages
+     * @see percentagePrecision
+     */
+    showPercentages?: boolean;
+    /**
+     * Specifies whether bar charts display only percentages, without absolute values.
+     *
+     * Applies only if the `allowShowPercentages` or `showPercentages` property is enabled.
+     *
+     * Default value: `false`
+     *
+     * @see allowShowPercentages
+     * @see showPercentages
+     * @see percentagePrecision
+     */
+    showOnlyPercentages?: boolean;
+    /**
+     * Specifies percentage precision.
+     *
+     * Default value: 0
+     *
+     * @see allowShowPercentages
+     * @see showPercentages
+     * @see showOnlyPercentages
+     */
+    percentagePrecision?: number;
+    /**
+     * Removes the Free Trial bar.
+     *
+     * Default value: `false`
+     *
+     * > You can enable this property only if you have a SurveyJS Dashboard commercial license. It is illegal to enable this property without a license.
+     */
+    haveCommercialLicense?: boolean;
+    /**
+     * Allows users to sort answers by answer count. Applies only to bar and scatter charts.
+     *
+     * This property adds a Sorting dropdown to each bar and scatter chart.
+     *
+     * Default value: `true`
+     *
+     * @see answersOrder
+     */
+    allowChangeAnswersOrder?: boolean;
+    /**
+     * Specifies how to sort answers in bar and scatter charts.
+     * Accepted values:
+     *
+     * - `"default"` (default) - Do not sort answers.
+     * - `"asc"` - Sort answers by ascending answer count.
+     * - `"desc"` - Sort answers by descending answer count.
+     *
+     * Users can change this property value if you enable the `allowChangeAnswersOrder` property.
+     *
+     * @see allowChangeAnswersOrder
+     */
+    answersOrder?: "default" | "asc" | "desc";
+    /**
+     * Allows users to hide answers with zero count in bar and scatter charts.
+     *
+     * This property adds a Hide Empty Answers button to each bar and scatter chart.
+     *
+     * Default value: `false`
+     */
+    allowHideEmptyAnswers?: boolean;
+    /**
+     * Hides answers with zero count in bar and scatter charts.
+     *
+     * Users can change this property value if you enable the `allowHideEmptyAnswers` property.
+     *
+     * Default value: `false`
+     *
+     * @see allowHideEmptyAnswers
+     */
+    hideEmptyAnswers?: boolean;
+    /**
+     * Allows users to select whether to show top 5, 10, or 20 answers by answer count.
+     *
+     * This property adds a Top N Answers dropdown to each chart.
+     *
+     * Default value: `false`
+     */
+    allowTopNAnswers?: boolean;
+    /**
+     * Allows users to show the number of respondents who did not answer a particular question.
+     *
+     * This property adds a Show Missing Answers button to each chart.
+     *
+     * Default value: `false`
+     */
+    allowShowMissingAnswers?: boolean;
+    allowExperimentalFeatures?: boolean;
+    /**
+     * Default chart type.
+     *
+     * Accepted values depend on the question type as follows:
+     *
+     * - Boolean: `"bar"` | `"pie"` | `"doughnut"`
+     * - Date, Number: `"bar"` | `"scatter"`
+     * - Matrix: `"bar"` | `"pie"` | `"doughnut"` | `"stackedbar"`
+     * - Rating: `"bar"` | `"scatter"` | `"gauge"` | `"bullet"`
+     * - Radiogroup, Checkbox, Dropdown, Image Picker: `"bar"` | `"pie"` | `"doughnut"` | `"scatter"`
+     *
+     * To set a type for an individual chart, access this chart in the `visualizers` array and set its `chartType` property to one of the values described above:
+     *
+     * ```js
+     * const vizPanel = new SurveyAnalytics.VisualizationPanel( ... );
+     * vizPanel.visualizers[0].chartType = "stackedbar";
+     * ```
+     *
+     */
+    defaultChartType?: string;
+    /**
+     * Allows users to transpose a visualized matrix question.
+     *
+     * This property adds a Transpose button to charts that visualize matrixes. When users select Per Values, matrix rows go to chart arguments and matrix columns form chart series. When users select Per Columns, matrix rows form chart series and matrix columns go to chart arguments.
+     *
+     * Default value: `false`
+     */
+    allowTransposeData?: boolean;
+    /**
+     * Allows users to cross-filter charts. The filter applies when users select a series point.
+     *
+     * Default value: `true`
+     */
+    allowSelection?: boolean;
+    renderContent?: Function;
+    destroyContent?: Function;
+    /**
+     * Removes HTML tags from survey element titles.
+     *
+     * Survey element titles can contain HTML markup and are specified by users. An attacker can inject malicious code into the titles. To guard against it, keep this property set to `true`.
+     *
+     * Default value: `true`
+     */
+    stripHtmlFromTitles?: boolean;
+}
+/**
+ * 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 declare class VisualizationPanel extends VisualizerBase {
+    protected questions: Array<any>;
+    private _elements;
+    static haveCommercialLicense: boolean;
+    visualizers: Array<VisualizerBase>;
+    private haveCommercialLicense;
+    private renderedQuestionsCount;
+    constructor(questions: Array<any>, data: Array<{
+        [index: string]: any;
+    }>, options?: IVisualizationPanelOptions, _elements?: Array<IVisualizerPanelRenderedElement>);
+    private onAfterRenderQuestionCallback;
+    /**
+     * An event that is raised when a user selects a different visualizer type from the Type drop-down menu.
+     *
+     * Parameters:
+     *
+     * - `sender`: `AlternativeVisualizersWrapper`\
+     * An object that controls altenative visualizers.
+     *
+     * - `options.visualizer`: `VisualizerBase`\
+     * An applied visualizer.
+     **/
+    onAlternativeVisualizerChanged: Event<(sender: AlternativeVisualizersWrapper, options: any) => any, AlternativeVisualizersWrapper, any>;
+    private onAlternativeVisualizerChangedCallback;
+    protected showElement(elementName: string): void;
+    protected hideElement(elementName: string): void;
+    protected makeElementPrivate(element: IVisualizerPanelElement): void;
+    protected makeElementPublic(element: IVisualizerPanelElement): void;
+    protected moveVisibleElement(fromVisibleIndex: number, toVisibleIndex: number): void;
+    protected moveElement(fromIndex: number, toIndex: number): void;
+    protected setBackgroundColorCore(color: string): void;
+    private buildVisualizers;
+    private destroyVisualizers;
+    protected setLocale(newLocale: string): void;
+    /**
+     * 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 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;
+    get allowMakeQuestionsPrivate(): boolean;
+    private _layoutEngine;
+    /**
+     * 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 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 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 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[];
+    get publicElements(): IVisualizerPanelRenderedElement[];
+    get privateElements(): IVisualizerPanelRenderedElement[];
+    protected get locales(): any;
+    /**
+     * Returns panel element description by the question name.
+     */
+    getElement(name: 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).
+     *
+     * 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;
+    onStateChanged: Event<(sender: VisualizationPanel, state: IState) => any, VisualizationPanel, any>;
+    onPermissionsChangedCallback: any;
+    protected renderPanelElement(element: IVisualizerPanelRenderedElement, container: HTMLElement): HTMLElement;
+    protected renderToolbar(container: HTMLElement): void;
+    renderContent(container: HTMLElement): void;
+    protected destroyContent(container: HTMLElement): void;
+    /**
+     * Redraws the `VisualizationPanel` and all its content.
+     */
+    refresh(): void;
+    layout(): void;
+    /**
+     * 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;
+    get state(): IState;
+    /**
+     * Sets vizualization panel state.
+     */
+    set state(newState: IState);
+    get permissions(): IPermission[];
+    set permissions(permissions: IPermission[]);
+    destroy(): void;
+}

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

@@ -0,0 +1,23 @@
+import { VisualizerBase } from "./visualizerBase";
+import { VisualizationPanel } from "./visualizationPanel";
+import { Question, IQuestion } from "survey-core";
+export declare class VisualizationPanelDynamic extends VisualizerBase {
+    protected _panelVisualizer: VisualizationPanel;
+    constructor(question: Question, data: Array<{
+        [index: string]: any;
+    }>, options?: {
+        [index: string]: any;
+    }, name?: string);
+    protected setLocale(newLocale: string): void;
+    private onAfterRenderPanelCallback;
+    get type(): string;
+    private updatePanelVisualizerData;
+    updateData(data: Array<{
+        [index: string]: any;
+    }>): void;
+    protected onDataChanged(): void;
+    getQuestions(): IQuestion[];
+    destroyContent(container: HTMLElement): void;
+    renderContent(container: HTMLElement): void;
+    destroy(): void;
+}

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

@@ -0,0 +1,257 @@
+import { Question } from "survey-core";
+import { IDataInfo, DataProvider } from "./dataProvider";
+import { Event } from "survey-core";
+/**
+ * A base object for all visualizers. Use it to implement a custom visualizer.
+ *
+ * Constructor parameters:
+ *
+ * - `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.
+ * - `type`: `String`\
+ * *(Optional)* The visualizer's type.
+ *
+ * [View Demo](https://surveyjs.io/dashboard/examples/how-to-plot-survey-data-in-custom-bar-chart/ (linkStyle))
+ */
+export declare class VisualizerBase implements IDataInfo {
+    question: Question;
+    options: {
+        [index: string]: any;
+    };
+    private _type?;
+    private _showToolbar;
+    private _footerVisualizer;
+    private _dataProvider;
+    labelTruncateLength: number;
+    protected renderResult: HTMLElement;
+    protected toolbarContainer: HTMLElement;
+    protected headerContainer: HTMLElement;
+    protected contentContainer: HTMLElement;
+    protected footerContainer: HTMLElement;
+    protected _supportSelection: boolean;
+    static otherCommentCollapsed: boolean;
+    /**
+     * 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;
+    /**
+     * 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;
+    }) => any, VisualizerBase, any>;
+    protected toolbarItemCreators: {
+        [name: string]: (toolbar?: HTMLDivElement) => HTMLElement;
+    };
+    constructor(question: Question, data: Array<{
+        [index: string]: any;
+    }>, options?: {
+        [index: string]: any;
+    }, _type?: string);
+    protected get questionOptions(): any;
+    protected onDataChanged(): void;
+    /**
+     * Returns the identifier of a visualized question.
+     */
+    get name(): string | Array<string>;
+    /**
+     * 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 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;
+    /**
+     * Allows you to access the footer visualizer. Returns `undefined` if the footer is absent.
+     * @see hasFooter
+     */
+    get footerVisualizer(): VisualizerBase;
+    /**
+     * 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;
+    getSeriesValues(): Array<string>;
+    getSeriesLabels(): Array<string>;
+    getValues(): Array<any>;
+    getLabels(): Array<string>;
+    /**
+     * Registers a function used to create a toolbar item for this visualizer.
+     *
+     * The following code shows how to add a custom button and drop-down menu to the toolbar:
+     *
+     * ```js
+     * import { VisualizationPanel, DocumentHelper } from "survey-analytics";
+     *
+     * const vizPanel = new VisualizationPanel( ... );
+     *
+     * // Add a custom button to the toolbar
+     * visPanel.visualizers[0].registerToolbarItem("my-toolbar-button", () => {
+     *   return DocumentHelper.createButton(
+     *     // A button click event handler
+     *     () => {
+     *       alert("Custom toolbar button is clicked");
+     *     },
+     *     // Button caption
+     *     "Button"
+     *   );
+     * });
+     *
+     * // Add a custom drop-down menu to the toolbar
+     * vizPanel.visualizers[0].registerToolbarItem("my-toolbar-dropdown", () => {
+     *   return DocumentHelper.createSelector(
+     *     // Menu items
+     *     [
+     *       { value: 1, text: "One" },
+     *       { value: 2, text: "Two" },
+     *       { value: 3, text: "Three" }
+     *     ],
+     *     // A function that specifies initial selection
+     *     (option) => false,
+     *     // An event handler that is executed when selection is changed
+     *     (e) => {
+     *       alert(e.target.value);
+     *     }
+     *   );
+     * });
+     * ```
+     * @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;
+    /**
+     * Returns the visualizer's type.
+     */
+    get type(): string;
+    /**
+     * 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 visualized data.
+     * @param data A data array with survey results to be visualized.
+     */
+    updateData(data: Array<{
+        [index: string]: any;
+    }>): void;
+    onUpdate: () => void;
+    invokeOnUpdate(): void;
+    /**
+     * Deletes the visualizer and all its elements from the DOM.
+     * @see clear
+     */
+    destroy(): void;
+    /**
+     * 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;
+    protected getCorrectAnswerText(): string;
+    protected destroyToolbar(container: HTMLElement): void;
+    protected renderToolbar(container: HTMLElement): void;
+    protected destroyHeader(container: HTMLElement): void;
+    protected destroyContent(container: HTMLElement): void;
+    protected renderHeader(container: HTMLElement): void;
+    protected renderContent(container: HTMLElement): void;
+    protected destroyFooter(container: HTMLElement): void;
+    protected renderFooter(container: HTMLElement): void;
+    /**
+     * 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;
+    /**
+     * Re-renders the visualizer and its content.
+     */
+    refresh(): void;
+    protected processText(text: string): string;
+    getRandomColor(): any;
+    private _backgroundColor;
+    get backgroundColor(): string;
+    set backgroundColor(value: string);
+    protected getBackgroundColorCore(): string;
+    protected setBackgroundColorCore(color: string): void;
+    static customColors: string[];
+    private static colors;
+    getColors(count?: number): any;
+    /**
+     * Gets or sets the visibility of the visualizer's toolbar.
+     *
+     * Default value: `true`
+     */
+    get showToolbar(): boolean;
+    set showToolbar(newValue: boolean);
+    /**
+     * 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 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 the visualizer's state.
+     *
+     * > This method is overriden in descendant classes.
+     * @see getState
+     */
+    setState(state: any): void;
+    /**
+     * 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;
+    set locale(newLocale: string);
+    protected setLocale(newLocale: string): void;
+}

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

@@ -0,0 +1,20 @@
+import { Question } from "survey-core";
+import { VisualizerBase } from "./visualizerBase";
+/**
+ * An object that allows you to create individual visualizers without creating a [visualization panel](https://surveyjs.io/dashboard/documentation/api-reference/visualizationpanel).
+ */
+export declare class VisualizerFactory {
+    /**
+     * 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;
+    }>, options?: {
+        [index: string]: any;
+    }): VisualizerBase;
+}

package/survey-analytics.types/wordcloud/stopwords/dutch.d.ts

@@ -0,0 +1 @@
+export declare var stopWords: string[];

package/survey-analytics.types/wordcloud/stopwords/english.d.ts

@@ -0,0 +1 @@
+export declare var stopWords: string[];

package/survey-analytics.types/wordcloud/stopwords/index.d.ts

@@ -0,0 +1,3 @@
+export declare var textHelper: {
+    getStopWords: (locale?: string) => string[];
+};

package/survey-analytics.types/wordcloud/stopwords/norwegian.d.ts

@@ -0,0 +1 @@
+export declare var stopWords: string[];