@aibee/crc-bmap 0.14.37 → 0.14.39

package/lib/meta.json

@@ -1142,13 +1142,28 @@
       "format": "esm"
     },
     "../lib/src/utils/index-db.js": {
-      "bytes": 6422,
+      "bytes": 9851,
       "imports": [
         {
           "path": "core-js/modules/es.error.cause.js",
           "kind": "import-statement",
           "external": true
         },
+        {
+          "path": "core-js/modules/web.dom-exception.constructor.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/web.dom-exception.stack.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/web.dom-exception.to-string-tag.js",
+          "kind": "import-statement",
+          "external": true
+        },
         {
           "path": "<runtime>",
           "kind": "import-statement",
@@ -1350,8 +1365,13 @@
       "format": "esm"
     },
     "../lib/src/factory/img-texture.js": {
-      "bytes": 3369,
+      "bytes": 4061,
       "imports": [
+        {
+          "path": "core-js/modules/es.error.cause.js",
+          "kind": "import-statement",
+          "external": true
+        },
         {
           "path": "core-js/modules/web.dom-collections.iterator.js",
           "kind": "import-statement",
@@ -2010,8 +2030,43 @@
       "format": "esm"
     },
     "../lib/src/layer/poi-text-batch.js": {
-      "bytes": 13108,
+      "bytes": 14619,
       "imports": [
+        {
+          "path": "core-js/modules/es.set.difference.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.intersection.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.is-disjoint-from.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.is-subset-of.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.is-superset-of.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.symmetric-difference.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.union.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
         {
           "path": "core-js/modules/web.dom-collections.iterator.js",
           "kind": "import-statement",
@@ -2111,7 +2166,7 @@
       "format": "esm"
     },
     "../lib/src/layer/poi-icon-batch.js": {
-      "bytes": 10718,
+      "bytes": 10922,
       "imports": [
         {
           "path": "core-js/modules/web.dom-collections.iterator.js",
@@ -2399,7 +2454,7 @@
       "format": "esm"
     },
     "../src/utils/index-db.ts": {
-      "bytes": 5584,
+      "bytes": 8563,
       "imports": [
         {
           "path": "<runtime>",
@@ -2482,7 +2537,7 @@
       "format": "esm"
     },
     "../src/factory/img-texture.ts": {
-      "bytes": 3167,
+      "bytes": 3732,
       "imports": [
         {
           "path": "three",
@@ -3420,7 +3475,7 @@
       "format": "esm"
     },
     "../lib/src/elements/poi2.js": {
-      "bytes": 34819,
+      "bytes": 41716,
       "imports": [
         {
           "path": "../../../node_modules/.pnpm/@swc+helpers@0.5.17/node_modules/@swc/helpers/esm/_extends.js",
@@ -3437,6 +3492,41 @@
           "kind": "import-statement",
           "external": true
         },
+        {
+          "path": "core-js/modules/es.set.difference.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.intersection.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.is-disjoint-from.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.is-subset-of.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.is-superset-of.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.symmetric-difference.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.union.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
         {
           "path": "core-js/modules/es.string.trim.js",
           "kind": "import-statement",
@@ -3476,7 +3566,7 @@
       "format": "esm"
     },
     "../lib/src/elements/floor.js": {
-      "bytes": 7381,
+      "bytes": 7765,
       "imports": [
         {
           "path": "core-js/modules/web.dom-collections.iterator.js",
@@ -5022,7 +5112,7 @@
       "format": "esm"
     },
     "../lib/src/context/collision-system.js": {
-      "bytes": 6570,
+      "bytes": 6772,
       "imports": [
         {
           "path": "core-js/modules/es.array.unshift.js",
@@ -5182,7 +5272,7 @@
       "format": "esm"
     },
     "../lib/src/loader/AibeeLoader/index.js": {
-      "bytes": 23146,
+      "bytes": 24793,
       "imports": [
         {
           "path": "../../../node_modules/.pnpm/@swc+helpers@0.5.17/node_modules/@swc/helpers/esm/_extends.js",
@@ -5199,6 +5289,11 @@
           "kind": "import-statement",
           "external": true
         },
+        {
+          "path": "core-js/modules/es.error.cause.js",
+          "kind": "import-statement",
+          "external": true
+        },
         {
           "path": "../lib/src/utils/index-db.js",
           "kind": "import-statement",
@@ -5327,7 +5422,7 @@
       "format": "esm"
     },
     "../lib/src/bmap.js": {
-      "bytes": 22666,
+      "bytes": 24399,
       "imports": [
         {
           "path": "../../../node_modules/.pnpm/@swc+helpers@0.5.17/node_modules/@swc/helpers/esm/_extends.js",
@@ -5399,6 +5494,11 @@
           "kind": "import-statement",
           "original": "./loader"
         },
+        {
+          "path": "../lib/src/utils/index-db.js",
+          "kind": "import-statement",
+          "original": "./utils/index-db"
+        },
         {
           "path": "<runtime>",
           "kind": "import-statement",
@@ -8080,11 +8180,31 @@
           "kind": "import-statement",
           "external": true
         },
+        {
+          "path": "core-js/modules/web.dom-exception.constructor.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/web.dom-exception.stack.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/web.dom-exception.to-string-tag.js",
+          "kind": "import-statement",
+          "external": true
+        },
         {
           "path": "three",
           "kind": "import-statement",
           "external": true
         },
+        {
+          "path": "core-js/modules/es.error.cause.js",
+          "kind": "import-statement",
+          "external": true
+        },
         {
           "path": "core-js/modules/web.dom-collections.iterator.js",
           "kind": "import-statement",
@@ -8400,6 +8520,41 @@
           "kind": "import-statement",
           "external": true
         },
+        {
+          "path": "core-js/modules/es.set.difference.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.intersection.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.is-disjoint-from.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.is-subset-of.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.is-superset-of.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.symmetric-difference.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.union.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
         {
           "path": "core-js/modules/web.dom-collections.iterator.js",
           "kind": "import-statement",
@@ -8690,6 +8845,41 @@
           "kind": "import-statement",
           "external": true
         },
+        {
+          "path": "core-js/modules/es.set.difference.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.intersection.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.is-disjoint-from.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.is-subset-of.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.is-superset-of.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.symmetric-difference.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
+        {
+          "path": "core-js/modules/es.set.union.v2.js",
+          "kind": "import-statement",
+          "external": true
+        },
         {
           "path": "core-js/modules/es.string.trim.js",
           "kind": "import-statement",
@@ -9410,6 +9600,11 @@
           "kind": "import-statement",
           "external": true
         },
+        {
+          "path": "core-js/modules/es.error.cause.js",
+          "kind": "import-statement",
+          "external": true
+        },
         {
           "path": "three",
           "kind": "import-statement",
@@ -10266,7 +10461,7 @@
           "bytesInOutput": 208
         },
         "../lib/src/bmap.js": {
-          "bytesInOutput": 11302
+          "bytesInOutput": 11609
         },
         "../lib/src/context/context.js": {
           "bytesInOutput": 9505
@@ -10386,7 +10581,7 @@
           "bytesInOutput": 2371
         },
         "../lib/src/utils/index-db.js": {
-          "bytesInOutput": 1920
+          "bytesInOutput": 2884
         },
         "../lib/src/factory/worker/sdf-text.worker.js": {
           "bytesInOutput": 97
@@ -10395,7 +10590,7 @@
           "bytesInOutput": 3816
         },
         "../lib/src/factory/img-texture.js": {
-          "bytesInOutput": 1581
+          "bytesInOutput": 1890
         },
         "../lib/src/factory/model.js": {
           "bytesInOutput": 898
@@ -10452,7 +10647,7 @@
           "bytesInOutput": 4421
         },
         "../lib/src/elements/floor.js": {
-          "bytesInOutput": 4504
+          "bytesInOutput": 4621
         },
         "../lib/src/elements/model.js": {
           "bytesInOutput": 410
@@ -10470,10 +10665,10 @@
           "bytesInOutput": 2126
         },
         "../lib/src/layer/poi-text-batch.js": {
-          "bytesInOutput": 6773
+          "bytesInOutput": 7437
         },
         "../lib/src/layer/poi-icon-batch.js": {
-          "bytesInOutput": 5870
+          "bytesInOutput": 5913
         },
         "../lib/src/layer/parking-layer.js": {
           "bytesInOutput": 4035
@@ -10509,7 +10704,7 @@
           "bytesInOutput": 1595
         },
         "../lib/src/elements/poi2.js": {
-          "bytesInOutput": 15800
+          "bytesInOutput": 18439
         },
         "../lib/src/elements/heatmap.js": {
           "bytesInOutput": 2123
@@ -10602,13 +10797,13 @@
           "bytesInOutput": 186
         },
         "../lib/src/context/collision-system.js": {
-          "bytesInOutput": 2629
+          "bytesInOutput": 2605
         },
         "../lib/src/config.js": {
           "bytesInOutput": 1360
         },
         "../lib/src/loader/AibeeLoader/index.js": {
-          "bytesInOutput": 10274
+          "bytesInOutput": 10701
         },
         "../lib/src/loader/AibeeLoader/layer.js": {
           "bytesInOutput": 4435
@@ -10764,7 +10959,7 @@
           "bytesInOutput": 0
         }
       },
-      "bytes": 472254
+      "bytes": 477700
     }
   }
 }

package/lib/src/bmap.d.ts

@@ -43,6 +43,10 @@ export declare enum MapTypePolar {
 }
 export declare class BMap extends EventDispatcher<BmapEventMap> {
     private container;
+    /** 当前存活的 BMap 实例数；共享 db / factory 只在最后一个实例销毁时释放 */
+    private static liveCount;
+    /** dispose 幂等标记，避免同一个实例重复减少 liveCount */
+    private disposed;
     config: Config;
     context: Context;
     polarKeys: string[];

package/lib/src/elements/poi2.d.ts

@@ -64,6 +64,21 @@ export declare class Poi2 extends Object3D<PoiEventMap2> {
     box: Box2;
     boxHelper?: HTMLDivElement;
     private _shouldShow;
+    /** 异步文字/图标初始化版本号；hide 或下一次重建会递增，旧请求据此失效 */
+    private textRevision;
+    /** show/hide 的版本号，避免旧的 show 在 await 之后继续操作新状态 */
+    private visibilityRevision;
+    /** 下一帧按最新 zoom/textHeight 再校准一次网格缩放 */
+    private scheduleScaleSync;
+    /** 图标初始化版本号，和 textRevision 同理 */
+    private iconRevision;
+    /** 下一帧的缩放校准任务，避免创建瞬间的 zoom/布局与渲染帧不一致 */
+    private scaleSyncRaf;
+    /** 只记录 SDK 自己创建的文字/背景网格，避免误销毁外部添加到 POI 的对象 */
+    private textObjects;
+    /** 只记录 SDK 自己创建的独立图标 sprite */
+    private iconSprites;
+    get shouldShow(): boolean;
     /** 文字布局结果（按 textTextureKey 缓存） */
     textLayoutMap: Record<string, TextLayoutResult>;
     /** 所属 PoiLayer2 的文字合批器；为空时保持旧的逐 POI Mesh 渲染 */
@@ -118,8 +133,24 @@ export declare class Poi2 extends Object3D<PoiEventMap2> {
         height: number;
         lines: number;
     } | null;
+    /**
+     * 标签挂载点相对 POI 位置在 z 方向上的抬升量。
+     * 逐 POI 网格（meshText / spriteIcon）、合批实例（PoiTextBatch / PoiIconBatch）
+     * 以及碰撞框原点（getLabelOriginWorldPosition）必须共用这一个值，
+     * 否则 3D 视角下包围盒会和实际绘制的标签错开。
+     * 纯文字时抬升量随 zoom 变化，合批需要在 zoom 变化时同步实例中心。
+     */
     get deltaZ(): number;
     get canSelect(): boolean;
+    /** 释放单个文字/背景网格的几何与材质 */
+    private disposeTextMesh;
+    /**
+     * 清掉 SDK 自己创建的所有文字/背景网格。
+     * 用 Set 记录所有权，而不是扫描 children/userData，避免误销毁外部对象。
+     */
+    private clearTextObjects;
+    /** 清掉 SDK 自己创建的所有独立图标 sprite */
+    private clearIconObjects;
     show(): Promise<void>;
     hide(): void;
     registryEvent(): void;
@@ -127,6 +158,8 @@ export declare class Poi2 extends Object3D<PoiEventMap2> {
     getPosition(): Vector3;
     initIcon(): Promise<Sprite<Object3DEventMap> | undefined>;
     get textTextureKey(): string;
+    /** 预生成当前文案的布局和包围盒，即使 POI 当前被碰撞隐藏也要做 */
+    private prepareTextLayout;
     _initTextTexture: () => Promise<void>;
     initTextTexture: () => Promise<void>;
     /** 计算文字的 SDF 布局（含换行），度量来自共享字形图集；结果会缓存到 textLayoutMap */
@@ -149,7 +182,8 @@ export declare class Poi2 extends Object3D<PoiEventMap2> {
     /**
      * 标签渲染原点的世界坐标，供碰撞检测投影使用。
      * 优先取文字/图标网格的实际世界坐标（包含 deltaZ 抬升与楼层等父级变换）；
-     * 标签被隐藏（网格未创建）时，按 deltaZ 估算。
+     * 合批模式下没有逐 POI 网格，按 deltaZ 估算——合批实例的挂载高度同样取自
+     * deltaZ（见 PoiTextBatch / PoiIconBatch），两边必须是同一个口径。
      * 这样包围盒的基准点与渲染一致，2D / 3D 视角下都不会错位。
      */
     getLabelOriginWorldPosition(target?: Vector3): Vector3;

package/lib/src/factory/img-texture.d.ts

@@ -5,6 +5,8 @@ export declare class ImgTextureFactory {
     static borderUrlTextureMap: Map<string, Texture | Promise<Texture>>;
     private static canvas;
     private static ctx;
+    /** 懒创建离屏画布；dispose 后下一次使用时会重新创建 */
+    private static ensureCanvas;
     static getTextureByUrl(url: string): Promise<Texture>;
     static getUrlTextureBorder(url: string, size: number, border: {
         width: number;

package/lib/src/layer/poi-text-batch.d.ts

@@ -23,6 +23,8 @@ export declare class PoiTextBatch extends Object3D {
     dispose(): void;
     private get pixelRatio();
     private onZoomChange;
+    /** 把每个实例的中心 z 同步为 POI 当前的 deltaZ（不重建几何） */
+    private syncCenterZ;
     private writeOpacity;
     private scheduleRebuild;
     private clearBuckets;

package/lib/src/loader/AibeeLoader/index.d.ts

@@ -30,6 +30,13 @@ interface AibeeLoaderEventMap {
             graphics: Graphic[];
         };
     };
+    /** 切楼层失败（数据不可用、缓存/网络异常等）；调用方据此结束 loading */
+    'switch-floor-error': {
+        data: {
+            floor: string;
+            error: unknown;
+        };
+    };
 }
 export interface AibeeFloorInfo {
     floor_id: number;
@@ -60,6 +67,8 @@ export interface PlaceConfig {
 }
 export declare class AibeeLoader extends EventDispatcher<AibeeLoaderEventMap> {
     bmap: BMap;
+    /** 防止 dispose 重复执行（BMap.dispose 和组件卸载可能都会调用） */
+    disposed: boolean;
     floors: AibeeFloorInfo[];
     initDbPromise: Promise<void>;
     /** 全场预热的完成信号；需要确保缓存已就绪时可 await 它 */
@@ -76,7 +85,7 @@ export declare class AibeeLoader extends EventDispatcher<AibeeLoaderEventMap> {
     initDb(): Promise<void>;
     load(data: number | string | AibeeFloorInfo[], placeConfig?: Partial<PlaceConfig>): Promise<void>;
     waitForPreload(): Promise<void>;
-    setCacheData(storeName: string, key: string | number, data: any): Promise<unknown>;
+    setCacheData(storeName: string, key: string | number, data: any): Promise<any>;
     getCacheData<T>(storeName: string, key: string | number): Promise<T>;
     /**
      * 刚写入 IndexedDB 的数据，在 Safari/WKWebView 下可能因为事务提交时序短暂读不到。

package/lib/src/utils/index-db.d.ts

@@ -11,6 +11,20 @@ export declare enum MAP_DB_TABLES {
     LAZY_POI = "lazy_poi",// 车位poi
     SDF_GLYPH = "sdf_glyph_1"
 }
+/**
+ * 增加一个 db 持有者。由 BMap 在构造时调用，和 releaseDb 成对出现。
+ * 持有者存在期间，即使某个 AibeeLoader 被销毁，也不会关闭共享连接。
+ */
+export declare function retainDb(): void;
+/**
+ * 释放一个 db 持有者。只有最后一个持有者释放时才关闭连接。
+ */
+export declare function releaseDb(): void;
+/**
+ * 获取 indexDb 连接。
+ * 连接不可用时会重新打开；worker 里没有 window，允许 worker 自己打开自己的连接。
+ */
+export declare function ensureDb(): Promise<IDBDatabase>;
 /**
  * 获取indexDb连接
  * @param database
@@ -27,7 +41,7 @@ export declare function createDb(database?: string, version?: number): Promise<{
  * @param db
  * @returns
  */
-export declare function get(storeName: string, key: string, db?: IDBDatabase): Promise<unknown>;
+export declare function get(storeName: string, key: string, db?: IDBDatabase | null): Promise<any>;
 /**
  * 添加数据
  * @param storeName
@@ -36,14 +50,14 @@ export declare function get(storeName: string, key: string, db?: IDBDatabase): P
  * @param db
  * @returns
  */
-export declare function set(storeName: string, key: string, value: any, db?: IDBDatabase, forceAdd?: boolean): Promise<unknown>;
+export declare function set(storeName: string, key: string, value: any, db?: IDBDatabase | null, forceAdd?: boolean): Promise<any>;
 /**
  * 创建数据表
  * @param storeName
  * @param db
  * @returns
  */
-export declare function createStore(storeName: string, db?: IDBDatabase): void;
+export declare function createStore(storeName: string, db?: IDBDatabase | null): void;
 /**
  * 删除数据
  * @param storeName
@@ -51,7 +65,7 @@ export declare function createStore(storeName: string, db?: IDBDatabase): void;
  * @param db
  * @returns
  */
-export declare function remove(storeName: string, key: string, db?: IDBDatabase): Promise<unknown>;
+export declare function remove(storeName: string, key: string, db?: IDBDatabase | null): Promise<any>;
 /**
  * 更新数据
  * @param storeName
@@ -60,5 +74,5 @@ export declare function remove(storeName: string, key: string, db?: IDBDatabase)
  * @param db
  * @returns
  */
-export declare function update(storeName: string, key: string, value: any, db?: IDBDatabase): Promise<unknown>;
-export declare function closeDb(db?: IDBDatabase): void;
+export declare function update(storeName: string, key: string, value: any, db?: IDBDatabase | null): Promise<any>;
+export declare function closeDb(db?: IDBDatabase | null): void;