@arcgis/map-components 4.33.0-next.16 → 4.33.0-next.160

package/dist/components/arcgis-print-template-selector/index.js

@@ -0,0 +1,8 @@
+import "@esri/calcite-components/components/calcite-button";
+import "@esri/calcite-components/components/calcite-list";
+import "@esri/calcite-components/components/calcite-chip";
+import "@esri/calcite-components/components/calcite-list-item";
+import "@esri/calcite-components/components/calcite-icon";
+import "@esri/calcite-components/components/calcite-loader";
+import "@esri/calcite-components/components/calcite-action";
+export * from "./customElement.js";

package/dist/components/arcgis-scale-bar/customElement.d.ts

@@ -1,7 +1,6 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
-import { Use } from '@arcgis/components-controllers';
-import { Nil } from '@arcgis/components-utils';
+import { Use } from '@arcgis/lumina/controllers';
 import { default as ScaleBarViewModel } from '@arcgis/core/widgets/ScaleBar/ScaleBarViewModel.js';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
@@ -9,38 +8,64 @@ import { MeasurementSystem } from '../types';
 
 type ScaleBarStyle = "line" | "ruler";
 type ScaleBarUnit = MeasurementSystem | "dual";
-declare const useScaleBarViewModel: (component: import('@arcgis/components-controllers').StencilLifecycles & {
-    manager: import('@arcgis/components-controllers').ControllerManager;
-    el: HTMLElement;
-    autoDestroyDisabled?: boolean;
-    destroy?: () => Promise<void>;
-} & Pick<ScaleBarViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<ScaleBarViewModel>, options?: {
-    editConstructorProperties(props: unknown): unknown;
-} | undefined) => ScaleBarViewModel;
-/** The Scale Bar component displays a scale bar on the map or in a specified HTML node.
+declare const useScaleBarViewModel: (component: LitElement & Pick<ScaleBarViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<ScaleBarViewModel>) => ScaleBarViewModel;
+/**
+ * The Scale Bar component displays a scale bar representing the scale of the map.
+ * It respects various coordinate systems and displays units in metric or imperial values.
+ * Metric values show either kilometers, meters, centimeters, or millimeters depending on the scale, and likewise, imperial values show miles, feet, or inches depending on the scale.
+ * When working with Web Mercator or geographic coordinate systems the scale bar takes into account projection distortion and dynamically adjusts the scale bar.
+ *
+ * When the scale bar is inside the map, the actual location of the scale bar is used to calculate the scale.
+ * Otherwise, the center of the map is used to calculate the scale.
+ *
+ * **Known limitations**
+ *
+ * - This component is not currently supported within a Scene component.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scale-bar/)
  */
 export declare class ArcgisScaleBar extends LitElement {
-    private messages;
     /**
-     * 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 component to a different place on the page, or
-     * temporary hide it. If this is set, make sure to call the
-     * \`destroy\` method when you are done to prevent memory leaks.
+     * 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
+     * component to a different place on the page, or temporarily hide it. If this
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scale-bar/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
     /**
      * The style for the scale bar.
      * When `unit` is set to `dual`, the style will always be `line`.
+     *
+     * @default "line"
      */
     barStyle: ScaleBarStyle;
-    /** Icon displayed in the widget's button. */
-    icon: Nil | string;
+    /**
+     * Icon which represents the component.
+     * Typically used when the component is controlled by another component (e.g. by the Expand component).
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "actual-size"
+     */
+    icon?: string;
     /** The component's default label. */
-    label: Nil | string;
+    label?: string;
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
+    /** @default "top-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    /**
+     * 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.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
+    referenceElement?: ArcgisReferenceElement | string;
     /**
      * Units to use for the scale bar.
      * When using `dual`, the scale bar displays both metric and imperial units.
@@ -49,8 +74,14 @@ export declare class ArcgisScaleBar extends LitElement {
      */
     get unit(): ScaleBarUnit | undefined;
     set unit(value: ScaleBarUnit | undefined);
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    readonly arcgisReady: TargetedEvent<this, void>;
+    private messages: Partial<{
+        componentLabel: string;
+    }> & import('@arcgis/lumina/controllers').T9nMeta<{
+        componentLabel: string;
+    }>;
 }
 export {};

package/dist/components/arcgis-scale-bar/customElement.js

