survey-core 1.12.21 → 1.12.22

package/typings/src/question_radiogroup.d.ts

@@ -0,0 +1,40 @@
+import { QuestionCheckboxBase } from "./question_baseselect";
+import { ItemValue } from "./itemvalue";
+import { Action } from "./actions/action";
+/**
+ * A class that describes the Radio Button Group question type.
+ *
+ * [View Demo](https://surveyjs.io/form-library/examples/questiontype-radiogroup/ (linkStyle))
+ */
+export declare class QuestionRadiogroupModel extends QuestionCheckboxBase {
+    constructor(name: string);
+    protected getDefaultItemComponent(): string;
+    getType(): string;
+    protected getFirstInputElementId(): string;
+    /**
+     * Returns the selected choice item. If no item is selected, returns `null`.
+     */
+    get selectedItem(): ItemValue;
+    /**
+     * Specifies whether to display a button that clears the question value.
+     *
+     * Default value: `false`
+     */
+    get allowClear(): boolean;
+    set allowClear(val: boolean);
+    /**
+     * @deprecated Use the [`allowClear`](https://surveyjs.io/form-library/documentation/api-reference/radio-button-question-model#allowClear) property instead.
+     */
+    get showClearButton(): boolean;
+    set showClearButton(val: boolean);
+    get canShowClearButton(): boolean;
+    get clearButtonCaption(): string;
+    supportAutoAdvance(): boolean;
+    getConditionJson(operator?: string, path?: string): any;
+    protected setNewComment(newValue: string): void;
+    get showClearButtonInContent(): boolean;
+    clickItemHandler(item: ItemValue): void;
+    protected getDefaultTitleActions(): Array<Action>;
+    get isNewA11yStructure(): boolean;
+    get a11y_input_ariaRole(): string;
+}

package/typings/src/question_ranking.d.ts

