@ionic/core 8.8.19 → 8.8.20-dev.11787158518.168a2fea

package/dist/collection/components/searchbar/searchbar.js

@@ -12,186 +12,22 @@ import { getIonMode } from "../../global/ionic-global";
  * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
  */
 export class Searchbar {
-    constructor() {
-        this.isCancelVisible = false;
-        this.shouldAlignLeft = true;
-        this.inputId = `ion-searchbar-${searchbarIds++}`;
-        this.inheritedAttributes = {};
-        this.focused = false;
-        this.noAnimate = true;
-        /**
-         * If `true`, enable searchbar animation.
-         */
-        this.animated = false;
-        /**
-         * Indicates whether and how the text value should be automatically capitalized as it is entered/edited by the user.
-         * Available options: `"off"`, `"none"`, `"on"`, `"sentences"`, `"words"`, `"characters"`.
-         */
-        this.autocapitalize = 'off';
-        /**
-         * Set the input's autocomplete property.
-         */
-        this.autocomplete = 'off';
-        /**
-         * Set the input's autocorrect property.
-         */
-        this.autocorrect = 'off';
-        /**
-         * Set the cancel button icon. Only applies to `md` mode.
-         * Defaults to `arrow-back-sharp`.
-         */
-        this.cancelButtonIcon = config.get('backButtonIcon', arrowBackSharp);
-        /**
-         * Set the cancel button text. Only applies to `ios` mode.
-         */
-        this.cancelButtonText = 'Cancel';
-        /**
-         * If `true`, the user cannot interact with the input.
-         */
-        this.disabled = false;
-        /**
-         * If used in a form, set the name of the control, which is submitted with the form data.
-         */
-        this.name = this.inputId;
-        /**
-         * Set the input's placeholder.
-         * `placeholder` can accept either plaintext or HTML as a string.
-         * To display characters normally reserved for HTML, they
-         * must be escaped. For example `<Ionic>` would become
-         * `&lt;Ionic&gt;`
-         *
-         * For more information: [Security Documentation](https://ionicframework.com/docs/faq/security)
-         */
-        this.placeholder = 'Search';
-        /**
-         * Sets the behavior for the cancel button. Defaults to `"never"`.
-         * Setting to `"focus"` shows the cancel button on focus.
-         * Setting to `"never"` hides the cancel button.
-         * Setting to `"always"` shows the cancel button regardless
-         * of focus state.
-         */
-        this.showCancelButton = 'never';
-        /**
-         * Sets the behavior for the clear button. Defaults to `"focus"`.
-         * Setting to `"focus"` shows the clear button on focus if the
-         * input is not empty.
-         * Setting to `"never"` hides the clear button.
-         * Setting to `"always"` shows the clear button regardless
-         * of focus state, but only if the input is not empty.
-         */
-        this.showClearButton = 'always';
-        /**
-         * If `true`, enable spellcheck on the input.
-         */
-        this.spellcheck = false;
-        /**
-         * Set the type of the input.
-         */
-        this.type = 'search';
-        /**
-         * the value of the searchbar.
-         */
-        this.value = '';
-        /**
-         * Clears the input field and triggers the control change.
-         */
-        this.onClearInput = async (shouldFocus) => {
-            if (this.clearTimeout) {
-                clearTimeout(this.clearTimeout);
-            }
-            this.ionClear.emit();
-            return new Promise((resolve) => {
-                // setTimeout() fixes https://github.com/ionic-team/ionic-framework/issues/7527
-                // wait for 4 frames
-                this.clearTimeout = setTimeout(() => {
-                    const value = this.getValue();
-                    if (value !== '') {
-                        this.value = '';
-                        this.emitInputChange();
-                        /**
-                         * When tapping clear button
-                         * ensure input is focused after
-                         * clearing input so users
-                         * can quickly start typing.
-                         */
-                        if (shouldFocus && !this.focused) {
-                            this.setFocus();
-                            /**
-                             * The setFocus call above will clear focusedValue,
-                             * but ionChange will never have gotten a chance to
-                             * fire. Manually revert focusedValue so onBlur can
-                             * compare against what was in the box before the clear.
-                             */
-                            this.focusedValue = value;
-                        }
-                    }
-                    resolve();
-                }, 16 * 4);
-            });
-        };
-        /**
-         * Clears the input field and tells the input to blur since
-         * the clearInput function doesn't want the input to blur
-         * then calls the custom cancel function if the user passed one in.
-         */
-        this.onCancelSearchbar = async (ev) => {
-            if (ev) {
-                ev.preventDefault();
-                ev.stopPropagation();
-            }
-            this.ionCancel.emit();
-            // get cached values before clearing the input
-            const value = this.getValue();
-            const focused = this.focused;
-            await this.onClearInput();
-            /**
-             * If there used to be something in the box, and we weren't focused
-             * beforehand (meaning no blur fired that would already handle this),
-             * manually fire ionChange.
-             */
-            if (value && !focused) {
-                this.emitValueChange(ev);
-            }
-            if (this.nativeInput) {
-                this.nativeInput.blur();
-            }
-        };
-        /**
-         * Update the Searchbar input value when the input changes
-         */
-        this.onInput = (ev) => {
-            const input = ev.target;
-            if (input) {
-                this.value = input.value;
-            }
-            this.emitInputChange(ev);
-        };
-        this.onChange = (ev) => {
-            this.emitValueChange(ev);
-        };
-        /**
-         * Sets the Searchbar to not focused and checks if it should align left
-         * based on whether there is a value in the searchbar or not.
-         */
-        this.onBlur = (ev) => {
-            this.focused = false;
-            this.ionBlur.emit();
-            this.positionElements();
-            if (this.focusedValue !== this.value) {
-                this.emitValueChange(ev);
-            }
-            this.focusedValue = undefined;
-        };
-        /**
-         * Sets the Searchbar to focused and active on input focus.
-         */
-        this.onFocus = () => {
-            this.focused = true;
-            this.focusedValue = this.value;
-            this.ionFocus.emit();
-            this.positionElements();
-        };
-    }
+    nativeInput;
+    isCancelVisible = false;
+    shouldAlignLeft = true;
+    originalIonInput;
+    inputId = `ion-searchbar-${searchbarIds++}`;
+    inheritedAttributes = {};
+    loadTimeout;
+    clearTimeout;
+    searchIconResizeObserver;
+    /**
+     * The value of the input when the textarea is focused.
+     */
+    focusedValue;
+    el;
+    focused = false;
+    noAnimate = true;
     /**
      * lang and dir are globally enumerated attributes.
      * As a result, creating these as properties
@@ -200,21 +36,177 @@ export class Searchbar {
      * to the inner `<input>` element.
      */
     onLangChanged(newValue) {
-        this.inheritedAttributes = Object.assign(Object.assign({}, this.inheritedAttributes), { lang: newValue });
+        this.inheritedAttributes = {
+            ...this.inheritedAttributes,
+            lang: newValue,
+        };
         forceUpdate(this);
     }
     onDirChanged(newValue) {
-        this.inheritedAttributes = Object.assign(Object.assign({}, this.inheritedAttributes), { dir: newValue });
+        this.inheritedAttributes = {
+            ...this.inheritedAttributes,
+            dir: newValue,
+        };
         forceUpdate(this);
     }
+    /**
+     * The color to use from your application's color palette.
+     * Default options are: `"primary"`, `"secondary"`, `"tertiary"`, `"success"`, `"warning"`, `"danger"`, `"light"`, `"medium"`, and `"dark"`.
+     * For more information on colors, see [theming](/docs/theming/basics).
+     */
+    color;
+    /**
+     * If `true`, enable searchbar animation.
+     */
+    animated = false;
+    /**
+     * Indicates whether and how the text value should be automatically capitalized as it is entered/edited by the user.
+     * Available options: `"off"`, `"none"`, `"on"`, `"sentences"`, `"words"`, `"characters"`.
+     */
+    autocapitalize = 'off';
+    /**
+     * Set the input's autocomplete property.
+     */
+    autocomplete = 'off';
+    /**
+     * Set the input's autocorrect property.
+     */
+    autocorrect = false;
+    /**
+     * Set the cancel button icon. Only applies to `md` mode.
+     * Defaults to `arrow-back-sharp`.
+     */
+    cancelButtonIcon = config.get('backButtonIcon', arrowBackSharp);
+    /**
+     * Set the cancel button text. Only applies to `ios` mode.
+     */
+    cancelButtonText = 'Cancel';
+    /**
+     * Set the clear icon. Defaults to `close-circle` for `ios` and `close-sharp` for `md`.
+     */
+    clearIcon;
+    /**
+     * Set the amount of time, in milliseconds, to wait to trigger the `ionInput` event after each keystroke.
+     */
+    debounce;
     debounceChanged() {
         const { ionInput, debounce, originalIonInput } = this;
         /**
          * If debounce is undefined, we have to manually revert the ionInput emitter in case
          * debounce used to be set to a number. Otherwise, the event would stay debounced.
          */
-        this.ionInput = debounce === undefined ? originalIonInput !== null && originalIonInput !== void 0 ? originalIonInput : ionInput : debounceEvent(ionInput, debounce);
+        this.ionInput = debounce === undefined ? originalIonInput ?? ionInput : debounceEvent(ionInput, debounce);
     }
+    /**
+     * If `true`, the user cannot interact with the input.
+     */
+    disabled = false;
+    /**
+     * A hint to the browser for which keyboard to display.
+     * Possible values: `"none"`, `"text"`, `"tel"`, `"url"`,
+     * `"email"`, `"numeric"`, `"decimal"`, and `"search"`.
+     */
+    inputmode;
+    /**
+     * A hint to the browser for which enter key to display.
+     * Possible values: `"enter"`, `"done"`, `"go"`, `"next"`,
+     * `"previous"`, `"search"`, and `"send"`.
+     */
+    enterkeyhint;
+    /**
+     * This attribute specifies the maximum number of characters that the user can enter.
+     */
+    maxlength;
+    /**
+     * This attribute specifies the minimum number of characters that the user can enter.
+     */
+    minlength;
+    /**
+     * If used in a form, set the name of the control, which is submitted with the form data.
+     */
+    name = this.inputId;
+    /**
+     * Set the input's placeholder.
+     * `placeholder` can accept either plaintext or HTML as a string.
+     * To display characters normally reserved for HTML, they
+     * must be escaped. For example `<Ionic>` would become
+     * `&lt;Ionic&gt;`
+     *
+     * For more information: [Security Documentation](https://ionicframework.com/docs/faq/security)
+     */
+    placeholder = 'Search';
+    /**
+     * The icon to use as the search icon. Defaults to `search-outline` in
+     * `ios` mode and `search-sharp` in `md` mode.
+     */
+    searchIcon;
+    /**
+     * Sets the behavior for the cancel button. Defaults to `"never"`.
+     * Setting to `"focus"` shows the cancel button on focus.
+     * Setting to `"never"` hides the cancel button.
+     * Setting to `"always"` shows the cancel button regardless
+     * of focus state.
+     */
+    showCancelButton = 'never';
+    /**
+     * Sets the behavior for the clear button. Defaults to `"focus"`.
+     * Setting to `"focus"` shows the clear button on focus if the
+     * input is not empty.
+     * Setting to `"never"` hides the clear button.
+     * Setting to `"always"` shows the clear button regardless
+     * of focus state, but only if the input is not empty.
+     */
+    showClearButton = 'always';
+    /**
+     * If `true`, enable spellcheck on the input.
+     */
+    spellcheck = false;
+    /**
+     * Set the type of the input.
+     */
+    type = 'search';
+    /**
+     * the value of the searchbar.
+     */
+    value = '';
+    /**
+     * Emitted when the `value` of the `ion-searchbar` element has changed.
+     */
+    ionInput;
+    /**
+     * The `ionChange` event is fired for `<ion-searchbar>` elements when the user
+     * modifies the element's value. Unlike the `ionInput` event, the `ionChange`
+     * event is not necessarily fired for each alteration to an element's value.
+     *
+     * The `ionChange` event is fired when the value has been committed
+     * by the user. This can happen when the element loses focus or
+     * when the "Enter" key is pressed. `ionChange` can also fire
+     * when clicking the clear or cancel buttons.
+     *
+     * This event will not emit when programmatically setting the `value` property.
+     */
+    ionChange;
+    /**
+     * Emitted when the cancel button is clicked.
+     */
+    ionCancel;
+    /**
+     * Emitted when the clear input button is clicked.
+     */
+    ionClear;
+    /**
+     * Emitted when the input loses focus.
+     */
+    ionBlur;
+    /**
+     * Emitted when the input has focus.
+     */
+    ionFocus;
+    /**
+     * Emitted when the styles change.
+     * @internal
+     */
+    ionStyle;
     valueChanged() {
         const inputEl = this.nativeInput;
         const value = this.getValue();
@@ -232,7 +224,9 @@ export class Searchbar {
         this.emitStyle();
     }
     componentWillLoad() {
-        this.inheritedAttributes = Object.assign({}, inheritAttributes(this.el, ['lang', 'dir']));
+        this.inheritedAttributes = {
+            ...inheritAttributes(this.el, ['lang', 'dir']),
+        };
     }
     componentDidLoad() {
         this.originalIonInput = this.ionInput;
@@ -243,14 +237,13 @@ export class Searchbar {
         }, 300);
     }
     disconnectedCallback() {
-        var _a;
         if (this.loadTimeout) {
             clearTimeout(this.loadTimeout);
         }
         if (this.clearTimeout) {
             clearTimeout(this.clearTimeout);
         }
-        (_a = this.searchIconResizeObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
+        this.searchIconResizeObserver?.disconnect();
     }
     emitStyle() {
         this.ionStyle.emit({
@@ -306,6 +299,105 @@ export class Searchbar {
         const { value } = this;
         this.ionInput.emit({ value, event });
     }
+    /**
+     * Clears the input field and triggers the control change.
+     */
+    onClearInput = async (shouldFocus) => {
+        if (this.clearTimeout) {
+            clearTimeout(this.clearTimeout);
+        }
+        this.ionClear.emit();
+        return new Promise((resolve) => {
+            // setTimeout() fixes https://github.com/ionic-team/ionic-framework/issues/7527
+            // wait for 4 frames
+            this.clearTimeout = setTimeout(() => {
+                const value = this.getValue();
+                if (value !== '') {
+                    this.value = '';
+                    this.emitInputChange();
+                    /**
+                     * When tapping clear button
+                     * ensure input is focused after
+                     * clearing input so users
+                     * can quickly start typing.
+                     */
+                    if (shouldFocus && !this.focused) {
+                        this.setFocus();
+                        /**
+                         * The setFocus call above will clear focusedValue,
+                         * but ionChange will never have gotten a chance to
+                         * fire. Manually revert focusedValue so onBlur can
+                         * compare against what was in the box before the clear.
+                         */
+                        this.focusedValue = value;
+                    }
+                }
+                resolve();
+            }, 16 * 4);
+        });
+    };
+    /**
+     * Clears the input field and tells the input to blur since
+     * the clearInput function doesn't want the input to blur
+     * then calls the custom cancel function if the user passed one in.
+     */
+    onCancelSearchbar = async (ev) => {
+        if (ev) {
+            ev.preventDefault();
+            ev.stopPropagation();
+        }
+        this.ionCancel.emit();
+        // get cached values before clearing the input
+        const value = this.getValue();
+        const focused = this.focused;
+        await this.onClearInput();
+        /**
+         * If there used to be something in the box, and we weren't focused
+         * beforehand (meaning no blur fired that would already handle this),
+         * manually fire ionChange.
+         */
+        if (value && !focused) {
+            this.emitValueChange(ev);
+        }
+        if (this.nativeInput) {
+            this.nativeInput.blur();
+        }
+    };
+    /**
+     * Update the Searchbar input value when the input changes
+     */
+    onInput = (ev) => {
+        const input = ev.target;
+        if (input) {
+            this.value = input.value;
+        }
+        this.emitInputChange(ev);
+    };
+    onChange = (ev) => {
+        this.emitValueChange(ev);
+    };
+    /**
+     * Sets the Searchbar to not focused and checks if it should align left
+     * based on whether there is a value in the searchbar or not.
+     */
+    onBlur = (ev) => {
+        this.focused = false;
+        this.ionBlur.emit();
+        this.positionElements();
+        if (this.focusedValue !== this.value) {
+            this.emitValueChange(ev);
+        }
+        this.focusedValue = undefined;
+    };
+    /**
+     * Sets the Searchbar to focused and active on input focus.
+     */
+    onFocus = () => {
+        this.focused = true;
+        this.focusedValue = this.value;
+        this.ionFocus.emit();
+        this.positionElements();
+    };
     /**
      * Positions the input search icon, placeholder, and the cancel button
      * based on the input value and if it is focused. (ios only)
@@ -348,7 +440,6 @@ export class Searchbar {
             doc.body.appendChild(tempSpan);
             // Get the width of the span then remove it
             raf(() => {
-                var _a, _b;
                 const textWidth = tempSpan.offsetWidth;
                 tempSpan.remove();
                 // Calculate the input padding
@@ -367,15 +458,14 @@ export class Searchbar {
                  * If it is zero, set up a ResizeObserver and call this function when it observes a width greater than 0.
                  */
                 if (iconWidth === 0) {
-                    (_a = this.searchIconResizeObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
+                    this.searchIconResizeObserver?.disconnect();
                     this.searchIconResizeObserver = new ResizeObserver((entries) => {
-                        var _a;
                         if (entries[0].contentRect.width > 0) {
-                            (_a = this.searchIconResizeObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
+                            this.searchIconResizeObserver?.disconnect();
                             this.positionPlaceholder();
                         }
                     });
-                    (_b = this.searchIconResizeObserver) === null || _b === void 0 ? void 0 : _b.observe(iconEl);
+                    this.searchIconResizeObserver?.observe(iconEl);
                     return;
                 }
                 const iconLeft = 'calc(50% - ' + (textWidth / 2 + iconWidth + 8) + 'px)';
@@ -459,8 +549,8 @@ export class Searchbar {
         const clearIcon = this.clearIcon || (mode === 'ios' ? closeCircle : closeSharp);
         const searchIcon = this.searchIcon || (mode === 'ios' ? searchOutline : searchSharp);
         const shouldShowCancelButton = this.shouldShowCancelButton();
-        const cancelButton = this.showCancelButton !== 'never' && (h("button", { key: '226b7a676b4819cda4062b8334fa8d4c4cee6f1a', "aria-label": cancelButtonText, "aria-hidden": shouldShowCancelButton ? undefined : 'true', type: "button", tabIndex: mode === 'ios' && !shouldShowCancelButton ? -1 : undefined, onMouseDown: this.onCancelSearchbar, onTouchStart: this.onCancelSearchbar, class: "searchbar-cancel-button" }, h("div", { key: '89adb4efa17a78c973bbd5527cfac91d99ceb9bb', "aria-hidden": "true" }, mode === 'md' ? (h("ion-icon", { "aria-hidden": "true", mode: mode, icon: this.cancelButtonIcon, lazy: false })) : (cancelButtonText))));
-        return (h(Host, { key: '237dd767403dba3cb3d7de8905996e275669da3b', role: "search", "aria-disabled": this.disabled ? 'true' : null, class: createColorClasses(this.color, {
+        const cancelButton = this.showCancelButton !== 'never' && (h("button", { key: '47ee586db12684db8b2d16a790976bd247cbbc62', "aria-label": cancelButtonText, "aria-hidden": shouldShowCancelButton ? undefined : 'true', type: "button", tabIndex: mode === 'ios' && !shouldShowCancelButton ? -1 : undefined, onMouseDown: this.onCancelSearchbar, onTouchStart: this.onCancelSearchbar, class: "searchbar-cancel-button" }, h("div", { key: '55e6b556a46e7bba14c2cfe1b58542499d2334ab', "aria-hidden": "true" }, mode === 'md' ? (h("ion-icon", { "aria-hidden": "true", mode: mode, icon: this.cancelButtonIcon, lazy: false })) : (cancelButtonText))));
+        return (h(Host, { key: '468d524b52a0d29d840e2c3cdafba46152716b15', role: "search", "aria-disabled": this.disabled ? 'true' : null, class: createColorClasses(this.color, {
                 [mode]: true,
                 'searchbar-animated': animated,
                 'searchbar-disabled': this.disabled,
@@ -470,14 +560,14 @@ export class Searchbar {
                 'searchbar-has-focus': this.focused,
                 'searchbar-should-show-clear': this.shouldShowClearButton(),
                 'searchbar-should-show-cancel': this.shouldShowCancelButton(),
-            }) }, h("div", { key: '5b4bdf7280bea710304b6975e76390fe6ceb7417', class: "searchbar-input-container" }, h("input", Object.assign({ key: '01a0820a2cf904aec1c7d84b542ab7918d435632', "aria-label": "search text", disabled: this.disabled, ref: (el) => (this.nativeInput = el), class: "searchbar-input", inputMode: this.inputmode, enterKeyHint: this.enterkeyhint, name: this.name, onInput: this.onInput, onChange: this.onChange, onBlur: this.onBlur, onFocus: this.onFocus, minLength: this.minlength, maxLength: this.maxlength, placeholder: this.placeholder, type: this.type, value: this.getValue(), autoCapitalize: autocapitalize === 'default' ? undefined : autocapitalize, autoComplete: this.autocomplete, autoCorrect: this.autocorrect, spellcheck: this.spellcheck }, this.inheritedAttributes)), mode === 'md' && cancelButton, h("ion-icon", { key: 'cd64973206b1cc59d221112861733b7ee25f0323', "aria-hidden": "true", mode: mode, icon: searchIcon, lazy: false, class: "searchbar-search-icon" }), h("button", { key: '2061fa8449bbc576cf8c5130ea613378ea492944', "aria-label": "reset", type: "button", "no-blur": true, class: "searchbar-clear-button", onPointerDown: (ev) => {
+            }) }, h("div", { key: '94378bdfdf883c28941ef770d64347705d6f8345', class: "searchbar-input-container" }, h("input", { key: 'deea2190823bf8652703148d308aa21473605930', "aria-label": "search text", disabled: this.disabled, ref: (el) => (this.nativeInput = el), class: "searchbar-input", inputMode: this.inputmode, enterKeyHint: this.enterkeyhint, name: this.name, onInput: this.onInput, onChange: this.onChange, onBlur: this.onBlur, onFocus: this.onFocus, minLength: this.minlength, maxLength: this.maxlength, placeholder: this.placeholder, type: this.type, value: this.getValue(), autoCapitalize: autocapitalize === 'default' ? undefined : autocapitalize, autoComplete: this.autocomplete, autoCorrect: this.autocorrect ? 'on' : 'off', spellcheck: this.spellcheck, ...this.inheritedAttributes }), mode === 'md' && cancelButton, h("ion-icon", { key: '0ecc28496ab545f2064b71b994b4cbf0968c2108', "aria-hidden": "true", mode: mode, icon: searchIcon, lazy: false, class: "searchbar-search-icon" }), h("button", { key: '1bcc77d70eaa08f2ae7fc6173642f114fe387fb7', "aria-label": "reset", type: "button", "no-blur": true, class: "searchbar-clear-button", onPointerDown: (ev) => {
                 /**
                  * This prevents mobile browsers from
                  * blurring the input when the clear
                  * button is activated.
                  */
                 ev.preventDefault();
-            }, onClick: () => this.onClearInput(true) }, h("ion-icon", { key: '00df6f7742bff70b1b088d544b8c00e962e7216c', "aria-hidden": "true", mode: mode, icon: clearIcon, lazy: false, class: "searchbar-clear-icon" }))), mode === 'ios' && cancelButton));
+            }, onClick: () => this.onClearInput(true) }, h("ion-icon", { key: 'bbf8d05eb1070a0d34a22236dfaaf11d8dcc06af', "aria-hidden": "true", mode: mode, icon: clearIcon, lazy: false, class: "searchbar-clear-icon" }))), mode === 'ios' && cancelButton));
     }
     static get is() { return "ion-searchbar"; }
     static get encapsulation() { return "scoped"; }
@@ -589,11 +679,11 @@ export class Searchbar {
                 "defaultValue": "'off'"
             },
             "autocorrect": {
-                "type": "string",
+                "type": "boolean",
                 "mutable": false,
                 "complexType": {
-                    "original": "'on' | 'off'",
-                    "resolved": "\"off\" | \"on\"",
+                    "original": "boolean",
+                    "resolved": "boolean",
                     "references": {}
                 },
                 "required": false,
@@ -606,7 +696,7 @@ export class Searchbar {
                 "setter": false,
                 "reflect": false,
                 "attribute": "autocorrect",
-                "defaultValue": "'off'"
+                "defaultValue": "false"
             },
             "cancelButtonIcon": {
                 "type": "string",