survey-core 1.12.21 → 1.12.22

package/typings/src/surveyProgress.d.ts

@@ -0,0 +1,4 @@
+export declare class SurveyProgressModel {
+    static getProgressTextInBarCss(css: any): string;
+    static getProgressTextUnderBarCss(css: any): string;
+}

package/typings/src/surveyStrings.d.ts

@@ -0,0 +1,151 @@
+export declare var surveyLocalization: {
+    currentLocaleValue: string;
+    defaultLocaleValue: string;
+    locales: {
+        [index: string]: any;
+    };
+    localeNames: {
+        [index: string]: any;
+    };
+    localeNamesInEnglish: {
+        [index: string]: any;
+    };
+    localeDirections: {
+        [index: string]: any;
+    };
+    supportedLocales: any[];
+    useEnglishNames: boolean;
+    showNamesInEnglish: boolean;
+    setupLocale(localeConfig: {
+        localeCode: string;
+        strings: any;
+        nativeName: string;
+        englishName: string;
+        rtl?: boolean;
+    }): void;
+    currentLocale: string;
+    defaultLocale: string;
+    getLocaleStrings(loc: string): any;
+    getString: (strName: string, locale?: string) => any;
+    getLocaleName(loc: string, inEnglish?: boolean): string;
+    getLocales: (removeDefaultLoc?: boolean) => Array<string>;
+    onGetExternalString: (name: string, locale: string) => string;
+};
+export declare function getLocaleString(strName: string, locale?: string): string;
+export declare function getLocaleStrings(locale: string): any;
+export declare function setupLocale(localeConfig: {
+    localeCode: string;
+    strings: any;
+    nativeName: string;
+    englishName: string;
+    rtl?: boolean;
+}): void;
+export declare var surveyStrings: {
+    pagePrevText: string;
+    pageNextText: string;
+    completeText: string;
+    previewText: string;
+    editText: string;
+    startSurveyText: string;
+    otherItemText: string;
+    noneItemText: string;
+    refuseItemText: string;
+    dontKnowItemText: string;
+    selectAllItemText: string;
+    deselectAllItemText: string;
+    progressText: string;
+    indexText: string;
+    panelDynamicProgressText: string;
+    panelDynamicTabTextFormat: string;
+    questionsProgressText: string;
+    emptySurvey: string;
+    completingSurvey: string;
+    completingSurveyBefore: string;
+    loadingSurvey: string;
+    placeholder: string;
+    ratingOptionsCaption: string;
+    value: string;
+    requiredError: string;
+    requiredErrorInPanel: string;
+    requiredInAllRowsError: string;
+    eachRowUniqueError: string;
+    numericError: string;
+    minError: string;
+    maxError: string;
+    textNoDigitsAllow: string;
+    textMinLength: string;
+    textMaxLength: string;
+    textMinMaxLength: string;
+    minRowCountError: string;
+    minSelectError: string;
+    maxSelectError: string;
+    numericMinMax: string;
+    numericMin: string;
+    numericMax: string;
+    invalidEmail: string;
+    invalidExpression: string;
+    urlRequestError: string;
+    urlGetChoicesError: string;
+    exceedMaxSize: string;
+    noUploadFilesHandler: string;
+    otherRequiredError: string;
+    uploadingFile: string;
+    loadingFile: string;
+    chooseFile: string;
+    noFileChosen: string;
+    filePlaceholder: string;
+    confirmDelete: string;
+    keyDuplicationError: string;
+    addColumn: string;
+    addRow: string;
+    removeRow: string;
+    noRowsText: string;
+    addPanel: string;
+    removePanel: string;
+    showDetails: string;
+    hideDetails: string;
+    choices_Item: string;
+    matrix_column: string;
+    matrix_row: string;
+    multipletext_itemname: string;
+    savingData: string;
+    savingDataError: string;
+    savingDataSuccess: string;
+    savingExceedSize: string;
+    saveAgainButton: string;
+    timerMin: string;
+    timerSec: string;
+    timerSpentAll: string;
+    timerSpentPage: string;
+    timerSpentSurvey: string;
+    timerLimitAll: string;
+    timerLimitPage: string;
+    timerLimitSurvey: string;
+    clearCaption: string;
+    signaturePlaceHolder: string;
+    signaturePlaceHolderReadOnly: string;
+    chooseFileCaption: string;
+    takePhotoCaption: string;
+    photoPlaceholder: string;
+    fileOrPhotoPlaceholder: string;
+    replaceFileCaption: string;
+    removeFileCaption: string;
+    booleanCheckedLabel: string;
+    booleanUncheckedLabel: string;
+    confirmRemoveFile: string;
+    confirmRemoveAllFiles: string;
+    questionTitlePatternText: string;
+    modalCancelButtonText: string;
+    modalApplyButtonText: string;
+    filterStringPlaceholder: string;
+    emptyMessage: string;
+    noEntriesText: string;
+    noEntriesReadonlyText: string;
+    tabTitlePlaceholder: string;
+    more: string;
+    tagboxDoneButtonCaption: string;
+    selectToRankEmptyRankedAreaText: string;
+    selectToRankEmptyUnrankedAreaText: string;
+    ok: string;
+    cancel: string;
+};

