@defra/interactive-map 0.0.31-alpha → 0.0.32-alpha

package/src/InteractiveMap/behaviourController.test.js

@@ -7,7 +7,7 @@ import * as queryString from '../utils/queryString.js'
 import { updateDOMState } from './domStateManager.js'
 
 jest.mock('../utils/queryString.js')
-jest.mock('./domStateManager.js', () => ({ updateDOMState: jest.fn() }))
+jest.mock('./domStateManager.js', () => ({ updateDOMState: jest.fn().mockReturnValue({ isFullscreen: false }) }))
 
 describe('shouldLoadComponent', () => {
   beforeEach(() => {
@@ -67,7 +67,8 @@ describe('setupBehavior', () => {
       loadApp: jest.fn(),
       removeApp: jest.fn(),
       hideApp: jest.fn(),
-      showApp: jest.fn()
+      showApp: jest.fn(),
+      eventBus: { emit: jest.fn() }
     }
     // Default: viewport is wide
     window.matchMedia = jest.fn().mockImplementation(() => ({
@@ -187,14 +188,16 @@ describe('setupBehavior', () => {
       expect(mockMapInstance.showApp).not.toHaveBeenCalled()
     })
 
-    it('calls updateDOMState when map is showing and should load', () => {
+    it('calls updateDOMState and emits APP_FULLSCREEN_CHANGE when map is showing and should load', () => {
       mockMapInstance._isHidden = false
       mockMapInstance._root = {} // has root
       queryString.getQueryParam.mockReturnValue(null)
+      updateDOMState.mockReturnValue({ isFullscreen: false })
 
       handleChange()
 
       expect(updateDOMState).toHaveBeenCalledWith(mockMapInstance)
+      expect(mockMapInstance.eventBus.emit).toHaveBeenCalledWith('app:fullscreenchange', { isFullscreen: false })
       expect(mockMapInstance.loadApp).not.toHaveBeenCalled()
       expect(mockMapInstance.showApp).not.toHaveBeenCalled()
     })

package/src/InteractiveMap/domStateManager.js

@@ -70,6 +70,8 @@ function updateDOMState (mapInstance, { isFullscreen: isFullscreenOverride } = {
     ? 'auto'
     : containerHeight
   rootEl.style.height = isFullscreen ? '100%' : height
+
+  return { isFullscreen }
 }
 
 /**

package/src/config/events.js

@@ -69,11 +69,13 @@ export const EVENTS = {
    * Fired after initial load (`loadApp`) and when the app is shown again after being hidden (`showApp`).
    * Subscribe to this event to react whenever the map becomes visible to the user.
    *
-   * Payload: `{ statePreserved: boolean }` — `true` if the map state was preserved from a previous session.
+   * Payload:
+   * - `statePreserved: boolean` — `true` if the map state was preserved from a previous session.
+   * - `isFullscreen: boolean` — `true` if the map opened in fullscreen mode, `false` if inline.
    *
    * @example
-   * map.on(EVENTS.APP_OPENED, ({ statePreserved }) => {
-   *   console.log('Map opened, state preserved:', statePreserved)
+   * map.on(EVENTS.APP_OPENED, ({ isFullscreen, statePreserved }) => {
+   *   console.log('Map opened, fullscreen:', isFullscreen, 'state preserved:', statePreserved)
    * })
    */
   APP_OPENED: 'app:opened',
@@ -93,6 +95,22 @@ export const EVENTS = {
    */
   APP_CLOSED: 'app:closed',
 
+  /**
+   * Emitted when the map transitions between fullscreen and inline display while already visible.
+   *
+   * Fired during viewport resize in `hybrid` behaviour when the map crosses the fullscreen/inline
+   * threshold without being hidden and re-shown. Use this alongside `app:opened` and `app:closed`
+   * to track the map's display mode across all transitions.
+   *
+   * Payload: `{ isFullscreen: boolean }` — `true` if the map is now fullscreen, `false` if inline.
+   *
+   * @example
+   * map.on(EVENTS.APP_FULLSCREEN_CHANGE, ({ isFullscreen }) => {
+   *   console.log('Display mode changed, fullscreen:', isFullscreen)
+   * })
+   */
+  APP_FULLSCREEN_CHANGE: 'app:fullscreenchange',
+
   /**
    * Emitted when a panel is opened.
    * Payload: { panelId: string }