survey-react-ui 1.8.79 → 1.9.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "survey-react-ui",
-  "version": "1.8.79",
+  "version": "1.9.3",
   "description": "survey.js is a JavaScript Survey Library. It is a modern way to add a survey to your website. It uses JSON for survey metadata and results.",
   "keywords": [
     "Survey",
@@ -26,7 +26,7 @@
   "typings": "survey-react-ui.d.ts",
   "dependencies": {
     "survey-core": "*",
-    "react": "^17.0.1",
-    "react-dom": "^17.0.1"
+    "react": "^16.5.0 || ^17.0.1",
+    "react-dom": "^16.5.0 || ^17.0.1"
   }
 }

package/survey-react-ui.d.ts

@@ -1,4 +1,4 @@
-/*Type definitions for Survey JavaScript library v1.8.79
+/*Type definitions for Survey JavaScript library v1.9.3
 Copyright (c) 2015-2021 Devsoft Baltic OÜ  - http://surveyjs.io/
 Definitions by: Devsoft Baltic OÜ <https://github.com/surveyjs/>
 */
@@ -168,6 +168,7 @@ export declare class SurveyPanel extends SurveyPanelBase {
     constructor(props: any);
     get panel(): PanelModel;
     protected renderElement(): JSX.Element;
+    protected renderHeader(): JSX.Element;
     protected wrapElement(element: JSX.Element): JSX.Element;
     protected renderContent(style: any, rows: JSX.Element[], className: string): JSX.Element;
     protected renderTitle(): JSX.Element;
@@ -388,6 +389,9 @@ export declare class SurveyQuestionMatrixRow extends ReactSurveyElement {
 export declare class SurveyQuestionHtml extends SurveyQuestionElementBase {
     constructor(props: any);
     protected get question(): QuestionHtmlModel;
+    componentDidMount(): void;
+    componentWillUnmount(): void;
+    componentDidUpdate(prevProps: any, prevState: any): void;
     protected canRender(): boolean;
     protected renderElement(): JSX.Element;
 }
@@ -398,6 +402,7 @@ export declare class SurveyQuestionFile extends SurveyQuestionElementBase {
     protected renderElement(): JSX.Element;
     protected renderFileDecorator(): JSX.Element;
     protected renderClearButton(className: string): JSX.Element;
+    protected renderFileSign(className: string, val: any): JSX.Element;
     protected renderPreview(): JSX.Element;
 }
 
@@ -514,11 +519,12 @@ export declare class SurveyQuestionPanelDynamic extends SurveyQuestionElementBas
     handleOnRangeChange(event: any): void;
     protected renderElement(): JSX.Element;
     protected renderNavigator(): JSX.Element;
-    protected rendrerPrevButton(viewBox?: string, icon?: JSX.Element): JSX.Element;
-    protected rendrerNextButton(viewBox?: string, icon?: JSX.Element): JSX.Element;
+    protected rendrerPrevButton(): JSX.Element;
+    protected rendrerNextButton(): JSX.Element;
     protected renderRange(): JSX.Element;
     protected renderAddRowButton(): JSX.Element;
     protected renderNavigatorV2(): JSX.Element;
+    protected renderPlaceholder(): JSX.Element;
 }
 export declare class SurveyQuestionPanelDynamicItem extends SurveyPanel {
     constructor(props: any);
@@ -838,7 +844,7 @@ declare function isElementVisible(element: HTMLElement, threshold?: number): boo
 declare function findScrollableParent(element: HTMLElement): HTMLElement;
 declare function scrollElementByChildId(id: string): void;
 declare function getIconNameFromProxy(iconName: string): string;
-declare function createSvg(size: number, width: number, height: number, iconName: string, svgElem: any): void;
+declare function createSvg(size: number | string, width: number, height: number, iconName: string, svgElem: any): void;
 export declare function unwrap<T>(value: T | (() => T)): T;
 export declare function getSize(value: any): any;
 declare function doKey2ClickUp(evt: KeyboardEvent, options?: {
@@ -931,6 +937,8 @@ export declare class QuestionCheckboxModel extends QuestionCheckboxBase {
         protected onAfterRunItemsEnableCondition(): void;
         protected getItemClassCore(item: any, options: any): string;
         updateValueFromSurvey(newValue: any): void;
+        protected setDefaultValue(): void;
+        protected hasValueToClearIncorrectValues(): boolean;
         protected setNewValue(newValue: any): void;
         protected getIsMultipleValue(): boolean;
         protected getCommentFromValue(newValue: any): string;
@@ -1108,7 +1116,7 @@ export declare class Base {
             * @param val new property value
             */
         setPropertyValue(name: string, val: any): void;
-        protected setArrayPropertyDirectly(name: string, val: any): void;
+        protected setArrayPropertyDirectly(name: string, val: any, sendNotification?: boolean): void;
         protected setPropertyValueDirectly(name: string, val: any): void;
         protected clearPropertyValue(name: string): void;
         onPropertyValueChangedCallback(name: string, oldValue: any, newValue: any, sender: Base, arrayChanges: ArrayChanges): void;
@@ -1143,7 +1151,7 @@ export declare class Base {
             */
         unRegisterFunctionOnPropertiesValueChanged(names: Array<string>, key?: string): void;
         createCustomLocalizableObj(name: string): void;
-        protected createLocalizableString(name: string, owner: ILocalizableOwner, useMarkDown?: boolean, hasDefaultValue?: boolean): LocalizableString;
+        protected createLocalizableString(name: string, owner: ILocalizableOwner, useMarkDown?: boolean, defaultStr?: boolean | string): LocalizableString;
         getLocalizableString(name: string): LocalizableString;
         getLocalizableStringText(name: string, defaultStr?: string): string;
         setLocalizableStringText(name: string, value: string): void;
@@ -1407,9 +1415,7 @@ export declare class QuestionSelectBase extends Question {
         /**
             *  Use this property to set the place holder text for other or comment field  .
             */
-        get otherPlaceHolder(): string;
-        set otherPlaceHolder(val: string);
-        get locOtherPlaceHolder(): LocalizableString;
+        otherPlaceHolder: string;
         /**
             * The text that shows when the other item is choosed by the other input is empty.
             */
@@ -1477,6 +1483,7 @@ export declare class QuestionSelectBase extends Question {
         onSurveyValueChanged(newValue: any): void;
         protected onVisibleChoicesChanged(): void;
         clearIncorrectValues(): void;
+        protected hasValueToClearIncorrectValues(): boolean;
         clearValueIfInvisible(): void;
         /**
             * Returns true if item is selected
@@ -1608,15 +1615,16 @@ export declare class LocalizableStrings implements ILocalizableString {
         setJson(value: any): void;
 }
 
-export interface IPropertyDecoratorOptions {
-        defaultValue?: any;
+export interface IPropertyDecoratorOptions<T = any> {
+        defaultValue?: T;
         defaultSource?: string;
+        getDefaultValue?: (objectInstance?: any) => T;
         localizable?: {
                 name?: string;
                 onGetTextCallback?: (str: string) => string;
                 defaultStr?: string;
         } | boolean;
-        onSet?: (val: any, target: any) => void;
+        onSet?: (val: T, objectInstance: any) => void;
 }
 export declare function property(options?: IPropertyDecoratorOptions): (target: any, key: string) => void;
 export interface IArrayPropertyDecoratorOptions {
@@ -1869,6 +1877,7 @@ export interface ISurvey extends ITextProcessor, ISurveyErrorOwner {
     requiredText: string;
     beforeSettingQuestionErrors(question: IQuestion, errors: Array<SurveyError>): void;
     beforeSettingPanelErrors(question: IPanel, errors: Array<SurveyError>): void;
+    getSurveyErrorCustomText(obj: Base, text: string, error: SurveyError): string;
     getElementTitleTagName(element: Base, tagName: string): string;
     questionTitlePattern: string;
     getUpdatedQuestionTitle(question: IQuestion, title: string): string;
@@ -2202,6 +2211,7 @@ export interface IAction {
             * Set this property to true to activate the toolbar item (page)
             */
         active?: boolean;
+        pressed?: boolean;
         /**
             * Toolbar item template name
             */
@@ -2265,6 +2275,7 @@ export declare class Action extends Base implements IAction {
         popupModel: any;
         needSeparator: boolean;
         active: boolean;
+        pressed: boolean;
         template: string;
         component: string;
         items: any;
@@ -2345,8 +2356,6 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
             */
         onReadyChanged: EventBase<Question>;
         isReadOnlyRenderDiv(): boolean;
-        get isErrorsModeTooltip(): boolean;
-        get hasParent(): boolean;
         constructor(name: string);
         protected createLocTitleProperty(): LocalizableString;
         getSurvey(live?: boolean): ISurvey;
@@ -2519,6 +2528,11 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
         get commentText(): string;
         set commentText(val: string);
         get locCommentText(): LocalizableString;
+        /**
+            *  Use this property to set the place holder text for comment field  .
+            */
+        commentPlaceHolder: string;
+        get commentOrOtherPlaceHolder(): string;
         /**
             * Returns a copy of question errors survey. For some questions like matrix and panel dynamic it includes the errors of nested questions.
             */
@@ -3028,6 +3042,7 @@ export interface IMatrixDropdownData {
         getRenderer(name: string): string;
         getRendererContext(locStr: LocalizableString): any;
         getProcessedText(text: string): string;
+        getParentTextProcessor(): ITextProcessor;
         getSharedQuestionByName(columnName: string, row: MatrixDropdownRowModelBase): Question;
         onTotalValueChanged(): any;
         getSurvey(): ISurvey;
@@ -3341,9 +3356,11 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
         setIsDetailPanelShowing(row: MatrixDropdownRowModelBase, val: boolean): void;
         getDetailPanelButtonCss(row: MatrixDropdownRowModelBase): string;
         getDetailPanelIconCss(row: MatrixDropdownRowModelBase): string;
+        getDetailPanelIconId(row: MatrixDropdownRowModelBase): string;
         createRowDetailPanel(row: MatrixDropdownRowModelBase): PanelModel;
         getSharedQuestionByName(columnName: string, row: MatrixDropdownRowModelBase): Question;
         onTotalValueChanged(): any;
+        getParentTextProcessor(): ITextProcessor;
         getQuestionFromArray(name: string, index: number): IQuestion;
         getCellTemplateData(cell: QuestionMatrixDropdownRenderedCell): any;
         getCellWrapperComponentName(cell: MatrixDropdownCell): string;
@@ -3374,6 +3391,10 @@ export declare class PopupUtils {
         height: number;
         top: number;
     };
+    static updateHorizontalDimensions(left: number, width: number, windowWidth: number, horizontalPosition: HorizontalPosition): {
+        width: number;
+        left: number;
+    };
     static updateVerticalPosition(targetRect: ClientRect, height: number, verticalPosition: VerticalPosition, showPointer: boolean, windowHeight: number): VerticalPosition;
     static calculatePopupDirection(verticalPosition: VerticalPosition, horizontalPosition: HorizontalPosition): string;
     static calculatePointerTarget(targetRect: ClientRect, top: number, left: number, verticalPosition: VerticalPosition, horizontalPosition: HorizontalPosition): INumberPosition;
@@ -3531,6 +3552,7 @@ export declare class SurveyElement extends SurveyElementCore implements ISurveyE
         protected updateElementCssCore(cssClasses: any): void;
         get cssError(): string;
         updateElementCss(reNew?: boolean): void;
+        protected clearCssClasses(): void;
         protected getIsLoadingFromJson(): boolean;
         /**
             * This is the identifier of a survey element - question or panel.
@@ -3597,6 +3619,10 @@ export declare class SurveyElement extends SurveyElementCore implements ISurveyE
         protected moveToBase(parent: IPanel, container: IPanel, insertBefore?: any): boolean;
         protected setPage(parent: IPanel, newPage: IPage): void;
         protected getSearchableLocKeys(keys: Array<string>): void;
+        protected get isDefaultV2Theme(): boolean;
+        get isErrorsModeTooltip(): boolean;
+        get hasParent(): boolean;
+        protected get hasFrameV2(): boolean;
 }
 
 export declare class ValidatorResult {
@@ -3767,6 +3793,7 @@ export declare class QuestionTextProcessor implements ITextProcessor {
     protected get panel(): PanelModel;
     protected getValues(): any;
     protected getQuestionByName(name: string): Question;
+    protected getParentTextProcessor(): ITextProcessor;
     protected onCustomProcessText(textValue: TextPreProcessorValue): boolean;
     processText(text: string, returnDisplayValue: boolean): string;
     processTextEx(text: string, returnDisplayValue: boolean): any;
@@ -3827,6 +3854,8 @@ export declare class QuestionMatrixBaseModel<TRow, TColumn> extends Question {
         constructor(name: string);
         getType(): string;
         get isCompositeQuestion(): boolean;
+        get showColumnHeader(): boolean;
+        set showColumnHeader(val: boolean);
         /**
             * Set this property to false, to hide table header. The default value is true.
             */
@@ -3920,6 +3949,7 @@ export declare class PanelModelBase extends SurveyElement implements IPanel, ICo
         setSurveyImpl(value: ISurveyImpl, isLight?: boolean): void;
         endLoadingFromJson(): void;
         get hasTitle(): boolean;
+        get hasDescription(): boolean;
         protected canShowTitle(): boolean;
         get _showDescription(): boolean;
         localeChanged(): void;
@@ -4329,6 +4359,7 @@ export declare class PanelModel extends PanelModelBase implements IElement {
         protected onVisibleChanged(): void;
         needResponsiveWidth(): boolean;
         focusIn: () => void;
+        getContainerCss(): string;
 }
 
 export interface IMatrixColumnOwner extends ILocalizableOwner {
@@ -4500,6 +4531,7 @@ export declare class QuestionMatrixDropdownRenderedCell {
     set className(val: string);
     get className(): string;
     get headers(): string;
+    getTitle(): string;
     calculateFinalClassName(matrixCssClasses: any): string;
 }
 export declare class QuestionMatrixDropdownRenderedRow extends Base {