survey-react 1.9.138 → 1.9.139

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "survey-react",
-  "version": "1.9.138",
+  "version": "1.9.139",
   "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",

package/survey.css

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - Survey JavaScript library v1.9.138
+ * surveyjs - Survey JavaScript library v1.9.139
  * Copyright (c) 2015-2024 Devsoft Baltic OÜ  - http://surveyjs.io/
  * License: MIT (http://www.opensource.org/licenses/mit-license.php)
  */

package/survey.min.css

@@ -1,5 +1,5 @@
 /*!
- * surveyjs - Survey JavaScript library v1.9.138
+ * surveyjs - Survey JavaScript library v1.9.139
  * Copyright (c) 2015-2024 Devsoft Baltic OÜ  - http://surveyjs.io/
  * License: MIT (http://www.opensource.org/licenses/mit-license.php)
  */

package/survey.react.d.ts

@@ -150,6 +150,7 @@ declare module "localization/english" {
         timerLimitSurvey: string;
         clearCaption: string;
         signaturePlaceHolder: string;
+        signaturePlaceHolderReadOnly: string;
         chooseFileCaption: string;
         takePhotoCaption: string;
         photoPlaceholder: string;
@@ -273,6 +274,7 @@ declare module "surveyStrings" {
         timerLimitSurvey: string;
         clearCaption: string;
         signaturePlaceHolder: string;
+        signaturePlaceHolderReadOnly: string;
         chooseFileCaption: string;
         takePhotoCaption: string;
         photoPlaceholder: string;
@@ -1201,7 +1203,11 @@ declare module "actions/action" {
     export function createDropdownActionModelAdvanced(actionOptions: IAction, listOptions: IListModel, popupOptions?: IPopupOptionsBase, locOwner?: ILocalizableOwner): Action;
     export function getActionDropdownButtonTarget(container: HTMLElement): HTMLElement;
     export abstract class BaseAction extends Base implements IAction {
+        private static renderedId;
+        private static getNextRendredId;
         private cssClassesValue;
+        private rendredIdValue;
+        private ownerValue;
         tooltip: string;
         showTitle: boolean;
         innerCss: string;
@@ -1212,7 +1218,6 @@ declare module "actions/action" {
         needSeparator: boolean;
         template: string;
         mode: actionModeType;
-        owner: ILocalizableOwner;
         visibleIndex: number;
         disableTabStop: boolean;
         disableShrink: boolean;
@@ -1228,6 +1233,9 @@ declare module "actions/action" {
         css?: string;
         minDimension: number;
         maxDimension: number;
+        get renderedId(): number;
+        get owner(): ILocalizableOwner;
+        set owner(val: ILocalizableOwner);
         get visible(): boolean;
         set visible(val: boolean);
         get enabled(): boolean;
@@ -1596,6 +1604,7 @@ declare module "defaultCss/defaultV2Css" {
             titleExpanded: string;
             titleCollapsed: string;
             titleDisabled: string;
+            titleReadOnly: string;
             titleBar: string;
             requiredText: string;
             number: string;
@@ -1620,6 +1629,8 @@ declare module "defaultCss/defaultV2Css" {
             invisible: string;
             composite: string;
             disabled: string;
+            readOnly: string;
+            preview: string;
             errorsContainer: string;
             errorsContainerTop: string;
             errorsContainerBottom: string;
@@ -1656,6 +1667,9 @@ declare module "defaultCss/defaultV2Css" {
             itemSelectAll: string;
             itemNone: string;
             itemDisabled: string;
+            itemReadOnly: string;
+            itemPreview: string;
+            itemPreviewSvgIconId: string;
             itemChecked: string;
             itemHover: string;
             itemInline: string;
@@ -1680,6 +1694,9 @@ declare module "defaultCss/defaultV2Css" {
             label: string;
             labelChecked: string;
             itemDisabled: string;
+            itemReadOnly: string;
+            itemPreview: string;
+            itemPreviewSvgIconId: string;
             itemChecked: string;
             itemHover: string;
             itemControl: string;
@@ -1701,17 +1718,25 @@ declare module "defaultCss/defaultV2Css" {
             itemExchanged: string;
             itemIndeterminate: string;
             itemDisabled: string;
+            itemReadOnly: string;
+            itemPreview: string;
             itemHover: string;
             label: string;
             labelTrue: string;
             labelFalse: string;
             switch: string;
             disabledLabel: string;
+            labelReadOnly: string;
+            labelPreview: string;
             sliderText: string;
             slider: string;
             sliderGhost: string;
             radioItem: string;
             radioItemChecked: string;
+            radioItemDisabled: string;
+            radioItemReadOnly: string;
+            radioItemPreview: string;
+            itemPreviewSvgIconId: string;
             radioLabel: string;
             radioControlLabel: string;
             radioFieldset: string;
@@ -1726,6 +1751,8 @@ declare module "defaultCss/defaultV2Css" {
             checkboxItemChecked: string;
             checkboxItemDecorator: string;
             checkboxItemDisabled: string;
+            checkboxItemReadOnly: string;
+            checkboxItemPreview: string;
             controlCheckbox: string;
             checkboxMaterialDecorator: string;
             checkboxControlLabel: string;
@@ -1735,6 +1762,8 @@ declare module "defaultCss/defaultV2Css" {
             root: string;
             small: string;
             controlDisabled: string;
+            controlReadOnly: string;
+            controlPreview: string;
             constrolWithCharacterCounter: string;
             characterCounterBig: string;
             content: string;
@@ -1745,6 +1774,9 @@ declare module "defaultCss/defaultV2Css" {
             root: string;
             rootMobile: string;
             itemLabel: string;
+            itemLabelReadOnly: string;
+            itemLabelDisabled: string;
+            itemLabelPreview: string;
             itemLabelOnError: string;
             itemLabelAllowFocus: string;
             itemLabelAnswered: string;
@@ -1782,6 +1814,8 @@ declare module "defaultCss/defaultV2Css" {
             controlInputFieldComponent: string;
             controlValue: string;
             controlDisabled: string;
+            controlReadOnly: string;
+            controlPreview: string;
             controlEmpty: string;
             controlLabel: string;
             filterStringInput: string;
@@ -1798,6 +1832,8 @@ declare module "defaultCss/defaultV2Css" {
             itemInline: string;
             itemChecked: string;
             itemDisabled: string;
+            itemReadOnly: string;
+            itemPreview: string;
             itemHover: string;
             label: string;
             itemDecorator: string;
@@ -1827,6 +1863,7 @@ declare module "defaultCss/defaultV2Css" {
             cell: string;
             row: string;
             rowDisabled: string;
+            rowReadOnly: string;
             headerCell: string;
             rowTextCell: string;
             label: string;
@@ -1834,6 +1871,9 @@ declare module "defaultCss/defaultV2Css" {
             itemValue: string;
             itemChecked: string;
             itemDisabled: string;
+            itemReadOnly: string;
+            itemPreview: string;
+            itemPreviewSvgIconId: string;
             itemHover: string;
             materialDecorator: string;
             itemDecorator: string;
@@ -1954,6 +1994,8 @@ declare module "defaultCss/defaultV2Css" {
             itemStarHover: string;
             itemStarSelected: string;
             itemStarDisabled: string;
+            itemStarReadOnly: string;
+            itemStarPreview: string;
             itemStarHighlighted: string;
             itemStarUnhighlighted: string;
             itemStarSmall: string;
@@ -1962,6 +2004,8 @@ declare module "defaultCss/defaultV2Css" {
             itemSmileyHover: string;
             itemSmileySelected: string;
             itemSmileyDisabled: string;
+            itemSmileyReadOnly: string;
+            itemSmileyPreview: string;
             itemSmileyHighlighted: string;
             itemSmileyScaleColored: string;
             itemSmileyRateColored: string;
@@ -1970,6 +2014,8 @@ declare module "defaultCss/defaultV2Css" {
             itemText: string;
             maxText: string;
             itemDisabled: string;
+            itemReadOnly: string;
+            itemPreview: string;
             itemFixedSize: string;
             control: string;
             itemSmall: string;
@@ -1988,6 +2034,8 @@ declare module "defaultCss/defaultV2Css" {
             root: string;
             small: string;
             controlDisabled: string;
+            controlReadOnly: string;
+            controlPreview: string;
             content: string;
             remainingCharacterCounter: string;
             onError: string;
@@ -1997,9 +2045,12 @@ declare module "defaultCss/defaultV2Css" {
             root: string;
             rootDragging: string;
             rootAnswered: string;
+            rootDisabled: string;
+            rootReadOnly: string;
+            rootPreview: string;
             other: string;
             placeholderInput: string;
-            preview: string;
+            previewItem: string;
             fileSign: string;
             fileList: string;
             fileSignBottom: string;
@@ -2088,9 +2139,12 @@ declare module "defaultCss/defaultV2Css" {
             rootMobileMod: string;
             rootDragMod: string;
             rootDisabled: string;
+            rootReadOnly: string;
+            rootPreview: string;
             rootDesignMode: string;
             rootDragHandleAreaIcon: string;
             rootSelectToRankMod: string;
+            rootSelectToRankEmptyValueMod: string;
             rootSelectToRankAlignVertical: string;
             rootSelectToRankAlignHorizontal: string;
             item: string;
@@ -2098,6 +2152,8 @@ declare module "defaultCss/defaultV2Css" {
             itemIndex: string;
             itemIndexEmptyMode: string;
             itemDisabled: string;
+            itemReadOnly: string;
+            itemPreview: string;
             controlLabel: string;
             itemGhostNode: string;
             itemIconContainer: string;
@@ -2174,7 +2230,10 @@ declare module "defaultCss/defaultV2Css" {
             controlValue: string;
             controlValueItems: string;
             placeholderInput: string;
+            controlEditable: string;
             controlDisabled: string;
+            controlReadOnly: string;
+            controlPreview: string;
             controlEmpty: string;
             controlLabel: string;
             filterStringInput: string;
@@ -2880,6 +2939,7 @@ declare module "question_custom" {
         afterRenderCore(el: any): void;
         get contentQuestion(): Question;
         protected createQuestion(): Question;
+        private checkCreatedQuestion;
         onSurveyLoad(): void;
         runCondition(values: HashTable<any>, properties: HashTable<any>): void;
         protected convertDataName(name: string): string;
@@ -3558,7 +3618,7 @@ declare module "panel" {
         focusIn(): void;
         protected getHasFrameV2(): boolean;
         protected getIsNested(): boolean;
-        private get showPanelAsPage();
+        get showPanelAsPage(): boolean;
         protected getCssRoot(cssClasses: {
             [index: string]: string;
         }): string;
@@ -6415,6 +6475,7 @@ declare module "question_paneldynamic" {
          */
         get showQuestionNumbers(): string;
         set showQuestionNumbers(val: string);
+        protected notifySurveyOnChildrenVisibilityChanged(): boolean;
         /**
          * Specifies the location of the Delete Panel button relative to panel content.
          *
@@ -6778,17 +6839,24 @@ declare module "question_signaturepad" {
         set backgroundImage(val: string);
         get clearButtonCaption(): string;
         /**
-         * A Boolean value that specifies whether to show the [placeholder](#placeholder).
+         * 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 for the signature area. Applies when the [`showPlaceholder`](#showPlaceholder) property is `true`.
+         * 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;
         onBlur: (event: any) => void;
         protected uploadResultItemToValue(r: any): any;
         protected setValueFromResult(arg: any): void;
@@ -8321,7 +8389,7 @@ declare module "mask/input_element_adapter" {
         private inputMaskInstance;
         private inputElement;
         private prevUnmaskedValue;
-        constructor(inputMaskInstance: InputMaskBase, inputElement: HTMLInputElement, value?: string);
+        constructor(inputMaskInstance: InputMaskBase, inputElement: HTMLInputElement, value?: any);
         inputMaskInstancePropertyChangedHandler: (sender: any, options: any) => void;
         clickHandler: (event: any) => void;
         beforeInputHandler: (event: any) => void;
@@ -11587,7 +11655,7 @@ declare module "survey" {
         get clearValueOnDisableItems(): boolean;
         set clearValueOnDisableItems(val: boolean);
         getQuestionClearIfInvisible(questionClearIf: string): string;
-        questionVisibilityChanged(question: Question, newValue: boolean): void;
+        questionVisibilityChanged(question: Question, newValue: boolean, resetIndexes: boolean): void;
         pageVisibilityChanged(page: PageModel, newValue: boolean): void;
         panelVisibilityChanged(panel: PanelModel, newValue: boolean): void;
         questionCreated(question: Question): any;
@@ -11866,6 +11934,55 @@ declare module "survey" {
         removeScrollEventListener(): void;
     }
 }
+declare module "knockout/kobase" {
+    import { Base } from "entries/core";
+    export class ImplementorBase {
+        element: Base;
+        private static doIterateProperties;
+        readonly implementedMark = "__surveyImplementedKo";
+        constructor(element: Base);
+        dispose(): void;
+    }
+}
+declare module "knockout/kopage" {
+    import { PageModel } from "entries/core";
+    import { PanelModelBase, PanelModel, QuestionRowModel } from "entries/core";
+    import { SurveyElement } from "entries/core";
+    import { ImplementorBase } from "knockout/kobase";
+    export class QuestionRow extends QuestionRowModel {
+        panel: PanelModelBase;
+        koElementAfterRender: any;
+        constructor(panel: PanelModelBase);
+        getElementType(el: any): "survey-panel" | "survey-question";
+        koAfterRender(htmlElements: any, element: SurveyElement): void;
+        private elementAfterRender;
+        rowAfterRender(elements: HTMLElement[], model: QuestionRow): void;
+        dispose(): void;
+    }
+    export class PanelImplementorBase extends ImplementorBase {
+        panel: PanelModelBase;
+        constructor(panel: PanelModelBase);
+    }
+    export class Panel extends PanelModel {
+        private _implementor;
+        koElementType: any;
+        constructor(name?: string);
+        protected onBaseCreating(): void;
+        createRow(): QuestionRowModel;
+        protected onCreating(): void;
+        protected onNumChanged(value: number): void;
+        dispose(): void;
+    }
+    export class Page extends PageModel {
+        private _implementor;
+        constructor(name?: string);
+        protected onBaseCreating(): void;
+        createRow(): QuestionRowModel;
+        protected onCreating(): void;
+        protected onNumChanged(value: number): void;
+        dispose(): void;
+    }
+}
 declare module "survey-element" {
     import { Base } from "base";
     import { IAction } from "actions/action";
@@ -12197,6 +12314,7 @@ declare module "survey-element" {
         isSingleInRow: boolean;
         private shouldAddRunnerStyles;
         protected get isCompact(): boolean;
+        private canHaveFrameStyles;
         protected getHasFrameV2(): boolean;
         protected getIsNested(): boolean;
         protected getCssRoot(cssClasses: {
@@ -12267,6 +12385,9 @@ declare module "survey-element" {
         get additionalTitleToolbar(): ActionContainer;
         protected getAdditionalTitleToolbar(): ActionContainer | null;
         protected getCssTitle(cssClasses: any): string;
+        get isDisabledStyle(): boolean;
+        get isReadOnlyStyle(): boolean;
+        get isPreviewStyle(): boolean;
         localeChanged(): void;
         private wrapperElement?;
         setWrapperElement(element?: HTMLElement): void;
@@ -12619,6 +12740,7 @@ declare module "question" {
         set titleLocation(value: string);
         getTitleOwner(): ITitleOwner;
         protected getIsTitleRenderedAsString(): boolean;
+        protected notifySurveyOnChildrenVisibilityChanged(): boolean;
         private notifySurveyVisibilityChanged;
         protected clearValueOnHidding(isClearOnHidden: boolean): void;
         /**
@@ -14023,7 +14145,7 @@ declare module "base-interfaces" {
         getQuestionByName(name: string): IQuestion;
         pageVisibilityChanged(page: IPage, newValue: boolean): any;
         panelVisibilityChanged(panel: IPanel, newValue: boolean): any;
-        questionVisibilityChanged(question: IQuestion, newValue: boolean): any;
+        questionVisibilityChanged(question: IQuestion, newValue: boolean, resetIndexes: boolean): any;
         isEditingSurveyElement: boolean;
         getQuestionClearIfInvisible(questionClearIf: string): string;
         questionsOrder: string;
@@ -15181,6 +15303,7 @@ declare module "popup" {
         private onDispose;
         setWidthByTarget: boolean;
         focusFirstInputSelector: string;
+        locale: string;
         contentComponentName: string;
         contentComponentData: T;
         verticalPosition: VerticalPosition;
@@ -16099,6 +16222,7 @@ declare module "question_matrix" {
         onMatrixRowChanged(row: MatrixRowModel): void;
         getCorrectedRowValue(value: any): any;
         cssClasses: any;
+        isDisabledStyle: boolean;
         isInputReadOnly: boolean;
         hasErrorInRow(row: MatrixRowModel): boolean;
     }
@@ -16899,6 +17023,7 @@ declare module "question_ranking" {
         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;
@@ -17455,6 +17580,13 @@ declare module "question_boolean" {
         set labelTrue(val: string);
         get locLabelTrue(): LocalizableString;
         get isDeterminated(): boolean;
+        /**
+         * Specifies whether to swap the order of the Yes and No answers.
+         *
+         * Default value: `false`
+         *
+         * By default, the order is [ "No", "Yes"]. Enable this property to reorder the answers as follows: [ "Yes", "No" ].
+         */
         swapOrder: boolean;
         get locLabelLeft(): LocalizableString;
         get locLabelRight(): LocalizableString;
@@ -17494,6 +17626,7 @@ declare module "question_boolean" {
         getCheckboxItemCss(): string;
         getLabelCss(checked: boolean): string;
         get svgIcon(): string;
+        get itemSvgIcon(): string;
         get allowClick(): boolean;
         getCheckedLabel(): LocalizableString;
         protected setQuestionValue(newValue: any, updateIsAnswered?: boolean): void;
@@ -17903,8 +18036,16 @@ declare module "mask/mask_pattern" {
          * - `dd` - Day of the month, with leading zero for single-digit values.
          * - `yy` - Last two digits of the year.
          * - `yyyy` - A four-digit year.
+         * - `H` - Hours in 24-hour format.
+         * - `HH` - Hours in 24-hour format, with leading zero for single-digit values.
+         * - `h` - Hours in 12-hour format.
+         * - `hh` - Hours in 12-hour format, with leading zero for single-digit values.
+         * - `MM` - Minutes.
+         * - `ss` - Seconds.
+         * - `TT` - 12-hour clock period in upper case (AM/PM).
+         * - `tt` - 12-hour clock period in lower case (am/pm).
          *
-         * Example: `mm/dd/yyyy`
+         * Example: `mm/dd/yyyy HH:MM:ss`
          *
          * [View Demo](https://surveyjs.io/form-library/examples/masked-input-fields/ (linkStyle))
          * @see [settings.maskSettings](https://surveyjs.io/form-library/documentation/api-reference/settings#maskSettings)
@@ -18013,11 +18154,13 @@ declare module "mask/mask_numeric" {
 declare module "mask/mask_datetime" {
     import { InputMaskPattern } from "mask/mask_pattern";
     import { IMaskedInputResult, ITextInputParams } from "mask/mask_utils";
+    type DateTimeMaskLexemType = "month" | "day" | "year" | "hour" | "minute" | "second" | "timeMarker" | "separator";
     export interface IDateTimeMaskLexem {
-        type: "month" | "day" | "year" | "separator";
+        type: DateTimeMaskLexemType;
         value: any;
         count: number;
         maxCount: number;
+        upperCase: boolean;
     }
     interface IDateTimeComposition {
         day: number;
@@ -18026,6 +18169,7 @@ declare module "mask/mask_datetime" {
         hour?: number;
         minute?: number;
         second?: number;
+        timeMarker?: string;
         min?: Date;
         max?: Date;
     }
@@ -18051,9 +18195,12 @@ declare module "mask/mask_datetime" {
      * [View Demo](https://surveyjs.io/form-library/examples/masked-input-fields/ (linkStyle))
      */
     export class InputMaskDateTime extends InputMaskPattern {
+        private defaultDate;
         private turnOfTheCentury;
+        private twelve;
         private lexems;
         private inputDateTimeData;
+        private validBeginningOfNumbers;
         /**
          * A minimum date and time value that respondents can enter.
          * @see max
@@ -18064,6 +18211,9 @@ declare module "mask/mask_datetime" {
          * @see min
          */
         max: string;
+        get hasDatePart(): boolean;
+        get hasTimePart(): boolean;
+        private get is12Hours();
         getType(): string;
         protected updateLiterals(): void;
         private leaveOnlyNumbers;
@@ -18071,13 +18221,19 @@ declare module "mask/mask_datetime" {
         private initInputDateTimeData;
         getISO_8601Format(dateTime: IDateTimeComposition): string;
         private isYearValid;
+        private createIDateTimeCompositionWithDefaults;
+        private getMaxDateForMonth;
         private isDateValid;
         private getPlaceholder;
+        private isDateValid12;
+        private updateTimeMarkerInputDateTimeData;
         private updateInputDateTimeData;
+        private checkValidationDateTimePart;
         private getCorrectDatePartFormat;
         private createIDateTimeComposition;
         private parseTwoDigitYear;
         private getFormatedString;
+        private cleanTimeMarker;
         private setInputDateTimeData;
         _getMaskedValue(src: string, matchWholeMask?: boolean): string;
         private getParts;
@@ -18565,7 +18721,7 @@ declare module "defaultCss/cssstandard" {
         file: {
             root: string;
             placeholderInput: string;
-            preview: string;
+            previewItem: string;
             removeButton: string;
             fileInput: string;
             removeFile: string;
@@ -19032,7 +19188,7 @@ declare module "defaultCss/cssmodern" {
             root: string;
             other: string;
             placeholderInput: string;
-            preview: string;
+            previewItem: string;
             fileSignBottom: string;
             fileDecorator: string;
             fileInput: string;
@@ -26836,13 +26992,6 @@ declare module "react/components/paneldynamic-actions/paneldynamic-progress-text
         protected renderElement(): JSX.Element;
     }
 }
-declare module "react/components/paneldynamic-actions/paneldynamic-remove-btn" {
-    import { SurveyQuestionPanelDynamicAction } from "react/components/paneldynamic-actions/paneldynamic-add-btn";
-    export class SurveyQuestionPanelDynamicRemoveButton extends SurveyQuestionPanelDynamicAction {
-        protected handleClick: (event: any) => void;
-        protected renderElement(): JSX.Element;
-    }
-}
 declare module "react/reactquestion_paneldynamic" {
     import { SurveyQuestionElementBase } from "react/reactquestion_element";
     import { SurveyModel, QuestionPanelDynamicModel } from "entries/core";
@@ -27122,6 +27271,13 @@ declare module "react/components/matrix-actions/detail-button/detail-button" {
         protected renderElement(): JSX.Element;
     }
 }
+declare module "react/components/paneldynamic-actions/paneldynamic-remove-btn" {
+    import { SurveyQuestionPanelDynamicAction } from "react/components/paneldynamic-actions/paneldynamic-add-btn";
+    export class SurveyQuestionPanelDynamicRemoveButton extends SurveyQuestionPanelDynamicAction {
+        protected handleClick: (event: any) => void;
+        protected renderElement(): JSX.Element;
+    }
+}
 declare module "react/components/survey-actions/survey-nav-button" {
     import { Action } from "entries/core";
     import { ReactSurveyElement } from "react/reactquestion_element";