@arcgis/map-components 5.2.0-next.11 → 5.2.0-next.111

package/dist/components/arcgis-search/customElement.d.ts

@@ -24,6 +24,9 @@ import type { GoToOverride } from "@arcgis/core/widgets/support/types.js";
  * If a global apiKey is present, the Search component uses this URL: `https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer`. If an apiKey
  * is present on the LocatorSearchSource, then the Search component uses the URL defined by the LocatorSearchSource.url property.
  *
+ * For popups, we recommend using either [popup-component-enabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupComponentEnabled),
+ * or adding the [arcgis-popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/) to your view components as a best practice.
+ *
  * The Search component sets the view on the Search result. The level of detail (LOD) at the center of the view depends on the data source, with higher quality data
  * sources returning extents closer to the `feature` obtained from the search. To manually define the scale of the view at the Search result, use the `zoomScale` property
  * of the LocatorSearchSource or LayerSearchSource. Search component results are typically sorted according to their relevance to the search and their relative importance.
@@ -31,9 +34,11 @@ import type { GoToOverride } from "@arcgis/core/widgets/support/types.js";
  * specified point (the center of the view) by passing in the `location parameter`. Features closest to the input location show up higher in the list of results.
  * This behavior can be changed by using the localSearchDisabled property.
  *
