survey-creator-core 1.9.125 → 1.9.126

package/typings/components/image-item-value.d.ts

@@ -12,6 +12,7 @@ export declare class ImageItemValueWrapperViewModel extends ItemValueWrapperView
     constructor(creator: CreatorBase, question: QuestionSelectBase, item: ImageItemValue, templateData: any, itemsRoot: HTMLElement);
     getRootCss(): string;
     getIsNewItemSingle(): boolean;
+    get canRenderControls(): boolean;
     chooseFile(model: ImageItemValueWrapperViewModel): void;
     uploadFiles(files: any): void;
     chooseNewFile(model: ImageItemValueWrapperViewModel): void;

package/typings/components/question.d.ts

@@ -24,9 +24,11 @@ export declare class QuestionAdornerViewModel extends SurveyElementAdornerBase {
     get isBannerShowing(): boolean;
     private get isUsingCarryForward();
     private get isUsingRestfull();
+    private get isMessagePanelVisible();
     createBannerParams(): QuestionBannerParams;
     private createCarryForwardParams;
     private createUsingRestfulParams;
+    private createCustomMessagePanel;
     dispose(): void;
     get isDraggable(): boolean;
     hover(event: MouseEvent, element: HTMLElement | any): void;

package/typings/components/switcher/switcher.d.ts

@@ -0,0 +1,6 @@
+import { Action } from "survey-core";
+export declare class Switcher extends Action {
+    checked: boolean;
+    getSwitcherIconCss(): string;
+    getActionBarItemCss(): string;
+}

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

@@ -39,6 +39,7 @@ export declare class ThemeBuilder extends Base {
     themeName: any;
     themePalette: any;
     themeMode: any;
+    groupAppearanceAdvancedMode: boolean;
     getFullThemeName(_themeName?: string): any;
     get survey(): SurveyModel;
     get pageActions(): Array<Action>;
@@ -96,6 +97,7 @@ export declare class ThemeBuilder extends Base {
     private updateDependentQuestionValues;
     private setThemeCssVariablesChanges;
     protected createThemeEditorSurvey(): SurveyModel;
+    private createAppearanceAdvancedModeAction;
     findSuitableTheme(themeName: string): ITheme;
     private patchFileEditors;
     private getCoverJson;

package/typings/creator-base.d.ts

@@ -250,12 +250,6 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
      * A Boolean value that specifies the property's read-only status.
      */
     onGetPropertyReadOnly: CreatorEvent;
-    /**
-     * The event is fired when the survey creator creates a survey object (Survey.Survey).
-     *- sender the survey creator object that fires the event
-     *- options.survey the survey object showing in the creator.
-     *- options.reason indicates what component of the creator requests the survey. There are several reason types: "designer" - survey for designer survey, "test" - survey for "Preview" tab and "conditionEditor", "defaultValueEditor", "restfulEditor" - surveys for different property editors.
-     */
     onSurveyInstanceCreated: CreatorEvent;
     /**
      * An event that is raised when Survey Creator obtains a survey element name to display it in the UI.
@@ -285,15 +279,22 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
      */
     onGetObjectDisplayName: CreatorEvent;
     /**
-     * This event is raised after a user has edited a text value on the design surface. This value may include HTML markup. You can handle the `onHtmlToMarkdown` event to convert the HTML markup to Markdown.
+     * An event that is raised after a user has edited a text value on the design surface. This value may include HTML markup. You can handle the `onHtmlToMarkdown` event to convert the HTML markup to Markdown.
      *
      * The event handler accepts the following arguments:
      *
-     * - `sender` - A Survey Creator instance that raised the event.
-     * - `options.element` - The instance of a survey element (survey, page, panel, question) that the user configures.
-     * - `options.name` - The name of a property whose value has been edited.
-     * - `options.html` - HTML content. Pass this field's value to an HTML-to-Markdown converter.
-     * - `options.text` - A text string that may contain Markdown. Assign the result of the HTML-to-Markdown conversion to this field.
+     * Parameters:
+     *
+     * - `sender`: `CreatorBase`\
+     * A Survey Creator instance that raised the event.
+     * - `options.element`: `any`\
+     * The instance of a survey element (survey, page, panel, question) that the user configures.
+     * - `options.name`: `string`\
+     * The name of a property whose value has been edited.
+     * - `options.html`: `string`\
+     * HTML content. Pass this field's value to an HTML-to-Markdown converter.
+     * - `options.text`: `string`\
+     * A text string that may contain Markdown. Assign the result of the HTML-to-Markdown conversion to this field.
      */
     onHtmlToMarkdown: CreatorEvent;
     /**
@@ -365,42 +366,67 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
     onShowingProperty: CreatorEvent;
     onCanShowProperty: CreatorEvent;
     /**
-     * The event is called after a survey that represents the Property Grid is created and all its questions (property editors) are setup.
-     * You can use this event to modify this survey to change the property grid behavior
-     *- options.obj the survey object that is currently editing in the property grid
-     *- options.survey the property grid survey
+     * An event that is raised when a [survey that represents the Property Grid](https://surveyjs.io/survey-creator/documentation/creator-v2-whats-new#survey-creator-ui-elements-are-surveys) is instantiated. Handle this event to customize the Property Grid by modifying the survey.
+     *
+     * Parameters:
+     *
+     * - `sender`: `CreatorBase`\
+     * A Survey Creator instance that raised the event.
+     * - `options.object`: `any`\
+     * A survey element being edited in the Property Grid.
+     * - `options.survey`: [`SurveyModel`](https://surveyjs.io/form-library/documentation/api-reference/survey-data-model)
+     * A survey that respresents the Property Grid. Use the `SurveyModel` API to modify the survey.
+     * @see onPropertyEditorCreated
      */
     onPropertyGridSurveyCreated: CreatorEvent;
     /**
-      * The event is called after a property editor (in fact a survey question) has been created and all it's properties have been assign.
-      * You can use this event to modify the property editor properties or set event handlers to customize it's behavior
-      *- options.obj the survey object that is currently editing in the property grid
-      *- options.property the property that the current property editor is editing
-      *- options.editor the property editor. In fact it is a survey question. We are using a heavily customizable survey as a property grid in Creator V2. It means that every property editor is a question.
-      */
+     * An event that is raised when a property editor is created in the Property Grid. Use this event to modify the property editor or add event handlers to it.
+     *
+     * Parameters:
+     *
+     * - `sender`: `CreatorBase`\
+     * A Survey Creator instance that raised the event.
+     * - `options.editor`: [`Question`](https://surveyjs.io/form-library/documentation/api-reference/question)\
+     * A property editor. It is an object of the [`Question`](https://surveyjs.io/form-library/documentation/question) type because the Property Grid is [built upon a regular survey](https://surveyjs.io/survey-creator/documentation/creator-v2-whats-new#survey-creator-ui-elements-are-surveys).
+     * - `options.property`: `JsonObjectProperty`\
+     * A property that corresponds to the created property editor.
+     * @see onPropertyGridSurveyCreated
+     */
     onPropertyEditorCreated: CreatorEvent;
     /**
-     * The event is called after a property editor setups its title actions.
-     * You can use this event to modify the property editor title actions
-     *- options.obj the survey object that is currently editing in the property grid
-     *- options.property the property that the current property editor is editing
-     *- options.editor the property editor. In fact it is a survey question. We are using a heavily customizable survey as a property grid in Creator V2. It means that every property editor is a question.
-     *- options.titleActions the list of title actions.
+     * An event that is raised when title actions are added to a property editor. Title actions are most often used to reveal hints for properties configured by users. Handle this event you want to add, remove, or modify the title actions.
+     *
+     * Parameters:
+     *
+     * - `sender`: `CreatorBase`\
+     * A Survey Creator instance that raised the event.
+     * - `options.object`: `any`\
+     * A survey element being edited in the Property Grid.
+     * - `options.editor`: [`Question`](https://surveyjs.io/form-library/documentation/api-reference/question)\
+     * A property editor that contains the title actions. It is an object of the [`Question`](https://surveyjs.io/form-library/documentation/question) type because the Property Grid is [built upon a regular survey](https://surveyjs.io/survey-creator/documentation/creator-v2-whats-new#survey-creator-ui-elements-are-surveys).
+     * - `options.property`: `JsonObjectProperty`\
+     * A property that corresponds to the property editor.
+     * - `options.titleActions`: [`IAction[]`](https://surveyjs.io/form-library/documentation/api-reference/iaction)\
+     * A list of title actions.
      */
     onPropertyEditorUpdateTitleActions: CreatorEvent;
     /**
-     * An event that is raised before Survey Creator displays a pop-up window called from the Property Grid. This window allows users to edit choices, conditions, and so on.
-     *
-     * Use this event to customize the pop-up window, for example, add custom action buttons.
+     * An event that is raised before Survey Creator displays a pop-up window called from the Property Grid. This window allows users to edit choices, conditions, etc. Use this event to customize the pop-up window, for example, add custom action buttons.
      *
      * Parameters:
      *
-     * - `sender` - A Survey Creator instance that raised the event.
-     * - `options.obj` - An instance of a survey element (question or panel) that users are configuring in the Property Grid.
-     * - `options.property`- A `JsonObjectProperty` object with metadata about the property being edited.
-     * - `options.editor` - A property editor. It is an object of the [`Question`](https://surveyjs.io/form-library/documentation/question) type because the Property Grid is [built upon a regular survey](https://surveyjs.io/survey-creator/documentation/creator-v2-whats-new#survey-creator-ui-elements-are-surveys).
-     * - `options.popupEditor` - An editor inside the pop-up window.
-     * - `options.popupModel` - A `PopupBaseViewModel` object that describes the pop-up window model. Use `options.popupModel.footerToolbar` to access the actions at the bottom of the window.
+     * - `sender`: `CreatorBase`\
+     * A Survey Creator instance that raised the event.
+     * - `options.obj`: `any`\
+     * The instance of a survey element (question or panel) that users are configuring in the Property Grid.
+     * - `options.property`: `JsonObjectProperty`\
+     * A property being edited.
+     * - `options.editor`: [`Question`](https://surveyjs.io/form-library/documentation/api-reference/question)\
+     * A property editor. It is an object of the [`Question`](https://surveyjs.io/form-library/documentation/question) type because the Property Grid is [built upon a regular survey](https://surveyjs.io/survey-creator/documentation/creator-v2-whats-new#survey-creator-ui-elements-are-surveys).
+     * - `options.popupEditor`: `any`\
+     * An editor inside the pop-up window.
+     * - `options.popupModel`: `PopupBaseViewModel`\
+     * A pop-up window model. Use `options.popupModel.footerToolbar` to access the actions at the bottom of the window.
      */
     onPropertyGridShowModal: CreatorEvent;
     onCanDeleteItem: CreatorEvent;
@@ -449,12 +475,6 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
      *- options.editorOptions.itemsEntryType a string property, 'form' by default. Set it 'fast' to show "Manual Entry" tab for "choices" property by default.
      */
     onSetPropertyEditorOptions: CreatorEvent;
-    /**
-     * The event is called on generation a new name for a new created element.
-     *- sender the survey creator object that fires the event
-     *- options.element a new created survey element. It can be question, panel or page
-     *- options.name a new suggested name, that is unique for the current survey. You can suggest your own name. If it is unique, creator will assign it to the element.
-     */
     onGenerateNewName: CreatorEvent;
     /**
      * An event that is raised when Survey Creator validates a modified value of a survey element property. Use this event to display a custom error message when the value is incorrect.
@@ -627,7 +647,7 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
      * The question users added.
      * - `options.page`: [`PageModel`](https://surveyjs.io/form-library/documentation/api-reference/page-model)\
      * A page to which the question was added.
-     * - `options.reason`: `"DROPPED_FROM_TOOLBOX"` | `"ADDED_FROM_PAGEBUTTON"` | `"ELEMENT_COPIED"`\
+     * - `options.reason`: `"DROPPED_FROM_TOOLBOX"` | `"ADDED_FROM_PAGEBUTTON"` | `"ELEMENT_COPIED"` | `"ELEMENT_CONVERTED"`\
      * A value that indicates how the question was added: dragged from the [Toolbox](https://surveyjs.io/survey-creator/documentation/toolbox-customization), created using the Add Question button, or duplicated.
      *
      * [Customize Survey Elements on Creation](https://surveyjs.io/survey-creator/documentation/customize-survey-creation-process#customize-survey-elements-on-creation (linkStyle))
@@ -950,6 +970,63 @@ export declare class CreatorBase extends Base implements ISurveyCreatorOptions,
      * @see onDragEnd
      */
     onDragDropAllow: CreatorEvent;
+    /**
+     * An event that allows you to create a custom message panel.
+     *
+     * Parameters:
+     *
+     * - `sender`: `CreatorBase`\
+     * A Survey Creator instance that raised the event.
+     * - `options.question`: [`Question`](https://surveyjs.io/form-library/documentation/question)\
+     * A question for which the event is raised.
+     * - `options.messageText`: `string`\
+     * A notification message that you want to display. Assign a custom string value to this parameter.
+     * - `options.actionText`: `string`\
+     * A caption text for the action button. Assign a custom string value to this parameter.
+     * - `options.onClick`: `function`\
+     * A function that is called when users click the action button. Assign a custom function to this parameter.
+     *
+     * A message panel displays a notification message instead of a question box on the design surface. A message panel contains a message and an action button. For instance, the following image illustrates a built-in message panel notifying survey authors that choice options are loaded from a web service:
+     *
+     * <img src="https://surveyjs.io/stay-updated/release-notes/articles/v1.9.126/creator-message-panel.png" alt="Survey Creator: A message panel" width="75%">
+     *
+     * To create a custom message panel, handle the `onCreateCustomMessagePanel` event. This event is raised for questions whose `isMessagePanelVisible` property set to `true`. The following code shows how to enable this property based on a condition. This code implements a custom data source selector for select-based questions (Dropdown, Checkboxes, Radio Button Group). When a survey author selects any data source other than "Custom", the `isMessagePanelVisible` property becomes enabled, indicating that the `onCreateCustomMessagePanel` event must be raised. A function that handles this event specifies custom message and action button texts and `onClick` event handler:
+     *
+     * ```js
+     * import { Serializer } from "survey-core";
+     * import { SurveyCreatorModel } from "survey-creator-core";
+     *
+     * Serializer.addProperty("selectbase", {
+     *   name: "choicesDataSource",
+     *   displayName: "Data source",
+     *   category: "choices",
+     *   choices: [
+     *     { text: "Country", value: "country" },
+     *     { text: "Region", value: "region" },
+     *     { text: "City", value: "city" },
+     *     { text: "Custom", value: "custom" }
+     *   ],
+     *   onSetValue: function (obj: any, value: any) {
+     *     // Set the custom property value
+     *     obj.setPropertyValue("choicesDataSource", value);
+     *     // Display the message panel based on a condition
+     *     obj.setPropertyValue("isMessagePanelVisible", value !== "custom");
+     *   }
+     * });
+     *
+     * const creator = new SurveyCreatorModel({});
+     *
+     * creator.onCreateCustomMessagePanel.add((_, options) => {
+     *   options.messageText = "Choices for this question are loaded from a predefined data source. ";
+     *   options.actionText = "Go to settings";
+     *   // Focus the "Data source" editor within the Property Grid
+     *   options.onClick = () => {
+     *     creator.selectElement(options.question, "choicesDataSource");
+     *   };
+     * });
+     * ```
+     */
+    onCreateCustomMessagePanel: CreatorEvent;
     getSurveyJSONTextCallback: () => {
         text: string;
         isModified: boolean;

package/typings/creator-settings.d.ts

@@ -50,6 +50,7 @@ export declare var settings: {
         showAddQuestionButton: boolean;
     };
     logic: {
+        questionSortOrder: string;
         defaultOperator: string;
         defaultOperators: {
             default: string;

package/typings/editorLocalization.d.ts

@@ -1058,8 +1058,8 @@ export declare var defaultStrings: {
         "--primary-foreground": string;
         "--foreground": string;
         "--base-unit": string;
+        advancedMode: string;
         groupGeneral: string;
-        groupAdvanced: string;
         groupHeader: string;
         groupBackground: string;
         groupAppearance: string;
@@ -1088,11 +1088,9 @@ export declare var defaultStrings: {
         backgroundImageAttachmentScroll: string;
         panelBackgroundTransparency: string;
         questionBackgroundTransparency: string;
-        questionPanel: string;
         questionTitle: string;
-        questionDescription: string;
         editorPanel: string;
-        editorFont: string;
+        backgroundCornerRadius: string;
         backcolor: string;
         hovercolor: string;
         borderDecoration: string;
@@ -1100,7 +1098,9 @@ export declare var defaultStrings: {
         accentForeground: string;
         primaryForecolor: string;
         primaryForecolorLight: string;
-        linesColors: string;
+        colorsTitle: string;
+        font: string;
+        lines: string;
         borderDefault: string;
         borderLight: string;
         fontFamily: string;
@@ -1117,7 +1117,8 @@ export declare var defaultStrings: {
         surveyTitle: string;
         surveyDescription: string;
         pageTitle: string;
-        pageDescription: string;
+        titleFont: string;
+        descriptionFont: string;
         boxShadowX: string;
         boxShadowY: string;
         boxShadowAddRule: string;
@@ -1126,8 +1127,7 @@ export declare var defaultStrings: {
         boxShadowSpread: string;
         boxShadowDrop: string;
         boxShadowInner: string;
-        questionShadow: string;
-        editorShadow: string;
+        shadow: string;
         headerView: string;
         headerViewBasic: string;
         headerViewAdvanced: string;

package/typings/entries/index.d.ts

@@ -66,6 +66,7 @@ export * from "../textWorker";
 export * from "../toolbox";
 export * from "../components/side-bar/side-bar-model";
 export * from "../components/side-bar/side-bar-tab-model";
+export * from "../components/switcher/switcher";
 export * from "../utils/events";
 export * from "../utils/utils";
 export * from "../question-editor/definition";

package/typings/localization/english.d.ts

@@ -1027,8 +1027,8 @@ export declare var enStrings: {
         "--primary-foreground": string;
         "--foreground": string;
         "--base-unit": string;
+        advancedMode: string;
         groupGeneral: string;
-        groupAdvanced: string;
         groupHeader: string;
         groupBackground: string;
         groupAppearance: string;
@@ -1057,11 +1057,9 @@ export declare var enStrings: {
         backgroundImageAttachmentScroll: string;
         panelBackgroundTransparency: string;
         questionBackgroundTransparency: string;
-        questionPanel: string;
         questionTitle: string;
-        questionDescription: string;
         editorPanel: string;
-        editorFont: string;
+        backgroundCornerRadius: string;
         backcolor: string;
         hovercolor: string;
         borderDecoration: string;
@@ -1069,7 +1067,9 @@ export declare var enStrings: {
         accentForeground: string;
         primaryForecolor: string;
         primaryForecolorLight: string;
-        linesColors: string;
+        colorsTitle: string;
+        font: string;
+        lines: string;
         borderDefault: string;
         borderLight: string;
         fontFamily: string;
@@ -1086,7 +1086,8 @@ export declare var enStrings: {
         surveyTitle: string;
         surveyDescription: string;
         pageTitle: string;
-        pageDescription: string;
+        titleFont: string;
+        descriptionFont: string;
         boxShadowX: string;
         boxShadowY: string;
         boxShadowAddRule: string;
@@ -1095,8 +1096,7 @@ export declare var enStrings: {
         boxShadowSpread: string;
         boxShadowDrop: string;
         boxShadowInner: string;
-        questionShadow: string;
-        editorShadow: string;
+        shadow: string;
         headerView: string;
         headerViewBasic: string;
         headerViewAdvanced: string;