feat: 导出 Sprite 加载处理函数

- 提取 createSpriteLoadHandler 供外部 WebApp 使用
- 从 common 和 mapboxgl 包入口导出该函数
- 补充公共导出测试

AI-GEN: 90% gpt5.6-luna

Author: xiongjiaojiao

src/common/mapping/WebMapV3.js

@@ -160,6 +160,28 @@ export const LEGEND_STYLE_TYPES = {
   IMAGE: 'image',
   STYLE: 'style'
 };
+
+/**
+ * 按地图版本创建 Sprite 加载处理函数，供 WebMap 和外部 WebApp 共用。
+ * @param {string} mapVersion 地图版本号。
+ * @returns {Function|undefined} 旧版地图返回线符号处理函数，新版地图不需要额外处理。
+ */
+export function createSpriteLoadHandler(mapVersion) {
+  const [major, minor, patch] = typeof mapVersion === 'string' ? mapVersion.split('.').map(Number) : [];
+  // 3.3.7 及以前的地图线符号需要垂直翻转；新版本由地图数据自身保证方向。
+  if (major > 3 || (major === 3 && minor > 3) || (major === 3 && minor === 3 && patch > 7)) {
+    return;
+  }
+  return (id, imageData, width, height) => {
+    // 翻转所有 line- 开头的图案
+    if (id && id.startsWith('line-')) {
+      return flipImageVertically(imageData, width, height);
+    }
+
+    return null;
+  };
+}
+
 export function createWebMapV3Extending(SuperClass, { MapManager, mapRepo, crsManager, l7LayerUtil, webMapService }) {
   return class WebMapV3 extends SuperClass {
     constructor(mapId, options, mapOptions = {}) {
@@ -319,20 +341,7 @@ export function createWebMapV3Extending(SuperClass, { MapManager, mapRepo, crsMa
   }
 
   _getSpriteLoad() {
-    const version = this._mapInfo && this._mapInfo.version;
-    const [major, minor, patch] = typeof version === 'string' ? version.split('.').map(Number) : [];
-    // 3.3.7 及以前的地图线符号需要垂直翻转；新版本由地图数据自身保证方向。
-    if (major > 3 || (major === 3 && minor > 3) || (major === 3 && minor === 3 && patch > 7)) {
-      return;
-    }
-    return (id, imageData, width, height) => {
-      // 翻转所有 line- 开头的图案
-      if (id && id.startsWith('line-')) {
-        return flipImageVertically(imageData, width, height);
-      }
-
-      return null;
-    };
+    return createSpriteLoadHandler(this._mapInfo && this._mapInfo.version);
   }
 
   _getTransformRequest() {

src/common/mapping/index.js

@@ -2,4 +2,5 @@ export * from './WebMapV2Base';
 export * from './WebMapService';
 export * from './utils/epsg-define';
 export * from './WebMapBase';
-export * from './utils/SourceListModelV2';
+export * from './utils/SourceListModelV2';
+export { createSpriteLoadHandler } from './WebMapV3';

src/mapboxgl/mapping/index.js

@@ -1,3 +1,4 @@
 export { WebMap } from './WebMap';
 export { initMap } from './InitMap';
-export { VideoMap } from './VideoMap';
+export { VideoMap } from './VideoMap';
+export { createSpriteLoadHandler } from '@supermapgis/iclient-common/mapping/WebMapV3';

test/common/mapping/WebMapV3Spec.js

@@ -1,4 +1,5 @@
 import { createWebMapV3Extending } from '../../../src/common/mapping/WebMapV3';
+import { createSpriteLoadHandler } from '../../../src/common/mapping';
 import { createWebMapBaseExtending } from '../../../src/common/mapping/WebMapBase';
 import { Events } from '../../../src/common/commontypes';
 
@@ -131,6 +132,11 @@ describe('WebMapV3 - addLocalIdeographFontFamily', () => {
   });
 
   describe('_getSpriteLoad', () => {
+    it('should be exported for external WebApps', () => {
+      expect(createSpriteLoadHandler('3.3.7')).toEqual(jasmine.any(Function));
+      expect(createSpriteLoadHandler('3.3.8')).toBeUndefined();
+    });
+
     it('should flip line sprites for maps at version 3.3.7', () => {
       instance._mapInfo = { version: '3.3.7' };
       const onSpriteLoad = instance._getSpriteLoad();

test/mapboxgl/mapping/WebMapV3Spec.js

@@ -4,6 +4,7 @@ import { createWebMapV3Extending } from '../../../src/common/mapping/WebMapV3';
 import { createMapClassExtending } from '../../../src/common/mapping/MapBase';
 import { L7LayerUtil } from '../../../src/common/mapping/utils/L7LayerUtil';
 import { WebMap } from '../../../src/mapboxgl/mapping/WebMap';
+import { createSpriteLoadHandler } from '../../../src/mapboxgl';
 import * as MapManagerUtil from '../../../src/mapboxgl/mapping/webmap/MapManager';
 import { CRSManager } from '../../../src/mapboxgl/mapping/webmap/CRSManager';
 import { featureFilter, expression } from '@mapbox/mapbox-gl-style-spec';
@@ -15,6 +16,9 @@ import '../../resources/WebMapV3.js';
 import '../../resources/WebMapV5.js';
 
 describe('mapboxgl-webmap3.0', () => {
+  it('exports the Sprite load handler from the package entry point', () => {
+    expect(createSpriteLoadHandler('3.3.7')).toEqual(jasmine.any(Function));
+  });
   var originalTimeout, testDiv;
   var server = 'http://localhost:8190/iportal/';
   var id = 617580084;