survey-react 1.11.6 → 1.11.8

package/survey.react.d.ts

@@ -912,6 +912,7 @@ declare module "utils/utils" {
         }>;
         mergedItems: Array<T>;
     };
+    export function roundTo2Decimals(number: number): number;
     export { mergeValues, getElementWidth, isContainerVisible, classesToSelector, compareVersions, confirmAction, confirmActionAsync, detectIEOrEdge, detectIEBrowser, loadFileFromBase64, isMobile, isShadowDOM, getElement, isElementVisible, findScrollableParent, scrollElementByChildId, navigateToUrl, wrapUrlForBackgroundImage, createSvg, getIconNameFromProxy, increaseHeightByContent, getOriginalEvent, preventDefaults, findParentByClassNames, getFirstVisibleChild, chooseFiles };
 }
 declare module "actions/container" {
@@ -2569,6 +2570,17 @@ declare module "calculatedValue" {
         private ensureExpression;
     }
 }
+declare module "panel-layout-column" {
+    import { Base } from "base";
+    export class PanelLayoutColumnModel extends Base {
+        width: number;
+        effectiveWidth: number;
+        questionTitleWidth: string;
+        constructor(width?: number, questionTitleWidth?: string);
+        getType(): string;
+        isEmpty(): boolean;
+    }
+}
 declare module "textPreProcessor" {
     import { Question } from "question";
     import { PanelModel } from "panel";
@@ -2704,6 +2716,7 @@ declare module "question_custom" {
     import { ISurveyImpl, ISurveyData, ITextProcessor, IPanel, IElement, IQuestion, IProgressInfo } from "base-interfaces";
     import { SurveyElement } from "survey-element";
     import { PanelModel } from "panel";
+    import { PanelLayoutColumnModel } from "panel-layout-column";
     import { HashTable } from "helpers";
     import { ItemValue } from "itemvalue";
     import { SurveyError } from "survey-error";
@@ -3043,6 +3056,8 @@ declare module "question_custom" {
         removeElement(element: IElement): boolean;
         getQuestionTitleLocation(): string;
         getQuestionTitleWidth(): string;
+        getColumsForElement(el: IElement): Array<PanelLayoutColumnModel>;
+        updateColumns(): void;
         getQuestionStartIndex(): string;
         getChildrenLayoutType(): string;
         elementWidthChanged(el: IElement): void;
@@ -3050,6 +3065,7 @@ declare module "question_custom" {
         indexOf(el: IElement): number;
         ensureRowsVisibility(): void;
         validateContainerOnly(): void;
+        onQuestionValueChanged(el: IElement): void;
         getQuestionErrorLocation(): string;
         protected getContentDisplayValueCore(keyAsText: boolean, value: any, question: Question): any;
     }
@@ -3209,6 +3225,7 @@ declare module "panel" {
     import { ActionContainer } from "actions/container";
     import { DragDropInfo } from "drag-drop-helper-v1";
     import { AnimationGroup } from "utils/animation";
+    import { PanelLayoutColumnModel } from "panel-layout-column";
     export class QuestionRowModel extends Base {
         panel: PanelModelBase;
         private static rowCounter;
@@ -3259,6 +3276,9 @@ declare module "panel" {
         private elementsValue;
         private isQuestionsReady;
         private questionsValue;
+        private _columns;
+        private _columnsReady;
+        layoutColumns: Array<PanelLayoutColumnModel>;
         addElementCallback: (element: IElement) => void;
         removeElementCallback: (element: IElement) => void;
         onGetQuestionTitleLocation: () => string;
@@ -3447,6 +3467,7 @@ declare module "panel" {
          */
         validate(fireCallback?: boolean, focusOnFirstError?: boolean, rec?: any): boolean;
         validateContainerOnly(): void;
+        onQuestionValueChanged(el: IElement): void;
         private hasErrorsInPanels;
         getErrorCustomText(text: string, error: SurveyError): string;
         private hasRequiredError;
@@ -3469,6 +3490,11 @@ declare module "panel" {
         addPanelsIntoList(list: Array<IPanel>, visibleOnly?: boolean, includingDesignTime?: boolean): void;
         private addElementsToList;
         private addElementsToListCore;
+        private calcMaxRowColSpan;
+        private updateColumnWidth;
+        private onColumnPropertyValueChangedCallback;
+        updateColumns(): void;
+        updateRootStyle(): void;
         updateCustomWidgets(): void;
         /**
          * Sets a title location relative to the input field for questions that belong to this panel/page.
@@ -3498,6 +3524,9 @@ declare module "panel" {
          */
         questionTitleWidth: string;
         getQuestionTitleWidth(): string;
+        get columns(): Array<PanelLayoutColumnModel>;
+        protected generateColumns(): void;
+        getColumsForElement(el: IElement): Array<PanelLayoutColumnModel>;
         protected getStartIndex(): string;
         getQuestionStartIndex(): string;
         getChildrenLayoutType(): string;
@@ -3648,6 +3677,7 @@ declare module "panel" {
         get no(): string;
         get cssError(): string;
         protected getCssError(cssClasses: any): string;
+        getSerializableColumnsValue(): Array<PanelLayoutColumnModel>;
         dispose(): void;
     }
     /**
@@ -3662,6 +3692,8 @@ declare module "panel" {
         getType(): string;
         get contentId(): string;
         getSurvey(live?: boolean): ISurvey;
+        get hasTextInTitle(): boolean;
+        private calcHasTextInTitle;
         onSurveyLoad(): void;
         protected onSetData(): void;
         get isPanel(): boolean;
@@ -8242,6 +8274,7 @@ declare module "page" {
          */
         get maxTimeToFinish(): number;
         set maxTimeToFinish(val: number);
+        getMaxTimeToFinish(): number;
         protected onNumChanged(value: number): void;
         protected onVisibleChanged(): void;
         getDragDropInfo(): any;
@@ -8334,20 +8367,25 @@ declare module "stylesmanager" {
     }
 }
 declare module "surveytimer" {
-    import { Event } from "base";
+    import { EventBase } from "base";
     export 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 class SurveyTimer {
         private static instanceValue;
         static get instance(): SurveyTimer;
         private listenerCounter;
         private timerId;
-        onTimer: Event<() => any, SurveyTimer, any>;
-        start(func?: () => any): void;
-        stop(func?: () => any): void;
+        private prevTimeInMs;
+        onTimer: EventBase<SurveyTimer, SurveyTimerEvent>;
+        start(func?: (timer: SurveyTimer, options: SurveyTimerEvent) => void): void;
+        stop(func?: (timer: SurveyTimer, options: SurveyTimerEvent) => any): void;
         doTimer(): void;
     }
 }
@@ -8619,6 +8657,7 @@ declare module "mask/input_element_adapter" {
         inputMaskInstancePropertyChangedHandler: (sender: any, options: any) => void;
         clickHandler: (event: any) => void;
         beforeInputHandler: (event: any) => void;
+        changeHandler: (event: any) => void;
         createArgs(event: any): ITextInputParams;
         addInputEventListener(): void;
         removeInputEventListener(): void;
@@ -8766,6 +8805,9 @@ declare module "question_text" {
         set inputValue(val: string);
         protected onChangeQuestionValue(newValue: any): void;
         private updateInputValue;
+        private hasToConvertToUTC;
+        protected valueForSurveyCore(val: any): any;
+        protected valueFromDataCore(val: any): any;
         protected onCheckForErrors(errors: Array<SurveyError>, isOnValueChanged: boolean): void;
         protected canSetValueToSurvey(): boolean;
         protected convertFuncValuetoQuestionValue(val: any): any;
@@ -8773,6 +8815,7 @@ declare module "question_text" {
         private get isValueLessMin();
         private get isValueGreaterMax();
         private get isDateInputType();
+        private isDateTimeLocaleType;
         private getCalculatedMinMax;
         private setRenderedMinMax;
         /**
@@ -8822,6 +8865,7 @@ declare module "question_multipletext" {
     import { ILocalizableOwner, LocalizableString } from "localizablestring";
     import { HashTable } from "helpers";
     import { InputMaskBase } from "mask/mask_base";
+    import { PanelLayoutColumnModel } from "panel-layout-column";
     export interface IMultipleTextData extends ILocalizableOwner, IPanel {
         getSurvey(): ISurvey;
         getTextProcessor(): ITextProcessor;
@@ -9122,6 +9166,8 @@ declare module "question_multipletext" {
         removeElement(element: IElement): boolean;
         getQuestionTitleLocation(): string;
         getQuestionTitleWidth(): string;
+        getColumsForElement(el: IElement): Array<PanelLayoutColumnModel>;
+        updateColumns(): void;
         getQuestionStartIndex(): string;
         getChildrenLayoutType(): string;
         elementWidthChanged(el: IElement): void;
@@ -9129,6 +9175,7 @@ declare module "question_multipletext" {
         indexOf(el: IElement): number;
         ensureRowsVisibility(): void;
         validateContainerOnly(): void;
+        onQuestionValueChanged(el: IElement): void;
         getItemLabelCss(item: MultipleTextItemModel): string;
         getItemCss(): string;
         getItemTitleCss(): string;
@@ -12019,6 +12066,7 @@ declare module "survey" {
          */
         get showTimerPanelMode(): string;
         set showTimerPanelMode(val: string);
+        gridLayoutEnabled: boolean;
         /**
           * Specifies how to calculate the survey width.
           *
@@ -12115,7 +12163,6 @@ declare module "survey" {
          */
         get maxTimeToFinishPage(): number;
         set maxTimeToFinishPage(val: number);
-        private getPageMaxTimeToFinish;
         private doTimer;
         get inSurvey(): boolean;
         getSurveyData(): ISurveyData;
@@ -12200,6 +12247,7 @@ declare module "survey" {
         dispose(): void;
         disposeCallback: () => void;
         private onScrollCallback;
+        _isElementShouldBeSticky(selector: string): boolean;
         onScroll(): void;
         addScrollEventListener(): void;
         removeScrollEventListener(): void;
@@ -12319,6 +12367,9 @@ declare module "survey-element" {
         private static focusElementCore;
         static CreateDisabledDesignElements: boolean;
         disableDesignActions: boolean;
+        effectiveColSpan: number;
+        get colSpan(): number;
+        set colSpan(val: number);
         constructor(name: string);
         protected onPropertyValueChanged(name: string, oldValue: any, newValue: any): void;
         protected getSkeletonComponentNameCore(): string;
@@ -12603,9 +12654,8 @@ declare module "survey-element" {
         get paddingRight(): string;
         set paddingRight(val: string);
         allowRootStyle: boolean;
-        get rootStyle(): {
-            [index: string]: any;
-        };
+        rootStyle: any;
+        updateRootStyle(): void;
         private isContainsSelection;
         get clickTitleFunction(): any;
         protected needClickTitleFunction(): boolean;
@@ -12783,6 +12833,7 @@ declare module "question" {
         themeChanged(theme: ITheme): void;
         isMobile: boolean;
         forceIsInputReadOnly: boolean;
+        ariaExpanded: "true" | "false";
         constructor(name: string);
         protected getDefaultTitle(): string;
         protected createLocTitleProperty(): LocalizableString;
@@ -12975,6 +13026,7 @@ declare module "question" {
         private notifySurveyVisibilityChanged;
         protected clearValueOnHidding(isClearOnHidden: boolean): void;
         get titleWidth(): string;
+        getPercentQuestionTitleWidth(): number;
         /**
          * Returns title location calculated based on the question's `titleLocation` property and the `questionTitleLocation` property of the question's containers (survey, page, or panel).
          * @see titleLocation
@@ -13128,6 +13180,7 @@ declare module "question" {
          */
         focus(onError?: boolean, scrollIfVisible?: boolean): void;
         private focuscore;
+        focusInputElement(onError: boolean): void;
         expandAllParents(): void;
         private expandAllParentsCore;
         focusIn(): void;
@@ -13271,6 +13324,8 @@ declare module "question" {
         getFilteredValue(): any;
         getFilteredName(): any;
         get valueForSurvey(): any;
+        protected valueForSurveyCore(val: any): any;
+        protected valueFromDataCore(val: any): any;
         /**
          * Sets the question's `value` and `comment` properties to `undefined`.
          * @see value
@@ -13597,7 +13652,6 @@ declare module "question" {
         get ariaInvalid(): "true" | "false";
         get ariaLabelledBy(): string;
         get ariaDescribedBy(): string;
-        get ariaExpanded(): string;
         get ariaErrormessage(): string;
         get a11y_input_ariaRole(): string;
         get a11y_input_ariaRequired(): "true" | "false";
@@ -14151,6 +14205,7 @@ declare module "question_matrixdropdownbase" {
          */
         get cellType(): string;
         set cellType(val: string);
+        isSelectCellType(): boolean;
         private updateColumnsCellType;
         private updateColumnsIndexes;
         /**
@@ -14363,6 +14418,7 @@ declare module "base-interfaces" {
     import { Base } from "base";
     import { IAction } from "actions/action";
     import { PanelModel } from "panel";
+    import { PanelLayoutColumnModel } from "panel-layout-column";
     import { QuestionPanelDynamicModel } from "question_paneldynamic";
     import { DragDropAllowEvent } from "survey-events-api";
     import { PopupModel } from "popup";
@@ -14421,6 +14477,7 @@ declare module "base-interfaces" {
         getRendererForString(element: Base, name: string): string;
         getRendererContextForString(element: Base, locStr: LocalizableString): any;
         getExpressionDisplayValue(question: IQuestion, value: any, displayValue: string): string;
+        gridLayoutEnabled: boolean;
         isDisplayMode: boolean;
         isDesignMode: boolean;
         areInvisibleElementsShowing: boolean;
@@ -14457,6 +14514,7 @@ declare module "base-interfaces" {
         maxTextLength: number;
         maxOthersLength: number;
         clearValueOnDisableItems: boolean;
+        maxTimeToFinishPage: number;
         uploadFiles(question: IQuestion, name: string, files: File[], uploadingCallback: (data: any | Array<any>, errors?: any | Array<any>) => any): any;
         downloadFile(question: IQuestion, name: string, content: string, callback: (status: string, data: any) => any): any;
         clearFiles(question: IQuestion, name: string, value: any, fileName: string, clearCallback: (status: string, data: any) => any): any;
@@ -14568,6 +14626,7 @@ declare module "base-interfaces" {
         isCollapsed: boolean;
         rightIndent: number;
         startWithNewLine: boolean;
+        colSpan?: number;
         registerPropertyChangedHandlers(propertyNames: Array<string>, handler: any, key: string): void;
         registerFunctionOnPropertyValueChanged(name: string, func: any, key: string): void;
         unRegisterFunctionOnPropertyValueChanged(name: string, key: string): void;
@@ -14581,6 +14640,7 @@ declare module "base-interfaces" {
         clearErrors(): any;
         dispose(): void;
         needResponsiveWidth(): boolean;
+        updateRootStyle(): void;
     }
     export interface IQuestion extends IElement, ISurveyErrorOwner {
         hasTitle: boolean;
@@ -14611,12 +14671,15 @@ declare module "base-interfaces" {
         getQuestionTitleWidth(): string;
         getQuestionStartIndex(): string;
         getQuestionErrorLocation(): string;
+        getColumsForElement(el: IElement): Array<PanelLayoutColumnModel>;
+        updateColumns(): void;
         parent: IPanel;
         elementWidthChanged(el: IElement): any;
         indexOf(el: IElement): number;
         elements: Array<IElement>;
         ensureRowsVisibility(): void;
         validateContainerOnly(): void;
+        onQuestionValueChanged(el: IElement): void;
     }
     export interface IPage extends IPanel, IConditionRunner {
         isStartPage: boolean;
@@ -14691,7 +14754,7 @@ declare module "jsonobject" {
             onGetTextCallback?: (str: string) => string;
             defaultStr?: string;
         } | boolean;
-        onSet?: (val: T, objectInstance: any) => void;
+        onSet?: (val: T, objectInstance: any, prevVal?: T) => void;
     }
     export function property(options?: IPropertyDecoratorOptions): (target: any, key: string) => void;
     export interface IArrayPropertyDecoratorOptions {
@@ -16211,6 +16274,36 @@ declare module "settings" {
                 [key: string]: RegExp;
             };
         };
+        /**
+         * Specifies whether to store date-time values in the following format: `"YYYY-MM-DDThh:mm:ss.sssZ"`. Applies only to form fields with [`inputType`](https://surveyjs.io/form-library/documentation/api-reference/text-entry-question-model#inputType) set to `"datetime-local"`.
+         *
+         * Default value: `false`
+         *
+         * If you enable this setting, date-time values are converted from local time to UTC when they are saved to the survey's [`data`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#data) object, while the question values remain in local time. Therefore, when you specify default values using a question's [`defaultValue`](https://surveyjs.io/form-library/documentation/api-reference/text-entry-question-model#defaultValue) property, you need to use local time, but if you specify them using the `data` object, use a UTC date-time value in the following format: `"YYYY-MM-DDThh:mm:ss.sssZ"`.
+         *
+         * ```js
+         * const surveyJson = {
+         *   "elements": [{
+         *     "name": "datetime",
+         *     "type": "text",
+         *     "title": "Select a date and time",
+         *     "inputType": "datetime-local",
+         *     "defaultValue": "2024-07-16T12:15:00" // Local date-time value
+         *   }]
+         * }
+         * ```
+         *
+         * ```js
+         * import { Model } from "survey-core";
+         * const surveyJson = { ... }
+         * const survey = new Model(surveyJson);
+         *
+         * survey.data = {
+         *   datetime: "2024-07-16T12:15:00.000Z" // UTC date-time value
+         * }
+         * ```
+         */
+        storeUtcDates: boolean;
     };
 }
 declare module "question_matrixdropdown" {
@@ -16336,7 +16429,7 @@ declare module "dropdownListModel" {
         get showHintString(): boolean;
         get hintStringSuffix(): string;
         get hintStringMiddle(): string;
-        private qustionPropertyChangedHandler;
+        private questionPropertyChangedHandler;
         constructor(question: Question, onSelectionChanged?: (item: IAction, ...params: any[]) => void);
         get popupModel(): PopupModel;
         get noTabIndex(): boolean;
@@ -16501,7 +16594,6 @@ declare module "question_dropdown" {
         get dropdownListModel(): DropdownListModel;
         set dropdownListModel(val: DropdownListModel);
         get popupModel(): PopupModel;
-        get ariaExpanded(): string;
         onOpened: EventBase<QuestionDropdownModel>;
         onOpenedCallBack(): void;
         protected onSelectedItemValuesChangedHandler(newValue: any): void;
@@ -16512,6 +16604,7 @@ declare module "question_dropdown" {
         protected getFirstInputElementId(): string;
         getInputId(): string;
         clearValue(keepComment?: boolean): void;
+        afterRenderCore(el: any): void;
         onClick(e: any): void;
         onKeyUp(event: any): void;
         dispose(): void;
@@ -17067,7 +17160,6 @@ declare module "question_tagbox" {
         getType(): string;
         get ariaRole(): string;
         get popupModel(): PopupModel;
-        get ariaExpanded(): string;
         getControlClass(): string;
         onOpened: EventBase<QuestionTagboxModel>;
         onOpenedCallBack(): void;
@@ -17487,16 +17579,16 @@ declare module "question_comment" {
          * Default value: `false` (inherited from `SurveyModel`'s [`autoGrowComment`](https://surveyjs.io/form-library/documentation/surveymodel#autoGrowComment) property)
          * @see allowResize
          */
-        get autoGrow(): boolean;
-        set autoGrow(val: boolean);
+        get autoGrow(): boolean | undefined;
+        set autoGrow(val: boolean | undefined);
+        get renderedAutoGrow(): boolean;
         /**
-         * Specifies whether to display a resize handle for the comment area.
          *
          * Default value: `true` (inherited from `SurveyModel`'s [`allowResizeComment`](https://surveyjs.io/form-library/documentation/surveymodel#allowResizeComment) property)
          * @see autoGrow
          */
-        get allowResize(): boolean;
-        set allowResize(val: boolean);
+        get allowResize(): boolean | undefined;
+        set allowResize(val: boolean | undefined);
         get renderedAllowResize(): boolean;
         get resizeStyle(): "none" | "both";
         getType(): string;
@@ -17858,7 +17950,6 @@ declare module "question_rating" {
         protected onBeforeSetCompactRenderer(): void;
         protected getCompactRenderAs(): string;
         protected getDesktopRenderAs(): string;
-        get ariaExpanded(): string;
         private dropdownListModelValue;
         set dropdownListModel(val: DropdownListModel);
         get dropdownListModel(): DropdownListModel;
@@ -27333,6 +27424,15 @@ declare module "react/components/loading-indicator" {
         render(): JSX.Element | null;
     }
 }
+declare module "react/components/file/file-choose-button" {
+    import { ReactSurveyElement } from "react/reactquestion_element";
+    import { QuestionFileModel } from "entries/core";
+    export class SurveyFileChooseButton extends ReactSurveyElement {
+        constructor(props: any);
+        protected get question(): QuestionFileModel;
+        render(): JSX.Element;
+    }
+}
 declare module "react/reactquestion_file" {
     import { QuestionFileModel } from "entries/core";
     import { SurveyQuestionElementBase } from "react/reactquestion_element";
@@ -27348,15 +27448,6 @@ declare module "react/reactquestion_file" {
         protected renderVideo(): JSX.Element;
     }
 }
-declare module "react/components/file/file-choose-button" {
-    import { ReactSurveyElement } from "react/reactquestion_element";
-    import { QuestionFileModel } from "entries/core";
-    export class SurveyFileChooseButton extends ReactSurveyElement {
-        constructor(props: any);
-        protected get question(): QuestionFileModel;
-        render(): JSX.Element;
-    }
-}
 declare module "react/components/file/file-preview" {
     import { SurveyElementBase } from "react/reactquestion_element";
     import { QuestionFileModel } from "entries/core";