@@ -0,0 +1,135 @@
+import { ISurveyImpl } from "./base-interfaces";
+import { DragDropRankingChoices } from "./dragdrop/ranking-choices";
+import { ItemValue } from "./itemvalue";
+import { QuestionCheckboxModel } from "./question_checkbox";
+import { AnimationGroup } from "./utils/animation";
+/**
+ * A class that describes the Ranking question type.
+ *
+ * [View Demo](https://surveyjs.io/form-library/examples/questiontype-ranking/ (linkStyle))
+ */
+export declare class QuestionRankingModel extends QuestionCheckboxModel {
+    private domNode;
+    private dragOrClickHelper;
+    constructor(name: string);
+    getType(): string;
+    getItemTabIndex(item: ItemValue): number;
+    protected supportContainerQueries(): boolean;
+    get rootClass(): string;
+    protected isItemSelectedCore(item: ItemValue): boolean;
+    protected getItemClassCore(item: ItemValue, options: any): string;
+    getContainerClasses(containerType?: string): string;
+    protected isItemCurrentDropTarget(item: ItemValue): boolean;
+    get ghostPositionCssClass(): string;
+    getItemIndexClasses(item: ItemValue): string;
+    getNumberByIndex(index: number): string;
+    private updateRankingChoicesSync;
+    setSurveyImpl(value: ISurveyImpl, isLight?: boolean): void;
+    isAnswerCorrect(): boolean;
+    get requireStrictCompare(): boolean;
+    onSurveyValueChanged(newValue: any): void;
+    onSurveyLoad(): void;
+    protected onVisibleChoicesChanged: () => void;
+    updateValueFromSurvey(newValue: any, clearData: boolean): void;
+    localeChanged: () => void;
+    private addToValueByVisibleChoices;
+    private removeFromValueByVisibleChoices;
+    private getChoicesAnimationOptions;
+    private _rankingChoicesAnimation;
+    get rankingChoicesAnimation(): AnimationGroup<ItemValue>;
+    private _unRankingChoicesAnimation;
+    get unRankingChoicesAnimation(): AnimationGroup<ItemValue>;
+    rankingChoices: Array<ItemValue>;
+    unRankingChoices: Array<ItemValue>;
+    private _renderedRankingChoices;
+    private _renderedUnRankingChoices;
+    get renderedRankingChoices(): Array<ItemValue>;
+    set renderedRankingChoices(val: Array<ItemValue>);
+    get renderedUnRankingChoices(): Array<ItemValue>;
+    set renderedUnRankingChoices(val: Array<ItemValue>);
+    private updateRenderedRankingChoices;
+    private updateRenderedUnRankingChoices;
+    private updateRankingChoices;
+    updateUnRankingChoices(newRankingChoices: Array<ItemValue>): void;
+    private updateRankingChoicesSelectToRankMode;
+    dragDropRankingChoices: DragDropRankingChoices;
+    currentDropTarget: ItemValue;
+    endLoadingFromJson(): void;
+    private setDragDropRankingChoices;
+    protected createDragDropRankingChoices(): DragDropRankingChoices;
+    private draggedChoiceValue;
+    private draggedTargetNode;
+    handlePointerDown: (event: PointerEvent, choice: ItemValue, node: HTMLElement) => void;
+    startDrag: (event: PointerEvent) => void;
+    handlePointerUp: (event: PointerEvent, choice: ItemValue, node: HTMLElement) => void;
+    private isDragStartNodeValid;
+    private isAllowStartDrag;
+    private canStartDragDueMaxSelectedChoices;
+    private canStartDragDueItemEnabled;
+    checkMaxSelectedChoicesUnreached(): boolean;
+    afterRenderQuestionElement(el: HTMLElement): void;
+    beforeDestroyQuestionElement(el: HTMLElement): void;
+    handleKeydown: (event: KeyboardEvent, choice: ItemValue) => void;
+    protected supportSelectAll(): boolean;
+    supportOther(): boolean;
+    supportNone(): boolean;
+    supportRefuse(): boolean;
+    supportDontKnow(): boolean;
+    handleKeydownSelectToRank(event: KeyboardEvent, movedElement: ItemValue, hardKey?: string, isNeedFocus?: boolean): void;
+    private setValueAfterKeydown;
+    private focusItem;
+    isValueSetByUser: boolean;
+    setValue: () => void;
+    getIconHoverCss(): string;
+    getIconFocusCss(): string;
+    /**
+     * Specifies whether to use a long tap (press and hold) gesture to start dragging.
+     *
+     * Default value: `true`
+     *
+     * Disable this property if you want to start dragging when users perform a scroll gesture.
+    */
+    get longTap(): boolean;
+    set longTap(val: boolean);
+    protected getDefaultItemComponent(): string;
+    /**
+     * Specifies whether users can select choices they want to rank.
+     *
+     * When you enable this property, the Ranking question displays two areas for ranked and unranked choices. To order choices, users should first drag them from the unranked to the ranked area. Use this mode if you want to let users order only the choices they select.
+     *
+     * Default value: `false`
+     * @see selectToRankAreasLayout
+    */
+    get selectToRankEnabled(): boolean;
+    set selectToRankEnabled(val: boolean);
+    get selectToRankSwapAreas(): boolean;
+    set selectToRankSwapAreas(val: boolean);
+    carryForwardStartUnranked: boolean;
+    /**
+     * Specifies the layout of the ranked and unranked areas. Applies when [`selectToRankEnabled`](https://surveyjs.io/form-library/documentation/api-reference/ranking-question-model#selectToRankEnabled) is `true`.
+     *
+     * Possible values:
+     *
+     * - `"horizontal"` (default) - The ranked and unranked areas are positioned next to each other. Users drag and drop choices between them in the horizontal direction.
+     * - `"vertical"`- The ranked area is positioned above the unranked area. Users drag and drop choices between them in the vertical direction.
+     * @see selectToRankAreasLayout
+    */
+    get selectToRankAreasLayout(): string;
+    set selectToRankAreasLayout(val: string);
+    get renderedSelectToRankAreasLayout(): string;
+    isMobileMode(): boolean;
+    /**
+     * A placeholder displayed in the area for ranked choices. Applies when [`selectToRankEnabled`](https://surveyjs.io/form-library/documentation/api-reference/ranking-question-model#selectToRankEnabled) is `true`.
+     */
+    selectToRankEmptyRankedAreaText: string;
+    /**
+     * A placeholder displayed in the area for unranked choices. Applies when [`selectToRankEnabled`](https://surveyjs.io/form-library/documentation/api-reference/ranking-question-model#selectToRankEnabled) is `true`.
+     */
+    selectToRankEmptyUnrankedAreaText: string;
+    get useFullItemSizeForShortcut(): boolean;
+    set useFullItemSizeForShortcut(val: boolean);
+    get dragDropSvgIcon(): string;
+    get arrowsSvgIcon(): string;
+    get dashSvgIcon(): string;
+    get isNewA11yStructure(): boolean;
+}

