@accelint/map-toolkit 0.3.1 → 0.4.0

package/dist/map-mode/store.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/map-mode/store.ts"],"names":[],"mappings":"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","file":"store.js","sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { Broadcast } from '@accelint/bus';\nimport { uuid } from '@accelint/core';\nimport { MapModeEvents } from './events';\nimport type { UniqueId } from '@accelint/core';\nimport type { MapModeEventType, ModeChangeDecisionPayload } from './types';\n\nconst DEFAULT_MODE = 'default';\n\n/**\n * Typed event bus instance for map mode events.\n * Provides type-safe event emission and listening for all map mode state changes.\n */\nconst mapModeBus = Broadcast.getInstance<MapModeEventType>();\n\n/**\n * Internal type for tracking pending authorization requests.\n * @internal\n */\ntype PendingRequest = {\n  authId: string;\n  desiredMode: string;\n  currentMode: string;\n  requestOwner: string;\n};\n\n/**\n * Type representing the state for a single map mode instance\n */\ntype MapModeState = {\n  mode: string;\n  modeOwners: Map<string, string>;\n  pendingRequests: Map<string, PendingRequest>;\n};\n\n/**\n * Store for map mode state keyed by instanceId\n */\nconst modeStore = new Map<UniqueId, MapModeState>();\n\n/**\n * Track React component subscribers per instanceId (for fan-out notifications).\n * Each Set contains onStoreChange callbacks from useSyncExternalStore.\n */\nconst componentSubscribers = new Map<UniqueId, Set<() => void>>();\n\n/**\n * Cache of bus unsubscribe functions (1 per instanceId).\n * This ensures we only have one bus listener per map mode instance, regardless of\n * how many React components subscribe to it.\n */\nconst busUnsubscribers = new Map<UniqueId, () => void>();\n\ntype Subscription = (onStoreChange: () => void) => () => void;\n/**\n * Cache of subscription functions per instanceId to avoid recreating on every render\n */\nconst subscriptionCache = new Map<UniqueId, Subscription>();\n\n/**\n * Cache of snapshot functions per instanceId to maintain referential stability\n */\nconst snapshotCache = new Map<UniqueId, () => string>();\n\n/**\n * Cache of requestModeChange functions per instanceId to maintain referential stability\n */\nconst requestModeChangeCache = new Map<\n  UniqueId,\n  (desiredMode: string, requestOwner: string) => void\n>();\n\n/**\n * Get or create mode state for a given instanceId\n */\nfunction getOrCreateState(instanceId: UniqueId): MapModeState {\n  if (!modeStore.has(instanceId)) {\n    modeStore.set(instanceId, {\n      mode: DEFAULT_MODE,\n      modeOwners: new Map(),\n      pendingRequests: new Map(),\n    });\n  }\n  // biome-ignore lint/style/noNonNullAssertion: State guaranteed to exist after has() check above\n  return modeStore.get(instanceId)!;\n}\n\n/**\n * Notify all React subscribers for a given instanceId\n */\nfunction notifySubscribers(instanceId: UniqueId): void {\n  const subscribers = componentSubscribers.get(instanceId);\n  if (subscribers) {\n    for (const onStoreChange of subscribers) {\n      onStoreChange();\n    }\n  }\n}\n\n/**\n * Determine if a mode change request should be auto-accepted without authorization\n */\nfunction shouldAutoAcceptRequest(\n  state: MapModeState,\n  desiredMode: string,\n  requestOwner: string,\n): boolean {\n  const currentModeOwner = state.modeOwners.get(state.mode);\n  const desiredModeOwner = state.modeOwners.get(desiredMode);\n\n  // Owner returning to default mode\n  if (desiredMode === DEFAULT_MODE && requestOwner === currentModeOwner) {\n    return true;\n  }\n\n  // Owner switching between their own modes\n  if (requestOwner === currentModeOwner) {\n    return true;\n  }\n\n  // No ownership conflicts exist\n  if (!(currentModeOwner || desiredModeOwner)) {\n    return true;\n  }\n\n  // Entering an owned mode from default mode\n  if (state.mode === DEFAULT_MODE && requestOwner === desiredModeOwner) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Set mode and emit change event\n */\nfunction setMode(\n  instanceId: UniqueId,\n  state: MapModeState,\n  newMode: string,\n): void {\n  const previousMode = state.mode;\n  state.mode = newMode;\n\n  mapModeBus.emit(MapModeEvents.changed, {\n    previousMode,\n    currentMode: newMode,\n    id: instanceId,\n  });\n\n  notifySubscribers(instanceId);\n}\n\n/**\n * Approve a request and reject all others\n */\nfunction approveRequestAndRejectOthers(\n  instanceId: UniqueId,\n  state: MapModeState,\n  approvedRequest: PendingRequest,\n  excludeAuthId: string,\n  decisionOwner: string,\n  reason: string,\n  emitApproval: boolean,\n): void {\n  // Collect all other pending requests to emit rejections for\n  const requestsToReject: PendingRequest[] = [];\n  for (const request of state.pendingRequests.values()) {\n    if (request.authId !== excludeAuthId) {\n      requestsToReject.push(request);\n    }\n  }\n\n  // Clear all pending requests BEFORE changing mode\n  state.pendingRequests.clear();\n\n  // Change mode\n  setMode(instanceId, state, approvedRequest.desiredMode);\n\n  // Store the new mode's owner (unless it's default mode)\n  if (approvedRequest.desiredMode !== DEFAULT_MODE) {\n    state.modeOwners.set(\n      approvedRequest.desiredMode,\n      approvedRequest.requestOwner,\n    );\n  }\n\n  // Emit approval decision if requested\n  if (emitApproval) {\n    mapModeBus.emit(MapModeEvents.changeDecision, {\n      authId: approvedRequest.authId,\n      approved: true,\n      owner: decisionOwner,\n      reason,\n      id: instanceId,\n    });\n  }\n\n  // Emit rejection events for all other pending requests\n  for (const request of requestsToReject) {\n    mapModeBus.emit(MapModeEvents.changeDecision, {\n      authId: request.authId,\n      approved: false,\n      owner: decisionOwner,\n      reason: 'Request auto-rejected because another request was approved',\n      id: instanceId,\n    });\n  }\n}\n\n/**\n * Handle pending requests when returning to default mode\n */\nfunction handlePendingRequestsOnDefaultMode(\n  instanceId: UniqueId,\n  state: MapModeState,\n  previousMode: string,\n): void {\n  const firstEntry = Array.from(state.pendingRequests.values())[0];\n  if (!firstEntry) {\n    return;\n  }\n\n  const previousModeOwner = state.modeOwners.get(previousMode);\n\n  if (!previousModeOwner) {\n    return;\n  }\n\n  // If the first pending request is for default mode, reject all requests\n  if (firstEntry.desiredMode === DEFAULT_MODE) {\n    const allRequests = Array.from(state.pendingRequests.values());\n    state.pendingRequests.clear();\n\n    for (const request of allRequests) {\n      mapModeBus.emit(MapModeEvents.changeDecision, {\n        authId: request.authId,\n        approved: false,\n        owner: previousModeOwner,\n        reason: 'Request rejected - already in requested mode',\n        id: instanceId,\n      } satisfies ModeChangeDecisionPayload);\n    }\n  } else {\n    // Auto-accept the first pending request for a different mode\n    approveRequestAndRejectOthers(\n      instanceId,\n      state,\n      firstEntry,\n      firstEntry.authId,\n      previousModeOwner,\n      'Auto-accepted when mode owner returned to default',\n      true,\n    );\n  }\n}\n\n/**\n * Handle authorization decision\n *\n * Processes approval/rejection decisions from mode owners. Only the current mode's owner\n * can make authorization decisions. If a decision comes from a non-owner, a warning is\n * logged and the decision is ignored to prevent unauthorized mode changes.\n *\n * @param instanceId - The unique identifier for this map instance\n * @param state - The mode state for this instance\n * @param payload - The authorization decision containing authId, approved status, and owner\n */\nfunction handleAuthorizationDecision(\n  instanceId: UniqueId,\n  state: MapModeState,\n  payload: {\n    approved: boolean;\n    authId: string;\n    owner: string;\n  },\n): void {\n  const { approved, authId, owner: decisionOwner } = payload;\n\n  // Verify decision is from current mode's owner\n  // Logs a warning if unauthorized component attempts to make decisions\n  const currentModeOwner = state.modeOwners.get(state.mode);\n  if (decisionOwner !== currentModeOwner) {\n    console.warn(\n      `[MapMode] Authorization decision from \"${decisionOwner}\" ignored - not the owner of mode \"${state.mode}\" (owner: ${currentModeOwner || 'none'})`,\n    );\n    return;\n  }\n\n  // Find the request with matching authId\n  let matchingRequestOwner: string | null = null;\n  let matchingRequest: PendingRequest | null = null;\n\n  for (const [requestOwner, request] of state.pendingRequests.entries()) {\n    if (request.authId === authId) {\n      matchingRequestOwner = requestOwner;\n      matchingRequest = request;\n      break;\n    }\n  }\n\n  if (!(matchingRequest && matchingRequestOwner)) {\n    return;\n  }\n\n  if (approved) {\n    approveRequestAndRejectOthers(\n      instanceId,\n      state,\n      matchingRequest,\n      authId,\n      decisionOwner,\n      '',\n      false,\n    );\n  } else {\n    state.pendingRequests.delete(matchingRequestOwner);\n  }\n}\n\n/**\n * Handle mode change request logic\n */\nfunction handleModeChangeRequest(\n  instanceId: UniqueId,\n  state: MapModeState,\n  desiredMode: string,\n  requestOwner: string,\n): void {\n  const desiredModeOwner = state.modeOwners.get(desiredMode);\n\n  // Check if this request should be auto-accepted\n  if (shouldAutoAcceptRequest(state, desiredMode, requestOwner)) {\n    setMode(instanceId, state, desiredMode);\n\n    // Store the desired mode's owner unless it's default\n    if (desiredMode !== DEFAULT_MODE && !desiredModeOwner) {\n      state.modeOwners.set(desiredMode, requestOwner);\n    }\n\n    // Clear requester's pending request since mode changed successfully\n    state.pendingRequests.delete(requestOwner);\n    return;\n  }\n\n  // Otherwise, send authorization request\n  const authId = uuid();\n\n  state.pendingRequests.set(requestOwner, {\n    authId,\n    desiredMode,\n    currentMode: state.mode,\n    requestOwner,\n  });\n\n  mapModeBus.emit(MapModeEvents.changeAuthorization, {\n    authId,\n    desiredMode,\n    currentMode: state.mode,\n    id: instanceId,\n  });\n}\n\n/**\n * Ensures a single bus listener exists for the given instanceId.\n * All React subscribers will be notified via fan-out when the bus events fire.\n * This prevents creating N bus listeners for N React components.\n *\n * @param instanceId - The unique identifier for the map mode instance\n */\nfunction ensureBusListener(instanceId: UniqueId): void {\n  if (busUnsubscribers.has(instanceId)) {\n    return; // Already listening\n  }\n\n  const state = getOrCreateState(instanceId);\n\n  // Listen for mode change requests\n  const unsubRequest = mapModeBus.on(MapModeEvents.changeRequest, (event) => {\n    const { desiredMode, owner: requestOwner, id } = event.payload;\n\n    // Filter: only handle if targeted at this map\n    if (id !== instanceId || desiredMode === state.mode) {\n      return;\n    }\n\n    handleModeChangeRequest(instanceId, state, desiredMode, requestOwner);\n  });\n\n  // Listen for authorization decisions\n  const unsubDecision = mapModeBus.on(MapModeEvents.changeDecision, (event) => {\n    const { id, approved, authId, owner } = event.payload;\n\n    // Filter: only handle if targeted at this map\n    if (id !== instanceId) {\n      return;\n    }\n\n    handleAuthorizationDecision(instanceId, state, { approved, authId, owner });\n  });\n\n  // Listen for mode changes to handle pending requests\n  const unsubChanged = mapModeBus.on(MapModeEvents.changed, (event) => {\n    const { currentMode, previousMode, id } = event.payload;\n\n    // Filter: only handle if targeted at this map\n    if (id !== instanceId) {\n      return;\n    }\n\n    // When mode owner changes to default mode, handle pending requests\n    if (currentMode === DEFAULT_MODE && state.pendingRequests.size > 0) {\n      handlePendingRequestsOnDefaultMode(instanceId, state, previousMode);\n    }\n  });\n\n  // Store composite cleanup function\n  busUnsubscribers.set(instanceId, () => {\n    unsubRequest();\n    unsubDecision();\n    unsubChanged();\n  });\n}\n\n/**\n * Cleans up the bus listener if no React subscribers remain.\n *\n * @param instanceId - The unique identifier for the map mode instance\n */\nfunction cleanupBusListenerIfNeeded(instanceId: UniqueId): void {\n  const subscribers = componentSubscribers.get(instanceId);\n\n  if (!subscribers || subscribers.size === 0) {\n    // No more React subscribers - clean up bus listener\n    const unsub = busUnsubscribers.get(instanceId);\n    if (unsub) {\n      unsub();\n      busUnsubscribers.delete(instanceId);\n    }\n\n    // Clean up all state\n    modeStore.delete(instanceId);\n    componentSubscribers.delete(instanceId);\n    subscriptionCache.delete(instanceId);\n    snapshotCache.delete(instanceId);\n    requestModeChangeCache.delete(instanceId);\n  }\n}\n\n/**\n * Creates or retrieves a cached subscription function for a given instanceId.\n * Uses a fan-out pattern: 1 bus listener -> N React subscribers.\n * Automatically cleans up map mode state when the last subscriber unsubscribes.\n *\n * @param instanceId - The unique identifier for the map mode instance\n * @returns A subscription function for useSyncExternalStore\n */\nexport function getOrCreateSubscription(\n  instanceId: UniqueId,\n): (onStoreChange: () => void) => () => void {\n  const subscription =\n    subscriptionCache.get(instanceId) ??\n    ((onStoreChange: () => void) => {\n      // Ensure state exists\n      getOrCreateState(instanceId);\n\n      // Ensure single bus listener exists for this instanceId\n      ensureBusListener(instanceId);\n\n      // Get or create the subscriber set for this map instance, then add this component's callback\n      let subscriberSet = componentSubscribers.get(instanceId);\n      if (!subscriberSet) {\n        subscriberSet = new Set();\n        componentSubscribers.set(instanceId, subscriberSet);\n      }\n      subscriberSet.add(onStoreChange);\n\n      // Return cleanup function to remove this component's subscription\n      return () => {\n        const currentSubscriberSet = componentSubscribers.get(instanceId);\n        if (currentSubscriberSet) {\n          currentSubscriberSet.delete(onStoreChange);\n        }\n\n        // Clean up bus listener if this was the last React subscriber\n        cleanupBusListenerIfNeeded(instanceId);\n      };\n    });\n\n  subscriptionCache.set(instanceId, subscription);\n\n  return subscription;\n}\n\n/**\n * Creates or retrieves a cached snapshot function for a given instanceId.\n * The string returned gets equality checked, so it needs to be stable or React re-renders unnecessarily.\n *\n * @param instanceId - The unique identifier for the map mode instance\n * @returns A snapshot function for useSyncExternalStore\n */\nexport function getOrCreateSnapshot(instanceId: UniqueId): () => string {\n  const snapshot =\n    snapshotCache.get(instanceId) ??\n    (() => {\n      const state = modeStore.get(instanceId);\n      if (!state) {\n        return DEFAULT_MODE;\n      }\n      return state.mode;\n    });\n\n  snapshotCache.set(instanceId, snapshot);\n\n  return snapshot;\n}\n\n/**\n * Creates or retrieves a cached requestModeChange function for a given instanceId.\n * This maintains referential stability for the function reference.\n *\n * @param instanceId - The unique identifier for the map mode instance\n * @returns A requestModeChange function for this instance\n */\nexport function getOrCreateRequestModeChange(\n  instanceId: UniqueId,\n): (desiredMode: string, requestOwner: string) => void {\n  const requestModeChange =\n    requestModeChangeCache.get(instanceId) ??\n    ((desiredMode: string, requestOwner: string) => {\n      const trimmedDesiredMode = desiredMode.trim();\n      const trimmedRequestOwner = requestOwner.trim();\n\n      if (!trimmedDesiredMode) {\n        throw new Error('requestModeChange requires non-empty desiredMode');\n      }\n      if (!trimmedRequestOwner) {\n        throw new Error('requestModeChange requires non-empty requestOwner');\n      }\n\n      mapModeBus.emit(MapModeEvents.changeRequest, {\n        desiredMode: trimmedDesiredMode,\n        owner: trimmedRequestOwner,\n        id: instanceId,\n      });\n    });\n\n  requestModeChangeCache.set(instanceId, requestModeChange);\n\n  return requestModeChange;\n}\n\n/**\n * Get the owner of the current mode for a given map instance\n * @internal - For internal map-toolkit use only\n */\nexport function getCurrentModeOwner(instanceId: UniqueId): string | undefined {\n  const state = modeStore.get(instanceId);\n  if (!state) {\n    return undefined;\n  }\n  return state.modeOwners.get(state.mode);\n}\n\n/**\n * Manually clear map mode state for a specific instanceId.\n * This is typically not needed as cleanup happens automatically when all subscribers unmount.\n * Use this only in advanced scenarios where manual cleanup is required.\n *\n * @param instanceId - The unique identifier for the map mode instance to clear\n *\n * @example\n * ```tsx\n * // Manual cleanup (rarely needed)\n * clearMapModeState('my-map-instance');\n * ```\n */\nexport function clearMapModeState(instanceId: UniqueId): void {\n  // Unsubscribe from bus if listening\n  const unsub = busUnsubscribers.get(instanceId);\n  if (unsub) {\n    unsub();\n    busUnsubscribers.delete(instanceId);\n  }\n\n  // Clear all state\n  modeStore.delete(instanceId);\n  componentSubscribers.delete(instanceId);\n  subscriptionCache.delete(instanceId);\n  snapshotCache.delete(instanceId);\n  requestModeChangeCache.delete(instanceId);\n}\n"]}
+{"version":3,"file":"store.js","names":["requestsToReject: PendingRequest[]","matchingRequestOwner: string | null","matchingRequest: PendingRequest | null"],"sources":["../../src/map-mode/store.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { Broadcast } from '@accelint/bus';\nimport { uuid } from '@accelint/core';\nimport { MapModeEvents } from './events';\nimport type { UniqueId } from '@accelint/core';\nimport type { MapModeEventType, ModeChangeDecisionPayload } from './types';\n\nconst DEFAULT_MODE = 'default';\n\n/**\n * Typed event bus instance for map mode events.\n * Provides type-safe event emission and listening for all map mode state changes.\n */\nconst mapModeBus = Broadcast.getInstance<MapModeEventType>();\n\n/**\n * Internal type for tracking pending authorization requests.\n * @internal\n */\ntype PendingRequest = {\n  authId: string;\n  desiredMode: string;\n  currentMode: string;\n  requestOwner: string;\n};\n\n/**\n * Type representing the state for a single map mode instance\n */\ntype MapModeState = {\n  mode: string;\n  modeOwners: Map<string, string>;\n  pendingRequests: Map<string, PendingRequest>;\n};\n\n/**\n * Store for map mode state keyed by instanceId\n */\nconst modeStore = new Map<UniqueId, MapModeState>();\n\n/**\n * Track React component subscribers per instanceId (for fan-out notifications).\n * Each Set contains onStoreChange callbacks from useSyncExternalStore.\n */\nconst componentSubscribers = new Map<UniqueId, Set<() => void>>();\n\n/**\n * Cache of bus unsubscribe functions (1 per instanceId).\n * This ensures we only have one bus listener per map mode instance, regardless of\n * how many React components subscribe to it.\n */\nconst busUnsubscribers = new Map<UniqueId, () => void>();\n\ntype Subscription = (onStoreChange: () => void) => () => void;\n/**\n * Cache of subscription functions per instanceId to avoid recreating on every render\n */\nconst subscriptionCache = new Map<UniqueId, Subscription>();\n\n/**\n * Cache of snapshot functions per instanceId to maintain referential stability\n */\nconst snapshotCache = new Map<UniqueId, () => string>();\n\n/**\n * Cache of server snapshot functions per instanceId to maintain referential stability.\n * Server snapshots always return default mode since mode state is client-only.\n */\nconst serverSnapshotCache = new Map<UniqueId, () => string>();\n\n/**\n * Cache of requestModeChange functions per instanceId to maintain referential stability\n */\nconst requestModeChangeCache = new Map<\n  UniqueId,\n  (desiredMode: string, requestOwner: string) => void\n>();\n\n/**\n * Get or create mode state for a given instanceId\n */\nfunction getOrCreateState(instanceId: UniqueId): MapModeState {\n  if (!modeStore.has(instanceId)) {\n    modeStore.set(instanceId, {\n      mode: DEFAULT_MODE,\n      modeOwners: new Map(),\n      pendingRequests: new Map(),\n    });\n  }\n  // biome-ignore lint/style/noNonNullAssertion: State guaranteed to exist after has() check above\n  return modeStore.get(instanceId)!;\n}\n\n/**\n * Notify all React subscribers for a given instanceId\n */\nfunction notifySubscribers(instanceId: UniqueId): void {\n  const subscribers = componentSubscribers.get(instanceId);\n  if (subscribers) {\n    for (const onStoreChange of subscribers) {\n      onStoreChange();\n    }\n  }\n}\n\n/**\n * Determine if a mode change request should be auto-accepted without authorization\n */\nfunction shouldAutoAcceptRequest(\n  state: MapModeState,\n  desiredMode: string,\n  requestOwner: string,\n): boolean {\n  const currentModeOwner = state.modeOwners.get(state.mode);\n  const desiredModeOwner = state.modeOwners.get(desiredMode);\n\n  // Owner returning to default mode\n  if (desiredMode === DEFAULT_MODE && requestOwner === currentModeOwner) {\n    return true;\n  }\n\n  // Owner switching between their own modes\n  if (requestOwner === currentModeOwner) {\n    return true;\n  }\n\n  // No ownership conflicts exist\n  if (!(currentModeOwner || desiredModeOwner)) {\n    return true;\n  }\n\n  // Entering an owned mode from default mode\n  if (state.mode === DEFAULT_MODE && requestOwner === desiredModeOwner) {\n    return true;\n  }\n\n  return false;\n}\n\n/**\n * Set mode and emit change event\n */\nfunction setMode(\n  instanceId: UniqueId,\n  state: MapModeState,\n  newMode: string,\n): void {\n  const previousMode = state.mode;\n  state.mode = newMode;\n\n  mapModeBus.emit(MapModeEvents.changed, {\n    previousMode,\n    currentMode: newMode,\n    id: instanceId,\n  });\n\n  notifySubscribers(instanceId);\n}\n\n/**\n * Approve a request and reject all others\n */\nfunction approveRequestAndRejectOthers(\n  instanceId: UniqueId,\n  state: MapModeState,\n  approvedRequest: PendingRequest,\n  excludeAuthId: string,\n  decisionOwner: string,\n  reason: string,\n  emitApproval: boolean,\n): void {\n  // Collect all other pending requests to emit rejections for\n  const requestsToReject: PendingRequest[] = [];\n  for (const request of state.pendingRequests.values()) {\n    if (request.authId !== excludeAuthId) {\n      requestsToReject.push(request);\n    }\n  }\n\n  // Clear all pending requests BEFORE changing mode\n  state.pendingRequests.clear();\n\n  // Change mode\n  setMode(instanceId, state, approvedRequest.desiredMode);\n\n  // Store the new mode's owner (unless it's default mode)\n  if (approvedRequest.desiredMode !== DEFAULT_MODE) {\n    state.modeOwners.set(\n      approvedRequest.desiredMode,\n      approvedRequest.requestOwner,\n    );\n  }\n\n  // Emit approval decision if requested\n  if (emitApproval) {\n    mapModeBus.emit(MapModeEvents.changeDecision, {\n      authId: approvedRequest.authId,\n      approved: true,\n      owner: decisionOwner,\n      reason,\n      id: instanceId,\n    });\n  }\n\n  // Emit rejection events for all other pending requests\n  for (const request of requestsToReject) {\n    mapModeBus.emit(MapModeEvents.changeDecision, {\n      authId: request.authId,\n      approved: false,\n      owner: decisionOwner,\n      reason: 'Request auto-rejected because another request was approved',\n      id: instanceId,\n    });\n  }\n}\n\n/**\n * Handle pending requests when returning to default mode\n */\nfunction handlePendingRequestsOnDefaultMode(\n  instanceId: UniqueId,\n  state: MapModeState,\n  previousMode: string,\n): void {\n  const firstEntry = Array.from(state.pendingRequests.values())[0];\n  if (!firstEntry) {\n    return;\n  }\n\n  const previousModeOwner = state.modeOwners.get(previousMode);\n\n  if (!previousModeOwner) {\n    return;\n  }\n\n  // If the first pending request is for default mode, reject all requests\n  if (firstEntry.desiredMode === DEFAULT_MODE) {\n    const allRequests = Array.from(state.pendingRequests.values());\n    state.pendingRequests.clear();\n\n    for (const request of allRequests) {\n      mapModeBus.emit(MapModeEvents.changeDecision, {\n        authId: request.authId,\n        approved: false,\n        owner: previousModeOwner,\n        reason: 'Request rejected - already in requested mode',\n        id: instanceId,\n      } satisfies ModeChangeDecisionPayload);\n    }\n  } else {\n    // Auto-accept the first pending request for a different mode\n    approveRequestAndRejectOthers(\n      instanceId,\n      state,\n      firstEntry,\n      firstEntry.authId,\n      previousModeOwner,\n      'Auto-accepted when mode owner returned to default',\n      true,\n    );\n  }\n}\n\n/**\n * Handle authorization decision\n *\n * Processes approval/rejection decisions from mode owners. Only the current mode's owner\n * can make authorization decisions. If a decision comes from a non-owner, a warning is\n * logged and the decision is ignored to prevent unauthorized mode changes.\n *\n * @param instanceId - The unique identifier for this map instance\n * @param state - The mode state for this instance\n * @param payload - The authorization decision containing authId, approved status, and owner\n */\nfunction handleAuthorizationDecision(\n  instanceId: UniqueId,\n  state: MapModeState,\n  payload: {\n    approved: boolean;\n    authId: string;\n    owner: string;\n  },\n): void {\n  const { approved, authId, owner: decisionOwner } = payload;\n\n  // Verify decision is from current mode's owner\n  // Logs a warning if unauthorized component attempts to make decisions\n  const currentModeOwner = state.modeOwners.get(state.mode);\n  if (decisionOwner !== currentModeOwner) {\n    console.warn(\n      `[MapMode] Authorization decision from \"${decisionOwner}\" ignored - not the owner of mode \"${state.mode}\" (owner: ${currentModeOwner || 'none'})`,\n    );\n    return;\n  }\n\n  // Find the request with matching authId\n  let matchingRequestOwner: string | null = null;\n  let matchingRequest: PendingRequest | null = null;\n\n  for (const [requestOwner, request] of state.pendingRequests.entries()) {\n    if (request.authId === authId) {\n      matchingRequestOwner = requestOwner;\n      matchingRequest = request;\n      break;\n    }\n  }\n\n  if (!(matchingRequest && matchingRequestOwner)) {\n    return;\n  }\n\n  if (approved) {\n    approveRequestAndRejectOthers(\n      instanceId,\n      state,\n      matchingRequest,\n      authId,\n      decisionOwner,\n      '',\n      false,\n    );\n  } else {\n    state.pendingRequests.delete(matchingRequestOwner);\n  }\n}\n\n/**\n * Handle mode change request logic\n */\nfunction handleModeChangeRequest(\n  instanceId: UniqueId,\n  state: MapModeState,\n  desiredMode: string,\n  requestOwner: string,\n): void {\n  const desiredModeOwner = state.modeOwners.get(desiredMode);\n\n  // Check if this request should be auto-accepted\n  if (shouldAutoAcceptRequest(state, desiredMode, requestOwner)) {\n    setMode(instanceId, state, desiredMode);\n\n    // Store the desired mode's owner unless it's default\n    if (desiredMode !== DEFAULT_MODE && !desiredModeOwner) {\n      state.modeOwners.set(desiredMode, requestOwner);\n    }\n\n    // Clear requester's pending request since mode changed successfully\n    state.pendingRequests.delete(requestOwner);\n    return;\n  }\n\n  // Otherwise, send authorization request\n  const authId = uuid();\n\n  state.pendingRequests.set(requestOwner, {\n    authId,\n    desiredMode,\n    currentMode: state.mode,\n    requestOwner,\n  });\n\n  mapModeBus.emit(MapModeEvents.changeAuthorization, {\n    authId,\n    desiredMode,\n    currentMode: state.mode,\n    id: instanceId,\n  });\n}\n\n/**\n * Ensures a single bus listener exists for the given instanceId.\n * All React subscribers will be notified via fan-out when the bus events fire.\n * This prevents creating N bus listeners for N React components.\n *\n * @param instanceId - The unique identifier for the map mode instance\n */\nfunction ensureBusListener(instanceId: UniqueId): void {\n  if (busUnsubscribers.has(instanceId)) {\n    return; // Already listening\n  }\n\n  const state = getOrCreateState(instanceId);\n\n  // Listen for mode change requests\n  const unsubRequest = mapModeBus.on(MapModeEvents.changeRequest, (event) => {\n    const { desiredMode, owner: requestOwner, id } = event.payload;\n\n    // Filter: only handle if targeted at this map\n    if (id !== instanceId || desiredMode === state.mode) {\n      return;\n    }\n\n    handleModeChangeRequest(instanceId, state, desiredMode, requestOwner);\n  });\n\n  // Listen for authorization decisions\n  const unsubDecision = mapModeBus.on(MapModeEvents.changeDecision, (event) => {\n    const { id, approved, authId, owner } = event.payload;\n\n    // Filter: only handle if targeted at this map\n    if (id !== instanceId) {\n      return;\n    }\n\n    handleAuthorizationDecision(instanceId, state, { approved, authId, owner });\n  });\n\n  // Listen for mode changes to handle pending requests\n  const unsubChanged = mapModeBus.on(MapModeEvents.changed, (event) => {\n    const { currentMode, previousMode, id } = event.payload;\n\n    // Filter: only handle if targeted at this map\n    if (id !== instanceId) {\n      return;\n    }\n\n    // When mode owner changes to default mode, handle pending requests\n    if (currentMode === DEFAULT_MODE && state.pendingRequests.size > 0) {\n      handlePendingRequestsOnDefaultMode(instanceId, state, previousMode);\n    }\n  });\n\n  // Store composite cleanup function\n  busUnsubscribers.set(instanceId, () => {\n    unsubRequest();\n    unsubDecision();\n    unsubChanged();\n  });\n}\n\n/**\n * Cleans up the bus listener if no React subscribers remain.\n *\n * @param instanceId - The unique identifier for the map mode instance\n */\nfunction cleanupBusListenerIfNeeded(instanceId: UniqueId): void {\n  const subscribers = componentSubscribers.get(instanceId);\n\n  if (!subscribers || subscribers.size === 0) {\n    // No more React subscribers - clean up bus listener\n    const unsub = busUnsubscribers.get(instanceId);\n    if (unsub) {\n      unsub();\n      busUnsubscribers.delete(instanceId);\n    }\n\n    // Clean up all state\n    modeStore.delete(instanceId);\n    componentSubscribers.delete(instanceId);\n    subscriptionCache.delete(instanceId);\n    snapshotCache.delete(instanceId);\n    serverSnapshotCache.delete(instanceId);\n    requestModeChangeCache.delete(instanceId);\n  }\n}\n\n/**\n * Creates or retrieves a cached subscription function for a given instanceId.\n * Uses a fan-out pattern: 1 bus listener -> N React subscribers.\n * Automatically cleans up map mode state when the last subscriber unsubscribes.\n *\n * @param instanceId - The unique identifier for the map mode instance\n * @returns A subscription function for useSyncExternalStore\n */\nexport function getOrCreateSubscription(\n  instanceId: UniqueId,\n): (onStoreChange: () => void) => () => void {\n  const subscription =\n    subscriptionCache.get(instanceId) ??\n    ((onStoreChange: () => void) => {\n      // Ensure state exists\n      getOrCreateState(instanceId);\n\n      // Ensure single bus listener exists for this instanceId\n      ensureBusListener(instanceId);\n\n      // Get or create the subscriber set for this map instance, then add this component's callback\n      let subscriberSet = componentSubscribers.get(instanceId);\n      if (!subscriberSet) {\n        subscriberSet = new Set();\n        componentSubscribers.set(instanceId, subscriberSet);\n      }\n      subscriberSet.add(onStoreChange);\n\n      // Return cleanup function to remove this component's subscription\n      return () => {\n        const currentSubscriberSet = componentSubscribers.get(instanceId);\n        if (currentSubscriberSet) {\n          currentSubscriberSet.delete(onStoreChange);\n        }\n\n        // Clean up bus listener if this was the last React subscriber\n        cleanupBusListenerIfNeeded(instanceId);\n      };\n    });\n\n  subscriptionCache.set(instanceId, subscription);\n\n  return subscription;\n}\n\n/**\n * Creates or retrieves a cached snapshot function for a given instanceId.\n * The string returned gets equality checked, so it needs to be stable or React re-renders unnecessarily.\n *\n * @param instanceId - The unique identifier for the map mode instance\n * @returns A snapshot function for useSyncExternalStore\n */\nexport function getOrCreateSnapshot(instanceId: UniqueId): () => string {\n  const snapshot =\n    snapshotCache.get(instanceId) ??\n    (() => {\n      const state = modeStore.get(instanceId);\n      if (!state) {\n        return DEFAULT_MODE;\n      }\n      return state.mode;\n    });\n\n  snapshotCache.set(instanceId, snapshot);\n\n  return snapshot;\n}\n\n/**\n * Creates or retrieves a cached server snapshot function for a given instanceId.\n * Server snapshots always return the default mode since mode state is client-only.\n * Required for SSR/RSC compatibility with useSyncExternalStore.\n *\n * @param instanceId - The unique identifier for the map mode instance\n * @returns A server snapshot function for useSyncExternalStore\n */\nexport function getOrCreateServerSnapshot(instanceId: UniqueId): () => string {\n  const serverSnapshot =\n    serverSnapshotCache.get(instanceId) ?? (() => DEFAULT_MODE);\n\n  serverSnapshotCache.set(instanceId, serverSnapshot);\n\n  return serverSnapshot;\n}\n\n/**\n * Creates or retrieves a cached requestModeChange function for a given instanceId.\n * This maintains referential stability for the function reference.\n *\n * @param instanceId - The unique identifier for the map mode instance\n * @returns A requestModeChange function for this instance\n */\nexport function getOrCreateRequestModeChange(\n  instanceId: UniqueId,\n): (desiredMode: string, requestOwner: string) => void {\n  const requestModeChange =\n    requestModeChangeCache.get(instanceId) ??\n    ((desiredMode: string, requestOwner: string) => {\n      const trimmedDesiredMode = desiredMode.trim();\n      const trimmedRequestOwner = requestOwner.trim();\n\n      if (!trimmedDesiredMode) {\n        throw new Error('requestModeChange requires non-empty desiredMode');\n      }\n      if (!trimmedRequestOwner) {\n        throw new Error('requestModeChange requires non-empty requestOwner');\n      }\n\n      mapModeBus.emit(MapModeEvents.changeRequest, {\n        desiredMode: trimmedDesiredMode,\n        owner: trimmedRequestOwner,\n        id: instanceId,\n      });\n    });\n\n  requestModeChangeCache.set(instanceId, requestModeChange);\n\n  return requestModeChange;\n}\n\n/**\n * Get the owner of the current mode for a given map instance\n * @internal - For internal map-toolkit use only\n */\nexport function getCurrentModeOwner(instanceId: UniqueId): string | undefined {\n  const state = modeStore.get(instanceId);\n  if (!state) {\n    return undefined;\n  }\n  return state.modeOwners.get(state.mode);\n}\n\n/**\n * Manually clear map mode state for a specific instanceId.\n * This is typically not needed as cleanup happens automatically when all subscribers unmount.\n * Use this only in advanced scenarios where manual cleanup is required.\n *\n * @param instanceId - The unique identifier for the map mode instance to clear\n *\n * @example\n * ```tsx\n * // Manual cleanup (rarely needed)\n * clearMapModeState('my-map-instance');\n * ```\n */\nexport function clearMapModeState(instanceId: UniqueId): void {\n  // Unsubscribe from bus if listening\n  const unsub = busUnsubscribers.get(instanceId);\n  if (unsub) {\n    unsub();\n    busUnsubscribers.delete(instanceId);\n  }\n\n  // Clear all state\n  modeStore.delete(instanceId);\n  componentSubscribers.delete(instanceId);\n  subscriptionCache.delete(instanceId);\n  snapshotCache.delete(instanceId);\n  serverSnapshotCache.delete(instanceId);\n  requestModeChangeCache.delete(instanceId);\n}\n"],"mappings":"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"}

package/dist/map-mode/types.d.ts

@@ -1,59 +1,72 @@
-import { Payload } from '@accelint/bus';
-import { UniqueId } from '@accelint/core';
-import { MapModeEvents } from './events.js';
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { MapModeEvents } from "./events.js";
+import { Payload } from "@accelint/bus";
+import { UniqueId } from "@accelint/core";
 
+//#region src/map-mode/types.d.ts
 /**
  * Payload emitted when the map mode has successfully changed.
  */
 type ModeChangedPayload = {
-    /** The mode before the change */
-    previousMode: string;
-    /** The mode after the change */
-    currentMode: string;
-    /** The ID of the map this event is for */
-    id: UniqueId;
+  /** The mode before the change */
+  previousMode: string;
+  /** The mode after the change */
+  currentMode: string;
+  /** The ID of the map this event is for */
+  id: UniqueId;
 };
 /**
  * Payload for requesting a map mode change.
  * This initiates the mode change flow.
  */
 type ModeChangeRequestPayload = {
-    /** The mode being requested */
-    desiredMode: string;
-    /** The identifier of the component requesting the mode change */
-    owner: string;
-    /** The ID of the map this event is for */
-    id: UniqueId;
+  /** The mode being requested */
+  desiredMode: string;
+  /** The identifier of the component requesting the mode change */
+  owner: string;
+  /** The ID of the map this event is for */
+  id: UniqueId;
 };
 /**
  * Payload emitted when a mode change requires authorization.
  * This is sent to the current mode owner to approve or reject the request.
  */
 type ModeChangeAuthorizationPayload = {
-    /** Unique identifier for this authorization request */
-    authId: string;
-    /** The mode being requested */
-    desiredMode: string;
-    /** The current active mode */
-    currentMode: string;
-    /** The ID of the map this event is for */
-    id: UniqueId;
+  /** Unique identifier for this authorization request */
+  authId: string;
+  /** The mode being requested */
+  desiredMode: string;
+  /** The current active mode */
+  currentMode: string;
+  /** The ID of the map this event is for */
+  id: UniqueId;
 };
 /**
  * Payload for an authorization decision from the current mode owner.
  * This completes the authorization flow.
  */
 type ModeChangeDecisionPayload = {
-    /** The authId from the corresponding authorization request */
-    authId: string;
-    /** Whether the mode change was approved */
-    approved: boolean;
-    /** The identifier of the component making the decision (must be current mode owner) */
-    owner: string;
-    /** Optional reason for rejection */
-    reason?: string;
-    /** The ID of the map this event is for */
-    id: UniqueId;
+  /** The authId from the corresponding authorization request */
+  authId: string;
+  /** Whether the mode change was approved */
+  approved: boolean;
+  /** The identifier of the component making the decision (must be current mode owner) */
+  owner: string;
+  /** Optional reason for rejection */
+  reason?: string;
+  /** The ID of the map this event is for */
+  id: UniqueId;
 };
 /**
  * Event type for mode change notifications.
@@ -79,5 +92,6 @@ type ModeChangeDecisionEvent = Payload<typeof MapModeEvents.changeDecision, Mode
  * Union type of all map mode event types that can be emitted through the event bus.
  */
 type MapModeEventType = ModeChangedEvent | ModeChangeRequestEvent | ModeChangeAuthorizationEvent | ModeChangeDecisionEvent;
-
-export type { MapModeEventType, ModeChangeAuthorizationEvent, ModeChangeAuthorizationPayload, ModeChangeDecisionEvent, ModeChangeDecisionPayload, ModeChangeRequestEvent, ModeChangeRequestPayload, ModeChangedEvent, ModeChangedPayload };
+//#endregion
+export { MapModeEventType, ModeChangeAuthorizationEvent, ModeChangeAuthorizationPayload, ModeChangeDecisionEvent, ModeChangeDecisionPayload, ModeChangeRequestEvent, ModeChangeRequestPayload, ModeChangedEvent, ModeChangedPayload };
+//# sourceMappingURL=types.d.ts.map

package/dist/map-mode/types.js

@@ -1,3 +1,12 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
 
-//# sourceMappingURL=types.js.map
-//# sourceMappingURL=types.js.map

package/dist/map-mode/use-map-mode.d.ts

@@ -1,13 +1,26 @@
-import { UniqueId } from '@accelint/core';
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
 
+import { UniqueId } from "@accelint/core";
+
+//#region src/map-mode/use-map-mode.d.ts
 /**
  * Return value for the useMapMode hook
  */
 type UseMapModeReturn = {
-    /** The current active map mode */
-    mode: string;
-    /** Function to request a mode change with ownership */
-    requestModeChange: (desiredMode: string, requestOwner: string) => void;
+  /** The current active map mode */
+  mode: string;
+  /** Function to request a mode change with ownership */
+  requestModeChange: (desiredMode: string, requestOwner: string) => void;
 };
 /**
  * Hook to access the map mode state and actions.
@@ -48,5 +61,6 @@ type UseMapModeReturn = {
  * ```
  */
 declare function useMapMode(id?: UniqueId): UseMapModeReturn;
-
-export { type UseMapModeReturn, useMapMode };
+//#endregion
+export { UseMapModeReturn, useMapMode };
+//# sourceMappingURL=use-map-mode.d.ts.map

package/dist/map-mode/use-map-mode.js

@@ -1,29 +1,72 @@
-import 'client-only';
-import { useContext, useSyncExternalStore, useMemo } from 'react';
-import { MapContext } from '../deckgl/base-map/provider.js';
-import { getOrCreateSubscription, getOrCreateSnapshot, getOrCreateRequestModeChange } from './store.js';
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
 
+
+'use client';
+
+import { getOrCreateRequestModeChange, getOrCreateServerSnapshot, getOrCreateSnapshot, getOrCreateSubscription } from "./store.js";
+import { MapContext } from "../deckgl/base-map/provider.js";
+import { useContext, useMemo, useSyncExternalStore } from "react";
+
+//#region src/map-mode/use-map-mode.ts
+/**
+* Hook to access the map mode state and actions.
+*
+* This hook uses `useSyncExternalStore` to subscribe to map mode state changes,
+* providing concurrent-safe mode state updates. Uses a fan-out pattern where
+* a single bus listener per map instance notifies N React component subscribers.
+*
+* @param id - Optional map instance ID. If not provided, will use the ID from `MapContext`.
+* @returns The current map mode and requestModeChange function
+* @throws Error if no `id` is provided and hook is used outside of `MapProvider`
+*
+* @example
+* ```tsx
+* // Inside MapProvider (within BaseMap children) - uses context
+* // Only Deck.gl layer components can be children
+* function CustomDeckLayer() {
+*   const { mode, requestModeChange } = useMapMode();
+*
+*   const handleClick = (info: PickingInfo) => {
+*     requestModeChange('editing', 'custom-layer-id');
+*   };
+*
+*   return <ScatterplotLayer onClick={handleClick} />;
+* }
+* ```
+*
+* @example
+* ```tsx
+* // Outside MapProvider - pass id directly
+* function ExternalControl({ mapId }: { mapId: UniqueId }) {
+*   const { mode, requestModeChange } = useMapMode(mapId);
+*
+*   return <button onClick={() => requestModeChange('default', 'external')}>
+*     Reset to Default (current: {mode})
+*   </button>;
+* }
+* ```
+*/
 function useMapMode(id) {
-  const contextId = useContext(MapContext);
-  const actualId = id ?? contextId;
-  if (!actualId) {
-    throw new Error(
-      "useMapMode requires either an id parameter or to be used within a MapProvider"
-    );
-  }
-  const mode = useSyncExternalStore(
-    getOrCreateSubscription(actualId),
-    getOrCreateSnapshot(actualId)
-  );
-  return useMemo(
-    () => ({
-      mode,
-      requestModeChange: getOrCreateRequestModeChange(actualId)
-    }),
-    [mode, actualId]
-  );
+	const contextId = useContext(MapContext);
+	const actualId = id ?? contextId;
+	if (!actualId) throw new Error("useMapMode requires either an id parameter or to be used within a MapProvider");
+	const mode = useSyncExternalStore(getOrCreateSubscription(actualId), getOrCreateSnapshot(actualId), getOrCreateServerSnapshot(actualId));
+	return useMemo(() => ({
+		mode,
+		requestModeChange: getOrCreateRequestModeChange(actualId)
+	}), [mode, actualId]);
 }
 
+//#endregion
 export { useMapMode };
-//# sourceMappingURL=use-map-mode.js.map
 //# sourceMappingURL=use-map-mode.js.map

package/dist/map-mode/use-map-mode.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/map-mode/use-map-mode.ts"],"names":[],"mappings":";;;;;AAuEO,SAAS,WAAW,EAAA,EAAiC;AAC1D,EAAA,MAAM,SAAA,GAAY,WAAW,UAAU,CAAA;AACvC,EAAA,MAAM,WAAW,EAAA,IAAM,SAAA;AAEvB,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KACF;AAAA,EACF;AAGA,EAAA,MAAM,IAAA,GAAO,oBAAA;AAAA,IACX,wBAAwB,QAAQ,CAAA;AAAA,IAChC,oBAAoB,QAAQ;AAAA,GAC9B;AAGA,EAAA,OAAO,OAAA;AAAA,IACL,OAAO;AAAA,MACL,IAAA;AAAA,MACA,iBAAA,EAAmB,6BAA6B,QAAQ;AAAA,KAC1D,CAAA;AAAA,IACA,CAAC,MAAM,QAAQ;AAAA,GACjB;AACF","file":"use-map-mode.js","sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { useContext, useMemo, useSyncExternalStore } from 'react';\nimport { MapContext } from '../deckgl/base-map/provider';\nimport {\n  getOrCreateRequestModeChange,\n  getOrCreateSnapshot,\n  getOrCreateSubscription,\n} from './store';\nimport type { UniqueId } from '@accelint/core';\n\n/**\n * Return value for the useMapMode hook\n */\nexport type UseMapModeReturn = {\n  /** The current active map mode */\n  mode: string;\n  /** Function to request a mode change with ownership */\n  requestModeChange: (desiredMode: string, requestOwner: string) => void;\n};\n\n/**\n * Hook to access the map mode state and actions.\n *\n * This hook uses `useSyncExternalStore` to subscribe to map mode state changes,\n * providing concurrent-safe mode state updates. Uses a fan-out pattern where\n * a single bus listener per map instance notifies N React component subscribers.\n *\n * @param id - Optional map instance ID. If not provided, will use the ID from `MapContext`.\n * @returns The current map mode and requestModeChange function\n * @throws Error if no `id` is provided and hook is used outside of `MapProvider`\n *\n * @example\n * ```tsx\n * // Inside MapProvider (within BaseMap children) - uses context\n * // Only Deck.gl layer components can be children\n * function CustomDeckLayer() {\n *   const { mode, requestModeChange } = useMapMode();\n *\n *   const handleClick = (info: PickingInfo) => {\n *     requestModeChange('editing', 'custom-layer-id');\n *   };\n *\n *   return <ScatterplotLayer onClick={handleClick} />;\n * }\n * ```\n *\n * @example\n * ```tsx\n * // Outside MapProvider - pass id directly\n * function ExternalControl({ mapId }: { mapId: UniqueId }) {\n *   const { mode, requestModeChange } = useMapMode(mapId);\n *\n *   return <button onClick={() => requestModeChange('default', 'external')}>\n *     Reset to Default (current: {mode})\n *   </button>;\n * }\n * ```\n */\nexport function useMapMode(id?: UniqueId): UseMapModeReturn {\n  const contextId = useContext(MapContext);\n  const actualId = id ?? contextId;\n\n  if (!actualId) {\n    throw new Error(\n      'useMapMode requires either an id parameter or to be used within a MapProvider',\n    );\n  }\n\n  // Subscribe to store using useSyncExternalStore with fan-out pattern\n  const mode = useSyncExternalStore(\n    getOrCreateSubscription(actualId),\n    getOrCreateSnapshot(actualId),\n  );\n\n  // Memoize the return value to prevent unnecessary re-renders\n  return useMemo(\n    () => ({\n      mode,\n      requestModeChange: getOrCreateRequestModeChange(actualId),\n    }),\n    [mode, actualId],\n  );\n}\n"]}
+{"version":3,"file":"use-map-mode.js","names":[],"sources":["../../src/map-mode/use-map-mode.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n'use client';\n\nimport 'client-only';\nimport { useContext, useMemo, useSyncExternalStore } from 'react';\nimport { MapContext } from '../deckgl/base-map/provider';\nimport {\n  getOrCreateRequestModeChange,\n  getOrCreateServerSnapshot,\n  getOrCreateSnapshot,\n  getOrCreateSubscription,\n} from './store';\nimport type { UniqueId } from '@accelint/core';\n\n/**\n * Return value for the useMapMode hook\n */\nexport type UseMapModeReturn = {\n  /** The current active map mode */\n  mode: string;\n  /** Function to request a mode change with ownership */\n  requestModeChange: (desiredMode: string, requestOwner: string) => void;\n};\n\n/**\n * Hook to access the map mode state and actions.\n *\n * This hook uses `useSyncExternalStore` to subscribe to map mode state changes,\n * providing concurrent-safe mode state updates. Uses a fan-out pattern where\n * a single bus listener per map instance notifies N React component subscribers.\n *\n * @param id - Optional map instance ID. If not provided, will use the ID from `MapContext`.\n * @returns The current map mode and requestModeChange function\n * @throws Error if no `id` is provided and hook is used outside of `MapProvider`\n *\n * @example\n * ```tsx\n * // Inside MapProvider (within BaseMap children) - uses context\n * // Only Deck.gl layer components can be children\n * function CustomDeckLayer() {\n *   const { mode, requestModeChange } = useMapMode();\n *\n *   const handleClick = (info: PickingInfo) => {\n *     requestModeChange('editing', 'custom-layer-id');\n *   };\n *\n *   return <ScatterplotLayer onClick={handleClick} />;\n * }\n * ```\n *\n * @example\n * ```tsx\n * // Outside MapProvider - pass id directly\n * function ExternalControl({ mapId }: { mapId: UniqueId }) {\n *   const { mode, requestModeChange } = useMapMode(mapId);\n *\n *   return <button onClick={() => requestModeChange('default', 'external')}>\n *     Reset to Default (current: {mode})\n *   </button>;\n * }\n * ```\n */\nexport function useMapMode(id?: UniqueId): UseMapModeReturn {\n  const contextId = useContext(MapContext);\n  const actualId = id ?? contextId;\n\n  if (!actualId) {\n    throw new Error(\n      'useMapMode requires either an id parameter or to be used within a MapProvider',\n    );\n  }\n\n  // Subscribe to store using useSyncExternalStore with fan-out pattern\n  // Third parameter provides server snapshot for SSR/RSC compatibility\n  const mode = useSyncExternalStore(\n    getOrCreateSubscription(actualId),\n    getOrCreateSnapshot(actualId),\n    getOrCreateServerSnapshot(actualId),\n  );\n\n  // Memoize the return value to prevent unnecessary re-renders\n  return useMemo(\n    () => ({\n      mode,\n      requestModeChange: getOrCreateRequestModeChange(actualId),\n    }),\n    [mode, actualId],\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwEA,SAAgB,WAAW,IAAiC;CAC1D,MAAM,YAAY,WAAW,WAAW;CACxC,MAAM,WAAW,MAAM;AAEvB,KAAI,CAAC,SACH,OAAM,IAAI,MACR,gFACD;CAKH,MAAM,OAAO,qBACX,wBAAwB,SAAS,EACjC,oBAAoB,SAAS,EAC7B,0BAA0B,SAAS,CACpC;AAGD,QAAO,eACE;EACL;EACA,mBAAmB,6BAA6B,SAAS;EAC1D,GACD,CAAC,MAAM,SAAS,CACjB"}

package/dist/maplibre/constants.d.ts

@@ -1,11 +1,13 @@
+//#region src/maplibre/constants.d.ts
 declare const INITIAL_VIEW_STATE: {
-    longitude: number;
-    latitude: number;
-    zoom: number;
-    minZoom: number;
-    maxZoom: number;
-    pitch: number;
-    bearing: number;
+  longitude: number;
+  latitude: number;
+  zoom: number;
+  minZoom: number;
+  maxZoom: number;
+  pitch: number;
+  bearing: number;
 };
-
+//#endregion
 export { INITIAL_VIEW_STATE };
+//# sourceMappingURL=constants.d.ts.map

package/dist/maplibre/constants.js

@@ -1,13 +1,27 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+//#region src/maplibre/constants.ts
 const INITIAL_VIEW_STATE = {
-  longitude: -77.0369,
-  latitude: 38.9072,
-  zoom: 4,
-  minZoom: 1,
-  maxZoom: 22,
-  pitch: 0,
-  bearing: 0
+	longitude: -77.0369,
+	latitude: 38.9072,
+	zoom: 4,
+	minZoom: 1,
+	maxZoom: 22,
+	pitch: 0,
+	bearing: 0
 };
 
+//#endregion
 export { INITIAL_VIEW_STATE };
-//# sourceMappingURL=constants.js.map
 //# sourceMappingURL=constants.js.map

package/dist/maplibre/constants.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/maplibre/constants.ts"],"names":[],"mappings":"AAcO,MAAM,kBAAA,GAAqB;AAAA,EAChC,SAAA,EAAW,QAAA;AAAA,EACX,QAAA,EAAU,OAAA;AAAA,EACV,IAAA,EAAM,CAAA;AAAA,EACN,OAAA,EAAS,CAAA;AAAA,EACT,OAAA,EAAS,EAAA;AAAA,EACT,KAAA,EAAO,CAAA;AAAA,EACP,OAAA,EAAS;AACX","file":"constants.js","sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n// __private-exports\n\nexport const INITIAL_VIEW_STATE = {\n  longitude: -77.0369,\n  latitude: 38.9072,\n  zoom: 4,\n  minZoom: 1,\n  maxZoom: 22,\n  pitch: 0,\n  bearing: 0,\n};\n"]}
+{"version":3,"file":"constants.js","names":[],"sources":["../../src/maplibre/constants.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n// __private-exports\n\nexport const INITIAL_VIEW_STATE = {\n  longitude: -77.0369,\n  latitude: 38.9072,\n  zoom: 4,\n  minZoom: 1,\n  maxZoom: 22,\n  pitch: 0,\n  bearing: 0,\n};\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAa,qBAAqB;CAChC,WAAW;CACX,UAAU;CACV,MAAM;CACN,SAAS;CACT,SAAS;CACT,OAAO;CACP,SAAS;CACV"}

package/dist/maplibre/hooks/use-maplibre.d.ts

@@ -1,4 +1,18 @@
-import { IControl, MapOptions, Map } from 'maplibre-gl';
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import { IControl, Map, MapOptions } from "maplibre-gl";
+
+//#region src/maplibre/hooks/use-maplibre.d.ts
 
 /**
  * Hook to integrate a MapLibre GL map with a Deck.gl instance.
@@ -35,5 +49,6 @@ import { IControl, MapOptions, Map } from 'maplibre-gl';
  * ```
  */
 declare function useMapLibre(deck: IControl | null, styleUrl: string, options: MapOptions): Map | null;
-
+//#endregion
 export { useMapLibre };
+//# sourceMappingURL=use-maplibre.d.ts.map

package/dist/maplibre/hooks/use-maplibre.js

@@ -1,37 +1,83 @@
-import { Map } from 'maplibre-gl';
-import { useRef, useEffect } from 'react';
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
 
+
+import { useEffect, useRef } from "react";
+import { Map } from "maplibre-gl";
+
+//#region src/maplibre/hooks/use-maplibre.ts
+/**
+* Hook to integrate a MapLibre GL map with a Deck.gl instance.
+*
+* This hook manages the lifecycle of a MapLibre map, including initialization,
+* style updates, and cleanup. It ensures the Deck.gl control is properly added
+* to the map and handles cleanup when the component unmounts.
+*
+* @param deck - The Deck.gl IControl instance to add to the map
+* @param styleUrl - The MapLibre style URL to use for the map
+* @param options - MapLibre map options (container, center, zoom, etc.)
+* @returns The MapLibre map instance, or null if not yet initialized
+*
+* @example
+* ```tsx
+* function MapComponent() {
+*   const deckglInstance = useDeckgl();
+*   const container = useId();
+*
+*   const mapOptions = useMemo(() => ({
+*     container,
+*     center: [-122.4, 37.8],
+*     zoom: 12,
+*   }), [container]);
+*
+*   useMapLibre(
+*     deckglInstance as IControl,
+*     'https://tiles.example.com/style.json',
+*     mapOptions
+*   );
+*
+*   return <div id={container} />;
+* }
+* ```
+*/
 function useMapLibre(deck, styleUrl, options) {
-  const mapRef = useRef(null);
-  const optionsRef = useRef(options);
-  const styleRef = useRef(styleUrl);
-  useEffect(() => {
-    if (deck && !mapRef.current) {
-      mapRef.current = new Map({
-        ...optionsRef.current,
-        style: styleRef.current
-      });
-      mapRef.current.once("style.load", () => {
-        mapRef.current?.setProjection({ type: "mercator" });
-        mapRef.current?.addControl(deck);
-      });
-      return () => {
-        if (mapRef.current) {
-          mapRef.current.removeControl(deck);
-          mapRef.current.remove();
-          mapRef.current = null;
-        }
-      };
-    }
-  }, [deck]);
-  useEffect(() => {
-    if (mapRef.current) {
-      mapRef.current.setStyle(styleUrl);
-    }
-  }, [styleUrl]);
-  return mapRef.current;
+	const mapRef = useRef(null);
+	const optionsRef = useRef(options);
+	const styleRef = useRef(styleUrl);
+	useEffect(() => {
+		if (deck && !mapRef.current) {
+			mapRef.current = new Map({
+				...optionsRef.current,
+				style: styleRef.current
+			});
+			mapRef.current.once("style.load", () => {
+				mapRef.current?.setProjection({ type: "mercator" });
+				mapRef.current?.addControl(deck);
+			});
+			return () => {
+				if (mapRef.current) {
+					mapRef.current.removeControl(deck);
+					mapRef.current.remove();
+					mapRef.current = null;
+				}
+			};
+		}
+	}, [deck]);
+	useEffect(() => {
+		if (mapRef.current) mapRef.current.setStyle(styleUrl);
+	}, [styleUrl]);
+	return mapRef.current;
 }
 
+//#endregion
 export { useMapLibre };
-//# sourceMappingURL=use-maplibre.js.map
 //# sourceMappingURL=use-maplibre.js.map