cc-tools-utils 0.0.2 → 0.0.4

package/README.md

@@ -1,6 +1,7 @@
-一个由 chencheng)开发与维护的个人 JavaScript/Node.js 工具函数库，旨在为日常开发提供常用的、高质量的辅助工具。
+一个由 chencheng 开发与维护的个人工具函数库，旨在为日常开发提供常用的、高质量的辅助工具。
 
 ✨ 特性
+
 开箱即用：简单导入，无需复杂配置
 
 轻量无依赖：保持核心功能的纯净，不引入第三方依赖
@@ -9,4 +10,27 @@
 
 模块化：按需引入，支持 Tree Shaking
 
-良好测试：核心功能均有单元测试覆盖
+良好测试：核心功能均有单元测试覆盖
+
+## 📦 安装
+
+```bash
+npm install cc-tools-utils
+# 或
+yarn add cc-tools-utils
+# 或
+pnpm add cc-tools-utils
+```
+
+
+## 🚀 使用
+
+```javascript
+import { cesiumHooks, tools } from 'cc-tools-utils';
+
+// 使用 Cesium hooks
+const { viewer } = cesiumHooks.initCesium('cesiumContainer');
+
+// 使用工具函数
+const debouncedFn = tools.debounce(300, () => console.log('debounced'));
+```

package/index.js

@@ -0,0 +1,12 @@
+// import * as img from "./lib/img/Transform.js";
+import * as tools from "./lib/js/tools.js";
+import * as cesiumHooks from "./lib/js/cesiumHooks.js";
+
+// 命名导出
+export { tools, cesiumHooks };
+
+// 默认导出
+export default {
+  tools,
+  cesiumHooks,
+};

package/lib/js/cesiumHooks.js

@@ -20,7 +20,6 @@ import {
   Color,
 } from "cesium";
 import * as Cesium from "cesium";
-import { ref } from "vue";
 
 // 默认镜头高度
 export const DEFAULT_HEIGHT = 25000000;
@@ -28,13 +27,18 @@ export const DEFAULT_HEIGHT = 25000000;
 export const DEFAULT_POSITION = [109, 35.5, DEFAULT_HEIGHT];
 // 模型显示的距离阈值（米）
 export const MODEL_DISPLAY_DISTANCE = 5000000;
