survey-react 1.9.92 → 1.9.93

package/survey.react.d.ts

@@ -1913,7 +1913,7 @@ declare module "actions/action" {
     export class Action extends BaseAction implements IAction, ILocalizableOwner {
         innerItem: IAction;
         private locTitleValue;
-        updateCallback: () => void;
+        updateCallback: (isResetInitialized: boolean) => void;
         private raiseUpdate;
         constructor(innerItem: IAction);
         private createLocTitle;
@@ -2003,7 +2003,7 @@ declare module "actions/adaptive-container" {
     import { Action, actionModeType } from "actions/action";
     import { ActionContainer } from "actions/container";
     export class AdaptiveActionContainer<T extends Action = Action> extends ActionContainer<T> {
-        protected dotsItem: Action;
+        dotsItem: Action;
         private responsivityManager;
         minVisibleItemsCount: number;
         isResponsivenessDisabled: boolean;
@@ -2140,6 +2140,17 @@ declare module "defaultCss/defaultV2Css" {
             progressBtnIcon: string;
             noEntriesPlaceholder: string;
             compact: string;
+            tabsRoot: string;
+            tabsLeft: string;
+            tabsRight: string;
+            tabsCenter: string;
+            tabs: {
+                item: string;
+                itemPressed: string;
+                itemAsIcon: string;
+                itemIcon: string;
+                itemTitle: string;
+            };
         };
         progress: string;
         progressTop: string;
@@ -2656,6 +2667,7 @@ declare module "defaultCss/defaultV2Css" {
             other: string;
             onError: string;
             label: string;
+            itemSvgIconId: string;
             item: string;
             itemDisabled: string;
             itemChecked: string;
@@ -3579,6 +3591,7 @@ declare module "question_file" {
         private getFileIndexCaption;
         isPreviewVisible(index: number): boolean;
         getType(): string;
+        clearValue(): void;
         clearOnDeletingContainer(): void;
         /**
          * Disable this property only to implement a custom preview.
@@ -4237,7 +4250,7 @@ declare module "question_baseselect" {
         private randomizeArray;
         clearIncorrectValues(): void;
         protected hasValueToClearIncorrectValues(): boolean;
-        protected clearValueIfInvisibleCore(): void;
+        protected clearValueIfInvisibleCore(reason: string): void;
         /**
          * Returns `true` if a passed choice item is selected.
          *
@@ -4681,6 +4694,8 @@ declare module "dragdrop/matrix-rows" {
     import { DragDropCore } from "dragdrop/core";
     export class DragDropMatrixRows extends DragDropCore<QuestionMatrixDynamicModel> {
         protected get draggedElementType(): string;
+        protected restoreUserSelectValue: string;
+        protected onStartDrag(): void;
         protected createDraggedElementShortcut(text: string, draggedElementNode: HTMLElement, event: PointerEvent): HTMLElement;
         private fromIndex;
         private toIndex;
@@ -5171,6 +5186,7 @@ declare module "question_paneldynamic" {
     import { SurveyError } from "survey-error";
     import { ActionContainer } from "actions/container";
     import { IAction } from "actions/action";
+    import { AdaptiveActionContainer } from "actions/adaptive-container";
     export interface IQuestionPanelDynamicData {
         getItemIndex(item: ISurveyData): number;
         getVisibleItemIndex(item: ISurveyData): number;
@@ -5686,7 +5702,9 @@ declare module "question_paneldynamic" {
         hasErrors(fireCallback?: boolean, rec?: any): boolean;
         protected getContainsErrors(): boolean;
         protected getIsAnswered(): boolean;
-        protected clearValueIfInvisibleCore(): void;
+        protected clearValueOnHidding(isClearOnHidden: boolean): void;
+        clearValueIfInvisible(reason?: string): void;
+        private clearValueInPanelsIfInvisible;
         protected getIsRunningValidators(): boolean;
         getAllErrors(): Array<SurveyError>;
         protected getDisplayValueCore(keysAsText: boolean, value: any): any;
@@ -5741,7 +5759,7 @@ declare module "question_paneldynamic" {
         getShowNoEntriesPlaceholder(): boolean;
         needResponsiveWidth(): boolean;
         private additionalTitleToolbarValue;
-        protected getAdditionalTitleToolbar(): ActionContainer | null;
+        protected getAdditionalTitleToolbar(): AdaptiveActionContainer | null;
         private footerToolbarValue;
         get footerToolbar(): ActionContainer;
         legacyNavigation: boolean;
@@ -5757,6 +5775,7 @@ declare module "question_paneldynamic" {
         get showLegacyNavigation(): boolean;
         get showNavigation(): boolean;
         showSeparator(index: number): boolean;
+        protected calcCssClasses(css: any): any;
     }
 }
 declare module "survey-events-api" {
@@ -5795,7 +5814,7 @@ declare module "survey-events-api" {
     }
     export interface MatrixDropdownQuestionEventMixin {
         /**
-         * A Multiple-Choice Matrix question instance for which the event is raised.
+         * A Multi-Select Matrix question instance for which the event is raised.
          */
         question: QuestionMatrixDropdownModelBase;
     }
@@ -5861,7 +5880,7 @@ declare module "survey-events-api" {
     }
     export interface CompletingEvent extends CompleteBaseEvent {
         /**
-         * Set this property to `false` if you want to prevent survey completion.
+         * A Boolean property that you can set to `false` if you want to prevent survey completion.
          */
         allow: boolean;
         allowComplete: boolean;
@@ -5890,14 +5909,14 @@ declare module "survey-events-api" {
     }
     export interface ShowingPreviewEvent {
         /**
-         * Set this property to `false` if you want to cancel the preview.
+         * A Boolean property that you can set to `false` if you want to cancel the preview.
          */
         allow: boolean;
         allowShowPreview: boolean;
     }
     export interface NavigateToUrlEvent {
         /**
-         * Set this property to `false` if you want to cancel the navigation and show the [complete page](https://surveyjs.io/form-library/documentation/design-survey/create-a-multi-page-survey#complete-page).
+         * A Boolean property that you can set to `false` if you want to cancel the navigation and show the [complete page](https://surveyjs.io/form-library/documentation/design-survey/create-a-multi-page-survey#complete-page).
          */
         allow: boolean;
         /**
@@ -5933,7 +5952,7 @@ declare module "survey-events-api" {
     }
     export interface CurrentPageChangingEvent extends CurrentPageChangedEvent {
         /**
-         * Set this property to `false` if you do not want to switch the current page.
+         * A Boolean property that you can set to `false` if you do not want to switch the current page.
          */
         allow: boolean;
         allowChanging: boolean;
@@ -6283,13 +6302,13 @@ declare module "survey-events-api" {
     }
     export interface UpdateChoiceItemCssEvent extends QuestionEventMixin {
         /**
-         * a string with css classes divided by space. You can change it
+         * A choice item. To access its value and display text, use the `options.item.value` and `options.item.text` properties.
          */
-        css: string;
+        item: ItemValue;
         /**
-         * a choice item of ItemValue type. You can get value or text choice properties as options.item.value or options.choice.text
+         * A string with CSS classes applied to the choice item. The CSS classes are separated by a space character. You can modify this string to apply custom CSS classes.
          */
-        item: ItemValue;
+        css: string;
     }
     export interface AfterRenderSurveyEvent extends AfterRenderElementEventMixin {
         survey: SurveyModel;
@@ -6353,135 +6372,136 @@ declare module "survey-events-api" {
     }
     export interface MatrixRowAddedEvent extends MatrixDynamicQuestionEventMixin {
         /**
-         * a new added row
+         * An added matrix row.
          */
         row: any;
     }
     export interface MatrixBeforeRowAddedEvent extends MatrixDynamicQuestionEventMixin {
         /**
-         * specifies whether a new row can be added
+         * A Boolean property that you can set to `false` if you do not want to add the row.
          */
         canAddRow: boolean;
     }
     export interface MatrixRowRemovingEvent extends MatrixDynamicQuestionEventMixin {
         /**
-         * a boolean property. Set it to `false` to disable the row removing
-         */
-        allow: boolean;
-        /**
-         * a row object
+         * A matrix row to be deleted. If you want to clear row data, set the `options.row.value` property to `undefined`.
          */
         row: any;
         /**
-         * a row index
+         * A zero-based index of the matrix row to be deleted.
          */
         rowIndex: number;
+        /**
+         * A Boolean property that you can set to `false` if you want to cancel row deletion.
+         */
+        allow: boolean;
     }
     export interface MatrixRowRemovedEvent extends MatrixDynamicQuestionEventMixin {
         /**
-         * a removed row object
+         * A deleted matrix row.
          */
         row: any;
         /**
-         * a removed row index
+         * A zero-based index of the deleted row.
          */
         rowIndex: number;
     }
     export interface MatrixAllowRemoveRowEvent extends MatrixDynamicQuestionEventMixin {
         /**
-         * a boolean property. Set it to `false` to disable the row removing
-         */
-        allow: boolean;
-        /**
-         * a row object
+         * A matrix row for which the event is raised.
          */
         row: any;
         /**
-         * a row index
+         * A zero-based row index.
          */
         rowIndex: number;
+        /**
+         * A Boolean property that you can set to `false` if you want to hide the Remove button for this row.
+         */
+        allow: boolean;
     }
     export interface MatrixCellCreatingBaseEvent extends MatrixDropdownQuestionEventMixin {
         /**
-         * the matrix row object
+         * A matrix column to which the cell belongs.
          */
-        row: MatrixDropdownRowModelBase;
+        column: MatrixDropdownColumn;
         /**
-         * the matrix column name
+         * The name of the matrix column to which the cell belongs.
          */
         columnName: string;
         /**
-         * the matrix column object
+         * A matrix row to which the cell belongs.
          */
-        column: MatrixDropdownColumn;
+        row: MatrixDropdownRowModelBase;
         /**
-         * the value of the current row. To access a particular column's value within the current row, use: `options.rowValue["columnValue"]`
+         * The values of this matrix row.\
+         * To access a particular column's value, use the following code: `options.rowValue["columnName"]`
          */
         rowValue: any;
     }
     export interface MatrixCellCreatingEvent extends MatrixCellCreatingBaseEvent {
         /**
-         * the cell question type. You can change it
+         * The type of this matrix cell. You can change this property value to one of the values described in the [`cellType`](https://surveyjs.io/form-library/documentation/api-reference/matrix-table-with-dropdown-list#cellType) documentation.
          */
         cellType: string;
     }
     export interface MatrixCellCreatedEvent extends MatrixCellCreatingBaseEvent {
         /**
-         * the question/editor in the cell. You may customize it, change it's properties, like choices or visible
+         * A matrix cell for which the event is raised.
          */
-        cellQuestion: Question;
+        cell: MatrixDropdownCell;
         /**
-         * the matrix cell
+         * A Question instance within the matrix cell. You can use the properties and methods exposed by the instance to customize it.
          */
-        cell: MatrixDropdownCell;
+        cellQuestion: Question;
     }
     export interface MatrixAfterCellRenderEvent extends QuestionEventMixin, AfterRenderElementEventMixin {
         /**
-         * the matrix row object
+         * A matrix cell for which the event is raised.
          */
-        row: MatrixDropdownRowModelBase;
+        cell: MatrixDropdownCell;
         /**
-         * the matrix column object
+         * A Question instance within the matrix cell.
          */
-        column: MatrixDropdownColumn | MatrixDropdownCell;
+        cellQuestion: Question;
         /**
-         * the question/editor in the cell
+         * A matrix row to which the cell belongs.
          */
-        cellQuestion: Question;
+        row: MatrixDropdownRowModelBase;
         /**
-         * the matrix cell
+         * A matrix column to which the cell belongs.
          */
-        cell: MatrixDropdownCell;
+        column: MatrixDropdownColumn | MatrixDropdownCell;
     }
     export interface MatrixCellValueBaseEvent extends MatrixDropdownQuestionEventMixin {
         /**
-         * the function that returns the cell question by column name
+         * A matrix row to which the cell belongs.
          */
-        getCellQuestion: (columnName: string) => Question;
+        row: MatrixDropdownRowModelBase;
         /**
-         * the matrix row object
+         * The name of a matrix column to which the cell belongs.
          */
-        row: MatrixDropdownRowModelBase;
+        columnName: string;
         /**
-         * a new value
+         * A method that returns a Question instance within the matrix cell given a column name.
          */
-        value: any;
+        getCellQuestion: (columnName: string) => Question;
         /**
-         * the matrix column name
+         * A new cell value.
          */
-        columnName: string;
+        value: any;
     }
     export interface MatrixCellValueChangedEvent extends MatrixCellValueBaseEvent {
     }
     export interface MatrixCellValueChangingEvent extends MatrixCellValueBaseEvent {
         /**
-         * the old value
+         * A previous cell value.
          */
         oldValue: any;
     }
     export interface MatrixCellValidateEvent extends MatrixCellValueBaseEvent {
         /**
-         * an error string. It is empty by default
+         * A field for your custom error message. Default value: `undefined`.
          */
         error?: string;
     }
@@ -6493,7 +6513,7 @@ declare module "survey-events-api" {
     }
     export interface DynamicPanelRemovingEvent extends DynamicPanelModifiedEvent {
         /**
-         * Set this property to `false` if you want to cancel the panel deletion.
+         * A Boolean property that you can set to `false` if you want to cancel panel deletion.
          */
         allow: boolean;
     }
@@ -6594,13 +6614,13 @@ declare module "survey-events-api" {
     }
     export interface GetPanelFooterActionsEvent extends GetActionsEventMixin, PanelEventMixin {
         /**
-         * A [Dynamic Panel](https://surveyjs.io/form-library/documentation/questionpaneldynamicmodel) to which the Panel belongs. This field is `undefined` if the Panel does not belong to any Dynamic Panel
+         * A [Dynamic Panel](https://surveyjs.io/form-library/documentation/questionpaneldynamicmodel) to which the Panel belongs. This field is `undefined` if the Panel does not belong to any Dynamic Panel.
          */
         question?: QuestionPanelDynamicModel;
     }
     export interface GetMatrixRowActionsEvent extends QuestionEventMixin, GetActionsEventMixin {
         /**
-         * A matrix row for which the event is fired
+         * A matrix row for which the event is raised.
          */
         row: any;
     }
@@ -6630,7 +6650,7 @@ declare module "survey-events-api" {
     }
     export interface MatrixColumnAddedEvent extends QuestionEventMixin {
         /**
-         * A new added column.
+         * An added matrix column.
          */
         column: any;
     }
@@ -6996,6 +7016,7 @@ declare module "question_textbase" {
     import { Question } from "question";
     import { LocalizableString } from "localizablestring";
     import { Base } from "base";
+    import { ISurveyImpl } from "base-interfaces";
     export class CharacterCounter extends Base {
         remainingCharacterCounter: string;
         updateRemainingCharacterCounter(newValue: string, maxLength: number): void;
@@ -7044,10 +7065,13 @@ declare module "question_textbase" {
         protected onReadOnlyChanged(): void;
         onSurveyLoad(): void;
         localeChanged(): void;
+        setSurveyImpl(value: ISurveyImpl, isLight?: boolean): void;
         protected calcRenderedPlaceholder(): void;
         protected hasPlaceHolder(): boolean;
         protected setNewValue(newValue: any): void;
         protected setQuestionValue(newValue: any, updateIsAnswered?: boolean): void;
+        disableNativeUndoRedo: boolean;
+        protected checkForUndo(event: KeyboardEvent): void;
         getControlClass(): string;
         get ariaRole(): string;
         get ariaRequired(): any;
@@ -7841,7 +7865,9 @@ declare module "survey" {
          */
         onUpdateQuestionCssClasses: EventBase<SurveyModel, UpdateQuestionCssClassesEvent>;
         /**
-         * An event that is raised before rendering a panel. Use it to override default panel CSS classes.
+         * An event that is raised before rendering a standalone panel and panels within [Dynamic Panel](/form-library/examples/duplicate-group-of-fields-in-form/). Use it to override default panel CSS classes.
+         *
+         * For information on event handler parameters, refer to descriptions within the interface.
          *
          * [View Demo](/form-library/examples/customize-survey-with-css/ (linkStyle))
          * @see css
@@ -7850,6 +7876,8 @@ declare module "survey" {
         /**
          * An event that is raised before rendering a page. Use it to override default page CSS classes.
          *
+         * For information on event handler parameters, refer to descriptions within the interface.
+         *
          * [View Demo](/form-library/examples/customize-survey-with-css/ (linkStyle))
          * @see css
          */
@@ -7857,6 +7885,8 @@ declare module "survey" {
         /**
          * An event that is raised before rendering a choice item in Radio Button Group, Checkboxes, and Dropdown questions. Use it to override default CSS classes applied to choice items.
          *
+         * For information on event handler parameters, refer to descriptions within the interface.
+         *
          * [View Demo](/form-library/examples/customize-survey-with-css/ (linkStyle))
          * @see css
          */
@@ -7933,91 +7963,61 @@ declare module "survey" {
          */
         onGetChoiceDisplayValue: EventBase<SurveyModel, GetChoiceDisplayValueEvent>;
         /**
-         * An event that is raised on adding a new row in Matrix Dynamic question.
-         * @see QuestionMatrixDynamicModel
-         * @see QuestionMatrixDynamicModel.visibleRows
+         * An event that is raised after a new row is added to a [Dynamic Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/).
          */
         onMatrixRowAdded: EventBase<SurveyModel, MatrixRowAddedEvent>;
         /**
-         * An event that is raised before adding a new row in Matrix Dynamic question.
-         * @see QuestionMatrixDynamicModel
-         * @see QuestionMatrixDynamicModel.visibleRows
+         * An event that is raised before a new row is added to a [Dynamic Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/).
          */
         onMatrixBeforeRowAdded: EventBase<SurveyModel, MatrixBeforeRowAddedEvent>;
         /**
-         * An event that is raised before removing a row from Matrix Dynamic question. You can disable removing and clear the data instead.
-         * @see QuestionMatrixDynamicModel
-         * @see onMatrixRowRemoved
+         * An event that is raised before a row is deleted from a [Dynamic Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/). You can cancel row deletion and clear row data instead.
          * @see onMatrixAllowRemoveRow
          */
         onMatrixRowRemoving: EventBase<SurveyModel, MatrixRowRemovingEvent>;
         /**
-         * An event that is raised on removing a row from Matrix Dynamic question.
-         * @see QuestionMatrixDynamicModel
-         * @see QuestionMatrixDynamicModel.visibleRows
-         * @see onMatrixRowRemoving
+         * An event that is raised after a row is deleted from a [Dynamic Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/).
          * @see onMatrixAllowRemoveRow
          */
         onMatrixRowRemoved: EventBase<SurveyModel, MatrixRowRemovedEvent>;
         /**
-         * An event that is raised before rendering "Remove" button for removing a row from Matrix Dynamic question.
-         * @see QuestionMatrixDynamicModel
+         * An event that is raised before rendering the Remove button in a row of a [Dynamic Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/). Use this event to hide the Remove button for individual matrix rows.
          * @see onMatrixRowRemoving
          * @see onMatrixRowRemoved
          */
         onMatrixAllowRemoveRow: EventBase<SurveyModel, MatrixAllowRemoveRowEvent>;
         /**
-         * An event that is raised before creating cell question in the matrix. You can change the cell question type by setting different options.cellType.
-         * @see onMatrixBeforeRowAdded
-         * @see onMatrixCellCreated
-         * @see QuestionMatrixDynamicModel
-         * @see QuestionMatrixDropdownModel
+         * An event that is raised before a cell in a [Multi-Select Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdropdown/) or [Dynamic Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/) is created. Use this event to change the type of individual matrix cells.
+         * @see onMatrixAfterCellRender
          */
         onMatrixCellCreating: EventBase<SurveyModel, MatrixCellCreatingEvent>;
         /**
-          * An event that is raised for every cell created in Matrix Dynamic and Matrix Dropdown questions.
-          * @see onMatrixBeforeRowAdded
-          * @see onMatrixCellCreating
-          * @see onMatrixRowAdded
-          * @see QuestionMatrixDynamicModel
-          * @see QuestionMatrixDropdownModel
+          * An event that is raised after a cell in a [Multi-Select Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdropdown/) or [Dynamic Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/) is created.
+          * @see onMatrixAfterCellRender
           */
         onMatrixCellCreated: EventBase<SurveyModel, MatrixCellCreatedEvent>;
         /**
-         * An event that is raised for every cell after is has been rendered in DOM.
+         * An event that is raised for every matrix cell after it is rendered to the DOM.
          * @see onMatrixCellCreated
-         * @see QuestionMatrixDynamicModel
-         * @see QuestionMatrixDropdownModel
          */
         onMatrixAfterCellRender: EventBase<SurveyModel, MatrixAfterCellRenderEvent>;
         /**
-         * An event that is raised when cell value is changed in Matrix Dynamic and Matrix Dropdown questions.
-         * @see onMatrixCellValueChanging
+         * An event that is raised after a cell value is changed in a [Multi-Select Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdropdown/) or [Dynamic Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/).
          * @see onMatrixBeforeRowAdded
-         * @see onMatrixRowAdded
-         * @see QuestionMatrixDynamicModel
-         * @see QuestionMatrixDropdownModel
          */
         onMatrixCellValueChanged: EventBase<SurveyModel, MatrixCellValueChangedEvent>;
         /**
-         * An event that is raised on changing cell value in Matrix Dynamic and Matrix Dropdown questions. You may change the `options.value` property to change a cell value.
-         * @see onMatrixCellValueChanged
+         * An event that is raised before a cell value is changed in a [Multi-Select Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdropdown/) or [Dynamic Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/). Use this event to change the cell value.
          * @see onMatrixBeforeRowAdded
-         * @see onMatrixRowAdded
-         * @see QuestionMatrixDynamicModel
-         * @see QuestionMatrixDropdownModel
          */
         onMatrixCellValueChanging: EventBase<SurveyModel, MatrixCellValueChangingEvent>;
         /**
-         * An event that is raised when Matrix Dynamic and Matrix Dropdown questions validate the cell value.
+         * An event that is raised for [Multi-Select Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdropdown/) and [Dynamic Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/) questions when they validate a cell value. Use this event to display a custom error message based on a condition.
          * @see onMatrixBeforeRowAdded
-         * @see onMatrixRowAdded
-         * @see QuestionMatrixDynamicModel
-         * @see QuestionMatrixDropdownModel
          */
         onMatrixCellValidate: EventBase<SurveyModel, MatrixCellValidateEvent>;
         /**
-         * An event that is raised on adding a new column in Matrix Dynamic or Matrix Dropdown question.
+         * An event that is raised after a new column is added to a [Multi-Select Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdropdown/) or [Dynamic Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/).
          */
         onMatrixColumnAdded: EventBase<SurveyModel, MatrixColumnAddedEvent>;
         /**
@@ -8095,9 +8095,12 @@ declare module "survey" {
          */
         onGetPanelFooterActions: EventBase<SurveyModel, GetPanelFooterActionsEvent>;
         /**
-         * Use this event to create/customize actions to be displayed in a matrix question's row.
+         * An event that allows you to add, delete, or modify actions in rows of a [Dynamic Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/).
+         *
+         * For information on event handler parameters, refer to descriptions within the interface.
+         *
+         * [View Demo](https://surveyjs.io/form-library/examples/employee-information-form/ (linkStyle))
          * @see IAction
-         * @see QuestionMatrixDropdownModelBase
          */
         onGetMatrixRowActions: EventBase<SurveyModel, GetMatrixRowActionsEvent>;
         /**
@@ -8508,27 +8511,53 @@ declare module "survey" {
          */
         get emptySurveyText(): string;
         /**
-         * Gets or sets a survey logo.
-         * @see title
+         * An image URL or a Base64-encoded image to use as a survey logo.
+         *
+         * [View Demo](https://surveyjs.io/form-library/examples/survey-logo/ (linkStyle))
+         * @see logoPosition
+         * @see logoFit
          */
         get logo(): string;
         set logo(value: string);
         get locLogo(): LocalizableString;
         /**
-         * Gets or sets a survey logo width.
+         * A logo width in CSS-accepted values.
+         *
+         * Default value: `300px`
+         *
+         * [View Demo](https://surveyjs.io/form-library/examples/survey-logo/ (linkStyle))
+         * @see logoHeight
          * @see logo
+         * @see logoPosition
+         * @see logoFit
          */
         get logoWidth(): any;
         set logoWidth(value: any);
         /**
-         * Gets or sets a survey logo height.
+         * A logo height in CSS-accepted values.
+         *
+         * Default value: `200px`
+         *
+         * [View Demo](https://surveyjs.io/form-library/examples/survey-logo/ (linkStyle))
+         * @see logoHeight
          * @see logo
+         * @see logoPosition
+         * @see logoFit
          */
         get logoHeight(): any;
         set logoHeight(value: any);
         /**
-         * Gets or sets a survey logo position.
+         * A logo position relative to the [survey title](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#title).
+         *
+         * Possible values:
+         *
+         * - `"left"` (default) - Places the logo to the left of the survey title.
+         * - `"right"` - Places the logo to the right of the survey title.
+         * - `"none"` - Hides the logo.
+         *
+         * [View Demo](https://surveyjs.io/form-library/examples/survey-logo/ (linkStyle))
          * @see logo
+         * @see logoFit
          */
         get logoPosition(): string;
         set logoPosition(value: string);
@@ -8543,8 +8572,20 @@ declare module "survey" {
         get renderedHasLogo(): boolean;
         get renderedHasHeader(): boolean;
         /**
-         * The logo fit mode.
+         * Specifies how to resize a logo to fit it into its container.
+         *
+         * Possible values:
+         *
+         * - `"contain"` (default)
+         * - `"cover"`
+         * - `"fill"`
+         * - `"none"`
+         *
+         * Refer to the [`object-fit`](https://developer.mozilla.org/en-US/docs/Web/CSS/object-fit) CSS property description for information on the possible values.
+         *
+         * [View Demo](https://surveyjs.io/form-library/examples/survey-logo/ (linkStyle))
          * @see logo
+         * @see logoPosition
          */
         get logoFit(): string;
         set logoFit(val: string);
@@ -8942,12 +8983,12 @@ declare module "survey" {
          */
         get isShowStartingPage(): boolean;
         /**
-         * Specifies which part of a choice item responds to a drag gesture in MatrixDynamic questions.
+         * Specifies which part of a matrix row responds to a drag gesture in [Dynamic Matrix](https://surveyjs.io/form-library/examples/questiontype-matrixdynamic/) questions.
          *
          * Possible values:
          *
-         * - `"entireItem"` (default) - Users can use the entire choice item as a drag handle.
-         * - `"icon"` - Users can only use the choice item icon as a drag handle.
+         * - `"entireItem"` (default) - Users can use the entire matrix row as a drag handle.
+         * - `"icon"` - Users can only use a drag icon as a drag handle.
          */
         get matrixDragHandleArea(): string;
         set matrixDragHandleArea(val: string);
@@ -9708,8 +9749,7 @@ declare module "survey" {
          */
         get clearValueOnDisableItems(): boolean;
         set clearValueOnDisableItems(val: boolean);
-        get isClearValueOnHidden(): boolean;
-        get isClearValueOnHiddenContainer(): boolean;
+        getQuestionClearIfInvisible(questionClearIf: string): string;
         questionVisibilityChanged(question: Question, newValue: boolean): void;
         pageVisibilityChanged(page: PageModel, newValue: boolean): void;
         panelVisibilityChanged(panel: PanelModel, newValue: boolean): void;
@@ -10544,7 +10584,7 @@ declare module "question" {
         /**
          * Hides the question number from the title and excludes the question from numbering.
          *
-         * If you want to disable question numbering in the entire survey, set SurveyModel's `showQuestionNumbers` property to `false`.
+         * If you want to disable question numbering in the entire survey, set `SurveyModel`'s `showQuestionNumbers` property to `false`.
          * @see SurveyModel.showQuestionNumbers
          */
         get hideNumber(): boolean;
@@ -10622,6 +10662,7 @@ declare module "question" {
         getTitleOwner(): ITitleOwner;
         protected getIsTitleRenderedAsString(): boolean;
         private notifySurveyVisibilityChanged;
+        protected clearValueOnHidding(isClearOnHidden: boolean): void;
         /**
          * 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
@@ -10882,7 +10923,7 @@ declare module "question" {
          */
         get isParentVisible(): boolean;
         clearValueIfInvisible(reason?: string): void;
-        protected clearValueIfInvisibleCore(): void;
+        protected clearValueIfInvisibleCore(reason: string): void;
         /**
          * Specifies when to clear the question value if the question becomes invisible.
          *
@@ -10890,6 +10931,7 @@ declare module "question" {
          *
          * - `"default"` (default) - Inherits the setting from the Survey's [`clearInvisibleValues`](https://surveyjs.io/form-library/documentation/surveymodel#clearInvisibleValues) property.
          * - `"onHidden"` - Clears the value when the question becomes invisible. If a question is invisible on startup and has an initial value, this value will be cleared when the survey is complete.
+         * - `"onHiddenContainer"` - Clears the value when the question or its containter (page or panel) becomes invisible. If the question is invisible initially, its value is removed on survey completion.
          * - `"onComplete"` - Clears the value when the survey is complete.
          * - `"none"` - Never clears the value of an invisible question.
          * @see SurveyModel.clearInvisibleValues
@@ -10898,6 +10940,7 @@ declare module "question" {
          */
         get clearIfInvisible(): string;
         set clearIfInvisible(val: string);
+        protected getClearIfInvisible(): string;
         get displayValue(): any;
         /**
          * Returns a display text that corresponds to the question value. For example, if you call this method for a Dropdown question, it returns an item text instead of an item value.
@@ -11758,8 +11801,7 @@ declare module "base-interfaces" {
         panelVisibilityChanged(panel: IPanel, newValue: boolean): any;
         questionVisibilityChanged(question: IQuestion, newValue: boolean): any;
         isEditingSurveyElement: boolean;
-        isClearValueOnHidden: boolean;
-        isClearValueOnHiddenContainer: boolean;
+        getQuestionClearIfInvisible(questionClearIf: string): string;
         questionsOrder: string;
         matrixDragHandleArea: string;
         keepIncorrectValues: boolean;
@@ -12592,7 +12634,7 @@ declare module "question_matrixdropdown" {
         protected getConditionObjectsRowIndeces(): Array<number>;
         protected setNewValue(newValue: any): void;
         clearIncorrectValues(): void;
-        protected clearValueIfInvisibleCore(): void;
+        protected clearValueIfInvisibleCore(reason: string): void;
         protected generateRows(): Array<MatrixDropdownRowModel>;
         protected createMatrixRow(item: ItemValue, value: any): MatrixDropdownRowModel;
         protected getSearchableItemValueKeys(keys: Array<string>): void;
@@ -12613,6 +12655,7 @@ declare module "dropdownListModel" {
         readonly loadingItemHeight = 40;
         private _markdownMode;
         private _popupModel;
+        focused: boolean;
         private get focusFirstInputSelector();
         protected readonly selectedItemSelector = ".sv-list__item--selected";
         protected readonly itemSelector = ".sv-list__item";
@@ -12667,6 +12710,7 @@ declare module "dropdownListModel" {
         setSearchEnabled(newValue: boolean): void;
         updateItems(): void;
         onClick(event: any): void;
+        protected onPropertyChangedHandler(sender: any, options: any): void;
         protected focusItemOnClickAndPopup(): void;
         onClear(event: any): void;
         getSelectedAction(): ItemValue;
@@ -12939,7 +12983,7 @@ declare module "question_matrix" {
         }): import("question").IQuestionPlainData;
         addConditionObjectsByContext(objects: Array<IConditionObject>, context: any): void;
         getConditionJson(operator?: string, path?: string): any;
-        protected clearValueIfInvisibleCore(): void;
+        protected clearValueIfInvisibleCore(reason: string): void;
         protected getFirstInputElementId(): string;
         onMatrixRowChanged(row: MatrixRowModel): void;
         getCorrectedRowValue(value: any): any;
@@ -13211,6 +13255,7 @@ declare module "dropdownMultiSelectListModel" {
         protected onEscape(): void;
         protected beforeScrollToFocusedItem(focusedItem: ItemValue): void;
         protected afterScrollToFocusedItem(): void;
+        protected onPropertyChangedHandler(sender: any, options: any): void;
     }
 }
 declare module "question_tagbox" {
@@ -14571,7 +14616,7 @@ declare module "question_custom" {
         updateElementCss(reNew?: boolean): void;
         getTextProcessor(): ITextProcessor;
         findQuestionByName(name: string): IQuestion;
-        protected clearValueIfInvisibleCore(): void;
+        protected clearValueIfInvisibleCore(reason: string): void;
         onAnyValueChanged(name: string): void;
         protected createPanel(): PanelModel;
         protected onReadOnlyChanged(): void;