@arcgis/common-components 5.1.0-next.67 → 5.1.0-next.69

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

@@ -4,9 +4,9 @@ import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { Popover as Popover } from "@esri/calcite-components/components/calcite-popover";
 
 /**
- * The Slider component is used to filter data or collect numeric input from users. It supports single or multiple thumbs, configured via the
- * [values](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#values) property. The Slider can be displayed in horizontal or vertical [layout](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#layout), supports snapping to defined [steps](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#steps),
- * configurable value [precision](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#precision), and custom [labelFormatter](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#labelFormatter). It also includes keyboard interaction,
+ * The slider component is used to filter data or collect numeric input from users. It supports single or multiple thumbs, configured via the
+ * [values](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#values) property. The slider can be displayed in a horizontal or vertical [layout](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#layout), and it supports snapping to defined [steps](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#steps),
+ * configurable value [precision](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#precision), and a custom [labelFormatter](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#labelFormatter). It also includes keyboard interaction,
  * optional editable labels, and customizable popover content.
  *
  * The slider component can be set up with the [arcgis-ticks](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-ticks/) component. See the example below:
@@ -17,7 +17,8 @@ import type { Popover as Popover } from "@esri/calcite-components/components/cal
  * </arcgis-slider>
  * ```
  *
- * ## Which slider should you use: arcgis-slider or calcite-slider?
+ * > [!TIP]
+ * > Which slider should you use: `arcgis-slider` or `calcite-slider`?
  * >
  * > Use [calcite-slider](https://developers.arcgis.com/calcite-design-system/components/slider/) by default. It provides a consistent UI/UX and supports most common slider use cases.
  * >
@@ -309,28 +310,30 @@ export abstract class ArcgisSlider extends LitElement {
    */
   accessor showRangeLabels: boolean;
   /**
-   * Sets steps, or intervals, on the slider that restrict user
+   * Sets intervals on the slider that restrict user
    * input to specific values. If an array of numbers is passed to this
    * property, the slider thumbs may only be moved to the positions
    * specified in the array.
    *
+   * This can be set as comma-separated numbers in the attribute (e.g., `<arcgis-slider steps="10, 20, 30"></arcgis-slider>`)
+   * or programmatically as either a single number or an array of numbers (e.g., `slider.steps = 10`, `slider.steps = [10, 20, 30]`).
+   *
    * If a single number is set, then steps are set along the entire
-   * slider range at an interval of the provided value. In this scenario,
-   * the user may only slide the thumbs to values at the provided interval.
-   * For example, if a value of `0.5` is set here, and the slider
-   * [min](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#min) is `0` and the slider [max](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#max) is `10`, then the user will
-   * only be able to update the thumbs to values of 0, 0.5, 1.0, 1.5, 2.0, etc.
+   * slider range at an interval of the provided value. The user may
+   * only slide the thumbs to values at the provided interval.
+   * For example, if a value of `0.5` is set and the slider
+   * [min](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#min) is `0` and [max](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#max) is `2`, then the user will
+   * only be able to update the thumbs to values of 0, 0.5, 1.0, 1.5, and 2.0.
    *
    * @example
    * ```html
-   * <!-- set steps at an interval of 0.5. So the -->
-   * <!-- slider thumb snaps at values of 0.5, 1.0, 1.5, etc. -->
+   * <!-- In this example, the thumb snaps to every value evenly divisible by 0.5 between 0 and 10. -->
    * <arcgis-slider min="0" max="10" steps="0.5" values="5"></arcgis-slider>
    * ```
    * @example
    * ```html
-   * <!-- Set steps at specific slider positions -->
-   * <arcgis-slider min="0" max="100" steps="5, 10, 15, 20, 25, 30, 35, 40" values="15, 30"></arcgis-slider>
+   * <!-- In this example, the thumb snaps to the specified values in the steps array (2, 4, 6, and 8). -->
+   * <arcgis-slider min="0" max="10" steps="2, 4, 6, 8" values="4"></arcgis-slider>
    * ```
    */
   accessor steps: number[] | number | undefined;
