@aibee/crc-bmap 0.14.32 → 0.14.33

package/lib/meta.json

@@ -3193,7 +3193,7 @@
       "format": "esm"
     },
     "../lib/src/elements/poi2.js": {
-      "bytes": 25509,
+      "bytes": 27236,
       "imports": [
         {
           "path": "../../../node_modules/.pnpm/@swc+helpers@0.5.17/node_modules/@swc/helpers/esm/_extends.js",
@@ -4795,7 +4795,7 @@
       "format": "esm"
     },
     "../lib/src/context/collision-system.js": {
-      "bytes": 6444,
+      "bytes": 6570,
       "imports": [
         {
           "path": "core-js/modules/es.array.unshift.js",
@@ -4816,7 +4816,7 @@
       "format": "esm"
     },
     "../lib/src/context/context.js": {
-      "bytes": 19442,
+      "bytes": 19535,
       "imports": [
         {
           "path": "core-js/modules/web.dom-collections.iterator.js",
@@ -5100,7 +5100,7 @@
       "format": "esm"
     },
     "../lib/src/bmap.js": {
-      "bytes": 22278,
+      "bytes": 22666,
       "imports": [
         {
           "path": "../../../node_modules/.pnpm/@swc+helpers@0.5.17/node_modules/@swc/helpers/esm/_extends.js",
@@ -9848,10 +9848,10 @@
           "bytesInOutput": 208
         },
         "../lib/src/bmap.js": {
-          "bytesInOutput": 11143
+          "bytesInOutput": 11303
         },
         "../lib/src/context/context.js": {
-          "bytesInOutput": 9410
+          "bytesInOutput": 9436
         },
         "../lib/src/utils/timer.js": {
           "bytesInOutput": 1783
@@ -10085,7 +10085,7 @@
           "bytesInOutput": 1595
         },
         "../lib/src/elements/poi2.js": {
-          "bytesInOutput": 12193
+          "bytesInOutput": 12704
         },
         "../lib/src/elements/heatmap.js": {
           "bytesInOutput": 2123
@@ -10178,7 +10178,7 @@
           "bytesInOutput": 186
         },
         "../lib/src/context/collision-system.js": {
-          "bytesInOutput": 2618
+          "bytesInOutput": 2629
         },
         "../lib/src/config.js": {
           "bytesInOutput": 1276
@@ -10340,7 +10340,7 @@
           "bytesInOutput": 0
         }
       },
-      "bytes": 452255
+      "bytes": 452963
     }
   }
 }

package/lib/src/bmap.d.ts

@@ -144,6 +144,14 @@ export declare class BMap extends EventDispatcher<BmapEventMap> {
     configurePolarShortcutKeys(keys: string[]): void;
     configureAzimuthalShortcutKeys(keys: string[]): void;
     rotateMap(radius?: number, duration?: number): void | Promise<unknown>;
+    /**
+     * 绘制 POI 碰撞检测包围盒（调试用，v1 DOM 文字与 v2 SDF 文字均支持）
+     */
+    showCollisionBox(): void;
+    /**
+     * 关闭 POI 碰撞检测包围盒绘制
+     */
+    hideCollisionBox(): void;
     /**
      * 测量距离
      * @returns

package/lib/src/context/context.d.ts

@@ -77,6 +77,8 @@ export declare class Context extends EventDispatcher<ContextEventMap> {
     };
     renderRf: number;
     basicZoom: number;
+    /** 是否绘制 POI 碰撞检测包围盒（调试用） */
+    debugCollisionBox: boolean;
     constructor(container: HTMLElement, bmap: BMap);
     get config(): import("..").Config;
     get center(): [number, number];

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

@@ -130,8 +130,23 @@ export declare class Poi2 extends Object3D<PoiEventMap2> {
         zoom: number;
     }) => void;
     resetZ(): void;
+    /**
+     * 标签渲染原点的世界坐标，供碰撞检测投影使用。
+     * 优先取文字/图标网格的实际世界坐标（包含 deltaZ 抬升与楼层等父级变换）；
+     * 标签被隐藏（网格未创建）时，按 deltaZ 估算。
+     * 这样包围盒的基准点与渲染一致，2D / 3D 视角下都不会错位。
+     */
+    getLabelOriginWorldPosition(target?: Vector3): Vector3;
+    /**
+     * 计算标签的屏幕包围盒（碰撞检测 & 点击拾取用）。
+     * v3 是「标签渲染原点」（见 getLabelOriginWorldPosition）的 NDC 坐标，
+     * 包围盒按渲染时的 pivot 布局构建：
+     * - 纯文字：文字块以原点为中心
+     * - 纯图标：图标以原点为中心
+     * - 图标+文字：图标底部贴原点，文字在图标上方，水平居中于原点
+     */
     getBox(v3: Vector3): Box2 | null;
-    renderBoxHelper(x?: number, y?: number): void;
+    renderBoxHelper(): void;
     setVisible(visible: boolean): void;
     parentSetVisible(visible: boolean): void;
     clearTextTextureCache(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibee/crc-bmap",
-  "version": "0.14.32",
+  "version": "0.14.33",
   "description": "",
   "main": "lib/index.cjs",
   "module": "lib/index.esm.min.js",