@arcgis/core 5.0.0-next.66 → 5.0.0-next.67

package/Ground.d.ts

@@ -6,9 +6,9 @@ import type ElevationSampler from "./layers/support/ElevationSampler.js";
 import type { ReadonlyArrayOrCollection } from "./core/Collection.js";
 import type { JSONSupportMixin, JSONSupportMixinProperties } from "./core/JSONSupport.js";
 import type { Loadable, LoadableMixinProperties } from "./core/Loadable.js";
+import type { GroundElevationLayerUnion } from "./layers/types.js";
 import type { ElevationQueryResult, QueryGeometry } from "./layers/support/ElevationQuery.js";
 import type { QueryOptions as ElevationQueryOptions, CreateSamplerOptions } from "./layers/support/ElevationQueryContext.js";
-import type { GroundElevationLayer } from "./layers/support/layerUtils.js";
 import type { ColorLike } from "./Color.js";
 import type { NavigationConstraintProperties } from "./ground/NavigationConstraint.js";
 
@@ -31,7 +31,7 @@ export interface GroundProperties extends LoadableMixinProperties, JSONSupportMi
    * });
    * map.ground.layers.add(layer);
    */
-  layers?: ReadonlyArrayOrCollection<GroundElevationLayer>;
+  layers?: ReadonlyArrayOrCollection<GroundElevationLayerUnion>;
   /**
    * Specifies the user navigation constraints relative to
    * the ground surface.
@@ -120,8 +120,8 @@ export default class Ground extends GroundSuperclass {
    * });
    * map.ground.layers.add(layer);
    */
-  get layers(): Collection<GroundElevationLayer>;
-  set layers(value: ReadonlyArrayOrCollection<GroundElevationLayer>);
+  get layers(): Collection<GroundElevationLayerUnion>;
+  set layers(value: ReadonlyArrayOrCollection<GroundElevationLayerUnion>);
   /**
    * Indicates whether the instance has loaded. When `true`,
    * the properties of the object can be accessed. A Ground is considered loaded

package/Map.d.ts

@@ -6,7 +6,7 @@ import type { BasemapProperties } from "./Basemap.js";
 import type { GroundProperties } from "./Ground.js";
 import type { ReadonlyCollection } from "./core/Collection.js";
 import type { EventedAccessor, EventedMixinProperties } from "./core/Evented.js";
-import type { EditableLayerUnion } from "./layers/support/editableLayers.js";
+import type { EditableLayerUnion } from "./layers/types.js";
 import type { LayersMixin, LayersMixinProperties } from "./support/LayersMixin.js";
 import type { TablesMixin, TablesMixinProperties } from "./support/TablesMixin.js";
 import type { FocusAreasProperties } from "./effects/FocusAreas.js";

package/WebDocument2D.d.ts

@@ -8,7 +8,6 @@ import type ApplicationProperties from "./webmap/ApplicationProperties.js";
 import type Bookmark from "./webmap/Bookmark.js";
 import type InitialViewProperties from "./webmap/InitialViewProperties.js";
 import type { LoadableMixin, LoadableMixinProperties } from "./core/Loadable.js";
-import type { MultiOriginJSONMixin, MultiOriginJSONMixinProperties } from "./core/MultiOriginJSONSupport.js";
 import type { EsriPromiseMixin, EsriPromiseMixinProperties } from "./core/Promise.js";
 import type { AbortOptions } from "./core/promiseUtils.js";
 import type { PortalItemProperties } from "./portal/PortalItem.js";
@@ -22,7 +21,7 @@ import type { InitialViewPropertiesProperties } from "./webmap/InitialViewProper
 import type { WidgetsProperties } from "./webdoc/Widgets.js";
 import type { MapProperties as EsriMapProperties } from "./Map.js";
 
-export interface WebDocument2DProperties extends EsriMapProperties, EsriPromiseMixinProperties, LoadableMixinProperties, MultiOriginJSONMixinProperties, Partial<Pick<WebDocument2D, "authoringApp" | "authoringAppVersion" | "thumbnailUrl">> {
+export interface WebDocument2DProperties extends EsriMapProperties, EsriPromiseMixinProperties, LoadableMixinProperties, Partial<Pick<WebDocument2D, "authoringApp" | "authoringAppVersion" | "thumbnailUrl">> {
   /**
    * The applicationProperties contains the viewing properties of the WebMap.
    *
@@ -400,4 +399,4 @@ export default abstract class WebDocument2D extends WebDocument2DSuperclass {
    */
   updateFrom(view: MapView, options?: UpdateFromOptions): Promise<void>;
 }