@@ -361,7 +364,11 @@ export abstract class ArcgisSlider extends LitElement {
    * @default "start"
    */
   accessor valueLabelsPlacement: "end" | "start";
-  /** An array of numbers representing absolute thumb positions on the slider. */
+  /**
+   * An array of numbers representing absolute thumb positions on the slider. This can be set as comma-separated
+   * numbers in the attribute (e.g., `<arcgis-slider values="10, 20, 30"></arcgis-slider>`) or programmatically as an
+   * array of numbers (e.g., `slider.values = [10, 20, 30]`).
+   */
   accessor values: number[];
   /** Permanently destroys the component. */
   destroy(): Promise<void>;
@@ -398,7 +405,7 @@ export abstract class ArcgisSlider extends LitElement {
    */
   readonly arcgisActiveValueChange: import("@arcgis/lumina").TargetedEvent<this, void>;
   /**
-   * Fires when the thumb or range is released on the component.
+   * Fires when the thumb or range is released on the slider.
    *
    * Use [@arcgisInput](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#event-arcgisInput) for continuous updates during a drag.
    *
@@ -448,7 +455,7 @@ export abstract class ArcgisSlider extends LitElement {
    */
   readonly arcgisInput: import("@arcgis/lumina").TargetedEvent<this, void>;
   /**
-   * Fires when the slider's [min](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#min) and [max](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#max) range changes.
+   * Fires when the slider's range changes.
    * This occurs when the user edits the [min](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#min) or [max](https://developers.arcgis.com/javascript/latest/references/common-components/components/arcgis-slider/#max) range labels (when enabled).
    *
    * @example

package/dist/components/arcgis-spatial-reference-picker/customElement.d.ts

@@ -0,0 +1,327 @@
+/// <reference path="../../index.d.ts" />
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { T9nMeta } from "@arcgis/lumina/controllers";
+
+/** @internal */
+export abstract class ArcgisSpatialReferencePicker extends LitElement {
+  /**
+   * Contains the translations for this component.
+   *
+   * @internal
+   */
+  protected _messages: {
+      "ARC (equal arc-second)": string;
+      Africa: string;
+      Antarctica: string;
+      Argentina: string;
+      Asia: string;
+      "Asteroid Belt": string;
+      "Atlantic Ocean": string;
+      Australia: string;
+      "Australia and New Zealand": string;
+      Austria: string;
+      "BLM (US Feet)": string;
+      Bangladesh: string;
+      "Beijing 1954": string;
+      Bhutan: string;
+      CGCS2000: string;
+      Canada: string;
+      Caribbean: string;
+      "Caribbean Sea": string;
+      "Central America": string;
+      "Central and North America": string;
+      Colombia: string;
+      Continental: string;
+      "County Systems": string;
+      "Democratic Republic of the Congo": string;
+      "EPSG Arctic": string;
+      Earth: string;
+      "Ellipsoidal-based": string;
+      Europe: string;
+      Finland: string;
+      France: string;
+      "GSK 2011": string;
+      "Gauss Kruger": string;
+      "Geographic Coordinate Systems": string;
+      Germany: string;
+      "Gravity-related": string;
+      "Greenwich-based": string;
+      "Highways England": string;
+      Illinois: string;
+      "Indian Ocean": string;
+      "Indian Subcontinent": string;
+      Indiana: string;
+      Indonesia: string;
+      Iowa: string;
+      "Ireland and United Kingdom": string;
+      Italy: string;
+      Japan: string;
+      Jupiter: string;
+      Kansas: string;
+      "Las Vegas": string;
+      Libya: string;
+      Malaysia: string;
+      "Malaysia and Singapore": string;
+      Mars: string;
+      Mercury: string;
+      Meters: string;
+      Minnesota: string;
+      Montana: string;
+      "NAD 1927": string;
+      "NAD 1927 (US Feet)": string;
+      "NAD 1983": string;
+      "NAD 1983 (2011)": string;
+      "NAD 1983 (2011) (Intl Feet)": string;
+      "NAD 1983 (2011) (Meters)": string;
+      "NAD 1983 (2011) (US Feet)": string;
+      "NAD 1983 (CORS96) (Intl Feet)": string;
+      "NAD 1983 (CORS96) (Meters)": string;
+      "NAD 1983 (CORS96) (US Feet)": string;
+      "NAD 1983 (Intl Feet)": string;
+      "NAD 1983 (Meters)": string;
+      "NAD 1983 (PA11) (Meters)": string;
+      "NAD 1983 (PA11) (US Feet)": string;
+      "NAD 1983 (US Feet)": string;
+      "NAD 1983 HARN (Intl Feet)": string;
+      "NAD 1983 HARN (Meters)": string;
+      "NAD 1983 HARN (US Feet)": string;
+      "NAD 1983 NSRS2007 (Intl Feet)": string;
+      "NAD 1983 NSRS2007 (Meters)": string;
+      "NAD 1983 NSRS2007 (US Feet)": string;
+      "National Grids": string;
+      Navajo: string;
+      Neptune: string;
+      "New Beijing": string;
+      "New Zealand": string;
+      "North America": string;
+      "Northern Hemisphere": string;
+      Norway: string;
+      Oceans: string;
+      Oregon: string;
+      "Other GCS": string;
+      "Pacific Ocean": string;
+      Pluto: string;
+      Polar: string;
+      Portugal: string;
+      "Projected Coordinate Systems": string;
+      "Pulkovo 1942": string;
+      "Pulkovo 1995": string;
+      Replaced: string;
+      "SAD 1969": string;
+      SIRGAS: string;
+      "SIRGAS 2000": string;
+      Saturn: string;
+      "Solar System": string;
+      "South Africa": string;
+      "South America": string;
+      "South Korea": string;
+      "Southern Hemisphere": string;
+      "Spheroid-based": string;
+      "State Plane": string;
+      "State Systems": string;
+      Sweden: string;
+      "Switzerland and Liechtenstein": string;
+      Texas: string;
+      Tribal: string;
+      Turkey: string;
+      "US Feet": string;
+      "USA and territories": string;
+      UTM: string;
+      Ukraine: string;
+      "Unknown Height Systems": string;
+      Uranus: string;
+      Venus: string;
+      "Vertical Coordinate Systems": string;
+      Vietnam: string;
+      "WGS 1972": string;
+      "WGS 1984": string;
+      Wisconsin: string;
+      "Wisconsin CRS": string;
+      World: string;
+      "World (Sphere-based)": string;
+      Wyoming: string;
+      "Xian 1980": string;
+      noMatchesFound: string;
+      noResults: string;
+      searchPlaceholder: string;
+  } & T9nMeta<{
+      "ARC (equal arc-second)": string;
+      Africa: string;
+      Antarctica: string;
+      Argentina: string;
+      Asia: string;
+      "Asteroid Belt": string;
+      "Atlantic Ocean": string;
+      Australia: string;
+      "Australia and New Zealand": string;
+      Austria: string;
+      "BLM (US Feet)": string;
+      Bangladesh: string;
+      "Beijing 1954": string;
+      Bhutan: string;
+      CGCS2000: string;
+      Canada: string;
+      Caribbean: string;
+      "Caribbean Sea": string;
+      "Central America": string;
+      "Central and North America": string;
+      Colombia: string;
+      Continental: string;
+      "County Systems": string;
+      "Democratic Republic of the Congo": string;
+      "EPSG Arctic": string;
+      Earth: string;
+      "Ellipsoidal-based": string;
+      Europe: string;
+      Finland: string;
+      France: string;
+      "GSK 2011": string;
+      "Gauss Kruger": string;
+      "Geographic Coordinate Systems": string;
+      Germany: string;
+      "Gravity-related": string;
+      "Greenwich-based": string;
+      "Highways England": string;
+      Illinois: string;
+      "Indian Ocean": string;
+      "Indian Subcontinent": string;
+      Indiana: string;
+      Indonesia: string;
+      Iowa: string;
+      "Ireland and United Kingdom": string;
+      Italy: string;
+      Japan: string;
+      Jupiter: string;
+      Kansas: string;
+      "Las Vegas": string;
+      Libya: string;
+      Malaysia: string;
+      "Malaysia and Singapore": string;
+      Mars: string;
+      Mercury: string;
+      Meters: string;
+      Minnesota: string;
+      Montana: string;
+      "NAD 1927": string;
+      "NAD 1927 (US Feet)": string;
+      "NAD 1983": string;
+      "NAD 1983 (2011)": string;
+      "NAD 1983 (2011) (Intl Feet)": string;
+      "NAD 1983 (2011) (Meters)": string;
+      "NAD 1983 (2011) (US Feet)": string;
+      "NAD 1983 (CORS96) (Intl Feet)": string;
+      "NAD 1983 (CORS96) (Meters)": string;
+      "NAD 1983 (CORS96) (US Feet)": string;
+      "NAD 1983 (Intl Feet)": string;
+      "NAD 1983 (Meters)": string;
+      "NAD 1983 (PA11) (Meters)": string;
+      "NAD 1983 (PA11) (US Feet)": string;
+      "NAD 1983 (US Feet)": string;
+      "NAD 1983 HARN (Intl Feet)": string;
+      "NAD 1983 HARN (Meters)": string;
+      "NAD 1983 HARN (US Feet)": string;
+      "NAD 1983 NSRS2007 (Intl Feet)": string;
+      "NAD 1983 NSRS2007 (Meters)": string;
+      "NAD 1983 NSRS2007 (US Feet)": string;
+      "National Grids": string;
+      Navajo: string;
+      Neptune: string;
+      "New Beijing": string;
+      "New Zealand": string;
+      "North America": string;
+      "Northern Hemisphere": string;
+      Norway: string;
+      Oceans: string;
+      Oregon: string;
+      "Other GCS": string;
+      "Pacific Ocean": string;
+      Pluto: string;
+      Polar: string;
+      Portugal: string;
+      "Projected Coordinate Systems": string;
+      "Pulkovo 1942": string;
+      "Pulkovo 1995": string;
+      Replaced: string;
+      "SAD 1969": string;
+      SIRGAS: string;
+      "SIRGAS 2000": string;
+      Saturn: string;
+      "Solar System": string;
+      "South Africa": string;
+      "South America": string;
+      "South Korea": string;
+      "Southern Hemisphere": string;
+      "Spheroid-based": string;
+      "State Plane": string;
+      "State Systems": string;
+      Sweden: string;
+      "Switzerland and Liechtenstein": string;
+      Texas: string;
+      Tribal: string;
+      Turkey: string;
+      "US Feet": string;
+      "USA and territories": string;
+      UTM: string;
+      Ukraine: string;
+      "Unknown Height Systems": string;
+      Uranus: string;
+      Venus: string;
+      "Vertical Coordinate Systems": string;
+      Vietnam: string;
+      "WGS 1972": string;
+      "WGS 1984": string;
+      Wisconsin: string;
+      "Wisconsin CRS": string;
+      World: string;
+      "World (Sphere-based)": string;
+      Wyoming: string;
+      "Xian 1980": string;
+      noMatchesFound: string;
+      noResults: string;
+      searchPlaceholder: string;
+  }>;
+  /**
+   * When true the arcgis-spatial-reference-picker-tree will be filtered to display the default wkid when the component loads.
+   * The default wkid will also be shown in the search element when this value is true.
+   * Currently MapViewer Analysis UI has the property set to its default value of false, to avoid auto filtering.
+   *
+   * @default false
+   */
+  accessor autoFilterToDefault: boolean;
+  /**
+   * The wkid that will be used as the default when no user selection has been made.
+   * This should be the wkid of the base map or the wkid of the first layer in the map.
+   * If no default is provided, it will fall back to WGS 84 (Web Mercator)
+   *
+   * @default 4326
+   */
+  accessor defaultWkid: number;
+  /**
+   * When true the search input is displayed and users can filter spatial references.
+   *
+   * @default false
+   */
+  accessor filterEnabled: boolean;
+  /**
+   * Categories to hide from the spatial-reference-picker.
+   * The three top-level categories are "Projected Coordinate Systems", "Geographic Coordinate Systems", and "Vertical Coordinate Systems".
+   * Each of these categories has sub-categories that can also be hidden, to see the full list of categories, see the `srCategories` that is imported.
+   *
+   * @example
+   * // Hide the "Projected Coordinate Systems" category
+   * hideCategories: ["Projected Coordinate Systems"]
+   * @example
+   * // Hide the "Projected Coordinate Systems" and "Geographic Coordinate Systems" categories
+   * hideCategories: ["Projected Coordinate Systems", "Geographic Coordinate Systems"]
+   */
+  accessor hideCategories: string[] | undefined;
+  /** The current spatial reference selection as a WKID string */
+  accessor value: { latestWkid?: number; } | undefined;
+  /** @returns the description of the spatial reference */
+  getSRDescription(): Promise<string | undefined>;
+  /** Emitted when the spatial reference selection changes */
+  readonly arcgisChange: import("@arcgis/lumina").TargetedEvent<this, { latestWkid?: number; } | undefined>;
+  readonly "@eventTypes": {
+    arcgisChange: ArcgisSpatialReferencePicker["arcgisChange"]["detail"];
+  };
+}