@@ -7,12 +7,12 @@ import { watch as y } from "@arcgis/core/core/reactiveUtils.js";
 import { formatNumber as S } from "@arcgis/core/intl.js";
 import L from "@arcgis/core/widgets/ScaleBar/ScaleBarViewModel.js";
 import { LitElement as B, createEvent as M, noShadowRoot as R, safeClassMap as a, safeStyleMap as _ } from "@arcgis/lumina";
-import { u as x } from "../../chunks/useView.js";
+import { u as x } from "../../chunks/useT9n.js";
 import { m as D } from "../../chunks/useViewModel.js";
 import { g as v } from "../../chunks/globalCss.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.16 */
+v4.33.0-next.160 */
 function $(f = 0, e = 0) {
   return { x: f, y: e };
 }
@@ -38,31 +38,20 @@ class k extends B {
     super(...arguments), this._defaultUnit = "metric", this.messages = x(), this._scaleComputedFrom = $(), this.viewModel = U(this), this.autoDestroyDisabled = !1, this.barStyle = "line", this.icon = "actual-size", this.position = "top-left", this.arcgisReady = M();
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, barStyle: 1, icon: 3, label: 1, messageOverrides: 0, position: 3, referenceElement: 1, unit: 1 };
+    this.properties = { autoDestroyDisabled: 5, barStyle: 1, icon: 1, label: 1, messageOverrides: 0, position: 3, referenceElement: 1, unit: 1 };
   }
   static {
     this.shadowRootOptions = R;
   }
-  /**
-   * Units to use for the scale bar.
-   * When using `dual`, the scale bar displays both metric and imperial units.
-   * When metric, distances will be shown in either kilometers, meters, centimeters, or millimeters depending on the scale. Similarly, imperial
-   * units will be shown in either miles, feet, or inches.
-   */
   get unit() {
     return this._unit ?? this._defaultUnit;
   }
   set unit(e) {
     this._unit = e;
   }
-  // #endregion
-  // #region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
-  // #endregion
-  // #region Lifecycle
   updated() {
     this._handleRootCreateOrUpdate();
   }
@@ -80,8 +69,6 @@ class k extends B {
       this._defaultUnit = e ?? "metric", i && this.requestUpdate();
     }));
   }
-  // #endregion
-  // #region Private Methods
   _handleContainerRef(e) {
     e !== void 0 && this._handleRootCreateOrUpdate();
   }
@@ -98,8 +85,6 @@ class k extends B {
       unitDisplay: "short"
     });
   }
