ArcGIS widget-removal survival guide

Every classic ArcGIS JS SDK widget (esri/widgets/* / @arcgis/core/widgets/*) is deprecated as of ArcGIS JS 5.0 and is removed at 6.0 — as early as Q1 2027. If your app constructs any of these widgets, that code stops compiling and running when you take the 6.0 upgrade.

This guide answers, for each deprecated widget, what happens if you migrate to Honua/MapLibre instead of rewriting onto Esri's web components. Dispositions are deliberately honest — including "no equivalent" — in the spirit of docs/migration-punch-list.md.

This document is generated from the versioned disposition data in src/migration/widget-dispositions.ts (v1.0.0); the honua-migrate widget scanner consumes the same data, so the scanner report and this guide cannot drift apart. The deprecated-widget inventory is pinned per ArcGIS release against https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets.html (5.0 deprecation list) and updated manually.

Scan your app first

# Human-readable table (also: --json, --markdown, --gate <pct>, --report <file>)
npm run scan:arcgis:widgets -- ./src

The report inventories every widget usage site (ESM imports, AMD require([...]) arrays, and dynamic $arcgis.import(...) specifiers), joins each row to the disposition below, and emits an overall automated/assisted/manual split against the 6.0 removal deadline. --gate <pct> makes CI fail when the automated share drops below the threshold.

Disposition taxonomy

• Automated (automated): The honua-migrate codemod deterministically rewrites the import and safe constructor call sites to a Honua compat shim from @honua/sdk-esri-compat. Unsafe option literals fall through to an annotated manual TODO.
• Compat shim (compat-shim): A Honua compat shim exists and the codemod rewrites to it, but the widget carries a large interaction surface — treat the migration as assisted and verify app-specific behavior by hand.
• App platform (app-platform): The capability is served by a Honua app-platform component rather than an SDK widget. (Reserved: no widget currently carries this disposition; rows may move here as the app platform matures.)
• MapLibre plugin (maplibre-plugin): The capability is served by a MapLibre control or community plugin wired up by hand. (Reserved: no widget currently carries this disposition; several automated rows note the MapLibre-native control underneath.)
• Manual workaround (manual-workaround): No drop-in replacement. The row documents an explicit, honest workaround that is real app work you own.
• No equivalent (no-equivalent): No Honua or MapLibre surface reproduces the widget today. Apps that depend on it need a product decision, not a rewrite.

Readiness buckets: automated counts as automated; compat-shim, app-platform, and maplibre-plugin count as assisted; manual-workaround and no-equivalent count as manual.

A compat-backed row may also list a direct @honua/app-platform component. That component is the recommended destination for a deliberate UI rewrite; the disposition still describes what honua-migrate can automate today.

Summary

Widget dispositions

Per-widget details

AreaMeasurement2D

• Disposition: compat-shim (Compat shim)
• Modules: @arcgis/core/widgets/AreaMeasurement2D, esri/widgets/AreaMeasurement2D
• Target: AreaMeasurement2DCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/measurement-2d.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites, but the shim covers the core workflow rather than the full ArcGIS surface — plan hands-on verification of app-specific behavior after migration. Rendering is not byte-identical to ArcGIS.

Attribution

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/Attribution, esri/widgets/Attribution
• Target: AttributionCompat from @honua/sdk-esri-compat (MapLibre AttributionControl underneath)
• Compat shim source: src/esri-compat/controls.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

BasemapGallery

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/BasemapGallery, esri/widgets/BasemapGallery
• Target: BasemapGalleryCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/basemap-gallery.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

BasemapLayerList

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/BasemapLayerList, esri/widgets/BasemapLayerList
• Target: BasemapLayerListCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/basemap-layer-list.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

BasemapToggle

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/BasemapToggle, esri/widgets/BasemapToggle
• Target: BasemapToggleCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/controls.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

Bookmarks

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/Bookmarks, esri/widgets/Bookmarks
• Target: BookmarksCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/bookmarks.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

Compass

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/Compass, esri/widgets/Compass
• Target: CompassCompat from @honua/sdk-esri-compat (MapLibre NavigationControl covers the same gesture natively)
• Compat shim source: src/esri-compat/controls.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

CoordinateConversion

• Disposition: compat-shim (Compat shim)
• Modules: @arcgis/core/widgets/CoordinateConversion, esri/widgets/CoordinateConversion
• Target: CoordinateConversionCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/coordinate-conversion.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites, but the shim covers the core workflow rather than the full ArcGIS surface — plan hands-on verification of app-specific behavior after migration. Rendering is not byte-identical to ArcGIS. Custom coordinate formats beyond the built-in set are not reproduced.

Daylight

• Disposition: no-equivalent (No equivalent)
• Modules: @arcgis/core/widgets/Daylight, esri/widgets/Daylight
• Target: None. Requires a 3D scene with sun/shadow simulation.
• Notes: SceneView/3D analysis widget. Honua's SceneViewCompat is 2D-behavior only and no Honua or MapLibre surface reproduces this widget today (see docs/migration-punch-list.md, parity gap 1). Apps that depend on it need a product decision, not a code rewrite.

Directions

• Disposition: compat-shim (Compat shim)
• Modules: @arcgis/core/widgets/Directions, esri/widgets/Directions
• Target: DirectionsCompat from @honua/sdk-esri-compat backed by HonuaRouteService (RouteTask parity)
• Compat shim source: src/esri-compat/directions.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites, but the shim covers the core workflow rather than the full ArcGIS surface — plan hands-on verification of app-specific behavior after migration. Rendering is not byte-identical to ArcGIS. Only RouteTask-backed routing is shimmed; service-area, closest-facility, and OD-cost-matrix flows remain unsupported (docs/migration-punch-list.md, parity gap 3).

DistanceMeasurement2D

• Disposition: compat-shim (Compat shim)
• Modules: @arcgis/core/widgets/DistanceMeasurement2D, esri/widgets/DistanceMeasurement2D
• Target: DistanceMeasurement2DCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/measurement-2d.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites, but the shim covers the core workflow rather than the full ArcGIS surface — plan hands-on verification of app-specific behavior after migration. Rendering is not byte-identical to ArcGIS.

Editor

• Disposition: compat-shim (Compat shim)
• Modules: @arcgis/core/widgets/Editor, esri/widgets/Editor
• Target: EditorCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/editor.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites, but the shim covers the core workflow rather than the full ArcGIS surface — plan hands-on verification of app-specific behavior after migration. Rendering is not byte-identical to ArcGIS. Attribute + geometry editing against feature services works; advanced form elements and utility-network editing do not.

ElevationProfile

• Disposition: manual-workaround (Manual workaround)
• Modules: @arcgis/core/widgets/ElevationProfile, esri/widgets/ElevationProfile
• Target: No drop-in widget. Sample the profile geometry yourself (e.g. @honua/sdk-js/geometry densify + an elevation/terrain source such as maplibre-gl queryTerrainElevation) and chart with your own charting library.
• Notes: There is no ElevationProfile shim and no automated rewrite. The workaround is honest but real work: profile sampling, unit handling, and chart UX are app code you own after migration.

Expand

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/Expand, esri/widgets/Expand
• Target: ExpandCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/expand.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

Feature

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/Feature, esri/widgets/Feature
• Target: FeatureCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/feature.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

FeatureForm

• Disposition: compat-shim (Compat shim)
• Modules: @arcgis/core/widgets/FeatureForm, esri/widgets/FeatureForm
• Target: FeatureFormCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/feature-form.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites, but the shim covers the core workflow rather than the full ArcGIS surface — plan hands-on verification of app-specific behavior after migration. Rendering is not byte-identical to ArcGIS. Arcade-driven form expressions are not evaluated.

FeatureTable

• Disposition: compat-shim (Compat shim)
• Modules: @arcgis/core/widgets/FeatureTable, esri/widgets/FeatureTable
• Target: FeatureTableCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/feature-table.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites, but the shim covers the core workflow rather than the full ArcGIS surface — plan hands-on verification of app-specific behavior after migration. Rendering is not byte-identical to ArcGIS. Related-records and popup interaction flows are exercised by the demo fixtures; column virtualization and attachment editing differ from ArcGIS.

FeatureTemplates

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/FeatureTemplates, esri/widgets/FeatureTemplates
• Target: FeatureTemplatesCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/feature-templates.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

Fullscreen

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/Fullscreen, esri/widgets/Fullscreen
• Target: FullscreenCompat from @honua/sdk-esri-compat (MapLibre FullscreenControl underneath)
• Compat shim source: src/esri-compat/controls.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

Home

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/Home, esri/widgets/Home
• Target: HomeCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/controls.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

LayerList

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/LayerList, esri/widgets/LayerList
• Target: LayerListCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/layer-list.ts
• Direct app-platform component: <honua-layer-list> from @honua/app-platform/web-components
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

App-platform usage (the module import auto-registers the element):

import "@honua/app-platform/web-components";

<honua-map id="map"></honua-map>
<honua-layer-list for="map"></honua-layer-list>

Legend

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/Legend, esri/widgets/Legend
• Target: LegendCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/legend.ts
• Direct app-platform component: <honua-legend> from @honua/app-platform/web-components
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

App-platform usage (the module import auto-registers the element):

import "@honua/app-platform/web-components";

<honua-map id="map"></honua-map>
<honua-legend for="map"></honua-legend>

LineOfSight

• Disposition: no-equivalent (No equivalent)
• Modules: @arcgis/core/widgets/LineOfSight, esri/widgets/LineOfSight
• Target: None. Requires 3D scene geometry intersection analysis.
• Notes: SceneView/3D analysis widget. Honua's SceneViewCompat is 2D-behavior only and no Honua or MapLibre surface reproduces this widget today (see docs/migration-punch-list.md, parity gap 1). Apps that depend on it need a product decision, not a code rewrite.

Locate

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/Locate, esri/widgets/Locate
• Target: LocateCompat from @honua/sdk-esri-compat (MapLibre GeolocateControl covers the same behavior natively)
• Compat shim source: src/esri-compat/controls.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

Measurement

• Disposition: compat-shim (Compat shim)
• Modules: @arcgis/core/widgets/Measurement, esri/widgets/Measurement
• Target: MeasurementCompat from @honua/sdk-esri-compat (2D distance/area only)
• Compat shim source: src/esri-compat/measurement.ts
• Direct app-platform component: <honua-measurement> from @honua/app-platform/web-components
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites, but the shim covers the core workflow rather than the full ArcGIS surface — plan hands-on verification of app-specific behavior after migration. Rendering is not byte-identical to ArcGIS. 3D measurement modes are not supported.

App-platform usage (the module import auto-registers the element):

import "@honua/app-platform/web-components";

<honua-map id="map"></honua-map>
<honua-measurement for="map"></honua-measurement>

Popup

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/Popup, esri/widgets/Popup
• Target: PopupCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/popup.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS. Popup actions and fieldInfos format callbacks migrate for the simple case only (docs/migration-punch-list.md, parity gap 5).

Print

• Disposition: compat-shim (Compat shim)
• Modules: @arcgis/core/widgets/Print, esri/widgets/Print
• Target: PrintCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/print.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites, but the shim covers the core workflow rather than the full ArcGIS surface — plan hands-on verification of app-specific behavior after migration. Rendering is not byte-identical to ArcGIS. Export goes through the Honua rendering pipeline, not an ArcGIS print service; custom print templates need re-authoring.

ScaleBar

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/ScaleBar, esri/widgets/ScaleBar
• Target: ScaleBarCompat from @honua/sdk-esri-compat (MapLibre ScaleControl underneath)
• Compat shim source: src/esri-compat/controls.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

Search

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/Search, esri/widgets/Search
• Target: SearchCompat from @honua/sdk-esri-compat backed by the Honua geocoding surface
• Compat shim source: src/esri-compat/search.ts
• Direct app-platform component: <honua-search> from @honua/app-platform/web-components
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS. Custom Locator sources are out of scope (Locator/Geoprocessor parity gap).

App-platform usage (the module import auto-registers the element):

import "@honua/app-platform/web-components";

<honua-map id="map"></honua-map>
<honua-search for="map" source="incidents"></honua-search>

ShadowCast

• Disposition: no-equivalent (No equivalent)
• Modules: @arcgis/core/widgets/ShadowCast, esri/widgets/ShadowCast
• Target: None. Requires a 3D scene with shadow accumulation.
• Notes: SceneView/3D analysis widget. Honua's SceneViewCompat is 2D-behavior only and no Honua or MapLibre surface reproduces this widget today (see docs/migration-punch-list.md, parity gap 1). Apps that depend on it need a product decision, not a code rewrite.

Sketch

• Disposition: compat-shim (Compat shim)
• Modules: @arcgis/core/widgets/Sketch, esri/widgets/Sketch
• Target: SketchCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/sketch.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites, but the shim covers the core workflow rather than the full ArcGIS surface — plan hands-on verification of app-specific behavior after migration. Rendering is not byte-identical to ArcGIS. Snapping and 3D sketch tools are not reproduced.

Slice

• Disposition: no-equivalent (No equivalent)
• Modules: @arcgis/core/widgets/Slice, esri/widgets/Slice
• Target: None. Requires 3D scene slicing.
• Notes: SceneView/3D analysis widget. Honua's SceneViewCompat is 2D-behavior only and no Honua or MapLibre surface reproduces this widget today (see docs/migration-punch-list.md, parity gap 1). Apps that depend on it need a product decision, not a code rewrite.

Swipe

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/Swipe, esri/widgets/Swipe
• Target: SwipeCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/swipe.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

TableList

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/TableList, esri/widgets/TableList
• Target: TableListCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/table-list.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

TimeSlider

• Disposition: compat-shim (Compat shim)
• Modules: @arcgis/core/widgets/TimeSlider, esri/widgets/TimeSlider
• Target: TimeSliderCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/time-slider.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites, but the shim covers the core workflow rather than the full ArcGIS surface — plan hands-on verification of app-specific behavior after migration. Rendering is not byte-identical to ArcGIS. Time-aware layer filtering works; stops derived from server time-info metadata should be verified per service.

Track

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/Track, esri/widgets/Track
• Target: TrackCompat from @honua/sdk-esri-compat
• Compat shim source: src/esri-compat/track.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

Weather

• Disposition: no-equivalent (No equivalent)
• Modules: @arcgis/core/widgets/Weather, esri/widgets/Weather
• Target: None. Requires a 3D scene atmosphere/weather renderer.
• Notes: SceneView/3D analysis widget. Honua's SceneViewCompat is 2D-behavior only and no Honua or MapLibre surface reproduces this widget today (see docs/migration-punch-list.md, parity gap 1). Apps that depend on it need a product decision, not a code rewrite.

Zoom

• Disposition: automated (Automated)
• Modules: @arcgis/core/widgets/Zoom, esri/widgets/Zoom
• Target: ZoomCompat from @honua/sdk-esri-compat (MapLibre NavigationControl underneath)
• Compat shim source: src/esri-compat/controls.ts
• Notes: The honua-migrate codemod rewrites the import and safe constructor call sites deterministically; unsafe option literals fall through to an annotated manual TODO. Rendering goes through the Honua widget host, so CSS selectors and DOM structure are not byte-identical to ArcGIS.

Out of scope

These surfaces are intentionally not covered by the dispositions above:

• SceneView / 3D rendering. Honua's SceneViewCompat shares 2D MapView behavior; WebGL/CesiumJS scene parity (environment, global viewing mode, scene layers, camera) is not implemented (punch list, parity gaps 1-2). The 3D analysis widgets above are therefore no-equivalent rather than shimmed.
• Locator (geocoding tasks). Only the Search widget's core flow is shimmed; the standalone Locator task surface (suggest/geocode customization, custom locators) needs its own Honua surface first (punch list, parity gap 3).
• Geoprocessor / NetworkAnalyst beyond RouteTask. Service-area, closest-facility, OD-cost-matrix, and general geoprocessing have no Honua equivalent yet; the scanner's advanced-widget-or-networking-detected flag calls these out separately (punch list, parity gap 3).

Related reading

• Migration punch list — the honest parity/codemod accounting.
• Honua ⇄ MapLibre migration notes — the honua-maplibre codemod target.
• SDK guide: Migration CLI — every honua-migrate subcommand.