survey-core 1.9.124 → 1.9.125

package/ts3.4/typings/settings.d.ts

@@ -142,12 +142,12 @@ export declare var settings: {
      * import { ItemValue, settings } from "survey-core";
      *
      * // `itemValueSerializeAsObject` example
-     * settings.localization.itemValueSerializeAsObject = true;
+     * settings.serialization.itemValueSerializeAsObject = true;
      * const item = new ItemValue(5);
      * const itemString = item.toJSON(); // Produces { value: 5 } instead of 5
      *
      * // `itemValueSerializeDisplayText` example
-     * settings.localization.itemValueSerializeDisplayText = true;
+     * settings.serialization.itemValueSerializeDisplayText = true;
      * const item = new ItemValue("item1");
      * const itemString = item.toJSON(); // Produces { value: "item1", text: "item1" } instead of "item1"
      * ```

package/ts3.4/typings/survey-events-api.d.ts

@@ -694,7 +694,7 @@ export interface MatrixAllowRemoveRowEvent extends MatrixDynamicQuestionEventMix
 }
 export interface MatrixCellCreatingBaseEvent extends MatrixDropdownQuestionEventMixin {
     /**
-     * A matrix column to which the cell belongs.
+     * A [matrix column](https://surveyjs.io/form-library/documentation/api-reference/multi-select-matrix-column-values) to which the cell belongs.
      */
     column: MatrixDropdownColumn;
     /**
@@ -741,7 +741,7 @@ export interface MatrixAfterCellRenderEvent extends QuestionEventMixin, AfterRen
      */
     row: MatrixDropdownRowModelBase;
     /**
-     * A matrix column to which the cell belongs.
+     * A [matrix column](https://surveyjs.io/form-library/documentation/api-reference/multi-select-matrix-column-values) to which the cell belongs.
      */
     column: MatrixDropdownColumn | MatrixDropdownCell;
 }
@@ -751,7 +751,7 @@ export interface MatrixCellValueBaseEvent extends MatrixDropdownQuestionEventMix
      */
     row: MatrixDropdownRowModelBase;
     /**
-     * A matrix column to which the cell belongs.
+     * A [matrix column](https://surveyjs.io/form-library/documentation/api-reference/multi-select-matrix-column-values) to which the cell belongs.
      */
     column: MatrixDropdownColumn;
     /**

package/ts3.4/typings/survey.d.ts

@@ -776,6 +776,8 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     */
     lazyRendering: boolean;
     readonly isLazyRendering: boolean;
+    lazyRenderingFirstBatchSizeValue: number;
+    lazyRenderingFirstBatchSize: number;
     private updateLazyRenderingRowsOnRemovingElements;
     /*
     * A list of triggers in the survey.
@@ -1550,6 +1552,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     * The `currentPage` property does not return the start page even if it is current. Use the [`activePage`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#activePage) property instead if your survey contains a start page.
     */
     currentPage: any;
+    tryNavigateToPage(page: PageModel): boolean;
     private updateCurrentPage;
     private readonly isCurrentPageAvailable: any;
     private isPageExistsInSurvey;

package/ts3.4/typings/surveyStrings.d.ts

@@ -40,6 +40,7 @@ export declare var surveyStrings: {
     requiredError: string;
     requiredErrorInPanel: string;
     requiredInAllRowsError: string;
+    eachRowUniqueError: string;
     numericError: string;
     minError: string;
     maxError: string;

package/ts3.4/typings/surveyToc.d.ts

@@ -1,10 +1,8 @@
 import { Action } from "./actions/action";
 import { ListModel } from "./list";
-import { PageModel } from "./page";
 import { PanelModelBase } from "./panel";
 import { PopupModel } from "./popup";
 import { SurveyModel } from "./survey";
-export declare function tryNavigateToPage(survey: SurveyModel, page: PageModel): boolean;
 export declare function tryFocusPage(survey: SurveyModel, panel: PanelModelBase): boolean;
 export declare function createTOCListModel(survey: SurveyModel, onAction?: () => void): ListModel<Action>;
 export declare function getTocRootCss(survey: SurveyModel, isMobile?: boolean): string;

package/typings/actions/action.d.ts

@@ -1,5 +1,5 @@
 import { ILocalizableOwner, LocalizableString } from "../localizablestring";
-import { Base } from "../base";
+import { Base, ComputedUpdater } from "../base";
 import { IListModel } from "../list";
 import { IPopupOptionsBase } from "../popup";
 export declare type actionModeType = "large" | "small" | "popup" | "removed";
@@ -22,7 +22,7 @@ export interface IAction {
      * @see enabled
      * @see active
      */
-    visible?: boolean;
+    visible?: boolean | ComputedUpdater<boolean>;
     /**
      * The action item's title.
      *
@@ -43,7 +43,7 @@ export interface IAction {
      * @see active
      * @see visible
      */
-    enabled?: boolean;
+    enabled?: boolean | ComputedUpdater<boolean>;
     enabledIf?: () => boolean;
     /**
      * Specifies the visibility of the action item's title.

package/typings/base-interfaces.d.ts

@@ -74,6 +74,7 @@ export interface ISurvey extends ITextProcessor, ISurveyErrorOwner {
     allowResizeComment: boolean;
     state: string;
     isLazyRendering: boolean;
+    lazyRenderingFirstBatchSize: number;
     cancelPreviewByPage(panel: IPanel): any;
     locEditText: LocalizableString;
     cssNavigationEdit: string;

package/typings/base.d.ts

@@ -265,7 +265,7 @@ export declare class Base {
     registerFunctionOnPropertiesValueChanged(names: Array<string>, func: any, key?: string): void;
     unRegisterFunctionOnPropertyValueChanged(name: string, key?: string): void;
     unRegisterFunctionOnPropertiesValueChanged(names: Array<string>, key?: string): void;
-    createCustomLocalizableObj(name: string): void;
+    createCustomLocalizableObj(name: string): LocalizableString;
     getLocale(): string;
     getLocalizationString(strName: string): string;
     getLocalizationFormatString(strName: string, ...args: any[]): string;

package/typings/error.d.ts

@@ -56,6 +56,12 @@ export declare class RequiredInAllRowsError extends SurveyError {
     getErrorType(): string;
     protected getDefaultText(): string;
 }
+export declare class EachRowUniqueError extends SurveyError {
+    text: string;
+    constructor(text: string, errorOwner?: ISurveyErrorOwner);
+    getErrorType(): string;
+    protected getDefaultText(): string;
+}
 export declare class MinRowCountError extends SurveyError {
     minRowCount: number;
     constructor(minRowCount: number, errorOwner?: ISurveyErrorOwner);

package/typings/jsonobject.d.ts

@@ -152,11 +152,13 @@ export declare class JsonMetadataClass {
     properties: Array<JsonObjectProperty>;
     private isCustomValue;
     private allProperties;
+    private requiredProperties;
     private hashProperties;
     constructor(name: string, properties: Array<any>, creator?: (json?: any) => any, parentName?: string);
     find(name: string): JsonObjectProperty;
     findProperty(name: string): JsonObjectProperty;
     getAllProperties(): Array<JsonObjectProperty>;
+    getRequiredProperties(): Array<JsonObjectProperty>;
     resetAllProperties(): void;
     get isCustom(): boolean;
     private fillAllProperties;
@@ -177,6 +179,7 @@ export declare class JsonMetadata {
     private classes;
     private alternativeNames;
     private childrenClasses;
+    private dynamicPropsCache;
     onSerializingProperty: ((obj: Base, prop: JsonObjectProperty, value: any, json: any) => boolean) | undefined;
     getObjPropertyValue(obj: any, name: string): any;
     setObjPropertyValue(obj: any, name: string, val: any): void;
@@ -204,6 +207,7 @@ export declare class JsonMetadata {
     addProperty(className: string, propertyInfo: any): JsonObjectProperty;
     private addCustomPropertyCore;
     removeProperty(className: string, propertyName: string): boolean;
+    private clearDynamicPropsCache;
     private removePropertyFromClass;
     private fillChildrenClasses;
     findClass(name: string): JsonMetadataClass;

package/typings/localizablestring.d.ts

@@ -42,6 +42,7 @@ export declare class LocalizableString implements ILocalizableString {
     searchText: string;
     searchIndex: number;
     disableLocalization: boolean;
+    defaultValue: string;
     constructor(owner: ILocalizableOwner, useMarkdown?: boolean, name?: string);
     getIsMultiple(): boolean;
     get locale(): string;

package/typings/localization/english.d.ts

@@ -23,6 +23,7 @@ export declare var englishStrings: {
     requiredError: string;
     requiredErrorInPanel: string;
     requiredInAllRowsError: string;
+    eachRowUniqueError: string;
     numericError: string;
     minError: string;
     maxError: string;

package/typings/martixBase.d.ts

@@ -25,9 +25,13 @@ export declare class QuestionMatrixBaseModel<TRow, TColumn> extends Question {
     /**
      * An array of matrix columns.
      *
-     * This array can contain primitive values or objects with the `text` (display value) and `value` (value to be saved in survey results) properties.
+     * For a Single-Select Matrix, the `columns` array can contain configuration objects with the `text` (display value) and `value` (value to be saved in survey results) properties. Alternatively, the array can contain primitive values that will be used as both the display values and values to be saved in survey results.
      *
-     * [View Demo](https://surveyjs.io/form-library/examples/single-selection-matrix-table-question/ (linkStyle))
+     * [View "Single-Select Matrix" Demo](https://surveyjs.io/form-library/examples/single-selection-matrix-table-question/ (linkStyle))
+     *
+     * For a Multi-Select Matrix or Dynamic Matrix, the `columns` array should contain configuration objects with properties described in the [`MatrixDropdownColumn`](https://surveyjs.io/form-library/documentation/api-reference/multi-select-matrix-column-values) API Reference section.
+     *
+     * [View "Multi-Select Matrix" Demo](https://surveyjs.io/form-library/examples/questiontype-matrixdropdown/ (linkStyle))
      */
     get columns(): Array<any>;
     set columns(newValue: Array<any>);

package/typings/panel.d.ts

@@ -122,7 +122,7 @@ export declare class PanelModelBase extends SurveyElement<Question> implements I
      *
      * A survey parses and runs all expressions on startup. If any values used in the expression change, the survey re-evaluates it.
      *
-     * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility)
+     * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility).
      * @see visible
      * @see isVisible
      */
@@ -215,7 +215,7 @@ export declare class PanelModelBase extends SurveyElement<Question> implements I
      *
      * A survey parses and runs all expressions on startup. If any values used in the expression change, the survey re-evaluates it.
      *
-     * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility)
+     * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility).
      * @see isRequired
      */
     get requiredIf(): string;
@@ -338,7 +338,7 @@ export declare class PanelModelBase extends SurveyElement<Question> implements I
      *
      * A survey parses and runs all expressions on startup. If any values used in the expression change, the survey re-evaluates it.
      *
-     * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility)
+     * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility).
      * @see readOnly
      * @see isReadOnly
      */

package/typings/question.d.ts

@@ -158,7 +158,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
      *
      * A survey parses and runs all expressions on startup. If any values used in the expression change, the survey re-evaluates it.
      *
-     * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility)
+     * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility).
      * @see visible
      * @see isVisible
      */
@@ -448,7 +448,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
      *
      * A survey parses and runs all expressions on startup. If any values used in the expression change, the survey re-evaluates it.
      *
-     * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility)
+     * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility).
      * @see isRequired
      */
     get requiredIf(): string;
@@ -495,7 +495,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
      *
      * A survey parses and runs all expressions on startup. If any values used in the expression change, the survey re-evaluates it.
      *
-     * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility)
+     * Refer to the following help topic for more information: [Conditional Visibility](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#conditional-visibility).
      * @see readOnly
      * @see isReadOnly
      */

package/typings/question_baseselect.d.ts

@@ -293,7 +293,7 @@ export declare class QuestionSelectBase extends Question {
     get otherPlaceHolder(): string;
     set otherPlaceHolder(newValue: string);
     /**
-     * Get or sets an error message displayed when users select the "Other" choice item but leave the comment area empty.
+     * Gets or sets an error message displayed when users select the "Other" choice item but leave the comment area empty.
      * @see showOtherItem
      */
     get otherErrorText(): string;
@@ -460,7 +460,7 @@ export declare class QuestionCheckboxBase extends QuestionSelectBase {
     colCountChangedCallback: () => void;
     constructor(name: string);
     /**
-     * Get or sets the number of columns used to arrange choice items.
+     * Gets or sets the number of columns used to arrange choice items.
      *
      * Set this property to 0 if you want to display all items in one line. The default value depends on the available width.
      * @see separateSpecialChoices

package/typings/question_custom.d.ts

@@ -37,13 +37,37 @@ export interface ICustomQuestionTypeConfiguration {
      */
     onInit?(): void;
     /**
-     * Specifies whether the custom question type is available in the Toolbox and the Add Question menu.
+     * Specifies whether the custom question type is available in the Toolbox and the Add Question menu in Survey Creator.
      *
      * Default value: `true`
      *
      * Set this property to `false` if your custom question type is used only to customize Property Grid content and is not meant for a survey.
      */
     showInToolbox?: boolean;
+    /**
+     * A default title for questions created with this question type. Survey authors can change the default title in the JSON object or in Survey Creator's Property Grid.
+     *
+     * You can specify the question title with a string value or with an object that defines different titles for different locales:
+     *
+     * ```js
+     * import { ComponentCollection } from "survey-core";
+     *
+     * ComponentCollection.Instance.add({
+     *   // ...
+     *   defaultQuestionTitle: "Default title"
+     * });
+     * // ===== OR =====
+     * ComponentCollection.Instance.add({
+     *   // ...
+     *   defaultQuestionTitle: {
+     *     en: "Default title",
+     *     de: "Standardtitel",
+     *     fr: "Titre par défaut"
+     *   }
+     * });
+     * ```
+     */
+    defaultQuestionTitle?: any;
     /**
      * A function that is called when the custom question is created. Use it to access questions nested within a [composite question type](https://surveyjs.io/form-library/documentation/customize-question-types/create-composite-question-types).
      *
@@ -208,6 +232,7 @@ export declare class ComponentQuestionJSON {
     onValueChanging(question: Question, name: string, newValue: any): any;
     onItemValuePropertyChanged(question: Question, item: ItemValue, propertyName: string, name: string, newValue: any): void;
     getDisplayValue(keyAsText: boolean, value: any, question: Question): any;
+    get defaultQuestionTitle(): any;
     setValueToQuestion(val: any): any;
     getValueFromQuestion(val: any): any;
     get isComposite(): boolean;
@@ -231,10 +256,12 @@ export declare class ComponentCollection {
 }
 export declare abstract class QuestionCustomModelBase extends Question implements ISurveyImpl, ISurveyData, IPanel {
     customQuestion: ComponentQuestionJSON;
+    private locQuestionTitle;
     constructor(name: string, customQuestion: ComponentQuestionJSON);
     getType(): string;
     locStrsChanged(): void;
     localeChanged(): void;
+    protected getDefaultTitle(): string;
     addUsedLocales(locales: Array<string>): void;
     needResponsiveWidth(): boolean;
     protected createWrapper(): void;

package/typings/question_matrix.d.ts

@@ -8,6 +8,7 @@ import { IPlainDataOptions } from "./base-interfaces";
 export interface IMatrixData {
     onMatrixRowChanged(row: MatrixRowModel): void;
     getCorrectedRowValue(value: any): any;
+    hasErrorInRow(row: MatrixRowModel): boolean;
 }
 export declare class MatrixRowModel extends Base {
     fullName: string;
@@ -19,7 +20,7 @@ export declare class MatrixRowModel extends Base {
     get text(): string;
     get locText(): LocalizableString;
     get value(): any;
-    set value(newValue: any);
+    set value(val: any);
     get rowClasses(): string;
 }
 export interface IMatrixCellsOwner extends ILocalizableOwner {
@@ -68,9 +69,18 @@ export declare class QuestionMatrixModel extends QuestionMatrixBaseModel<MatrixR
     /**
      * Specifies whether each row requires an answer. If a respondent skips a row, the question displays a validation error.
      * @see isRequired
+     * @see eachRowUnique
+     * @see validators
      */
     get isAllRowRequired(): boolean;
     set isAllRowRequired(val: boolean);
+    /**
+     * Specifies whether answers in all rows should be unique. If any answers duplicate, the question displays a validation error.
+     * @see isAllRowRequired
+     * @see validators
+     */
+    get eachRowUnique(): boolean;
+    set eachRowUnique(val: boolean);
     get hasRows(): boolean;
     /**
      * Specifies a sort order for matrix rows.
@@ -115,9 +125,13 @@ export declare class QuestionMatrixModel extends QuestionMatrixBaseModel<MatrixR
     private emptyLocalizableString;
     getCellDisplayLocText(row: any, column: any): LocalizableString;
     supportGoNextPageAutomatic(): boolean;
+    private errorsInRow;
     protected onCheckForErrors(errors: Array<SurveyError>, isOnValueChanged: boolean): void;
-    private hasErrorInRows;
+    private hasErrorAllRowsRequired;
+    private hasErrorEachRowUnique;
     private hasValuesInAllRows;
+    private hasNonUniqueValueInRow;
+    private addErrorIntoRow;
     protected getIsAnswered(): boolean;
     private createMatrixRow;
     protected onMatrixRowCreated(row: MatrixRowModel): void;
@@ -130,6 +144,7 @@ export declare class QuestionMatrixModel extends QuestionMatrixBaseModel<MatrixR
     protected getFirstInputElementId(): string;
     onMatrixRowChanged(row: MatrixRowModel): void;
     getCorrectedRowValue(value: any): any;
+    hasErrorInRow(row: MatrixRowModel): boolean;
     protected getSearchableItemValueKeys(keys: Array<string>): void;
     private get SurveyModel();
     getColumnHeaderWrapperComponentName(cell: ItemValue): string;

package/typings/question_matrixdropdownbase.d.ts

@@ -302,14 +302,15 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
      *
      * Possible values:
      *
-     * - `"dropdown"`
-     * - `"checkbox"`
-     * - `"radiogroup"`
-     * - `"text"`
-     * - `"comment"`
-     * - `"boolean"`
-     * - `"expression"`
-     * - `"rating"`
+     * - [`"dropdown"`](https://surveyjs.io/form-library/documentation/api-reference/dropdown-menu-model)
+     * - [`"checkbox"`](https://surveyjs.io/form-library/documentation/api-reference/checkbox-question-model)
+     * - [`"radiogroup"`](https://surveyjs.io/form-library/documentation/api-reference/radio-button-question-model)
+     * - [`"tagbox"`](https://surveyjs.io/form-library/documentation/api-reference/dropdown-tag-box-model)
+     * - [`"text"`](https://surveyjs.io/form-library/documentation/api-reference/text-entry-question-model)
+     * - [`"comment"`](https://surveyjs.io/form-library/documentation/api-reference/comment-field-model)
+     * - [`"boolean"`](https://surveyjs.io/form-library/documentation/api-reference/boolean-question-model)
+     * - [`"expression"`](https://surveyjs.io/form-library/documentation/api-reference/expression-model)
+     * - [`"rating"`](https://surveyjs.io/form-library/documentation/api-reference/rating-scale-question-model)
      *
      * Default value: `"dropdown"` (inherited from [`settings.matrix.defaultCellType`](https://surveyjs.io/form-library/documentation/settings#matrixDefaultCellType))
      */