- *  Starting with version `5.1`, on [@arcgisSelectResult](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-search/#event-arcgisSelectResult) the selected search result is announced to assistive technologies. Visit the [Accessibility guide](https://developers.arcgis.com/javascript/latest/accessibility/#assistive-technologies) to learn more
+ * Starting with version `5.1`, on [@arcgisSelectResult](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-search/#event-arcgisSelectResult) the selected search result is announced to assistive technologies. Visit the [Accessibility guide](https://developers.arcgis.com/javascript/latest/accessibility/#assistive-technologies) to learn more
  * about live announcements supporting more audiences.
  *
+ * @see [Sample - Search component with multiple sources](https://developers.arcgis.com/javascript/latest/sample-code/search-component-multisource/)
+ * @see [Sample - Search component with custom source](https://developers.arcgis.com/javascript/latest/sample-code/search-component-customsource/)
  * @since 4.28
  */
 export abstract class ArcgisSearch extends LitElement {
@@ -82,6 +87,15 @@ export abstract class ArcgisSearch extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-search auto-destroy-disabled></arcgis-search>
+   * ```
+   *
+   * ```js
+   * searchElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -117,7 +131,7 @@ export abstract class ArcgisSearch extends LitElement {
    */
   get defaultSources(): Collection<SupportedSearchSource>;
   /**
-   * When true, the component is visually withdrawn and cannot receive user interaction.
+   * When true, the component is visually de-emphasized and does not accept user interaction.
    *
    * @default false
    */
@@ -168,7 +182,7 @@ export abstract class ArcgisSearch extends LitElement {
    * **Note:**
    * The use of this property is only supported on secure origins.
    * To use it, switch your application to a secure origin, such as HTTPS.
-   * Note that localhost is considered "potentially secure" and can be used for easy testing in browsers that supports
+   * Note that localhost is considered "potentially secure" and can be used for easy testing in browsers that support
    * [Window.isSecureContext](https://developer.mozilla.org/docs/Web/API/isSecureContext#browser_compatibility)
    * (currently Chrome and Firefox).
    *
@@ -209,10 +223,8 @@ export abstract class ArcgisSearch extends LitElement {
       noResults?: string | undefined;
       noResultsFound?: string | undefined;
       noResultsFoundForValue?: string | undefined;
-      showMoreResults?: string | undefined;
-      hideMoreResults?: string | undefined;
       searchResult?: string | undefined;
-      moreResultsHeader?: string | undefined;
+      searchResults?: string | undefined;
       useCurrentLocation?: string | undefined;
       resultSelected?: string | undefined;
   };
@@ -230,10 +242,8 @@ export abstract class ArcgisSearch extends LitElement {
       noResults: string;
       noResultsFound: string;
       noResultsFoundForValue: string;
-      showMoreResults: string;
-      hideMoreResults: string;
       searchResult: string;
-      moreResultsHeader: string;
+      searchResults: string;
       useCurrentLocation: string;
       resultSelected: string;
   } & T9nMeta<{
@@ -249,10 +259,8 @@ export abstract class ArcgisSearch extends LitElement {
       noResults: string;
       noResultsFound: string;
       noResultsFoundForValue: string;
-      showMoreResults: string;
-      hideMoreResults: string;
       searchResult: string;
-      moreResultsHeader: string;
+      searchResults: string;
       useCurrentLocation: string;
       resultSelected: string;
   }>;
@@ -451,8 +459,8 @@ export abstract class ArcgisSearch extends LitElement {
    */
   accessor topLayerDisabled: boolean;
   /**
-   * The view associated with the component. 
-   *   > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-search component will be associated with a map or scene component rather than using the `view` property.
+   * The view associated with the component.
+   * > **Note:** The recommended approach is to fully migrate applications to use map and scene components and avoid using MapView and SceneView directly. However, if you are migrating a large application from widgets to components, you might prefer a more gradual transition. To support this use case, the SDK includes this `view` property which connects a component to a MapView or SceneView. Ultimately, once migration is complete, the arcgis-search component will be associated with a map or scene component rather than using the `view` property.
    */
   accessor view: MapViewOrSceneView | null | undefined;
   /**
@@ -486,7 +494,7 @@ export abstract class ArcgisSearch extends LitElement {
   suggest(query?: string): Promise<null | undefined | SuggestResponse>;
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
   readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "state"; }>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   /** Fires when a result is cleared from the input box or a new result is selected. */
   readonly arcgisSearchClear: import("@arcgis/lumina").TargetedEvent<this, SearchViewModelEvents["search-clear"]>;

package/dist/components/arcgis-search/customElement.js

@@ -207,12 +207,12 @@ class z extends f {
     const { allSources: t, activeSourceIndex: i } = this.viewModel, { sourceIndex: r } = e, o = e.results?.length, l = t.length > 1 && i === -1, c = this._getSourceName(r);
     return o && l ? s`<calcite-autocomplete-item-group .heading=${c}>${this._renderSuggestGroup(e)}</calcite-autocomplete-item-group>` : this._renderSuggestGroup(e);
   }
-  _renderSuggestion({ key: e, sourceIndex: t, text: i }) {
-    const r = {
-      key: e,
-      sourceIndex: t
+  _renderSuggestion(e) {
+    const { key: t, sourceIndex: i, text: r } = e, o = {
+      key: t,
+      sourceIndex: i
     };
-    return s`<calcite-autocomplete-item .heading=${i ?? this.messages.untitledResult ?? ""} .value=${JSON.stringify(r)}></calcite-autocomplete-item>`;
+    return s`<calcite-autocomplete-item .heading=${r ?? this.messages.untitledResult ?? ""} .value=${JSON.stringify(o)} .selected=${e === this.viewModel.selectedSuggestion}></calcite-autocomplete-item>`;
   }
   _renderSource(e) {
     const t = this._getSourceName(e);

package/dist/components/arcgis-search-result-renderer/customElement.d.ts

@@ -4,8 +4,7 @@ import type { ArcgisSearch } from "../arcgis-search/customElement.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 
 /**
- * The Search Result Renderer renders the Search component results and allows expanding a DOM element to show alternative matches.
- * These alternative matches appear in the Show more results link.
+ * The Search Result Renderer renders the Search component results and supports selecting alternate matches.
  *
  * @internal
  */
@@ -18,13 +17,22 @@ export abstract class ArcgisSearchResultRenderer extends LitElement {
    * prevent memory leaks.
    *
    * @default false
+   * @example
+   * ```html
+   * <arcgis-search-result-renderer auto-destroy-disabled></arcgis-search-result-renderer>
+   * ```
+   *
+   * ```js
+   * searchResultRendererElement.autoDestroyDisabled = true;
+   * ```
+   * 
    */
   accessor autoDestroyDisabled: boolean;
   accessor messages: ArcgisSearch["messages"] | undefined;
   accessor viewModel: SearchViewModel | undefined;
   /** Permanently destroy the component. */
   destroy(): Promise<void>;
-  /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
+  /** Emitted when the component associated with a map or scene view is ready for user interaction. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   readonly "@eventTypes": {
     arcgisReady: ArcgisSearchResultRenderer["arcgisReady"]["detail"];

package/dist/components/arcgis-search-result-renderer/customElement.js

@@ -1,64 +1,50 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { c } from "../../chunks/runtime.js";
-import { css as d, html as r } from "lit";
-import { keyed as a } from "lit/directives/keyed.js";
-import { LitElement as g, createEvent as u, safeClassMap as p } from "@arcgis/lumina";
-import { classes as h } from "@arcgis/toolkit/dom";
-import { g as _ } from "../../chunks/globalCss.js";
-import { watch as n } from "@arcgis/core/core/reactiveUtils.js";
-import { substitute as m } from "@arcgis/core/intl.js";
-const f = d`.esri-widget__heading{color:var(--calcite-color-text-2);margin:0 0 .5rem;font-weight:var(--calcite-font-weight-semibold)}h1.esri-widget__heading{font-size:var(--calcite-font-size-xl)}h2.esri-widget__heading{font-size:var(--calcite-font-size-md)}h3.esri-widget__heading,h4.esri-widget__heading,h5.esri-widget__heading,h6.esri-widget__heading{font-size:var(--calcite-font-size)}.esri-widget{box-sizing:border-box;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget *,.esri-widget :before,.esri-widget :after{box-sizing:inherit}.esri-widget.esri-widget--disabled>*{opacity:.4;pointer-events:none}.esri-widget.esri-widget--compact{--esri-widget-padding-y: 0;--esri-widget-padding-x: 0}.esri-widget__anchor{color:var(--calcite-color-text-2)}.esri-widget__anchor:hover{color:var(--calcite-color-text-3)}.esri-widget__anchor:hover,.esri-widget__anchor:focus{text-decoration:underline}.esri-widget__anchor--disabled{opacity:.4;pointer-events:none}.esri-widget__header{background-color:var(--calcite-color-foreground-1);flex:1 0 100%;justify-content:space-between;align-items:center;width:100%;min-height:48px;padding:12px 0 12px 15px;display:flex}.esri-widget__heading{word-break:break-word}.esri-widget__header .esri-widget__heading{width:calc(100% - 48px);text-align:initial;color:var(--calcite-color-text-1);align-items:center;margin:0;padding:0;display:flex}.esri-widget__header-button{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background-color:var(--calcite-color-foreground-1);border:none;flex:0 0 48px;justify-content:center;align-self:stretch;align-items:center;width:48px;padding:0;display:flex}.esri-widget__footer{background-color:var(--calcite-color-foreground-1);justify-content:center;align-items:center;width:100%;min-height:48px;display:flex}.esri-widget__footer-pagination{color:var(--calcite-color-text-2);justify-content:space-between;align-items:center;display:flex}.esri-widget__footer-pagination-previous-button,.esri-widget__footer-pagination-next-button{cursor:pointer;background-color:var(--calcite-color-foreground-1);border:0;margin:0 7px;padding:12px 15px;transition:background-color .125s ease-in-out}.esri-widget__footer-pagination-previous-button:hover,.esri-widget__footer-pagination-previous-button:focus,.esri-widget__footer-pagination-next-button:hover,.esri-widget__footer-pagination-next-button:focus{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1)}.esri-menu{visibility:hidden;z-index:1;background-clip:padding;background-color:var(--calcite-color-foreground-1);background-clip:padding-box;width:100%;max-height:0;margin:2px 0 0;padding:0;font-size:var(--calcite-font-size);line-height:var(--calcite-spacing-xl);position:absolute;top:100%;left:0;overflow:hidden;box-shadow:0 1px 2px #0000004d}.esri-menu .esri-menu__header{color:var(--calcite-color-text-inverse);background-color:var(--calcite-color-inverse);padding:6px 12px}.esri-menu__list{margin:0;padding:0;list-style:none}.esri-menu__list-item{cursor:pointer;border-top:1px solid #adadad4d;border-left:3px solid #0000;padding:.8em 1em}.esri-menu__list-item [class^=esri-icon-],.esri-menu__list-item [class*=" esri-icon-"]{padding-right:2.8px}.esri-menu__list-item:first-child{border-top:none}.esri-menu__list-item--focus,.esri-menu__list-item:hover,.esri-menu__list-item:focus{background-color:var(--calcite-color-foreground-1)}.esri-menu__list-item:active{background-color:var(--calcite-color-foreground-current)}.esri-menu__list-item--active,.esri-menu__list-item--active:hover,.esri-menu__list-item--active:focus{background-color:var(--calcite-color-foreground-1);border-left-color:var(--calcite-color-brand)}.esri-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:var(--calcite-font-line-height-relative-tight)}.esri-widget__table tr:nth-child(odd){background-color:var(--calcite-color-transparent)}.esri-widget__table tr:nth-child(2n){background-color:var(--calcite-color-transparent-press)}.esri-widget__table tr a{color:var(--calcite-color-text-2)}.esri-widget__table tr a:hover,.esri-widget__table tr a:focus{color:var(--calcite-color-text-1)}.esri-widget__table tr td,.esri-widget__table tr th{vertical-align:top;word-break:break-word;padding:.5em .7em;font-size:var(--calcite-font-size-sm);font-weight:var(--calcite-font-weight-regular)}.esri-widget__table tr th{text-align:left;border-right:3px solid #0000000d;width:50%}.esri-widget__table tr td{width:50%}.esri-input{color:var(--calcite-color-text-1);background-color:var(--calcite-color-foreground-1);border:1px solid #959595;font-size:var(--calcite-font-size)}.esri-input::-ms-clear{display:none}.esri-input::placeholder{opacity:1;color:var(--calcite-color-text-2)}.esri-input:placeholder-shown{text-overflow:ellipsis}.esri-input[type=text],.esri-input[type=password],.esri-input[type=number]{height:32px;padding:0 .5em}calcite-combobox.esri-input{border:none}.esri-widget__content--empty{text-align:center;color:var(--calcite-color-border-input);flex-flow:column wrap;align-items:center;padding:18px 22px;display:flex}.esri-widget__content--empty h1.esri-widget__heading,.esri-widget__content--empty h2.esri-widget__heading,.esri-widget__content--empty h3.esri-widget__heading,.esri-widget__content--empty h4.esri-widget__heading,.esri-widget__content--empty h5.esri-widget__heading{font-weight:var(--calcite-font-weight-regular)}.esri-widget__content-illustration--empty{width:128px;padding:1rem 0}.esri-widget__content-icon--empty{width:32px;padding:.5rem 0}.esri-select{appearance:none;cursor:pointer;color:var(--calcite-color-text-2);background:var(--calcite-color-foreground-1) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='-8 -8 32 32' width='32' height='32'%3E%3Cpath d='M8 11.207l-4-4V5.793l4 4 4-4v1.414z' fill='%23adadad' fillrule='nonzero'/%3E%3C/svg%3E") 100% no-repeat;border:1px solid #959595;border-radius:0;width:100%;height:32px;margin:0;padding:0 .5em;font-family:inherit;font-size:.85em;display:block}.esri-select[disabled]{cursor:auto}.esri-select::-ms-expand{display:none}.esri-disabled a,.esri-disabled [role=menu],.esri-disabled [role=checkbox],.esri-disabled [class^=esri-icon-],.esri-disabled [class*=" esri-icon-"]{color:var(--calcite-color-text-3)}.keynav-mode .esri-widget:focus,.keynav-mode .esri-widget :focus{z-index:1;outline-offset:2px;outline:2px solid #adadad}.esri-widget__loader-animation{border:.15em solid #adadad4d;border-top-color:var(--calcite-color-border-input);border-radius:100%;width:1em;height:1em;font-size:var(--calcite-font-size-md);animation:1.25s linear infinite esri-rotate;display:block;transform:translateZ(0)}:dir(rtl) .esri-widget__table th{text-align:right;border-left:3px solid #0000000d;border-right:none}:dir(rtl) .esri-select{background-position:0}:dir(rtl) .esri-menu__list-item{border-left:none;border-right:3px solid #0000}:dir(rtl) .esri-menu__list-item [class^=esri-icon-],:dir(rtl) .esri-menu__list-item [class*=" esri-icon-"]{padding-left:2px;padding-right:0}:dir(rtl) .esri-menu__list-item--active{border-right-color:var(--calcite-color-brand)}.esri-icon-font-fallback-text{clip:rect(0 0 0 0);width:1px;height:1px;position:absolute;overflow:hidden}.esri-rotating{animation:1.25s linear infinite esri-rotate;transform:translateZ(0)}.esri-clearfix:before,.esri-clearfix:after{content:" ";display:table}.esri-clearfix:after{clear:both}.esri-interactive{cursor:pointer}.esri-hidden{display:none!important}.esri-invisible{visibility:hidden!important}.esri-offscreen{position:absolute;top:-999em;left:-999em}.esri-match-height{flex-direction:column;flex:auto;display:flex;overflow:hidden}.root calcite-block,.root calcite-block[expanded]{margin-block:0;margin-block-start:var(--calcite-spacing-md);border:0}`;
-class w extends g {
+import { c as n } from "../../chunks/runtime.js";
+import { html as i } from "lit";
+import { keyed as l } from "lit/directives/keyed.js";
+import { LitElement as a, createEvent as m } from "@arcgis/lumina";
+import { watch as o } from "@arcgis/core/core/reactiveUtils.js";
+class d extends a {
   constructor() {
-    super(...arguments), this._resultCount = 0, this._showMoreResultsOpen = !1, this.autoDestroyDisabled = !1, this.arcgisReady = u();
+    super(...arguments), this._resultCount = 0, this.autoDestroyDisabled = !1, this.arcgisReady = m();
   }
   static {
-    this.properties = { _results: 16, _resultCount: 16, _selectedResult: 16, _showMoreResultsOpen: 16, messages: 0, autoDestroyDisabled: 5, viewModel: 0 };
-  }
-  static {
-    this.styles = f;
+    this.properties = { _results: 16, _resultCount: 16, _selectedResult: 16, messages: 0, autoDestroyDisabled: 5, viewModel: 0 };
   }
   async destroy() {
     await this.manager.destroy();
   }
   loaded() {
     this.manager.onLifecycle(() => [
-      n(() => [this.viewModel?.results, this.viewModel?.resultCount], () => {
-        this._results = this.viewModel?.results, this._resultCount = this.viewModel?.resultCount ?? 0, this._showMoreResultsOpen = !1;
+      o(() => [this.viewModel?.results, this.viewModel?.resultCount], () => {
+        this._results = this.viewModel?.results, this._resultCount = this.viewModel?.resultCount ?? 0;
       }, { initial: !0 }),
-      n(() => this.viewModel?.selectedResult, (e) => this._selectedResult = e, { initial: !0 })
+      o(() => this.viewModel?.selectedResult, (e) => this._selectedResult = e, { initial: !0 })
     ]);
   }
   _selectResult(e) {
-    this._showMoreResultsOpen = !1, this.viewModel?.select(e);
+    this.viewModel?.select(e);
   }
   _getSourceName(e, t) {
     return t === -1 ? this.messages?.all ?? "" : e.name;
   }
-  _toggleShowMoreResults(e) {
-    this._showMoreResultsOpen = e;
-    const t = this.viewModel?.view?.popup;
-    t && "reposition" in t && t.reposition();
-  }
   render() {
-    return r`<div class=${p(h("root", _.widget))}>${this._selectedResult?.name ?? ""}${this._renderMoreResults()}</div>`;
-  }
-  _renderMoreResults() {
     const { _resultCount: e, _results: t } = this;
-    return !e || e < 2 || !t ? null : r`<calcite-block class="more-results" collapsible .expanded=${this._showMoreResultsOpen} .heading=${m(this.messages?.showMoreResults ?? "", { count: e - 1 })} @calciteBlockClose=${() => this._toggleShowMoreResults(!1)} @calciteBlockOpen=${() => this._toggleShowMoreResults(!0)}>${t.map((i) => this._renderMoreResultsList(i, t?.length > 1))}</calcite-block>`;
+    return !e || !t ? null : e === 1 ? this._selectedResult?.name ?? null : t.map((s) => this._renderResultsList(s, t?.length > 1));
   }
-  _renderMoreResultsList(e, t) {
-    const { results: i } = e;
-    if (!(i?.length ?? 0) || !i)
+  _renderResultsList(e, t) {
+    const { results: s } = e;
+    if (!(s?.length ?? 0) || !s)
       return null;
-    const s = this._getSourceName(e.source, e.sourceIndex), l = i.filter((o) => o !== this._selectedResult).map((o) => this._renderListItem(o));
-    return r`<calcite-list .label=${s}>${t ? a(`group-${e.sourceIndex}`, r`<calcite-list-item-group .heading=${s}>${l}</calcite-list-item-group>`) : l}</calcite-list>`;
+    const u = this._getSourceName(e.source, e.sourceIndex), r = s.map((c) => this._renderListItem(c));
+    return i`<calcite-list .label=${this.messages?.searchResults ?? ""} scale=s selection-mode=single-persist>${t ? l(`group-${e.sourceIndex}`, i`<calcite-list-item-group .heading=${u}>${r}</calcite-list-item-group>`) : r}</calcite-list>`;
   }
   _renderListItem(e) {
-    return a(`result-${e.sourceIndex}-${e.key}`, r`<calcite-list-item .label=${e.name} @calciteListItemSelect=${() => this._selectResult(e)}></calcite-list-item>`);
+    const t = e === this._selectedResult;
+    return l(`result-${e.sourceIndex}-${e.key}`, i`<calcite-list-item .selected=${t} .label=${e.name} @calciteListItemSelect=${t ? void 0 : () => this._selectResult(e)}></calcite-list-item>`);
   }
 }
-c("arcgis-search-result-renderer", w);
+n("arcgis-search-result-renderer", d);
 export {
-  w as ArcgisSearchResultRenderer
+  d as ArcgisSearchResultRenderer
 };

package/dist/components/arcgis-search-result-renderer/index.js

@@ -1,4 +1,3 @@
-import "@esri/calcite-components/components/calcite-block";
 import "@esri/calcite-components/components/calcite-list";
 import "@esri/calcite-components/components/calcite-list-item-group";
 import "@esri/calcite-components/components/calcite-list-item";