@arcgis/map-components 4.33.0-next.99 → 4.33.0

package/dist/components/arcgis-link-chart-layout-switcher/customElement.d.ts

@@ -1,7 +1,6 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
 import { ArcgisReferenceElement } from '../../utils/component-utils';
-import { Nil } from '@arcgis/components-utils';
 import { Use } from '@arcgis/lumina/controllers';
 import { default as LinkChartLayoutSwitcherViewModel } from '@arcgis/core/widgets/LinkChartLayoutSwitcher/LinkChartLayoutSwitcherViewModel.js';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
@@ -18,55 +17,139 @@ declare enum DiagramLayoutValues {
 }
 type DiagramLayoutType = `${DiagramLayoutValues}`;
 
-declare const useLinkChartLayoutSwitcherViewModel: (component: LitElement & Pick<LinkChartLayoutSwitcherViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<LinkChartLayoutSwitcherViewModel>, options?: {
-    editConstructorProperties(props: unknown): unknown;
-} | undefined) => LinkChartLayoutSwitcherViewModel;
-/** A component for use in link charts that allows users to switch between different layouts. See [documentation on layouts](https://enterprise.arcgis.com/en/knowledge/latest/knowledge-studio/change-the-layout-applied-to-a-link-chart.htm) for more details.
- 
-
-Note: Sign in to access the data in this demo, U/P: `viewer01`/`I68VGU^nMurF`
+declare const useLinkChartLayoutSwitcherViewModel: (component: LitElement & Pick<LinkChartLayoutSwitcherViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<LinkChartLayoutSwitcherViewModel>) => LinkChartLayoutSwitcherViewModel;
+/**
+ * A component for use in link charts that allows users to switch between different layouts. See [documentation on layouts](https://enterprise.arcgis.com/en/knowledge/latest/knowledge-studio/change-the-layout-applied-to-a-link-chart.htm) for more details.
+ *
+ *
+ * Note: Sign in to access the data in this demo, U/P: `viewer01`/`I68VGU^nMurF`
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart-layout-switcher/)
  */
 export declare class ArcgisLinkChartLayoutSwitcher extends LitElement {
+    /**
+     * The appearance of the layout switcher. `dropdown` displays a button that is clicked to reveal a dropdown menu, while `menu-bar` displays a menu bar.
+     *
+     * @since 4.33
+     * @default "dropdown"
+     */
+    appearance: "dropdown" | "menu-bar";
     /**
      * 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-link-chart-layout-switcher/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
     /**
-     * Icon displayed in the widget's button.
+     * When `true`, the layout menu will not close when a layout is selected. Only applicable when `appearance` is `dropdown`.
+     *
+     * @since 4.33
+     * @default false
+     */
+    closeOnSelectDisabled: boolean;
+    /**
+     * Icon displayed in the component's button, when `appearance` is `dropdown`.
      *
      * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
-     * @since 4.28
+     * @default "nodes-link"
      */
-    icon: Nil | string;
+    icon?: string;
     /** The component's default label. */
-    label: Nil | string;
+    label?: string;
+    /**
+     * The current selected link chart layout.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LinkChartLayoutSwitcher-LinkChartLayoutSwitcherViewModel.html#layout)
+     *
+     * @default "organic-standard"
+     */
     readonly layout: DiagramLayoutType;
+    /**
+     * 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;
+    /**
+     * Prevents extent from updating on changes to the layout.
+     *
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LinkChartLayoutSwitcher-LinkChartLayoutSwitcherViewModel.html#preventExtentUpdate)
+     *
+     * @default false
+     */
     preventExtentUpdate: boolean;
-    referenceElement: ArcgisReferenceElement | Nil | string;
-    readonly state: "ready" | "disabled" | "loading";
-    /** Permanently destroy the component */
-    destroy(): Promise<void>;
     /**
-     * Switches the layout of the link chart to the value provided.
+     * 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 also:
+     * - [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 current state of the component.
+     *
+     * @default "loading"
      */
+    readonly state: "ready" | "loading" | "disabled";
+    /** Permanently destroy the component. */
+    destroy(): Promise<void>;
+    /** Switches the layout of the link chart to the value provided. */
     switchLayout(newLayout: "basic-grid" | "chronological-mono-timeline" | "chronological-multi-timeline" | "geographic-organic-standard" | "hierarchical-bottom-to-top" | "organic-community" | "organic-standard" | "radial-root-centric" | "tree-left-to-right"): Promise<void>;
     /**
      * Fires when component has completed the layout switch
      *
      * @example
+     * ```js
      * layoutswitcher.addEventListener("arcgisSwitchLayout", (event) => {
      *   console.log("Layout Switched");
      * });
+     * ```
      */
     readonly arcgisSwitchLayout: TargetedEvent<this, __esri.LinkChartLayoutSwitcherViewModelSwitchLayoutEvent>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    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<{
+        layoutOptions: string;
+        forceDirected: string;
+        community: string;
+        simple: string;
+        hierarchical: string;
+        radialTree: string;
+        smartTree: string;
+        geographic: string;
+        chronologicalSingle: string;
+        chronologicalMultiple: string;
+        basicLayoutCategory: string;
+        organicLayoutCategory: string;
+        treeLayoutCategory: string;
+        hierarchicalLayoutCategory: string;
+        chronologicalLayoutCategory: string;
+    }> & import('@arcgis/lumina/controllers').T9nMeta<{
+        layoutOptions: string;
+        forceDirected: string;
+        community: string;
+        simple: string;
+        hierarchical: string;
+        radialTree: string;
+        smartTree: string;
+        geographic: string;
+        chronologicalSingle: string;
+        chronologicalMultiple: string;
+        basicLayoutCategory: string;
+        organicLayoutCategory: string;
+        treeLayoutCategory: string;
+        hierarchicalLayoutCategory: string;
+        chronologicalLayoutCategory: string;
+    }>;
 }
 export {};

