@arcgis/map-components 4.34.0-next.125 → 4.34.0-next.127

package/dist/components/arcgis-histogram-range-slider/customElement.d.ts

@@ -21,7 +21,7 @@ declare const useHistogramRangeSliderWidget: (component: LitElement & Pick<Histo
         childElem? /** @copyDoc */: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
+        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView | nullish;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;

package/dist/components/arcgis-histogram-range-slider/customElement.js

@@ -6,7 +6,7 @@ import { m as a } from "../../chunks/useWidget.js";
 import { css as l } from "lit";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.125 */
+v4.34.0-next.127 */
 const n = l`.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{--esri-widget-padding-x: 15px;--esri-widget-padding-y: var(--calcite-spacing-md);--esri-widget-padding: var(--esri-widget-padding-y) var(--esri-widget-padding-x);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:1.3em}.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__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:#303030}.esri-menu__list-item:active{background-color:#000}.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:#2493f2}.esri-widget__table{border-collapse:collapse;color:var(--calcite-color-text-1);border:none;width:100%;line-height:1.3em}.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}@supports (-ms-ime-align: auto){.esri-slider__anchor:focus{outline:1px dotted var(--calcite-color-foreground-current)}}.esri-slider{-webkit-user-select:none;user-select:none;direction:ltr;width:100%;height:100%;display:flex}.esri-disabled{pointer-events:none}.esri-disabled .esri-slider__content,.esri-disabled .esri-slider__min,.esri-disabled .esri-slider__max{opacity:var(--calcite-opacity-light)}.esri-slider--reversed.esri-slider--horizontal{flex-direction:row-reverse}.esri-slider--reversed.esri-slider--vertical{flex-direction:column}.esri-slider--horizontal{flex-direction:row}.esri-slider--horizontal .esri-slider__content{height:auto}.esri-slider--horizontal .esri-slider__track{width:100%;height:2px}.esri-slider--horizontal .esri-slider__segment--interactive:hover{cursor:ew-resize}.esri-slider--horizontal .esri-slider__anchor{width:1px;height:100%}.esri-slider--horizontal .esri-slider__label{text-align:center;margin:0 11px;top:-30px;left:-50px}.esri-slider--horizontal .esri-slider__label-input{text-align:center}.esri-slider--horizontal .esri-slider__max,.esri-slider--horizontal .esri-slider__min{flex:none;width:50px;height:auto;margin:auto}.esri-slider--horizontal .esri-slider__ticks{width:100%;margin:9px 0 0;top:100%;left:0}.esri-slider--horizontal .esri-slider__tick{width:1px;height:5px}.esri-slider--horizontal .esri-slider__tick-label{margin-top:18px}.esri-slider--vertical{flex-direction:column-reverse}.esri-slider--vertical .esri-slider__content{flex-direction:column;width:auto}.esri-slider--vertical .esri-slider__track{flex-direction:column;flex:1 0 0;width:2px;height:100%}.esri-slider--vertical .esri-slider__segment--interactive:hover{cursor:ns-resize}.esri-slider--vertical .esri-slider__anchor{width:100%;height:1px}.esri-slider--vertical .esri-slider__label{text-align:left;top:-10px;left:20px}.esri-slider--vertical .esri-slider__max,.esri-slider--vertical .esri-slider__min{flex:0 0 22px;width:100%;margin:auto}.esri-slider--vertical .esri-slider__ticks{margin:0 0 0 11px;top:0;left:100%}.esri-slider--vertical .esri-slider__tick{width:5px;height:1px}.esri-slider--vertical .esri-slider__tick-label{margin-left:30px}.esri-slider__content{z-index:0;flex:1 0 auto;justify-content:center;align-items:center;margin:auto;line-height:0;display:flex;position:relative}.esri-slider__track{touch-action:none;background-color:var(--calcite-color-border-ghost);display:inline-block;position:relative}.esri-slider__segment{transform-origin:0 0;will-change:transform;touch-action:none;width:100%;height:100%;position:absolute;top:0;left:0}.esri-slider__segment:hover{cursor:pointer}.esri-slider__anchor{touch-action:none;-webkit-user-select:none;user-select:none;background-color:var(--calcite-color-brand);position:absolute}.esri-slider__anchor:focus .esri-slider__thumb,.esri-slider__anchor:focus .esri-slider__label{outline:inherit}.esri-slider__anchor--moving:focus .esri-slider__thumb{cursor:grabbing;border:3px solid var(--calcite-color-brand-press)}.esri-slider__anchor--moving .esri-slider__label:hover,.esri-slider__anchor--moving .esri-slider__label--interactive:hover{cursor:grabbing}.esri-slider__thumb{box-sizing:border-box;z-index:1;touch-action:none;background-color:var(--calcite-color-foreground-2);border:2px solid var(--calcite-color-brand);border-radius:16px;width:16px;height:16px;transition:all .125s ease-in-out;position:absolute;top:-7px;left:-7px}.esri-slider__thumb:hover{cursor:grab;border-width:3px;border-color:var(--calcite-color-brand-press);width:19.2px;height:19.2px;top:-8.6px;left:-8.6px}.esri-slider__label{min-width:80px;line-height:22px;position:absolute}.esri-slider__label:hover{cursor:grab}.esri-slider__label--interactive:hover,.esri-slider__max--interactive:hover,.esri-slider__min--interactive:hover{cursor:pointer;text-decoration:underline}.esri-slider__label-input{z-index:1;width:100%;position:relative}.esri-slider__extra-content{display:inline-block}.esri-slider__max,.esri-slider__min{text-align:center;justify-content:center;align-items:center;height:22px;line-height:22px;display:flex}.esri-slider__max--interactive:hover,.esri-slider__min--interactive:hover{background-color:var(--calcite-color-foreground-2)}.esri-slider__range-input{text-align:center;width:100%;padding:1px 0}.esri-slider__ticks{z-index:0;height:100%;display:inline-block;position:absolute}.esri-slider__tick{background:var(--calcite-color-foreground-1);position:absolute}.esri-slider__tick-label{width:max-content;position:absolute}:dir(rtl) .esri-slider__label,:dir(rtl) .esri-slider__max,:dir(rtl) .esri-slider__min,:dir(rtl) .esri-slider__tick-label{direction:rtl;unicode-bidi:plaintext}:dir(rtl) .esri-slider__range-input,:dir(rtl) .esri-slider__label-input{unicode-bidi:plaintext}.esri-histogram-range-slider{flex-direction:column;width:100%;height:100%;display:flex;position:relative}.esri-histogram-range-slider .esri-slider .esri-slider__label{display:none;top:24px}.esri-histogram-range-slider .esri-slider__anchor--moving .esri-slider__label{display:inline}.esri-histogram-range-slider .esri-slider{font-size:var(--calcite-font-size-sm)}.esri-histogram-range-slider .esri-slider__content{flex-direction:column-reverse;display:flex}.esri-histogram-range-slider .esri-slider__max{text-align:right;position:absolute;bottom:0;right:0}.esri-histogram-range-slider .esri-slider__max .esri-slider__range-input{float:right;text-align:right}.esri-histogram-range-slider .esri-slider__min{text-align:left;position:absolute;bottom:0;left:0}.esri-histogram-range-slider .esri-slider__min .esri-slider__range-input{text-align:left}.esri-histogram-range-slider .esri-slider--horizontal .esri-slider__max,.esri-histogram-range-slider .esri-slider--horizontal .esri-slider__min{min-width:50%;display:inline}.esri-histogram-range-slider .esri-histogram{align-self:flex-end;display:flex}.esri-histogram-range-slider .esri-histogram__bar{touch-action:none}.esri-histogram-range-slider__slider-container{align-self:flex-end;width:100%;margin-bottom:var(--calcite-font-size-xxl)}.esri-histogram-range-slider__histogram-container{flex-grow:1;width:100%;height:100%;min-height:0;display:flex}.esri-histogram-range-slider__range-type--less-than .esri-slider__segment-0,.esri-histogram-range-slider__range-type--at-most .esri-slider__segment-0,.esri-histogram-range-slider__range-type--greater-than .esri-slider__segment-1,.esri-histogram-range-slider__range-type--at-least .esri-slider__segment-1,.esri-histogram-range-slider__range-type--between .esri-slider__segment-1,.esri-histogram-range-slider__range-type--not-between .esri-slider__segment-1{background-color:#0079c1}`, d = a(t);
 class c extends s {
   constructor() {

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

@@ -26,6 +26,12 @@ declare const useHomeViewModel: (component: LitElement & Pick<HomeViewModel, nev
  * ```
  */
 export declare class ArcgisHome extends LitElement {
+    /**
+     * The view associated with the widget instance.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Home-HomeViewModel.html#view)
+     */
+    view?: __esri.MapView | __esri.SceneView | nullish;
     /**
      * If true, the component will not be destroyed automatically when it is
      * disconnected from the document. This is useful when you want to move the

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

@@ -3,26 +3,26 @@ import { css as r, html as i } from "lit";
 import { usePropertyChange as l } from "@arcgis/lumina/controllers";
 import { reEmitEvent as n } from "@arcgis/lumina/controllers/accessor";
 import { classes as h } from "@arcgis/toolkit/dom";
-import m from "@arcgis/core/widgets/Home/HomeViewModel.js";
-import { LitElement as d, createEvent as g, safeClassMap as v, nothing as u } from "@arcgis/lumina";
+import d from "@arcgis/core/widgets/Home/HomeViewModel.js";
+import { LitElement as m, createEvent as g, safeClassMap as v, nothing as u } from "@arcgis/lumina";
 import { u as p } from "../../chunks/useT9n.js";
-import { m as b } from "../../chunks/useViewModel.js";
+import { m as w } from "../../chunks/useViewModel.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.125 */
-const f = r`.arcgis-button{--calcite-ui-icon-color: var(--calcite-color-text-3);--calcite-button-background-color: var(--calcite-color-foreground-1);color:var(--calcite-color-text-3);line-height:1.3em;display:flex;flex-flow:column;cursor:pointer;background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);:hover{--calcite-ui-icon-color: var(--calcite-color-text-1);--calcite-button-background-color: var(--calcite-color-transparent-hover)}calcite-button{width:var(--calcite-spacing-xxxl);height:var(--calcite-spacing-xxxl)}}:host{width:var(--calcite-spacing-xxxl);height:var(--calcite-spacing-xxxl)}`, w = "home", s = {
-  base: w,
+v4.34.0-next.127 */
+const b = r`.arcgis-button{--calcite-ui-icon-color: var(--calcite-color-text-3);--calcite-button-background-color: var(--calcite-color-foreground-1);color:var(--calcite-color-text-3);line-height:1.3em;display:flex;flex-flow:column;cursor:pointer;background-color:var(--calcite-color-foreground-1);font-size:var(--calcite-font-size);:hover{--calcite-ui-icon-color: var(--calcite-color-text-1);--calcite-button-background-color: var(--calcite-color-transparent-hover)}calcite-button{width:var(--calcite-spacing-xxxl);height:var(--calcite-spacing-xxxl)}}:host{width:var(--calcite-spacing-xxxl);height:var(--calcite-spacing-xxxl)}`, f = "home", s = {
+  base: f,
   button: "arcgis-button"
-}, x = b(m);
-class y extends d {
+}, x = w(d);
+class M extends m {
   constructor() {
-    super(...arguments), this.messages = p(), this.viewModel = x(this), this.autoDestroyDisabled = !1, this.goToOverride = this.viewModel.goToOverride, this.icon = "home", this.state = this.viewModel.state, this.viewpoint = this.viewModel.viewpoint, this.arcgisGo = n(() => this.viewModel, "go"), this.arcgisPropertyChange = l()("state"), this.arcgisReady = g();
+    super(...arguments), this.messages = p(), this.viewModel = x(this), this.view = this.viewModel.view, this.autoDestroyDisabled = !1, this.goToOverride = this.viewModel.goToOverride, this.icon = "home", this.state = this.viewModel.state, this.viewpoint = this.viewModel.viewpoint, this.arcgisGo = n(() => this.viewModel, "go"), this.arcgisPropertyChange = l()("state"), this.arcgisReady = g();
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, goToOverride: 0, icon: 1, label: 1, messageOverrides: 0, position: 3, referenceElement: 1, state: 3, viewpoint: 0 };
+    this.properties = { view: 0, autoDestroyDisabled: 5, goToOverride: 0, icon: 1, label: 1, messageOverrides: 0, position: 3, referenceElement: 1, state: 3, viewpoint: 0 };
   }
   static {
-    this.styles = f;
+    this.styles = b;
   }
   async cancelGo() {
     this.viewModel.cancelGo();
@@ -42,7 +42,7 @@ class y extends d {
     return i`<div class=${v(h(s.base, s.button))}><calcite-button .disabled=${t === "disabled"} .iconStart=${o ? void 0 : c ?? void 0} kind=neutral .label=${e.componentLabel} @click=${this._go} .scale=${o ? "s" : "m"} title=${(t === "going-home" ? e.cancel : e.title) ?? u}>${o ? i`<calcite-loader inline label></calcite-loader>` : null}</calcite-button></div>`;
   }
 }
-a("arcgis-home", y);
+a("arcgis-home", M);
 export {
-  y as ArcgisHome
+  M as ArcgisHome
 };

package/dist/components/arcgis-labeled-switch/customElement.js

@@ -5,7 +5,7 @@ import { keyed as b } from "lit/directives/keyed.js";
 import { LitElement as g, createEvent as m, safeClassMap as c } from "@arcgis/lumina";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.125 */
+v4.34.0-next.127 */
 const f = p`.label{--calcite-label-margin-bottom: 0}.label-content{display:flex;flex:1;gap:var(--calcite-spacing-sm);align-items:center;text-wrap:balance}.label-content>div{flex-grow:1}.icon{margin-top:-1px;&.info{color:var(--calcite-color-status-info)}&.warning{color:var(--calcite-color-status-warning)}}.tooltip{text-wrap:wrap}`, e = {
   label: "label",
   labelContent: "label-content",

package/dist/components/arcgis-layer-list/customElement.d.ts

@@ -21,7 +21,7 @@ declare const useLayerListWidget: (component: LitElement & Pick<LayerList, "icon
         childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
+        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView | nullish;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
@@ -38,6 +38,14 @@ export declare class ArcgisLayerList extends LitElement {
      * @since 4.33
      */
     readonly arcgisClose: TargetedEvent<this>;
+    /**
+     * A reference to the [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) or [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList.html#view)
+     *
+     * @default null
+     */
+    view?: __esri.MapView | __esri.SceneView | nullish;
     /**
      * If true, the component will not be destroyed automatically when it is
      * disconnected from the document. This is useful when you want to move the

package/dist/components/arcgis-layer-list/customElement.js

@@ -8,14 +8,14 @@ import { s as d } from "../../chunks/layer-list.js";
 import { c as n } from "../../chunks/createCloseEvent.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.125 */
+v4.34.0-next.127 */
 const g = h(r);
 class c extends o {
   constructor() {
-    super(...arguments), this.widget = g(this), this.viewModel = this.widget.viewModel, this.arcgisClose = n(this), this.autoDestroyDisabled = !1, this.catalogOptions = this.widget.catalogOptions, this.closed = !1, this.collapsed = this.widget.collapsed, this.dragEnabled = this.widget.dragEnabled, this.filterPlaceholder = this.widget.filterPlaceholder, this.filterPredicate = this.widget.filterPredicate, this.filterText = this.widget.filterText, this.headingLevel = this.widget.headingLevel, this.hideCatalogLayerList = this.widget.visibleElements.catalogLayerList, this.hideFlow = this.widget.visibleElements.flow, this.hideStatusIndicators = this.widget.visibleElements.statusIndicators, this.icon = this.widget.icon, this.knowledgeGraphOptions = this.widget.knowledgeGraphOptions, this.label = this.widget.label, this.listItemCreatedFunction = this.widget.listItemCreatedFunction, this.minDragEnabledItems = this.widget.minDragEnabledItems, this.minFilterItems = this.widget.minFilterItems, this.openedLayers = this.widget.openedLayers, this.selectedItems = this.widget.selectedItems, this.selectionMode = this.widget.selectionMode, this.showCloseButton = this.widget.visibleElements.closeButton, this.showCollapseButton = this.widget.visibleElements.collapseButton, this.showErrors = this.widget.visibleElements.errors, this.showFilter = this.widget.visibleElements.filter, this.showHeading = this.widget.visibleElements.heading, this.showTemporaryLayerIndicators = this.widget.visibleElements.temporaryLayerIndicators, this.state = this.viewModel.state, this.visibilityAppearance = this.widget.visibilityAppearance, this.arcgisPropertyChange = s()("state"), this.arcgisReady = l(), this.arcgisTriggerAction = a(() => this.widget, "trigger-action");
+    super(...arguments), this.widget = g(this), this.viewModel = this.widget.viewModel, this.arcgisClose = n(this), this.view = this.widget.view, this.autoDestroyDisabled = !1, this.catalogOptions = this.widget.catalogOptions, this.closed = !1, this.collapsed = this.widget.collapsed, this.dragEnabled = this.widget.dragEnabled, this.filterPlaceholder = this.widget.filterPlaceholder, this.filterPredicate = this.widget.filterPredicate, this.filterText = this.widget.filterText, this.headingLevel = this.widget.headingLevel, this.hideCatalogLayerList = this.widget.visibleElements.catalogLayerList, this.hideFlow = this.widget.visibleElements.flow, this.hideStatusIndicators = this.widget.visibleElements.statusIndicators, this.icon = this.widget.icon, this.knowledgeGraphOptions = this.widget.knowledgeGraphOptions, this.label = this.widget.label, this.listItemCreatedFunction = this.widget.listItemCreatedFunction, this.minDragEnabledItems = this.widget.minDragEnabledItems, this.minFilterItems = this.widget.minFilterItems, this.openedLayers = this.widget.openedLayers, this.selectedItems = this.widget.selectedItems, this.selectionMode = this.widget.selectionMode, this.showCloseButton = this.widget.visibleElements.closeButton, this.showCollapseButton = this.widget.visibleElements.collapseButton, this.showErrors = this.widget.visibleElements.errors, this.showFilter = this.widget.visibleElements.filter, this.showHeading = this.widget.visibleElements.heading, this.showTemporaryLayerIndicators = this.widget.visibleElements.temporaryLayerIndicators, this.state = this.viewModel.state, this.visibilityAppearance = this.widget.visibilityAppearance, this.arcgisPropertyChange = s()("state"), this.arcgisReady = l(), this.arcgisTriggerAction = a(() => this.widget, "trigger-action");
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, catalogLayerList: 32, catalogOptions: 0, closed: 5, collapsed: 7, dragEnabled: 5, filterPlaceholder: 1, filterPredicate: 0, filterText: 1, headingLevel: 9, hideCatalogLayerList: 5, hideFlow: 5, hideStatusIndicators: 5, icon: 1, knowledgeGraphOptions: 0, label: 1, listItemCreatedFunction: 0, minDragEnabledItems: 9, minFilterItems: 9, openedLayers: 0, operationalItems: 32, position: 1, referenceElement: 1, selectedItems: 0, selectionMode: 1, showCloseButton: 5, showCollapseButton: 5, showErrors: 5, showFilter: 5, showHeading: 5, showTemporaryLayerIndicators: 5, state: 3, tableList: 32, visibilityAppearance: 1 };
+    this.properties = { view: 0, autoDestroyDisabled: 5, catalogLayerList: 32, catalogOptions: 0, closed: 5, collapsed: 7, dragEnabled: 5, filterPlaceholder: 1, filterPredicate: 0, filterText: 1, headingLevel: 9, hideCatalogLayerList: 5, hideFlow: 5, hideStatusIndicators: 5, icon: 1, knowledgeGraphOptions: 0, label: 1, listItemCreatedFunction: 0, minDragEnabledItems: 9, minFilterItems: 9, openedLayers: 0, operationalItems: 32, position: 1, referenceElement: 1, selectedItems: 0, selectionMode: 1, showCloseButton: 5, showCollapseButton: 5, showErrors: 5, showFilter: 5, showHeading: 5, showTemporaryLayerIndicators: 5, state: 3, tableList: 32, visibilityAppearance: 1 };
   }
   static {
     this.styles = d;

package/dist/components/arcgis-layer-list-item/customElement.js

@@ -10,7 +10,7 @@ import { s as E } from "../../chunks/layer-list.js";
 import { u as x } from "../../chunks/useT9n.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.125 */
+v4.34.0-next.127 */
 const D = {
   hideChildren: "hide-children"
 };

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

@@ -1,14 +1,89 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference path="../../index.d.ts" />
 import { default as LegendViewModel } from '@arcgis/core/widgets/Legend/LegendViewModel.js';
-import { JsxNode, ToElement, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { Use } from '@arcgis/lumina/controllers';
 import { HeadingLevel } from '../../support/heading';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
 declare const useLegendViewModel: (component: LitElement & Pick<LegendViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<LegendViewModel>) => LegendViewModel;
-/** [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/) */
+/**
+ * The Legend component displays the symbols and labels used to represent layers in a [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/) or [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).
+ * Only layers and sublayers visible in the view are shown, unless [ignoreLayerVisibility](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#ignoreLayerVisibility) is set to `true`.
+ *
+ * The legend automatically updates when:
+ *  - the visibility of a layer or sublayer changes
+ *  - a layer is added or removed from the map
+ *  - a layer's `renderer`, `opacity`, or `title` is changed
+ *  - the `legendEnabled` property is changed (set to `true` or `false` on the layer)
+ *
+ * ## Known Limitations
+ *
+ * * Currently, the legend component does not support the following layer types:
+ * [ElevationLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ElevationLayer.html),
+ * [GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html),
+ * [IntegratedMeshLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMeshLayer.html),
+ * [KMLLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-KMLLayer.html),
+ * [MapNotesLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MapNotesLayer.html),
+ * [OpenStreetMapLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-OpenStreetMapLayer.html),
+ * [VectorTileLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VectorTileLayer.html),
+ * [VideoLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VideoLayer.html), and
+ * [WebTileLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WebTileLayer.html).
+ * * [Symbol3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-Symbol3D.html) with more than one
+ * [symbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-Symbol3DLayer.html) are not supported.
+ * * [DictionaryRenderer](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-DictionaryRenderer.html) is not supported.
+ * * [TrackInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-TrackInfo.html) is not supported.
+ * * CIM Symbol [primitiveOverride](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-CIMSymbol.html#PrimitiveOverride) is not supported.
+ *
+ * ## Various examples of legends based on renderer type.
+ *
+ * ### Unique values
+ *
+ * [![Unique values](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-unique-values.png)](../sample-code/visualization-location-types/)
+ *
+ * ### Continuous color
+ *
+ * [![Continuous color](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-color-vv.png)](../sample-code/visualization-vv-color/)
+ *
+ * ### Classed color
+ *
+ * [![Classed color](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-class-breaks.png)](../sample-code/visualization-classbreaks/)
+ *
+ * ### Continuous size
+ *
+ * [![Continuous size](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-size.png)](../sample-code/visualization-sm-size/)
+ *
+ * ### Size - above and below
+ *
+ * [![Size - above and below](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-size-themes.png)](../sample-code/visualization-sm-size-themes/)
+ *
+ * ### Dot density
+ *
+ * [![Dot density](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-dot-density.png)](../sample-code/visualization-dot-density/)
+ *
+ * ### Predominance
+ *
+ * [![Predominance](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-predominance.png)](../sample-code/visualization-arcade/)
+ *
+ * ### Relationship
+ *
+ * [![Relationship](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-relationship.png)](../sample-code/visualization-sm-relationship/)
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/)
+ *
+ * @see [Sample - Legend component](https://developers.arcgis.com/javascript/latest/sample-code/legend/)
+ * @see [Sample - Add a Legend to the LayerList](https://developers.arcgis.com/javascript/latest/sample-code/layerlist-legend/)
+ * @see [Sample - Legend component card style](https://developers.arcgis.com/javascript/latest/sample-code/legend-card/)
+ * @see [Sample - Update legend text](https://developers.arcgis.com/javascript/latest/sample-code/legend-update/)
+ * @since 4.28
+ */
 export declare class ArcgisLegend extends LitElement {
+    /**
+     * The view from which the widget will operate.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Legend-LegendViewModel.html#view)
+     */
+    view?: __esri.MapView | __esri.SceneView | nullish;
     /**
      * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
      *
@@ -27,7 +102,7 @@ export declare class ArcgisLegend extends LitElement {
     icon?: string;
     /**
      * Collection of [ActiveLayerInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Legend-support-ActiveLayerInfo.html) objects used by the legend view to
-     * display data in the legend. The legend widget watches this property to hide or display the layer's legend when
+     * display data in the legend. The legend component watches this property to hide or display the layer's legend when
      * an [ActiveLayerInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Legend-support-ActiveLayerInfo.html) is removed from or added to this collection.
      *
      * @autocast { "value": "Object[]", "typedCollection": true }
@@ -35,44 +110,57 @@ export declare class ArcgisLegend extends LitElement {
     activeLayerInfos: __esri.Collection<__esri.ActiveLayerInfo>;
     /**
      * Indicates whether to show the [Basemap](https://developers.arcgis.com/javascript/latest/api-reference/esri-Basemap.html) layers in the Legend. If you set this property to
-     * `true` and specify [layerInfos](#layerInfos), the basemap layers you want included in the legend must also be
-     * specified in `layerInfos`.
+     * `true` and specify [layerInfos](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#layerInfos) that include the basemap layers, the basemap will be displayed in the legend.
      *
-     * @example legend.basemapLegendVisible = true;
+     * @example
+     * Show basemap layers in the legend
+     *
+     * ```js
+     * const mapElement = document.querySelector("arcgis-map");
+     * const basemapLayer = mapElement.map.basemap.baseLayers.getItemAt(0);
+     * const legend = document.querySelector("arcgis-legend");
+     * legend.layerInfos = [{ layer: basemapLayer }];
+     * legend.basemapLegendVisible = true;
+     * ```
      * @default false
      */
     basemapLegendVisible: boolean;
     /**
-     * Indicates the heading level to use for the legend title. By default, legend titles
-     * are rendered as level 3 headings (e.g. `<h3>Legend title</h3>`). Depending on the legend placement
-     * in your app, you may need to adjust this heading for proper semantics. This is
-     * important for meeting accessibility standards.
+     * Indicates the heading level to use for the legend title. By default, legend titles are rendered as level 3 headings (e.g. `<h3>Legend title</h3>`). Depending on the legend placement
+     * in your app, you may need to adjust this heading for proper semantics. This is important for meeting accessibility standards.
      *
-     * @since 4.20
      * @see [Heading Elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)
      * @example
-     * // legend title will render as an <h2>
-     * legend.headingLevel = 2;
+     * Legend title will render as an `<h2>`
+     *
+     * ```html
+     * <arcgis-legend heading-level="2"></arcgis-legend>
+     * ```
+     *
+     * ```js
+     * document.querySelector("arcgis-legend").headingLevel = 2;
+     * ```
      * @default 3
      */
     headingLevel: HeadingLevel;
     /**
-     * When `true`, layers will only be shown in the legend if
-     * they are visible in the view's extent. When data from a layer
-     * is not visible in the view, the layer's legend information
-     * will be hidden. Only layers that implement the `createQuery()`
+     * When `true`, layers will only be shown in the legend if they are visible in the view's extent. When data from a layer
+     * is not visible in the view, the layer's legend information will be hidden. Only layers that implement the `createQuery()`
      * and `queryFeatureCount()` methods are supported by `hideLayersNotInCurrentView`.
      *
-     * To hide layers completely
-     * from the legend, you should set the `legendEnabled` property of
-     * the layer to `false`.
+     * To hide layers completely from the legend, you should set the `legendEnabled` property of the layer to `false`.
      *
-     * @since 4.21
-     * @see [respectLayerVisibility](#respectLayerVisibility)
+     * @see [ignoreLayerVisibility](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#ignoreLayerVisibility)
      * @example
-     * // layers not displayed in the view
-     * // will not be shown in the legend
-     * legend.hideLayersNotInCurrentView = true;
+     * Layers not displayed in the current map extent will not be shown in the legend
+     *
+     * ```html
+     * <arcgis-legend hide-layers-not-in-current-view></arcgis-legend>
+     * ```
+     *
+     * ```js
+     * document.querySelector("arcgis-legend").hideLayersNotInCurrentView = true;
+     * ```
      * @default false
      */
     hideLayersNotInCurrentView: boolean;
@@ -83,14 +171,22 @@ export declare class ArcgisLegend extends LitElement {
      *
      * @since 4.30
      * @see [definitionExpression](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#definitionExpression)
+     * @example
+     * Only display features that satisfy the layer's definitionExpression.
+     *
+     * ```html
+     * <arcgis-legend respect-layer-definition-expression></arcgis-legend>
+     * ```
+     *
+     * ```js
+     * document.querySelector("arcgis-legend").respectLayerDefinitionExpression = true;
+     * ```
      * @default false
      */
     respectLayerDefinitionExpression: boolean;
     /**
-     * Determines whether to respect the properties of the layers in the map that
-     * control the legend's visibility (`minScale`, `maxScale`, `legendEnabled`).
-     * By default, a layer's legend elements **will
-     * not render** in the legend given the following conditions:
+     * Determines whether to respect the properties of the layers in the map that control the legend's visibility (`minScale`, `maxScale`, `legendEnabled`).
+     * By default, a layer's legend elements **will not render** in the legend given the following conditions:
      *
      * - The layer's [legendEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#legendEnabled) property
      * is set to `false`.
@@ -98,61 +194,121 @@ export declare class ArcgisLegend extends LitElement {
      * defined by the layer's [minScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#minScale) and
      * [maxScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#maxScale) properties.
      *
-     * When the `respectLayerVisibility` property of the legend is set to `false`, the legend elements for each
+     * When the `ignoreLayerVisibility` property of the legend is set to `true`, the legend elements for each
      * layer in the map will always display, thus disregarding the `minScale`, `maxScale`,
      * and `legendEnabled` properties for each layer in the map.
      *
-     * @since 4.13
-     * @see [hideLayersNotInCurrentView](#hideLayersNotInCurrentView)
+     * @since 4.34
+     * @see [hideLayersNotInCurrentView](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#hideLayersNotInCurrentView)
      * @example
-     * // Always displays legend elements for the map's layers
-     * // regardless of their minScale, maxScale, and legendEnabled properties
-     * legend.respectLayerVisibility = false;
-     * @default true
+     * Always displays legend elements for the map's layers regardless of their minScale, maxScale, and legendEnabled properties.
+     *
+     * ```html
+     * <arcgis-legend ignore-layer-visibility></arcgis-legend>
+     * ```
+     *
+     * ```js
+     * document.querySelector("arcgis-legend").ignoreLayerVisibility = true;
+     * ```
+     * @default false
      */
     ignoreLayerVisibility: boolean;
     /**
-     * Specifies a subset of the layers to display in the legend. This includes any [basemap layers](#basemapLegendVisible)
-     * you want to be visible in the legend.
-     * If this property is not set, all layers in the map will display in the legend, including
-     * basemap layers if [basemapLegendVisible](#basemapLegendVisible) is `true`.
-     * Objects in this array are defined with the properties listed below.
+     * Determines whether to respect the properties of the layers in the map that control the legend's visibility (`minScale`, `maxScale`, `legendEnabled`).
+     * By default, a layer's legend elements **will not render** in the legend given the following conditions:
+     *
+     * - The layer's [legendEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#legendEnabled) property
+     * is set to `false`.
+     * - If the view's scale is outside the visibility range
+     * defined by the layer's [minScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#minScale) and
+     * [maxScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#maxScale) properties.
+     *
+     * When the `respectLayerVisibilityDisabled` property of the legend is set to `false`, the legend elements for each
+     * layer in the map will always display, thus disregarding the `minScale`, `maxScale`,
+     * and `legendEnabled` properties for each layer in the map.
      *
+     * @see [ignoreLayerVisibility](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#ignoreLayerVisibility)
      * @example
+     * Always displays legend elements for the map's layers regardless of their minScale, maxScale, and legendEnabled properties.
+     *
+     * ```html
+     * <arcgis-legend respect-layer-visibility-disabled="false"></arcgis-legend>
+     * ```
+     *
+     * ```js
+     * document.querySelector("arcgis-legend").respectLayerVisibilityDisabled = true;
+     * ```
+     * @deprecated since 4.34 use [ignoreLayerVisibility](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#ignoreLayerVisibility) instead.
+     * @default false
+     */
+    respectLayerVisibilityDisabled: boolean;
+    /**
+     * Specifies a subset of the layers to display in the legend. This includes any basemap layers
+     * you want to be visible in the legend.  If this property is not set, all layers in the map will display in the legend, including
+     * basemap layers if [basemapLegendVisible](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#basemapLegendVisible) is `true`. Objects in this array are defined with the properties in the example below.
+     *
+     * @example
+     * Only show a specific sublayer in the legend
+     *
+     * ```js
      * const subtypeGroupLayer = webmap.layers.getItemAt(0);
      * const subtypeSubLayer = subtypeGroupLayer.sublayers.getItemAt(1);
      * const subtypeSublayerId = parseInt(subtypeSubLayer.subtypeCode);
-     * const legend = new Legend({
-     *   view: view,
-     *   layerInfos: [
-     *     {
-     *       layer: subtypeGroupLayer,
-     *       sublayerIds: [subtypeSublayerId]
-     *     }
-     *   ]
+     * document.querySelector("arcgis-legend").layerInfos = [
+     *   {
+     *     layer: subtypeGroupLayer,
+     *     sublayerIds: [subtypeSublayerId]
+     *   }
+     * ];
      * });
+     * ```
      */
     layerInfos: __esri.LegendViewModelLayerInfos[];
+    /**
+     * Indicates whether the legend is currently loading.
+     *
+     * @since 4.34
+     * @default false
+     */
+    readonly loading: boolean;
+    /**
+     * Indicates the layout of the legend when the [legendStyle](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#legendStyle) is set to the string value of `"card"`.
+     * The layout determines how the legend's content is arranged.
+     *
+     * [![card-style-layout](https://developers.arcgis.com/javascript/latest/assets/img/components/legend/card-style-layout.png)](../sample-code/legend-card/)
+     *
+     * @since 4.34
+     * @example
+     * Renders the legend in the card style with a "stack" layout
+     *
+     * ```html
+     * <arcgis-legend legend-style="card" card-style-layout="stack"></arcgis-legend>
+     * ```
+     *
+     * ```js
+     * const legend = document.querySelector("arcgis-legend");
+     * legend.legendStyle = "card";
+     * legend.cardStyleLayout = "stack";
+     * ```
+     */
     cardStyleLayout?: "auto" | "side-by-side" | "stack";
     /**
      * Indicates the style of the legend. The style determines the legend's layout and behavior.
      * You can either specify a string or an object to indicate the style. The known string values are the same values listed in
      * the table within the `type` property.
      *
-     * @since 4.7
-     * @example
-     * // renders the legend in the card style with a "stack" layout
-     * legend.legendStyle = "card";
+     * [![legend-style](https://developers.arcgis.com/javascript/latest/assets/img/components/legend/legend-style.png)](../sample-code/legend-card/)
+     *
+     * @see [cardStyleLayout](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#cardStyleLayout)
      * @example
-     * // renders the legend in the card style with a responsive
-     * // layout that toggles between "stack" and "side-by-side"
-     * legend.legendStyle = {
+     * Renders the legend in the card style with a stack layout
+     *
+     * ```js
+     * document.querySelector("arcgis-legend").legendStyle = legendStyle = {
      *   type: "card",
-     *   layout: "auto"
+     *   layout: "stack"
      * };
-     * @example
-     * // renders the legend in the classic layout
-     * legend.legendStyle = "classic";
+     * ```
      * @default "classic"
      */
     legendStyle: "card" | "classic" | {