feat(harmony): add ViewAnnotationUtils and NativeMapView components

- Add ViewAnnotationUtils utility class for annotation operations
- Add NativeMapView component for native view rendering support
- Enhance InfoWindowManager with improved layout management
- Update NativeViewAnnotationOverlay with better view lifecycle handling
- Refactor light_harmony.cpp style handling

Author: yidafu

platform/harmony/maplibre_harmony/src/main/cpp/style/light_harmony.cpp

@@ -14,6 +14,12 @@ namespace harmony {
 // Static member initialization
 napi_ref LightHarmony::constructor = nullptr;
 
+// Constructor data structure for passing to napi_new_instance
+struct LightConstructorData {
+    mbgl::Map* map;
+    mbgl::style::Light* light;
+};
+
 LightHarmony::LightHarmony(mbgl::Map& coreMap, mbgl::style::Light& coreLight)
     : light(coreLight), map(&coreMap) {
     Logger::info("LightHarmony", "Light wrapper created");
@@ -30,7 +36,7 @@ void LightHarmony::Destructor(napi_env env, void* nativeObject, void* hint) {
 
 napi_value LightHarmony::Init(napi_env env, napi_value exports) {
     Logger::info("LightHarmony", "Initializing Light NAPI class");
-    
+
     napi_property_descriptor properties[] = {
         { "getAnchor", nullptr, GetAnchor, nullptr, nullptr, nullptr, napi_default, nullptr },
         { "setAnchor", nullptr, SetAnchor, nullptr, nullptr, nullptr, napi_default, nullptr },
@@ -47,33 +53,51 @@ napi_value LightHarmony::Init(napi_env env, napi_value exports) {
         { "getIntensityTransition", nullptr, GetIntensityTransition, nullptr, nullptr, nullptr, napi_default, nullptr },
         { "setIntensityTransition", nullptr, SetIntensityTransition, nullptr, nullptr, nullptr, napi_default, nullptr },
     };
-    
+
     napi_value cons;
-    napi_status status = napi_define_class(env, "Light", NAPI_AUTO_LENGTH, 
+    napi_status status = napi_define_class(env, "Light", NAPI_AUTO_LENGTH,
         [](napi_env env, napi_callback_info info) -> napi_value {
             napi_value jsThis;
-            napi_get_cb_info(env, info, nullptr, nullptr, &jsThis, nullptr);
+            size_t argc = 1;
+            napi_value argv[1];
+            napi_get_cb_info(env, info, &argc, argv, &jsThis, nullptr);
+
+            // Check if called as constructor (new Light(...))
+            napi_value newTarget;
+            napi_get_new_target(env, info, &newTarget);
+            if (newTarget != nullptr) {
+                // Constructor call - extract data and create wrapper
+                if (argc > 0) {
+                    LightConstructorData* data = nullptr;
+                    napi_get_value_external(env, argv[0], (void**)&data);
+                    if (data) {
+                        LightHarmony* lightHarmony = new LightHarmony(*data->map, *data->light);
+                        napi_wrap(env, jsThis, lightHarmony, Destructor, nullptr, nullptr);
+                        Logger::info("LightHarmony", "Light wrapper created via constructor");
+                    }
+                }
+            }
             return jsThis;
-        }, 
+        },
         nullptr, sizeof(properties) / sizeof(properties[0]), properties, &cons);
-    
+
     if (status != napi_ok) {
         Logger::error("LightHarmony", "Failed to define Light class");
         return nullptr;
     }
-    
+
     status = napi_create_reference(env, cons, 1, &constructor);
     if (status != napi_ok) {
         Logger::error("LightHarmony", "Failed to create Light constructor reference");
         return nullptr;
     }
-    
+
     status = napi_set_named_property(env, exports, "Light", cons);
     if (status != napi_ok) {
         Logger::error("LightHarmony", "Failed to export Light class");
         return nullptr;
     }
-    
+
     Logger::info("LightHarmony", "Light NAPI class initialized successfully");
     return exports;
 }
@@ -85,32 +109,31 @@ napi_value LightHarmony::CreateLightPeer(napi_env env, mbgl::Map& map, mbgl::sty
         napi_get_undefined(env, &undefined);
         return undefined;
     }
-    
+
     napi_value cons;
     napi_get_reference_value(env, constructor, &cons);
-    
-    napi_value instance;
-    napi_status status = napi_new_instance(env, cons, 0, nullptr, &instance);
+
+    // Create data structure with Map and Light pointers
+    LightConstructorData data{&map, &coreLight};
+
+    napi_value dataExternal;
+    napi_status status = napi_create_external(env, &data, nullptr, nullptr, &dataExternal);
     if (status != napi_ok) {
-        Logger::error("LightHarmony", "Failed to create Light instance");
+        Logger::error("LightHarmony", "Failed to create external data");
         napi_value undefined;
         napi_get_undefined(env, &undefined);
         return undefined;
     }
-    
-    // Create native wrapper
-    LightHarmony* lightHarmony = new LightHarmony(map, coreLight);
-    
-    // Wrap native object
-    status = napi_wrap(env, instance, lightHarmony, Destructor, nullptr, nullptr);
+
+    napi_value instance;
+    status = napi_new_instance(env, cons, 1, &dataExternal, &instance);
     if (status != napi_ok) {
-        Logger::error("LightHarmony", "Failed to wrap Light instance");
-        delete lightHarmony;
+        Logger::error("LightHarmony", "Failed to create Light instance");
         napi_value undefined;
         napi_get_undefined(env, &undefined);
         return undefined;
     }
-    
+
     Logger::info("LightHarmony", "Light peer created successfully");
     return instance;
 }

platform/harmony/maplibre_harmony/src/main/ets/maps/MapLibreMap.ets

@@ -223,6 +223,9 @@ export class MapLibreMap {
   private pendingAnimationCallback: CameraAnimationCallback | null = null;
   private animationTimerId: number | null = null;
   private animationCancelled: boolean = false;
+  // Camera move throttling - limits update frequency during gestures
+  private lastCameraMoveTime: number = 0;
+  private static readonly CAMERA_MOVE_THROTTLE_MS = 16; // ~60fps limit
 
   constructor(nativeMapView: NativeMapView, options: MapLibreMapOptions) {
     this.nativeMapView = nativeMapView;
@@ -3098,7 +3101,12 @@ export class MapLibreMap {
       console.warn('[MapLibreMap] _notifyCameraMove() called but map is destroyed, skipping');
       return;
     }
-    console.info('[MapLibreMap] _notifyCameraMove() called');
+    // Throttle updates to ~60fps to avoid overwhelming the UI thread during gestures
+    const now = Date.now();
+    if (now - this.lastCameraMoveTime < MapLibreMap.CAMERA_MOVE_THROTTLE_MS) {
+      return;
+    }
+    this.lastCameraMoveTime = now;
     // Mirrors Android: update UI elements (InfoWindow, etc.) while the camera moves
     this.onUpdateRegionChange();
     this.cameraChangeDispatcher.notifyCameraMove();

platform/harmony/maplibre_harmony/src/main/ets/maps/annotations/InfoWindow.ets

@@ -305,7 +305,7 @@ struct DefaultInfoWindowHost {
         this.context.onClose?.();
       },
       onSizeChanged: (width: number, height: number) => {
-        this.notifySizeChanged(width, height);
+        this.notifySizeChanged?.(width, height);
       }
     });
   }

platform/harmony/maplibre_harmony/src/main/ets/maps/annotations/InfoWindowManager.ets

@@ -29,6 +29,20 @@ interface InfoWindowUpdateOptions extends ViewAnnotationUpdateOptions {
   viewName: string;
 }
 
+/**
+ * Global reference to the current InfoWindowManager instance.
+ * Used by NativeViewAnnotationOverlay to get InfoWindowBuilderContext for rendering.
+ */
+let currentInfoWindowManager: InfoWindowManager | null = null;
+
+/**
+ * Get the current InfoWindowManager instance.
+ * Used for cross-component context access during rendering.
+ */
+export function getInfoWindowManagerInstance(): InfoWindowManager | null {
+  return currentInfoWindowManager;
+}
+
 /**
  * Options supplied when displaying an InfoWindow via the manager.
  */
@@ -51,8 +65,8 @@ class InfoWindowContextManager {
   registerInfoWindowContext(annotationId: number, ctx: InfoWindowBuilderContext) {
     this.ctxMap.set(annotationId, ctx)
   }
-  getInfoWindowContext(annotation: number): InfoWindowBuilderContext | null{
-    return this.ctxMap.get(annotation)?? null
+  public getInfoWindowContext(annotation: number): InfoWindowBuilderContext | null {
+    return this.ctxMap.get(annotation) ?? null;
   }
   clear() {
     this.ctxMap.clear();
@@ -72,6 +86,28 @@ export class InfoWindowManager {
   private onCloseListener: OnInfoWindowCloseListener | null = null;
   private allowConcurrentMultiple: boolean = false;
   private viewAnnotationManager: ViewAnnotationManager | null = null;
+  private ctxMap: Map<number, InfoWindowBuilderContext> = new Map();
+
+  constructor() {
+    // Set as the current global instance for cross-component access
+    currentInfoWindowManager = this;
+  }
+
+  /**
+   * Register an InfoWindowBuilderContext for an annotation ID.
+   * Called by the rendering system to enable context lookup during view updates.
+   */
+  registerInfoWindowContext(annotationId: number, ctx: InfoWindowBuilderContext): void {
+    this.ctxMap.set(annotationId, ctx);
+  }
+
+  /**
+   * Get InfoWindowBuilderContext by annotation ID.
+   * Used by NativeViewAnnotationOverlay during rendering.
+   */
+  public getInfoWindowContext(annotationId: number): InfoWindowBuilderContext | null {
+    return this.ctxMap.get(annotationId) ?? null;
+  }
 
   /**
    * Bind the ViewAnnotationManager used to create InfoWindow annotations.
@@ -225,6 +261,7 @@ export class InfoWindowManager {
     const layout = activeInfoWindow.getLayoutOptions();
 
     const existingId = activeInfoWindow.getAnnotationId();
+    let annotationId = existingId;
     if (existingId > 0) {
       try {
         const updateOptions = {
@@ -241,7 +278,6 @@ export class InfoWindowManager {
       } catch (error) {
         const reason = error instanceof Error ? error.message : `${error}`;
         console.error('[InfoWindowManager] updateViewAnnotation failed: ', reason);
-        return null;
       }
     } else {
       const estimatedSize = activeInfoWindow.estimateSize();
@@ -260,7 +296,7 @@ export class InfoWindowManager {
         zIndex: layout.zIndex
       } as InfoWindowAddOptions;
       try {
-        const annotationId = this.viewAnnotationManager.addViewAnnotation(addOptions);
+        annotationId = this.viewAnnotationManager.addViewAnnotation(addOptions);
         if (annotationId <= 0) {
           console.error('[InfoWindowManager] Failed to add ViewAnnotation for InfoWindow');
           return null;
@@ -273,6 +309,10 @@ export class InfoWindowManager {
       }
     }
 
+    // Register the InfoWindowBuilderContext for rendering
+    const builderContext = new InfoWindowBuilderContext(activeInfoWindow, infoWindow.getRenderContext());
+    this.registerInfoWindowContext(annotationId, builderContext);
+
     activeInfoWindow.setVisible(true);
     return activeInfoWindow;
   }
@@ -291,6 +331,8 @@ export class InfoWindowManager {
       if (this.viewAnnotationManager) {
         this.viewAnnotationManager.removeViewAnnotation(annotationId);
       }
+      // Clean up the registered context
+      this.ctxMap.delete(annotationId);
     }
 
     infoWindow.resetAnnotation();

platform/harmony/maplibre_harmony/src/main/ets/maps/annotations/NativeViewAnnotationOverlay.ets

@@ -1,5 +1,10 @@
 import type { ViewAnnotationWrappedBuilder } from './ViewAnnotationTypes';
-import { ViewAnnotationBuilderContext, InfoWindowBuilderContext, INFO_WINDOW_VIEW_NAME } from './ViewAnnotationTypes';
+import {
+  ViewAnnotationBuilderContext,
+  InfoWindowBuilderContext,
+  INFO_WINDOW_VIEW_NAME
+} from './ViewAnnotationTypes';
+import { getInfoWindowManagerInstance } from './InfoWindowManager';
 
 export interface ViewAnnotationRenderStateParams {
   id: number;
@@ -217,8 +222,15 @@ export struct NativeViewAnnotationOverlay {
   private createBuilderContext(state: ViewAnnotationRenderState): ViewAnnotationBuilderContext {
     let ctx: ViewAnnotationBuilderContext;
     if (state.viewName === INFO_WINDOW_VIEW_NAME) {
-      // Create a basic ViewAnnotationBuilderContext for InfoWindows
-      // The actual InfoWindowBuilderContext will be created by the InfoWindowManager
+      // For InfoWindows, get the actual InfoWindowBuilderContext from InfoWindowManager
+      const infoWindowManager = getInfoWindowManagerInstance();
+      if (infoWindowManager) {
+        const infoWindowCtx = infoWindowManager.getInfoWindowContext(state.id);
+        if (infoWindowCtx) {
+          return infoWindowCtx;
+        }
+      }
+      // Fallback: create a basic context if InfoWindowManager is not available
       ctx = new ViewAnnotationBuilderContext();
     } else {
       ctx = new ViewAnnotationBuilderContext();

platform/harmony/maplibre_harmony/src/main/ets/maps/annotations/ViewAnnotationManager.ets

@@ -412,13 +412,6 @@ export class ViewAnnotationManager {
       const positionX = frameLogicalX - logicalWidth * anchorU + frameOffsetX + centerOffsetX;
       const positionY = frameLogicalY - logicalHeight * anchorV + frameOffsetY + centerOffsetY;
 
-      console.info(
-        `[ViewAnnotationManager] frame=${frame.id} raw=(${format(frame.x)}, ${format(frame.y)}) ` +
-        `pixelRatio(raw=${format(frame.pixelRatio)}, resolved=${format(frameRatio)}) ` +
-        `logical=(${format(frameLogicalX)}, ${format(frameLogicalY)}) size=(${format(logicalWidth)}, ${format(logicalHeight)}) ` +
-        `offset=(${format(frameOffsetX)}, ${format(frameOffsetY)}) position=(${format(positionX)}, ${format(positionY)})`
-      );
-
       nextStates.push(new ViewAnnotationRenderState({
         id: frame.id,
         positionX,