@esri/calcite-components 1.0.0-beta.81 → 1.0.0-beta.84

package/dist/collection/components/combobox/combobox.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-beta.81
+ * v1.0.0-beta.84
  */
 import { Component, h, Prop, State, Listen, Event, Element, Method, Watch, Host } from "@stencil/core";
 import { filter } from "../../utils/filter";
@@ -11,9 +11,10 @@ import { guid } from "../../utils/guid";
 import { ComboboxChildSelector, ComboboxItem, ComboboxItemGroup, TEXT } from "./resources";
 import { getItemAncestors, getItemChildren, hasActiveChildren } from "./utils";
 import { connectLabel, disconnectLabel, getLabelText } from "../../utils/label";
-import { afterConnectDefaultValueSet, connectForm, disconnectForm, HiddenFormInputSlot } from "../../utils/form";
+import { afterConnectDefaultValueSet, connectForm, disconnectForm, HiddenFormInputSlot, submitForm } from "../../utils/form";
 import { createObserver } from "../../utils/observers";
 import { updateHostInteraction } from "../../utils/interactive";
+import { toAriaBoolean } from "../../utils/dom";
 const isGroup = (el) => el.tagName === ComboboxItemGroup;
 const itemUidPrefix = "combobox-item-";
 const chipUidPrefix = "combobox-chip-";
