survey-core 1.12.1 → 1.12.3

package/typings/packages/survey-core/src/question_matrixdropdownbase.d.ts

@@ -11,6 +11,7 @@ import { IMatrixColumnOwner, MatrixDropdownColumn } from "./question_matrixdropd
 import { QuestionMatrixDropdownRenderedCell, QuestionMatrixDropdownRenderedRow, QuestionMatrixDropdownRenderedTable } from "./question_matrixdropdownrendered";
 export interface IMatrixDropdownData {
     value: any;
+    getFilteredData(): any;
     onRowChanged(row: MatrixDropdownRowModelBase, columnName: string, newRowValue: any, isDeletingValue: boolean): void;
     onRowChanging(row: MatrixDropdownRowModelBase, columnName: string, rowValue: any): any;
     isValidateOnValueChanging: boolean;
@@ -36,6 +37,7 @@ export interface IMatrixDropdownData {
     getSurvey(): ISurvey;
     getDataFilteredValues(): any;
     isMatrixReadOnly(): boolean;
+    onRowVisibilityChanged(row: MatrixDropdownRowModelBase): void;
 }
 export declare class MatrixDropdownCell {
     column: MatrixDropdownColumn;
@@ -75,6 +77,7 @@ export declare class MatrixDropdownRowModelBase implements ISurveyData, ISurveyI
     private idValue;
     private textPreProcessor;
     private detailPanelValue;
+    private visibleValue;
     cells: Array<MatrixDropdownCell>;
     showHideDetailPanelClick: any;
     onDetailPanelShowingChanged: () => void;
@@ -85,6 +88,10 @@ export declare class MatrixDropdownRowModelBase implements ISurveyData, ISurveyI
     get text(): any;
     isRowEnabled(): boolean;
     protected isRowHasEnabledCondition(): boolean;
+    get isVisible(): boolean;
+    get visible(): boolean;
+    set visible(val: boolean);
+    protected isItemVisible(): boolean;
     get value(): any;
     set value(value: any);
     get locText(): LocalizableString;
@@ -103,7 +110,8 @@ export declare class MatrixDropdownRowModelBase implements ISurveyData, ISurveyI
     getFilteredValues(): any;
     getFilteredProperties(): any;
     private applyRowVariablesToValues;
-    runCondition(values: HashTable<any>, properties: HashTable<any>): void;
+    runCondition(values: HashTable<any>, properties: HashTable<any>, rowsVisibleIf?: string): void;
+    protected setRowsVisibleIfValues(values: any): void;
     getNamesWithDefaultValues(): Array<string>;
     clearValue(keepComment?: boolean): void;
     onAnyValueChanged(name: string, questionName: string): void;
@@ -164,7 +172,7 @@ export declare class MatrixDropdownTotalRowModel extends MatrixDropdownRowModelB
     constructor(data: IMatrixDropdownData);
     protected createCell(column: MatrixDropdownColumn): MatrixDropdownCell;
     setValue(name: string, newValue: any): void;
-    runCondition(values: HashTable<any>, properties: HashTable<any>): void;
+    runCondition(values: HashTable<any>, properties: HashTable<any>, rowsVisibleIf?: string): void;
     protected updateCellOnColumnChanged(cell: MatrixDropdownCell, name: string, newValue: any): void;
 }
 /**
@@ -372,6 +380,7 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
     runTriggers(name: string, value: any): void;
     protected shouldRunColumnExpression(): boolean;
     protected runCellsCondition(values: HashTable<any>, properties: HashTable<any>): void;
+    protected runConditionsForColumns(values: HashTable<any>, properties: HashTable<any>): boolean;
     private checkColumnsVisibility;
     private checkColumnsRenderedRequired;
     private isColumnVisibilityChanged;
@@ -400,7 +409,7 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
      * }
      * ```
      *
-     * To enable Markdown support for the `text` property, implement Markdown-to-HTML conversion in the [onTextMarkdown](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onTextMarkdown) event handler. For an example, refer to the following demo: [Convert Markdown to HTML with Showdown](https://surveyjs.io/form-library/examples/edit-survey-questions-markdown/).
+     * To enable Markdown support for the `text` property, implement Markdown-to-HTML conversion in the [onTextMarkdown](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onTextMarkdown) event handler. For an example, refer to the following demo: [Convert Markdown to HTML with markdown-it](https://surveyjs.io/form-library/examples/edit-survey-questions-markdown/).
      *
      * If you add custom properties, refer to the following help topic to learn how to serialize them into JSON: [Add Custom Properties to Property Grid](https://surveyjs.io/survey-creator/documentation/property-grid#add-custom-properties-to-the-property-grid).
      *
@@ -429,7 +438,13 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
     get locKeyDuplicationError(): LocalizableString;
     get storeOthersAsComment(): boolean;
     addColumn(name: string, title?: string): MatrixDropdownColumn;
+    private visibleRowsArray;
+    protected clearVisibleRows(): void;
+    protected isColumnVisible(column: any): boolean;
+    private isGenereatingRows;
     protected getVisibleRows(): Array<MatrixDropdownRowModelBase>;
+    private generateVisibleRowsIfNeeded;
+    private getVisibleFromGenerated;
     private updateValueOnRowsGeneration;
     get totalValue(): any;
     protected getVisibleTotalRow(): MatrixDropdownRowModelBase;
@@ -503,6 +518,9 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
     protected onCellValueChanged(row: MatrixDropdownRowModelBase, columnName: string, rowValue: any): void;
     validateCell(row: MatrixDropdownRowModelBase, columnName: string, rowValue: any): SurveyError;
     get isValidateOnValueChanging(): boolean;
+    protected get hasInvisibleRows(): boolean;
+    getFilteredData(): any;
+    protected getFilteredDataCore(): any;
     onRowChanging(row: MatrixDropdownRowModelBase, columnName: string, rowValue: any): any;
     onRowChanged(row: MatrixDropdownRowModelBase, columnName: string, newRowValue: any, isDeletingValue: boolean): void;
     private getNewValueOnRowChanged;
@@ -521,6 +539,10 @@ export declare class QuestionMatrixDropdownModelBase extends QuestionMatrixBaseM
     getDataFilteredValues(): any;
     getParentTextProcessor(): ITextProcessor;
     isMatrixReadOnly(): boolean;
+    onRowVisibilityChanged(row: MatrixDropdownRowModelBase): void;
+    protected clearValueIfInvisibleCore(reason: string): void;
+    protected clearInvisibleValuesInRows(): void;
+    protected isRowsFiltered(): boolean;
     getQuestionFromArray(name: string, index: number): IQuestion;
     private isMatrixValueEmpty;
     private get SurveyModel();

package/typings/packages/survey-core/src/question_matrixdropdowncolumn.d.ts

@@ -81,6 +81,7 @@ export declare class MatrixDropdownColumn extends Base implements ILocalizableOw
     set visible(val: boolean);
     get hasVisibleCell(): boolean;
     set hasVisibleCell(newVal: boolean);
+    isColumnsVisibleIf: boolean;
     getVisibleMultipleChoices(): Array<ItemValue>;
     get getVisibleChoicesInCell(): Array<any>;
     setVisibleChoicesInCell(val: Array<any>): void;

package/typings/packages/survey-core/src/question_matrixdynamic.d.ts

@@ -259,6 +259,7 @@ export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownMo
     private getInsertedDeletedIndex;
     private isEditingObjectValueChanged;
     updateValueFromSurvey(newValue: any, clearData?: boolean): void;
+    protected getFilteredDataCore(): any;
     protected onBeforeValueChanged(val: any): void;
     protected createNewValue(): any;
     protected deleteRowValue(newValue: any, row: MatrixDropdownRowModelBase): any;

package/typings/packages/survey-core/src/question_multipletext.d.ts

@@ -232,7 +232,7 @@ export declare class QuestionMultipleTextModel extends Question implements IMult
      * }
      * ```
      *
-     * To enable Markdown support for the `title` property, implement Markdown-to-HTML conversion in the [`onTextMarkdown`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onTextMarkdown) event handler. For an example, refer to the following demo: [Convert Markdown to HTML with Showdown](https://surveyjs.io/form-library/examples/edit-survey-questions-markdown/).
+     * To enable Markdown support for the `title` property, implement Markdown-to-HTML conversion in the [`onTextMarkdown`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onTextMarkdown) event handler. For an example, refer to the following demo: [Convert Markdown to HTML with markdown-it](https://surveyjs.io/form-library/examples/edit-survey-questions-markdown/).
      * @see itemTitleWidth
      * @see addItem
      */

package/typings/packages/survey-core/src/question_ranking.d.ts

@@ -101,6 +101,8 @@ export declare class QuestionRankingModel extends QuestionCheckboxModel {
     */
     get selectToRankEnabled(): boolean;
     set selectToRankEnabled(val: boolean);
+    get selectToRankSwapAreas(): boolean;
+    set selectToRankSwapAreas(val: boolean);
     carryForwardStartUnranked: boolean;
     /**
      * Specifies the layout of the ranked and unranked areas. Applies when [`selectToRankEnabled`](https://surveyjs.io/form-library/documentation/api-reference/ranking-question-model#selectToRankEnabled) is `true`.

package/typings/packages/survey-core/src/question_rating.d.ts

@@ -51,7 +51,7 @@ export declare class QuestionRatingModel extends Question {
      *
      * If you add custom properties, refer to the following help topic to learn how to serialize them into JSON: [Add Custom Properties to Property Grid](https://surveyjs.io/survey-creator/documentation/property-grid#add-custom-properties-to-the-property-grid).
      *
-     * To enable Markdown support for the `text` property, implement Markdown-to-HTML conversion in the [onTextMarkdown](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onTextMarkdown) event handler. For an example, refer to the following demo: [Convert Markdown to HTML with Showdown](https://surveyjs.io/form-library/examples/edit-survey-questions-markdown/).
+     * To enable Markdown support for the `text` property, implement Markdown-to-HTML conversion in the [onTextMarkdown](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#onTextMarkdown) event handler. For an example, refer to the following demo: [Convert Markdown to HTML with markdown-it](https://surveyjs.io/form-library/examples/edit-survey-questions-markdown/).
      *
      * If you need to specify only the `value` property, you can set the `rateValues` property to an array of numbers, for example, `[ 3, 6, 10 ]`. These values are both saved in survey results and used as display text.
      *

package/typings/packages/survey-core/src/survey-element.d.ts

@@ -42,6 +42,7 @@ export declare abstract class SurveyElementCore extends Base implements ILocaliz
     set title(val: string);
     get locTitle(): LocalizableString;
     protected getDefaultTitleValue(): string;
+    protected setTitleValue(val: string): void;
     /**
      * Returns `true` if the survey element has a description.
      * @see description
@@ -259,6 +260,7 @@ export declare class SurveyElement<E = any> extends SurveyElementCore implements
      */
     get cssClasses(): any;
     get cssTitleNumber(): any;
+    get cssRequiredText(): any;
     protected calcCssClasses(css: any): any;
     protected updateElementCssCore(cssClasses: any): void;
     get cssError(): string;

package/typings/packages/survey-core/src/survey.d.ts

@@ -1,6 +1,6 @@
 import { JsonError } from "./jsonobject";
 import { Base, EventBase } from "./base";
-import { ISurvey, ISurveyData, ISurveyImpl, ITextProcessor, IQuestion, IPanel, IElement, IPage, ISurveyErrorOwner, ISurveyElement, IProgressInfo, IFindElement, ISurveyLayoutElement, IPlainDataOptions, LayoutElementContainer, IValueItemCustomPropValues, ILoadFromJSONOptions, IDropdownMenuOptions } from "./base-interfaces";
+import { ISurvey, ISurveyData, ISurveyImpl, ITextProcessor, IQuestion, IPanel, IElement, IPage, ISurveyErrorOwner, ISurveyElement, IProgressInfo, IFindElement, ISurveyLayoutElement, IPlainDataOptions, LayoutElementContainer, IValueItemCustomPropValues, ILoadFromJSONOptions, IDropdownMenuOptions, ITextProcessorProp, ITextProcessorResult } from "./base-interfaces";
 import { SurveyElementCore } from "./survey-element";
 import { ISurveyTriggerOwner, SurveyTrigger, Trigger } from "./trigger";
 import { CalculatedValue } from "./calculatedValue";
@@ -64,7 +64,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      *
      * For information on event handler parameters, refer to descriptions within the interface.
      *
-     * [Conditional Survey Logic (Triggers)](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#conditional-survey-logic-triggers (linkStyle)).
+     * [Conditional Survey Logic (Triggers)](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#conditional-survey-logic-triggers (linkStyle))
      * @see triggers
      * @see runTriggers
      */
@@ -2617,10 +2617,9 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     validatePanel(panel: PanelModel): SurveyError;
     processHtml(html: string, reason?: string): string;
     processText(text: string, returnDisplayValue: boolean): string;
-    processTextEx(text: string, returnDisplayValue: boolean, doEncoding: boolean): any;
+    processTextEx(params: ITextProcessorProp): ITextProcessorResult;
     private textPreProcessorValue;
     private get textPreProcessor();
-    private processTextCore;
     getSurveyMarkdownHtml(element: Question | PanelModel | PageModel | SurveyModel, text: string, name: string): string;
     getCorrectedAnswerCount(): number;
     /**

package/typings/packages/survey-core/src/textPreProcessor.d.ts

@@ -1,6 +1,6 @@
 import { Question } from "./question";
 import { PanelModel } from "./panel";
-import { ISurvey, ITextProcessor } from "./base-interfaces";
+import { ISurvey, ITextProcessor, ITextProcessorProp, ITextProcessorResult } from "./base-interfaces";
 export declare class TextPreProcessorItem {
     start: number;
     end: number;
@@ -38,6 +38,6 @@ export declare class QuestionTextProcessor implements ITextProcessor {
     protected getQuestionDisplayText(question: Question): string;
     private getProcessedTextValue;
     processText(text: string, returnDisplayValue: boolean): string;
-    processTextEx(text: string, returnDisplayValue: boolean): any;
+    processTextEx(params: ITextProcessorProp): ITextProcessorResult;
     private processTextCore;
 }

package/typings/packages/survey-core/src/utils/text-area.d.ts

@@ -0,0 +1,56 @@
+import { Question } from "../question";
+export interface ITextArea {
+    question: any;
+    id: () => string;
+    propertyName: string;
+    className: () => string;
+    isDisabledAttr: () => boolean;
+    isReadOnlyAttr?: () => boolean;
+    placeholder: () => string;
+    autoGrow: () => boolean;
+    maxLength: () => number;
+    rows: () => number;
+    cols?: () => number;
+    getTextValue?: () => any;
+    onTextAreaChange?: (event: any) => void;
+    onTextAreaInput?: (event: any) => void;
+    onTextAreaKeyDown?: (event: any) => void;
+    onTextAreaBlur?: (event: any) => void;
+    onTextAreaFocus?: (event: any) => void;
+    ariaRequired: () => "true" | "false";
+    ariaLabel: () => string;
+    ariaInvalid?: () => "true" | "false";
+    ariaLabelledBy?: () => string;
+    ariaDescribedBy?: () => string;
+    ariaErrormessage?: () => string;
+}
+export declare class TextAreaModel {
+    private options;
+    private element;
+    private onPropertyChangedCallback;
+    constructor(options: ITextArea);
+    setElement(element: HTMLTextAreaElement | null): void;
+    getTextValue(): string;
+    onTextAreaChange(event: any): void;
+    onTextAreaInput(event: any): void;
+    onTextAreaKeyDown(event: any): void;
+    onTextAreaBlur(event: any): void;
+    onTextAreaFocus(event: any): void;
+    get question(): Question;
+    get id(): string;
+    get placeholder(): string;
+    get className(): string;
+    get maxLength(): number;
+    get autoGrow(): boolean;
+    get rows(): number;
+    get cols(): number | undefined;
+    get isDisabledAttr(): boolean;
+    get isReadOnlyAttr(): boolean | undefined;
+    get ariaRequired(): "true" | "false";
+    get ariaLabel(): string;
+    get ariaInvalid(): "true" | "false";
+    get ariaLabelledBy(): string;
+    get ariaDescribedBy(): string;
+    get ariaErrormessage(): string;
+    dispose(): void;
+}

package/typings/packages/survey-core/src/validator.d.ts

@@ -8,13 +8,18 @@ export declare class ValidatorResult {
     constructor(value: any, error?: SurveyError);
 }
 /**
- * Base SurveyJS validator class.
+ * A base class for all classes that implement validators.
+ *
+ * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
  */
 export declare class SurveyValidator extends Base {
     errorOwner: ISurveyErrorOwner;
     onAsyncCompleted: (result: ValidatorResult) => void;
     constructor();
     getSurvey(live?: boolean): ISurvey;
+    /**
+     * An error message to display when a value fails validation.
+     */
     get text(): string;
     set text(value: string);
     get isValidateAllValues(): boolean;
@@ -46,7 +51,9 @@ export declare class ValidatorRunner {
     private prepareAsyncValidators;
 }
 /**
- * Validate numeric values.
+ * A class that implements a validator for numeric values.
+ *
+ * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
  */
 export declare class NumericValidator extends SurveyValidator {
     constructor(minValue?: number, maxValue?: number);
@@ -54,18 +61,24 @@ export declare class NumericValidator extends SurveyValidator {
     validate(value: any, name?: string, values?: any, properties?: any): ValidatorResult;
     protected getDefaultErrorText(name: string): string;
     /**
-     * The minValue property.
+     * A minimum allowed numeric value.
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
      */
     get minValue(): number;
     set minValue(val: number);
     /**
-     * The maxValue property.
+     * A maximum allowed numeric value.
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
      */
     get maxValue(): number;
     set maxValue(val: number);
 }
 /**
- * Validate text values.
+ * A class that implements a validator for text values.
+ *
+ * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
  */
 export declare class TextValidator extends SurveyValidator {
     constructor();
@@ -73,23 +86,35 @@ export declare class TextValidator extends SurveyValidator {
     validate(value: any, name?: string, values?: any, properties?: any): ValidatorResult;
     protected getDefaultErrorText(name: string): string;
     /**
-     * The minLength property.
+     * The minimum length of a text value measured in characters.
+     *
+     * Default value: 0
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
      */
     get minLength(): number;
     set minLength(val: number);
     /**
-     * The maxLength property.
+     * The maximum length of a text value measured in characters.
+     *
+     * Default value: 0 (unlimited)
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
      */
     get maxLength(): number;
     set maxLength(val: number);
     /**
-     * The allowDigits property.
+     * Specifies whether a text value can include numerical digits.
+     *
+     * Default value: `true`
      */
     get allowDigits(): boolean;
     set allowDigits(val: boolean);
 }
 /**
- * Validates the number of answers.
+ * A class that implements answer count validation in the question types that can have multiple values (for instance, [Checkboxes](https://surveyjs.io/form-library/documentation/api-reference/checkbox-question-model)).
+ *
+ * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
  */
 export declare class AnswerCountValidator extends SurveyValidator {
     constructor(minCount?: number, maxCount?: number);
@@ -97,18 +122,22 @@ export declare class AnswerCountValidator extends SurveyValidator {
     validate(value: any, name?: string, values?: any, properties?: any): ValidatorResult;
     protected getDefaultErrorText(name: string): string;
     /**
-     * The minCount property.
+     * A minimum number of selected answers.
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
      */
     get minCount(): number;
     set minCount(val: number);
     /**
-     * The maxCount property.
+     * A maximum number of selected answers.
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
      */
     get maxCount(): number;
     set maxCount(val: number);
 }
 /**
- * Use it to validate the text by regular expressions.
+ * A class that implements validation using regular expressions.
  *
  * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
  */
@@ -118,16 +147,27 @@ export declare class RegexValidator extends SurveyValidator {
     validate(value: any, name?: string, values?: any, properties?: any): ValidatorResult;
     private hasError;
     /**
-     * The regex property.
+     * A regular expression used to validate values.
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
      */
     get regex(): string;
     set regex(val: string);
+    /**
+     * Specifies whether uppercase and lowercase letters must be treated as distinct or equivalent when validating values.
+     *
+     * Default value: `false` (uppercase and lowercase letters are treated as distinct)
+     */
+    get caseInsensitive(): boolean;
+    set caseInsensitive(val: boolean);
     get insensitive(): boolean;
     set insensitive(val: boolean);
     private createRegExp;
 }
 /**
- * Validate e-mail address in the text input
+ * A class that implements a validator for e-mail addresses.
+ *
+ * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
  */
 export declare class EmailValidator extends SurveyValidator {
     private re;
@@ -137,7 +177,9 @@ export declare class EmailValidator extends SurveyValidator {
     protected getDefaultErrorText(name: string): string;
 }
 /**
- * Show error if expression returns false
+ * A class that implements validation using [expressions](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions).
+ *
+ * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
  */
 export declare class ExpressionValidator extends SurveyValidator {
     private conditionRunner;
@@ -152,7 +194,9 @@ export declare class ExpressionValidator extends SurveyValidator {
     protected getDefaultErrorText(name: string): string;
     protected ensureConditionRunner(): boolean;
     /**
-     * The expression property.
+     * A Boolean [expression](https://surveyjs.io/form-library/documentation/design-survey/conditional-logic#expressions). If it evaluates to `false`, validation fails.
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/javascript-form-validation/ (linkStyle))
      */
     get expression(): string;
     set expression(val: string);

package/typings/src/defaultCss/cssmodern.d.ts

@@ -82,6 +82,7 @@ export declare var modernCss: {
     page: {
         root: string;
         title: string;
+        number: string;
         description: string;
     };
     pageTitle: string;
@@ -159,6 +160,7 @@ export declare var modernCss: {
         rootSelectToRankMod: string;
         rootSelectToRankAlignVertical: string;
         rootSelectToRankAlignHorizontal: string;
+        rootSelectToRankSwapAreas: string;
         item: string;
         itemContent: string;
         itemIndex: string;

package/typings/src/defaultCss/cssstandard.d.ts

@@ -140,6 +140,7 @@ export declare var defaultStandardCss: {
         rootSelectToRankMod: string;
         rootSelectToRankAlignVertical: string;
         rootSelectToRankAlignHorizontal: string;
+        rootSelectToRankSwapAreas: string;
         item: string;
         itemContent: string;
         itemIndex: string;