survey-core 1.9.21 → 1.9.24

package/survey.core.d.ts

@@ -1,5 +1,5 @@
 /*
-* Type definition for Survey JavaScript library. Platform independent (core) v1.9.21
+* Type definition for Survey JavaScript library. Platform independent (core) v1.9.24
 * Copyright (c) 2015-2022 Devsoft Baltic OÜ  - https://surveyjs.io/
 * License: MIT (http://www.opensource.org/licenses/mit-license.php)
 */
@@ -89,124 +89,99 @@ export interface IExpresionExecutor {
   * This call back runs on executing expression if there is at least one async function
   */
   onComplete: any;
-  /*
-  * The expression as string, property with get/set
-  */
-  expression: string;
-  /*
-  * Returns true if the expression is valid and can be executed
-  */
-  canRun(): boolean;
-  /*
-  * Run the expression. Returns the result of execution.
-  * The result can be undefined if there is an asyn function. In this case result will be returned onComplete callback.
-  */
-  run(values: any, properties: any): any;
-  /*
-  * Returns the list of variables that used in the expression. They defined as: {variableName} in default parser.
-  */
-  getVariables(): Array<any>;
-  /*
-  * Returns true if there is a function in the expression
-  */
-  hasFunction(): boolean;
-  /*
-  * Returns true if there is an async function in the expression
-  */
-  isAsync: boolean;
 }
 /*
-* Defines an individual action. Action items can be displayed in certain survey elements - in Toolbar (or action bar), in titles (of pages, panels, questions), in matrix rows (as 'expand details' or 'remove row' buttons), and etc.
+* An action item.
+* Action items are used in the Toolbar, matrix rows, titles of pages, panels, questions, and other survey elements.
 */
 export interface IAction {
   /*
-  * Unique string id
+  * A unique action item identifier.
   */
   id: string;
   /*
-  * Set this property to false to make the toolbar item invisible.
+  * Specifies the action item's visibility.
   */
   visible?: boolean;
   /*
-  * Toolbar item title
+  * The action item's title.
   */
   title?: string;
   /*
-  * Toolbar item tooltip
+  * The action item's tooltip.
   */
   tooltip?: string;
   /*
-  * Set this property to false to disable the toolbar item.
+  * Specifies whether users can interact with the action item.
   */
   enabled?: boolean;
   /*
-  * Set this property to false to hide the toolbar item title.
+  * Specifies the visibility of the action item's title.
   */
   showTitle?: boolean;
   /*
-  * A callback that calls on toolbar item click.
+  * A function that is executed when users click the action item.
   */
   action?: any;
   /*
-  * Toolbar item css class
+  * One or several CSS classes that you want to apply to the outer `<div>` element.
+  * In the markup, an action item is rendered as an `<input>` wrapped in a `<div>`. The `css` property applies classes to the `<div>`.
+  * To apply several classes, separate them with a space character: "myclass1 myclass2".
   */
   css?: string;
   /*
-  * Toolbar inner element css class
+  * One or several CSS classes that you want to apply to the inner `<input>` element.
+  * In the markup, an action item is rendered as an `<input>` wrapped in a `<div>`. The `innerCss` property applies classes to the `<input>`.
+  * To apply several classes, separate them with a space character: "myclass1 myclass2".
   */
   innerCss?: string;
   /*
-  * Toolbar item data object. Used as data for custom template or component rendering
+  * The action item's data object. Use it to pass required data to a custom template or component.
   */
   data?: any;
   popupModel?: any;
   needSeparator?: boolean;
   /*
-  * Set this property to true to activate the toolbar item (page)
+  * Specifies whether the action item is active.
+  * Use it as a flag to specify different action item appearances in different states.
   */
   active?: boolean;
   pressed?: boolean;
   /*
-  * Toolbar item template name
+  * Specifies the name of a template used to render the action item.
   */
   template?: string;
   /*
-  * Toolbar item component name
+  * Specifies the name of a component used to render the action item.
   */
   component?: string;
   /*
-  * Toolbar item icon name
+  * The action item's icon name.
   */
   iconName?: string;
   /*
-  * Toolbar item icon size
+  * The action item's icon size in pixels.
   */
   iconSize?: number;
   /*
-  * Toolbar item child items. Can be used as contianer for options
-  */
-  items?: any;
-  /*
-  * Gets or sets an action's location in a matrix question's row.
+  * The action item's location in a matrix question's row.
   * 
-  * The following options are available:
+  * The following values are available:
   * 
-  * - `start` - An action is located at the beginning of a row.
-  * - `end` - An action is located at the end of a row.
+  * - `"start"` - The action item is located at the beginning of the row.
+  * - `"end"` - The action is located at the end of the row.
   */
   location?: string;
   /*
-  * Set it to true to make the tabIndex -1 to disable keyboard navigation to this item
+  * Set this property to `true` if you want to disable keyboard navigation for the action item (sets the `tabIndex` attribute to -1).
   */
   disableTabStop?: boolean;
   /*
-  * Set it to false to force action "large" mode even if has icon and does not fit to action bar space
+  * Set this property to `true` if you want the item's `title` to be always visible.
+  * If you set it to `false`, the `title` hides when the screen space is limited, and the item displays only the icon.
   */
   disableShrink?: boolean;
-  /*
-  * Action button display mode
-  */
-  mode?: "popup" | "large" | "small";
+  mode?: any;
   visibleIndex?: number;
   needSpace?: boolean;
 }
