cesium_dev_kit 1.1.21 → 1.1.23
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +60 -0
- package/README.md +293 -291
- package/README.zh-CN.md +274 -0
- package/SECURITY.md +21 -0
- package/dist/Analysis-BLpVrGfg.d.mts +143 -0
- package/dist/Analysis-DmO1gtgS.d.ts +143 -0
- package/dist/Base-DH8H9suE.d.mts +635 -0
- package/dist/Base-DH8H9suE.d.ts +635 -0
- package/dist/Base-_BOXyMdS.d.ts +43 -0
- package/dist/Base-skqjcPfo.d.mts +43 -0
- package/dist/Control-B7AMFmHe.d.ts +98 -0
- package/dist/Control-BrpRU7RP.d.mts +98 -0
- package/dist/CustomCesiumPlugin-BqgAvlhi.d.ts +29 -0
- package/dist/CustomCesiumPlugin-CKYQ-7i9.d.mts +29 -0
- package/dist/Draw-1NhPP8z3.d.mts +490 -0
- package/dist/Draw-DRh7yNzc.d.ts +490 -0
- package/dist/Graphics-CuFNsQ3b.d.ts +1565 -0
- package/dist/Graphics-QE3Gb43w.d.mts +1565 -0
- package/dist/Material-CeZ4l-tY.d.mts +165 -0
- package/dist/Material-Cqbyf2Pn.d.ts +165 -0
- package/dist/Math3d-0nO-vFbT.d.mts +179 -0
- package/dist/Math3d-t635PYzU.d.ts +179 -0
- package/dist/PassEffect-DEFyytQZ.d.ts +41 -0
- package/dist/PassEffect-DEgElnVk.d.mts +41 -0
- package/dist/Plugin-BPCX0zTu.d.mts +197 -0
- package/dist/Plugin-DnYT0bue.d.ts +197 -0
- package/dist/Primitive-BNXp-9_6.d.mts +199 -0
- package/dist/Primitive-UEAuUimH.d.ts +199 -0
- package/dist/ThreeJs-BAlEWxa1.d.mts +44 -0
- package/dist/ThreeJs-DpAcw_qf.d.ts +44 -0
- package/dist/analysis.cjs +145 -0
- package/dist/analysis.cjs.map +1 -0
- package/dist/analysis.d.mts +6 -0
- package/dist/analysis.d.ts +6 -0
- package/dist/analysis.mjs +145 -0
- package/dist/analysis.mjs.map +1 -0
- package/dist/control.cjs +140 -0
- package/dist/control.cjs.map +1 -0
- package/dist/control.d.mts +4 -0
- package/dist/control.d.ts +4 -0
- package/dist/control.mjs +140 -0
- package/dist/control.mjs.map +1 -0
- package/dist/custom-cesium-plugin.cjs +507 -0
- package/dist/custom-cesium-plugin.cjs.map +1 -0
- package/dist/custom-cesium-plugin.d.mts +4 -0
- package/dist/custom-cesium-plugin.d.ts +4 -0
- package/dist/custom-cesium-plugin.mjs +507 -0
- package/dist/custom-cesium-plugin.mjs.map +1 -0
- package/dist/default-static.cjs +3 -0
- package/dist/default-static.cjs.map +1 -0
- package/dist/default-static.d.mts +37 -0
- package/dist/default-static.d.ts +37 -0
- package/dist/default-static.mjs +3 -0
- package/dist/default-static.mjs.map +1 -0
- package/dist/draw.cjs +140 -0
- package/dist/draw.cjs.map +1 -0
- package/dist/draw.d.mts +6 -0
- package/dist/draw.d.ts +6 -0
- package/dist/draw.mjs +140 -0
- package/dist/draw.mjs.map +1 -0
- package/dist/graphics.cjs +140 -0
- package/dist/graphics.cjs.map +1 -0
- package/dist/graphics.d.mts +19 -0
- package/dist/graphics.d.ts +19 -0
- package/dist/graphics.mjs +140 -0
- package/dist/graphics.mjs.map +1 -0
- package/dist/index.cjs +1030 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.mts +338 -0
- package/dist/index.d.ts +338 -0
- package/dist/index.mjs +1030 -0
- package/dist/index.mjs.map +1 -0
- package/dist/material.cjs +391 -0
- package/dist/material.cjs.map +1 -0
- package/dist/material.d.mts +4 -0
- package/dist/material.d.ts +4 -0
- package/dist/material.mjs +391 -0
- package/dist/material.mjs.map +1 -0
- package/dist/pass-effect.cjs +416 -0
- package/dist/pass-effect.cjs.map +1 -0
- package/dist/pass-effect.d.mts +4 -0
- package/dist/pass-effect.d.ts +4 -0
- package/dist/pass-effect.mjs +416 -0
- package/dist/pass-effect.mjs.map +1 -0
- package/dist/plugin.cjs +141 -0
- package/dist/plugin.cjs.map +1 -0
- package/dist/plugin.d.mts +4 -0
- package/dist/plugin.d.ts +4 -0
- package/dist/plugin.mjs +141 -0
- package/dist/plugin.mjs.map +1 -0
- package/dist/primitive.cjs +370 -0
- package/dist/primitive.cjs.map +1 -0
- package/dist/primitive.d.mts +4 -0
- package/dist/primitive.d.ts +4 -0
- package/dist/primitive.mjs +370 -0
- package/dist/primitive.mjs.map +1 -0
- package/dist/three.cjs +140 -0
- package/dist/three.cjs.map +1 -0
- package/dist/three.d.mts +4 -0
- package/dist/three.d.ts +4 -0
- package/dist/three.mjs +140 -0
- package/dist/three.mjs.map +1 -0
- package/package.json +289 -46
- package/dist/index.js +0 -1
- package/dist/index.min.js +0 -1
- package/dist/index.umd.js +0 -1
- package/index.js +0 -37
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/) 规范。
|
|
4
|
+
|
|
5
|
+
## [Unreleased]
|
|
6
|
+
|
|
7
|
+
### 新增(Added)
|
|
8
|
+
- 新增 `cesium_dev_kit/default-static` 子路径,导出 `defaultStatic`、`createDefaultStatic()`、`DEFAULT_STATIC_BASE`:未显式传入 `defaultStatic` 时库内自动回退到默认 CDN,避免默认图片静默 404;支持一行代码切换到自有 CDN 或相对路径自托管。
|
|
9
|
+
- 发布现代化库产物:ESM(`*.mjs`)、CJS(`*.cjs`)、类型声明(`.d.ts` / `.d.mts`)与 sourcemap。
|
|
10
|
+
- `package.json` 增加 `main` / `module` / `types` / `exports` / `typesVersions` / `files` / `sideEffects`,支持按需引入子路径:`cesium_dev_kit/graphics`、`/primitive`、`/analysis` 等。
|
|
11
|
+
- 新增 `tsup.config.ts` 与 `npm run build:lib`,每个子路径入口自包含,避免 `graphics` 连带引入 `echarts` / `dat.gui`。
|
|
12
|
+
- 新增 `dispose()`:`initCesium` 与 `singleImport` 各模块均可释放由 kit 自己创建的 viewer;外部传入的 viewer 不会被销毁。
|
|
13
|
+
- 新增 `scripts/check-exports.mjs` 与 CI 校验,防止 `package.json` 导出路径与构建产物不一致。
|
|
14
|
+
- CI 升级为 Node 18/20 矩阵,并加入单测、类型检查、库构建、导出校验和 demo 构建。
|
|
15
|
+
|
|
16
|
+
### 变更(Changed)
|
|
17
|
+
- **(破坏性)** 移除库内置的 Cesium Ion token。请通过 `extraConfig.AccessToken` 传入,或在应用入口设置 `Cesium.Ion.defaultAccessToken`。
|
|
18
|
+
- 运行依赖降为可选 peer 依赖:`dat.gui`、`echarts`、`libgif` 已移入 `peerDependencies` 并标记 `optional`,仅在用到控制面板 / 坡度剖面图 / GIF 导出时需安装;Vue / Element Plus / axios / OpenLayers 等演示站依赖移至 `devDependencies`。
|
|
19
|
+
- `dat.gui`、`echarts`、`libgif` 改为惰性 `import()` 加载:根入口 `import 'cesium_dev_kit'` 在 Node / SSR 环境不再因 `window` / `document` 未定义而报错。
|
|
20
|
+
- `three` 标记为可选 peer 依赖(`peerDependenciesMeta.three.optional = true`),只在 Three.js 集成场景需要安装。
|
|
21
|
+
- 高德/谷歌/百度影像的 7 个 `http://` 瓦片地址改为 `https://`,避免 HTTPS 站点混合内容被拦截。
|
|
22
|
+
- `cesium` 与 `three` 由 `dependencies` 调整为 `peerDependencies`,避免使用方重复打包、版本冲突。
|
|
23
|
+
- 放宽 `engines`:`node` 由 `==16.0.0` 调整为 `>=16.0.0`,`npm` 由 `==8.19.4` 调整为 `>=8.0.0`。
|
|
24
|
+
- `package.json` 补充 `description`、`keywords`、`repository`、`homepage`、`bugs` 等元数据,提升 npm 可发现性。
|
|
25
|
+
|
|
26
|
+
### 修复(Fixed)
|
|
27
|
+
- 修复 `getDfSt()` 在目标字段不存在时返回 `baseService + undefined` 的问题;绝对地址、`data:` URI 和站点根路径不再被错误拼接 `baseService`。
|
|
28
|
+
- 修复 README 示例中泄漏的真实天地图 token、失效的 `/src/views/...` 绝对路径、不存在的 `sceneMang` 字段,以及 `http://` 瓦片地址。
|
|
29
|
+
- `package.json` 的 `files` 改为包含整个 `dist`,修复 sourcemap 与 `.d.mts` 实际未发布的问题。
|
|
30
|
+
- CI 与 CHANGELOG 对齐:改为 Node 18/20 矩阵,执行 `typecheck`、`test`、`build:lib`、`check:exports`、`npm pack --dry-run`,移除 `strict-ssl false` 与不安全的 http registry 配置。
|
|
31
|
+
- 修正原型混入时使用 `instance.constructor` 作为 `Reflect.construct` newTarget 的问题:旧模块的 `X.prototype = { ... }` 会继承 `Object.prototype.constructor`,导致临时实例原型错误、`this._installXxx is not a function`。
|
|
32
|
+
- 修复 `Plugin.ts` 中 `setTimeout` 回调参数隐式 `any`,使 `tsup --dts` 可以正常生成类型声明。
|
|
33
|
+
- 修复 `dragDialog.ts`、`localstorage.ts` 的类型错误,`npm run typecheck` 现已通过。
|
|
34
|
+
- 移除 `package.json` 中的自我依赖 `cesium_dev_kit`。
|
|
35
|
+
- `Primitive` 模块 XyzAxisPrimitive `remove()` 中 `this._handler.distory()` 拼写错误修正为 `destroy()`。
|
|
36
|
+
- `Math3d.getPositionsAngle()` 中 `"heading "`(尾部多一个空格)修正为 `"heading"`,使偏航角分支真正生效。
|
|
37
|
+
- `Math2d.getFactorial2d()` 移除永远不命中的 `switch` 死分支,直接按阶乘计算(行为不变)。
|
|
38
|
+
- `Math2d.isClockWise` 此前只在接口声明、未实现,现补为 `isClockWise2d` 的别名(`getBisectorNormals2d` 调用处修复)。
|
|
39
|
+
- `Analysis` 方量分析中 `new Cesium.PolygonGeometry.fromPositions(...)` 误加 `new`(会抛 “not a constructor”)修正为直接调用。
|
|
40
|
+
- `Analysis` 坡度分析中 `appendChild(el, "dark", {...})` 多余参数移除。
|
|
41
|
+
|
|
42
|
+
### 重构(Refactor)
|
|
43
|
+
- `Math2d`、`Math3d` 由「构造函数 + 原型赋值 + `as unknown as` 强转」重构为真正的 ES6 `class`(保留 `XxxInstance` / `XxxConstructor` 类型别名兼容旧引用)。
|
|
44
|
+
- 新增 `mixinPrototype(target, source)` 工具(`libs/Base.ts`),替代 `X.prototype = { ...X.prototype, ...Base.prototype }` 原型重写。
|
|
45
|
+
- `indexOld.ts` / `singleImport/Base.ts` 的 `exeClone` 由 `Object.keys` 改为 `Object.getOwnPropertyNames`(兼容 class 的非枚举方法)。
|
|
46
|
+
- 消除模块级全局状态:核心模块的 Cesium/dfSt 与拖拽等交互状态改为按实例隔离的闭包,新增 createScopedConstructor 包装器,多 viewer 并存互不覆盖。
|
|
47
|
+
- 标绘(plot)模块的 BasePlot / AttackArrow / StraightArrow / PincerArrow 也改为按实例隔离的 Cesium(`this._Cesium`),每个箭头实例使用各自传入的 `cesiumGlobal`;Sensor 入口移除冗余的模块级 `let Cesium`,直接使用 `cesiumGlobal` 参数。
|
|
48
|
+
|
|
49
|
+
### 测试(Tests)
|
|
50
|
+
- 新增基于 `tsx` + Node 内置 `assert` 的单元测试,覆盖纯几何模块 `plot/plotUtil` 与 `Math2d`(无 Cesium 依赖)。
|
|
51
|
+
- `package.json` 新增 `test` 脚本与 `tsx` 开发依赖。
|
|
52
|
+
|
|
53
|
+
### 类型(Types)
|
|
54
|
+
- 修正公开 API 拼写并提供向后兼容别名(旧名标记 `@deprecated`):`bindHandelEvent` → `bindHandleEvent`、`getHandelPosition` → `getHandlePosition`、`cluserColors( Type )` → `clusterColors( Type )`、`barLableType` → `barLabelType`。聚合图层同时兼容 `clusterColors` 与旧的 `cluserColors`。
|
|
55
|
+
- 为 `cesiumPluginsExtends` 下所有模块补齐 `XxxInstance` / `XxxConstructor` 接口与各方法 options 类型,消除约 1600 处 `any`。
|
|
56
|
+
- 集中 Cesium 类型引用:各模块不再各自 `import 'cesium'`,统一通过 `cesiumGlobal` 传入的 Cesium 对象,`CesiumGlobal` / `Viewer` 等类型由 `libs/Base.ts` 统一导出。
|
|
57
|
+
|
|
58
|
+
## [1.1.23]
|
|
59
|
+
|
|
60
|
+
- 历史版本。详见 [GitHub releases](https://github.com/dengxiaoning/cesium_dev_kit/releases)。
|