-// 慧居公司主体 Access_Tokens
-export const Cesium_Access_Tokens =
-  "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiI2Mzg2ZTAwNy0zODczLTQxYjUtODE3OS0zYzI5ZmM1MTU3MGIiLCJpZCI6Mzc4NzcwLCJpYXQiOjE3Njg0NDQyODd9.u9gpkF-dD_GHOX9dbnNR5k7Zv6oVpUcNm5WOeqvxzu0";
-// 所有的实体ids
-export const allEntitiesIds = ref([]);
-// 赋值accessToken
-Cesium.Ion.defaultAccessToken = Cesium_Access_Tokens;
+
+/**
+ * 设置Cesium Ion访问令牌
+ * @param {string} token - Cesium Ion访问令牌
+ */
+export const setCesiumAccessToken = (token) => {
+  if (!token || typeof token !== "string") {
+    console.warn("setCesiumAccessToken: token必须是非空字符串");
+    return;
+  }
+  Cesium.Ion.defaultAccessToken = token;
+};
 
 // 判断是否是同一个对象
 export function isArrayEqual(arr1, arr2) {
@@ -61,6 +65,38 @@ export const getHeading = (pointA, pointB) => {
   return CesiumMath.TWO_PI - CesiumMath.zeroToTwoPi(heading);
 };
 
+/**
+ * 计算两点间的恒向线方位角（Rhumb Bearing）
+ * @param {Array} pos1 - 起点 [经度, 纬度]
+ * @param {Array} pos2 - 终点 [经度, 纬度]
+ * @returns {number} 方位角（度数）
+ */
+export const getRhumbBearing = (pos1, pos2) => {
+  if (!Array.isArray(pos1) || !Array.isArray(pos2)) {
+    throw new Error("getRhumbBearing: 参数必须是数组");
+  }
+  if (pos1.length < 2 || pos2.length < 2) {
+    throw new Error("getRhumbBearing: 参数数组至少需要两个元素[经度, 纬度]");
+  }
+
+  const [lon1, lat1] = pos1;
+  const [lon2, lat2] = pos2;
+
+  // 将度数转换为弧度
+  const φ1 = CesiumMath.toRadians(lat1);
+  const φ2 = CesiumMath.toRadians(lat2);
+  const Δλ = CesiumMath.toRadians(lon2 - lon1);
+
+  // 计算恒向线方位角
+  const Δψ = Math.log(
+    Math.tan(φ2 / 2 + Math.PI / 4) / Math.tan(φ1 / 2 + Math.PI / 4),
+  );
+  const θ = Math.atan2(Δλ, Δψ);
+
+  // 转换为度数并标准化到0-360范围
+  return (CesiumMath.toDegrees(θ) + 360) % 360;
+};
+
 // 获取俯仰角
 export const getPitch = (pointA, pointB) => {
   const transform = Transforms.eastNorthUpToFixedFrame(pointA);
@@ -118,20 +154,39 @@ export const transformCartesian3ToWGS84 = (cartesian3) => {
 
 // 颜色
 export const toCesiumColor = (color) => {
-  return Cesium.Color.fromCssColorString(color);
+  if (!color || typeof color !== "string") {
+    console.warn("toCesiumColor: color必须是字符串，使用默认颜色");
+    return Cesium.Color.WHITE;
+  }
+  try {
+    return Cesium.Color.fromCssColorString(color);
+  } catch (error) {
+    console.warn(`toCesiumColor: 无效的颜色值 ${color}，使用默认颜色`);
+    return Cesium.Color.WHITE;
+  }
 };
 
 // 位置
 export const toCesiumPosition = (position) => {
-  if (Array.isArray(position)) {
-    return Cesium.Cartesian3.fromDegrees(...position);
-  } else {
-    throw new Error("Position must be an array of numbers.");
+  if (!Array.isArray(position)) {
+    throw new Error("toCesiumPosition: position必须是数组");
+  }
+  if (position.length < 2) {
+    throw new Error(
+      "toCesiumPosition: position数组至少需要两个元素[经度, 纬度]",
+    );
+  }
+  if (position.some((v) => typeof v !== "number" || isNaN(v))) {
+    throw new Error("toCesiumPosition: position数组元素必须是有效数字");
   }
+  return Cesium.Cartesian3.fromDegrees(...position);
 };
 
 // 返回中国视角
 export const backToChina = (viewer, callback, time) => {
+  if (!viewer) {
+    throw new Error("backToChina: viewer参数是必需的");
+  }
   viewer.camera.flyTo({
     destination: toCesiumPosition(DEFAULT_POSITION),
     duration: time || 1.5,
@@ -143,6 +198,9 @@ export const backToChina = (viewer, callback, time) => {
 
 // 初始化 一切
 export const initCesium = (boxID, doSomething) => {
+  if (!boxID) {
+    throw new Error("initCesium: boxID参数是必需的");
+  }
   // 1. 创建Viewer
   const viewer = new Cesium.Viewer(boxID, {
     contextOptions: {
@@ -228,11 +286,13 @@ export const divergingWaves = (
     speed = 1,
     defaultColor = "#ff0000",
     id = "",
-  },
+  } = {},
 ) => {
   if (!Cesium.defined(viewer)) {
-    console.error("Viewer is not defined");
-    return;
+    throw new Error("divergingWaves: viewer参数是必需的");
+  }
+  if (!Array.isArray(defaultPosition) || defaultPosition.length < 2) {
+    throw new Error("divergingWaves: defaultPosition必须是有效的坐标数组");
   }
   const entity = viewer.entities.add({
     id,
@@ -607,8 +667,14 @@ export const addPointer = (
     nearDistance = 1000,
     farDistance = 400000000,
     hoverImage,
-  },
+  } = {},
 ) => {
+  if (!viewer) {
+    throw new Error("addPointer: viewer参数是必需的");
+  }
+  if (!position) {
+    throw new Error("addPointer: position参数是必需的");
+  }
   // 构建实体配置
   const entityConfig = {
     id,
@@ -737,13 +803,14 @@ export const initEvents = ({ viewer, scene, camera, entities, clock }) => {
   viewer.cesiumWidget.screenSpaceEventHandler.removeInputAction(
     ScreenSpaceEventType.LEFT_DOUBLE_CLICK,
   );
+
+  let allEntitiesIds;
   // 监听实体添加
   entities.collectionChanged.addEventListener((collection, added, removed) => {
-    let old = allEntitiesIds.value;
+    let old = allEntitiesIds;
     let current = collection.values.map((item) => item.id);
     if (!isArrayEqual(old, current)) {
-      allEntitiesIds.value = entities.values.map((item) => item.id);
-      // console.log(" 添加了 实体", allEntitiesIds.value);
+      allEntitiesIds = entities.values.map((item) => item.id);
     }
   });
 
@@ -814,6 +881,8 @@ export const initEvents = ({ viewer, scene, camera, entities, clock }) => {
       // console.log("鼠标位置经纬度:", log_String, lat_String, alti_String);
     }
   }, Cesium.ScreenSpaceEventType.MOUSE_MOVE);
+
+  return allEntitiesIds;
 };
 
 // 渲染更新 位置
@@ -1052,3 +1121,7 @@ export const addHover = (viewer, onHover) => {
     if (hoverTimer) clearTimeout(hoverTimer);
   };
 };
+
+export const cc = () => {
+  return 1;
+};

package/lib/js/tools.js

@@ -0,0 +1,36 @@
+// 防抖函数
+export const debounce = (time, fn) => {
+  if (typeof fn !== "function") {
+    throw new Error("debounce的第二个参数必须是函数");
+  }
+  if (typeof time !== "number" || time < 0) {
+    throw new Error("debounce的第一个参数必须是非负数");
+  }
+  let timeoutID = null;
+  return function () {
+    if (timeoutID) clearTimeout(timeoutID);
+    timeoutID = setTimeout(() => {
+      fn.apply(this, arguments);
+      timeoutID = null;
+    }, time);
+  };
+};
+
+// 节流
+export const throttle = (time, fn) => {
+  if (typeof fn !== "function") {
+    throw new Error("throttle的第二个参数必须是函数");
+  }
+  if (typeof time !== "number" || time < 0) {
+    throw new Error("throttle的第一个参数必须是非负数");
+  }
+  let isRunning = false;
+  return function () {
+    if (isRunning) return;
+    isRunning = true;
+    fn.apply(this, arguments);
+    setTimeout(() => {
+      isRunning = false;
+    }, time);
+  };
+};

package/package.json

@@ -1,58 +1,55 @@
 {
   "name": "cc-tools-utils",
-  "version": "0.0.2",
-  "description": "A collection of useful JavaScript utilities including animation tools, image processing, and event bus",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "version": "0.0.4",
+  "description": "Cesium工具库，包含常用的Cesium hooks和工具函数",
+  "main": "index.js",
+  "types": "index.d.ts",
   "scripts": {
-    "type-check": "tsc --noEmit",
+    "type-check": "false",
     "test": "echo \"Error: no test specified\" && exit 1",
-    "build": "webpack --config webpack.dev.js",
-    "dev": "webpack --config webpack.dev.js --mode development"
+    "build": "webpack --config webpack.dev.js "
   },
   "keywords": [
-    "utilities",
+    "cesium",
     "tools",
-    "animation",
-    "image-processing",
-    "event-bus",
-    "javascript",
-    "typescript"
+    "utils",
+    "hooks"
   ],
-  "author": "chencheng",
-  "license": "MIT",
+  "author": "",
+  "license": "ISC",
   "repository": {
     "type": "git",
     "url": "https://gitee.com/chen-cheng-1998/learn_own.git"
   },
   "files": [
-    "dist",
     "lib",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "index.js",
+    "index.d.ts",
+    "vue-config-helper.js",
+    "CONSUMER_PROJECT_CONFIG.md"
   ],
-  "dependencies": {
+  "peerDependencies": {
+    "cesium": ">=1.100.0",
+    "vue": ">=3.0.0"
+  },
+  "devDependencies": {
     "@vue/compiler-sfc": "^3.5.11",
-    "cesium": "^1.137.0",
     "css-loader": "^7.1.2",
     "style-loader": "^4.0.0",
-    "vue": "3.2.13",
-    "vue-loader": "^17.4.2"
-  },
-  "devDependencies": {
+    "vue-loader": "^17.4.2",
     "@babel/core": "^7.18.0",
+    "@babel/plugin-proposal-nullish-coalescing-operator": "^7.18.6",
     "@babel/plugin-proposal-optional-chaining": "^7.17.12",
     "@babel/preset-env": "^7.18.2",
-    "@babel/preset-react": "^7.17.12",
     "@types/node": "^22.7.5",
     "babel-loader": "^8.2.5",
     "clean-webpack-plugin": "^4.0.0",
-    "copy-webpack-plugin": "^11.0.0",
     "ts-loader": "^9.2.6",
     "typescript": "^4.5.4",
     "webpack": "^5.65.0",
-    "webpack-bundle-analyzer": "^4.5.0",
     "webpack-cli": "^4.9.1",
     "webpack-parallel-uglify-plugin": "^2.0.0"
   }
-}
+}

package/vue-config-helper.js

@@ -0,0 +1,54 @@
+/**
+ * cc-tools-utils 的 Vue CLI 配置辅助工具
+ *
+ * 使用方法：
+ * 在消费项目的 vue.config.js 中：
+ *
+ * const ccToolsConfig = require('cc-tools-utils/vue-config-helper');
+ * module.exports = ccToolsConfig;
+ *
+ * 或者合并配置：
+ * const { defineConfig } = require('@vue/cli-service');
+ * const ccToolsConfig = require('cc-tools-utils/vue-config-helper');
+ *
+ * module.exports = defineConfig({
+ *   ...ccToolsConfig,
+ *   // 你的其他配置
+ * });
+ */
+
+const { defineConfig } = require("@vue/cli-service");
+
+module.exports = defineConfig({
+  transpileDependencies: ["cesium", /@cesium/],
+
+  configureWebpack: {
+    module: {
+      rules: [
+        {
+          test: /\.m?js$/,
+          include: /node_modules[\\/](cesium|@cesium)/,
+          use: {
+            loader: "babel-loader",
+            options: {
+              presets: [
+                [
+                  "@babel/preset-env",
+                  {
+                    targets: {
+                      browsers: ["> 1%", "last 2 versions", "not ie <= 8"],
+                    },
+                  },
+                ],
+              ],
+              plugins: [
+                "@babel/plugin-proposal-nullish-coalescing-operator",
+                "@babel/plugin-proposal-optional-chaining",
+              ],
+            },
+          },
+        },
+      ],
+    },
+  },
+});

package/dist/index.d.ts

@@ -1,11 +0,0 @@
-import * as img from "./lib/img/Transform";
-import * as js from "./lib/js/tools";
-import * as bus from "./lib/js/bus";
-import * as cesiumHooks from "./lib/js/cesiumHooks";
-declare const _default: {
-    img: typeof img;
-    js: typeof js;
-    bus: typeof bus;
-    cesiumHooks: typeof cesiumHooks;
-};
-export default _default;