@arcgis/map-components 4.33.0-next.87 → 4.33.0-next.88

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

@@ -5,7 +5,7 @@ import { m as a } 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.87 */
+v4.33.0-next.88 */
 const d = n`@layer{arcgis-expand{display:flex;pointer-events:auto}arcgis-expand>.esri-expand__content--expanded{background-color:var(--calcite-color-background)}}`, c = a(e);
 class l extends s {
   //#endregion

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

@@ -6,7 +6,7 @@ import { m as h } from "../../chunks/useWidget.js";
 import { css as l } 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.87 */
+v4.33.0-next.88 */
 const r = l`@layer{arcgis-feature{display:block}}`, c = h(n);
 class m extends a {
   constructor() {

package/dist/components/arcgis-feature-form/customElement.d.ts

@@ -34,9 +34,6 @@ declare const useFeatureFormWidget: (component: import('@arcgis/components-contr
 }, options?: {
     editConstructorProperties(props: __esri.FeatureFormProperties | undefined): __esri.FeatureFormProperties | Promise<__esri.FeatureFormProperties | undefined> | undefined;
 } | undefined) => FeatureForm;
-/**
- * @internal
- */
 export declare class ArcgisFeatureForm extends LitElement {
     /**
      * If true, the component will not be destroyed automatically when it is

package/dist/components/arcgis-feature-form/customElement.js

@@ -7,7 +7,7 @@ import { m as h } from "../../chunks/useWidget.js";
 import { css as m } 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.87 */
+v4.33.0-next.88 */
 const l = m`@layer{arcgis-feature-form{display:block}}`, g = h(s);
 class n extends r {
   constructor() {

package/dist/components/arcgis-feature-table/customElement.js

@@ -9,7 +9,7 @@ import { e as m, g as c } from "../../chunks/component-utils.js";
 import { css as u } 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.87 */
+v4.33.0-next.88 */
 const w = u`@layer{arcgis-feature-table{display:block}.arcgis-feature-table{width:100%;height:100%}}`, b = g(d);
 class y extends a {
   constructor() {

package/dist/components/arcgis-feature-templates/customElement.js

@@ -7,7 +7,7 @@ import { m as a } from "../../chunks/useWidget.js";
 import { css as h } 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.87 */
+v4.33.0-next.88 */
 const n = h`@layer{arcgis-feature-templates{display:block}}`, c = a(s);
 class d extends o {
   constructor() {

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

@@ -7,7 +7,7 @@ import { m as d } from "../../chunks/useWidget.js";
 import { css as l } 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.87 */
+v4.33.0-next.88 */
 const c = l`@layer{arcgis-features{display:flex;flex-direction:column;overflow:hidden;.esri-features{flex:1 1 auto;overflow:hidden}}}`, g = d(o);
 class u extends r {
   constructor() {

package/dist/components/arcgis-floor-filter/customElement.js

@@ -5,7 +5,7 @@ import { m as a } from "../../chunks/useWidget.js";
 import { css as r } 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.87 */
+v4.33.0-next.88 */
 const h = r`@layer{arcgis-floor-filter{display:block}}`, n = a(i);
 class c extends s {
   constructor() {

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

@@ -10,7 +10,7 @@ import { g as o } from "../../chunks/globalCss.js";
 import { css as y } 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.87 */
+v4.33.0-next.88 */
 const b = y`@layer{arcgis-fullscreen{display:block}}`, v = {
   base: "esri-fullscreen"
 }, M = w(m);

package/dist/components/arcgis-grid-controls/customElement.d.ts

@@ -0,0 +1,206 @@
+/// <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/components-controllers';
+import { GridPlacementState, GridTheme } from './interfaces';
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { default as Color } from '@arcgis/core/Color.js';
+
+declare const useGridControlsViewModel: (component: import('@arcgis/components-controllers').StencilLifecycles & {
+    manager: import('@arcgis/components-controllers').ControllerManager;
+    el: HTMLElement;
+    autoDestroyDisabled?: boolean;
+    destroy?: () => Promise<void>;
+} & Pick<__esri.GridControlsViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<__esri.GridControlsViewModel>, options?: {
+    editConstructorProperties(props: unknown): unknown;
+} | undefined) => __esri.GridControlsViewModel;
+/**
+ * `GridControls` provides a user interface (UI) for configuring and displaying a two-dimensional grid.
+ * The grid displayed provides a network of horizontal and vertical lines used to divide the view into equal cells.
+ * With support for snapping, the grid lines can be used as a reference when drawing features.
+ * Note: grid controls are embedded in snapping controls for Sketch and Editor by default.
+ *
+ * **Known limitations**
+ *
+ * - GridControls is only supported in 2D/arcgis-map.
+ * - The grid spacing does not correspond to real world measurements. Distortion will be minimized when used in conjunction with an equal area basemap.
+ * - The grid spacing input will be hidden when working with Web Mercator and Geographic Coordinate Systems.
+ */
+export declare class ArcgisGridControls extends LitElement {
+    referenceElement: ArcgisReferenceElement | Nil | string;
+    position: __esri.UIPosition;
+    /**
+     * Icon which represents the component. It is typically used when the component is controlled by another
+     * one (e.g. in <arcgis-expand>).
+     *
+     * @see [Calcite Icon Search](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default "grid-unit"
+     */
+    icon: Nil | string;
+    /**
+     * The custom color used for drawing the grid, if any.
+     */
+    customColor: Color | Nil;
+    /**
+     * The [SnappingOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-interactive-snapping-SnappingOptions.html)
+     * that will be controlled by this component if the snapping toggle is enabled for display.
+     * If SnappingOptions are provided, grid display will be automatically enabled or disabled to match snapping state.
+     */
+    snappingOptions: nullish | __esri.SnappingOptions;
+    /**
+     * The color scheme used to display the grid. This will be light, dark, or custom. When theme is set to custom,
+     * the [customColor](#customColor) is shown, otherwise a default light or dark theme color is used.
+     *
+     * @default "dark"
+     */
+    get theme(): GridTheme | Nil;
+    set theme(theme: GridTheme | Nil);
+    /**
+     * Controls display of the color and theme selection options.
+     */
+    hideColorSelection: boolean;
+    /**
+     * Controls display of the dynamic scaling toggle. Dynamic scaling adjusts the size of the grid to work
+     * well regardless of view scale.
+     */
+    hideDynamicScaleToggle: boolean;
+    /**
+     * Controls display of the grid enabled toggle. This toggle controls whether the grid is displayed.
+     */
+    hideGridEnabledToggle: boolean;
+    /**
+     * Controls display of the numeric input fields for setting grid spacing and rotation.
+     */
+    hideNumericInputs: boolean;
+    /**
+     * Controls display of the grid snapping enabled toggle. This toggle controls whether snapping is enabled.
+     */
+    hideGridSnapEnabledToggle: boolean;
+    /**
+     * Controls display of the line interval input field for setting the interval between major grid lines.
+     */
+    hideLineIntervalInput: boolean;
+    /**
+     * Controls display of the out of scale warning. This warning is displayed when the grid is not shown
+     * because it would be too small at the current scale and dynamic scaling is disabled.
+     */
+    hideOutOfScaleWarning: boolean;
+    /**
+     * Controls display of the grid placement buttons. These buttons allow the user to start interactive
+     * configuration of the grid.
+     */
+    hidePlacementButtons: boolean;
+    /**
+     * Controls display of the rotate with map toggle. This toggle controls whether the grid rotates with the map.
+     */
+    hideRotateWithMapToggle: boolean;
+    /**
+     * Rotation of the grid in radians. NOTE: UI controls convert to and from degrees automatically.
+     */
+    rotation: number;
+    /**
+     * Controls whether the grid rotates with the map, or stays fixed to the screen.
+     */
+    rotateWithMap: boolean;
+    /**
+     * Length of a grid cell. Grid cells are always square. Defined in [unit](#unit).
+     * @default 1
+     */
+    spacing: number;
+    /**
+     * Controls the number of grid cells shown between major grid lines. Can be anything between 1 and 15.
+     * No minor grid lines are shown when this is set to 1.
+     */
+    majorLineInterval: number;
+    /**
+     * Controls the color of the major grid lines. Minor grid lines are a slightly transparent version of this color.
+     */
+    gridColor: Color | Nil;
+    /**
+     * Returns `true` if the grid is enabled for display.
+     * Use [trySetDisplayEnabled](#trySetDisplayEnabled) to enable or disable grid display.
+     */
+    readonly displayEnabled: boolean;
+    /**
+     * True if the grid is currently not displayed (and therefore also not a valid snap target),
+     * because [dynamicScaling](#dynamicScaling) is off and the grid cells are too small
+     * to render at the current scale.
+     */
+    readonly gridOutOfScale: boolean;
+    /**
+     * Unit of measure (foot, meter, etc) used when defining the [spacing](#spacing) grid cell.
+     * Note that units are defined relatively to the map's spatial reference length unit,
+     * which will not correspond to geographic distance unless using a special-purpose basemap
+     * within a supported target area.
+     *
+     * When using Web Mercator, the projection defines the length of a meter in projection system units;
+     * this length is equal to a geographic meter only at the equator. On screen, the size of the grid cells is constant
+     * from the equator to the poles, but the real-world size of the grid cell is much larger further from the equator.
+     *
+     * The length of the grid cells can usefully correspond to a geographic length when the Grid is used with an
+     * appropriate spatial reference (for example a local system or a State Plane system) within the reference's area of interest.
+     */
+    unit: nullish | __esri.LengthUnit;
+    /**
+     * Returns `true` if the grid is set to scale dynamically. When dynamic scaling is enabled,
+     * grid cells are added or removed to ensure that grid cells are a reasonable size on screen as the user zooms.
+     * The way additional grid lines are shown is controlled by the [majorLineInterval](#majorLineInterval) property.
+     */
+    dynamicScaling: boolean;
+    /**
+     * Returns `true` if the grid is in a valid state for manually setting grid properties or starting an interactive placement.
+     */
+    readonly gridControlsEnabled: boolean;
+    /**
+     * Sets the interactive placement state, either starting or ending a draw operation that implicitly adjusts the grid.
+     * Interactive placement allows the user to define the center of the grid, then the scale and rotation of the grid by
+     * drawing a second point. Setting this to "place" allows the user to move the grid center only. Setting this to "rotate"
+     * keeps the scale and center of the grid constant while rotating the grid by defining a second point.
+     * @default null
+     */
+    interactivePlacementState: nullish | "rotate" | "place" | "interactive";
+    /**
+     * Controls snapping behavior if [snappingOptions](#snappingOptions) has been defined.
+     * If [snappingOptions](#snappingOptions) have been defined, disabling or enabling grid snapping will
+     * also disable or enable grid display.
+     *
+     * @default false
+     */
+    snappingEnabled: boolean;
+    /**
+     * Returns the actual spacing of grid lines after dynamic scaling has been applied at the current scale.
+     */
+    readonly effectiveSpacingAfterDynamicScaling: number | nullish;
+    /**
+     * Use this property to disable the interactive grid placement buttons as needed.
+     * An example use case might be to block interaction while another interactive operation
+     * (e.g. sketching) is in progress.
+     */
+    placementDisabled: boolean;
+    /**
+     * 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.
+     */
+    autoDestroyDisabled: boolean;
+    /** Overwrite localized strings for this component */
+    messageOverrides?: typeof this._messages._overrides;
+    /** The component's default label. */
+    label: Nil | string;
+    /** Permanently destroy the component */
+    destroy(): Promise<void>;
+    /**
+     * Call this to turn the grid on/off.
+     * @param enabled Desired end state for grid display.
+     */
+    trySetDisplayEnabled(enabled: boolean): void;
+    readonly arcgisPropertyChange: TargetedEvent<this, {
+        name: "rotation" | "theme" | "customColor" | "rotateWithMap" | "spacing" | "majorLineInterval" | "gridColor" | "displayEnabled" | "gridOutOfScale" | "dynamicScaling" | "gridControlsEnabled" | "interactivePlacementState" | "snappingEnabled" | "effectiveSpacingAfterDynamicScaling";
+    }>;
+    readonly arcgisReady: TargetedEvent<this, undefined>;
+    private _messages;
+}
+export {};

package/dist/components/arcgis-grid-controls/customElement.js

@@ -0,0 +1,233 @@
+import { c as S } from "../../chunks/runtime.js";
+import { html as n } from "lit-html";
+import { ref as f } from "lit-html/directives/ref.js";
+import { g as _ } from "../../chunks/globalCss.js";
+import C from "@arcgis/core/views/Theme.js";
+import { u as I } from "../../chunks/useT9n.js";
+import { generateGuid as M, classes as g } from "@arcgis/components-utils";
+import { usePropertyChange as T } from "@arcgis/components-controllers";
+import { m as E } from "../../chunks/useViewModel.js";
+import { newWidgetsSupportGridControlsGridControlsViewModel as x } from "@arcgis/core-adapter";
+import h from "@arcgis/core/Color.js";
+import { LitElement as P, createEvent as R, noShadowRoot as k, safeClassMap as d, nothing as u } from "@arcgis/lumina";
+import { css as O } from "@lit/reactive-element/css-tag.js";
+import { substitute as D } from "@arcgis/core/intl.js";
+import { watch as L } from "@arcgis/core/core/reactiveUtils.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.88 */
+function B(o) {
+  if (o == null || Number.isNaN(o))
+    return 0;
+  const e = o + 180;
+  return Math.trunc(w(e, 360));
+}
+function N(o) {
+  let e = o;
+  return e == null || (typeof e == "string" && (e = Number.parseInt(e, 10)), Number.isNaN(e)) ? 0 : w(Math.trunc(e), 360) - 180;
+}
+function w(o, e) {
+  return (o % e + e) % e;
+}
+const $ = {
+  fromAttribute: (o) => h.fromHex(o),
+  toAttribute: (o) => typeof o == "string" ? o : o?.toHex() ?? ""
+}, W = O`@layer{calcite-block>.arcgis-grid-controls{background:none;padding:0}.arcgis-ui-corner .arcgis-expand .arcgis-widget--panel .arcgis-widget--panel.arcgis-grid-controls{overflow-y:visible}.arcgis-grid-controls{user-select:none;display:flex;flex-flow:column wrap;padding:var(--calcite-spacing-sm);.container{display:flex;flex:1 1 auto;flex-direction:column;gap:var(--calcite-spacing-sm)}.numeric-inputs-container{display:grid;grid-auto-columns:1fr;grid-auto-flow:column;gap:var(--calcite-spacing-sm)}arcgis-labeled-switch{margin-block-end:var(--calcite-spacing-sm)}.switch--bordered{border-width:0 0 var(--calcite-spacing-px) 0;border-style:solid;border-color:var(--calcite-color-border-1);padding-block-end:var(--calcite-spacing-sm)}.tile-group{display:flex;column-gap:var(--calcite-spacing-md);align-items:start;margin-bottom:calc(0px - var(--calcite-spacing-sm))}.tile{position:relative;.content{display:flex;flex-direction:column;row-gap:var(--calcite-spacing-md);align-items:center;padding:var(--calcite-spacing-md);color:var(--calcite-color-text-2)}&.disabled{opacity:var(--calcite-opacity-disabled)}&:focus-within{outline:var(--calcite-spacing-base) solid var(--calcite-color-brand);outline-offset:var(--calcite-spacing-base)}input[type=radio]{appearance:none;position:absolute;inset:0;opacity:.001;border:var(--calcite-spacing-px) solid transparent;cursor:pointer;&:checked+.content{border:var(--calcite-spacing-px) solid var(--calcite-color-brand)}+.content{border:var(--calcite-spacing-px) solid transparent;calcite-label{margin-bottom:calc(0px - var(--calcite-label-margin-bottom, .75rem));font-weight:var(--calcite-font-weight-medium)}}}}.inline-icon{margin-left:var(--calcite-spacing-xs);vertical-align:top;color:var(--calcite-color-status-warning)}}}`, G = "arcgis-grid-controls", r = {
+  base: G,
+  borderedSwitch: "switch--bordered",
+  container: "container",
+  numericInputsContainer: "numeric-inputs-container",
+  tileGroup: "tile-group",
+  tile: "tile",
+  tileDisabled: "disabled",
+  tileContent: "content",
+  inlineIcon: "inline-icon"
+}, m = {
+  componentIcon: "grid-unit",
+  gridTheme: { light: "circle", dark: "circle-area", custom: "palette" },
+  placementState: { interactive: "maximum-territory-distance", place: "move", rotate: "rotate" },
+  warning: "exclamation-mark-triangle"
+}, b = h.fromArray([115, 115, 115]), v = h.fromArray([200, 200, 200]), A = ["interactive", "place", "rotate"], j = E(x);
+class V extends P {
+  constructor() {
+    super(...arguments), this._labelUid = M(), this._messages = I({}), this._viewModel = j(this), this._placementModeButtonRefs = /* @__PURE__ */ new Map(), this._warningIconTooltipRef = void 0, this._themePopoverRef = void 0, this.numericSpacingInputShouldBeVisible = this._viewModel.numericSpacingInputShouldBeVisible, this.position = "bottom-right", this.icon = m.componentIcon, this.customColor = null, this.snappingOptions = this._viewModel.snappingOptions, this.hideColorSelection = !1, this.hideDynamicScaleToggle = !1, this.hideGridEnabledToggle = !1, this.hideNumericInputs = !1, this.hideGridSnapEnabledToggle = !1, this.hideLineIntervalInput = !1, this.hideOutOfScaleWarning = !1, this.hidePlacementButtons = !1, this.hideRotateWithMapToggle = !1, this.rotation = this._viewModel.rotation, this.rotateWithMap = this._viewModel.rotateWithMap, this.spacing = this._viewModel.spacing, this.majorLineInterval = this._viewModel.majorLineInterval, this.gridColor = this._viewModel.gridColor, this.displayEnabled = this._viewModel.displayEnabled, this.gridOutOfScale = this._viewModel.gridOutOfScale, this.unit = this._viewModel.unit, this.dynamicScaling = this._viewModel.dynamicScaling, this.gridControlsEnabled = this._viewModel.gridControlsEnabled, this.interactivePlacementState = this._viewModel.interactivePlacementState, this.snappingEnabled = this._viewModel.snappingEnabled, this.effectiveSpacingAfterDynamicScaling = this._viewModel.effectiveSpacingAfterDynamicScaling, this.placementDisabled = this._viewModel.placementDisabled, this.autoDestroyDisabled = !1, this.arcgisPropertyChange = T()("customColor", "theme", "spacing", "rotation", "majorLineInterval", "rotateWithMap", "dynamicScaling", "snappingEnabled", "interactivePlacementState", "displayEnabled", "gridOutOfScale", "effectiveSpacingAfterDynamicScaling", "gridControlsEnabled", "gridColor"), this.arcgisReady = R();
+  }
+  static {
+    this.properties = { _placementModeButtonRefs: 16, _warningIconTooltipRef: 16, _themePopoverRef: 16, numericSpacingInputShouldBeVisible: 16, referenceElement: 1, position: 3, icon: 3, customColor: [3, { converter: $ }], snappingOptions: 0, theme: 1, hideColorSelection: 5, hideDynamicScaleToggle: 5, hideGridEnabledToggle: 5, hideNumericInputs: 5, hideGridSnapEnabledToggle: 5, hideLineIntervalInput: 5, hideOutOfScaleWarning: 5, hidePlacementButtons: 5, hideRotateWithMapToggle: 5, rotation: 11, rotateWithMap: 5, spacing: 11, majorLineInterval: 11, gridColor: [3, { converter: $ }], displayEnabled: 4, gridOutOfScale: 7, unit: 1, dynamicScaling: 5, gridControlsEnabled: 4, interactivePlacementState: 3, snappingEnabled: 5, effectiveSpacingAfterDynamicScaling: 43, placementDisabled: 5, autoDestroyDisabled: 5, messageOverrides: 0, label: 1 };
+  }
+  static {
+    this.styles = W;
+  }
+  static {
+    this.shadowRootOptions = k;
+  }
+  /**
+   * The color scheme used to display the grid. This will be light, dark, or custom. When theme is set to custom,
+   * the [customColor](#customColor) is shown, otherwise a default light or dark theme color is used.
+   *
+   * @default "dark"
+   */
+  get theme() {
+    const e = this.gridColor;
+    return !e || b.equals(e) ? "dark" : v.equals(e) ? "light" : "custom";
+  }
+  set theme(e) {
+    const { customColor: t } = this, i = this._viewModel.view;
+    switch (e) {
+      case "dark":
+        this.gridColor = b;
+        break;
+      case "custom":
+        t == null && (this.customColor = i?.theme?.accentColor ?? new C().accentColor), this.gridColor = this.customColor;
+        break;
+      case "light":
+      default:
+        this.gridColor = v;
+        break;
+    }
+  }
+  //#endregion
+  //#region Public Methods
+  /** Permanently destroy the component */
+  async destroy() {
+    await this.manager.destroy();
+  }
+  /**
+   * Call this to turn the grid on/off.
+   * @param enabled Desired end state for grid display.
+   */
+  trySetDisplayEnabled(e) {
+    this._viewModel.trySetDisplayEnabled(e);
+  }
+  //#endregion
+  //#region Lifecycle
+  loaded() {
+    this.manager.onLifecycle(() => [
+      // Move focus when movement angle changed by touch/mouse (not keyboard!)
+      L(() => this._viewModel.gridColor, (e) => {
+        const t = e instanceof h ? e : typeof e == "string" ? h.fromHex(e) : null;
+        t && !b.equals(e) && !v.equals(t) ? this.customColor = t : b.equals(t) ? this.theme = "dark" : v.equals(t) && (this.theme = "light");
+      })
+    ]);
+  }
+  //#endregion
+  //#region Private Methods
+  _togglePlacementState(e) {
+    this.interactivePlacementState = this.interactivePlacementState === e ? null : e;
+  }
+  _setWarningIconRef(e) {
+    this._warningIconTooltipRef = e;
+  }
+  _setPopoverRef(e) {
+    this._themePopoverRef = e;
+  }
+  _emptyFunction(e) {
+  }
+  _setPlacementButtonRef(e) {
+    if (e) {
+      const t = e.dataset.placementAction;
+      this._placementModeButtonRefs.set(t, e);
+    } else
+      this._placementModeButtonRefs.clear();
+  }
+  //#endregion
+  //#region Rendering
+  render() {
+    return n`<div class=${d(g(r.base, _.widget, _.panel))}><div class=${d(r.container)}>${this._renderContent()}</div></div>`;
+  }
+  _renderContent() {
+    const { hideGridEnabledToggle: e, hidePlacementButtons: t, hideNumericInputs: i, hideLineIntervalInput: a, hideGridSnapEnabledToggle: l, hideDynamicScaleToggle: s, hideRotateWithMapToggle: c, hideColorSelection: p } = this;
+    return [
+      e ? void 0 : this._renderEnabledToggle(),
+      t ? void 0 : this._renderGridPlacementButtons(),
+      i ? void 0 : this._renderNumericInputs(),
+      a ? void 0 : this._renderIntervalInput(),
+      !l && this.snappingOptions ? this._renderSnappingToggle() : void 0,
+      s ? void 0 : this._renderDynamicScaleToggle(),
+      c ? void 0 : this._renderRotateToggle(),
+      p ? void 0 : this._renderColorSelection()
+    ];
+  }
+  _renderGridPlacementButtons() {
+    const { interactivePlacementState: e, placementDisabled: t, gridControlsEnabled: i } = this, a = t || !i;
+    return n`<calcite-label scale=s>${this._messages.placementOptions}<calcite-action-bar expand-disabled layout=horizontal>${A.map((l) => this._renderPlacementModeButton(l, a, e))}</calcite-action-bar></calcite-label>`;
+  }
+  _renderPlacementModeButton(e, t, i) {
+    const a = this._messages?.placementState?.[e], l = this._placementModeButtonRefs.get(e);
+    return n`<div><calcite-action .active=${i === e} alignment=center .disabled=${t} .icon=${m.placementState[e]} data-placement-action=${e ?? u} @click=${() => this._togglePlacementState(e)} .text=${a ?? ""} ${f(this._setPlacementButtonRef)}></calcite-action>${l ? n`<calcite-tooltip overlay-positioning=fixed placement=top .referenceElement=${l}>${a}</calcite-tooltip>` : void 0}</div>`;
+  }
+  _renderNumericInputs() {
+    const { rotation: e, spacing: t, effectiveSpacingAfterDynamicScaling: i, numericSpacingInputShouldBeVisible: a, gridControlsEnabled: l } = this, s = i != null && i !== t;
+    return n`<div class=${d(g(r.numericInputsContainer))}>${[
+      a ? n`<calcite-label scale=s><span>${this._messages?.inputLabel?.spacing}${s ? n`<calcite-icon class=${d(g(r.inlineIcon))} .icon=${m.warning} scale=s tabindex=0 ${f(this._setWarningIconRef)}></calcite-icon>` : void 0}</span><calcite-input-number .disabled=${!l} number-button-type=none .value=${t?.toFixed(2)} @calciteInputNumberChange=${({ currentTarget: c }) => {
+        const p = Number.parseFloat(c.value);
+        this.spacing = p, p !== this.spacing && (c.value = `${this.spacing}`);
+      }}></calcite-input-number>${s && this._warningIconTooltipRef ? n`<calcite-tooltip overlay-positioning=fixed placement=leading .referenceElement=${this._warningIconTooltipRef}>${D(this._messages?.warnings?.dynamicSpacing ?? "", { actualSpacingIncludingUnit: i }, {
+        format: {
+          actualSpacingIncludingUnit: {
+            type: "number",
+            intlOptions: {
+              minimumFractionDigits: 2,
+              maximumFractionDigits: 2,
+              unit: this.unit ?? "meters",
+              style: "decimal"
+            }
+          }
+        }
+      })}</calcite-tooltip>` : void 0}</calcite-label>` : void 0,
+      n`<calcite-label scale=s>${this._messages?.inputLabel?.angle}<calcite-input-number .disabled=${!l} integer number-button-type=none suffix-text=\u00B0 .value=${`${B(e)}`} @calciteInputNumberChange=${({ currentTarget: c }) => this.rotation = N(c.value)}></calcite-input-number></calcite-label>`
+    ]}</div>`;
+  }
+  _renderIntervalInput() {
+    const { majorLineInterval: e, gridControlsEnabled: t } = this;
+    return n`<div class=${d(g(r.numericInputsContainer))}><calcite-label scale=s>${this._messages?.inputLabel?.interval}<calcite-input-number .disabled=${!t} integer max=15 min=1 number-button-type=vertical .value=${`${e}`} @calciteInputNumberChange=${({ currentTarget: i }) => {
+      const a = Number.parseInt(i.value, 10);
+      this.majorLineInterval = a, a !== this.majorLineInterval && (i.value = `${this.majorLineInterval}`);
+    }}></calcite-input-number></calcite-label></div>`;
+  }
+  _renderSnappingToggle() {
+    const { snappingOptions: e, gridControlsEnabled: t } = this, i = e?.gridEnabled ?? !1;
+    return n`<arcgis-labeled-switch .checked=${!!i} .disabled=${!(t && !!e)} .label=${this._messages?.switchLabel?.snap} @arcgisCheckedChanged=${(l) => {
+      l.stopPropagation(), this.snappingOptions?.set("gridEnabled", l.detail);
+    }}></arcgis-labeled-switch>`;
+  }
+  _renderDynamicScaleToggle() {
+    const { _messages: e, gridOutOfScale: t, dynamicScaling: i, gridControlsEnabled: a } = this, l = !this.hideOutOfScaleWarning && t;
+    return n`<arcgis-labeled-switch .checked=${i} .disabled=${!a} .hint=${l ? e?.warnings?.outOfScale : void 0} .hintIcon=${m.warning} hint-kind=warning .label=${e?.switchLabel?.scaling} @arcgisCheckedChanged=${(s) => {
+      s.stopPropagation(), this.dynamicScaling = s.detail;
+    }}></arcgis-labeled-switch>`;
+  }
+  _renderRotateToggle() {
+    const { gridControlsEnabled: e, rotateWithMap: t } = this;
+    return n`<arcgis-labeled-switch .checked=${t} .disabled=${!e} .label=${this._messages?.switchLabel?.rotateWithMap ?? ""} @arcgisCheckedChanged=${(i) => {
+      i.stopPropagation(), this.rotateWithMap = i.detail;
+    }}></arcgis-labeled-switch>`;
+  }
+  _renderEnabledToggle() {
+    return n`<div class=${d(r.borderedSwitch)}><arcgis-labeled-switch .checked=${this.displayEnabled} .disabled=${!!this.interactivePlacementState} .label=${this._messages?.switchLabel?.display} @arcgisCheckedChanged=${(e) => {
+      e.stopPropagation(), this.trySetDisplayEnabled(e.detail);
+    }}></arcgis-labeled-switch></div>`;
+  }
+  _renderColorSelection() {
+    const { customColor: e } = this;
+    return n`<calcite-label scale=s>${this._messages?.inputLabel?.theme}<div class=${d(r.tileGroup)}>${[
+      this._renderThemeTile({ value: "dark" }),
+      this._renderThemeTile({ value: "light" }),
+      this._renderThemeTile({ value: "custom" }),
+      this._themePopoverRef ? n`<calcite-popover auto-close .label=${this._messages?.gridLineColorPopoverLabel ?? ""} overlay-positioning=fixed .referenceElement=${this._themePopoverRef}><calcite-color-picker alpha-channel saved-disabled .value=${e?.toHex({ digits: 8 }) ?? "#000000ff"} @calciteColorPickerChange=${(t) => {
+        const i = h.fromHex(t.currentTarget.value);
+        i && (this.customColor = i, this.theme = "custom");
+      }}></calcite-color-picker></calcite-popover>` : void 0
+    ]}</div></calcite-label>`;
+  }
+  _renderThemeTile(e) {
+    const { theme: t, gridControlsEnabled: i } = this, { value: a } = e, l = this._messages?.gridTheme?.[a], s = `${this._labelUid}--theme_tile_${a}`, c = `${s}__label`, p = m.gridTheme[a];
+    return n`<div class=${d(g({ [r.tile]: !0, [r.tileDisabled]: !i }))} role=button ${f(a === "custom" ? this._setPopoverRef : this._emptyFunction)}><input aria-labelledby=${c ?? u} .checked=${t === a} .disabled=${!i} id=${s ?? u} .name=${`${this._labelUid}--theme`} @change=${(y) => {
+      this.theme = a, y.currentTarget.focus();
+    }} tabindex=0 type=radio><div class=${d(r.tileContent)}><calcite-icon .icon=${p} scale=l></calcite-icon><calcite-label .for=${s} id=${c ?? u}>${l}</calcite-label></div></div>`;
+  }
+}
+S("arcgis-grid-controls", V);
+export {
+  V as ArcgisGridControls
+};

package/dist/components/arcgis-grid-controls/gridUtils.d.ts

@@ -0,0 +1,16 @@
+import { Nil } from '@arcgis/components-utils';
+import { default as Color } from '@arcgis/core/Color.js';
+/** Convert grid rotation value to user-facing degrees value. */
+export declare function gridRotationToDegrees(rotationFromGrid: Nil | number): number;
+/**
+ * Takes a number or string representation of grid rotation in degrees,
+ * and transforms to the equivalent MeasuredGrid rotation value.
+ */
+export declare function userInputToGridRotation(rotationFromAnywhere: Nil | number | string): number;
+/** Applies a single color to a grid; major line gets color as-is, minor line gets color with half opacity. */
+export declare function applyColorToGrid(grid: Nil | object, color: number[]): void;
+export declare function moduloPositive(a: number, n: number): number;
+export declare const ColorPropertyConverter: {
+    fromAttribute: (value: string) => Color | Nil;
+    toAttribute: (value: Color | Nil | string) => string;
+};

package/dist/components/arcgis-grid-controls/index.d.ts

@@ -0,0 +1,10 @@
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-action-bar";
+import "@esri/calcite-components/components/calcite-action";
+import "@esri/calcite-components/components/calcite-tooltip";
+import "@esri/calcite-components/components/calcite-icon";
+import "@esri/calcite-components/components/calcite-input-number";
+import "../arcgis-labeled-switch/index.js";
+import "@esri/calcite-components/components/calcite-popover";
+import "@esri/calcite-components/components/calcite-color-picker";
+export * from "./customElement.js";

package/dist/components/arcgis-grid-controls/index.js

@@ -0,0 +1,10 @@
+import "@esri/calcite-components/components/calcite-label";
+import "@esri/calcite-components/components/calcite-action-bar";
+import "@esri/calcite-components/components/calcite-action";
+import "@esri/calcite-components/components/calcite-tooltip";
+import "@esri/calcite-components/components/calcite-icon";
+import "@esri/calcite-components/components/calcite-input-number";
+import "../arcgis-labeled-switch/index.js";
+import "@esri/calcite-components/components/calcite-popover";
+import "@esri/calcite-components/components/calcite-color-picker";
+export * from "./customElement.js";

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

@@ -6,7 +6,7 @@ import { m as r } 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.87 */
+v4.33.0-next.88 */
 const h = n`@layer{arcgis-histogram{display:block}}`, d = r(e);
 class m extends s {
   constructor() {

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

@@ -6,7 +6,7 @@ import { m as n } from "../../chunks/useWidget.js";
 import { css as d } 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.87 */
+v4.33.0-next.88 */
 const h = d`@layer{arcgis-histogram-range-slider{display:block}}`, l = n(s);
 class g extends a {
   constructor() {

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

@@ -11,7 +11,7 @@ import { g as a } from "../../chunks/globalCss.js";
 import { css as u } 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.87 */
+v4.33.0-next.88 */
 const b = u`@layer{arcgis-home{display:block}}`, y = {
   base: "esri-home"
 }, M = f(d);

package/dist/components/arcgis-labeled-switch/customElement.d.ts

@@ -0,0 +1,41 @@
+/// <reference types="../../index.d.ts" />
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+
+/**
+ * Labeled switch component shows a label, a switch, and optionally an icon with a tooltip for hints.
+ * Used by grid controls, snapping controls, etc.
+ * @private
+ */
+export declare class LabeledSwitch extends LitElement {
+    /**
+     * Tracks the state of the switch.
+     */
+    checked: boolean;
+    /**
+     * Used to disable the switch.
+     */
+    disabled: boolean;
+    /**
+     * Label to display alongside the switch.
+     */
+    label: string | null;
+    /**
+     * Hint shown when user hovers over the hint icon.
+     */
+    hint: string | null;
+    /**
+     * Icon to show for the hint. Common values are "warning" and "information"
+     */
+    hintIcon: string | null;
+    /**
+     * Controls the presentation of the hint icon. Uses a yellow color if set to warning.
+     * @default "info"
+     */
+    hintKind: "info" | "warning";
+    /** Permanently destroy the component */
+    destroy(): Promise<void>;
+    /**
+     * Emitted when the switch is toggled. Event detail is the new checked state.
+     */
+    readonly arcgisCheckedChanged: TargetedEvent<this, boolean>;
+}