package/typings/src/surveyTaskManager.d.ts

@@ -0,0 +1,16 @@
+import { Base } from "./base";
+declare class SurveyTaskModel {
+    type: string;
+    private timestamp;
+    constructor(type: string);
+}
+export declare class SurveyTaskManagerModel extends Base {
+    private taskList;
+    constructor();
+    private onAllTasksCompleted;
+    hasActiveTasks: boolean;
+    runTask(type: string, func: (done: any) => void): SurveyTaskModel;
+    waitAndExecute(action: any): void;
+    private taskFinished;
+}
+export {};

package/typings/src/surveyTimerModel.d.ts

@@ -0,0 +1,47 @@
+import { ISurvey } from "./base-interfaces";
+import { Base, EventBase } from "./base";
+import { PageModel } from "./page";
+import { SurveyModel } from "./survey";
+export interface ISurveyTimerText {
+    timerInfoText: string;
+    timerInfo: {
+        spent: number;
+        limit?: number;
+    };
+    timerClock: {
+        majorText: string;
+        minorText?: string;
+    };
+    getCss(): any;
+    isTimerPanelShowingOnBottom: boolean;
+    isTimerPanelShowingOnTop: boolean;
+    onCurrentPageChanged: EventBase<SurveyModel>;
+}
+export declare class SurveyTimerModel extends Base {
+    onTimerTick: (page: PageModel) => void;
+    private surveyValue;
+    constructor(survey: ISurvey);
+    text: string;
+    progress: number;
+    clockMajorText: string;
+    clockMinorText: string;
+    spent: number;
+    get survey(): ISurveyTimerText;
+    onCreating(): void;
+    private timerFunc;
+    start(): void;
+    stop(): void;
+    get isRunning(): boolean;
+    private setIsRunning;
+    private update;
+    private doTimer;
+    private updateProgress;
+    private updateText;
+    get showProgress(): boolean;
+    get showTimerAsClock(): boolean;
+    get rootCss(): string;
+    getProgressCss(): string;
+    get textContainerCss(): string;
+    get minorTextCss(): string;
+    get majorTextCss(): string;
+}

package/typings/src/surveyToc.d.ts

@@ -0,0 +1,23 @@
+import { Action } from "./actions/action";
+import { ListModel } from "./list";
+import { PanelModelBase } from "./panel";
+import { PopupModel } from "./popup";
+import { SurveyModel } from "./survey";
+export declare function tryFocusPage(survey: SurveyModel, panel: PanelModelBase): boolean;
+export declare function createTOCListModel(survey: SurveyModel, onAction?: () => void): ListModel<Action>;
+export declare function getTocRootCss(survey: SurveyModel, isMobile?: boolean): string;
+export declare class TOCModel {
+    survey: SurveyModel;
+    static RootStyle: string;
+    static StickyPosition: boolean;
+    constructor(survey: SurveyModel);
+    private initStickyTOCSubscriptions;
+    updateStickyTOCSize(rootElement: HTMLElement): void;
+    get isMobile(): boolean;
+    get containerCss(): string;
+    listModel: ListModel<Action>;
+    popupModel: PopupModel;
+    icon: string;
+    togglePopup: () => void;
+    dispose(): void;
+}

package/typings/src/surveytimer.d.ts

