@defra/interactive-map 0.0.23-alpha → 0.0.24-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,107));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,50 @@
+import XYZ from 'ol/source/XYZ.js'
+import TileGrid from 'ol/tilegrid/TileGrid.js'
+import TileState from 'ol/TileState.js'
+import { TILE_GRID_RESOLUTIONS, TILE_GRID_ORIGIN, TILE_SIZE } from './defaults.js'
+
+const createTileLoadFunction = (transformRequest) => (tile, src) => {
+  const result = transformRequest(src, 'Tile') || {}
+  const url = result.url || src
+  const headers = result.headers || {}
+  fetch(url, { headers })
+    .then(r => r.blob())
+    .then(blob => { tile.getImage().src = URL.createObjectURL(blob) })
+    .catch(() => tile.setState(TileState.ERROR))
+}
+
+export function createTileSource (url, transformRequest) {
+  const tileGrid = new TileGrid({
+    resolutions: TILE_GRID_RESOLUTIONS,
+    origin: TILE_GRID_ORIGIN,
+    tileSize: TILE_SIZE
+  })
+
+  const tileUrlFunction = ([z, x, y]) => url
+    .replace('{z}', z)
+    .replace('{x}', x)
+    .replace('{y}', y)
+
+  return new XYZ({
+    projection: 'EPSG:27700',
+    tileGrid,
+    tileUrlFunction,
+    tileLoadFunction: transformRequest ? createTileLoadFunction(transformRequest) : undefined
+  })
+}
+
+export function attachAppEvents ({ tileLayer, transformRequest, events, eventBus }) {
+  const handleSetMapStyle = (mapStyle) => {
+    const source = createTileSource(mapStyle.url, transformRequest)
+    tileLayer.setSource(source)
+    eventBus.emit(events.MAP_STYLE_CHANGE, { mapStyleId: mapStyle.id })
+  }
+
+  eventBus.on(events.MAP_SET_STYLE, handleSetMapStyle)
+
+  return {
+    remove () {
+      eventBus.off(events.MAP_SET_STYLE, handleSetMapStyle)
+    }
+  }
+}

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