package/typings/src/question_rating.d.ts

@@ -0,0 +1,300 @@
+import { ItemValue } from "./itemvalue";
+import { Question } from "./question";
+import { LocalizableString } from "./localizablestring";
+import { Base } from "./base";
+import { DropdownListModel } from "./dropdownListModel";
+import { ISurveyImpl } from "./base-interfaces";
+import { ITheme } from "./themes";
+import { HashTable } from "./helpers";
+export declare class RenderedRatingItem extends Base {
+    itemValue: ItemValue;
+    private locString;
+    private onStringChangedCallback;
+    get value(): number;
+    highlight: "none" | "highlighted" | "unhighlighted";
+    get locText(): LocalizableString;
+    text: string;
+    style: any;
+    constructor(itemValue: ItemValue, locString?: LocalizableString);
+}
+/**
+ * A class that describes the Rating Scale question type.
+ *
+ * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
+ */
+export declare class QuestionRatingModel extends Question {
+    constructor(name: string);
+    private setIconsToRateValues;
+    endLoadingFromJson(): void;
+    private _syncPropertiesChanging;
+    private registerSychProperties;
+    private useRateValues;
+    private updateRateMax;
+    private updateRateMin;
+    private updateRateCount;
+    initPropertyDependencies(): void;
+    inputHasValue: boolean;
+    get showSelectedItemLocText(): boolean;
+    get selectedItemLocText(): LocalizableString;
+    autoGenerate: boolean;
+    /**
+     * A list of rate values.
+     *
+     * This property accepts an array of objects with the following structure:
+     *
+     * ```js
+     * {
+     *   "value": any, // A value to be saved in survey results
+     *   "text": String, // A display text. This property supports Markdown. When `text` is undefined, `value` is used.
+     *   "customProperty": any // Any property that you find useful.
+     * }
+     * ```
+     *
+     * If you add custom properties, refer to the following help topic to learn how to serialize them into JSON: [Add Custom Properties to Property Grid](https://surveyjs.io/survey-creator/documentation/property-grid#add-custom-properties-to-the-property-grid).
+     *
+     * To enable Markdown support for the `text` property, implement Markdown-to-HTML conversion in the [onTextMarkdown](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onTextMarkdown) event handler. For an example, refer to the following demo: [Convert Markdown to HTML with markdown-it](https://surveyjs.io/form-library/examples/edit-survey-questions-markdown/).
+     *
+     * If you need to specify only the `value` property, you can set the `rateValues` property to an array of numbers, for example, `[ 3, 6, 10 ]`. These values are both saved in survey results and used as display text.
+     *
+     * If you do not specify the `rateValues` property, rate values are generated automatically based upon the [`rateMin`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateMin), [`rateMax`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateMax), [`rateStep`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateStep), and [`rateCount`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateCount) property values.
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
+     */
+    get rateValues(): Array<any>;
+    set rateValues(val: Array<any>);
+    /**
+     * Specifies the first rate value in the generated sequence of rate values. Applies if the [`rateValues`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateValues) array is empty.
+     *
+     * Default value: 1
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
+     * @see rateMax
+     * @see rateStep
+     * @see rateCount
+     */
+    get rateMin(): number;
+    set rateMin(val: number);
+    /**
+     * Specifies the last rate value in the generated sequence of rate values. Applies if the [`rateValues`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateValues) array is empty.
+     *
+     * Default value: 5
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
+     * @see rateMin
+     * @see rateStep
+     * @see rateCount
+     */
+    get rateMax(): number;
+    set rateMax(val: number);
+    /**
+     * Specifies a step with which to generate rate values. Applies if the [`rateValues`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateValues) array is empty.
+     *
+     * Default value: 1
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
+     * @see rateMin
+     * @see rateMax
+     * @see rateCount
+     */
+    get rateStep(): number;
+    set rateStep(val: number);
+    /**
+     * Specifies the number of rate values you want to generate. Applies if the [`rateValues`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateValues) array is empty.
+     *
+     * Set the [`rateMin`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateMin) or [`rateMax`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateMax) property to specify the first or the last rate value. Use the [`rateStep`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateStep) property to specify a step with which to generate rate values.
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
+     */
+    rateCount: number;
+    private static colorsCalculated;
+    private static badColor;
+    private static normalColor;
+    private static goodColor;
+    private static badColorLight;
+    private static normalColorLight;
+    private static goodColorLight;
+    private updateColors;
+    protected getDisplayValueCore(keysAsText: boolean, value: any): any;
+    get visibleRateValues(): ItemValue[];
+    protected supportEmptyValidation(): boolean;
+    itemValuePropertyChanged(item: ItemValue, name: string, oldValue: any, newValue: any): void;
+    protected runConditionCore(values: HashTable<any>, properties: HashTable<any>): void;
+    protected runRateItesmCondition(values: HashTable<any>, properties: HashTable<any>): void;
+    private getRateValuesCore;
+    private calculateRateValues;
+    private calculateRenderedRateItems;
+    private calculateVisibleChoices;
+    private iCounter;
+    private resetRenderedItems;
+    get renderedRateItems(): Array<RenderedRatingItem>;
+    get visibleChoices(): ItemValue[];
+    private createRateValues;
+    private getRatingItemValue;
+    private correctValue;
+    getType(): string;
+    protected getFirstInputElementId(): string;
+    getInputId(index: number): string;
+    get questionName(): string;
+    supportAutoAdvance(): boolean;
+    supportOther(): boolean;
+    protected getPlainDataCalculatedValue(propName: string): any;
+    /**
+     * Specifies a description for the minimum (first) rate value.
+     * @see rateDescriptionLocation
+     * @see displayRateDescriptionsAsExtremeItems
+     * @see rateValues
+     * @see rateMin
+     */
+    get minRateDescription(): string;
+    set minRateDescription(val: string);
+    get locMinRateDescription(): LocalizableString;
+    /**
+     * Specifies a description for the maximum (last) rate value.
+     * @see rateDescriptionLocation
+     * @see displayRateDescriptionsAsExtremeItems
+     * @see rateValues
+     * @see rateMax
+     */
+    get maxRateDescription(): string;
+    set maxRateDescription(val: string);
+    get locMaxRateDescription(): LocalizableString;
+    hasMinRateDescription: boolean;
+    hasMaxRateDescription: boolean;
+    get hasMinLabel(): boolean;
+    get hasMaxLabel(): boolean;
+    /**
+    * Specifies whether to display [`minRateDescription`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#minRateDescription) and [`maxRateDescription`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#maxRateDescription) values as captions for buttons that correspond to the extreme (first and last) rate values.
+    *
+    * Default value: `false`
+    *
+    * If this property is disabled, the `minRateDescription` and `maxRateDescription` values are displayed as plain non-clickable texts.
+    *
+    * If any of the `minRateDescription` and `maxRateDescription` properties is empty, the corresponding rate value's `value` or `text` is displayed as a button caption.
+    * @see rateDescriptionLocation
+    * @see rateMin
+    * @see rateMax
+    * @see rateValues
+    */
+    displayRateDescriptionsAsExtremeItems: boolean;
+    /**
+    * Specifies whether to display rate values as buttons or items in a drop-down list.
+    *
+    * Possible values:
+    *
+    * - `"buttons"` - Displays rate values as buttons in a row.
+    * - `"dropdown"` - Displays rate values as items in a drop-down list.
+    * - `"auto"` (default) - Selects between the `"buttons"` and `"dropdown"` modes based on the available width. When the width is insufficient to display buttons, the question displays a dropdown.
+    *
+    * [View Demo](https://surveyjs.io/form-library/examples/ui-adaptation-modes-for-rating-scale/ (linkStyle))
+    * @see rateType
+    */
+    displayMode: "dropdown" | "buttons" | "auto";
+    private updateRenderAsBasedOnDisplayMode;
+    onSurveyLoad(): void;
+    /**
+    * Specifies the alignment of [`minRateDescription`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#minRateDescription) and [`maxRateDescription`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#maxRateDescription) texts.
+    *
+    * Possible values:
+    *
+    * - `"leftRight"` (default) - Aligns `minRateDescription` to the left of rate values and `maxRateDescription` to their right.
+    * - `"top"` - Displays the descriptions above the minimum and maximum rate values.
+    * - `"bottom"` - Displays both descriptions below the minimum and maximum rate values.
+    * - `"topBottom"` - Displays `minRateDescription` above the minimum rate value and `maxRateDescription` below the maximum rate value.
+    * @see displayRateDescriptionsAsExtremeItems
+    */
+    rateDescriptionLocation: "leftRight" | "top" | "bottom" | "topBottom";
+    /**
+     * Specifies the visual representation of rate values.
+     *
+     * Possible values:
+     *
+     * - `"labels"` (default) - Displays rate values as buttons with labels.
+     * - `"stars"` - Displays rate values as stars.
+     * - `"smileys"` - Displays rate values as smiley faces.
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
+     * @see scaleColorMode
+     * @see rateColorMode
+     * @see displayMode
+     */
+    rateType: "labels" | "stars" | "smileys";
+    get rateDisplayMode(): "labels" | "stars" | "smileys";
+    set rateDisplayMode(val: "labels" | "stars" | "smileys");
+    /**
+     * Specifies how to colorize the smiley face rating scale. Applies only if [`rateType`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateType) is `"smileys"`.
+     *
+     * Possible values:
+     *
+     * - `"monochrome"` (default) - Displays emojis in monochrome.
+     * - `"colored"` - Displays emojis in color.
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/rating-scale/ (linkStyle))
+     * @see rateColorMode
+     */
+    scaleColorMode: "monochrome" | "colored";
+    /**
+     * Specifies how to colorize the selected emoji. Applies only if [`rateType`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model#rateType) is `"smileys"`.
+     *
+     * Possible values:
+     *
+     * - `"default"` - Displays the selected emoji in default survey color.
+     * - `"scale"` (default) - Inherits the color from the scale.
+     * @see scaleColorMode
+     */
+    rateColorMode: "default" | "scale";
+    get isStar(): boolean;
+    get isSmiley(): boolean;
+    getDefaultItemComponent(): string;
+    /**
+     * The name of a component used to render items.
+     */
+    get itemComponent(): string;
+    set itemComponent(value: string);
+    protected valueToData(val: any): any;
+    setValueFromClick(value: any): void;
+    onItemMouseIn(item: RenderedRatingItem): void;
+    onItemMouseOut(item: RenderedRatingItem): void;
+    get itemSmallMode(): boolean;
+    get ratingRootCss(): string;
+    get itemStarIcon(): string;
+    get itemStarIconAlt(): string;
+    getItemSmiley(item: ItemValue): string;
+    getItemSmileyIconName(item: ItemValue): string;
+    getItemClassByText(item: ItemValue, text: string): string;
+    private getRenderedItemColor;
+    getItemStyle(item: ItemValue, highlight?: "none" | "highlighted" | "unhighlighted"): {
+        "--sd-rating-item-color"?: undefined;
+        "--sd-rating-item-color-light"?: undefined;
+    } | {
+        "--sd-rating-item-color": string;
+        "--sd-rating-item-color-light": string;
+    } | {
+        "--sd-rating-item-color": string;
+        "--sd-rating-item-color-light"?: undefined;
+    };
+    getItemClass(item: ItemValue, highlight?: "none" | "highlighted" | "unhighlighted"): string;
+    getControlClass(): string;
+    get placeholder(): string;
+    set placeholder(val: string);
+    get locPlaceholder(): LocalizableString;
+    get allowClear(): boolean;
+    get searchEnabled(): boolean;
+    get renderedValue(): any;
+    set renderedValue(val: any);
+    isItemSelected(item: ItemValue): boolean;
+    get readOnlyText(): any;
+    needResponsiveWidth(): boolean;
+    protected supportResponsiveness(): boolean;
+    protected onBeforeSetCompactRenderer(): void;
+    protected getCompactRenderAs(): string;
+    protected getDesktopRenderAs(): string;
+    private dropdownListModelValue;
+    set dropdownListModel(val: DropdownListModel);
+    get dropdownListModel(): DropdownListModel;
+    protected onBlurCore(event: any): void;
+    protected updateCssClasses(res: any, css: any): void;
+    protected calcCssClasses(css: any): any;
+    themeChanged(theme: ITheme): void;
+    setSurveyImpl(value: ISurveyImpl, isLight?: boolean): void;
+    dispose(): void;
+}

