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

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

@@ -0,0 +1,307 @@
+/// <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 { GridPlacementState, GridTheme } from './interfaces';
+import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
+import { default as Color } from '@arcgis/core/Color.js';
+import { default as GridControlsViewModel } from '@arcgis/core/widgets/support/GridControls/GridControlsViewModel.js';
+
+declare const useGridControlsViewModel: (component: LitElement & Pick<GridControlsViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<GridControlsViewModel>) => GridControlsViewModel;
+/**
+ * The Grid Controls component 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**
+ *
+ * - Grid Controls is only supported in a 2D Map component.
+ * - 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.
+ *
+ * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-grid-controls/)
+ */
+export declare class ArcgisGridControls extends LitElement {
+    /**
+     * 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;
+    /** @default "bottom-right" */
+    position: __esri.UIPosition;
+    /**
+     * 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 "grid-unit"
+     */
+    icon?: string;
+    /** The custom color used for drawing the grid, if any. */
+    customColor?: Color;
+    /**
+     * 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.
+     *
+     * @default false
+     */
+    hideColorSelection: boolean;
+    /**
+     * Controls display of the dynamic scaling toggle. Dynamic scaling adjusts the size of the grid to work
+     * well regardless of view scale.
+     *
+     * @default false
+     */
+    hideDynamicScaleToggle: boolean;
+    /**
+     * Controls display of the grid enabled toggle. This toggle controls whether the grid is displayed.
+     *
+     * @default false
+     */
+    hideGridEnabledToggle: boolean;
+    /**
+     * Controls display of the numeric input fields for setting grid spacing and rotation.
+     *
+     * @default false
+     */
+    hideNumericInputs: boolean;
+    /**
+     * Controls display of the grid snapping enabled toggle. This toggle controls whether snapping is enabled.
+     *
+     * @default false
+     */
+    hideGridSnapEnabledToggle: boolean;
+    /**
+     * Controls display of the line interval input field for setting the interval between major grid lines.
+     *
+     * @default false
+     */
+    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.
+     *
+     * @default false
+     */
+    hideOutOfScaleWarning: boolean;
+    /**
+     * Controls display of the grid placement buttons. These buttons allow the user to start interactive
+     * configuration of the grid.
+     *
+     * @default false
+     */
+    hidePlacementButtons: boolean;
+    /**
+     * Controls display of the rotate with map toggle. This toggle controls whether the grid rotates with the map.
+     *
+     * @default false
+     */
+    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.
+     *
+     * @default true
+     */
+    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.
+     *
+     * @default 10
+     */
+    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.
+     *
+     * @default false
+     */
+    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.
+     *
+     * @default false
+     */
+    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.
+     *
+     * @default false
+     */
+    dynamicScaling: boolean;
+    /**
+     * Returns `true` if the grid is in a valid state for manually setting grid properties or starting an interactive placement.
+     *
+     * @default false
+     */
+    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.
+     *
+     * @default false
+     */
+    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 temporarily hide it. If this
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-grid-controls/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
+     */
+    autoDestroyDisabled: boolean;
+    /**
+     * Replace localized message strings with your own strings.
+     *
+     * _**Note**: Individual message keys may change between releases._
+     */
+    messageOverrides?: typeof this._messages._overrides;
+    /** The component's default label. */
+    label?: 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;
+    /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
+    readonly arcgisPropertyChange: TargetedEvent<this, {
+        name: "rotation" | "theme" | "customColor" | "rotateWithMap" | "spacing" | "majorLineInterval" | "gridColor" | "displayEnabled" | "gridOutOfScale" | "dynamicScaling" | "gridControlsEnabled" | "interactivePlacementState" | "snappingEnabled" | "effectiveSpacingAfterDynamicScaling";
+    }>;
+    /** 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;
+        placementOptions: string;
+        gridLineColorPopoverLabel: string;
+        switchLabel: {
+            rotateWithMap: string;
+            scaling: string;
+            display: string;
+            snap: string;
+        };
+        inputLabel: {
+            spacing: string;
+            interval: string;
+            angle: string;
+            theme: string;
+        };
+        gridTheme: {
+            light: string;
+            dark: string;
+            custom: string;
+        };
+        placementState: {
+            interactive: string;
+            place: string;
+            scale: string;
+            rotate: string;
+        };
+        warnings: {
+            dynamicSpacing: string;
+            outOfScale: string;
+            interactivePlaceDisabled: string;
+        };
+    }> & import('@arcgis/lumina/controllers').T9nMeta<{
+        componentLabel: string;
+        placementOptions: string;
+        gridLineColorPopoverLabel: string;
+        switchLabel: {
+            rotateWithMap: string;
+            scaling: string;
+            display: string;
+            snap: string;
+        };
+        inputLabel: {
+            spacing: string;
+            interval: string;
+            angle: string;
+            theme: string;
+        };
+        gridTheme: {
+            light: string;
+            dark: string;
+            custom: string;
+        };
+        placementState: {
+            interactive: string;
+            place: string;
+            scale: string;
+            rotate: string;
+        };
+        warnings: {
+            dynamicSpacing: string;
+            outOfScale: string;
+            interactivePlaceDisabled: string;
+        };
+    }>;
+}
+export {};

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

@@ -0,0 +1,214 @@
+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 h } from "@arcgis/components-utils";
+import { usePropertyChange as T } from "@arcgis/lumina/controllers";
+import { m as E } from "../../chunks/useViewModel.js";
+import g from "@arcgis/core/Color.js";
+import { LitElement as x, createEvent as P, noShadowRoot as k, safeClassMap as d, nothing as u } from "@arcgis/lumina";
+import { css as R } from "@lit/reactive-element/css-tag.js";
+import { substitute as O } from "@arcgis/core/intl.js";
+import { watch as D } from "@arcgis/core/core/reactiveUtils.js";
+import L from "@arcgis/core/widgets/support/GridControls/GridControlsViewModel.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.161 */
+function B(s) {
+  if (s == null || Number.isNaN(s))
+    return 0;
+  const e = s + 180;
+  return Math.trunc(y(e, 360));
+}
+function N(s) {
+  let e = s;
+  return e == null || (typeof e == "string" && (e = Number.parseInt(e, 10)), Number.isNaN(e)) ? 0 : y(Math.trunc(e), 360) - 180;
+}
+function y(s, e) {
+  return (s % e + e) % e;
+}
+const $ = {
+  fromAttribute: (s) => g.fromHex(s),
+  toAttribute: (s) => typeof s == "string" ? s : s?.toHex() ?? ""
+}, W = R`@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 = g.fromArray([115, 115, 115]), v = g.fromArray([200, 200, 200]), A = ["interactive", "place", "rotate"], j = E(L);
+class V extends x {
+  constructor() {
+    super(...arguments), this._labelUid = M(), this._messages = I({}), this._viewModel = j(this), this._placementModeButtonRefs = /* @__PURE__ */ new Map(), this.numericSpacingInputShouldBeVisible = this._viewModel.numericSpacingInputShouldBeVisible, this.position = "bottom-right", this.icon = m.componentIcon, 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 = P();
+  }
+  static {
+    this.properties = { _placementModeButtonRefs: 16, _warningIconTooltipRef: 16, _themePopoverRef: 16, numericSpacingInputShouldBeVisible: 16, referenceElement: 1, position: 3, icon: 1, 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;
+  }
+  get theme() {
+    const e = this.gridColor;
+    return !e || b.equals(e) ? "dark" : v.equals(e) ? "light" : "custom";
+  }
+  set theme(e) {
+    const t = this._viewModel.view;
+    switch (e) {
+      case "dark":
+        this.gridColor = b;
+        break;
+      case "custom":
+        this.customColor == null && (this.customColor = t?.theme?.accentColor ?? new C().accentColor), this.gridColor = this.customColor;
+        break;
+      case "light":
+      default:
+        this.gridColor = v;
+        break;
+    }
+  }
+  async destroy() {
+    await this.manager.destroy();
+  }
+  trySetDisplayEnabled(e) {
+    this._viewModel.trySetDisplayEnabled(e);
+  }
+  loaded() {
+    this.manager.onLifecycle(() => [
+      // Move focus when movement angle changed by touch/mouse (not keyboard!)
+      D(() => this._viewModel.gridColor, (e) => {
+        const t = e instanceof g ? e : typeof e == "string" ? g.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");
+      })
+    ]);
+  }
+  _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();
+  }
+  render() {
+    return n`<div class=${d(h(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: o, 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,
+      o ? 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, o = i != null && i !== t;
+    return n`<div class=${d(h(r.numericInputsContainer))}>${[
+      a ? n`<calcite-label scale=s><span>${this._messages?.inputLabel?.spacing}${o ? n`<calcite-icon class=${d(h(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>${o && this._warningIconTooltipRef ? n`<calcite-tooltip overlay-positioning=fixed placement=leading .referenceElement=${this._warningIconTooltipRef}>${O(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(h(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=${(o) => {
+      o.stopPropagation(), this.dynamicScaling = o.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 = g.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], o = `${this._labelUid}--theme_tile_${a}`, c = `${o}__label`, p = m.gridTheme[a];
+    return n`<div class=${d(h({ [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=${o ?? u} .name=${`${this._labelUid}--theme`} @change=${(w) => {
+      this.theme = a, w.currentTarget.focus();
+    }} tabindex=0 type=radio><div class=${d(r.tileContent)}><calcite-icon .icon=${p} scale=l></calcite-icon><calcite-label .for=${o} 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-grid-controls/interfaces.d.ts

@@ -0,0 +1,2 @@
+export type GridPlacementState = "interactive" | "place" | "rotate";
+export type GridTheme = "custom" | "dark" | "light";