deeptwins-engine-3d 0.1.63 → 0.1.65

package/dist/esm/drawer/shape/SwallowtailArrow.js

@@ -0,0 +1,438 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _get() { if (typeof Reflect !== "undefined" && Reflect.get) { _get = Reflect.get.bind(); } else { _get = function _get(target, property, receiver) { var base = _superPropBase(target, property); if (!base) return; var desc = Object.getOwnPropertyDescriptor(base, property); if (desc.get) { return desc.get.call(arguments.length < 3 ? target : receiver); } return desc.value; }; } return _get.apply(this, arguments); }
+function _superPropBase(object, property) { while (!Object.prototype.hasOwnProperty.call(object, property)) { object = _getPrototypeOf(object); if (object === null) break; } return object; }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
+function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import * as Cesium from 'deeptwins-cesium';
+import { isNil } from 'lodash';
+import { calculateSwallowPoints } from "../common";
+import { STATUS } from "../types";
+import { normalizePolygonPositions } from "../utils";
+import BaseShape from "./BaseShape";
+import DragPoint from "./DragPoint";
+import { ShapePolygon } from "./Polygon";
+import { ShapePolyline } from "./Polyline";
+var SwallowtailArrow = /*#__PURE__*/function (_BaseShape) {
+  _inherits(SwallowtailArrow, _BaseShape);
+  var _super = _createSuper(SwallowtailArrow);
+  function SwallowtailArrow(drawContext, config) {
+    var _config$swallowtailTy;
+    var _this;
+    _classCallCheck(this, SwallowtailArrow);
+    _this = _super.call(this, drawContext);
+    _defineProperty(_assertThisInitialized(_this), "type", 'swallowtailArrow');
+    _defineProperty(_assertThisInitialized(_this), "shapePolylineLayer", void 0);
+    _defineProperty(_assertThisInitialized(_this), "shapePolygonLayer", void 0);
+    _defineProperty(_assertThisInitialized(_this), "_startPosition", void 0);
+    _defineProperty(_assertThisInitialized(_this), "_endPosition", void 0);
+    _defineProperty(_assertThisInitialized(_this), "_swallowtailType", void 0);
+    _this._startPosition = null;
+    _this._endPosition = null;
+    _this._swallowtailType = _this._normalizeSwallowtailType((_config$swallowtailTy = config === null || config === void 0 ? void 0 : config.swallowtailType) !== null && _config$swallowtailTy !== void 0 ? _config$swallowtailTy : config === null || config === void 0 ? void 0 : config.type);
+    _this.clampToGround = isNil(config === null || config === void 0 ? void 0 : config.clampToGround) ? _this.clampToGround : config.clampToGround;
+    _this.pointStyle.heightReference = _this.clampToGround ? Cesium.HeightReference.CLAMP_TO_GROUND : Cesium.HeightReference.NONE;
+    _this.polylineStyle.clampToGround = _this.clampToGround;
+    if (_this.clampToGround) {
+      _this.polygonStyle.heightReference = Cesium.HeightReference.CLAMP_TO_GROUND;
+      _this.polygonStyle.perPositionHeight = false;
+    } else {
+      _this.polygonStyle.heightReference = Cesium.HeightReference.NONE;
+      _this.polygonStyle.perPositionHeight = true;
+    }
+    return _this;
+  }
+
+  // 统一收敛燕尾箭头类型，避免外部传入非法值。
+  _createClass(SwallowtailArrow, [{
+    key: "_normalizeSwallowtailType",
+    value: function _normalizeSwallowtailType(value) {
+      var numericValue = Number(value);
+      if (!Number.isFinite(numericValue)) {
+        return 1;
+      }
+      return numericValue === 2 ? 2 : 1;
+    }
+
+    // 鼠标事件位置统一转成内部经纬高三元组。
+  }, {
+    key: "_toPositionTuple",
+    value: function _toPositionTuple(position) {
+      var lng = position.lng,
+        lat = position.lat,
+        _position$alt = position.alt,
+        alt = _position$alt === void 0 ? 0 : _position$alt;
+      return [lng, lat, alt];
+    }
+
+    // 贴地时高度统一为 0；非贴地时用两个控制点的平均高度近似。
+  }, {
+    key: "_getAltitudeBase",
+    value: function _getAltitudeBase(startPosition, endPosition) {
+      if (this.clampToGround) {
+        return 0;
+      }
+      var altitudes = [startPosition === null || startPosition === void 0 ? void 0 : startPosition[2], endPosition === null || endPosition === void 0 ? void 0 : endPosition[2]].filter(function (altitude) {
+        return Number.isFinite(altitude);
+      });
+      if (!altitudes.length) {
+        return 0;
+      }
+      return altitudes.reduce(function (sum, altitude) {
+        return sum + altitude;
+      }, 0) / altitudes.length;
+    }
+
+    // 渲染外框始终闭合，便于绘制和编辑阶段预览边界。
+  }, {
+    key: "_getDrawPolylinePositions",
+    value: function _getDrawPolylinePositions() {
+      if (!this.positions.length) {
+        return [];
+      }
+      return [].concat(_toConsumableArray(this.positions), [this.positions[0]]);
+    }
+
+    // polygon 渲染末尾补首点形成闭环。
+  }, {
+    key: "_getDrawPolygonPositions",
+    value: function _getDrawPolygonPositions() {
+      if (!this.positions.length) {
+        return [];
+      }
+      return [].concat(_toConsumableArray(this.positions), [this.positions[0]]);
+    }
+
+    // 统一释放线框和面图层，避免绘制中断后残留几何。
+  }, {
+    key: "_destroyShapeLayers",
+    value: function _destroyShapeLayers() {
+      this.shapePolylineLayer && this.shapePolylineLayer.destroy();
+      this.shapePolylineLayer = null;
+      this.shapePolygonLayer && this.shapePolygonLayer.destroy();
+      this.shapePolygonLayer = null;
+    }
+
+    // 根据当前顶点数组同步线框和面图层。
+  }, {
+    key: "_syncShapeLayers",
+    value: function _syncShapeLayers() {
+      if (!this.positions.length) {
+        this._destroyShapeLayers();
+        return;
+      }
+      var polylinePositions = this._getDrawPolylinePositions();
+      var polygonPositions = this._getDrawPolygonPositions();
+      if (!this.shapePolylineLayer) {
+        this.shapePolylineLayer = new ShapePolyline(this.getMap(), {
+          positions: polylinePositions,
+          style: this.polylineStyle
+        });
+      } else {
+        this.shapePolylineLayer.update(polylinePositions);
+      }
+      if (!this.shapePolygonLayer) {
+        this.shapePolygonLayer = new ShapePolygon(this.getMap(), {
+          positions: polygonPositions,
+          style: this.polygonStyle
+        });
+        return;
+      }
+      this.shapePolygonLayer.update(polygonPositions);
+    }
+
+    // 参考 drawer/common.calculateSwallowPoints(type=1/2)：用两端点计算燕尾箭头特征点。
+  }, {
+    key: "_buildSwallowtailArrowPositions",
+    value: function _buildSwallowtailArrowPositions(startPosition, endPosition, swallowtailType) {
+      var startCartesian = this._toCartesian3(startPosition);
+      var endCartesian = this._toCartesian3(endPosition);
+      if (!startCartesian) {
+        return [];
+      }
+      var anchorCartesians = endCartesian ? [startCartesian, endCartesian] : [startCartesian];
+      var degreeHeights;
+      try {
+        degreeHeights = calculateSwallowPoints(anchorCartesians, swallowtailType);
+      } catch (error) {
+        return [];
+      }
+      if (!Array.isArray(degreeHeights) || degreeHeights.length < 6) {
+        return [];
+      }
+      var altitudeBase = this._getAltitudeBase(startPosition, endPosition);
+      var positions = [];
+      for (var index = 0; index < degreeHeights.length; index += 3) {
+        var lng = degreeHeights[index];
+        var lat = degreeHeights[index + 1];
+        if (!Number.isFinite(lng) || !Number.isFinite(lat)) {
+          continue;
+        }
+        positions.push([lng, lat, altitudeBase]);
+      }
+      return normalizePolygonPositions(positions);
+    }
+
+    // 统一更新两个控制点、箭头类型、顶点数组和渲染图层。
+  }, {
+    key: "_applyGeometry",
+    value: function _applyGeometry(startPosition, endPosition) {
+      var swallowtailType = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : this._swallowtailType;
+      var positions = this._buildSwallowtailArrowPositions(startPosition, endPosition, swallowtailType);
+      if (positions.length < 3) {
+        this.positions = [];
+        this._destroyShapeLayers();
+        return false;
+      }
+      this._startPosition = startPosition ? _toConsumableArray(startPosition) : null;
+      this._endPosition = endPosition ? _toConsumableArray(endPosition) : null;
+      this._swallowtailType = swallowtailType;
+      this.positions = positions;
+      this._syncShapeLayers();
+      return true;
+    }
+
+    // 编辑结束或销毁时统一释放两个控制点。
+  }, {
+    key: "_destroyEditHandles",
+    value: function _destroyEditHandles() {
+      this.dragPoints.forEach(function (point) {
+        return point.destroy();
+      });
+      this.dragPoints = [];
+      this.dragLayer = null;
+      this.dragging = false;
+    }
+
+    // 创建编辑控制点：起点/终点负责调整燕尾箭头尺寸和朝向。
+  }, {
+    key: "_createEditHandle",
+    value: function _createEditHandle(position, role) {
+      var handle = new DragPoint(this.getMap(), {
+        positions: position,
+        style: this.pointStyle
+      });
+      handle.handleRole = role;
+      handle.startEdit();
+      return handle;
+    }
+
+    // 几何变化后把两个控制点同步到最新位置。
+  }, {
+    key: "_syncEditHandles",
+    value: function _syncEditHandles() {
+      var startHandle = this.dragPoints.find(function (point) {
+        return point.handleRole === 'start';
+      });
+      var endHandle = this.dragPoints.find(function (point) {
+        return point.handleRole === 'end';
+      });
+      if (startHandle && this._startPosition) {
+        startHandle.mouseDragChange({
+          lng: this._startPosition[0],
+          lat: this._startPosition[1],
+          alt: this._startPosition[2]
+        });
+      }
+      if (endHandle && this._endPosition) {
+        endHandle.mouseDragChange({
+          lng: this._endPosition[0],
+          lat: this._endPosition[1],
+          alt: this._endPosition[2]
+        });
+      }
+    }
+
+    // 绘制预览阶段透出当前燕尾箭头面顶点数组。
+  }, {
+    key: "_emitMouseMoveChange",
+    value: function _emitMouseMoveChange() {
+      this._drawContext.options.onMouseMoveChange && this._drawContext.options.onMouseMoveChange({
+        layer: this,
+        positions: this.positions
+      });
+    }
+
+    // 编辑态拖拽时透出最新燕尾箭头面顶点数组。
+  }, {
+    key: "_emitPointsChange",
+    value: function _emitPointsChange() {
+      var _this$_drawContext$op, _this$_drawContext$op2;
+      ((_this$_drawContext$op = this._drawContext.options) === null || _this$_drawContext$op === void 0 ? void 0 : _this$_drawContext$op.onPointsChange) && ((_this$_drawContext$op2 = this._drawContext.options) === null || _this$_drawContext$op2 === void 0 ? void 0 : _this$_drawContext$op2.onPointsChange({
+        layer: this,
+        positions: this.positions
+      }));
+    }
+
+    // 统一完成绘制：入库、触发回调并进入编辑态。
+  }, {
+    key: "_finishDraw",
+    value: function _finishDraw() {
+      if (!this.positions.length) {
+        return;
+      }
+      this._drawContext.setDrawerLayer(this.id, this);
+      this.drawEnd(this);
+      this.startEdit();
+    }
+
+    // 基于 anchors 还原燕尾箭头；缺少 anchors 时由 Drawer 回退为普通 polygon。
+  }, {
+    key: "transformData",
+    value: function transformData(_) {
+      var _config$swallowtailTy2;
+      var config = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+      var anchors = config === null || config === void 0 ? void 0 : config.anchors;
+      if (!Array.isArray(anchors) || anchors.length < 2) {
+        return false;
+      }
+      var swallowtailType = this._normalizeSwallowtailType((_config$swallowtailTy2 = config === null || config === void 0 ? void 0 : config.swallowtailType) !== null && _config$swallowtailTy2 !== void 0 ? _config$swallowtailTy2 : config === null || config === void 0 ? void 0 : config.type);
+      var startPosition = [anchors[0][0], anchors[0][1], anchors[0][2] || 0];
+      var endPosition = [anchors[1][0], anchors[1][1], anchors[1][2] || 0];
+      if (!this._applyGeometry(startPosition, endPosition, swallowtailType)) {
+        return false;
+      }
+      this._drawContext.setDrawerLayer(this.id, this);
+      return true;
+    }
+
+    // 第一次点击记录起点，第二次点击根据终点完成燕尾箭头绘制。
+  }, {
+    key: "addPoint",
+    value: function addPoint(position) {
+      var nextPosition = this._toPositionTuple(position);
+      if (!this._startPosition) {
+        this._startPosition = nextPosition;
+        this._endPosition = null;
+        this.positions = [];
+        this._drawContext._changeStatus(STATUS.DRAWING);
+        this._drawContext._updateTooltip();
+        return;
+      }
+      if (!this._applyGeometry(this._startPosition, nextPosition, this._swallowtailType)) {
+        return;
+      }
+      this.drawing(this);
+      this._finishDraw();
+    }
+
+    // 鼠标移动时根据当前终点实时预览燕尾箭头。
+  }, {
+    key: "updateTempPosition",
+    value: function updateTempPosition(position) {
+      if (!this._startPosition) {
+        return;
+      }
+      var nextPosition = this._toPositionTuple(position);
+      if (!this._applyGeometry(this._startPosition, nextPosition, this._swallowtailType)) {
+        return;
+      }
+      this._emitMouseMoveChange();
+    }
+
+    // 兼容外部显式结束绘制的调用，按当前控制点收敛最终 geometry。
+  }, {
+    key: "endDraw",
+    value: function endDraw() {
+      if (!this._startPosition || !this._endPosition) {
+        return;
+      }
+      if (!this._applyGeometry(this._startPosition, this._endPosition, this._swallowtailType)) {
+        return;
+      }
+      this._finishDraw();
+    }
+
+    // 编辑态只保留两个控制点，避免退化为普通 polygon 的逐点编辑。
+  }, {
+    key: "startEdit",
+    value: function startEdit() {
+      if (!this._startPosition || !this._endPosition) {
+        return;
+      }
+      _get(_getPrototypeOf(SwallowtailArrow.prototype), "startEdit", this).call(this);
+      this._destroyEditHandles();
+      this.dragPoints = [this._createEditHandle(this._startPosition, 'start'), this._createEditHandle(this._endPosition, 'end')];
+    }
+
+    // 记录当前拖拽的控制点。
+  }, {
+    key: "mouseDragStart",
+    value: function mouseDragStart(position, dragLayer) {
+      var _this$dragLayer;
+      this.dragging = true;
+      this.dragLayer = dragLayer;
+      (_this$dragLayer = this.dragLayer) === null || _this$dragLayer === void 0 || _this$dragLayer.mouseDragStart();
+    }
+
+    // 拖拽起点/终点时重新计算燕尾箭头特征点。
+  }, {
+    key: "mouseDragChange",
+    value: function mouseDragChange(position) {
+      if (!this.dragging || !this.dragLayer) {
+        return;
+      }
+      if (!this._startPosition || !this._endPosition) {
+        return;
+      }
+      var nextPosition = this._toPositionTuple(position);
+      var nextStartPosition = _toConsumableArray(this._startPosition);
+      var nextEndPosition = _toConsumableArray(this._endPosition);
+      if (this.dragLayer.handleRole === 'start') {
+        nextStartPosition = nextPosition;
+      } else {
+        nextEndPosition = nextPosition;
+      }
+      if (!this._applyGeometry(nextStartPosition, nextEndPosition, this._swallowtailType)) {
+        return;
+      }
+      this._syncEditHandles();
+      this._emitPointsChange();
+    }
+
+    // 结束拖拽时只清理状态。
+  }, {
+    key: "mouseDragEnd",
+    value: function mouseDragEnd() {
+      this.dragging = false;
+      this.dragLayer = null;
+    }
+
+    // 结束编辑后销毁两个控制点。
+  }, {
+    key: "endEdit",
+    value: function endEdit(layer) {
+      var emitComplete = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
+      _get(_getPrototypeOf(SwallowtailArrow.prototype), "endEdit", this).call(this, layer, emitComplete);
+      this._destroyEditHandles();
+    }
+
+    // 销毁时同时清理渲染图层和内部几何状态。
+  }, {
+    key: "destroy",
+    value: function destroy() {
+      _get(_getPrototypeOf(SwallowtailArrow.prototype), "destroy", this).call(this);
+      this._destroyShapeLayers();
+      this._startPosition = null;
+      this._endPosition = null;
+    }
+  }]);
+  return SwallowtailArrow;
+}(BaseShape);
+export default SwallowtailArrow;

