@defra/interactive-map 0.0.23-alpha → 0.0.25-alpha

package/providers/beta/openlayers/dist/umd/im-openlayers-provider.js.LICENSE.txt

@@ -0,0 +1 @@
+/*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */

package/providers/beta/openlayers/dist/umd/index.js

@@ -0,0 +1,2 @@
+/*! For license information please see index.js.LICENSE.txt */
+!function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define("defra",[],t):"object"==typeof exports?exports.defra=t():(e.defra=e.defra||{},e.defra.openLayersProvider=t())}(this,()=>(()=>{"use strict";var e,t,r={},n={};function o(e){var t=n[e];if(void 0!==t)return t.exports;var i=n[e]={exports:{}};return r[e](i,i.exports,o),i.exports}o.m=r,o.d=(e,t)=>{for(var r in t)o.o(t,r)&&!o.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:t[r]})},o.f={},o.e=e=>Promise.all(Object.keys(o.f).reduce((t,r)=>(o.f[r](e,t),t),[])),o.u=e=>"im-openlayers-provider.js",o.miniCssF=e=>{},o.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),o.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),e={},t="defra.openLayersProvider:",o.l=(r,n,i,a)=>{if(e[r])e[r].push(n);else{var u,c;if(void 0!==i)for(var f=document.getElementsByTagName("script"),p=0;p<f.length;p++){var s=f[p];if(s.getAttribute("src")==r||s.getAttribute("data-webpack")==t+i){u=s;break}}u||(c=!0,(u=document.createElement("script")).charset="utf-8",o.nc&&u.setAttribute("nonce",o.nc),u.setAttribute("data-webpack",t+i),u.src=r),e[r]=[n];var l=(t,n)=>{u.onerror=u.onload=null,clearTimeout(d);var o=e[r];if(delete e[r],u.parentNode&&u.parentNode.removeChild(u),o&&o.forEach(e=>e(n)),t)return t(n)},d=setTimeout(l.bind(null,void 0,{type:"timeout",target:u}),12e4);u.onerror=l.bind(null,u.onerror),u.onload=l.bind(null,u.onload),c&&document.head.appendChild(u)}},o.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},(()=>{var e;o.g.importScripts&&(e=o.g.location+"");var t=o.g.document;if(!e&&t&&(t.currentScript&&"SCRIPT"===t.currentScript.tagName.toUpperCase()&&(e=t.currentScript.src),!e)){var r=t.getElementsByTagName("script");if(r.length)for(var n=r.length-1;n>-1&&(!e||!/^http(s?):/.test(e));)e=r[n--].src}if(!e)throw new Error("Automatic publicPath is not supported in this browser");e=e.replace(/^blob:/,"").replace(/#.*$/,"").replace(/\?.*$/,"").replace(/\/[^\/]+$/,"/"),o.p=e})(),(()=>{var e={57:0};o.f.j=(t,r)=>{var n=o.o(e,t)?e[t]:void 0;if(0!==n)if(n)r.push(n[2]);else{var i=new Promise((r,o)=>n=e[t]=[r,o]);r.push(n[2]=i);var a=o.p+o.u(t),u=new Error;o.l(a,r=>{if(o.o(e,t)&&(0!==(n=e[t])&&(e[t]=void 0),n)){var i=r&&("load"===r.type?"missing":r.type),a=r&&r.target&&r.target.src;u.message="Loading chunk "+t+" failed.\n("+i+": "+a+")",u.name="ChunkLoadError",u.type=i,u.request=a,n[1](u)}},"chunk-"+t,t)}};var t=(t,r)=>{var n,i,[a,u,c]=r,f=0;if(a.some(t=>0!==e[t])){for(n in u)o.o(u,n)&&(o.m[n]=u[n]);c&&c(o)}for(t&&t(r);f<a.length;f++)i=a[f],o.o(e,i)&&e[i]&&e[i][0](),e[i]=0},r=this.webpackChunkdefra_DefraMap=this.webpackChunkdefra_DefraMap||[];r.forEach(t.bind(null,0)),r.push=t.bind(null,r.push.bind(r))})();var i={};function a(){var e,t,r="function"==typeof Symbol?Symbol:{},n=r.iterator||"@@iterator",o=r.toStringTag||"@@toStringTag";function i(r,n,o,i){var a=n&&n.prototype instanceof f?n:f,p=Object.create(a.prototype);return u(p,"_invoke",function(r,n,o){var i,a,u,f=0,p=o||[],s=!1,l={p:0,n:0,v:e,a:d,f:d.bind(e,4),d:function(t,r){return i=t,a=0,u=e,l.n=r,c}};function d(r,n){for(a=r,u=n,t=0;!s&&f&&!o&&t<p.length;t++){var o,i=p[t],d=l.p,v=i[2];r>3?(o=v===n)&&(u=i[(a=i[4])?5:(a=3,3)],i[4]=i[5]=e):i[0]<=d&&((o=r<2&&d<i[1])?(a=0,l.v=n,l.n=i[1]):d<v&&(o=r<3||i[0]>n||n>v)&&(i[4]=r,i[5]=n,l.n=v,a=0))}if(o||r>1)return c;throw s=!0,n}return function(o,p,v){if(f>1)throw TypeError("Generator is already running");for(s&&1===p&&d(p,v),a=p,u=v;(t=a<2?e:u)||!s;){i||(a?a<3?(a>1&&(l.n=-1),d(a,u)):l.n=u:l.v=u);try{if(f=2,i){if(a||(o="next"),t=i[o]){if(!(t=t.call(i,u)))throw TypeError("iterator result is not an object");if(!t.done)return t;u=t.value,a<2&&(a=0)}else 1===a&&(t=i.return)&&t.call(i),a<2&&(u=TypeError("The iterator does not provide a '"+o+"' method"),a=1);i=e}else if((t=(s=l.n<0)?u:r.call(n,l))!==c)break}catch(t){i=e,a=1,u=t}finally{f=1}}return{value:t,done:s}}}(r,o,i),!0),p}var c={};function f(){}function p(){}function s(){}t=Object.getPrototypeOf;var l=[][n]?t(t([][n]())):(u(t={},n,function(){return this}),t),d=s.prototype=f.prototype=Object.create(l);function v(e){return Object.setPrototypeOf?Object.setPrototypeOf(e,s):(e.__proto__=s,u(e,o,"GeneratorFunction")),e.prototype=Object.create(d),e}return p.prototype=s,u(d,"constructor",s),u(s,"constructor",p),p.displayName="GeneratorFunction",u(s,o,"GeneratorFunction"),u(d),u(d,o,"Generator"),u(d,n,function(){return this}),u(d,"toString",function(){return"[object Generator]"}),(a=function(){return{w:i,m:v}})()}function u(e,t,r,n){var o=Object.defineProperty;try{o({},"",{})}catch(e){o=0}u=function(e,t,r,n){function i(t,r){u(e,t,function(e){return this._invoke(t,r,e)})}t?o?o(e,t,{value:r,enumerable:!n,configurable:!n,writable:!n}):e[t]=r:(i("next",0),i("throw",1),i("return",2))},u(e,t,r,n)}function c(e,t,r,n,o,i,a){try{var u=e[i](a),c=u.value}catch(e){return void r(e)}u.done?t(c):Promise.resolve(c).then(n,o)}function f(){var e,t,r=(arguments.length>0&&void 0!==arguments[0]?arguments[0]:{}).zoomAlignment;return{checkDeviceCapabilities:function(){return{isSupported:!!document.createElement("canvas").getContext,error:"Canvas is not supported in this browser"}},load:(e=a().m(function e(){var t,n;return a().w(function(e){for(;;)switch(e.n){case 0:return e.n=1,o.e(142).then(o.bind(o,272));case 1:return t=e.v.default,n={zoomAlignment:r,crs:"EPSG:27700"},e.a(2,{MapProvider:t,mapProviderConfig:n})}},e)}),t=function(){var t=this,r=arguments;return new Promise(function(n,o){var i=e.apply(t,r);function a(e){c(i,n,o,a,u,"next",e)}function u(e){c(i,n,o,a,u,"throw",e)}a(void 0)})},function(){return t.apply(this,arguments)})}}return o.d(i,{default:()=>f}),i.default})());

package/providers/beta/openlayers/dist/umd/index.js.LICENSE.txt

@@ -0,0 +1 @@
+/*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */

package/providers/beta/openlayers/src/appEvents.js

@@ -0,0 +1,39 @@
+import { createTileSource, createVectorTileLayer, createOGCVectorTileLayer } from './utils/tileLayers.js'
+
+export { createTileSource, createVectorTileLayer, createOGCVectorTileLayer }
+
+export function attachAppEvents ({ mapProvider, layer, layerType, transformRequest, events, eventBus, map }) {
+  const handleSetMapStyle = async (mapStyle) => {
+    if (layerType === 'raster') {
+      const source = createTileSource(mapStyle.url, transformRequest)
+      layer.setSource(source)
+    } else if (mapStyle.type === 'ogc-vt') {
+      const { layer: newLayer } = await createOGCVectorTileLayer(mapStyle.url, transformRequest)
+      map.getLayers().setAt(0, newLayer)
+    } else {
+      const { layer: newLayer } = await createVectorTileLayer(mapStyle.url, transformRequest)
+      map.getLayers().setAt(0, newLayer)
+    }
+    eventBus.emit(events.MAP_STYLE_CHANGE, { mapStyleId: mapStyle.id })
+  }
+
+  const handleSetPixelRatio = (pixelRatio) => {
+    map.setPixelRatio(pixelRatio)
+  }
+
+  const handleSizeChange = ({ mapSize }) => {
+    mapProvider.mapSize = mapSize
+  }
+
+  eventBus.on(events.MAP_SET_STYLE, handleSetMapStyle)
+  eventBus.on(events.MAP_SET_PIXEL_RATIO, handleSetPixelRatio)
+  eventBus.on(events.MAP_SIZE_CHANGE, handleSizeChange)
+
+  return {
+    remove () {
+      eventBus.off(events.MAP_SET_STYLE, handleSetMapStyle)
+      eventBus.off(events.MAP_SET_PIXEL_RATIO, handleSetPixelRatio)
+      eventBus.off(events.MAP_SIZE_CHANGE, handleSizeChange)
+    }
+  }
+}

package/providers/beta/openlayers/src/appEvents.test.js

@@ -0,0 +1,117 @@
+import { attachAppEvents } from './appEvents.js'
+
+import { createTileSource, createVectorTileLayer } from './utils/tileLayers.js'
+
+const mockSourceInstance = {}
+const mockVectorTileLayerInstance = {}
+
+jest.mock('./utils/tileLayers.js', () => ({
+  __esModule: true,
+  createTileSource: jest.fn(() => mockSourceInstance),
+  createVectorTileLayer: jest.fn(async () => ({ layer: mockVectorTileLayerInstance, source: {} }))
+}))
+
+const events = {
+  MAP_SET_STYLE: 'map:setstyle',
+  MAP_STYLE_CHANGE: 'map:stylechange',
+  MAP_SET_PIXEL_RATIO: 'map:setpixelratio',
+  MAP_SIZE_CHANGE: 'map:sizechange'
+}
+
+function makeMap () {
+  return { getLayers: jest.fn(() => ({ setAt: jest.fn() })), setPixelRatio: jest.fn() }
+}
+
+function makeProvider () {
+  return { mapSize: 'small' }
+}
+
+describe('attachAppEvents', () => {
+  describe('raster', () => {
+    function makeSetup () {
+      jest.clearAllMocks()
+      const layer = { setSource: jest.fn() }
+      const eventBus = { on: jest.fn(), off: jest.fn(), emit: jest.fn() }
+      const mapProvider = makeProvider()
+      const handles = attachAppEvents({ mapProvider, layer, layerType: 'raster', transformRequest: null, events, eventBus, map: makeMap() })
+      const handlerFor = (event) => eventBus.on.mock.calls.find(c => c[0] === event)[1]
+      return { layer, eventBus, handles, handlerFor, mapProvider }
+    }
+
+    it('subscribes to MAP_SET_STYLE on the event bus', () => {
+      const { eventBus } = makeSetup()
+      expect(eventBus.on).toHaveBeenCalledWith(events.MAP_SET_STYLE, expect.any(Function))
+    })
+
+    it('on MAP_SET_STYLE: creates a tile source and sets it on the layer', async () => {
+      const { layer, handlerFor } = makeSetup()
+      await handlerFor(events.MAP_SET_STYLE)({ url: 'https://new.tiles.com/{z}/{x}/{y}', id: 'newStyle' })
+      expect(createTileSource).toHaveBeenCalledWith('https://new.tiles.com/{z}/{x}/{y}', null)
+      expect(layer.setSource).toHaveBeenCalledWith(mockSourceInstance)
+    })
+
+    it('on MAP_SET_STYLE: emits MAP_STYLE_CHANGE with the new style id', async () => {
+      const { eventBus, handlerFor } = makeSetup()
+      await handlerFor(events.MAP_SET_STYLE)({ url: 'https://new.tiles.com/{z}/{x}/{y}', id: 'newStyle' })
+      expect(eventBus.emit).toHaveBeenCalledWith(events.MAP_STYLE_CHANGE, { mapStyleId: 'newStyle' })
+    })
+
+    it('remove() unsubscribes all handlers', () => {
+      const { eventBus, handles, handlerFor } = makeSetup()
+      handles.remove()
+      expect(eventBus.off).toHaveBeenCalledWith(events.MAP_SET_STYLE, handlerFor(events.MAP_SET_STYLE))
+      expect(eventBus.off).toHaveBeenCalledWith(events.MAP_SET_PIXEL_RATIO, handlerFor(events.MAP_SET_PIXEL_RATIO))
+      expect(eventBus.off).toHaveBeenCalledWith(events.MAP_SIZE_CHANGE, handlerFor(events.MAP_SIZE_CHANGE))
+    })
+  })
+
+  describe('vector', () => {
+    function makeSetup () {
+      jest.clearAllMocks()
+      const setAt = jest.fn()
+      const map = { getLayers: jest.fn(() => ({ setAt })), setPixelRatio: jest.fn() }
+      const eventBus = { on: jest.fn(), off: jest.fn(), emit: jest.fn() }
+      const mapProvider = makeProvider()
+      const handles = attachAppEvents({ mapProvider, layer: {}, layerType: 'vector', transformRequest: null, events, eventBus, map })
+      const handlerFor = (event) => eventBus.on.mock.calls.find(c => c[0] === event)[1]
+      return { map, setAt, eventBus, handles, handlerFor, mapProvider }
+    }
+
+    it('on MAP_SET_STYLE: creates a vector tile layer and places it at index 0', async () => {
+      const { setAt, handlerFor } = makeSetup()
+      await handlerFor(events.MAP_SET_STYLE)({ url: 'https://example.com/styles', id: 'newVts' })
+      expect(createVectorTileLayer).toHaveBeenCalledWith('https://example.com/styles', null)
+      expect(setAt).toHaveBeenCalledWith(0, mockVectorTileLayerInstance)
+    })
+
+    it('on MAP_SET_STYLE: emits MAP_STYLE_CHANGE with the new style id', async () => {
+      const { eventBus, handlerFor } = makeSetup()
+      await handlerFor(events.MAP_SET_STYLE)({ url: 'https://example.com/styles', id: 'newVts' })
+      expect(eventBus.emit).toHaveBeenCalledWith(events.MAP_STYLE_CHANGE, { mapStyleId: 'newVts' })
+    })
+  })
+
+  describe('pixel ratio and map size', () => {
+    function makeSetup () {
+      jest.clearAllMocks()
+      const map = makeMap()
+      const eventBus = { on: jest.fn(), off: jest.fn(), emit: jest.fn() }
+      const mapProvider = makeProvider()
+      attachAppEvents({ mapProvider, layer: {}, layerType: 'vector', transformRequest: null, events, eventBus, map })
+      const handlerFor = (event) => eventBus.on.mock.calls.find(c => c[0] === event)[1]
+      return { map, mapProvider, handlerFor }
+    }
+
+    it('on MAP_SET_PIXEL_RATIO: calls map.setPixelRatio with the new ratio', () => {
+      const { map, handlerFor } = makeSetup()
+      handlerFor(events.MAP_SET_PIXEL_RATIO)(3)
+      expect(map.setPixelRatio).toHaveBeenCalledWith(3)
+    })
+
+    it('on MAP_SIZE_CHANGE: updates mapProvider.mapSize', () => {
+      const { mapProvider, handlerFor } = makeSetup()
+      handlerFor(events.MAP_SIZE_CHANGE)({ mapSize: 'large' })
+      expect(mapProvider.mapSize).toBe('large')
+    })
+  })
+})

package/providers/beta/openlayers/src/defaults.js

@@ -0,0 +1,36 @@
+// OS Maps API WMTS tile grid for EPSG:27700 — used by the tile source only
+export const TILE_GRID_RESOLUTIONS = [896, 448, 224, 112, 56, 28, 14, 7, 3.5, 1.75, 0.875, 0.4375, 0.21875, 0.109375]
+
+// World (ESRI-derived) LOD resolutions for EPSG:27700. When used in the OL View,
+// view.zoom matches ESRI SDK zoom levels exactly. OL maps between view resolution
+// and the nearest OS tile grid level automatically when loading tiles.
+export const WORLD_LOD_RESOLUTIONS = [
+  156543.03392800014, 78271.51696400007, 39135.758482000034, 19567.879241000017,
+  9783.939620500008, 4891.969810250004, 2445.984905125002, 1222.992452562501,
+  611.4962262812505, 305.74811314062526, 152.87405657031263, 76.43702828515632,
+  38.21851414257816, 19.10925707128908, 9.55462853564454, 4.77731426782227,
+  2.388657133911135, 1.1943285669555674, 0.5971642834777837, 0.29858214173889186,
+  0.14929107086944593, 0.07464553543472296, 0.03732276771736148, 0.01866138385868074
+]
+
+// ESRI LOD 6 (~2446 m/px) matches the ESRI SDK's minimum zoom for EPSG:27700
+export const WORLD_DEFAULT_MIN_ZOOM = 6
+
+// ESRI LOD 20 (~0.149 m/px) is the last level that maps to a unique OS tile (zoom 13).
+// Past this point OL upscales the same zoom-13 tiles with no additional detail.
+export const WORLD_DEFAULT_MAX_ZOOM = 20
+
+// Top-left corner of the OS National Grid extent
+export const TILE_GRID_ORIGIN = [-238375.0, 1376256.0]
+
+export const TILE_SIZE = 256
+
+export const DEFAULTS = {
+  animationDuration: 300,
+  coordinatePrecision: 2
+}
+
+// Zoom level tolerance for min/max checks (fractional zoom)
+export const ZOOM_TOLERANCE = 0.01
+
+export const supportedShortcuts = ['showKeyboardHelp', 'selectControl', 'moveLarge', 'nudgeMap', 'zoomLarge', 'nudgeZoom']

package/providers/beta/openlayers/src/index.js

@@ -0,0 +1,21 @@
+export default function createOpenLayersProvider ({ zoomAlignment } = {}) {
+  return {
+    checkDeviceCapabilities: () => ({
+      isSupported: !!document.createElement('canvas').getContext,
+      error: 'Canvas is not supported in this browser'
+    }),
+    load: async () => {
+      const MapProvider = (await import(/* webpackChunkName: "im-openlayers-provider" */ './openlayersProvider.js')).default
+
+      const mapProviderConfig = {
+        zoomAlignment,
+        crs: 'EPSG:27700'
+      }
+
+      return {
+        MapProvider,
+        mapProviderConfig
+      }
+    }
+  }
+}

package/providers/beta/openlayers/src/mapEvents.js

@@ -0,0 +1,132 @@
+import { debounce } from '../../../../src/utils/debounce.js'
+import { throttle } from '../../../../src/utils/throttle.js'
+import { ZOOM_TOLERANCE } from './defaults.js'
+
+const DEBOUNCE_IDLE_TIME = 500
+const MOVE_THROTTLE_TIME = 10
+const DRAG_TOLERANCE = 6
+
+function attachLoadEvents ({ source, map, emit, eventBus, events, on }) {
+  let loadedEmitted = false
+  on(source, 'tileloadend', () => {
+    if (!loadedEmitted) {
+      loadedEmitted = true
+      eventBus.emit(events.MAP_LOADED)
+    }
+  })
+  map.once('rendercomplete', () => emit(events.MAP_FIRST_IDLE))
+}
+
+function attachMoveEvents ({ map, view, emit, eventBus, events, on, debouncers }) {
+  let moving = false
+
+  const emitMoveEnd = debounce(() => {
+    moving = false
+    emit(events.MAP_MOVE_END)
+  }, DEBOUNCE_IDLE_TIME)
+  debouncers.push(emitMoveEnd)
+
+  const emitMove = throttle(() => emit(events.MAP_MOVE), MOVE_THROTTLE_TIME)
+
+  on(view, 'change', () => {
+    if (!moving) {
+      moving = true
+      eventBus.emit(events.MAP_MOVE_START)
+    }
+    emitMoveEnd()
+  })
+
+  // Drive MAP_MOVE from postrender so resolution reads the actual animated value each frame,
+  // matching MapLibre/ESRI smooth scale bar behaviour
+  on(map, 'postrender', () => {
+    if (moving) {
+      emitMove()
+    }
+  })
+}
+
+function attachClickEvents ({ map, eventBus, events, on }) {
+  let pointerDownPixel = null
+
+  on(map, 'pointerdown', (e) => {
+    pointerDownPixel = e.pixel
+  })
+
+  on(map, 'click', (e) => {
+    if (pointerDownPixel) {
+      const dx = e.pixel[0] - pointerDownPixel[0]
+      const dy = e.pixel[1] - pointerDownPixel[1]
+      if (Math.hypot(dx, dy) > DRAG_TOLERANCE) {
+        return
+      }
+    }
+    eventBus.emit(events.MAP_CLICK, {
+      point: { x: e.pixel[0], y: e.pixel[1] },
+      coords: e.coordinate
+    })
+  })
+}
+
+export function attachMapEvents ({
+  map,
+  source,
+  events,
+  eventBus,
+  getZoom,
+  getCenter,
+  getBounds,
+  getResolution
+}) {
+  let destroyed = false
+  const listeners = []
+  const debouncers = []
+
+  const view = map.getView()
+  const viewMinZoom = view.getMinZoom()
+  const viewMaxZoom = view.getMaxZoom()
+
+  const getMapState = () => {
+    if (destroyed) {
+      return null
+    }
+    const zoom = getZoom()
+    return {
+      center: getCenter(),
+      bounds: getBounds(),
+      resolution: getResolution(),
+      zoom,
+      isAtMaxZoom: zoom + ZOOM_TOLERANCE >= viewMaxZoom,
+      isAtMinZoom: zoom - ZOOM_TOLERANCE <= viewMinZoom
+    }
+  }
+
+  const emit = (name) => {
+    const state = getMapState()
+    if (state) {
+      eventBus.emit(name, state)
+    }
+  }
+
+  const on = (target, type, handler) => {
+    target.on(type, handler)
+    listeners.push([target, type, handler])
+  }
+
+  attachLoadEvents({ source, map, emit, eventBus, events, on })
+  attachMoveEvents({ map, view: map.getView(), emit, eventBus, events, on, debouncers })
+  attachClickEvents({ map, eventBus, events, on })
+
+  on(map, 'postrender', () => eventBus.emit(events.MAP_RENDER))
+
+  const emitDataChange = debounce(() => emit(events.MAP_DATA_CHANGE), DEBOUNCE_IDLE_TIME)
+  debouncers.push(emitDataChange)
+  on(source, 'tileloadend', emitDataChange)
+
+  return {
+    remove () {
+      destroyed = true
+      debouncers.forEach(d => d.cancel())
+      listeners.forEach(([target, type, handler]) => target.un(type, handler))
+    }
+  }
+}

package/providers/beta/openlayers/src/mapEvents.test.js

@@ -0,0 +1,198 @@
+// Non-passthrough debounce: captures fn without calling it so tests can control when it fires
+import { attachMapEvents } from './mapEvents.js'
+
+const mockDebounceFns = []
+
+jest.mock('../../../../src/utils/debounce.js', () => ({
+  __esModule: true,
+  debounce: (fn) => {
+    const wrapper = jest.fn()
+    wrapper.cancel = jest.fn()
+    mockDebounceFns.push({ fn, wrapper })
+    return wrapper
+  }
+}))
+
+// Passthrough throttle: calls fn immediately (no cancel needed, not added to debouncers)
+jest.mock('../../../../src/utils/throttle.js', () => ({
+  __esModule: true,
+  throttle: (fn) => jest.fn(fn)
+}))
+
+const events = {
+  MAP_LOADED: 'map:loaded',
+  MAP_FIRST_IDLE: 'map:firstidle',
+  MAP_MOVE_START: 'map:movestart',
+  MAP_MOVE: 'map:move',
+  MAP_MOVE_END: 'map:moveend',
+  MAP_CLICK: 'map:click',
+  MAP_RENDER: 'map:render',
+  MAP_DATA_CHANGE: 'map:datachange'
+}
+
+function makeTarget () {
+  const handlers = {}
+  return {
+    on: jest.fn((type, handler) => { (handlers[type] = handlers[type] || []).push(handler) }),
+    once: jest.fn((type, handler) => { (handlers[type] = handlers[type] || []).push(handler) }),
+    un: jest.fn(),
+    trigger: (type, event = {}) => (handlers[type] || []).forEach(h => h(event))
+  }
+}
+
+function setup () {
+  mockDebounceFns.length = 0
+
+  const view = makeTarget()
+  view.getMinZoom = jest.fn(() => 0)
+  view.getMaxZoom = jest.fn(() => 13)
+
+  const map = makeTarget()
+  map.getView = jest.fn(() => view)
+
+  const source = makeTarget()
+  source.changed = jest.fn()
+  const eventBus = { emit: jest.fn() }
+
+  const getZoom = jest.fn(() => 7)
+  const getCenter = jest.fn(() => [400000, 300000])
+  const getBounds = jest.fn(() => [0, 0, 800, 600])
+  const getResolution = jest.fn(() => 56)
+
+  const handles = attachMapEvents({ map, source, events, eventBus, getZoom, getCenter, getBounds, getResolution })
+
+  return { map, view, source, eventBus, handles }
+}
+
+describe('attachMapEvents — load events', () => {
+  it('emits MAP_LOADED on first tileloadend', () => {
+    const { source, eventBus } = setup()
+    source.trigger('tileloadend')
+    expect(eventBus.emit).toHaveBeenCalledWith(events.MAP_LOADED)
+  })
+
+  it('does not re-emit MAP_LOADED on subsequent tileloadend', () => {
+    const { source, eventBus } = setup()
+    source.trigger('tileloadend')
+    eventBus.emit.mockClear()
+    source.trigger('tileloadend')
+    expect(eventBus.emit).not.toHaveBeenCalledWith(events.MAP_LOADED)
+  })
+
+  it('emits MAP_FIRST_IDLE on rendercomplete', () => {
+    const { map, eventBus } = setup()
+    map.trigger('rendercomplete')
+    expect(eventBus.emit).toHaveBeenCalledWith(events.MAP_FIRST_IDLE, expect.any(Object))
+  })
+})
+
+describe('attachMapEvents — move events', () => {
+  it('emits MAP_MOVE_START on first view change', () => {
+    const { view, eventBus } = setup()
+    view.trigger('change')
+    expect(eventBus.emit).toHaveBeenCalledWith(events.MAP_MOVE_START)
+  })
+
+  it('does not re-emit MAP_MOVE_START while already moving', () => {
+    const { view, eventBus } = setup()
+    view.trigger('change')
+    eventBus.emit.mockClear()
+    view.trigger('change')
+    expect(eventBus.emit).not.toHaveBeenCalledWith(events.MAP_MOVE_START)
+  })
+
+  it('emits MAP_MOVE_END (with state) when debounced callback fires', () => {
+    const { view, eventBus } = setup()
+    view.trigger('change')
+    mockDebounceFns[0].fn() // emitMoveEnd's inner callback
+    expect(eventBus.emit).toHaveBeenCalledWith(events.MAP_MOVE_END, expect.any(Object))
+  })
+
+  it('resets moving flag after MAP_MOVE_END so MAP_MOVE_START can fire again', () => {
+    const { view, eventBus } = setup()
+    view.trigger('change')
+    mockDebounceFns[0].fn() // resets moving = false
+    eventBus.emit.mockClear()
+    view.trigger('change')
+    expect(eventBus.emit).toHaveBeenCalledWith(events.MAP_MOVE_START)
+  })
+
+  it('emits MAP_MOVE on postrender when moving', () => {
+    const { view, map, eventBus } = setup()
+    view.trigger('change') // sets moving = true (debounce wrapper does not reset it)
+    map.trigger('postrender')
+    expect(eventBus.emit).toHaveBeenCalledWith(events.MAP_MOVE, expect.any(Object))
+  })
+
+  it('does not emit MAP_MOVE on postrender when not moving', () => {
+    const { map, eventBus } = setup()
+    map.trigger('postrender')
+    expect(eventBus.emit).not.toHaveBeenCalledWith(events.MAP_MOVE, expect.anything())
+  })
+})
+
+describe('attachMapEvents — click events', () => {
+  it('emits MAP_CLICK with point and coords on click with no prior pointerdown', () => {
+    const { map, eventBus } = setup()
+    map.trigger('click', { pixel: [100, 200], coordinate: [400000, 300000] })
+    expect(eventBus.emit).toHaveBeenCalledWith(events.MAP_CLICK, {
+      point: { x: 100, y: 200 },
+      coords: [400000, 300000]
+    })
+  })
+
+  it('emits MAP_CLICK when drag distance is within tolerance', () => {
+    const { map, eventBus } = setup()
+    // Math.hypot(4, 3) = 5 < DRAG_TOLERANCE(6)
+    map.trigger('pointerdown', { pixel: [100, 200] })
+    map.trigger('click', { pixel: [104, 203], coordinate: [400000, 300000] })
+    expect(eventBus.emit).toHaveBeenCalledWith(events.MAP_CLICK, expect.any(Object))
+  })
+
+  it('suppresses MAP_CLICK when drag distance exceeds tolerance', () => {
+    const { map, eventBus } = setup()
+    // Math.hypot(7, 0) = 7 > DRAG_TOLERANCE(6)
+    map.trigger('pointerdown', { pixel: [100, 200] })
+    map.trigger('click', { pixel: [107, 200], coordinate: [400000, 300000] })
+    expect(eventBus.emit).not.toHaveBeenCalledWith(events.MAP_CLICK, expect.anything())
+  })
+})
+
+describe('attachMapEvents — render and data events', () => {
+  it('emits MAP_RENDER on every postrender', () => {
+    const { map, eventBus } = setup()
+    map.trigger('postrender')
+    expect(eventBus.emit).toHaveBeenCalledWith(events.MAP_RENDER)
+  })
+
+  it('emits MAP_DATA_CHANGE (with state) when debounced tileloadend callback fires', () => {
+    const { source, eventBus } = setup()
+    source.trigger('tileloadend')
+    mockDebounceFns[1].fn() // emitDataChange's inner callback
+    expect(eventBus.emit).toHaveBeenCalledWith(events.MAP_DATA_CHANGE, expect.any(Object))
+  })
+})
+
+describe('attachMapEvents — remove', () => {
+  it('calls cancel on all debouncers', () => {
+    const { handles } = setup()
+    handles.remove()
+    expect(mockDebounceFns[0].wrapper.cancel).toHaveBeenCalled()
+    expect(mockDebounceFns[1].wrapper.cancel).toHaveBeenCalled()
+  })
+
+  it('calls un on all registered event targets', () => {
+    const { handles, map, view, source } = setup()
+    handles.remove()
+    expect(view.un).toHaveBeenCalled()
+    expect(map.un).toHaveBeenCalled()
+    expect(source.un).toHaveBeenCalled()
+  })
+
+  it('prevents state-bearing events from emitting after destroy', () => {
+    const { eventBus, handles } = setup()
+    handles.remove()
+    mockDebounceFns[0].fn() // emitMoveEnd fires after destroy → getMapState returns null
+    expect(eventBus.emit).not.toHaveBeenCalledWith(events.MAP_MOVE_END, expect.anything())
+  })
+})