@@ -0,0 +1,22 @@
+import { EventBase } from "./base";
+export declare var surveyTimerFunctions: {
+    setTimeout: (func: () => any) => number;
+    clearTimeout: (timerId: number) => void;
+    safeTimeOut: (func: () => any, delay: number) => number | any;
+    now(): number;
+};
+export interface SurveyTimerEvent {
+    seconds: number;
+}
+export declare class SurveyTimer {
+    private static instanceValue;
+    static get instance(): SurveyTimer;
+    private listenerCounter;
+    private timerId;
+    private prevTimeInMs;
+    onTimerTick: EventBase<SurveyTimer, SurveyTimerEvent>;
+    onTimer: EventBase<SurveyTimer, SurveyTimerEvent>;
+    start(func?: (timer: SurveyTimer, options: SurveyTimerEvent) => void): void;
+    stop(func?: (timer: SurveyTimer, options: SurveyTimerEvent) => any): void;
+    doTimer(): void;
+}

package/typings/src/svgbundle.d.ts

@@ -0,0 +1,23 @@
+import { EventBase } from "./base";
+interface SvgIconData {
+    [key: string]: string;
+}
+export declare class SvgIconRegistry {
+    icons: SvgIconData;
+    private iconPrefix;
+    private processId;
+    registerIconFromSymbol(iconId: string, iconSymbolSvg: string): void;
+    registerIconFromSvgViaElement(iconId: string, iconSvg: string, iconPrefix?: string): void;
+    registerIconFromSvg(iconId: string, iconSvg: string, iconPrefix?: string): boolean;
+    registerIconsFromFolder(r: any): void;
+    registerIcons(icons: SvgIconData): void;
+    iconsRenderedHtml(): string;
+    updateMarkup(): void;
+    onIconsChanged: EventBase<SvgIconRegistry, {}>;
+}
+export declare const SvgRegistry: SvgIconRegistry;
+export declare const SvgThemeSets: {
+    [index: string]: SvgIconData;
+};
+export declare function addIconsToThemeSet(name: string, iconsData: SvgIconData): void;
+export {};

package/typings/src/template-renderer.d.ts

@@ -0,0 +1,10 @@
+export interface SurveyTemplateRendererTemplateData {
+    name: string;
+    data: any;
+    nodes?: HTMLElement[];
+    afterRender: (el: HTMLElement, context: any) => void;
+}
+export interface SurveyTemplateRendererViewModel {
+    componentData: any;
+    templateData: SurveyTemplateRendererTemplateData;
+}

package/typings/src/textPreProcessor.d.ts

@@ -0,0 +1,43 @@
+import { Question } from "./question";
+import { PanelModel } from "./panel";
+import { ISurvey, ITextProcessor, ITextProcessorProp, ITextProcessorResult } from "./base-interfaces";
+export declare class TextPreProcessorItem {
+    start: number;
+    end: number;
+}
+export declare class TextPreProcessorValue {
+    name: string;
+    returnDisplayValue: boolean;
+    constructor(name: string, returnDisplayValue: boolean);
+    value: any;
+    isExists: boolean;
+    canProcess: boolean;
+}
+export declare class TextPreProcessor {
+    private _unObservableValues;
+    private get hasAllValuesOnLastRunValue();
+    private set hasAllValuesOnLastRunValue(value);
+    onProcess: (textValue: TextPreProcessorValue) => void;
+    process(text: string, returnDisplayValue?: boolean, doEncoding?: boolean): string;
+    processValue(name: string, returnDisplayValue: boolean): TextPreProcessorValue;
+    get hasAllValuesOnLastRun(): boolean;
+    private getItems;
+    private getName;
+}
+export declare class QuestionTextProcessor implements ITextProcessor {
+    protected variableName: string;
+    private textPreProcessor;
+    constructor(variableName: string);
+    processValue(name: string, returnDisplayValue: boolean): TextPreProcessorValue;
+    protected get survey(): ISurvey;
+    protected get panel(): PanelModel;
+    protected getValues(): any;
+    protected getQuestionByName(name: string): Question;
+    protected getParentTextProcessor(): ITextProcessor;
+    protected onCustomProcessText(textValue: TextPreProcessorValue): boolean;
+    protected getQuestionDisplayText(question: Question): string;
+    private getProcessedTextValue;
+    processText(text: string, returnDisplayValue: boolean): string;
+    processTextEx(params: ITextProcessorProp): ITextProcessorResult;
+    private processTextCore;
+}