package/dist/esm/drawer/types.d.ts

@@ -0,0 +1,23 @@
+export interface DrawContext {
+    options: any;
+    getMap: any;
+    setDrawerLayer: any;
+    _changeStatus: any;
+    _updateTooltip: any;
+}
+export interface DataTransformDrawOptions {
+    type?: string;
+    center?: [number, number] | [number, number, number];
+    featureTypeField?: string;
+    featureConfigField?: string;
+    [key: string]: any;
+}
+export declare const STATUS: {
+    readonly INIT: "INIT";
+    readonly START_DRAW: "START_DRAW";
+    readonly DRAWING: "DRAWING";
+    readonly END_DRAW: "END_DRAW";
+    readonly EDITING: "EDITING";
+    readonly END_EDIT: "END_EDIT";
+};
+export type Status = (typeof STATUS)[keyof typeof STATUS];

package/dist/esm/drawer/types.js

@@ -0,0 +1,11 @@
+// 状态表定义
+export var STATUS = {
+  INIT: 'INIT',
+  START_DRAW: 'START_DRAW',
+  DRAWING: 'DRAWING',
+  END_DRAW: 'END_DRAW',
+  EDITING: 'EDITING',
+  END_EDIT: 'END_EDIT'
+};
+
+// 从状态表推导类型

package/dist/esm/drawer/utils.d.ts

@@ -1 +1,15 @@
+import type { DataTransformDrawOptions } from './types';
 export declare const HANDLE_FEATURE_DATA_TYPE_FUN: any;
+export declare function normalizePolygonPositions(positions?: any[]): any[][];
+export declare function getPolygonRestoreCenterPosition(positions: any[]): [number, number, number] | null;
+export declare function getPolygonRestoreHandlePosition(positions: any[]): [number, number, number] | null;
+export declare function getSectorRestoreAnchors(positions: any[]): [[number, number, number], [number, number, number], [number, number, number]] | null;
+export declare function normalizeDataTransformDrawOptions(options?: DataTransformDrawOptions): {
+    type: string | undefined;
+    shapeOptions: any;
+    featureTypeField: string;
+    featureConfigField: string;
+};
+export declare function getDefaultDrawerShapeType(geometryType: string): string;
+export declare function isShapeTypeCompatible(shapeType: string, geometryType: string): boolean;
+export declare function getDrawerRestoreItems(feature: any, options?: DataTransformDrawOptions): any[];