-declare const WebDocument2DSuperclass: typeof EsriMap & typeof EsriPromiseMixin & typeof LoadableMixin & typeof MultiOriginJSONMixin
+declare const WebDocument2DSuperclass: typeof EsriMap & typeof EsriPromiseMixin & typeof LoadableMixin

package/WebScene.d.ts

@@ -12,7 +12,6 @@ import type Presentation from "./webscene/Presentation.js";
 import type Version from "./webscene/Version.js";
 import type { MapProperties } from "./Map.js";
 import type { LoadableMixin, LoadableMixinProperties } from "./core/Loadable.js";
-import type { MultiOriginJSONMixin, MultiOriginJSONMixinProperties } from "./core/MultiOriginJSONSupport.js";
 import type { EsriPromiseMixin, EsriPromiseMixinProperties } from "./core/Promise.js";
 import type { AbortOptions } from "./core/promiseUtils.js";
 import type { PortalItemProperties } from "./portal/PortalItem.js";
@@ -25,7 +24,7 @@ import type { PresentationProperties } from "./webscene/Presentation.js";
 import type { InitialViewPropertiesProperties } from "./webscene/InitialViewProperties.js";
 import type { WidgetsProperties } from "./webdoc/Widgets.js";
 
-export interface WebSceneProperties extends MapProperties, MultiOriginJSONMixinProperties, EsriPromiseMixinProperties, LoadableMixinProperties, Partial<Pick<WebScene, "authoringApp" | "authoringAppVersion" | "clippingEnabled" | "thumbnailUrl">> {
+export interface WebSceneProperties extends MapProperties, EsriPromiseMixinProperties, LoadableMixinProperties, Partial<Pick<WebScene, "authoringApp" | "authoringAppVersion" | "clippingEnabled" | "thumbnailUrl">> {
   /**
    * Configuration of application and UI elements.
    *
@@ -642,7 +641,7 @@ export default class WebScene extends WebSceneSuperclass {
    */
   updateThumbnail(view: SceneView, options?: WebSceneUpdateThumbnailOptions): Promise<void>;
 }
-declare const WebSceneSuperclass: typeof Map & typeof MultiOriginJSONMixin & typeof EsriPromiseMixin & typeof LoadableMixin
+declare const WebSceneSuperclass: typeof Map & typeof EsriPromiseMixin & typeof LoadableMixin
 
 export interface SaveOptions {
   /**

package/applications/Components/QuantityFormatter.d.ts

@@ -2,12 +2,16 @@ import type Accessor from "../../core/Accessor.js";
 import type { Area, Length, RotationType, Volume } from "../../core/quantity.js";
 import type { AngleUnit } from "../../core/units.js";
 
-/** @internal */
+/**
+ * @experimental
+ * @internal
+ */
 export interface QuantityFormatterProperties {}
 
 /**
  * The format to use for the quantity.
  *
+ * @experimental
  * @internal
  */
 export type FormattingStyle = "singular" | "plural" | "abbr";
@@ -16,9 +20,11 @@ export type FormattingStyle = "singular" | "plural" | "abbr";
  * Class which has methods to format quantities like lengths and areas. To be used in components until we have a public
  * API for unit conversion and formatting.
  *
+ * @experimental
  * @internal
  */
 export default class QuantityFormatter extends Accessor {
+  /** @experimental */
   constructor(properties?: QuantityFormatterProperties);
   /**
    * Formats an angle quantity to degrees. Absolute angles are always formatted in the domain [0, 360).
@@ -29,6 +35,7 @@ export default class QuantityFormatter extends Accessor {
    * @param preferredType - The preferred type of the resulting formatted angle.
    * @param precision - Precision to be used when formatting values.
    * @returns The formatted angle.
+   * @experimental
    */
   formatAngleDegrees(angle: number, unit: AngleUnit, rotationType: RotationType, preferredType: RotationType, precision?: number | null | undefined): string;
   /**
@@ -38,6 +45,7 @@ export default class QuantityFormatter extends Accessor {
    * @param precision - The number of decimal places to include in the formatted string.
    * @param format - The format to use for the quantity.
    * @returns The formatted quantity.
+   * @experimental
    */
   formatArea(quantity: Area, precision?: number, format?: FormattingStyle): string;
   /**
@@ -47,6 +55,7 @@ export default class QuantityFormatter extends Accessor {
    * @param precision - The number of decimal places to include in the formatted string.
    * @param format - The format to use for the quantity.
    * @returns The formatted quantity.
+   * @experimental
    */
   formatDecimal(quantity: Length | Area, precision?: number, format?: FormattingStyle): string;
   /**
@@ -56,6 +65,7 @@ export default class QuantityFormatter extends Accessor {
    * @param precision - The number of decimal places to include in the formatted string.
    * @param format - The format to use for the quantity.
    * @returns The formatted length quantity.
+   * @experimental
    */
   formatLength(quantity: Length, precision?: number, format?: FormattingStyle): string;
   /**
@@ -65,6 +75,7 @@ export default class QuantityFormatter extends Accessor {
    * @param precision - The number of decimal places to include in the formatted string.
    * @param format - The format to use for the quantity.
    * @returns The formatted quantity.
+   * @experimental
    */
   formatVerticalLength(quantity: Length, precision?: number, format?: FormattingStyle): string;
   /**
@@ -74,12 +85,14 @@ export default class QuantityFormatter extends Accessor {
    * @param precision - The number of decimal places to include in the formatted string.
    * @param format - The format to use for the quantity.
    * @returns The formatted quantity.
+   * @experimental
    */
   formatVolume(quantity: Volume, precision?: number, format?: FormattingStyle): string;
   /**
    * Returns a promise that resolves when the messages are loaded.
    *
    * @returns A promise that resolves when the messages are loaded.
+   * @experimental
    */
   when(): Promise<void>;
 }

package/applications/Components/SelectionOperation.d.ts

@@ -1,28 +1,63 @@
 /**
  * Utilities for creating a SelectionOperation class instance.
  *
+ * @experimental
  * @internal
  */
 import type { MapViewOrSceneView } from "../../views/MapViewOrSceneView.js";
 
-/** @internal */
+/**
+ * @experimental
+ * @internal
+ */
 export type SelectionOperationType = "add" | "remove" | "replace";
 
-/** @internal */
+/**
+ * @experimental
+ * @internal
+ */
 export interface OperationOptions {
-  /** The tool to create ("point", "polygon", "circle", or "rectangle"). Defaults to "rectangle" if not specified. */
+  /**
+   * The tool to create ("point", "polygon", "circle", or "rectangle"). Defaults to "rectangle" if not specified.
+   *
+   * @experimental
+   */
   createTool?: "point" | "polygon" | "circle" | "rectangle";
-  /** The operation mode ("click", "freehand", or "hybrid"). */
+  /**
+   * The operation mode ("click", "freehand", or "hybrid").
+   *
+   * @experimental
+   */
   mode?: "click" | "freehand" | "hybrid";
-  /** An optional, unique name used to distinguish an operation. */
+  /**
+   * An optional, unique name used to distinguish an operation.
+   *
+   * @experimental
+   */
   name?: "rectangle" | "lasso" | "point" | string;
-  /** Whether the final selection should update the current selection manager. */
+  /**
+   * Whether the final selection should update the current selection manager.
+   *
+   * @experimental
+   */
   persistSelection?: boolean;
-  /** Whether the selected graphics should include geometries. Defaults to true if not specified. */
+  /**
+   * Whether the selected graphics should include geometries. Defaults to true if not specified.
+   *
+   * @experimental
+   */
   returnGeometry?: boolean;
-  /** Whether to select on complete. Defaults to true if not specified. */
+  /**
+   * Whether to select on complete. Defaults to true if not specified.
+   *
+   * @experimental
+   */
   selectOnComplete?: boolean;
-  /** The type of selection operation ("add", "remove" or "replace"). Defaults to "add" if not specified. */
+  /**
+   * The type of selection operation ("add", "remove" or "replace"). Defaults to "add" if not specified.
+   *
+   * @experimental
+   */
   type?: SelectionOperationType;
 }
 
@@ -33,6 +68,7 @@ export interface OperationOptions {
  * @param sources - An array of source layers.
  * @param options - Additional tool- and selection-related options for the SelectionOperation.
  * @returns The created SelectionOperation instance.
+ * @experimental
  * @internal
  */
 export function createSelectionOperation(view: MapViewOrSceneView, sources: any[] | null | undefined, options?: OperationOptions): any;

package/applications/Components/SketchTooltipControls.d.ts

@@ -1,23 +1,47 @@
 /**
  * Utilites for creating a SketchTooltipControls class instance.
  *
+ * @experimental
  * @internal
  */
 
-/** @internal */
+/**
+ * @experimental
+ * @internal
+ */
 export interface VisibleElements {
-  /** Whether the direction mode picker is visible. */
+  /**
+   * Whether the direction mode picker is visible.
+   *
+   * @experimental
+   */
   directionModePicker?: boolean;
-  /** Whether the header is visible. */
+  /**
+   * Whether the header is visible.
+   *
+   * @experimental
+   */
   header?: boolean;
-  /** Whether the labels toggle is visible. */
+  /**
+   * Whether the labels toggle is visible.
+   *
+   * @experimental
+   */
   labelsToggle?: boolean;
-  /** Whether the tooltips toggle is visible. */
+  /**
+   * Whether the tooltips toggle is visible.
+   *
+   * @experimental
+   */
   tooltipsToggle?: boolean;
 }
 
-/** @internal */
+/**
+ * @experimental
+ * @internal
+ */
 export interface SketchTooltipControlsInterface {
+  /** @experimental */
   destroy(): void;
 }
 
@@ -27,6 +51,7 @@ export interface SketchTooltipControlsInterface {
  * @param visibleElements - Determines which elements are visible, such as labels or tooltips.
  * @param sketchOptions - Determines which sketch options to show, such as labels or tooltips.
  * @returns The created SketchTooltipControls instance.
+ * @experimental
  * @internal
  */
 export function createSketchTooltipControls(visibleElements: VisibleElements, sketchOptions: any): SketchTooltipControlsInterface;

package/applications/Components/actionUtils.d.ts

@@ -13,6 +13,7 @@ import type SceneView from "../../views/SceneView.js";
  * @param graphic - The graphic feature to check.
  * @param view - The view associated with the popup.
  * @returns True if the screen size is suitable for zoom actions, otherwise false.
+ * @experimental
  * @internal
  */
 export function isZoomScreenSize(graphic: Graphic | null | undefined, view: MapView | SceneView | null | undefined): Promise<boolean>;

package/applications/Components/analysisUtils.d.ts

@@ -17,10 +17,10 @@ import type { AnalysisViewUnion } from "../../views/analysis/types.js";
 /**
  * Forces the analysis view to be interactive until the returned handle is removed.
  *
- * @deprecated
  * @param analysisView - The analysis view whose `interactive` property is to be forced to `true`.
  * @returns A handle which, when removed, will restore the analysis view to its
  * original interactive state.
+ * @experimental
  * @internal
  */
 export function forceInteractive(analysisView: AnalysisViewUnion): ResourceHandle;
@@ -28,9 +28,9 @@ export function forceInteractive(analysisView: AnalysisViewUnion): ResourceHandl
 /**
  * Gets whether the specified length is above the geodesic distance threshold.
  *
- * @deprecated
  * @param length - The length to check.
  * @returns `true` if the specified length is geodesic, `false` otherwise.
+ * @experimental
  * @internal
  */
 export function isAboveGeodesicDistanceThreshold(length: Length): boolean;
@@ -39,9 +39,9 @@ export function isAboveGeodesicDistanceThreshold(length: Length): boolean;
  * Gets whether the specified analysis view contains a valid result. The result is valid if there are no intersecting
  * segments on the geometry.
  *
- * @deprecated
  * @param analysisView - The analysis view to check.
  * @returns `true` if the analysis view contains a valid result, `false` otherwise.
+ * @experimental
  * @internal
  */
 export function hasValidAreaResult(analysisView: AreaMeasurementAnalysisView3D): boolean;
@@ -49,8 +49,8 @@ export function hasValidAreaResult(analysisView: AreaMeasurementAnalysisView3D):
 /**
  * Sets the elevation profile to a test configuration which removes timeouts, throtting, etc to make tests faster.
  *
- * @deprecated
  * @returns A watch handle.
+ * @experimental
  * @internal
  */
 export function setElevationProfileTestConfig(): ResourceHandle;
@@ -58,38 +58,82 @@ export function setElevationProfileTestConfig(): ResourceHandle;
 /**
  * An elevation profile chart.
  *
- * @deprecated
+ * @experimental
  * @internal
  */
 export interface InternalElevationProfileChart {
-  /** The ElevationProfileAnalysisView2D or ElevationProfileAnalysisView3D associated with the chart. */
+  /**
+   * The ElevationProfileAnalysisView2D or ElevationProfileAnalysisView3D associated with the chart.
+   *
+   * @experimental
+   */
   analysisView?: ElevationProfileAnalysisView2D | ElevationProfileAnalysisView3D | null;
-  /** Indicates whether the chart should be shown. */
+  /**
+   * Indicates whether the chart should be shown.
+   *
+   * @experimental
+   */
   chartVisible: boolean;
-  /** Destroys the chart and releases resources. */
+  /**
+   * Destroys the chart and releases resources.
+   *
+   * @experimental
+   */
   destroy: () => void;
-  /** The messages used in the chart. */
+  /**
+   * The messages used in the chart.
+   *
+   * @experimental
+   */
   messages?: object | null;
-  /** Indicates whether the loading spinner should be shown. */
+  /**
+   * Indicates whether the loading spinner should be shown.
+   *
+   * @experimental
+   */
   spinnerVisible: boolean;
-  /** Testing utilities (only available when the `esri-tests` build flag is set to `true`). */
+  /**
+   * Testing utilities (only available when the `esri-tests` build flag is set to `true`).
+   *
+   * @experimental
+   */
   test?: InternalElevationProfileChartTest;
-  /** Indicates whether uniform scaling is enabled for the chart axes. */
+  /**
+   * Indicates whether uniform scaling is enabled for the chart axes.
+   *
+   * @experimental
+   */
   uniformScaling: boolean;
-  /** The MapView or SceneView associated with the chart. */
+  /**
+   * The MapView or SceneView associated with the chart.
+   *
+   * @experimental
+   */
   view?: MapView | SceneView | null;
-  /** Zooms out the chart to show the full range of data. */
+  /**
+   * Zooms out the chart to show the full range of data.
+   *
+   * @experimental
+   */
   zoomOut: () => void;
 }
 
 /**
- * @deprecated
+ * @experimental
  * @internal
  */
 export interface InternalElevationProfileChartTest {
-  /** Shows the chart tooltip at the specified coordinates. */
+  /**
+   * Shows the chart tooltip at the specified coordinates.
+   *
+   * @experimental
+   */
   forceShowTooltipAt: (x: number, y: number) => Promise<void>;
-  /** Returns a promise that resolves when the chart is fully ready. */
+  /**
+   * Returns a promise that resolves when the chart is fully ready.
+   *
+   * @experimental
+   */
   whenReady: () => Promise<void>;
 }
 
@@ -97,30 +141,58 @@ export interface InternalElevationProfileChartTest {
  * Factory method for lazy-loading and creating an elevation profile chart until we're able to fully use amCharts in
  * map-components along with the other things like unit and localization utilities.
  *
- * @deprecated
  * @param parameters
  * @returns The created chart instance.
+ * @experimental
  * @internal
  */
 export function createChart(parameters: InternalCreateChartParameters): Promise<InternalElevationProfileChart>;
 
 /**
- * @deprecated
+ * @experimental
  * @internal
  */
 export interface InternalCreateChartParameters extends AbortOptions {
-  /** The analysis view to associate with the chart. */
+  /**
+   * The analysis view to associate with the chart.
+   *
+   * @experimental
+   */
   analysisView?: ElevationProfileAnalysisView2D | ElevationProfileAnalysisView3D | null;
-  /** The container element in which to render the chart. */
+  /**
+   * The container element in which to render the chart.
+   *
+   * @experimental
+   */
   container: HTMLElement;
-  /** Messages to display in the chart. */
+  /**
+   * Messages to display in the chart.
+   *
+   * @experimental
+   */
   messages?: object | null;
-  /** Called when the cursor position changes on the chart. */
+  /**
+   * Called when the cursor position changes on the chart.
+   *
+   * @experimental
+   */
   onCursorPositionChange?: null | ((x: number | null | undefined, y: number | null | undefined) => void);
-  /** Called when the chart's range changes. */
+  /**
+   * Called when the chart's range changes.
+   *
+   * @experimental
+   */
   onRangeChange?: null | ((zoomFactorX: number, zoomFactorY: number) => void);
-  /** Whether to use uniform scaling for the chart axes. */
+  /**
+   * Whether to use uniform scaling for the chart axes.
+   *
+   * @experimental
+   */
   uniformScaling?: boolean | null;
-  /** The MapView or SceneView instance associated with the chart. */
+  /**
+   * The MapView or SceneView instance associated with the chart.
+   *
+   * @experimental
+   */
   view?: MapViewOrSceneView | null;
 }

package/applications/Components/arcadeEditorUtils.d.ts

@@ -1,6 +1,7 @@
 /**
  * Arcade editor utils for Components.
  *
+ * @experimental
  * @internal
  */
 import type ImageryLayer from "../../layers/ImageryLayer.js";
@@ -13,6 +14,7 @@ import type { Variable } from "../../arcade.js";
  *
  * @param layer - The layer a pixel will come from.
  * @returns The declared members as arcade variables.
+ * @experimental
  * @internal
  */
 export function getDeclaredPixelMembers(layer: ImageryLayer | ImageryTileLayer): Promise<Variable[]>;
@@ -22,6 +24,7 @@ export function getDeclaredPixelMembers(layer: ImageryLayer | ImageryTileLayer):
  *
  * @param layer - The layer a voxel will come from.
  * @returns The declared members as arcade variables.
+ * @experimental
  * @internal
  */
 export function getDeclaredVoxelMembers(layer: VoxelLayer): Promise<Variable[]>;

package/applications/Components/arcadeFeatureUtils.d.ts

@@ -1,6 +1,7 @@
 /**
  * Arcade feature utils for Components.
  *
+ * @experimental
  * @internal
  */
 import type Graphic from "../../Graphic.js";
@@ -14,15 +15,27 @@ import type { MapViewOrSceneView } from "../../views/MapViewOrSceneView.js";
  *
  * @param parameters - The parameters for compilation.
  * @returns The compiled expression info or null.
+ * @experimental
  * @internal
  */
 export function compileExpression(parameters: CompileExpressionParameters): Promise<any | null>;
 
-/** @internal */
+/**
+ * @experimental
+ * @internal
+ */
 export interface CompileExpressionParameters {
-  /** The Arcade expression. */
+  /**
+   * The Arcade expression.
+   *
+   * @experimental
+   */
   expression: string;
-  /** The graphic to use for context. */
+  /**
+   * The graphic to use for context.
+   *
+   * @experimental
+   */
   graphic: Graphic;
 }
 
@@ -32,6 +45,7 @@ export interface CompileExpressionParameters {
  * @param expressionInfos - Array of Arcade expression info objects.
  * @param graphic - The graphic to use for context.
  * @returns The compiled expression infos.
+ * @experimental
  * @internal
  */
 export function compileExpressionInfos(expressionInfos: ExpressionInfo[], graphic: Graphic): Promise<any>;
@@ -41,22 +55,36 @@ export function compileExpressionInfos(expressionInfos: ExpressionInfo[], graphi
  *
  * @param value - The value to format.
  * @returns The formatted value.
+ * @experimental
  * @internal
  */
 export function formatArcadeValue(value: string): string;
 
-/** @internal */
+/**
+ * @experimental
+ * @internal
+ */
 export interface ImageryPopupProfileParameters {
-  /** Popup graphic with imagery or imagery-tile layer origin. */
+  /**
+   * Popup graphic with imagery or imagery-tile layer origin.
+   *
+   * @experimental
+   */
   graphic: Graphic;
-  /** $userInput point */
+  /**
+   * $userInput point
+   *
+   * @experimental
+   */
   location?: Point | null;
+  /** @experimental */
   view?: MapViewOrSceneView | null;
 }
 
 /**
  * @param parameters
  * @returns profile variable instances for executing an arcade `popup-imagery` or `popup-element-imagery` expression
+ * @experimental
  * @internal
  */
 export function prepareImageryPopupProfileVariableInstances(parameters: ImageryPopupProfileParameters): ProfileVariableInstances;