package/typings/src/themes.d.ts

@@ -0,0 +1,222 @@
+import { HorizontalAlignment, VerticalAlignment } from "./base-interfaces";
+export type ImageFit = "auto" | "contain" | "cover";
+export type ImageAttachment = "fixed" | "scroll";
+/**
+ * A theme configuration interface.
+ *
+ * `ITheme` objects are used to apply predefined themes or create custom themes. Refer to the following help topic for more information:
+ *
+ * [Themes & Styles](https://surveyjs.io/form-library/documentation/manage-default-themes-and-styles (linkStyle))
+ */
+export interface ITheme {
+    /**
+     * A theme name.
+     */
+    themeName?: string;
+    /**
+     * A color palette.
+     *
+     * Possible values:
+     *
+     * - `"light"`
+     * - `"dark"`
+     */
+    colorPalette?: string;
+    /**
+     * A Boolean value that specifies whether survey questions are displayed within panels (`false`) or without them (`true`).
+     */
+    isPanelless?: boolean;
+    /**
+     * An image to display as survey background. This property accepts a hyperlink or a data URL.
+     */
+    backgroundImage?: string;
+    /**
+     * A string value that specifies how to resize the [background image](#backgroundImage) to fit it into its container.
+     *
+     * Possible values:
+     *
+     * - `"auto"`
+     * - `"contain"`
+     * - `"cover"`
+     *
+     * Refer to the description of the [`background-size`](https://developer.mozilla.org/en-US/docs/Web/CSS/background-size#values) CSS property values on MDN for detailed information on the possible values.
+     */
+    backgroundImageFit?: ImageFit;
+    /**
+     * A string value that specifies whether the [background image](#backgroundImage) is fixed in its position or scrolled along with the survey.
+     *
+     * Possible values:
+     *
+     * - `"fixed"`
+     * - `"scroll"`
+     */
+    backgroundImageAttachment?: ImageAttachment;
+    /**
+     * A value from 0 to 1 that specifies how transparent the [background image](#backgroundImage) should be: 0 makes the image completely transparent, and 1 makes it opaque.
+     */
+    backgroundOpacity?: number;
+    /**
+     * An object with [advanced survey header settings](https://surveyjs.io/form-library/documentation/api-reference/iheader). Applies when the [`headerView`](https://surveyjs.io/form-library/documentation/api-reference/itheme#headerView) property is set to `"advanced"`.
+     */
+    header?: IHeader;
+    /**
+     * Specifies whether the survey header uses only basic appearance settings or applies advanced settings from the survey theme.
+     *
+     * Possible values:
+     *
+     * - `"basic"` (default)\
+     * A basic header view applies only the [`title`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#title), [`description`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#description), and logo-related properties ([`logo`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#logo), [`logoPosition`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#logoPosition), etc.).
+     *
+     * - `"advanced"`\
+     * An advanced header view applies the same properties as the basic view, plus [header settings](https://surveyjs.io/form-library/documentation/api-reference/iheader) from the [survey theme](https://surveyjs.io/form-library/documentation/api-reference/itheme#header). The advanced view features a more flexible header layout, a capability to specify a background image, and other settings that give a more professional look to the survey header.
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/brand-your-survey-header/ (linkStyle))
+     */
+    headerView?: "advanced" | "basic";
+    /**
+     * An object with CSS variables.
+     */
+    cssVariables?: {
+        [index: string]: string;
+    };
+}
+/**
+ * A survey header configuration interface.
+ *
+ * An `IHeader` object configures advanced survey header appearance settings. To apply them, you need to assign the object to the [`header`](https://surveyjs.io/form-library/documentation/api-reference/itheme#header) property of your theme configuration and set the [`headerView`](https://surveyjs.io/form-library/documentation/api-reference/itheme#headerView) property to `"advanced"`.
+ */
+export interface IHeader {
+    /**
+     * The height of the survey header in pixels.
+     *
+     * Default value: 256
+     */
+    height?: number;
+    /**
+     * The height of the survey header on smartphones, measured in pixels.
+     *
+     * Default value: 0 (the height is calculated automatically to accommodate the header's content).
+     */
+    mobileHeight?: number;
+    /**
+     * A string value that specifies whether the header spans the width of the survey or that of the survey container.
+     *
+     * Possible values:
+     *
+     * - `"survey"`\
+     * The header width is the same as the survey width.
+     * - `"container"` (default)\
+     * The header width is the same as the survey container width.
+     *
+     * @see [SurveyModel.width](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#width)
+     * @see [SurveyModel.widthMode](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#widthMode)
+     */
+    inheritWidthFrom?: "survey" | "container";
+    /**
+     * The width of the header area that contains the survey [title](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#title) and [description](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#description), measured in pixels.
+     *
+     * Default value: 512
+     */
+    textAreaWidth?: number;
+    /**
+     * A Boolean value that specifies whether the header overlaps the survey content.
+     *
+     * Default value: `false`
+     */
+    overlapEnabled?: boolean;
+    /**
+     * An image to display in the background of the header. Accepts a base64 or URL string value.
+     */
+    backgroundImage?: string;
+    /**
+     * A value from 0 to 1 that specifies how transparent the [background image](#backgroundImage) should be: 0 makes the image completely transparent, and 1 makes it opaque.
+     */
+    backgroundImageOpacity?: number;
+    /**
+     * A string value that specifies how to resize a [background image](#backgroundImage) to fit it into the header.
+     *
+     * Possible values:
+     *
+     * - `"cover"` (default)\
+     * Scales the image to the smallest possible size that fills the header. The image preserves its aspect ratio but can be cropped if the header's proportions differ from that of the element.
+     * - `"fill"`\
+     * Stretches the image to fill the entire header.
+     * - `"contain"`\
+     * Scales the image to the largest possible size without cropping or stretching it.
+     * - `"tile"`\
+     * Tiles as many copies of the image as needed to fill the entire header.
+     */
+    backgroundImageFit?: "cover" | "fill" | "contain" | "tile";
+    /**
+     * A string value that specifies the logo position within the header in the horizontal direction.
+     *
+     * Possible values:
+     *
+     * - `"right"` (default)
+     * - `"left"`
+     * - `"center"`
+     *
+     * To specify a logo, set `SurveyModel`'s [`logo`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#logo) property.
+     */
+    logoPositionX?: HorizontalAlignment;
+    /**
+     * A string value that specifies the logo position within the header in the vertical direction.
+     *
+     * Possible values:
+     *
+     * - `"top"` (default)
+     * - `"bottom"`
+     * - `"middle"`
+     *
+     * To specify a logo, set `SurveyModel`'s [`logo`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#logo) property.
+     */
+    logoPositionY?: VerticalAlignment;
+    /**
+     * A string value that specifies the survey title position within the header in the horizontal direction.
+     *
+     * Possible values:
+     *
+     * - `"left"` (default)
+     * - `"right"`
+     * - `"center"`
+     *
+     * To specify a survey title, set `SurveyModel`'s [`title`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#title) property.
+     */
+    titlePositionX?: HorizontalAlignment;
+    /**
+     * A string value that specifies the survey title position within the header in the vertical direction.
+     *
+     * Possible values:
+     *
+     * - `"bottom"` (default)
+     * - `"top"`
+     * - `"middle"`
+     *
+     * To specify a survey title, set `SurveyModel`'s [`title`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#title) property.
+     */
+    titlePositionY?: VerticalAlignment;
+    /**
+     * A string value that specifies the survey description position within the header in the horizontal direction.
+     *
+     * Possible values:
+     *
+     * - `"left"` (default)
+     * - `"right"`
+     * - `"center"`
+     *
+     * To specify a survey description, set `SurveyModel`'s [`description`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#description) property.
+     */
+    descriptionPositionX?: HorizontalAlignment;
+    /**
+     * A string value that specifies the survey description position within the header in the vertical direction.
+     *
+     * Possible values:
+     *
+     * - `"bottom"` (default)
+     * - `"top"`
+     * - `"middle"`
+     *
+     * To specify a survey description, set `SurveyModel`'s [`description`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#description) property.
+     */
+    descriptionPositionY?: VerticalAlignment;
+}