@@ -30,8 +31,14 @@ export class Combobox {
     //  Public Properties
     //
     //--------------------------------------------------------------------------
-    /** Opens or closes the combobox */
+    /**
+     * When true, opens the combobox
+     *
+     * @deprecated use open instead
+     */
     this.active = false;
+    /**When true, opens the combobox */
+    this.open = false;
     /** Disable combobox input */
     this.disabled = false;
     /** Specify the maximum number of combobox items (including nested children) to display before showing the scroller */
@@ -44,7 +51,8 @@ export class Combobox {
      * @internal
      */
     this.required = false;
-    /** specify the selection mode
+    /**
+     * specify the selection mode
      * - multi: allow any number of selected items (default)
      * - single: only one selection)
      * - ancestors: like multi, but show ancestors of selected items as selected, only deepest children shown in chips
@@ -54,7 +62,9 @@ export class Combobox {
     this.scale = "m";
     /** The value(s) of the selectedItem(s) */
     this.value = null;
-    /** string to override the English "Remove tag" text for when an item is selected.
+    /**
+     * string to override the English "Remove tag" text for when an item is selected.
+     *
      * @default "Remove tag"
      */
     this.intlRemoveTag = TEXT.removeTag;
@@ -86,7 +96,7 @@ export class Combobox {
         : null;
     };
     this.getValue = () => {
-      const items = this.selectedItems.map((item) => item === null || item === void 0 ? void 0 : item.value.toString());
+      const items = this.selectedItems.map((item) => { var _a; return (_a = item === null || item === void 0 ? void 0 : item.value) === null || _a === void 0 ? void 0 : _a.toString(); });
       return (items === null || items === void 0 ? void 0 : items.length) ? (items.length > 1 ? items : items[0]) : "";
     };
     this.onLabelClick = () => {
@@ -102,8 +112,9 @@ export class Combobox {
             this.addCustomChip(this.text, true);
             event.preventDefault();
           }
-          else if (this.active) {
+          else if (this.open || this.active) {
             this.active = false;
+            this.open = false;
             event.preventDefault();
           }
           break;
@@ -120,9 +131,10 @@ export class Combobox {
           }
           break;
         case "ArrowDown":
-          if (!this.active) {
+          if (!(this.open || this.active)) {
             event.preventDefault();
             this.active = true;
+            this.open = true;
           }
           this.shiftActiveItemIndex(1);
           if (!this.comboboxInViewport()) {
@@ -133,11 +145,12 @@ export class Combobox {
           if (!this.textInput.value) {
             event.preventDefault();
             this.active = true;
+            this.open = true;
             this.shiftActiveItemIndex(1);
           }
           break;
         case "Home":
-          if (this.active) {
+          if (this.open || this.active) {
             event.preventDefault();
           }
           this.updateActiveItemIndex(0);
@@ -147,7 +160,7 @@ export class Combobox {
           }
           break;
         case "End":
-          if (this.active) {
+          if (this.open || this.active) {
             event.preventDefault();
           }
           this.updateActiveItemIndex(this.visibleItems.length - 1);
@@ -158,6 +171,7 @@ export class Combobox {
           break;
         case "Escape":
           this.active = false;
+          this.open = false;
           break;
         case "Enter":
           if (this.activeItemIndex > -1) {
@@ -169,6 +183,9 @@ export class Combobox {
           else if (this.allowCustomValues && this.text) {
             this.addCustomChip(this.text, true);
           }
+          else if (!event.defaultPrevented) {
+            submitForm(this);
+          }
           break;
         case "Delete":
         case "Backspace":
@@ -183,29 +200,42 @@ export class Combobox {
     };
     this.toggleCloseEnd = () => {
       this.active = false;
+      this.open = false;
       this.el.removeEventListener("calciteComboboxClose", this.toggleCloseEnd);
     };
     this.toggleOpenEnd = () => {
       this.active = true;
+      this.open = false;
       this.el.removeEventListener("calciteComboboxOpen", this.toggleOpenEnd);
     };
     this.transitionEnd = (event) => {
       if (event.propertyName === this.activeTransitionProp) {
-        this.active ? this.calciteComboboxOpen.emit() : this.calciteComboboxClose.emit();
+        this.open || this.active ? this.onOpen() : this.onClose();
       }
     };
-    this.setMaxScrollerHeight = () => {
-      const { active, listContainerEl } = this;
-      if (!listContainerEl || !active) {
+    /* *
+    - `transitionrun` fires when the transition is created at the start of any delay and is not cancellable once started.
+    - if there is no transition delay, both `transitionrun` and `transitionstart` are fired at the same time.
+    */
+    this.transitionRunHandler = (event) => {
+      if (event.propertyName === this.activeTransitionProp) {
+        this.open || this.active ? this.onBeforeOpen() : this.onBeforeClose();
+      }
+    };
+    this.setMaxScrollerHeight = async () => {
+      const { active, listContainerEl, open } = this;
+      const isOpen = !(active || open);
+      if (!listContainerEl || isOpen) {
         return;
       }
-      this.reposition();
+      await this.reposition();
       const maxScrollerHeight = this.getMaxScrollerHeight();
       listContainerEl.style.maxHeight = maxScrollerHeight > 0 ? `${maxScrollerHeight}px` : "";
-      this.reposition();
+      await this.reposition();
     };
     this.calciteChipDismissHandler = (event, comboboxItem) => {
       this.active = false;
+      this.open = false;
       const selection = this.items.find((item) => item === comboboxItem);
       if (selection) {
         this.toggleSelection(selection, false);
@@ -217,12 +247,14 @@ export class Combobox {
         return;
       }
       this.active = !this.active;
+      this.open = !this.open;
       this.updateActiveItemIndex(0);
       this.setFocus();
     };
     this.setInactiveIfNotContained = (event) => {
       const composedPath = event.composedPath();
-      if (!this.active || composedPath.includes(this.el) || composedPath.includes(this.referenceEl)) {
+      const isOpen = !(this.open || this.active);
+      if (isOpen || composedPath.includes(this.el) || composedPath.includes(this.referenceEl)) {
         return;
       }
       if (this.allowCustomValues && this.text.trim().length) {
@@ -237,6 +269,7 @@ export class Combobox {
         this.updateActiveItemIndex(-1);
       }
       this.active = false;
+      this.open = false;
     };
     this.setMenuEl = (el) => {
       this.menuEl = el;
@@ -244,6 +277,7 @@ export class Combobox {
     this.setListContainerEl = (el) => {
       this.resizeObserver.observe(el);
       this.listContainerEl = el;
+      this.listContainerEl.addEventListener("transitionrun", this.transitionRunHandler);
     };
     this.setReferenceEl = (el) => {
       this.referenceEl = el;
@@ -260,7 +294,7 @@ export class Combobox {
       const find = (item, filteredData) => item &&
         filteredData.some(({ label, value }) => {
           if (isGroup(item)) {
-            return value === item.label || value === item.label;
+            return value === item.label;
           }
           return (value === item.textLabel ||
             value === item.value ||
@@ -327,13 +361,15 @@ export class Combobox {
   activeHandler() {
     if (this.disabled) {
       this.active = false;
+      this.open = false;
       return;
     }
-    this.reposition();
+    this.setMaxScrollerHeight();
   }
   handleDisabledChange(value) {
     if (!value) {
       this.active = false;
+      this.open = false;
     }
   }
   maxItemsHandler() {
@@ -370,6 +406,8 @@ export class Combobox {
       return;
     }
     const target = event.target;
+    const newIndex = this.visibleItems.indexOf(target);
+    this.updateActiveItemIndex(newIndex);
     this.toggleSelection(target, target.selected);
   }
   //--------------------------------------------------------------------------
@@ -433,6 +471,9 @@ export class Combobox {
     this.destroyPopper();
     disconnectLabel(this);
     disconnectForm(this);
+    if (this.listContainerEl) {
+      this.listContainerEl.removeEventListener("transitionrun", this.transitionRunHandler);
+    }
   }
   selectedItemsHandler() {
     this.internalValueChangeFlag = true;
@@ -450,6 +491,18 @@ export class Combobox {
       bounding.right <= (window.innerWidth || document.documentElement.clientWidth) &&
       bounding.bottom <= (window.innerHeight || document.documentElement.clientHeight));
   }
+  onBeforeOpen() {
+    this.calciteComboboxBeforeOpen.emit();
+  }
+  onOpen() {
+    this.calciteComboboxOpen.emit();
+  }
+  onBeforeClose() {
+    this.calciteComboboxBeforeClose.emit();
+  }
+  onClose() {
+    this.calciteComboboxClose.emit();
+  }
   getModifiers() {
     const flipModifier = {
       name: "flip",
@@ -460,7 +513,7 @@ export class Combobox {
     };
     const eventListenerModifier = {
       name: "eventListeners",
-      enabled: this.active
+      enabled: this.open || this.active
     };
     return [flipModifier, eventListenerModifier];
   }
@@ -538,6 +591,7 @@ export class Combobox {
         this.textInput.value = item.textLabel;
       }
       this.active = false;
+      this.open = false;
       this.updateActiveItemIndex(-1);
       this.resetText();
       this.filterItems("");
@@ -586,9 +640,9 @@ export class Combobox {
   getData() {
     return this.items.map((item) => ({
       constant: item.constant,
+      filterDisabled: item.filterDisabled,
       value: item.value,
-      label: item.textLabel,
-      guid: item.guid
+      label: item.textLabel
     }));
   }
   getNeedsIcon() {
@@ -720,10 +774,10 @@ export class Combobox {
     });
   }
   renderInput() {
-    const { guid, active, disabled, placeholder, selectionMode, needsIcon, selectedItems } = this;
+    const { guid, active, disabled, placeholder, selectionMode, needsIcon, selectedItems, open } = this;
     const single = selectionMode === "single";
     const selectedItem = selectedItems[0];
-    const showLabel = !active && single && !!selectedItem;
+    const showLabel = !(open || active) && single && !!selectedItem;
     return (h("span", { class: {
         "input-wrap": true,
         "input-wrap--single": single
@@ -741,39 +795,42 @@ export class Combobox {
         }, disabled: disabled, id: `${inputUidPrefix}${guid}`, key: "input", onBlur: this.comboboxBlurHandler, onFocus: this.comboboxFocusHandler, onInput: this.inputHandler, placeholder: placeholder, ref: (el) => (this.textInput = el), type: "text" })));
   }
   renderListBoxOptions() {
-    return this.visibleItems.map((item) => (h("li", { "aria-selected": (!!item.selected).toString(), id: item.guid ? `${itemUidPrefix}${item.guid}` : null, role: "option", tabindex: "-1" }, item.textLabel)));
+    return this.visibleItems.map((item) => (h("li", { "aria-selected": toAriaBoolean(item.selected), id: item.guid ? `${itemUidPrefix}${item.guid}` : null, role: "option", tabindex: "-1" }, item.textLabel)));
   }
   renderPopperContainer() {
-    const { active, setMenuEl, setListContainerEl } = this;
+    const { active, setMenuEl, setListContainerEl, open } = this;
     const classes = {
       "list-container": true,
       [PopperCSS.animation]: true,
-      [PopperCSS.animationActive]: active
+      [PopperCSS.animationActive]: open || active
     };
-    return (h("div", { "aria-hidden": "true", class: { "popper-container": true, "popper-container--active": active }, ref: setMenuEl },
+    return (h("div", { "aria-hidden": "true", class: { "popper-container": true, "popper-container--active": open || active }, ref: setMenuEl },
       h("div", { class: classes, onTransitionEnd: this.transitionEnd, ref: setListContainerEl },
-        h("ul", { class: { list: true, "list--hide": !active } },
+        h("ul", { class: { list: true, "list--hide": !(open || active) } },
           h("slot", null)))));
   }
   renderIconStart() {
-    const { selectionMode, needsIcon, selectedItems } = this;
+    var _a;
+    const { selectionMode, needsIcon, selectedItems, placeholderIcon } = this;
     const selectedItem = selectedItems[0];
     return (selectionMode === "single" &&
-      needsIcon && (h("span", { class: "icon-start" }, (selectedItem === null || selectedItem === void 0 ? void 0 : selectedItem.icon) && (h("calcite-icon", { class: "selected-icon", icon: selectedItem.icon, scale: "s" })))));
+      needsIcon &&
+      ((selectedItem === null || selectedItem === void 0 ? void 0 : selectedItem.icon) || placeholderIcon) && (h("span", { class: "icon-start" },
+      h("calcite-icon", { class: "selected-icon", icon: (_a = selectedItem === null || selectedItem === void 0 ? void 0 : selectedItem.icon) !== null && _a !== void 0 ? _a : placeholderIcon, scale: "s" }))));
   }
   renderIconEnd() {
-    const { active } = this;
+    const { active, open } = this;
     return (h("span", { class: "icon-end" },
-      h("calcite-icon", { icon: active ? "chevron-up" : "chevron-down", scale: "s" })));
+      h("calcite-icon", { icon: active || open ? "chevron-up" : "chevron-down", scale: "s" })));
   }
   render() {
-    const { active, guid, label } = this;
+    const { active, guid, label, open } = this;
     const single = this.selectionMode === "single";
     return (h(Host, { onKeyDown: this.keydownHandler },
-      h("div", { "aria-autocomplete": "list", "aria-expanded": active.toString(), "aria-haspopup": "listbox", "aria-labelledby": `${labelUidPrefix}${guid}`, "aria-owns": `${listboxUidPrefix}${guid}`, class: {
+      h("div", { "aria-autocomplete": "list", "aria-expanded": toAriaBoolean(open || active), "aria-haspopup": "listbox", "aria-labelledby": `${labelUidPrefix}${guid}`, "aria-owns": `${listboxUidPrefix}${guid}`, class: {
           wrapper: true,
           "wrapper--single": single || !this.selectedItems.length,
-          "wrapper--active": active
+          "wrapper--active": open || active
         }, onClick: this.clickHandler, ref: this.setReferenceEl, role: "combobox" },
         h("div", { class: "grid-input" },
           this.renderIconStart(),
@@ -805,13 +862,34 @@ export class Combobox {
       "required": false,
       "optional": false,
       "docs": {
-        "tags": [],
-        "text": "Opens or closes the combobox"
+        "tags": [{
+            "name": "deprecated",
+            "text": "use open instead"
+          }],
+        "text": "When true, opens the combobox"
       },
       "attribute": "active",
       "reflect": true,
       "defaultValue": "false"
     },
+    "open": {
+      "type": "boolean",
+      "mutable": true,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "When true, opens the combobox"
+      },
+      "attribute": "open",
+      "reflect": true,
+      "defaultValue": "false"
+    },
     "disabled": {
       "type": "boolean",
       "mutable": false,
@@ -864,6 +942,23 @@ export class Combobox {
       "attribute": "placeholder",
       "reflect": false
     },
+    "placeholderIcon": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      },
+      "required": false,
+      "optional": true,
+      "docs": {
+        "tags": [],
+        "text": "Placeholder icon for input"
+      },
+      "attribute": "placeholder-icon",
+      "reflect": false
+    },
     "maxItems": {
       "type": "number",
       "mutable": false,
@@ -1145,7 +1240,7 @@ export class Combobox {
       "composed": true,
       "docs": {
         "tags": [],
-        "text": "Called when a selected item in the combobox is dismissed via its chip *"
+        "text": "Called when a selected item in the combobox is dismissed via its chip"
       },
       "complexType": {
         "original": "any",
@@ -1153,22 +1248,23 @@ export class Combobox {
         "references": {}
       }
     }, {
-      "method": "calciteComboboxOpen",
-      "name": "calciteComboboxOpen",
+      "method": "calciteComboboxBeforeClose",
+      "name": "calciteComboboxBeforeClose",
       "bubbles": true,
       "cancelable": true,
       "composed": true,
       "docs": {
-        "tags": [{
-            "name": "internal",
-            "text": undefined
-          }],
-        "text": "Fired when the combobox is opened"
+        "tags": [],
+        "text": ""
       },
       "complexType": {
-        "original": "any",
-        "resolved": "any",
-        "references": {}
+        "original": "{ el: HTMLCalciteComboboxElement }",
+        "resolved": "{ el: HTMLCalciteComboboxElement; }",
+        "references": {
+          "HTMLCalciteComboboxElement": {
+            "location": "global"
+          }
+        }
       }
     }, {
       "method": "calciteComboboxClose",
@@ -1177,16 +1273,55 @@ export class Combobox {
       "cancelable": true,
       "composed": true,
       "docs": {
-        "tags": [{
-            "name": "internal",
-            "text": undefined
-          }],
-        "text": "Fired when the combobox is closed"
+        "tags": [],
+        "text": ""
       },
       "complexType": {
-        "original": "any",
-        "resolved": "any",
-        "references": {}
+        "original": "{ el: HTMLCalciteComboboxElement }",
+        "resolved": "{ el: HTMLCalciteComboboxElement; }",
+        "references": {
+          "HTMLCalciteComboboxElement": {
+            "location": "global"
+          }
+        }
+      }
+    }, {
+      "method": "calciteComboboxBeforeOpen",
+      "name": "calciteComboboxBeforeOpen",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [],
+        "text": ""
+      },
+      "complexType": {
+        "original": "{ el: HTMLCalciteComboboxElement }",
+        "resolved": "{ el: HTMLCalciteComboboxElement; }",
+        "references": {
+          "HTMLCalciteComboboxElement": {
+            "location": "global"
+          }
+        }
+      }
+    }, {
+      "method": "calciteComboboxOpen",
+      "name": "calciteComboboxOpen",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [],
+        "text": ""
+      },
+      "complexType": {
+        "original": "{ el: HTMLCalciteComboboxElement }",
+        "resolved": "{ el: HTMLCalciteComboboxElement; }",
+        "references": {
+          "HTMLCalciteComboboxElement": {
+            "location": "global"
+          }
+        }
       }
     }]; }
   static get methods() { return {
@@ -1227,6 +1362,9 @@ export class Combobox {
   static get watchers() { return [{
       "propName": "active",
       "methodName": "activeHandler"
+    }, {
+      "propName": "open",
+      "methodName": "activeHandler"
     }, {
       "propName": "disabled",
       "methodName": "handleDisabledChange"

package/dist/collection/components/combobox/interfaces.js

@@ -1,6 +1,6 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-beta.81
+ * v1.0.0-beta.84
  */
 export {};

package/dist/collection/components/combobox/resources.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-beta.81
+ * v1.0.0-beta.84
  */
 export const ComboboxItem = "CALCITE-COMBOBOX-ITEM";
 export const ComboboxItemGroup = "CALCITE-COMBOBOX-ITEM-GROUP";
@@ -9,3 +9,8 @@ export const ComboboxChildSelector = `${ComboboxItem}, ${ComboboxItemGroup}`;
 export const TEXT = {
   removeTag: "Remove tag"
 };
+export const CSS = {
+  labelActive: "label--active",
+  labelSelected: "label--selected",
+  listContainer: "list-container"
+};

package/dist/collection/components/combobox/utils.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-beta.81
+ * v1.0.0-beta.84
  */
 import { nodeListToArray } from "../../utils/dom";
 import { ComboboxChildSelector } from "./resources";

package/dist/collection/components/combobox-item/combobox-item.css

@@ -128,7 +128,8 @@
   opacity: 1;
 }
 
-:host, ul{
+:host, 
+ul{
   margin: 0px;
   display: flex;
   flex-direction: column;
@@ -150,9 +151,7 @@
           text-decoration-line: none;
   transition-duration: 150ms;
   transition-timing-function: cubic-bezier(0.4, 0, 0.2, 1);
-  outline-offset: 0;
   outline-color: transparent;
-  transition: outline-offset 100ms ease-in-out, outline-color 100ms ease-in-out;
   padding: var(--calcite-combobox-item-spacing-unit-s) var(--calcite-combobox-item-spacing-unit-l);
 }
 
@@ -170,7 +169,8 @@
   outline-offset: -2px;
 }
 
-.label:hover, .label:active{
+.label:hover, 
+.label:active{
   background-color: var(--calcite-ui-foreground-2);
   color: var(--calcite-ui-text-1);
   -webkit-text-decoration-line: none;

package/dist/collection/components/combobox-item/combobox-item.js

@@ -1,7 +1,7 @@
 /*!
  * All material copyright ESRI, All Rights Reserved, unless otherwise specified.
  * See https://github.com/Esri/calcite-components/blob/master/LICENSE.md for details.
- * v1.0.0-beta.81
+ * v1.0.0-beta.84
  */
 import { Component, Element, Event, Host, Method, Prop, h, Watch } from "@stencil/core";
 import { getElementProp, getSlotted } from "../../utils/dom";
@@ -69,6 +69,8 @@ export class ComboboxItem {
   /**
    * Used to toggle the selection state. By default this won't trigger an event.
    * The first argument allows the value to be coerced, rather than swapping values.
+   *
+   * @param coerce
    */
   async toggleSelected(coerce) {
     if (this.disabled) {
@@ -284,11 +286,31 @@ export class ComboboxItem {
       "required": false,
       "optional": false,
       "docs": {
-        "tags": [],
+        "tags": [{
+            "name": "deprecated",
+            "text": "use filterDisabled instead"
+          }],
         "text": "Don't filter this item based on the search text"
       },
       "attribute": "constant",
       "reflect": true
+    },
+    "filterDisabled": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [],
+        "text": "Do not filter this item based on the search text"
+      },
+      "attribute": "filter-disabled",
+      "reflect": false
     }
   }; }
   static get events() { return [{
@@ -312,7 +334,10 @@ export class ComboboxItem {
       "complexType": {
         "signature": "(coerce?: boolean) => Promise<void>",
         "parameters": [{
-            "tags": [],
+            "tags": [{
+                "name": "param",
+                "text": "coerce"
+              }],
             "text": ""
           }],
         "references": {
@@ -324,7 +349,10 @@ export class ComboboxItem {
       },
       "docs": {
         "text": "Used to toggle the selection state. By default this won't trigger an event.\nThe first argument allows the value to be coerced, rather than swapping values.",
-        "tags": []
+        "tags": [{
+            "name": "param",
+            "text": "coerce"
+          }]
       }
     }
   }; }