survey-core 1.9.117 → 1.9.119

package/typings/notifier.d.ts

@@ -1,6 +1,15 @@
 import { Base } from "./base";
 import { ActionContainer } from "./actions/container";
 import { IAction } from "./actions/action";
+interface INotifierCssClasses {
+    root: string;
+    rootWithButtons: string;
+    info: string;
+    error: string;
+    success: string;
+    button: string;
+    shown: string;
+}
 export declare class Notifier extends Base {
     private cssClasses;
     active: boolean;
@@ -12,16 +21,10 @@ export declare class Notifier extends Base {
     private actionsVisibility;
     actionBar: ActionContainer;
     showActions: boolean;
-    constructor(cssClasses: {
-        root: string;
-        info: string;
-        error: string;
-        success: string;
-        button: string;
-        shown: string;
-    });
+    constructor(cssClasses: INotifierCssClasses);
     getCssClass(type: string): string;
     updateActionsVisibility(type: string): void;
     notify(message: string, type?: string, waitUserAction?: boolean): void;
     addAction(action: IAction, notificationType: string): void;
 }
+export {};

package/typings/page.d.ts

@@ -53,6 +53,7 @@ export declare class PageModel extends PanelModelBase implements IPage {
     protected calcCssClasses(css: any): any;
     get cssTitle(): string;
     get cssRoot(): string;
+    protected getCssError(cssClasses: any): string;
     num: number;
     /**
      * Set this property to "hide" to make "Prev", "Next" and "Complete" buttons are invisible for this page. Set this property to "show" to make these buttons visible, even if survey showNavigationButtons property is false.

package/typings/panel.d.ts

@@ -412,6 +412,8 @@ export declare class PanelModelBase extends SurveyElement<Question> implements I
     set questionErrorLocation(val: string);
     getQuestionErrorLocation(): string;
     get no(): string;
+    get cssError(): string;
+    protected getCssError(cssClasses: any): string;
     dispose(): void;
 }
 /**
@@ -492,6 +494,7 @@ export declare class PanelModel extends PanelModelBase implements IElement {
      */
     get no(): string;
     protected setNo(visibleIndex: number): void;
+    protected notifyStateChanged(): void;
     protected createLocTitleProperty(): LocalizableString;
     protected beforeSetVisibleIndex(index: number): number;
     protected getPanelStartIndex(index: number): number;
@@ -524,7 +527,6 @@ export declare class PanelModel extends PanelModelBase implements IElement {
     get hasEditButton(): boolean;
     cancelPreview(): void;
     get cssTitle(): string;
-    get cssError(): string;
     get showErrorsAbovePanel(): boolean;
     protected getCssError(cssClasses: any): string;
     protected onVisibleChanged(): void;
@@ -532,6 +534,7 @@ export declare class PanelModel extends PanelModelBase implements IElement {
     focusIn(): void;
     protected getHasFrameV2(): boolean;
     protected getIsNested(): boolean;
+    private get showPanelAsPage();
     protected getCssRoot(cssClasses: {
         [index: string]: string;
     }): string;

package/typings/question.d.ts

@@ -363,7 +363,6 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
     get isContainer(): boolean;
     protected updateCommentElements(): void;
     onCommentInput(event: any): void;
-    onCompositionUpdateComment(event: any): void;
     onCommentChange(event: any): void;
     afterRenderQuestionElement(el: HTMLElement): void;
     afterRender(el: HTMLElement): void;
@@ -478,6 +477,7 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
      * @see otherItem
      * @see otherErrorText
      * @see showCommentArea
+     * @see [settings.specialChoicesOrder](https://surveyjs.io/form-library/documentation/api-reference/settings#specialChoicesOrder)
      */
     get showOtherItem(): boolean;
     set showOtherItem(val: boolean);
@@ -630,6 +630,8 @@ export declare class Question extends SurveyElement<Question> implements IQuesti
      * - `{row.other_question_name}` (to access questions inside the same dynamic matrix or multi-column dropdown)
      *
      * An expression can also include built-in and custom functions for advanced calculations. For example, if the `defaultValue` should be today's date, set the `defaultValueExpression` to `"today()"`, and the corresponding built-in function will be executed each time the survey is loaded. Refer to the following help topic for more information: [Built-In Functions](https://surveyjs.io/form-library/documentation/design-survey-conditional-logic#built-in-functions).
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/specify-default-question-value-dynamically (linkStyle))
      * @see defaultValue
      * @see setValueExpression
      */

package/typings/question_baseselect.d.ts

@@ -62,6 +62,7 @@ export declare class QuestionSelectBase extends Question {
      * When users select the "None" item in multi-select questions, all other items become unselected.
      * @see noneItem
      * @see noneText
+     * @see [settings.specialChoicesOrder](https://surveyjs.io/form-library/documentation/api-reference/settings#specialChoicesOrder)
      */
     get showNoneItem(): boolean;
     set showNoneItem(val: boolean);
@@ -166,6 +167,7 @@ export declare class QuestionSelectBase extends Question {
      *
      * [View Demo](https://surveyjs.io/form-library/examples/questiontype-dropdownrestfull/ (linkStyle))
      * @see choices
+     * @see [settings.specialChoicesOrder](https://surveyjs.io/form-library/documentation/api-reference/settings#specialChoicesOrder)
      */
     get choicesByUrl(): ChoicesRestful;
     set choicesByUrl(val: ChoicesRestful);
@@ -188,6 +190,7 @@ export declare class QuestionSelectBase extends Question {
      * If you need to specify only the `value` property, you can set the `choices` property to an array of primitive values, for example, `[ "item1", "item2", "item3" ]`. These values are both saved in survey results and used as display text.
      * @see choicesByUrl
      * @see choicesFromQuestion
+     * @see [settings.specialChoicesOrder](https://surveyjs.io/form-library/documentation/api-reference/settings#specialChoicesOrder)
      */
     get choices(): Array<any>;
     set choices(newValue: Array<any>);
@@ -259,6 +262,7 @@ export declare class QuestionSelectBase extends Question {
      * - `"asc"`- Sorts choice items in ascending order.
      * - `"desc"`- Sorts choice items in ascending order.
      * - `"random"` - Displays choice items in random order.
+     * @see [settings.specialChoicesOrder](https://surveyjs.io/form-library/documentation/api-reference/settings#specialChoicesOrder)
      */
     get choicesOrder(): string;
     set choicesOrder(val: string);
@@ -273,6 +277,7 @@ export declare class QuestionSelectBase extends Question {
      * Displays the "Select All", "None", and "Other" choices on individual rows.
      * @see showNoneItem
      * @see showOtherItem
+     * @see [settings.specialChoicesOrder](https://surveyjs.io/form-library/documentation/api-reference/settings#specialChoicesOrder)
      */
     separateSpecialChoices: boolean;
     /**
@@ -361,7 +366,6 @@ export declare class QuestionSelectBase extends Question {
     protected getCommentFromValue(newValue: any): string;
     protected setOtherValueIntoValue(newValue: any): any;
     onOtherValueInput(event: any): void;
-    onCompositionUpdateOtherValue(event: any): void;
     onOtherValueChange(event: any): void;
     private isRunningChoices;
     private runChoicesByUrl;

package/typings/question_file.d.ts

@@ -150,7 +150,9 @@ export declare class QuestionFileModel extends Question {
     confirmRemoveAllMessage: string;
     noFileChosenCaption: string;
     chooseButtonCaption: string;
-    takePhotoCaption: string;
+    get takePhotoCaption(): string;
+    set takePhotoCaption(val: string);
+    get locTakePhotoCaption(): LocalizableString;
     replaceButtonCaption: string;
     clearButtonCaption: string;
     removeFileCaption: string;

package/typings/question_matrixdropdownbase.d.ts

@@ -41,6 +41,7 @@ export declare class MatrixDropdownCell {
     data: IMatrixDropdownData;
     private questionValue;
     constructor(column: MatrixDropdownColumn, row: MatrixDropdownRowModelBase, data: IMatrixDropdownData);
+    private updateCellQuestionTitleDueToAccessebility;
     locStrsChanged(): void;
     protected createQuestion(column: MatrixDropdownColumn, row: MatrixDropdownRowModelBase, data: IMatrixDropdownData): Question;
     get question(): Question;
@@ -76,10 +77,12 @@ export declare class MatrixDropdownRowModelBase implements ISurveyData, ISurveyI
     constructor(data: IMatrixDropdownData, value: any);
     get id(): string;
     get rowName(): any;
+    get dataName(): string;
     get text(): any;
     get value(): any;
     set value(value: any);
     get locText(): LocalizableString;
+    getAccessbilityText(): string;
     get hasPanel(): boolean;
     get detailPanel(): PanelModel;
     get detailPanelId(): string;

package/typings/question_matrixdropdowncolumn.d.ts

@@ -15,6 +15,7 @@ export interface IMatrixColumnOwner extends ILocalizableOwner {
     getCellType(): string;
     getCustomCellType(column: MatrixDropdownColumn, row: MatrixDropdownRowModelBase, cellType: string): string;
     onColumnCellTypeChanged(column: MatrixDropdownColumn): void;
+    getCellAriaLabel(rowTitle: string, columnTitle: string): string;
 }
 export declare var matrixDropdownColumnTypes: any;
 export declare class MatrixDropdownColumn extends Base implements ILocalizableOwner, IWrapperObject {

package/typings/question_matrixdynamic.d.ts

@@ -10,6 +10,9 @@ export declare class MatrixDynamicRowModel extends MatrixDropdownRowModelBase im
     private dragOrClickHelper;
     constructor(index: number, data: IMatrixDropdownData, value: any);
     get rowName(): string;
+    get dataName(): string;
+    get text(): any;
+    getAccessbilityText(): string;
     get shortcutText(): string;
 }
 /**

package/typings/question_ranking.d.ts

@@ -89,7 +89,13 @@ export declare class QuestionRankingModel extends QuestionCheckboxModel {
     set selectToRankAreasLayout(val: string);
     get renderedSelectToRankAreasLayout(): string;
     isMobileMode(): boolean;
+    /**
+     * A placeholder displayed in the area for ranked choices. Applies when [`selectToRankEnabled`](https://surveyjs.io/form-library/documentation/api-reference/ranking-question-model#selectToRankEnabled) is `true`.
+     */
     selectToRankEmptyRankedAreaText: string;
+    /**
+     * A placeholder displayed in the area for unranked choices. Applies when [`selectToRankEnabled`](https://surveyjs.io/form-library/documentation/api-reference/ranking-question-model#selectToRankEnabled) is `true`.
+     */
     selectToRankEmptyUnrankedAreaText: string;
     get useFullItemSizeForShortcut(): boolean;
     set useFullItemSizeForShortcut(val: boolean);

package/typings/question_rating.d.ts

@@ -118,6 +118,7 @@ export declare class QuestionRatingModel extends Question {
     itemValuePropertyChanged(item: ItemValue, name: string, oldValue: any, newValue: any): void;
     private createRenderedRateItems;
     renderedRateItems: Array<RenderedRatingItem>;
+    private createRateValues;
     private correctValue;
     getType(): string;
     protected getFirstInputElementId(): string;

package/typings/question_signaturepad.d.ts

@@ -51,7 +51,9 @@ export declare class QuestionSignaturePadModel extends Question {
      *
      * Default value: `false`
      *
-     * > The signature area is scaled only for display. The resulting image will have dimensions specified by the [`signatureHeight`](#signatureHeight) and [`signatureWidth`](#signatureWidth) properties.
+     * This property auto-scales the signature area to fill all available width within the question box while maintaining the default 3:2 aspect ratio. If you set [custom width](#signatureWidth) and [height](#signatureHeight) values, the setting will keep the aspect ratio of these dimensions.
+     *
+     * > The signature area is scaled only for display. The image saved in survey results will have dimensions specified by the [`signatureHeight`](#signatureHeight) and [`signatureWidth`](#signatureWidth) properties.
      */
     signatureAutoScaleEnabled: boolean;
     /**

package/typings/question_textbase.d.ts

@@ -58,9 +58,8 @@ export declare class QuestionTextBase extends Question {
     protected setQuestionValue(newValue: any, updateIsAnswered?: boolean): void;
     protected convertToCorrectValue(val: any): any;
     protected getValueSeparator(): string;
-    disableNativeUndoRedo: boolean;
-    protected checkForUndo(event: KeyboardEvent): void;
     protected getControlCssClassBuilder(): CssClassBuilder;
     getControlClass(): string;
     get isNewA11yStructure(): boolean;
+    onKeyDownPreprocess: (event: any) => void;
 }

package/typings/settings.d.ts

@@ -485,6 +485,27 @@ export declare var settings: {
      * Default value: `"none"`
      */
     noneItemValue: string;
+    /**
+     * An object whose properties specify the order of the special choice items (None, Other, Select All) in select-based questions.
+     *
+     * Default value: `{ selectAllItem: [-1], noneItem: [1], otherItem: [2] }`
+     *
+     * Use this object to reorder special choices. Each property accepts an array of integer numbers. Negative numbers place a special choice item above regular choice items, positive numbers place it below them. For instance, the code below specifies the following order of choices: None, Select All, regular choices, Other.
+     *
+     * ```js
+     * import { settings } from "survey-core";
+     *
+     * settings.specialChoicesOrder.noneItem = [-2];
+     * settings.specialChoicesOrder.selectAllItem = [-1];
+     * settings.specialChoicesOrder.otherItem = [1];
+     * ```
+     *
+     * If you want to duplicate a special choice item above and below other choices, add two numbers to the corresponding array:
+     *
+     * ```js
+     * settings.specialChoicesOrder.selectAllItem = [-1, 3] // Displays Select All above and below other choices
+     * ```
+     */
     specialChoicesOrder: {
         selectAllItem: number[];
         noneItem: number[];

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

@@ -1,6 +1,6 @@
 import { IAction } from "./actions/action";
 import { Base } from "./base";
-import { IElement, ISurveyElement, IValueItemCustomPropValues } from "./base-interfaces";
+import { IElement, IPanel, ISurveyElement, IValueItemCustomPropValues } from "./base-interfaces";
 import { ItemValue } from "./itemvalue";
 import { PageModel } from "./page";
 import { PanelModel, PanelModelBase } from "./panel";
@@ -499,9 +499,9 @@ export interface LoadFilesEvent extends FileQuestionEventMixin {
 }
 export interface UploadFilesEvent extends LoadFilesEvent {
     /**
-     * A callback function that you should call when a file is uploaded successfully or when file upload fails. Pass `"success"` or `"error"` as the first argument to indicate the operation status. As the second argument, you can pass the uploaded file's data if file upload was successful or an error message if file upload failed.
+     * A callback function that you should call when a file is uploaded successfully or when file upload fails. Pass an array of successfully uploaded files as the first argument. As the second argument, you can pass an array of error messages if file upload failed.
      */
-    callback: (status: string, data?: any) => any;
+    callback: (data: any | Array<any>, errors?: any | Array<any>) => any;
     /**
      * An array of JavaScript <a href="https://developer.mozilla.org/en-US/docs/Web/API/File" target="_blank">File</a> objects that represent files to upload.
      */
@@ -858,27 +858,39 @@ export interface DragDropAllowEvent {
     /**
      * A survey element being dragged.
      */
-    target: IElement;
+    draggedElement: IElement;
     /**
-     * A survey element from which `target` is being dragged. This parameter is `null` if `target` is being dragged from the [Toolbox](https://surveyjs.io/survey-creator/documentation/toolbox).
+     * A survey element from which `draggedElement` is being dragged. This parameter is `null` if `draggedElement` is being dragged from the [Toolbox](https://surveyjs.io/survey-creator/documentation/toolbox).
      */
-    source: IElement;
+    fromElement: IPanel;
+    /**
+     * A survey element to which `draggedElement` is being dragged.
+     */
+    toElement: IElement;
     /**
      * A survey element before which the target element will be placed. This parameter is `null` if the parent container (page or panel) has no elements or if the target element will be placed below all other elements within the container.
      */
     insertBefore: IElement;
     /**
-     * A survey element after which `target` will be placed. This parameter is `null` if the parent container (page or panel) has no elements or if `target` will be placed above all other elements within the container.
+     * A survey element after which `draggedElement` will be placed. This parameter is `null` if the parent container (page or panel) has no elements or if `draggedElement` will be placed above all other elements within the container.
      */
     insertAfter: IElement;
     /**
-     * A parent container (page or panel) within which `target` will be placed.
+     * A parent container (page or panel) within which `draggedElement` will be placed.
      */
     parent: ISurveyElement;
     /**
      * A Boolean property that you can set to `false` if you want to cancel the drag and drop operation.
      */
     allow: boolean;
+    /**
+     * Obsolete. Use `options.draggedElement` instead.
+     */
+    target: IElement;
+    /**
+     * Obsolete. Use `options.toElement` instead.
+     */
+    source: IElement;
 }
 export interface ScrollingElementToTopEvent {
     /**

package/typings/survey.d.ts

@@ -25,6 +25,7 @@ import { QuestionFileModel } from "./question_file";
 import { QuestionMultipleTextModel } from "./question_multipletext";
 import { ITheme, ImageFit, ImageAttachment } from "./themes";
 import { PopupModel } from "./popup";
+import { Cover } from "./header";
 /**
  * The `SurveyModel` object contains properties and methods that allow you to control the survey and access its elements.
  *
@@ -750,8 +751,11 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      *
      * - `"advanced"`\
      * An advanced header view applies the same properties as the basic view, plus [header settings](https://surveyjs.io/form-library/documentation/api-reference/iheader) from the [survey theme](https://surveyjs.io/form-library/documentation/api-reference/itheme#header). The advanced view features a more flexible header layout, a capability to specify a background image, and other settings that give a more professional look to the survey header.
+     *
+     * [View Demo](https://surveyjs.io/form-library/examples/brand-your-survey-header/ (linkStyle))
      */
     headerView: "advanced" | "basic";
+    protected insertAdvancedHeader(advHeader: Cover): void;
     private getNavigationCss;
     private lazyRenderingValue;
     showBrandInfo: boolean;
@@ -947,7 +951,8 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * Specifies whether to hide validation errors thrown by the Required validation in the UI.
      *
      * [Built-In Client-Side Validators](https://surveyjs.io/form-library/documentation/data-validation#built-in-client-side-validators (linkStyle))
-     * @see ignoreValidation
+     * @see validationEnabled
+     * @see validationAllowSwitchPages
      */
     hideRequiredErrors: boolean;
     beforeSettingQuestionErrors(question: Question, errors: Array<SurveyError>): void;
@@ -1020,6 +1025,10 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * - `"onComplete"` - Triggers validation when a user clicks the Complete button. If previous pages contain errors, the survey switches to the page with the first error.
      *
      * Refer to the following help topic for more information: [Data Validation](https://surveyjs.io/form-library/documentation/data-validation).
+     * @see validationEnabled
+     * @see validationAllowSwitchPages
+     * @see validationAllowComplete
+     * @see validate
      */
     get checkErrorsMode(): string;
     set checkErrorsMode(val: string);
@@ -1679,6 +1688,16 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     get completedState(): string;
     get completedStateText(): string;
     protected setCompletedState(value: string, text: string): void;
+    /**
+     * Displays a toast notification with a specified message.
+     *
+     * Depending on the `type` argument, a survey can display the following notification types:
+     *
+     * ![Toast notification types in SurveyJS Form Library](https://surveyjs.io//Content/Images/docs/notification-types.png)
+     * @param message A message to display.
+     * @param type A notification type: `"info"` (default), `"success"`, or `"error"`.
+     * @param showActions For internal use.
+     */
     notify(message: string, type: string, showActions?: boolean): void;
     /**
      * Resets the survey [`state`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#state) and, optionally, [`data`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#data). If `state` is `"completed"`, it becomes `"running"`.
@@ -1744,15 +1763,32 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      */
     deleteCookie(): void;
     /**
-     * Specifies whether to skip validation when you switch between pages or complete the survey programmatically or when users do that in the UI.
+     * This property is obsolete. Use the [`validationEnabled`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#validationEnabled) property instead.
+     */
+    get ignoreValidation(): boolean;
+    set ignoreValidation(val: boolean);
+    /**
+     * Specifies whether data validation is enabled.
      *
-     * Default value: `false`
+     * Default value: `true`
+     * @see checkErrorsMode
      * @see hideRequiredErrors
-     * @see nextPage
-     * @see isPrevPage
-     * @see completeLastPage
      */
-    ignoreValidation: boolean;
+    validationEnabled: boolean;
+    /**
+     * Specifies whether respondents can switch the current page even if it contains validation errors.
+     *
+     * Default value: `false`
+     * @see checkErrorsMode
+     */
+    validationAllowSwitchPages: boolean;
+    /**
+     * Specifies whether respondents can end a survey with validation errors.
+     *
+     * Default value: `false`
+     * @see checkErrorsMode
+     */
+    validationAllowComplete: boolean;
     /**
      * Switches the survey to the next page.
      *
@@ -1905,7 +1941,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     private runningPages;
     private onShowingPreviewChanged;
     private changeCurrentPageFromPreview;
-    private origionalPages;
+    private originalPages;
     protected onQuestionsOnPageModeChanged(oldValue: string): void;
     private restoreOriginalPages;
     private getPageStartIndex;
@@ -2100,11 +2136,11 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
      * @param question A [File Upload question instance](https://surveyjs.io/form-library/documentation/api-reference/file-model).
      * @param name The File Upload question's [`name`](https://surveyjs.io/form-library/documentation/api-reference/file-model#name).
      * @param files An array of JavaScript <a href="https://developer.mozilla.org/en-US/docs/Web/API/File" target="_blank">File</a> objects that represent files to upload.
-     * @param callback A callback function that allows you to get the upload status (`"success"` or `"error"`) and file data.
+     * @param callback A callback function that allows you to access successfully uploaded files as the first argument. If any files fail to upload, the second argument contains an array of error messages.
      * @see onUploadFiles
      * @see downloadFile
      */
-    uploadFiles(question: QuestionFileModel, name: string, files: File[], callback: (status: string, data: any) => any): void;
+    uploadFiles(question: QuestionFileModel, name: string, files: File[], callback: (data: any | Array<any>, errors?: any | Array<any>) => any): void;
     /**
      * Downloads a file from a server.
      *
@@ -2140,7 +2176,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     updateChoicesFromServer(question: QuestionSelectBase, choices: Array<ItemValue>, serverResult: any): Array<ItemValue>;
     loadedChoicesFromServer(question: IQuestion): void;
     protected createSurveyService(): dxSurveyService;
-    protected uploadFilesCore(name: string, files: File[], uploadingCallback: (status: string, data: any) => any): void;
+    protected uploadFilesCore(name: string, files: File[], uploadingCallback: (data: any | Array<any>, errors?: any | Array<any>) => any): void;
     getPage(index: number): PageModel;
     /**
      * Adds an existing page to the survey.
@@ -2643,6 +2679,7 @@ export declare class SurveyModel extends SurveyElementCore implements ISurvey, I
     private isMovingQuestion;
     startMovingQuestion(): void;
     stopMovingQuestion(): void;
+    get isQuestionDragging(): boolean;
     private needRenderIcons;
     private skippedPages;
     /**

package/typings/surveyStrings.d.ts

@@ -57,6 +57,7 @@ export declare var surveyStrings: {
     urlRequestError: string;
     urlGetChoicesError: string;
     exceedMaxSize: string;
+    noUploadFilesHandler: string;
     otherRequiredError: string;
     uploadingFile: string;
     loadingFile: string;

package/typings/themes.d.ts

@@ -83,9 +83,9 @@ export interface IHeader {
      *
      * Possible values:
      *
-     * - `"survey"` (default)\
+     * - `"survey"`\
      * The header width is the same as the survey width.
-     * - `"container"`\
+     * - `"container"` (default)\
      * The header width is the same as the survey container width.
      *
      * @see [SurveyModel.width](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model#width)