@@ -612,7 +587,28 @@ export declare class Base {
   protected addEvent<T>(): EventBase<T>;
   protected onBaseCreating(): void;
   /*
-  * Returns the type of the object as a string as it represents in the json. It should be in lowcase.
+  * Returns the question type.
+  * Possible values:
+  * - [*"boolean"*](https://surveyjs.io/Documentation/Library?id=questionbooleanmodel)
+  * - [*"checkbox"*](https://surveyjs.io/Documentation/Library?id=questioncheckboxmodel)
+  * - [*"comment"*](https://surveyjs.io/Documentation/Library?id=questioncommentmodel)
+  * - [*"dropdown"*](https://surveyjs.io/Documentation/Library?id=questiondropdownmodel)
+  * - [*"expression"*](https://surveyjs.io/Documentation/Library?id=questionexpressionmodel)
+  * - [*"file"*](https://surveyjs.io/Documentation/Library?id=questionfilemodel)
+  * - [*"html"*](https://surveyjs.io/Documentation/Library?id=questionhtmlmodel)
+  * - [*"image"*](https://surveyjs.io/Documentation/Library?id=questionimagemodel)
+  * - [*"imagepicker"*](https://surveyjs.io/Documentation/Library?id=questionimagepickermodel)
+  * - [*"matrix"*](https://surveyjs.io/Documentation/Library?id=questionmatrixmodel)
+  * - [*"matrixdropdown"*](https://surveyjs.io/Documentation/Library?id=questionmatrixdropdownmodel)
+  * - [*"matrixdynamic"*](https://surveyjs.io/Documentation/Library?id=questionmatrixdynamicmodel)
+  * - [*"multipletext"*](https://surveyjs.io/Documentation/Library?id=questionmultipletextmodel)
+  * - [*"panel"*](https://surveyjs.io/Documentation/Library?id=panelmodel)
+  * - [*"paneldynamic"*](https://surveyjs.io/Documentation/Library?id=questionpaneldynamicmodel)
+  * - [*"radiogroup"*](https://surveyjs.io/Documentation/Library?id=questionradiogroupmodel)
+  * - [*"rating"*](https://surveyjs.io/Documentation/Library?id=questionratingmodel)
+  * - [*"ranking"*](https://surveyjs.io/Documentation/Library?id=questionrankingmodel)
+  * - [*"signaturepad"*](https://surveyjs.io/Documentation/Library?id=questionsignaturepadmodel)
+  * - [*"text"*](https://surveyjs.io/Documentation/Library?id=questiontextmodel)
   */
   getType(): string;
   getSurvey(isLive?: boolean): ISurvey;
@@ -1315,7 +1311,7 @@ export declare class Action extends Base implements IAction {
   component: string;
   items: any;
   visibleIndex: number;
-  mode: "popup" | "large" | "small";
+  mode: any;
   disableTabStop: boolean;
   disableShrink: boolean;
   needSpace: boolean;
@@ -1347,6 +1343,7 @@ export declare class ActionContainer<T extends Action = Action> extends Base {
   get visibleActions(): any;
   getRootCss(): string;
   get cssClasses(): any;
+  addAction(val: IAction, sortByVisibleIndex?: boolean): Action;
   setItems(items: any, sortByVisibleIndex?: boolean): void;
   initResponsivityManager(container: any): void;
   resetResponsivityManager(): void;
@@ -1589,6 +1586,7 @@ export declare class ExceedSizeError extends SurveyError {
   getDefaultText(): string;
 }
 export declare class ExpressionExecutor implements IExpresionExecutor {
+  constructor(expression: string);
   static createExpressionExecutor: any;
   onComplete: any;
   expressionValue: string;
@@ -1599,7 +1597,6 @@ export declare class ExpressionExecutor implements IExpresionExecutor {
   hasFunctionValue: boolean;
   asyncFuncList: any;
   get expression(): string;
-  set expression(val: string);
   getVariables(): Array<any>;
   hasFunction(): boolean;
   get isAsync(): boolean;
@@ -2616,13 +2613,16 @@ export declare class AdaptiveActionContainer<T extends Action = Action> extends
   protected dotsItemPopupModel: any;
   responsivityManager: ResponsivityManager;
   minVisibleItemsCount: number;
+  isResponsivenessDisabled: boolean;
   protected invisibleItemsListModel: ListModel;
   protected onSet(): void;
   protected onPush(item: T): void;
   protected getRenderedActions(): Array<T>;
+  protected raiseUpdate(isResetInitialized: boolean): void;
   fit(dimension: number, dotsItemSize: number): void;
   initResponsivityManager(container: any): void;
   resetResponsivityManager(): void;
+  setActionsMode(mode: any): void;
   dispose(): void;
 }
 export declare class AnswerCountValidator extends SurveyValidator {
@@ -3117,6 +3117,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   localeValue: string;
   textPreProcessor: TextPreProcessor;
   timerModelValue: SurveyTimerModel;
+  navigationBarValue: any;
   /*
   * The event is fired before the survey is completed and the `onComplete` event is fired. You can prevent the survey from completing by setting `options.allowComplete` to `false`
   * <br/> `sender` - the survey object that fires the event.
@@ -3778,7 +3779,8 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   get cssNavigationStart(): string;
   get cssNavigationNext(): string;
   get bodyCss(): string;
-  get completedCss(): string;
+  completedCss: string;
+  containerCss: string;
   get completedStateCss(): string;
   getCompletedStateCss(): string;
   lazyRenderingValue: boolean;
@@ -4089,6 +4091,12 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   get loadingHtml(): string;
   set loadingHtml(val: string);
   get locLoadingHtml(): LocalizableString;
+  get navigationBar(): any;
+  /*
+  * Adds a custom navigation item similar to the Previous Page, Next Page, and Complete buttons.
+  * Accepts an object described in the [IAction](https://surveyjs.io/Documentation/Library?id=IAction) help section.
+  */
+  addNavigationItem(val: IAction): Action;
   /*
   * Gets or sets the 'Start' button caption.
   * The 'Start' button is shown on the started page. Set the `firstPageIsStarted` property to `true`, to display the started page.
@@ -4580,6 +4588,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   isCalculatingProgressText: boolean;
   updateProgressText(onValueChanged?: boolean): void;
   getProgressText(): string;
+  rootCss: string;
   getRootCss(): string;
   resizeObserver: any;
   afterRenderSurvey(htmlElement: any): void;
@@ -4734,6 +4743,10 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   setJsonObject(jsonObj: any): void;
   isEndLoadingFromJson: string;
   endLoadingFromJson(): void;
+  updateNavigationItemTitlesCallback: any;
+  updateNavigationItemCssCallback: any;
+  protected createNavigationBar(): ActionContainer;
+  protected createNavigationActions(): Array<IAction>;
   protected onBeforeCreating(): void;
   protected onCreating(): void;
   getBuiltInVariableValue(name: string): number;
@@ -4896,6 +4909,9 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
   setTriggerValue(name: string, value: any, isVariable: boolean): void;
   copyTriggerValue(name: string, fromName: string): void;
   isFocusingQuestion: boolean;
+  isMovingQuestion: boolean;
+  startMovingQuestion(): void;
+  stopMovingQuestion(): void;
   /*
   * Focus question by its name. If needed change the current page on the page where question is located.
   * Function returns false if there is no question with this name or question is invisible, otherwise it returns true.
@@ -5009,7 +5025,28 @@ export declare class PanelModelBase extends SurveyElement implements IPanel, ICo
   removeElementCallback: any;
   onGetQuestionTitleLocation: any;
   /*
-  * Returns the type of the object as a string as it represents in the json. It should be in lowcase.
+  * Returns the question type.
+  * Possible values:
+  * - [*"boolean"*](https://surveyjs.io/Documentation/Library?id=questionbooleanmodel)
+  * - [*"checkbox"*](https://surveyjs.io/Documentation/Library?id=questioncheckboxmodel)
+  * - [*"comment"*](https://surveyjs.io/Documentation/Library?id=questioncommentmodel)
+  * - [*"dropdown"*](https://surveyjs.io/Documentation/Library?id=questiondropdownmodel)
+  * - [*"expression"*](https://surveyjs.io/Documentation/Library?id=questionexpressionmodel)
+  * - [*"file"*](https://surveyjs.io/Documentation/Library?id=questionfilemodel)
+  * - [*"html"*](https://surveyjs.io/Documentation/Library?id=questionhtmlmodel)
+  * - [*"image"*](https://surveyjs.io/Documentation/Library?id=questionimagemodel)
+  * - [*"imagepicker"*](https://surveyjs.io/Documentation/Library?id=questionimagepickermodel)
+  * - [*"matrix"*](https://surveyjs.io/Documentation/Library?id=questionmatrixmodel)
+  * - [*"matrixdropdown"*](https://surveyjs.io/Documentation/Library?id=questionmatrixdropdownmodel)
+  * - [*"matrixdynamic"*](https://surveyjs.io/Documentation/Library?id=questionmatrixdynamicmodel)
+  * - [*"multipletext"*](https://surveyjs.io/Documentation/Library?id=questionmultipletextmodel)
+  * - [*"panel"*](https://surveyjs.io/Documentation/Library?id=panelmodel)
+  * - [*"paneldynamic"*](https://surveyjs.io/Documentation/Library?id=questionpaneldynamicmodel)
+  * - [*"radiogroup"*](https://surveyjs.io/Documentation/Library?id=questionradiogroupmodel)
+  * - [*"rating"*](https://surveyjs.io/Documentation/Library?id=questionratingmodel)
+  * - [*"ranking"*](https://surveyjs.io/Documentation/Library?id=questionrankingmodel)
+  * - [*"signaturepad"*](https://surveyjs.io/Documentation/Library?id=questionsignaturepadmodel)
+  * - [*"text"*](https://surveyjs.io/Documentation/Library?id=questiontextmodel)
   */
   getType(): string;
   setSurveyImpl(value: ISurveyImpl, isLight?: boolean): void;
@@ -5679,9 +5716,10 @@ export declare class Question extends SurveyElement implements IQuestion, ICondi
   getQuestionFromArray(name: string, index: number): IQuestion;
   getDefaultValue(): any;
   protected isDefaultValueEmpty(): boolean;
+  protected getDefaultRunner(runner: ExpressionRunner, expression: string): ExpressionRunner;
   protected setDefaultValue(): void;
   protected isValueExpression(val: any): boolean;
-  protected setValueAndRunExpression(expression: string, defaultValue: any, setFunc: any, values?: any, properties?: any): void;
+  protected setValueAndRunExpression(runner: ExpressionRunner, defaultValue: any, setFunc: any, values?: any, properties?: any): void;
   /*
   * The question comment value.
   */
@@ -7101,6 +7139,8 @@ export declare class QuestionSelectBase extends Question {
   protected get activeChoices(): any;
   protected getChoicesFromQuestion(question: QuestionSelectBase): Array<ItemValue>;
   protected get hasActiveChoices(): boolean;
+  protected isHeadChoice(item: ItemValue, question: QuestionSelectBase): boolean;
+  protected isFootChoice(item: ItemValue, question: QuestionSelectBase): boolean;
   protected isBuiltInChoice(item: ItemValue, question: QuestionSelectBase): boolean;
   protected getChoices(): Array<ItemValue>;
   supportComment(): boolean;
@@ -7802,6 +7842,8 @@ export declare class QuestionMatrixModel extends QuestionMatrixBaseModel<MatrixR
 export declare class QuestionTextModel extends QuestionTextBase {
   constructor(name: string);
   locDataListValue: LocalizableStrings;
+  minValueRunner: ExpressionRunner;
+  maxValueRunner: ExpressionRunner;
   protected isTextValue(): boolean;
   getType(): string;
   onSurveyLoad(): void;
@@ -7964,7 +8006,7 @@ export declare class QuestionCheckboxModel extends QuestionCheckboxBase {
   protected canUseFilteredChoices(): boolean;
   protected supportSelectAll(): boolean;
   protected addToVisibleChoices(items: any, isAddAll: boolean): void;
-  protected isBuiltInChoice(item: ItemValue, question: QuestionSelectBase): boolean;
+  protected isHeadChoice(item: ItemValue, question: QuestionSelectBase): boolean;
   /*
   * For internal use in SurveyJS Creator V2.
   */
@@ -8123,6 +8165,7 @@ export declare class QuestionMatrixDynamicModel extends QuestionMatrixDropdownMo
   */
   get allowRowsDragAndDrop(): boolean;
   set allowRowsDragAndDrop(val: boolean);
+  get iconDragElement(): string;
   protected createRenderedTable(): QuestionMatrixDropdownRenderedTable;
   /*
   * The minimum row count. A user could not delete a row if the rowCount equals to minRowCount
@@ -8474,6 +8517,7 @@ export declare var settings: {
   maxDate: string,
   showModal: any,
   supportCreatorV2: boolean,
+  showDefaultItemsInCreatorV2: boolean,
   /*
   * Specifies a list of custom icons.
   * Use this property to replace SurveyJS default icons (displayed in UI elements of SurveyJS Library or Creator) with your custom icons.
@@ -8844,6 +8888,9 @@ export declare var defaultStandardCss: {
       buttonCollapsed: string,
     },
   },
+  variables: {
+    themeMark: string,
+  },
 };
 export declare var surveyTimerFunctions: {
   setTimeout: any,
@@ -9792,6 +9839,9 @@ export declare var defaultV2Css: {
     itemText: string,
     clearButton: string,
     other: string,
+    itemNoImage: string,
+    itemNoImageSvgIcon: string,
+    itemNoImageSvgIconId: string,
   },
   matrix: {
     mainRoot: string,
@@ -9852,6 +9902,8 @@ export declare var defaultV2Css: {
     buttonRemove: string,
     iconAdd: string,
     iconRemove: string,
+    dragElementDecorator: string,
+    iconDragElement: string,
     footer: string,
     emptyRowsSection: string,
     iconDrag: string,
@@ -9976,6 +10028,7 @@ export declare var defaultV2Css: {
   },
   variables: {
     mobileWidth: string,
+    themeMark: string,
   },
 };
 export declare var modernCss: {
@@ -10346,6 +10399,9 @@ export declare var modernCss: {
       buttonCollapsed: string,
     },
   },
+  variables: {
+    themeMark: string,
+  },
 };
 export declare var SvgRegistry: SvgIconRegistry;
 export declare var SvgBundleViewModel: any;