@@ -0,0 +1,140 @@
+import XYZ from 'ol/source/XYZ.js'
+import TileGrid from 'ol/tilegrid/TileGrid.js'
+import { createTileSource, attachAppEvents } from './appEvents.js'
+import { TILE_GRID_RESOLUTIONS, TILE_GRID_ORIGIN, TILE_SIZE } from './defaults.js'
+
+const mockTileGridInstance = {}
+const mockSourceInstance = {}
+
+jest.mock('ol/source/XYZ.js', () => ({ __esModule: true, default: jest.fn(() => mockSourceInstance) }))
+jest.mock('ol/tilegrid/TileGrid.js', () => ({ __esModule: true, default: jest.fn(() => mockTileGridInstance) }))
+jest.mock('ol/TileState.js', () => ({ __esModule: true, default: { ERROR: 'error' } }))
+
+const flushPromises = () => new Promise(resolve => setTimeout(resolve, 0))
+
+describe('createTileSource', () => {
+  beforeEach(() => jest.clearAllMocks())
+
+  it('creates TileGrid with correct OS tile grid config', () => {
+    createTileSource('https://tiles.example.com/{z}/{x}/{y}', null)
+    expect(TileGrid).toHaveBeenCalledWith({
+      resolutions: TILE_GRID_RESOLUTIONS,
+      origin: TILE_GRID_ORIGIN,
+      tileSize: TILE_SIZE
+    })
+  })
+
+  it('creates XYZ source with EPSG:27700 projection', () => {
+    createTileSource('https://tiles.example.com/{z}/{x}/{y}', null)
+    expect(XYZ).toHaveBeenCalledWith(expect.objectContaining({ projection: 'EPSG:27700' }))
+  })
+
+  it('tileUrlFunction substitutes z, x, y into url template', () => {
+    createTileSource('https://tiles.example.com/{z}/{x}/{y}', null)
+    const { tileUrlFunction } = XYZ.mock.calls[0][0]
+    expect(tileUrlFunction([7, 3, 5])).toBe('https://tiles.example.com/7/3/5')
+  })
+
+  it('does not set tileLoadFunction when transformRequest is null', () => {
+    createTileSource('https://tiles.example.com/{z}/{x}/{y}', null)
+    const { tileLoadFunction } = XYZ.mock.calls[0][0]
+    expect(tileLoadFunction).toBeUndefined()
+  })
+
+  it('sets tileLoadFunction when transformRequest is provided', () => {
+    createTileSource('https://tiles.example.com/{z}/{x}/{y}', jest.fn())
+    const { tileLoadFunction } = XYZ.mock.calls[0][0]
+    expect(typeof tileLoadFunction).toBe('function')
+  })
+})
+
+describe('tileLoadFunction (via transformRequest)', () => {
+  const url = 'https://tiles.example.com/7/3/5'
+  const mockImg = { src: null }
+  const mockTile = { getImage: () => mockImg, setState: jest.fn() }
+
+  beforeEach(() => {
+    jest.clearAllMocks()
+    mockImg.src = null
+    global.URL.createObjectURL = jest.fn(() => 'blob:test')
+    global.fetch = jest.fn().mockResolvedValue({
+      blob: () => Promise.resolve(new Blob())
+    })
+  })
+
+  function getTileLoadFn (transformRequest) {
+    createTileSource('https://tiles.example.com/{z}/{x}/{y}', transformRequest)
+    return XYZ.mock.calls[0][0].tileLoadFunction
+  }
+
+  it('calls transformRequest with src and "Tile" resource type', async () => {
+    const transformRequest = jest.fn(() => null)
+    const fn = getTileLoadFn(transformRequest)
+    fn(mockTile, url)
+    expect(transformRequest).toHaveBeenCalledWith(url, 'Tile')
+  })
+
+  it('uses url and headers from transformRequest result', async () => {
+    const transformRequest = jest.fn(() => ({ url: 'https://proxied.example.com/tile', headers: { Authorization: 'Bearer abc' } }))
+    const fn = getTileLoadFn(transformRequest)
+    fn(mockTile, url)
+    await flushPromises()
+    expect(fetch).toHaveBeenCalledWith('https://proxied.example.com/tile', { headers: { Authorization: 'Bearer abc' } })
+  })
+
+  it('falls back to original src and empty headers when transformRequest returns null', async () => {
+    const fn = getTileLoadFn(() => null)
+    fn(mockTile, url)
+    await flushPromises()
+    expect(fetch).toHaveBeenCalledWith(url, { headers: {} })
+  })
+
+  it('sets tile image src via createObjectURL on success', async () => {
+    const fn = getTileLoadFn(() => null)
+    fn(mockTile, url)
+    await flushPromises()
+    expect(mockImg.src).toBe('blob:test')
+  })
+
+  it('sets tile state to ERROR on fetch failure', async () => {
+    global.fetch = jest.fn().mockRejectedValue(new Error('network error'))
+    const fn = getTileLoadFn(() => null)
+    fn(mockTile, url)
+    await flushPromises()
+    expect(mockTile.setState).toHaveBeenCalledWith('error')
+  })
+})
+
+describe('attachAppEvents', () => {
+  const events = {
+    MAP_SET_STYLE: 'map:setstyle',
+    MAP_STYLE_CHANGE: 'map:stylechange'
+  }
+
+  function makeSetup () {
+    jest.clearAllMocks()
+    const tileLayer = { setSource: jest.fn() }
+    const eventBus = { on: jest.fn(), off: jest.fn(), emit: jest.fn() }
+    const handles = attachAppEvents({ tileLayer, transformRequest: null, events, eventBus })
+    const styleHandler = eventBus.on.mock.calls[0][1]
+    return { tileLayer, eventBus, handles, styleHandler }
+  }
+
+  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: updates tile layer source and emits MAP_STYLE_CHANGE', () => {
+    const { tileLayer, eventBus, styleHandler } = makeSetup()
+    styleHandler({ url: 'https://new.tiles.com/{z}/{x}/{y}', id: 'newStyle' })
+    expect(tileLayer.setSource).toHaveBeenCalledWith(mockSourceInstance)
+    expect(eventBus.emit).toHaveBeenCalledWith(events.MAP_STYLE_CHANGE, { mapStyleId: 'newStyle' })
+  })
+
+  it('remove() unsubscribes from MAP_SET_STYLE', () => {
+    const { eventBus, handles, styleHandler } = makeSetup()
+    handles.remove()
+    expect(eventBus.off).toHaveBeenCalledWith(events.MAP_SET_STYLE, styleHandler)
+  })
+})

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,197 @@
+// 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()
+  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())
+  })
+})