package/dist/components/arcgis-link-chart-layout-switcher/customElement.js

@@ -1,18 +1,18 @@
-import { c as l } from "../../chunks/runtime.js";
-import { html as i } from "lit-html";
-import { classes as n } from "@arcgis/components-utils";
-import { g as e } from "../../chunks/globalCss.js";
-import h from "@arcgis/core/widgets/LinkChartLayoutSwitcher/LinkChartLayoutSwitcherViewModel.js";
-import { usePropertyChange as d } from "@arcgis/lumina/controllers";
-import { m } from "../../chunks/useViewModel.js";
-import { u as g } from "../../chunks/useT9n.js";
-import { reEmitEvent as u } from "@arcgis/lumina/controllers/accessor";
-import { LitElement as p, createEvent as y, noShadowRoot as w, safeClassMap as a } from "@arcgis/lumina";
-import { css as f } from "@lit/reactive-element/css-tag.js";
+import { c as d } from "../../chunks/runtime.js";
+import { html as e } from "lit-html";
+import { classes as m } from "@arcgis/components-utils";
+import { g as s } from "../../chunks/globalCss.js";
+import g from "@arcgis/core/widgets/LinkChartLayoutSwitcher/LinkChartLayoutSwitcherViewModel.js";
+import { usePropertyChange as p } from "@arcgis/lumina/controllers";
+import { m as u } from "../../chunks/useViewModel.js";
+import { u as y } from "../../chunks/useT9n.js";
+import { reEmitEvent as w } from "@arcgis/lumina/controllers/accessor";
+import { LitElement as b, createEvent as f, noShadowRoot as v, safeClassMap as c } from "@arcgis/lumina";
+import { css as $ } 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.99 */
-const b = f`@layer{arcgis-link-chart-layout-switcher{display:block}}`, k = {
+v4.33.0 */
+const L = $`@layer{arcgis-link-chart-layout-switcher{display:block}}`, l = {
   basicLayoutCategory: [
     "basic-grid"
     /* SIMPLE */
@@ -37,7 +37,7 @@ const b = f`@layer{arcgis-link-chart-layout-switcher{display:block}}`, k = {
     "chronological-multi-timeline"
     /* CHRONOLOGICAL_MULTIPLE */
   ]
-}, L = {
+}, n = {
   "organic-standard": "force-directed-link-chart-layout",
   "organic-community": "community-link-chart-layout",
   "basic-grid": "simple-link-chart-layout",
@@ -45,9 +45,9 @@ const b = f`@layer{arcgis-link-chart-layout-switcher{display:block}}`, k = {
   "radial-root-centric": "radial-tree-link-chart-layout",
   "tree-left-to-right": "smart-tree-link-chart-layout",
   "geographic-organic-standard": "geographic-link-chart-layout",
-  "chronological-mono-timeline": "clock-forward",
-  "chronological-multi-timeline": "clock-forward"
-}, v = {
+  "chronological-mono-timeline": "single-timeline",
+  "chronological-multi-timeline": "multi-timeline"
+}, h = {
   "organic-standard": "forceDirected",
   "organic-community": "community",
   "basic-grid": "simple",
@@ -57,42 +57,42 @@ const b = f`@layer{arcgis-link-chart-layout-switcher{display:block}}`, k = {
   "geographic-organic-standard": "geographic",
   "chronological-mono-timeline": "chronologicalSingle",
   "chronological-multi-timeline": "chronologicalMultiple"
-}, M = {
+}, k = {
   base: "esri-link-chart-layout-switcher"
-}, C = m(h);
-class $ extends p {
+}, M = u(g);
+class C extends b {
   constructor() {
-    super(...arguments), this.messages = g(), this.viewModel = C(this), this.autoDestroyDisabled = !1, this.icon = "nodes-link", this.layout = this.viewModel.layout, this.position = "top-left", this.preventExtentUpdate = this.viewModel.preventExtentUpdate, this.state = this.viewModel.state, this.arcgisSwitchLayout = u(() => this.viewModel, "switchLayout"), this.arcgisPropertyChange = d()("state"), this.arcgisReady = y();
+    super(...arguments), this.messages = y(), this.viewModel = M(this), this.appearance = "dropdown", this.autoDestroyDisabled = !1, this.closeOnSelectDisabled = !1, this.icon = "nodes-link", this.layout = this.viewModel.layout, this.position = "top-left", this.preventExtentUpdate = this.viewModel.preventExtentUpdate, this.state = this.viewModel.state, this.arcgisSwitchLayout = w(() => this.viewModel, "switchLayout"), this.arcgisPropertyChange = p()("state"), this.arcgisReady = f();
   }
   static {
-    this.properties = { autoDestroyDisabled: 5, icon: 3, label: 1, layout: 32, position: 3, preventExtentUpdate: 5, referenceElement: 1, state: 3 };
+    this.properties = { appearance: 1, autoDestroyDisabled: 5, closeOnSelectDisabled: 5, icon: 1, label: 1, layout: 32, messageOverrides: 0, position: 3, preventExtentUpdate: 5, referenceElement: 1, state: 3 };
   }
   static {
-    this.shadowRootOptions = w;
+    this.shadowRootOptions = v;
   }
   static {
-    this.styles = b;
+    this.styles = L;
   }
-  //#endregion
-  //#region Public Methods
-  /** Permanently destroy the component */
   async destroy() {
     await this.manager.destroy();
   }
-  /**
-   * Switches the layout of the link chart to the value provided.
-   */
   async switchLayout(t) {
     this.viewModel.switchLayout(t);
   }
-  //#endregion
-  //#region Rendering
+  _renderDropdown() {
+    const { messages: t, icon: o } = this;
+    return e`<calcite-dropdown scale=s width=m max-items=9 .closeOnSelectDisabled=${this.closeOnSelectDisabled}><calcite-button class=${c(s.widgetButton)} slot=trigger kind=neutral .disabled=${this.viewModel.state === "disabled"} .iconStart=${o ?? void 0} .label=${t.layoutOptions ?? "Layout"}></calcite-button>${Object.entries(l).map(([r, i]) => e`<calcite-dropdown-group selection-mode=single .groupTitle=${this.messages[r]}>${i.map((a) => e`<calcite-dropdown-item .iconStart=${n[a]} .selected=${a === this.layout ? !0 : void 0} @click=${() => void this.switchLayout(a)}>${t[h[a]]}</calcite-dropdown-item>`)}</calcite-dropdown-group>`)}</calcite-dropdown>`;
+  }
+  _renderMenuBar() {
+    const { messages: t } = this;
+    return e`<calcite-action-bar scale=s floating overflow-actions-disabled>${Object.entries(l).map(([o, r]) => e`<calcite-action-group .label=${this.messages[o]}>${r.map((i) => e`<calcite-action scale=s .icon=${n[i]} .active=${i === this.layout ? !0 : void 0} @click=${() => void this.switchLayout(i)} .text=${t[h[i]]}></calcite-action>`)}</calcite-action-group>`)}</calcite-action-bar>`;
+  }
   render() {
-    const { messages: t, icon: r } = this;
-    return i`<div class=${a(n(M.base, e.widget))}><calcite-dropdown scale=s width=m max-items=9><calcite-button class=${a(e.widgetButton)} slot=trigger kind=neutral .disabled=${this.viewModel.state === "disabled"} .iconStart=${r ?? void 0} .label=${t.layoutOptions ?? "Layout"}></calcite-button>${Object.entries(k).map(([c, s]) => i`<calcite-dropdown-group selection-mode=single .groupTitle=${this.messages[c]}>${s.map((o) => i`<calcite-dropdown-item .iconStart=${L[o]} .selected=${o === this.layout ? !0 : void 0} @click=${() => void this.switchLayout(o)}>${t[v[o]]}</calcite-dropdown-item>`)}</calcite-dropdown-group>`)}</calcite-dropdown></div>`;
+    const { appearance: t } = this, o = t === "menu-bar" ? this._renderMenuBar() : this._renderDropdown();
+    return e`<div class=${c(m(k.base, s.widget))}>${o}</div>`;
   }
 }
-l("arcgis-link-chart-layout-switcher", $);
+d("arcgis-link-chart-layout-switcher", C);
 export {
-  $ as ArcgisLinkChartLayoutSwitcher
+  C as ArcgisLinkChartLayoutSwitcher
 };

package/dist/components/arcgis-link-chart-layout-switcher/index.d.ts

@@ -2,4 +2,7 @@ import "@esri/calcite-components/components/calcite-dropdown";
 import "@esri/calcite-components/components/calcite-button";
 import "@esri/calcite-components/components/calcite-dropdown-group";
 import "@esri/calcite-components/components/calcite-dropdown-item";
+import "@esri/calcite-components/components/calcite-action-bar";
+import "@esri/calcite-components/components/calcite-action-group";
+import "@esri/calcite-components/components/calcite-action";
 export * from "./customElement.js";

package/dist/components/arcgis-link-chart-layout-switcher/index.js

@@ -2,4 +2,7 @@ import "@esri/calcite-components/components/calcite-dropdown";
 import "@esri/calcite-components/components/calcite-button";
 import "@esri/calcite-components/components/calcite-dropdown-group";
 import "@esri/calcite-components/components/calcite-dropdown-item";
+import "@esri/calcite-components/components/calcite-action-bar";
+import "@esri/calcite-components/components/calcite-action-group";
+import "@esri/calcite-components/components/calcite-action";
 export * from "./customElement.js";

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

@@ -1,62 +1,122 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
 /// <reference types="../../index.d.ts" />
 import { Use } from '@arcgis/lumina/controllers';
-import { Nil } from '@arcgis/components-utils';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { ArcgisReferenceElement } from '../../utils/component-utils';
 import { default as LocateViewModel } from './LocateViewModel';
 
-declare const useLocateViewModel: (component: LitElement & Pick<LocateViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<LocateViewModel>, options?: {
-    editConstructorProperties(props: unknown): unknown;
-} | undefined) => LocateViewModel;
-/** Locate component animates the `arcgis-map` or `arcgis-scene` to the user's current location.
+declare const useLocateViewModel: (component: LitElement & Pick<LocateViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<LocateViewModel>) => LocateViewModel;
+/**
+ * The Locate component animates the Map or Scene to the user's current location.
+ *
+ * This component uses the browser's [Geolocation API](https://developer.mozilla.org/en-US/docs/Web/API/Geolocation_API) which is only available in [secure contexts](https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts), such as HTTPS.
+ * Note that localhost is considered "potentially secure" and can be used for easy testing in browsers that support
+ * [Window.isSecureContext](https://developer.mozilla.org/en-US/docs/Web/API/isSecureContext#browser_compatibility).
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-locate/)
  */
 export declare class ArcgisLocate 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
-     * 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-locate/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
      */
     autoDestroyDisabled: boolean;
-    geolocationOptions: Nil | PositionOptions;
-    /** @default false */
+    geolocationOptions: PositionOptions | undefined;
+    /**
+     * Indicates whether to navigate the view to the position and scale of the geolocated result.
+     *
+     * @default false
+     */
     goToLocationDisabled: boolean;
-    goToOverride: Nil | __esri.GoToOverride;
+    goToOverride: __esri.GoToOverride | undefined;
+    /** The graphic used to show the user's location on the map. */
     graphic: __esri.Graphic;
-    icon: Nil | string;
+    /** @default "gps-off" */
+    icon?: string | undefined;
     /** The component's default label. */
-    label: Nil | string;
-    /** Replace localized message strings with your own strings. */
+    label?: string;
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
     messageOverrides?: typeof this.messages._overrides;
     /** @default false */
     popupDisabled: boolean;
+    /** @default "top-left" */
     position: __esri.UIPosition;
-    referenceElement: ArcgisReferenceElement | Nil | string;
-    scale: number | Nil;
     /**
-     * The current state of the component.
+     * 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;
+    /**
+     * Indicates the scale to set on the view when navigating to the position of the geolocated
+     * result, after a location is returned from the [track](#event-track) event.
+     *
+     * @default null
      */
+    scale: number | undefined;
+    /** The current state of the component. */
     state: "ready" | "disabled" | "error" | "feature-unsupported" | "locating";
     /**
      * This function provides the ability to interrupt and cancel the process of
      * programmatically obtaining the location of the user's device.
      */
     cancelLocate(): Promise<void>;
-    /** Permanently destroy the component */
+    /** Permanently destroy the component. */
     destroy(): Promise<void>;
     locate(): Promise<GeolocationPosition | null>;
     readonly arcgisError: TargetedEvent<this, {
         error: GeolocationPositionError;
     }>;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
         name: "state";
     }>;
-    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>;
     readonly arcgisSuccess: TargetedEvent<this, {
         position: GeolocationPosition;
     }>;
-    private messages;
+    private messages: Partial<{
+        componentLabel: string;
+        title: string;
+        currentLocation: string;
+        timestamp: string;
+        latitude: string;
+        longitude: string;
+        accuracy: string;
+        altitude: string;
+        altitudeAccuracy: string;
+        heading: string;
+        speed: string;
+        permissionError: string;
+        timeoutError: string;
+        positionUnavailable: string;
+        cancel: string;
+    }> & import('@arcgis/lumina/controllers').T9nMeta<{
+        componentLabel: string;
+        title: string;
+        currentLocation: string;
+        timestamp: string;
+        latitude: string;
+        longitude: string;
+        accuracy: string;
+        altitude: string;
+        altitudeAccuracy: string;
+        heading: string;
+        speed: string;
+        permissionError: string;
+        timeoutError: string;
+        positionUnavailable: string;
+        cancel: string;
+    }>;
 }
 export {};