@ray-js/robot-map-sdk 0.0.15 → 0.0.16-beta.2

package/dist/index.d.ts

@@ -622,6 +622,23 @@ export declare type BaseCustomElementParam = {
     customData?: Record<string, any>
     /** 尺寸是否固定 */
     sizeFixed?: boolean
+    /**
+     * 屏幕像素偏移（仅 `sizeFixed: true` 生效）
+     *
+     * 在元素锚定到 (x, y) 之后，再按「屏幕像素」平移指定距离。该偏移不随地图
+     * 缩放或旋转变化，始终对应相同的屏幕位移——与房间属性气泡停留在房间名上方
+     * 的行为一致。适合把图标稳定贴在气泡旁边等固定相对位置。
+     *
+     * 坐标约定（与 PIXI 屏幕坐标及 `getWallPointsByViewportCenter` 等 offset API 一致）：
+     * - `x` 正值向右，负值向左
+     * - `y` 正值向下，负值向上
+     *
+     * 例：贴在房间属性气泡上方 → `pixelOffset: { x: 12, y: -10 }`。
+     *
+     * 注意：`sizeFixed` 为 `false` 或未设置时该字段被忽略（随缩放变化的尺寸与
+     * 固定像素偏移没有自洽语义）。
+     */
+    pixelOffset?: Point
 }
 
 /** 区域和地毯配置的基础类型 */