@kq_npm/client3d_webgl_vue 4.5.55 → 4.5.57

package/buildpolylinemodel/index.js

@@ -12,7 +12,7 @@ return /******/ (function() { // webpackBootstrap
 /******/ 	"use strict";
 /******/ 	var __webpack_modules__ = ({
 
-/***/ 6265:
+/***/ 4152:
 /***/ (function(module, __webpack_exports__, __webpack_require__) {
 
 /* harmony import */ var _node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(76314);
@@ -21,7 +21,7 @@ return /******/ (function() { // webpackBootstrap
 
 var ___CSS_LOADER_EXPORT___ = _node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0___default()(function(i){return i[1]});
 // Module
-___CSS_LOADER_EXPORT___.push([module.id, "\n.simple-filter-select[data-v-7dc066c9] {\r\n  width: 100%;\n}\n.option-content[data-v-7dc066c9] {\r\n  display: flex;\r\n  justify-content: space-between;\r\n  align-items: center;\r\n  width: 100%;\r\n  padding: 0 4px;\n}\n.option-text[data-v-7dc066c9] {\r\n  flex: 1;\r\n  overflow: hidden;\r\n  text-overflow: ellipsis;\r\n  white-space: nowrap;\n}\n.icon-class[data-v-7dc066c9] {\r\n  font-size: 14px;\r\n  padding: 4px;\n}\n.icon-class[data-v-7dc066c9]:hover {\r\n  color: var(--kq-color-danger);\n}\n[data-v-7dc066c9] .kq-option:hover .delete-btn {\r\n  opacity: 1;\n}\n[data-v-7dc066c9] .custom-select-popper {\r\n  --kq-select-dropdown-item-padding: 4px 8px;\n}\n[data-v-7dc066c9] .kq-option {\r\n  padding: 0 !important;\n}\r\n", ""]);
+___CSS_LOADER_EXPORT___.push([module.id, "\n.simple-filter-select[data-v-8bb64ace] {\r\n  width: 100%;\n}\n.option-content[data-v-8bb64ace] {\r\n  display: flex;\r\n  justify-content: space-between;\r\n  align-items: center;\r\n  width: 100%;\r\n  padding: 0 4px;\n}\n.option-text[data-v-8bb64ace] {\r\n  flex: 1;\r\n  overflow: hidden;\r\n  text-overflow: ellipsis;\r\n  white-space: nowrap;\n}\n.icon-class[data-v-8bb64ace] {\r\n  font-size: 14px;\r\n  padding: 4px;\n}\n.icon-class[data-v-8bb64ace]:hover {\r\n  color: var(--kq-color-danger);\n}\n[data-v-8bb64ace] .kq-option:hover .delete-btn {\r\n  opacity: 1;\n}\n[data-v-8bb64ace] .custom-select-popper {\r\n  --kq-select-dropdown-item-padding: 4px 8px;\n}\n[data-v-8bb64ace] .kq-option {\r\n  padding: 0 !important;\n}\r\n", ""]);
 // Exports
 /* harmony default export */ __webpack_exports__.A = (___CSS_LOADER_EXPORT___);
 
@@ -56,7 +56,28 @@ module.exports = __WEBPACK_EXTERNAL_MODULE__22686__;
 
 /***/ }),
 
-/***/ 28153:
+/***/ 29371:
+/***/ (function(module) {
+
+module.exports = require("@element-plus/icons-vue");
+
+/***/ }),
+
+/***/ 33751:
+/***/ (function(module) {
+
+module.exports = require("@babel/runtime/helpers/interopRequireDefault");
+
+/***/ }),
+
+/***/ 42975:
+/***/ (function(module) {
+
+module.exports = __WEBPACK_EXTERNAL_MODULE__42975__;
+
+/***/ }),
+
+/***/ 46066:
 /***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
 
 // ESM COMPAT FLAG
@@ -75,9 +96,9 @@ var filterConditionSelectvue_type_script_setup_true_lang_js = __webpack_require_
 // EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/injectStylesIntoStyleTag.js
 var injectStylesIntoStyleTag = __webpack_require__(85072);
 var injectStylesIntoStyleTag_default = /*#__PURE__*/__webpack_require__.n(injectStylesIntoStyleTag);
-// EXTERNAL MODULE: ./node_modules/css-loader/dist/cjs.js!./node_modules/vue-loader/dist/stylePostLoader.js!./node_modules/vue-loader/dist/index.js??ruleSet[0].use[0]!./src/webgl/buildpolylinemodel/filterConditionSelect.vue?vue&type=style&index=0&id=7dc066c9&scoped=true&lang=css
-var filterConditionSelectvue_type_style_index_0_id_7dc066c9_scoped_true_lang_css = __webpack_require__(6265);
-;// ./node_modules/style-loader/dist/cjs.js!./node_modules/css-loader/dist/cjs.js!./node_modules/vue-loader/dist/stylePostLoader.js!./node_modules/vue-loader/dist/index.js??ruleSet[0].use[0]!./src/webgl/buildpolylinemodel/filterConditionSelect.vue?vue&type=style&index=0&id=7dc066c9&scoped=true&lang=css
+// EXTERNAL MODULE: ./node_modules/css-loader/dist/cjs.js!./node_modules/vue-loader/dist/stylePostLoader.js!./node_modules/vue-loader/dist/index.js??ruleSet[0].use[0]!./src/webgl/buildpolylinemodel/filterConditionSelect.vue?vue&type=style&index=0&id=8bb64ace&scoped=true&lang=css
+var filterConditionSelectvue_type_style_index_0_id_8bb64ace_scoped_true_lang_css = __webpack_require__(4152);
+;// ./node_modules/style-loader/dist/cjs.js!./node_modules/css-loader/dist/cjs.js!./node_modules/vue-loader/dist/stylePostLoader.js!./node_modules/vue-loader/dist/index.js??ruleSet[0].use[0]!./src/webgl/buildpolylinemodel/filterConditionSelect.vue?vue&type=style&index=0&id=8bb64ace&scoped=true&lang=css
 
             
 
@@ -86,12 +107,12 @@ var options = {};
 options.insert = "head";
 options.singleton = false;
 
-var update = injectStylesIntoStyleTag_default()(filterConditionSelectvue_type_style_index_0_id_7dc066c9_scoped_true_lang_css/* default */.A, options);
+var update = injectStylesIntoStyleTag_default()(filterConditionSelectvue_type_style_index_0_id_8bb64ace_scoped_true_lang_css/* default */.A, options);
 
 
 
-/* harmony default export */ var buildpolylinemodel_filterConditionSelectvue_type_style_index_0_id_7dc066c9_scoped_true_lang_css = (filterConditionSelectvue_type_style_index_0_id_7dc066c9_scoped_true_lang_css/* default */.A.locals || {});
-;// ./src/webgl/buildpolylinemodel/filterConditionSelect.vue?vue&type=style&index=0&id=7dc066c9&scoped=true&lang=css
+/* harmony default export */ var buildpolylinemodel_filterConditionSelectvue_type_style_index_0_id_8bb64ace_scoped_true_lang_css = (filterConditionSelectvue_type_style_index_0_id_8bb64ace_scoped_true_lang_css/* default */.A.locals || {});
+;// ./src/webgl/buildpolylinemodel/filterConditionSelect.vue?vue&type=style&index=0&id=8bb64ace&scoped=true&lang=css
 
 // EXTERNAL MODULE: ./node_modules/vue-loader/dist/exportHelper.js
 var exportHelper = __webpack_require__(66262);
@@ -102,33 +123,12 @@ var exportHelper = __webpack_require__(66262);
 ;
 
 
-const __exports__ = /*#__PURE__*/(0,exportHelper/* default */.A)(filterConditionSelectvue_type_script_setup_true_lang_js/* default */.A, [['__scopeId',"data-v-7dc066c9"]])
+const __exports__ = /*#__PURE__*/(0,exportHelper/* default */.A)(filterConditionSelectvue_type_script_setup_true_lang_js/* default */.A, [['__scopeId',"data-v-8bb64ace"]])
 
 /* harmony default export */ var filterConditionSelect = (__exports__);
 
 /***/ }),
 
-/***/ 29371:
-/***/ (function(module) {
-
-module.exports = require("@element-plus/icons-vue");
-
-/***/ }),
-
-/***/ 33751:
-/***/ (function(module) {
-
-module.exports = require("@babel/runtime/helpers/interopRequireDefault");
-
-/***/ }),
-
-/***/ 42975:
-/***/ (function(module) {
-
-module.exports = __WEBPACK_EXTERNAL_MODULE__42975__;
-
-/***/ }),
-
 /***/ 48232:
 /***/ (function(__unused_webpack_module, exports, __webpack_require__) {
 
@@ -145,12 +145,23 @@ var _useGlobalConfig = __webpack_require__(22686);
 // BuildPolylineModelViewModel.js
 
 class BuildPolylineModelViewModel {
+  // 国际化语言对象
+  /**
+   * @description 构造函数
+   * @param {Object} scenceView 三维场景视图
+   * @param {Object} formItem 表单配置项
+   */
   constructor(scenceView, formItem) {
     this._options = {};
+    // 表单配置项
     this._scenceView = null;
+    // 三维场景视图
     this._layerData = null;
+    // 输入的 geojson 数据
     this._polylineModel = null;
+    // 当前编辑的线模型
     this._polylineModels = [];
+    // 生成的线模型集合
     this._language = null;
     this._scenceView = scenceView;
     this._options = formItem;
@@ -160,7 +171,11 @@ class BuildPolylineModelViewModel {
     this._language = locale;
   }
 
-  // 获取模型
+  /**
+   * @description 通过 key 获取已存在的线模型并执行回调
+   * @param {String} key 模型 id
+   * @param {Function} cb 回调函数
+   */
   getPolylineModel(key, cb) {
     const primitives = this?._scenceView?._viewer?.scene?.primitives?._primitives ?? [];
     this._polylineModel = primitives.find(element => element._key === key);
@@ -169,9 +184,15 @@ class BuildPolylineModelViewModel {
     }
   }
 
-  // 参数变化处理
+  /**
+   * @description 参数变化处理，将变更同步至当前编辑模型
+   * @param {String} key 参数名
+   * @param {Object} editMode 编辑模式（add：新增，其他：编辑）
+   */
   paramsChanged(key, editMode) {
+    // 新增模式不处理参数变更
     if (editMode.value === "add") return;
+    // 无编辑模型时提示并返回
     if (!this._polylineModel) {
       (0, _message.default)({
         message: this._language.value.webgl.noEditModelData,
@@ -179,6 +200,7 @@ class BuildPolylineModelViewModel {
       });
       return;
     }
+    // 参数处理映射表
     const paramHandlers = {
       customShape: () => this._handleCustomShape(),
       shape: () => this._handleShape(key),
@@ -194,18 +216,26 @@ class BuildPolylineModelViewModel {
       wallTopTexture: () => this._wallTexture(key),
       groundHeight: () => this._groundHeight(key)
     };
+
+    // 默认处理：直接赋值
     const handler = paramHandlers[key] || (() => {
       this._polylineModel[key] = this._options[key];
     });
     handler();
   }
 
-  // 生成模型
+  /**
+   * @description 生成线模型
+   * @param {String} type 模型类型
+   * @param {Function} cb 生成完成回调函数
+   */
   generated(type, cb) {
     if (!this._validateInput(type)) return;
     try {
       this._polylineModels = [];
       const features = this._getValidFeatures();
+
+      // 无有效要素数据时提示
       if (!features?.length) {
         _message.default.warning(this._language.value.webgl.noGeoJSONData);
         return;
@@ -217,7 +247,11 @@ class BuildPolylineModelViewModel {
     }
   }
 
-  // 私有方法
+  /**
+   * @description 校验输入数据是否有效
+   * @param {String} type 模型类型
+   * @returns {Boolean} 校验是否通过
+   */
   _validateInput(type) {
     if (!this._layerData) {
       _message.default.warning(this._language.value.webgl.noGeoJSONData);
@@ -225,10 +259,18 @@ class BuildPolylineModelViewModel {
     }
     return true;
   }
+
+  // 获取过滤并处理后的有效要素数组
   _getValidFeatures() {
     const filteredData = _polylineModelUtils.DataProcessor.filterData(this._layerData, this._options.selectModelId);
     return _polylineModelUtils.DataProcessor.processGeoJSON(filteredData);
   }
+
+  /**
+   * @description 遍历要素创建线模型
+   * @param {String} type 模型类型
+   * @param {Array} features 要素数组
+   */
   _createModels(type, features) {
     features.forEach((feature, index) => {
       const {
@@ -242,8 +284,18 @@ class BuildPolylineModelViewModel {
       this._addModelToScene(type, config);
     });
   }
+
+  /**
+   * @description 根据类型生成模型配置
+   * @param {String} type 模型类型
+   * @param {Object} properties 要素属性
+   * @param {Array} positions 坐标点数组
+   * @param {Number} index 要素索引
+   * @returns {Object} 模型配置对象
+   */
   _createModelConfig(type, properties, positions, index) {
     const baseConfig = _polylineModelUtils.ModelConfigGenerator.getBaseConfig(type, properties, positions, index, this._options);
+    // 按模型类型生成特定配置
     const typeConfigs = {
       [_polylineModelUtils.MODEL_TYPES.ROAD]: _polylineModelUtils.ModelConfigGenerator.getRoadWallConfig(properties, positions, this._options),
       [_polylineModelUtils.MODEL_TYPES.WALL]: _polylineModelUtils.ModelConfigGenerator.getRoadWallConfig(properties, positions, this._options),
@@ -256,6 +308,12 @@ class BuildPolylineModelViewModel {
       ...(typeConfigs[type] || {})
     };
   }
+
+  /**
+   * @description 将模型添加到场景中
+   * @param {String} type 模型类型
+   * @param {Object} config 模型配置
+   */
   _addModelToScene(type, config) {
     try {
       //开启深度检测,放置飘
@@ -267,46 +325,68 @@ class BuildPolylineModelViewModel {
       console.error(`创建 ${type} 模型失败:`, error);
     }
   }
+
+  /**
+   * @description 触发生成完成回调
+   * @param {Function} cb 回调函数
+   */
   _invokeCallback(cb) {
     if (typeof cb === "function" && this._polylineModels?.length > 0) {
       cb(this._polylineModels);
     }
   }
 
-  // 参数处理的具体方法
+  // 处理自定义形状参数
   _handleCustomShape() {
     if (this._options.customShape) {
       this._polylineModel.customShape = JSON.parse(this._options.customShape);
       this._polylineModel.shape = "custom";
     }
   }
-  // 参数处理的具体方法
+  /**
+   * @description 处理形状参数变化
+   * @param {String} key 参数名
+   */
   _handleShape(key) {
     const shape = this._options?.shape || this._polylineModel.shape;
     const isFlowingType = ["circle", "semicircle"].includes(shape);
     const isSimpleType = ["box", "arch", "concavity"].includes(shape);
     this._polylineModel.shape = shape;
+    // 流动类型使用管道贴图
     if (isFlowingType) {
       this._handleImage("pipeImage");
     } else if (isSimpleType) {
+      // 简单类型清空贴图
       this._polylineModel.image = "null";
     }
   }
+
+  // 处理偏移参数
   _handleOffset() {
     this._polylineModel.offset = {
       x: this._options.offsetX,
       y: this._options.offsetY
     };
   }
+
+  // 处理模型名称参数
   _handleModelName() {
     this._polylineModel.label = this._options.ofModelName || this._polylineModel.label;
   }
+
+  // 处理道路高度参数
   _handleRoadHeight() {
     this._polylineModel.height = this._options.roadHeight || this._polylineModel.height;
   }
+
+  // 处理半径参数
   _handleRadius() {
     this._polylineModel.width = this._options.radius || this._polylineModel.width;
   }
+  /**
+   * @description 处理地面高度参数，水系放样时更新 height
+   * @param {String} key 参数名
+   */
   _groundHeight(key) {
     if (this._polylineModel?._modelingType == "waterLofting") {
       this._polylineModel.height = this._options[key];
@@ -314,30 +394,49 @@ class BuildPolylineModelViewModel {
       this._polylineModel.groundHeight = this._options[key];
     }
   }
+  // 处理水系宽度参数
   _handleWaterWidth() {
     this._polylineModel.width = this._options.waterWidth || this._polylineModel.width;
   }
+  // 处理按尺寸重复参数
   _repeatBySize() {
     this._polylineModel.repeatBySize = this._options.repeatBySize == 0 ? true : false;
   }
+  /**
+   * @description 处理贴图参数
+   * @param {String} key 参数名
+   */
   _handleImage(key) {
     this._polylineModel.image = this._options[key] || "null";
   }
+  /**
+   * @description 处理墙体纹理参数
+   * @param {String} key 参数名
+   */
   _wallTexture(key) {
     this._polylineModel[key] = this._options[key] || "null";
   }
-  // 其他方法保持不变
+  // 清空模型数据
   clear() {
     this._layerData = null;
     this._polylineModels = [];
     this._polylineModel = null;
   }
+
+  // 销毁并释放资源
   destroy() {
     this.clear();
   }
+
+  // 导出已生成的模型集合
   exportModels() {
     return this._polylineModels;
   }
+
+  /**
+   * @description 导入模型数据并添加到场景
+   * @param {Array} jsons 模型 JSON 数据数组
+   */
   importModels(jsons) {
     jsons.forEach(jsonData => {
       try {
@@ -350,12 +449,35 @@ class BuildPolylineModelViewModel {
   }
 
   // 保持对外的工具方法接口
+  /**
+   * @description 获取字符串类型属性值
+   * @param {Object} properties 要素属性
+   * @param {String} fieldKey 字段映射键
+   * @param {String} propKey 属性键
+   * @param {String} defaultValue 默认值
+   * @returns {String} 属性值
+   */
   getStringValue(properties, fieldKey, propKey, defaultValue = "") {
     return _polylineModelUtils.DataExtractor.getStringValue(properties, fieldKey, propKey, defaultValue, this._options);
   }
+
+  /**
+   * @description 获取数字类型属性值
+   * @param {Object} properties 要素属性
+   * @param {String} fieldKey 字段映射键
+   * @param {String} propKey 属性键
+   * @param {Number} defaultValue 默认值
+   * @returns {Number} 属性值
+   */
   getNumberValue(properties, fieldKey, propKey, defaultValue = 0) {
     return _polylineModelUtils.DataExtractor.getNumberValue(properties, fieldKey, propKey, defaultValue, this._options);
   }
+
+  /**
+   * @description 提取所有属性字段
+   * @param {Object} geojsonData geojson 数据
+   * @returns {Array} 属性字段数组
+   */
   extractPropertyFields(geojsonData) {
     return _polylineModelUtils.DataExtractor.extractPropertyFields(geojsonData);
   }
@@ -421,7 +543,7 @@ var _message = _interopRequireDefault(__webpack_require__(71323));
 var _BuildPolylineModelViewModel = _interopRequireDefault(__webpack_require__(48232));
 var _util = __webpack_require__(42975);
 var _useGlobalConfig = __webpack_require__(22686);
-var _filterConditionSelect = _interopRequireDefault(__webpack_require__(28153));
+var _filterConditionSelect = _interopRequireDefault(__webpack_require__(46066));
 const _hoisted_1 = {
   key: 0,
   class: "spanTile"
@@ -535,7 +657,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     const emit = __emit;
     // 获取组件传参
     const props = __props;
+    // 当前模式（add：新增，edit：编辑）
     const mode = (0, _vue.computed)(() => props?.settingParams?.mode ?? "add");
+    // 表单配置项
     let formItem = (0, _vue.reactive)({
       collapseValue: props?.settingParams?.collapseValue ?? "general",
       // 默认展开属性设置
@@ -555,10 +679,15 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       offsetY: props?.settingParams?.offsetY ?? 0,
       // 偏移y
       offsetStep: props?.settingParams?.scaleStep ?? 0.1,
+      // 偏移步长
       minOffset: props?.settingParams?.minOffset ?? -100,
+      // 最小偏移
       maxOffset: props?.settingParams?.maxOffset ?? 100,
+      // 最大偏移
       rotate: props?.settingParams?.rotate ?? 0,
+      // 旋转角度
       rotateFields: props?.settingParams?.rotateFields ?? "",
+      // 旋转字段
       color: props?.settingParams?.color ?? "#FFFFFF",
       // 颜色
       colorFields: props?.settingParams?.colorFields ?? "",
@@ -675,7 +804,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     });
     // 纹理图片
     let materials = (0, _vue.computed)(() => props?.materials || []);
+    // 重复模式选项
     const repeatModes = (0, _vue.ref)([locale.value.webgl.actualSize, locale.value.webgl.repeatCount]);
+    // 管道类型选项
     const pipelineTypes = (0, _vue.ref)([{
       name: locale.value.webgl.circularPipe,
       value: "circle"
@@ -692,6 +823,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       name: locale.value.webgl.concavePipe,
       value: "concavity"
     }]);
+    // 管道材质选项
     const pipelineMaterials = (0, _vue.ref)([{
       name: locale.value.webgl.circularPipe,
       value: "circle"
@@ -701,10 +833,12 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     let boxRef = (0, _vue.ref)(null);
     // 生成组件默认header
     let headerTemp = (0, _vue.ref)();
-    let headerTempRef = (0, _vue.ref)();
-    let viewModel = null;
-    let modelingTypes = (0, _vue.ref)(null);
-    let propertyFieldsDef = (0, _vue.ref)([]);
+    let headerTempRef = (0, _vue.ref)(); // headerTemp 组件引用
+    let viewModel = null; // 业务逻辑 ViewModel 实例
+    let modelingTypes = (0, _vue.ref)(null); // 当前放样类型
+    let propertyFieldsDef = (0, _vue.ref)([]); // 属性字段定义列表
+
+    // 容器最大高度
     const maxHeight = (0, _vue.computed)(() => props?.maxHeight ?? 605);
     // 控制是否加滚动样式
     const needScroll = (0, _vue.ref)(false);
@@ -712,11 +846,14 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     const scrollBox = (0, _vue.ref)(null);
     // 监听元素尺寸变化（内容变化自动触发）
     let resizeObserver = null;
+    // 组件挂载：初始化位置、监听、ViewModel 及滚动
     (0, _vue.onMounted)(() => {
       (0, _util.updatePosition)(boxRef.value, props);
+      // 监听位置变化更新组件定位
       (0, _vue.watch)(() => props.position, (newVal, oldVal) => {
         (0, _util.updatePosition)(boxRef.value, props);
       });
+      // 监听模式变化重置折叠项
       (0, _vue.watch)(mode, newMode => {
         formItem.collapseValue = "general";
         if (newMode == "add") modelingTypes.value = null;
@@ -724,11 +861,14 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         immediate: true
       });
       watchCreateHeaderTemp();
+      // 监听是否显示 header 变化
       (0, _vue.watch)(() => props.showHeaderTemp, (newVal, oldVal) => {
         (0, _vue.nextTick)(() => {
           watchCreateHeaderTemp();
         });
       });
+
+      // 获取地图视图并初始化 ViewModel
       _gisUtils.utils.getWebMap(props.mapTarget, scenceView => {
         if (scenceView) {
           viewModel = new _BuildPolylineModelViewModel.default(scenceView, formItem);
@@ -736,6 +876,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       });
       initScroll();
     });
+    // 初始化滚动监听
     function initScroll() {
       const el = scrollBox.value;
       if (!el) return;
@@ -766,22 +907,28 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         headerTemp.value = (0, _util.createHeaderTemp)(boxRef.value, (0, _vue.toRefs)(props), headerTempRef, "webgl.buildPolylineModel");
       }
     };
-    // 参数切换
+    /**
+     * @description 参数切换，同步至 ViewModel 并触发变更处理
+     * @param {String} key 参数名
+     */
     function paramsChanged(key) {
       if (!viewModel) return;
       viewModel._options[key] = formItem[key];
       viewModel.paramsChanged(key, mode);
+      // 编辑模式下模型名变更时通知父组件
       if (mode.value == "edit" && key == "ofModelName") {
         emit("changeModelName", formItem.ofModelName);
       }
     }
     /**
-     * @description 初始化事件
+     * @description 初始化事件，根据传入数据回填表单或设置图层
+     * @param {Object|String} data 模型 id 或 geojson 数据
      */
     function setData(data) {
       if (data) {
         if (!viewModel) return;
         clear();
+        // 字符串类型：编辑模式，根据 id 获取已存在模型并回填表单
         if (typeof data === "string") {
           viewModel.getPolylineModel(data, item => {
             const jsonData = item?.toJSON?.();
@@ -796,6 +943,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
               style
             } = jsonData;
             modelingTypes.value = modelingType ?? modelingTypes.value;
+            // 校验图片地址有效性
             const getValidImage = imagePath => imagePath && imagePath !== "null" && imagePath !== "undefined" ? imagePath : "";
             Object.assign(formItem, {
               // 通用参数回填
@@ -842,6 +990,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
             });
           });
         } else {
+          // 对象类型：新增模式，设置图层数据并提取属性字段
           viewModel._layerData = data;
           let propertyFields = viewModel.extractPropertyFields(data);
           if (propertyFields && propertyFields.length > 0) {
@@ -852,8 +1001,12 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         console.log("重新传入数据");
       }
     }
-    // 生成
+    /**
+     * @description 生成线模型
+     * @param {String} type 模型类型
+     */
     function generated(type) {
+      // 自定义放样需校验自定义形状
       if (type == "customLofting") {
         if (!formItem.customShape) {
           _message.default.warning(locale.value.webgl.noCustomData);
@@ -864,9 +1017,14 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         emit("generatedEnd", data);
       });
     }
+    /**
+     * @description 处理过滤条件变更
+     * @param {String} condition 过滤条件
+     */
     const handleFilterChange = condition => {
       formItem.selectModelId = condition;
     };
+    // 清空模型数据
     function clear() {
       viewModel?.clear();
     }
@@ -875,9 +1033,14 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       clear();
       resizeObserver?.disconnect();
     });
+    // 导出已生成的模型集合
     function exportModels() {
       return viewModel.exportModels();
     }
+    /**
+     * @description 导入模型数据
+     * @param {Array} jsons 模型 JSON 数据数组
+     */
     function importModels(jsons) {
       return viewModel.importModels(jsons);
     }
@@ -3043,11 +3206,11 @@ var _default = exports.A = {
       lang,
       locale
     } = (0, _useGlobalConfig.useLocale)();
-    const selectRef = (0, _vue.ref)(null);
+    const selectRef = (0, _vue.ref)(null); // 下拉选择组件引用
     const props = __props;
-    const selectedCondition = (0, _vue.ref)("");
-    const filterConditions = (0, _vue.ref)([...props.initialConditions]);
-    const selectKey = (0, _vue.ref)(0);
+    const selectedCondition = (0, _vue.ref)(""); // 当前选中的过滤条件
+    const filterConditions = (0, _vue.ref)([...props.initialConditions]); // 过滤条件列表
+    const selectKey = (0, _vue.ref)(0); // 下拉组件 key，用于强制刷新
     const emit = __emit;
 
     // 监听初始条件变化
@@ -3060,24 +3223,37 @@ var _default = exports.A = {
       immediate: true
     });
 
-    // 处理选中/新增逻辑
+    /**
+     * @description 处理选中/新增条件逻辑
+     * @param {String} value 选中的条件值
+     */
     const handleConditionChange = async value => {
       if (!value) return;
       const isExist = filterConditions.value.includes(value);
+      // 新条件加入列表
       if (!isExist) {
         filterConditions.value.push(value);
         await (0, _vue.nextTick)();
       }
       emit("condition-change", value);
     };
+
+    /**
+     * @description 处理新建条件逻辑
+     * @param {String} item 新建的条件值
+     */
     const handleCreateCondition = async item => {
       if (!item) return;
       await handleConditionChange(item);
       selectedCondition.value = item;
     };
-    // 
+    /**
+     * @description 删除指定条件选项
+     * @param {String} condition 待删除的条件
+     */
     const handleDeleteOption = async condition => {
       filterConditions.value = filterConditions.value.filter(item => item !== condition);
+      // 删除的是当前选中项时清空选中
       if (selectedCondition.value === condition) {
         selectedCondition.value = "";
         emit("condition-change", "");
@@ -3087,10 +3263,13 @@ var _default = exports.A = {
       emit("option-delete", condition);
     };
 
-    // 实时输入监听
+    /**
+     * @description 实时输入监听
+     * @param {String} val 输入值
+     */
     const handleInput = val => {};
 
-    // 清空选中
+    // 清空选中条件
     const clearSelection = () => {
       selectedCondition.value = "";
     };
@@ -3102,6 +3281,10 @@ var _default = exports.A = {
       },
       clearSelection,
       getConditions: () => [...filterConditions.value],
+      /**
+       * @description 新增过滤条件
+       * @param {String} condition 待新增的条件
+       */
       addCondition: condition => {
         if (condition && !filterConditions.value.includes(condition)) {
           filterConditions.value.push(condition);
@@ -3550,11 +3733,21 @@ const MODEL_TYPES = exports.MODEL_TYPES = {
   CUSTOM: "customLofting",
   WATER: "waterLofting"
 };
+
+// 属性字段排除列表
 const EXCLUDED_FIELDS = exports.EXCLUDED_FIELDS = ["oid", "kid", "id", "fid", "objectid", "smid", "sid"];
 
 // 数据提取工具
 class DataExtractor {
-  // 获取字符串类型属性值
+  /**
+   * @description 获取字符串类型属性值
+   * @param {Object} properties 要素属性
+   * @param {String} fieldKey 字段映射键
+   * @param {String} propKey 属性键
+   * @param {String} defaultValue 默认值
+   * @param {Object} options 选项对象
+   * @returns {String} 属性值
+   */
   static getStringValue(properties, fieldKey, propKey, defaultValue = "", options = {}) {
     const fieldName = options[fieldKey];
 
@@ -3577,7 +3770,15 @@ class DataExtractor {
     return defaultValue;
   }
 
-  // 获取数字类型属性值
+  /**
+   * @description 获取数字类型属性值
+   * @param {Object} properties 要素属性
+   * @param {String} fieldKey 字段映射键
+   * @param {String} propKey 属性键
+   * @param {Number} defaultValue 默认值
+   * @param {Object} options 选项对象
+   * @returns {Number} 属性值
+   */
   static getNumberValue(properties, fieldKey, propKey, defaultValue = 0, options = {}) {
     const fieldName = options[fieldKey];
 
@@ -3601,7 +3802,11 @@ class DataExtractor {
     return defaultValue;
   }
 
-  // 提取所有属性字段
+  /**
+   * @description 提取所有属性字段
+   * @param {Object} geojsonData geojson 数据
+   * @returns {Array} 属性字段数组
+   */
   static extractPropertyFields(geojsonData) {
     const propertyFields = new Set();
     geojsonData.features?.forEach(feature => {
@@ -3616,7 +3821,11 @@ class DataExtractor {
     return Array.from(propertyFields);
   }
 
-  // 提取线坐标
+  /**
+   * @description 提取线坐标
+   * @param {Object} geometry 几何对象
+   * @returns {Array} 坐标点数组
+   */
   static extractLinePositions(geometry) {
     const positions = [];
     if (!geometry?.coordinates) return positions;
@@ -3644,7 +3853,15 @@ class DataExtractor {
 // 模型配置
 exports.DataExtractor = DataExtractor;
 class ModelConfigGenerator {
-  // 获取通用配置参数
+  /**
+   * @description 获取通用配置参数
+   * @param {String} type 模型类型
+   * @param {Object} properties 要素属性
+   * @param {Array} positions 坐标点数组
+   * @param {Number} index 索引
+   * @param {Object} options 选项对象
+   * @returns {Object} 通用配置
+   */
   static getBaseConfig(type, properties, positions, index, options) {
     const key = (0, _util.guid)();
     return {
@@ -3669,7 +3886,13 @@ class ModelConfigGenerator {
     };
   }
 
-  // 获取道路/墙体放样配置
+  /**
+   * @description 获取道路/墙体放样配置
+   * @param {Object} properties 要素属性
+   * @param {Array} positions 坐标点数组
+   * @param {Object} options 选项对象
+   * @returns {Object} 道路/墙体放样配置
+   */
   static getRoadWallConfig(properties, positions, options) {
     return {
       geometry: {
@@ -3708,7 +3931,13 @@ class ModelConfigGenerator {
     };
   }
 
-  // 获取管道放样配置
+  /**
+   * @description 获取管道放样配置
+   * @param {Object} properties 要素属性
+   * @param {Array} positions 坐标点数组
+   * @param {Object} options 选项对象
+   * @returns {Object} 管道放样配置
+   */
   static getPipelineConfig(properties, positions, options) {
     const shape = options?.shape ?? properties?.shape ?? "circle";
     const isFlowingType = ["circle", "semicircle"].includes(shape);
@@ -3740,7 +3969,13 @@ class ModelConfigGenerator {
     };
   }
 
-  // 获取自定义放样配置
+  /**
+   * @description 获取自定义放样配置
+   * @param {Object} properties 要素属性
+   * @param {Array} positions 坐标点数组
+   * @param {Object} options 选项对象
+   * @returns {Object} 自定义放样配置
+   */
   static getCustomLineConfig(properties, positions, options) {
     return {
       region: {
@@ -3769,7 +4004,13 @@ class ModelConfigGenerator {
     };
   }
 
-  // 获取水系放样配置
+  /**
+   * @description 获取水系放样配置
+   * @param {Object} properties 要素属性
+   * @param {Array} positions 坐标点数组
+   * @param {Object} options 选项对象
+   * @returns {Object} 水系放样配置
+   */
   static getWaterConfig(properties, positions, options) {
     return {
       region: {
@@ -3795,7 +4036,13 @@ class ModelConfigGenerator {
     };
   }
 
-  // 私有方法
+  /**
+   * @description 私有方法，获取材质贴图
+   * @param {String} type 模型类型
+   * @param {Object} properties 要素属性
+   * @param {Object} options 选项对象
+   * @returns {String} 贴图地址
+   */
   static _getMaterialImage(type, properties, options) {
     switch (type) {
       case MODEL_TYPES.WATER:
@@ -3804,7 +4051,13 @@ class ModelConfigGenerator {
         return "null";
     }
   }
-  // 根据放样类型获取宽度参数值
+  /**
+   * @description 根据放样类型获取宽度参数值
+   * @param {String} type 模型类型
+   * @param {Object} properties 要素属性
+   * @param {Object} options 选项对象
+   * @returns {Number} 宽度
+   */
   static _getWidth(type, properties, options) {
     const widthMap = {
       [MODEL_TYPES.PIPELINE]: DataExtractor.getNumberValue(properties, "radiusFields", "radius", 30, options),
@@ -3814,6 +4067,12 @@ class ModelConfigGenerator {
     };
     return widthMap[type] ?? widthMap.default;
   }
+
+  /**
+   * @description 解析自定义形状字符串，优先尝试 JSON.parse
+   * @param {String} customShape 自定义形状字符串
+   * @returns {*} 解析结果
+   */
   static _parseCustomShape(customShape) {
     if (!customShape) return null;
     try {
@@ -3827,7 +4086,11 @@ class ModelConfigGenerator {
 // 数据处理器
 exports.ModelConfigGenerator = ModelConfigGenerator;
 class DataProcessor {
-  // 处理GeoJSON数据
+  /**
+   * @description 处理GeoJSON数据
+   * @param {Object} geojson geojson 数据
+   * @returns {Array} 要素数组
+   */
   static processGeoJSON(geojson) {
     let features = [];
     if (geojson.type === "FeatureCollection") {
@@ -3844,7 +4107,12 @@ class DataProcessor {
     return features;
   }
 
-  // 数据过滤
+  /**
+   * @description 数据过滤
+   * @param {Object} data geojson 数据
+   * @param {String} filterStr 过滤条件字符串
+   * @returns {Object} 过滤后的 geojson 数据
+   */
   static filterData(data, filterStr) {
     if (!filterStr || !data?.features) {
       return data;
@@ -3859,6 +4127,8 @@ class DataProcessor {
         return false;
       }
       const propValue = feature.properties[fieldName];
+
+      // 根据运算符判断是否保留该要素
       switch (operator) {
         case ">":
           return propValue > numValue;
@@ -3886,6 +4156,12 @@ class DataProcessor {
 // 模型创建器
 exports.DataProcessor = DataProcessor;
 class ModelCreator {
+  /**
+   * @description 根据类型创建模型实例
+   * @param {String} type 模型类型
+   * @param {Object} config 模型配置
+   * @returns {Object} 模型实例
+   */
   static createModelInstance(type, config) {
     const modelConstructors = {
       [MODEL_TYPES.ROAD]: Cesium.PMRegion3DWall,
@@ -3914,11 +4190,11 @@ Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
 exports.kq_npm_client_leaflet_vue = exports.kq_npm_client_common_vue = exports.kq_npm_client3d_webgl_vue = void 0;
-let kq_npm_client_common_vue = exports.kq_npm_client_common_vue = window.kq_npm_client_common_vue = window.kq_npm_client_common_vue || {};
+const kq_npm_client_common_vue = exports.kq_npm_client_common_vue = window.kq_npm_client_common_vue = window.kq_npm_client_common_vue || {};
 __webpack_require__.g.kq_npm_client_common_vue = kq_npm_client_common_vue;
-let kq_npm_client_leaflet_vue = exports.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue || {};
+const kq_npm_client_leaflet_vue = exports.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue || {};
 __webpack_require__.g.kq_npm_client_leaflet_vue = kq_npm_client_leaflet_vue;
-let kq_npm_client3d_webgl_vue = exports.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue || {};
+const kq_npm_client3d_webgl_vue = exports.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue || {};
 __webpack_require__.g.kq_npm_client3d_webgl_vue = kq_npm_client3d_webgl_vue;
 
 /***/ })