survey-creator-core 1.11.6 → 1.11.7

package/typings/components/tabs/theme-plugin.d.ts

@@ -20,6 +20,8 @@ import { ThemeModel } from "./theme-model";
  * const creator = new SurveyCreatorModel(creatorOptions);
  * creator.themeEditor.settingName = "value";
  * ```
+ *
+ * [Theme Editor Documentation](https://surveyjs.io/survey-creator/documentation/theme-editor (linkStyle))
  */
 export declare class ThemeTabPlugin implements ICreatorPlugin {
     private creator;

package/typings/creator-base.d.ts

@@ -14,7 +14,7 @@ import { ICreatorOptions } from "./creator-options";
 import { ThemeTabPlugin } from "./components/tabs/theme-plugin";
 import { DragDropSurveyElements } from "./survey-elements";
 import { PageAdorner } from "./components/page";
-import { ElementDeletingEvent, PropertyGetReadOnlyEvent, ElementGetDisplayNameEvent, HtmlToMarkdownEvent, ElementAllowOperationsEvent, ElementGetActionsEvent, PropertyAddingEvent, PropertyGridSurveyCreatedEvent, PropertyEditorCreatedEvent, PropertyEditorUpdateTitleActionsEvent, PropertyGridShowPopupEvent, CollectionItemAllowOperationsEvent, CollectionItemAddedEvent, FastEntryItemsEvent as FastEntryFinishedEvent, MatrixColumnAddedEvent, ConfigureTablePropertyEditorEvent, PropertyDisplayCustomErrorEvent, PropertyValueChangingEvent, PropertyValueChangedEvent, ConditionGetQuestionListEvent, GetConditionOperatorEvent, LogicRuleGetDisplayTextEvent, ModifiedEvent, QuestionAddedEvent, PanelAddedEvent, PageAddedEvent, PageGetFooterActionsEvent, SurveyInstanceCreatedEvent, DesignerSurveyCreatedEvent, PreviewSurveyCreatedEvent, NotifyEvent, ElementFocusingEvent, ElementFocusedEvent, OpenFileChooserEvent, UploadFileEvent, TranslationStringVisibilityEvent, TranslationImportItemEvent, TranslationImportedEvent, TranslationExportItemEvent, MachineTranslateEvent, TranslationItemChangingEvent, DragDropAllowEvent, CreateCustomMessagePanelEvent, ActiveTabChangingEvent, ActiveTabChangedEvent, BeforeUndoEvent, BeforeRedoEvent, PageAddingEvent, DragStartEndEvent } from "./creator-events-api";
+import { ElementDeletingEvent, PropertyGetReadOnlyEvent, ElementGetDisplayNameEvent, HtmlToMarkdownEvent, ElementAllowOperationsEvent, ElementGetActionsEvent, PropertyAddingEvent, PropertyGridSurveyCreatedEvent, PropertyEditorCreatedEvent, PropertyEditorUpdateTitleActionsEvent, PropertyGridShowPopupEvent, CollectionItemAllowOperationsEvent, CollectionItemAddedEvent, FastEntryItemsEvent as FastEntryFinishedEvent, MatrixColumnAddedEvent, ConfigureTablePropertyEditorEvent, PropertyDisplayCustomErrorEvent, PropertyValueChangingEvent, PropertyValueChangedEvent, ConditionGetQuestionListEvent, GetConditionOperatorEvent, LogicRuleGetDisplayTextEvent, ModifiedEvent, QuestionAddedEvent, PanelAddedEvent, PageAddedEvent, QuestionConvertingEvent, PageGetFooterActionsEvent, SurveyInstanceCreatedEvent, DesignerSurveyCreatedEvent, PreviewSurveyCreatedEvent, NotifyEvent, ElementFocusingEvent, ElementFocusedEvent, OpenFileChooserEvent, UploadFileEvent, TranslationStringVisibilityEvent, TranslationImportItemEvent, TranslationImportedEvent, TranslationExportItemEvent, MachineTranslateEvent, TranslationItemChangingEvent, DragDropAllowEvent, CreateCustomMessagePanelEvent, ActiveTabChangingEvent, ActiveTabChangedEvent, BeforeUndoEvent, BeforeRedoEvent, PageAddingEvent, DragStartEndEvent } from "./creator-events-api";
 export interface IKeyboardShortcut {
     name?: string;
     affectedTab?: string;
@@ -146,7 +146,7 @@ export declare class SurveyCreatorModel extends Base implements ISurveyCreatorOp
      *
      * Default value: `false`
      *
-     * If you enable this property, Survey Creator calls the [`saveSurveyFunc`](#saveSurveyFunc) or [`saveThemeFunc`](#saveThemeFunc) function to save the survey or theme JSON schema. The schemas are saved with a 500-millisecond delay after users change settings. You can specify the [`autoSaveDelay`](#autoSaveDelay) property to increase or descrease the delay.
+     * If you enable this property, Survey Creator calls the [`saveSurveyFunc`](#saveSurveyFunc) or [`saveThemeFunc`](#saveThemeFunc) function to save the survey or theme JSON schema. The schemas are saved with a 500-millisecond delay after users change settings. You can specify the [`autoSaveDelay`](#autoSaveDelay) property to increase or decrease the delay.
      */
     isAutoSave: boolean;
     showOptions: boolean;
@@ -403,6 +403,10 @@ export declare class SurveyCreatorModel extends Base implements ISurveyCreatorOp
      * [Customize Survey Elements on Creation](https://surveyjs.io/survey-creator/documentation/customize-survey-creation-process#customize-survey-elements-on-creation (linkStyle))
      */
     onPageAdded: EventBase<SurveyCreatorModel, PageAddedEvent>;
+    /**
+     * An event that is raised when a [question's type is being changed](https://surveyjs.io/survey-creator/documentation/end-user-guide/user-interface#how-to-change-the-question-type).
+     */
+    onQuestionConverting: EventBase<SurveyCreatorModel, QuestionConvertingEvent>;
     /**
      * An event that is raised when Survey Creator renders action buttons under each page on the design surface. Use this event to add, remove, or modify the buttons.
      * @see onDefineElementMenuItems
@@ -847,6 +851,11 @@ export declare class SurveyCreatorModel extends Base implements ISurveyCreatorOp
     private canSwitchViewType;
     private activatePlugin;
     private get currentPlugin();
+    /**
+     * Provides access to the [Toolbox API](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox).
+     *
+     * [Toolbox Customization](https://surveyjs.io/survey-creator/documentation/toolbox-customization (linkStyle))
+     */
     toolbox: QuestionToolbox;
     get toolboxCategories(): Array<any>;
     sidebar: SidebarModel;
@@ -1013,6 +1022,7 @@ export declare class SurveyCreatorModel extends Base implements ISurveyCreatorOp
     private getDefaultSurveyJson;
     protected setSurvey(survey: SurveyModel): void;
     private getSurveyTextFromDesigner;
+    private moveElementsToTheEnd;
     protected setTextValue(value: string): void;
     changeText(value: string, clearState?: boolean): void;
     /**
@@ -1093,12 +1103,12 @@ export declare class SurveyCreatorModel extends Base implements ISurveyCreatorOp
     createNewElement(json: any): IElement;
     copyElement(element: Base): IElement;
     /**
-     * Creates a copy of a specified question, inserts the copy next to this question and optionally select it in the designer.
+     * Creates a copy of a specified question, inserts the copy next to this question, and (optionally) selects it on the design surface.
      * @param question A question to copy.
-     * @param selectNewElement Select a new element if true
+     * @param selectCopy *(Optional)* Pass `true` if you want to select the copy on the design surface. Default value: `false`.
      * @returns The instance of a new question.
      */
-    fastCopyQuestion(question: Base, selectNewElement?: boolean): IElement;
+    fastCopyQuestion(question: Base, selectCopy?: boolean): IElement;
     /**
      * Gets or sets the focused survey element: a question, panel, page, or the survey itself.
      * @see onSelectedElementChanging

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

@@ -423,29 +423,21 @@ export interface LogicRuleGetDisplayTextEvent {
 }
 export interface ModifiedEvent {
     /**
-    * A value that indicates the modification: `"ADDED_FROM_TOOLBOX"`, `"PAGE_ADDED"`, `"PAGE_MOVED"`, `"QUESTION_CONVERTED"`, `"QUESTION_CHANGED_BY_EDITOR"`, `"PROPERTY_CHANGED"`, `"ELEMENT_REORDERED"`, `"OBJECT_DELETED"`, `"VIEW_TYPE_CHANGED"`, `"DO_DROP"`, `"TRANSLATIONS_CHANGED"`, `"JSON_EDITOR"`, `"THEME_MODIFIED"`
+    * A value that indicates the modification: `"ADDED_FROM_TOOLBOX"`, "ADDED_FROM_PAGEBUTTON", `"PAGE_ADDED"`, `"QUESTION_CONVERTED"`, `"ELEMENT_COPIED"`, `"PROPERTY_CHANGED"`, `"ELEMENT_REORDERED"`, `"OBJECT_DELETED"`, `"JSON_EDITOR"`
     *
     * Depending on the `options.type` value, the `options` object contains parameters listed below:
     *
-    * `options.type`: `"ADDED_FROM_TOOLBOX"`
-    * - `options.question` - An added question.
+    * `options.type`: `"ADDED_FROM_TOOLBOX"` | `"ADDED_FROM_PAGEBUTTON"` | `"ELEMENT_COPIED"`
+    * - `options.question` - An added or copied survey element.
     *
     * `options.type`: `"PAGE_ADDED"`
     * - `options.newValue` - An added page.
     *
-    * `options.type`: `"PAGE_MOVED"`
-    * - `options.page` - A moved page.
-    * - `options.indexFrom` - A previous index.
-    * - `options.indexTo` - A current index.
-    *
     * `options.type`: `"QUESTION_CONVERTED"`
     * - `options.className` - The name of a class to which a question has been converted.
     * - `options.oldValue` - An object of a previous class.
     * - `options.newValue` - An object of a class specified by `options.className`.
     *
-    * `options.type`: `"QUESTION_CHANGED_BY_EDITOR"`
-    * - `options.question` - A question that has been edited in a pop-up editor.
-    *
     * `options.type`: `"PROPERTY_CHANGED"`
     * - `options.name` - The name of the changed property.
     * - `options.target` - An object that contains the changed property.
@@ -461,15 +453,6 @@ export interface ModifiedEvent {
     *
     * `options.type`: `"OBJECT_DELETED"`
     * - `options.target` - A deleted object.
-    *
-    * `options.type`: `"VIEW_TYPE_CHANGED"`
-    * - `options.newType` - A current view: `"editor"` or `"designer"`.
-    *
-    * `options.type`: `"DO_DROP"`
-    * - `options.page` - A parent page of the dragged element.
-    * - `options.source` - A dragged element.
-    * - `options.target` - A drop target.
-    * - `options.newElement` - A new element. This parameter is defined only if users drag a question or panel from the Toolbox.
     */
     type: string;
     question?: Question;
@@ -522,6 +505,20 @@ export interface PageAddedEvent {
      */
     page: PageModel;
 }
+export interface QuestionConvertingEvent {
+    /**
+     * A question of the previous type.
+     */
+    sourceQuestion: Question;
+    /**
+     * A target [type](https://surveyjs.io/form-library/documentation/api-reference/question#getType).
+     */
+    targetType: string;
+    /**
+     * A JSON object produced by the previous question. You can modify this object to decide which properties should be copied to a new question. Set this parameter to `undefined` if you want to create the new question with a default JSON object.
+     */
+    json: any;
+}
 export interface PageGetFooterActionsEvent {
     /**
      * An array of actions. You can add, modify, or remove actions from this array.

package/typings/editorLocalization.d.ts

@@ -448,6 +448,9 @@ export declare var defaultStrings: {
         rateDescriptionLocation: string;
         size: string;
         cellErrorLocation: string;
+        enabled: string;
+        disabled: string;
+        inherit: string;
         apply: string;
         ok: string;
         save: string;
@@ -1469,6 +1472,7 @@ export declare var defaultStrings: {
         filePlaceholder: string;
         photoPlaceholder: string;
         fileOrPhotoPlaceholder: string;
+        colCount: string;
         masksettings: {
             saveMaskedValue: string;
         };

package/typings/localization/english.d.ts

@@ -406,6 +406,9 @@ export declare var enStrings: {
         rateDescriptionLocation: string;
         size: string;
         cellErrorLocation: string;
+        enabled: string;
+        disabled: string;
+        inherit: string;
         apply: string;
         ok: string;
         save: string;
@@ -1427,6 +1430,7 @@ export declare var enStrings: {
         filePlaceholder: string;
         photoPlaceholder: string;
         fileOrPhotoPlaceholder: string;
+        colCount: string;
         masksettings: {
             saveMaskedValue: string;
         };

package/typings/property-grid/index.d.ts

@@ -177,6 +177,12 @@ export declare class PropertyGridEditorBoolean extends PropertyGridEditor {
     getJSON(obj: Base, prop: JsonObjectProperty, options: ISurveyCreatorOptions): any;
     isSupportGrouping(): boolean;
 }
+export declare class PropertyGridEditorUndefinedBoolean extends PropertyGridEditor {
+    fit(prop: JsonObjectProperty, context?: string): boolean;
+    getJSON(obj: Base, prop: JsonObjectProperty, options: ISurveyCreatorOptions): any;
+    onCreated(obj: Base, question: Question, prop: JsonObjectProperty, options: ISurveyCreatorOptions, propGridDefinition?: ISurveyPropertyGridDefinition): void;
+    onSetup(obj: Base, question: Question, prop: JsonObjectProperty, options: ISurveyCreatorOptions): void;
+}
 export declare abstract class PropertyGridEditorStringBase extends PropertyGridEditor {
     protected updateMaxLength(prop: JsonObjectProperty, json: any): any;
     protected updateType(prop: JsonObjectProperty, obj: Base, json: any): any;

package/typings/questionconverter.d.ts

@@ -6,7 +6,8 @@ export declare class QuestionConverter {
     static addConvertInfo(className: string, convertToClassName: string): void;
     private static getConvertableClasses;
     static getConvertToClasses(className: string, availableTypes?: Array<string>, includeCurrent?: boolean): Array<string>;
-    static convertObject(obj: Question, convertToClass: string, defaultObjJSON?: any, defaultJSON?: any): Question;
+    static getObjJSON(obj: Question, defaultObjJSON: any): any;
+    static convertObject(obj: Question, convertToClass: string, objJSON: any, defaultJSON?: any): Question;
     private static updateJSON;
     private static updateJSONForMatrices;
     private static getColumnName;

package/typings/toolbox.d.ts

@@ -3,38 +3,57 @@ import { SurveyCreatorModel, toolboxLocationType } from "./creator-base";
 import { SearchManagerToolbox } from "./property-grid/search-manager";
 export declare type overflowBehaviorType = "hideInMenu" | "scroll";
 /**
- * The Toolbox item description.
+ * A toolbox item configuration.
+ *
+ * `IQuestionToolboxItem` objects are used in such Toolbox API methods as [`getItemByName(name)`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#getItemByName), [`addItem(name, index)`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#addItem), [`replaceItem(name)`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#replaceItem), and others.
+ *
+ * [Toolbox Customization](https://surveyjs.io/survey-creator/documentation/toolbox-customization (linkStyle))
  */
 export interface IQuestionToolboxItem extends IAction {
     /**
-     * A unique name
+     * A toolbox item identifier.
+     *
+     * > Toolbox item names must be unique.
      */
     name: string;
     /**
-     * Icon name
+     * An icon name.
+     *
+     * [UI Icons](https://surveyjs.io/form-library/documentation/icons (linkStyle))
      */
     iconName: string;
     /**
-     * The JSON that used to create a new question/panel. The 'type' attribute is required.
+     * A JSON object used to create a new question or panel when users click this toolbox item. It must contain the `type` property.
+     *
+     * [View Toolbox Customization Demo](https://surveyjs.io/survey-creator/examples/survey-toolbox-customization/ (linkStyle))
      */
     json: any;
     /**
-     * Toolbox item title
+     * A user-friendly toolbox item title.
      */
     title: string;
     className: string;
     /**
-     * Toolbox item tooltip. It equals to title if it is empty
+     * A toolbox item tooltip.
+     *
+     * If `tooltip` is undefined, the [`title`](https://surveyjs.io/survey-creator/documentation/api-reference/iquestiontoolboxitem#title) property value is used instead.
      */
     tooltip?: string;
-    /**
-     * True, if an end user added this item into Toolbox from the survey.
-     */
     isCopied: boolean;
     /**
-     * Toolbox item category. If it is empty, it goes to 'General' category.
+     * A category to which this toolbox item belongs.
+     *
+     * Out-of-the-box categories include `"general"`, `"choice"`, `"text"`, `"containers"`, `"matrix"`, and `"misc"`.
+     *
+     * Default value: `"general"`
      */
     category: string;
+    /**
+     * Specifies whether users can interact with the toolbox item.
+     *
+     * Default value: `true`
+     */
+    enabled?: boolean;
     getArea?: (el: HTMLElement) => HTMLElement;
 }
 export interface IQuestionToolbox {
@@ -78,7 +97,22 @@ export declare class QuestionToolboxItem extends Action implements IQuestionTool
     hasText(text: string): boolean;
 }
 /**
- * The list of Toolbox items.
+ * An object that enables you to modify Survey Creator's Toolbox. To access this object, use the [`toolbox`](https://surveyjs.io/survey-creator/documentation/api-reference/survey-creator#toolbox) property on a Survey Creator instance:
+ *
+ * ```js
+ * const creatorOptions = { ... };
+ * const creator = new SurveyCreator.SurveyCreator(creatorOptions);
+ * creator.toolbox.settingName = "value";
+ *
+ * // In modular applications:
+ * import { SurveyCreatorModel } from "survey-creator-core";
+ *
+ * const creatorOptions = { ... };
+ * const creator = new SurveyCreatorModel(creatorOptions);
+ * creator.toolbox.settingName = "value";
+ * ```
+ *
+ * [Toolbox Customization](https://surveyjs.io/survey-creator/documentation/toolbox-customization (linkStyle))
  */
 export declare class QuestionToolbox extends AdaptiveActionContainer<QuestionToolboxItem> implements IQuestionToolbox {
     private supportedQuestions;
@@ -98,14 +132,8 @@ export declare class QuestionToolbox extends AdaptiveActionContainer<QuestionToo
     get containerSelector(): string;
     static getQuestionDefaultSettings(questionType: string): any;
     static getSubTypePropertyName(questionType: string): string;
-    /**
-     * Modify this array to change the toolbox items order.
-     */
     get orderedQuestions(): string[];
     set orderedQuestions(questions: string[]);
-    /**
-     * The maximum number of copied toolbox items. If an user adding copiedItemMaxCount + 1 item, the first added item will be removed.
-     */
     copiedItemMaxCount: number;
     private allowExpandMultipleCategoriesValue;
     private keepAllCategoriesExpandedValue;
@@ -116,11 +144,14 @@ export declare class QuestionToolbox extends AdaptiveActionContainer<QuestionToo
      * Contains toolbox categories and allows you to modify them.
      *
      * [View Demo](https://surveyjs.io/Examples/Survey-Creator?id=toolboxcategories (linkStyle))
+     * @see defineCategories
+     * @see showCategoryTitles
      */
     categories: Array<QuestionToolboxCategory>;
     /**
-     * Set and get and active category. This property doesn't work if allowExpandMultipleCategories is true. Its default value is empty.
-     * @see allowExpandMultipleCategories
+     * Gets or sets the currently expanded category. Applies only if [`allowExpandMultipleCategories`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#allowExpandMultipleCategories) and [`keepAllCategoriesExpanded`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#keepAllCategoriesExpanded) are `false` and [`showCategoryTitles`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#showCategoryTitles) is `true`.
+     *
+     * Default value: `""`
      * @see expandCategory
      * @see collapseCategory
      */
@@ -129,27 +160,35 @@ export declare class QuestionToolbox extends AdaptiveActionContainer<QuestionToo
     canCollapseCategories: boolean;
     updateResponsiveness(isCompact: boolean, overflowBehavior: overflowBehaviorType): void;
     /**
-     * Indicates whether the toolbox is currently in compact mode.
-     * @see forceCompact
+     * Indicates whether the Toolbox is currently in [compact mode](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#forceCompact).
      */
     isCompact: boolean;
     isFocused: boolean;
     /**
-     * Indicates whether the toolbox is currently can have scrollbar.
+     * Specifies how the Toolbox behaves when it contains more items than can fit on the screen.
+     *
+     * Possible values:
+     *
+     * - `"scroll"` (default) - Enables scrolling to help users reach the items that do not fit on the screen.
+     * - `"hideInMenu"` - Hides the overflow items in a three-dot menu.
      */
     overflowBehavior: overflowBehaviorType;
     /**
-     * Specifies whether the toolbox should be in compact or full mode.
-     * Accepts the following values:
+     * Specifies whether the Toolbox should be in compact or full mode.
+     *
+     * Possible values:
+     *
      * - `true` - Toolbox is always in compact mode.
      * - `false` - Toolbox is always in full mode.
-     * - `undefined` - Toolbox switches between the full and compact modes automatically based on available width.
+     * - `undefined` (default) - Toolbox switches between the full and compact modes automatically based on available width.
+     *
+     * [View Toolbox Customization Demo](https://surveyjs.io/survey-creator/examples/survey-toolbox-customization/ (linkStyle))
      * @see isCompact
      */
     forceCompact: boolean;
     private categoriesTitles;
     /**
-     * Specifies whether to display a search field that allows users to find question and panel types within the toolbox.
+     * Specifies whether to display a search field that allows users to find question and panel types within the Toolbox.
      *
      * Default value: `true`
      */
@@ -172,89 +211,87 @@ export declare class QuestionToolbox extends AdaptiveActionContainer<QuestionToo
     searchItem: IAction;
     get classNames(): string;
     setLocation(toolboxLocation: toolboxLocationType): void;
-    /**
-     * The Array of Toolbox items as Text JSON.
-     */
     get jsonText(): string;
     set jsonText(value: string);
-    /**
-     * The Array of copied Toolbox items as Text JSON.
-     */
     get copiedJsonText(): string;
     set copiedJsonText(value: string);
     /**
-     * The Array of Toolbox items.
+     * An array of toolbox items.
+     * @see getItemByName
+     * @see addItem
+     * @see removeItem
      */
     get items(): Array<QuestionToolboxItem>;
     get itemNames(): Array<string>;
-    /**
-     * The Array of copied Toolbox items
-     */
     get copiedItems(): Array<QuestionToolboxItem>;
-    /**
-     * Add toolbox items into the Toolbox
-     * @param items the list of new items
-     * @param clearAll set it to true to clear all previous items.
-     */
     addItems(items: Array<IQuestionToolboxItem>, clearAll?: boolean): void;
-    /**
-     * Add a copied Question into Toolbox
-     * @param question a copied Survey.Question
-     * @param options a json object that allows you to override question properties. Attributes are: name, title, tooltip, isCopied, iconName, json and category.
-     */
     addCopiedItem(question: Question, options?: any): void;
-    /**
-     * Add a toolbox item
-     * @param item the toolbox item description
-     * @param index the toolbox index to place the item, the item is added to the end if index not passed
-     * @see IQuestionToolboxItem
-     */
     private getActionByItem;
     private addSubTypes;
+    /**
+     * Adds a new item to the Toolbox.
+     * @param item A [toolbox item configuration](https://surveyjs.io/survey-creator/documentation/api-reference/iquestiontoolboxitem).
+     * @param index *(Optional)* A zero-based index at which to insert the item. If you do not specify this parameter, the item is added to the end.
+     * @see removeItem
+     * @see replaceItem
+     * @see items
+     */
     addItem(item: IQuestionToolboxItem, index?: number): void;
     private correctItem;
     private get dragDropHelper();
     /**
-     * Add a new toolbox item, add delete the old item with the same name
-     * @param item the toolbox item description
-     * @see IQuestionToolboxItem
+     * Adds a new toolbox item and deletes an existing item with the same name (if there is any).
+     * @param item A [toolbox item configuration](https://surveyjs.io/survey-creator/documentation/api-reference/iquestiontoolboxitem).
+     * @see addItem
      */
     replaceItem(item: IQuestionToolboxItem): boolean;
     /**
-     * Remove a toolbox item by its name
-     * @param name toolbox item name
-     * @see IQuestionToolboxItem
+     * Removes a [toolbox item](https://surveyjs.io/survey-creator/documentation/api-reference/iquestiontoolboxitem) with a specified name.
+     * @param name A toolbox item's [`name`](https://surveyjs.io/survey-creator/documentation/api-reference/iquestiontoolboxitem#name).
+     * @returns `true` if the item is successfully deleted or `false` otherwise.
+     * @see clearItems
+     * @see addItem
+     * @see items
      */
     removeItem(name: string): boolean;
     /**
-     * Remove all toolbox items.
+     * Removes all items from the Toolbox.
+     * @see removeItem
+     * @see addItem
+     * @see items
      */
     clearItems(): void;
-    /**
-     * Remove all copied toolbox items.
-     */
     clearCopiedItems(): void;
     /**
-     * Returns toolbox item by its name. Returns null if there is no toolbox item with this name
-     * @param name
+     * Returns a [toolbox item](https://surveyjs.io/survey-creator/documentation/api-reference/iquestiontoolboxitem) with a specified name.
+     * @param name A toolbox item's [`name`](https://surveyjs.io/survey-creator/documentation/api-reference/iquestiontoolboxitem#name).
+     * @returns A toolbox item or `null` if a toolbox item with the specified name isn't found.
      */
     getItemByName(name: string): IQuestionToolboxItem;
     /**
-     * Set it to true, to allow end-user to expand more than one category. There will no active category in this case
-     * @see activeCategory
+     * Specifies whether more than one category can be in the expanded state at a time. Applies only if [`showCategoryTitles`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#showCategoryTitles) is `true`.
+     *
+     * If this property is `false`, the currently expanded category collapses when a user expands another category.
+     *
+     * Default value: `false`
+     * @see keepAllCategoriesExpanded
      */
     get allowExpandMultipleCategories(): boolean;
     set allowExpandMultipleCategories(val: boolean);
     /**
-     * Set it to true to expand all categories and hide expand/collapse category buttons
+     * Specifies whether to expand all categories without the capability to collapse any of them. Applies only if [`showCategoryTitles`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#showCategoryTitles) is `true`.
+     * @see allowExpandMultipleCategories
      */
     get keepAllCategoriesExpanded(): boolean;
     set keepAllCategoriesExpanded(val: boolean);
     /**
      * Specifies whether to display category titles in the Toolbox.
      *
-     * If you disable this property, the Toolbox hides the titles but continues to display horizontal lines that divide categories. To remove these lines as well, call the `removeCategories()` method.
-     * @see removeCategories
+     * Default value: `false`
+     *
+     * If this property is disabled, the Toolbox hides the titles but continues to display horizontal lines that divide categories. To remove these lines as well, call the [`removeCategories()`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#removeCategories) method.
+     * @see allowExpandMultipleCategories
+     * @see keepAllCategoriesExpanded
      */
     get showCategoryTitles(): boolean;
     set showCategoryTitles(val: boolean);
@@ -262,16 +299,18 @@ export declare class QuestionToolbox extends AdaptiveActionContainer<QuestionToo
     private updateActionTitle;
     private updateCategoriesState;
     /**
-     * Change the category of the toolbox item
-     * @param name the toolbox item name
-     * @param category new category name
+     * Changes the category of a toolbox item.
+     * @param itemName A toolbox item's [`name`](https://surveyjs.io/survey-creator/documentation/api-reference/iquestiontoolboxitem#name).
+     * @param categoryName A new category name. Out-of-the-box category names include `"general"`, `"choice"`, `"text"`, `"containers"`, `"matrix"`, and `"misc"`.
+     * @see defineCategories
      */
-    changeCategory(name: string, category: string): void;
+    changeCategory(itemName: string, categoryName: string): void;
     /**
-     * Change categories for several toolbox items.
-     * @param changedItems the array of objects {name: "your toolbox item name", category: "new category name"}
+     * Changes the categories of multiple toolbox items.
+     * @param items An array of objects with the following structure: `{ name: "toolboxItemName", category: "newCategoryName" }`.
+     * @see defineCategories
      */
-    changeCategories(changedItems: Array<any>): void;
+    changeCategories(items: Array<any>): void;
     /**
      * Defines toolbox categories from scratch.
      *
@@ -302,31 +341,32 @@ export declare class QuestionToolbox extends AdaptiveActionContainer<QuestionToo
      */
     defineCategories(categories: Array<IToolboxCategoryDefinition>, displayMisc?: boolean): void;
     /**
-     * Removes categories from the Toolbox.
+     * Removes all categories from the Toolbox.
      */
     removeCategories(): void;
     toggleCategoryState(categoryName: string): void;
     /**
-     * Expand a category by its name. If allowExpandMultipleCategories is false (default value), all other categories become collapsed
-     * @param categoryName the category name
-     * @see allowExpandMultipleCategories
+     * Expands a category with a specified name. Applies only if [`showCategoryTitles`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#showCategoryTitles) is `true`.
+     *
+     * If [`allowExpandMultipleCategories`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#allowExpandMultipleCategories) is `false`, all other categories become collapsed.
+     * @param categoryName A category name. Out-of-the-box category names include `"general"`, `"choice"`, `"text"`, `"containers"`, `"matrix"`, and `"misc"`.
      * @see collapseCategory
      */
     expandCategory(categoryName: string): void;
     /**
-     * Collapse a category by its name. If allowExpandMultipleCategories is false (default value) this function does nothing
-     * @param categoryName the category name
-     * @see allowExpandMultipleCategories
+     * Collapses a category with a specified name. Applies only if [`showCategoryTitles`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#showCategoryTitles) and [`allowExpandMultipleCategories`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#allowExpandMultipleCategories) are `true`.
+     * @param categoryName A category name. Out-of-the-box category names include `"general"`, `"choice"`, `"text"`, `"containers"`, `"matrix"`, and `"misc"`.
+     * @see expandCategory
      */
     collapseCategory(categoryName: string): void;
     /**
-     * Expand all categories. If allowExpandMultipleCategories is false (default value) this function does nothing
-     * @see allowExpandMultipleCategories
+     * Expands all categories. Applies only if [`showCategoryTitles`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#showCategoryTitles) and [`allowExpandMultipleCategories`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#allowExpandMultipleCategories) are `true`.
+     * @see collapseAllCategories
      */
     expandAllCategories(): void;
     /**
-     * Collapse all categories. If allowExpandMultipleCategories is false (default value) this function does nothing
-     * @see allowExpandMultipleCategories
+     * Collapses all categories. Applies only if [`showCategoryTitles`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#showCategoryTitles) and [`allowExpandMultipleCategories`](https://surveyjs.io/survey-creator/documentation/api-reference/questiontoolbox#allowExpandMultipleCategories) are `true`.
+     * @see expandAllCategories
      */
     collapseAllCategories(): void;
     private expandCollapseAllCategories;