package/typings/src/question_signaturepad.d.ts

@@ -0,0 +1,149 @@
+import { ITheme } from "./themes";
+import { QuestionFileModelBase } from "./question_file";
+/**
+ * A class that describes the Signature question type.
+ *
+ * [View Demo](https://surveyjs.io/form-library/examples/signature-pad-widget-javascript/ (linkStyle))
+ */
+export declare class QuestionSignaturePadModel extends QuestionFileModelBase {
+    isDrawingValue: boolean;
+    isReadyForUpload: boolean;
+    private getPenColorFromTheme;
+    private updateColors;
+    protected getCssRoot(cssClasses: any): string;
+    protected getFormat(): "" | "image/svg+xml" | "image/jpeg";
+    protected updateValue(): void;
+    constructor(name: string);
+    getType(): string;
+    afterRenderQuestionElement(el: HTMLElement): void;
+    beforeDestroyQuestionElement(el: HTMLElement): void;
+    themeChanged(theme: ITheme): void;
+    private canvas;
+    private element;
+    private scale;
+    private valueIsUpdatingInternally;
+    valueWasChangedFromLastUpload: boolean;
+    private resizeCanvas;
+    private scaleCanvas;
+    private fromUrl;
+    private fromDataUrl;
+    private _loadedData;
+    get loadedData(): string;
+    protected loadPreview(newValue: any): void;
+    protected onChangeQuestionValue(newValue: any): void;
+    onSurveyLoad(): void;
+    private updateValueHandler;
+    initSignaturePad(el: HTMLElement): void;
+    destroySignaturePad(el: HTMLElement): void;
+    /**
+     * Specifies the format in which to store the signature image.
+     *
+     * Possible values:
+     *
+     * - `"png"` (default)
+     * - `"jpeg"`
+     * - `"svg"`
+     */
+    get dataFormat(): string;
+    set dataFormat(val: string);
+    /**
+     * Specifies the width of the signature area. Accepts positive integer numbers.
+     */
+    get signatureWidth(): number;
+    set signatureWidth(val: number);
+    /**
+     * Specifies the height of the signature area. Accepts positive integer numbers.
+     */
+    get signatureHeight(): number;
+    set signatureHeight(val: number);
+    /**
+     * Specifies whether the signature area should be scaled to fit into the question width.
+     *
+     * Default value: `false`
+     *
+     * This property auto-scales the signature area to fill all available width within the question box while maintaining the default 3:2 aspect ratio. If you set [custom width](#signatureWidth) and [height](#signatureHeight) values, the setting will keep the aspect ratio of these dimensions.
+     *
+     * > The signature area is scaled only for display. The image saved in survey results will have dimensions specified by the [`signatureHeight`](#signatureHeight) and [`signatureWidth`](#signatureWidth) properties.
+     */
+    signatureAutoScaleEnabled: boolean;
+    /**
+     * Speicifies the minimum width of pen strokes, measured in pixels.
+     *
+     * Default value: 0.5
+     */
+    penMinWidth: number;
+    /**
+     * Speicifies the maximum width of pen strokes, measured in pixels.
+     *
+     * Default value: 2.5
+     */
+    penMaxWidth: number;
+    private get containerHeight();
+    private get containerWidth();
+    get renderedCanvasWidth(): string;
+    get height(): number;
+    set height(val: number);
+    /**
+     * Specifies whether to display a button that clears the signature area.
+     *
+     * Default value: `true`
+     */
+    get allowClear(): boolean;
+    set allowClear(val: boolean);
+    get canShowClearButton(): boolean;
+    /**
+     * Specifies a color for the pen.
+     *
+     * This property accepts color values in the following formats:
+     *
+     * - Hexadecimal colors (`"#FF0000"`)
+     * - RGB colors (`"rgb(255,0,0)"`)
+     * - Color names (`"red"`)
+     * @see backgroundColor
+     */
+    get penColor(): string;
+    set penColor(val: string);
+    /**
+     * Specifies a color for the signature area background. Ignored if [`backgroundImage`](#backgroundImage) is set.
+     *
+     * This property accepts color values in the following formats:
+     *
+     * - Hexadecimal colors (`"#FF0000"`)
+     * - RGB colors (`"rgb(255,0,0)"`)
+     * - Color names (`"red"`)
+     * @see penColor
+     */
+    get backgroundColor(): string;
+    set backgroundColor(val: string);
+    /**
+     * An image to display in the background of the signature area. Accepts a base64 or URL string value.
+     * @see backgroundColor
+     */
+    get backgroundImage(): string;
+    set backgroundImage(val: string);
+    get clearButtonCaption(): string;
+    /**
+     * A Boolean value that specifies whether to show the placeholder text in the signature area.
+     *
+     * Default value: `true`
+     *
+     * Use the [`placeholder`](#placeholder) and [`placeholderReadOnly`](#placeholderReadOnly) properties to specify placeholder texts for the signature area in edit mode and in read-only or preview mode.
+     */
+    showPlaceholder: boolean;
+    get locRenderedPlaceholder(): any;
+    nothingIsDrawn(): boolean;
+    needShowPlaceholder(): boolean;
+    /**
+     * A placeholder text for the signature area. Applies when the [`showPlaceholder`](#showPlaceholder) property is `true`.
+     */
+    placeholder: string;
+    /**
+     * A placeholder text for the signature area in read-only or preview mode. Applies when the [`showPlaceholder`](#showPlaceholder) property is `true`.
+     */
+    placeholderReadOnly: string;
+    protected onBlurCore(event: any): void;
+    protected uploadResultItemToValue(r: any): any;
+    protected setValueFromResult(arg: any): void;
+    clearValue(keepComment?: boolean): void;
+    endLoadingFromJson(): void;
+}