@arcgis/core 5.2.0-next.144 → 5.2.0-next.145

package/views/interactive/options/ViewOptions.d.ts

@@ -16,6 +16,10 @@ export interface ViewOptionsProperties {
   /**
    * Units for displaying measurements, such as lengths, areas, and volumes.
    *
+   * Each unit can be configured independently. Unset units use the defaults of the component, view model, or analysis.
+   * A display unit set directly on a component, view model, or analysis overrides the corresponding unit on the view,
+   * without changing the view's options or the units used by other components, view models, or analyses.
+   *
    * @since 5.2
    */
   displayUnits?: UnitsProperties;
@@ -23,6 +27,10 @@ export interface ViewOptionsProperties {
    * Units for interpreting numeric values entered by the user.
    *
    * Input units may differ from [displayUnits](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits).
+   * Each unit can be configured independently. Unset units use the defaults of the component, view model, or analysis.
+   * An input unit set directly on a component, view model, or analysis overrides the corresponding unit on the view,
+   * without changing the view's options or the units used by other components, view models, or analyses.
+   * These options control numeric input in the UI, not the spatial reference or stored coordinates of a geometry.
    *
    * @since 5.2
    */
@@ -39,7 +47,7 @@ export interface ViewOptionsProperties {
    * >
    * > These options currently do not apply to [AreaMeasurementAnalysisView2D](https://developers.arcgis.com/javascript/latest/references/core/views/2d/analysis/AreaMeasurementAnalysisView2D/) or
    * > [DistanceMeasurementAnalysisView2D](https://developers.arcgis.com/javascript/latest/references/core/views/2d/analysis/DistanceMeasurementAnalysisView2D/), including their measurement components.
-   * > Configure `snappingOptions` on the analysis view or component instead. Tooltip and unit settings configured through
+   * > Configure `snappingOptions` on the analysis view or component instead. Tooltip and unit options configured through
    * > `view.options` still apply. Support for `view.options.snapping` in these analyses and components is planned for a future release.
    *
    * @since 5.2
@@ -48,7 +56,15 @@ export interface ViewOptionsProperties {
   /**
    * Options for tooltips shown while sketching, editing, or placing analyses.
    *
-   * Tooltips are disabled by default.
+   * Tooltips are disabled by default in both [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) and [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
+   *
+   * > [!WARNING]
+   * >
+   * > **Known Limitations**
+   * >
+   * > The [Volume Measurement](https://developers.arcgis.com/javascript/latest/references/core/analysis/VolumeMeasurementAnalysis/) cut-fill elevation tooltip remains enabled
+   * > independently of these options. Its display and input units can still inherit
+   * > [ViewOptions.displayUnits](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits) and [ViewOptions.inputUnits](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#inputUnits).
    *
    * @since 5.2
    */
@@ -56,13 +72,56 @@ export interface ViewOptionsProperties {
 }
 
 /**
- * Stores snapping, tooltip, and measurement unit options for supported components and analyses configured to inherit these options from the view.
- * Configure these options through [View.options](https://developers.arcgis.com/javascript/latest/references/core/views/View/#options).
+ * Configures snapping, tooltips, display units, and input units for supported components, view models, and analyses through [View.options](https://developers.arcgis.com/javascript/latest/references/core/views/View/#options).
+ *
+ * Unlike inherited snapping and tooltip options, display and input units can be overridden individually through
+ * unit properties exposed by a component, view model, or analysis.
+ * For example, setting [DistanceMeasurementAnalysis.unit](https://developers.arcgis.com/javascript/latest/references/core/analysis/DistanceMeasurementAnalysis/#unit) to `feet` overrides
+ * [view.options.displayUnits.length](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/support/Units/#length) for that analysis without changing the view's configuration or other analyses.
+ * Setting the analysis unit back to `null` restores the unit configured through `view.options.displayUnits.length`.
  *
  * > [!IMPORTANT]
  * >
  * > These options are not saved in a [WebMap](https://developers.arcgis.com/javascript/latest/references/core/WebMap/) or [WebScene](https://developers.arcgis.com/javascript/latest/references/core/WebScene/).
  *
+ * The following table shows which components, view models, and analyses inherit each option from `view.options`.
+ *
+ * - **✓**: The option is inherited, with explicit component, view model, or analysis **units** taking precedence as described above.
+ * - `Opt-in`: The option is inherited only when the component's or view model's `useViewOptions` property is `true`.
+ * - ✗: The capability exists but does not inherit the option from the view. See the corresponding footnote.
+ * - `N/A`: The capability is unavailable for that component or analysis (for example, Area Measurement 3D does not support tooltips at all).
+ *
+ * | Component or analysis | Inherits `view.options.snapping` | Inherits `view.options.tooltips` | Inherits `view.options.displayUnits` | Inherits `view.options.inputUnits` |
+ * | --- | :---: | :---: | :---: | :---: |
+ * | Area Measurement 2D | ✗¹ | **✓** | **✓** | **✓** |
+ * | Area Measurement 3D | **✓** | N/A | **✓** | N/A |
+ * | Distance Measurement 2D | ✗¹ | **✓** | **✓** | **✓** |
+ * | Direct Line Measurement 3D | **✓** | N/A | **✓** | N/A |
+ * | Elevation Profile | **✓** | N/A | **✓** | N/A |
+ * | Line of Sight | **✓** | **✓** | **✓** | **✓** |
+ * | Viewshed | **✓** | **✓** | **✓** | **✓** |
+ * | Length Dimension | **✓** | N/A | **✓** | N/A |
+ * | Volume Measurement | **✓** | ✗² | **✓** | **✓** |
+ * | Sketch | Opt-in³ | Opt-in³ | Opt-in³ | Opt-in³ |
+ * | Editor | Opt-in³ | Opt-in³ | Opt-in³ | Opt-in³ |
+ *
+ * 1. For 2D measurements, configure snapping through the component's own `snappingOptions`,
+ *    [AreaMeasurementAnalysisView2D.snappingOptions](https://developers.arcgis.com/javascript/latest/references/core/views/2d/analysis/AreaMeasurementAnalysisView2D/#snappingOptions), or
+ *    [DistanceMeasurementAnalysisView2D.snappingOptions](https://developers.arcgis.com/javascript/latest/references/core/views/2d/analysis/DistanceMeasurementAnalysisView2D/#snappingOptions).
+ *    Support for `view.options.snapping` is planned for a future release.
+ * 2. The Volume Measurement cut-fill elevation tooltip remains enabled independently of
+ *    `view.options.tooltips`.
+ * 3. For Sketch and Editor, including [SketchViewModel](https://developers.arcgis.com/javascript/latest/references/core/widgets/Sketch/SketchViewModel/) and [EditorViewModel](https://developers.arcgis.com/javascript/latest/references/core/widgets/Editor/EditorViewModel/),
+ *    set the component's or view model's `useViewOptions` property to `true` (default: `false`) to use options on the view.
+ *    Changes to this property apply to the next create or update operation, not an operation already in progress.
+ *
+ *    When this property is `true`:
+ *
+ *    - Snapping and tooltip options specified on the component or view model are preserved but ignored.
+ *    - The corresponding controls in the component's Settings menu are hidden.
+ *    - Where unit properties are exposed, explicit units override those configured through `view.options` per measurement type.
+ *    - Set an explicit unit to `null` or `undefined` to use the unit from `view.options` for that measurement type again.
+ *
  * @beta
  * @since 5.2
  */
@@ -72,6 +131,10 @@ export default class ViewOptions extends Accessor {
   /**
    * Units for displaying measurements, such as lengths, areas, and volumes.
    *
+   * Each unit can be configured independently. Unset units use the defaults of the component, view model, or analysis.
+   * A display unit set directly on a component, view model, or analysis overrides the corresponding unit on the view,
+   * without changing the view's options or the units used by other components, view models, or analyses.
+   *
    * @since 5.2
    */
   get displayUnits(): Units;
@@ -80,6 +143,10 @@ export default class ViewOptions extends Accessor {
    * Units for interpreting numeric values entered by the user.
    *
    * Input units may differ from [displayUnits](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits).
+   * Each unit can be configured independently. Unset units use the defaults of the component, view model, or analysis.
+   * An input unit set directly on a component, view model, or analysis overrides the corresponding unit on the view,
+   * without changing the view's options or the units used by other components, view models, or analyses.
+   * These options control numeric input in the UI, not the spatial reference or stored coordinates of a geometry.
    *
    * @since 5.2
    */
@@ -97,7 +164,7 @@ export default class ViewOptions extends Accessor {
    * >
    * > These options currently do not apply to [AreaMeasurementAnalysisView2D](https://developers.arcgis.com/javascript/latest/references/core/views/2d/analysis/AreaMeasurementAnalysisView2D/) or
    * > [DistanceMeasurementAnalysisView2D](https://developers.arcgis.com/javascript/latest/references/core/views/2d/analysis/DistanceMeasurementAnalysisView2D/), including their measurement components.
-   * > Configure `snappingOptions` on the analysis view or component instead. Tooltip and unit settings configured through
+   * > Configure `snappingOptions` on the analysis view or component instead. Tooltip and unit options configured through
    * > `view.options` still apply. Support for `view.options.snapping` in these analyses and components is planned for a future release.
    *
    * @since 5.2
@@ -107,7 +174,15 @@ export default class ViewOptions extends Accessor {
   /**
    * Options for tooltips shown while sketching, editing, or placing analyses.
    *
-   * Tooltips are disabled by default.
+   * Tooltips are disabled by default in both [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) and [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
+   *
+   * > [!WARNING]
+   * >
+   * > **Known Limitations**
+   * >
+   * > The [Volume Measurement](https://developers.arcgis.com/javascript/latest/references/core/analysis/VolumeMeasurementAnalysis/) cut-fill elevation tooltip remains enabled
+   * > independently of these options. Its display and input units can still inherit
+   * > [ViewOptions.displayUnits](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits) and [ViewOptions.inputUnits](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#inputUnits).
    *
    * @since 5.2
    */

package/widgets/BasemapGallery/BasemapGalleryViewModel.d.ts

@@ -11,7 +11,7 @@ import type { MapViewOrSceneView } from "../../views/MapViewOrSceneView.js";
 import type { LocalBasemapsSourceProperties } from "./support/LocalBasemapsSource.js";
 import type { PortalBasemapsSourceProperties } from "./support/PortalBasemapsSource.js";
 
-/** @deprecated since version 5.2. Use [BasemapCollectionProperties](https://developers.arcgis.com/javascript/latest/references/core/basemaps/BasemapCollection/#BasemapCollectionProperties) instead. */
+/** @deprecated since version 5.2. Use [BasemapGalleryModelProperties](https://developers.arcgis.com/javascript/latest/references/core/basemapGallery/BasemapGalleryModel/#BasemapGalleryModelProperties) instead. */
 export interface BasemapGalleryViewModelProperties extends LoadableMixinProperties, Partial<Pick<BasemapGalleryViewModel, "view">> {
   /** The map's [Map.basemap](https://developers.arcgis.com/javascript/latest/references/core/Map/#basemap). */
   activeBasemap?: BasemapProperties | string | null;
@@ -31,7 +31,7 @@ export type BasemapGalleryViewModelState = "disabled" | "loading" | "ready" | "u
 /**
  * Provides the logic for the [BasemapGallery widget](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/) and [component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-gallery/).
  *
- * @deprecated since version 5.2. Use [BasemapCollection](https://developers.arcgis.com/javascript/latest/references/core/basemaps/BasemapCollection/) instead.
+ * @deprecated since version 5.2. Use [BasemapGalleryModel](https://developers.arcgis.com/javascript/latest/references/core/basemapGallery/BasemapGalleryModel/) instead.
  * @since 4.3
  * @see [BasemapGallery widget](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/) - _Deprecated since 4.32. Use the [Basemap Gallery component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-basemap-gallery/) instead._
  * @see [Programming patterns: Widget viewModel pattern](https://developers.arcgis.com/javascript/latest/programming-patterns/#widget-viewmodel-pattern)

package/widgets/BasemapGallery/BasemapGalleryViewModel.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import t from"../../core/Collection.js";import{deprecatedModule as n}from"../../core/deprecate.js";import{Loadable as r,isLoadable as i}from"../../core/Loadable.js";import a from"../../core/Logger.js";import{watch as o,on as s,when as c}from"../../core/reactiveUtils.js";import{property as l,subclass as u}from"../../core/accessorSupport/decorators.js";import{canProjectWithoutEngine as d,isLoaded as f,load as p}from"../../geometry/projectionUtils.js";import{equals as m}from"../../geometry/support/spatialReferenceUtils.js";import{isLinkChartView as h}from"../../linkChart/guards.js";import{basemapEnsureType as g}from"../../support/basemapEnsureType.js";import{contentEquals as _}from"../../support/basemapUtils.js";import{default3DCompatibility as v,default2DCompatibility as y}from"./support/basemapCompatibilityUtils.js";import b from"./support/BasemapGalleryItem.js";import x from"./support/LocalBasemapsSource.js";import S from"./support/PortalBasemapsSource.js";const C=t.ofType(b);function w(e){return e&&e.declaredClass===`esri.portal.Portal`}function T(e){return e&&!(e instanceof S)&&(!!e.portal||!!e.query)}function E(e){return e&&`basemaps`in e&&`state`in e&&`refresh`in e}let D=class extends r{constructor(e){super(e),this._loadingProjectionEngine=!1,this.items=new C,this.view=null,e?.suppressDeprecationWarning||n(a.getLogger(this),`esri.widgets.BasemapGallery.BasemapGalleryViewModel`,{version:`5.2`,replacement:`Use the @arcgis/core/basemaps/BasemapCollection class instead.`,warnOnce:!0}),this.source=new S}normalizeCtorArgs(e={}){let{suppressDeprecationWarning:t,...n}=e;return n}initialize(){let e=()=>this._recreateItems();this.addHandles([o(()=>this.state===`ready`?this.compatibilityFunction:null,()=>this._updateItems()),s(()=>this.source?.basemaps,`change`,e,{onListenerAdd:e}),c(()=>this.view,()=>{this.source instanceof S&&(this.source.viewType=this.view?.type)},{once:!0})])}destroy(){let e=this.source.basemaps.find(e=>e===this.activeBasemap);e&&this.source.basemaps.remove(e),this.source?.destroy()}get activeBasemap(){return this.view?.map?.basemap??null}set activeBasemap(e){let t=this.view;if(!t?.map)return;if(e=g(e),!e||!t.ready){t.map.basemap=e,this._clearOverride(`activeBasemap`);return}let n=e.spatialReference||this.items?.find(t=>this.basemapEquals(e,t.basemap))?.spatialReference;if(n&&`spatialReferenceLocked`in t&&!t.spatialReferenceLocked){let r=t.spatialReference;if(n!=null&&!m(r,n)&&!d(t.spatialReference,n)&&!f()){this._override(`activeBasemap`,e),this._loadingProjectionEngine=!0,p().then(()=>{this._get(`activeBasemap`)===e&&(t.map.basemap=e,t.spatialReference=n,this._clearOverride(`activeBasemap`))},()=>{}).then(()=>{this._loadingProjectionEngine=!1});return}t.map.basemap=e,this._clearOverride(`activeBasemap`),n!=null&&!m(t.spatialReference,n)&&(t.spatialReference=n)}else t.map.basemap=e,this._clearOverride(`activeBasemap`)}get activeBasemapIndex(){let{state:e,activeBasemap:t}=this;return e===`ready`?this._findBasemapIndex(t):-1}get compatibilityFunction(){return this.view?.type===`3d`?v:y}set compatibilityFunction(e){this._overrideIfSome(`compatibilityFunction`,e)}get source(){return this._get(`source`)}set source(e){(Array.isArray(e)||t.isCollection(e))&&(e=new x({basemaps:Array.isArray(e)?new t(e):e})),w(e)&&(e=new S({portal:e})),T(e)&&(e=new S(e)),E(e)||(e=null),this._set(`source`,e)}get state(){return!this.view?.ready||!this.source?`disabled`:h(this.view)&&!this.view.inGeographicLayout?`unsupported`:this._loadingProjectionEngine?`loading`:`ready`}basemapEquals(e,t){return _(e,t)}refresh(){this._recreateItems()}load(){return this.loadSource()}loadSource(e){return this.addResolvingPromise(i(this.source)?this.source.load(e):null),Promise.resolve(this)}_findBasemapIndex(e){let{items:t}=this,n=t.findIndex(t=>t.basemap===e);return n===-1?t.findIndex(t=>this.basemapEquals(t.basemap,e)):n}_recreateItems(){let e=this.source?.basemaps??[],{view:t,compatibilityFunction:n}=this,r=new Map(this.items.map(e=>[e.basemap,e])),i=e.map(e=>{let i=r.get(e);return i?(r.delete(e),i):new b({basemap:e,compatibilityFunction:n,view:t})});this.items.removeAll(),this.items.addMany(i),r.forEach(e=>e.destroy())}_updateItems(){for(let e of this.items)e.compatibilityFunction=this.compatibilityFunction,e.view=this.view}};e([l()],D.prototype,`_loadingProjectionEngine`,void 0),e([l()],D.prototype,`activeBasemap`,null),e([l({readOnly:!0})],D.prototype,`activeBasemapIndex`,null),e([l()],D.prototype,`compatibilityFunction`,null),e([l({readOnly:!0,type:C})],D.prototype,`items`,void 0),e([l()],D.prototype,`source`,null),e([l({readOnly:!0})],D.prototype,`state`,null),e([l()],D.prototype,`view`,void 0),D=e([u(`esri.widgets.BasemapGallery.BasemapGalleryViewModel`)],D);const O=D;export{O as default};
+import{__decorate as e}from"tslib";import t from"../../core/Collection.js";import{deprecatedModule as n}from"../../core/deprecate.js";import{Loadable as r,isLoadable as i}from"../../core/Loadable.js";import a from"../../core/Logger.js";import{watch as o,on as s,when as c}from"../../core/reactiveUtils.js";import{property as l,subclass as u}from"../../core/accessorSupport/decorators.js";import{canProjectWithoutEngine as d,isLoaded as f,load as p}from"../../geometry/projectionUtils.js";import{equals as m}from"../../geometry/support/spatialReferenceUtils.js";import{isLinkChartView as h}from"../../linkChart/guards.js";import{basemapEnsureType as g}from"../../support/basemapEnsureType.js";import{contentEquals as _}from"../../support/basemapUtils.js";import{default3DCompatibility as v,default2DCompatibility as y}from"./support/basemapCompatibilityUtils.js";import b from"./support/BasemapGalleryItem.js";import x from"./support/LocalBasemapsSource.js";import S from"./support/PortalBasemapsSource.js";const C=t.ofType(b);function w(e){return e&&e.declaredClass===`esri.portal.Portal`}function T(e){return e&&!(e instanceof S)&&(!!e.portal||!!e.query)}function E(e){return e&&`basemaps`in e&&`state`in e&&`refresh`in e}let D=class extends r{constructor(e){super(e),this._loadingProjectionEngine=!1,this.items=new C,this.view=null,e?.suppressDeprecationWarning||n(a.getLogger(this),`esri.widgets.BasemapGallery.BasemapGalleryViewModel`,{version:`5.2`,replacement:`Use the @arcgis/core/basemapGallery/BasemapGalleryModel class instead.`,warnOnce:!0}),this.source=new S}normalizeCtorArgs(e={}){let{suppressDeprecationWarning:t,...n}=e;return n}initialize(){let e=()=>this._recreateItems();this.addHandles([o(()=>this.state===`ready`?this.compatibilityFunction:null,()=>this._updateItems()),s(()=>this.source?.basemaps,`change`,e,{onListenerAdd:e}),c(()=>this.view,()=>{this.source instanceof S&&(this.source.viewType=this.view?.type)},{once:!0})])}destroy(){let e=this.source.basemaps.find(e=>e===this.activeBasemap);e&&this.source.basemaps.remove(e),this.source?.destroy()}get activeBasemap(){return this.view?.map?.basemap??null}set activeBasemap(e){let t=this.view;if(!t?.map)return;if(e=g(e),!e||!t.ready){t.map.basemap=e,this._clearOverride(`activeBasemap`);return}let n=e.spatialReference||this.items?.find(t=>this.basemapEquals(e,t.basemap))?.spatialReference;if(n&&`spatialReferenceLocked`in t&&!t.spatialReferenceLocked){let r=t.spatialReference;if(n!=null&&!m(r,n)&&!d(t.spatialReference,n)&&!f()){this._override(`activeBasemap`,e),this._loadingProjectionEngine=!0,p().then(()=>{this._get(`activeBasemap`)===e&&(t.map.basemap=e,t.spatialReference=n,this._clearOverride(`activeBasemap`))},()=>{}).then(()=>{this._loadingProjectionEngine=!1});return}t.map.basemap=e,this._clearOverride(`activeBasemap`),n!=null&&!m(t.spatialReference,n)&&(t.spatialReference=n)}else t.map.basemap=e,this._clearOverride(`activeBasemap`)}get activeBasemapIndex(){let{state:e,activeBasemap:t}=this;return e===`ready`?this._findBasemapIndex(t):-1}get compatibilityFunction(){return this.view?.type===`3d`?v:y}set compatibilityFunction(e){this._overrideIfSome(`compatibilityFunction`,e)}get source(){return this._get(`source`)}set source(e){(Array.isArray(e)||t.isCollection(e))&&(e=new x({basemaps:Array.isArray(e)?new t(e):e})),w(e)&&(e=new S({portal:e})),T(e)&&(e=new S(e)),E(e)||(e=null),this._set(`source`,e)}get state(){return!this.view?.ready||!this.source?`disabled`:h(this.view)&&!this.view.inGeographicLayout?`unsupported`:this._loadingProjectionEngine?`loading`:`ready`}basemapEquals(e,t){return _(e,t)}refresh(){this._recreateItems()}load(){return this.loadSource()}loadSource(e){return this.addResolvingPromise(i(this.source)?this.source.load(e):null),Promise.resolve(this)}_findBasemapIndex(e){let{items:t}=this,n=t.findIndex(t=>t.basemap===e);return n===-1?t.findIndex(t=>this.basemapEquals(t.basemap,e)):n}_recreateItems(){let e=this.source?.basemaps??[],{view:t,compatibilityFunction:n}=this,r=new Map(this.items.map(e=>[e.basemap,e])),i=e.map(e=>{let i=r.get(e);return i?(r.delete(e),i):new b({basemap:e,compatibilityFunction:n,view:t})});this.items.removeAll(),this.items.addMany(i),r.forEach(e=>e.destroy())}_updateItems(){for(let e of this.items)e.compatibilityFunction=this.compatibilityFunction,e.view=this.view}};e([l()],D.prototype,`_loadingProjectionEngine`,void 0),e([l()],D.prototype,`activeBasemap`,null),e([l({readOnly:!0})],D.prototype,`activeBasemapIndex`,null),e([l()],D.prototype,`compatibilityFunction`,null),e([l({readOnly:!0,type:C})],D.prototype,`items`,void 0),e([l()],D.prototype,`source`,null),e([l({readOnly:!0})],D.prototype,`state`,null),e([l()],D.prototype,`view`,void 0),D=e([u(`esri.widgets.BasemapGallery.BasemapGalleryViewModel`)],D);const O=D;export{O as default};

package/widgets/BasemapGallery/support/BasemapGalleryItem.d.ts

@@ -4,17 +4,17 @@ import type EsriError from "../../../core/Error.js";
 import type { IdentifiableMixin, IdentifiableMixinProperties } from "../../../core/Identifiable.js";
 import type { MapViewOrSceneView } from "../../../views/MapViewOrSceneView.js";
 
-/** @deprecated since version 5.2. Use [BasemapItemProperties](https://developers.arcgis.com/javascript/latest/references/core/basemaps/support/BasemapItem/#BasemapItemProperties) instead. */
+/** @deprecated since version 5.2. Use [BasemapItemProperties](https://developers.arcgis.com/javascript/latest/references/core/basemapGallery/support/BasemapItem/#BasemapItemProperties) instead. */
 export interface BasemapGalleryItemProperties extends IdentifiableMixinProperties, Partial<Pick<BasemapGalleryItem, "basemap" | "view">> {}
 
-/** @deprecated since version 5.2. Use [BasemapItemState](https://developers.arcgis.com/javascript/latest/references/core/basemaps/support/BasemapItem/#BasemapItemState) instead. */
+/** @deprecated since version 5.2. Use [BasemapItemState](https://developers.arcgis.com/javascript/latest/references/core/basemapGallery/support/BasemapItem/#BasemapItemState) instead. */
 export type BasemapGalleryItemState = "ready" | "loading" | "error";
 
 /**
  * The BasemapGalleryItem class represents one of the [BasemapGalleryViewModel.items](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/BasemapGalleryViewModel/#items)
  * in the [BasemapGallery](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/).
  *
- * @deprecated since version 5.2. Use [BasemapItem](https://developers.arcgis.com/javascript/latest/references/core/basemaps/support/BasemapItem/) instead.
+ * @deprecated since version 5.2. Use [BasemapItem](https://developers.arcgis.com/javascript/latest/references/core/basemapGallery/support/BasemapItem/) instead.
  * @since 4.3
  * @see [BasemapGalleryViewModel.items](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/BasemapGalleryViewModel/#items)
  */

package/widgets/BasemapGallery/support/LocalBasemapsSource.d.ts

@@ -5,7 +5,7 @@ import type { BasemapsSourceState } from "../types.js";
 import type { BasemapProperties } from "../../../Basemap.js";
 import type { ReadonlyArrayOrCollection } from "../../../core/Collection.js";
 
-/** @deprecated since version 5.2. Use [LocalBasemapsSourceProperties](https://developers.arcgis.com/javascript/latest/references/core/basemaps/LocalBasemapsSource/#LocalBasemapsSourceProperties) instead. */
+/** @deprecated since version 5.2. Use [LocalBasemapsSourceProperties](https://developers.arcgis.com/javascript/latest/references/core/basemapGallery/LocalBasemapsSource/#LocalBasemapsSourceProperties) instead. */
 export interface LocalBasemapsSourceProperties {
   /** A collection of [Basemap](https://developers.arcgis.com/javascript/latest/references/core/Basemap/)s. */
   basemaps?: ReadonlyArrayOrCollection<BasemapProperties>;
@@ -15,7 +15,7 @@ export interface LocalBasemapsSourceProperties {
  * The LocalBasemapsSource class is a Collection-driven [Basemap](https://developers.arcgis.com/javascript/latest/references/core/Basemap/) [BasemapGalleryViewModel.source](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/BasemapGalleryViewModel/#source)
  * in the [BasemapGalleryViewModel](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/BasemapGalleryViewModel/) or [BasemapGallery](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/) widget.
  *
- * @deprecated since version 5.2. Use [LocalBasemapsSource](https://developers.arcgis.com/javascript/latest/references/core/basemaps/LocalBasemapsSource/) instead.
+ * @deprecated since version 5.2. Use [LocalBasemapsSource](https://developers.arcgis.com/javascript/latest/references/core/basemapGallery/LocalBasemapsSource/) instead.
  * @since 4.3
  * @see [BasemapGalleryViewModel.source](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/BasemapGalleryViewModel/#source)
  * @see [BasemapGallery](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/)

package/widgets/BasemapGallery/support/PortalBasemapsSource.d.ts

@@ -8,7 +8,7 @@ import type { BasemapFilter, BasemapsSourceState, UpdateBasemapsCallback } from
 import type { LocalBasemapsSourceProperties } from "./LocalBasemapsSource.js";
 import type { PortalProperties } from "../../../portal/Portal.js";
 
-/** @deprecated since version 5.2. Use [PortalBasemapsSourceProperties](https://developers.arcgis.com/javascript/latest/references/core/basemaps/PortalBasemapsSource/#PortalBasemapsSourceProperties) instead. */
+/** @deprecated since version 5.2. Use [PortalBasemapsSourceProperties](https://developers.arcgis.com/javascript/latest/references/core/basemapGallery/PortalBasemapsSource/#PortalBasemapsSourceProperties) instead. */
 export interface PortalBasemapsSourceProperties extends LocalBasemapsSourceProperties, LoadableMixinProperties, Partial<Pick<PortalBasemapsSource, "filterFunction" | "query" | "updateBasemapsCallback">> {
   /** The Portal from which to fetch basemaps. */
   portal?: PortalProperties;
@@ -18,7 +18,7 @@ export interface PortalBasemapsSourceProperties extends LocalBasemapsSourcePrope
  * The PortalBasemapsSource class is a Portal-driven [Basemap](https://developers.arcgis.com/javascript/latest/references/core/Basemap/) [BasemapGalleryViewModel.source](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/BasemapGalleryViewModel/#source)
  * in the [BasemapGalleryViewModel](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/BasemapGalleryViewModel/) or [BasemapGallery](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/) widget.
  *
- * @deprecated since version 5.2. Use [PortalBasemapsSource](https://developers.arcgis.com/javascript/latest/references/core/basemaps/PortalBasemapsSource/) instead.
+ * @deprecated since version 5.2. Use [PortalBasemapsSource](https://developers.arcgis.com/javascript/latest/references/core/basemapGallery/PortalBasemapsSource/) instead.
  * @since 4.3
  * @see [BasemapGalleryViewModel.source](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/BasemapGalleryViewModel/#source)
  * @see [BasemapGallery](https://developers.arcgis.com/javascript/latest/references/core/widgets/BasemapGallery/)

package/widgets/BasemapGallery/types.d.ts

@@ -10,7 +10,7 @@ import type Basemap from "../../Basemap.js";
  * @param index - The index of the Basemap being assessed.
  * @param array - The array of basemaps being filtered.
  * @returns Returns true if the test passes, false otherwise.
- * @deprecated since version 5.2. Use [BasemapFilter](https://developers.arcgis.com/javascript/latest/references/core/basemaps/types/#BasemapFilter) instead.
+ * @deprecated since version 5.2. Use [BasemapFilter](https://developers.arcgis.com/javascript/latest/references/core/basemapGallery/types/#BasemapFilter) instead.
  * @since 5.0
  */
 export type BasemapFilter = (item: Basemap, index: number, array: Basemap[]) => boolean | Promise<boolean>;
@@ -23,7 +23,7 @@ export type BasemapFilter = (item: Basemap, index: number, array: Basemap[]) =>
  *
  * @param items - An array of basemaps that have been fetched and filtered from the Portal.
  * @returns The array of basemaps to display in the BasemapGallery widget.
- * @deprecated since version 5.2. Use [UpdateBasemapsCallback](https://developers.arcgis.com/javascript/latest/references/core/basemaps/types/#UpdateBasemapsCallback) instead.
+ * @deprecated since version 5.2. Use [UpdateBasemapsCallback](https://developers.arcgis.com/javascript/latest/references/core/basemapGallery/types/#UpdateBasemapsCallback) instead.
  * @since 5.0
  * @example
  * // Create custom basemap to be added to the array of portal basemaps
@@ -71,7 +71,7 @@ export type BasemapFilter = (item: Basemap, index: number, array: Basemap[]) =>
 export type UpdateBasemapsCallback = (items: Basemap[]) => Basemap[] | Promise<Basemap[]>;
 
 /**
- * @deprecated since version 5.2. Use [BasemapsSourceState](https://developers.arcgis.com/javascript/latest/references/core/basemaps/types/#BasemapsSourceState) instead.
+ * @deprecated since version 5.2. Use [BasemapsSourceState](https://developers.arcgis.com/javascript/latest/references/core/basemapGallery/types/#BasemapsSourceState) instead.
  * @since 5.0
  */
 export type BasemapsSourceState = "ready" | "loading" | "not-loaded";