-  // #endregion
-  // #region Rendering
   render() {
     const e = this.viewModel.state === "disabled", i = {
       [v.disabled]: e

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

@@ -1,77 +1,137 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
-import { Use } from '@arcgis/components-controllers';
-import { Nil } from '@arcgis/components-utils';
+import { Use } from '@arcgis/lumina/controllers';
 import { default as ScaleRangeSlider } from '@arcgis/core/widgets/ScaleRangeSlider.js';
 import { PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 
-declare const useScaleRangeSliderWidget: (component: import('@arcgis/components-controllers').StencilLifecycles & {
-    manager: import('@arcgis/components-controllers').ControllerManager;
-    el: HTMLElement;
-    autoDestroyDisabled?: boolean;
-    destroy?: () => Promise<void>;
-} & Pick<ScaleRangeSlider, never> & {
-    reactiveUtils?: typeof __esri.reactiveUtils;
+declare const useScaleRangeSliderWidget: (component: LitElement & Pick<ScaleRangeSlider, "icon" | "label" | "viewModel" | "mode" | "layer" | "disabled" | "maxScale" | "maxScaleLimit" | "minScale" | "minScaleLimit" | "region"> & {
     state?: unknown;
     viewModel?: __esri.ScaleRangeSliderViewModel | undefined;
-    icon: Nil | string;
-    label: Nil | string;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    closed?: boolean;
+    icon: import('@arcgis/components-utils').Nil | string;
+    label: import('@arcgis/components-utils').Nil | string;
+    referenceElement?: ArcgisReferenceElement | string;
     position: __esri.UIPosition;
-    arcgisReady: import('@arcgis/components-controllers').EventEmitter;
-    arcgisPropertyChange: import('@arcgis/components-controllers').EventEmitter<{
+    arcgisReady: import('@arcgis/lumina').EventEmitter;
+    arcgisPropertyChange: import('@arcgis/lumina').EventEmitter<{
         name: string;
     }> | undefined;
     el: HTMLElement & {
         childElem?: HTMLElement & {
             ownedBy?: HTMLElement;
         };
-        view?: __esri.MapView | __esri.SceneView | Nil;
+        view?: __esri.LinkChartView | __esri.MapView | __esri.SceneView;
     };
     autoDestroyDisabled: boolean;
     destroy: () => Promise<void>;
-}, options?: {
-    editConstructorProperties(props: __esri.ScaleRangeSliderProperties | undefined): __esri.ScaleRangeSliderProperties | Promise<__esri.ScaleRangeSliderProperties | undefined> | undefined;
-} | undefined) => ScaleRangeSlider;
-/** The ScaleRangeSlider component allows the user to set a minimum and maximum scale based on named scale ranges.
+}) => ScaleRangeSlider;
+/**
+ * The Scale Range Slider component allows the user to set a minimum and maximum scale based on named scale ranges.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scale-range-slider/)
  */
 export declare class ArcgisScaleRangeSlider extends LitElement {
     /**
      * 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
      * component to a different place on the page, or temporarily hide it. If this
-     * is set, make sure to call the \`destroy\` method when you are done to prevent
-     * memory leaks.
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scale-range-slider/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
+    /**
+     * When `true`, sets the widget to a disabled state so the user cannot interact with it.
+     *
+     * @default false
+     */
     disabled: boolean;
+    /** @default false */
     hidePreview: boolean | undefined;
+    /** @default false */
     hideScaleMenusMaxScaleMenu: boolean | undefined;
+    /** @default false */
     hideScaleMenusMinScaleMenu: boolean | undefined;
     /**
-     * Icon which represents the component.
-     * Typically used when the component is controlled by another component (e.g. by the Expand component).
-     * Search [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/) for possible values.
+     * Icon displayed in the widget's button.
+     *
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "actual-size"
      */
     icon: string;
-    /** The component's default label. */
+    /**
+     * The widget's default label.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ScaleRangeSlider.html#label)
+     */
     label: string;
+    /**
+     * When provided, the initial [minScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ScaleRangeSlider.html#minScale) and [maxScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ScaleRangeSlider.html#maxScale) values will match the layer's.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ScaleRangeSlider.html#layer)
+     */
     layer: nullish | __esri.Layer | __esri.Sublayer;
+    /**
+     * The maximum scale of the active scale range.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ScaleRangeSlider.html#maxScale)
+     */
     maxScale: number;
+    /**
+     * The lowest possible maximum scale value on the slider.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ScaleRangeSlider.html#maxScaleLimit)
+     */
     maxScaleLimit: number;
+    /**
+     * The minimum scale of the active scale range.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ScaleRangeSlider.html#minScale)
+     */
     minScale: number;
+    /**
+     * The highest possible minimum scale value on the slider.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ScaleRangeSlider.html#minScaleLimit)
+     */
     minScaleLimit: number;
+    /**
+     * The mode of the widget, indicating which slider thumbs can be adjusted.
+     *
+     * @default "range"
+     */
     mode: "range" | "max-scale-only" | "min-scale-only";
+    /** @default "bottom-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
+    /**
+     * 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.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
+    referenceElement?: ArcgisReferenceElement | string;
+    /**
+     * The region that the scale thumbnails will focus on.
+     *
+     * @default "US"
+     */
     region: __esri.SupportedRegion;
+    /**
+     * The current state of the widget.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ScaleRangeSlider-ScaleRangeSliderViewModel.html#state)
+     *
+     * @default "disabled"
+     */
     readonly state: "ready" | "disabled";
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state" | "maxScale" | "minScale";
     }>;
-    readonly arcgisReady: TargetedEvent<this, undefined>;
+    /** Emitted when the component associated with a map or scene view is is ready to be interacted with. */
+    readonly arcgisReady: TargetedEvent<this, void>;
 }
 export {};

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

@@ -1,12 +1,12 @@
 import { c as e } from "../../chunks/runtime.js";
-import { usePropertyChange as i } from "@arcgis/components-controllers";
+import { usePropertyChange as i } from "@arcgis/lumina/controllers";
 import t from "@arcgis/core/widgets/ScaleRangeSlider.js";
 import { LitElement as s, createEvent as a, noShadowRoot as l } from "@arcgis/lumina";
 import { m as o } from "../../chunks/useWidget.js";
 import { css as n } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.16 */
+v4.33.0-next.160 */
 const r = n`@layer{arcgis-scale-range-slider{display:block}}`, c = o(t);
 class h extends s {
   constructor() {
@@ -21,9 +21,6 @@ class h extends s {
   static {
     this.styles = r;
   }
-  // #endregion
-  // #region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }