@metagl/sdk-plotting 0.0.3 → 0.0.4

package/README.md

@@ -63,9 +63,11 @@ npm install @metagl/sdk-plotting@file:../../sdk-plotting/publish
 
 #### 2. Vite 项目配置要点
 
-##### 2.1 Cesium 别名映射
+##### 2.1 Cesium 别名映射 + 排除预打包
 
-sdk-plotting 打包时将 Cesium 标记为 external（全局变量 `Cesium`），但 Vite 按模块名解析时需要映射：
+sdk-plotting 打包时将 Cesium 标记为 external（全局变量 `Cesium`）。Vite 预打包时需要做两件事：
+- 将 `Cesium` 别名指向**浏览器 ESM 构建**（不能用 `cesium` 包名，否则会解析到 `index.cjs` Node.js 入口，导致 `__dirname is not defined` 错误）
+- 将 `@metagl/sdk-plotting` 排除预打包（避免 Vite 重新解析已打包好的 UMD 内部依赖）
 
 ```js
 // vite.config.js
@@ -75,8 +77,8 @@ import path from 'path'
 export default defineConfig({
   resolve: {
     alias: {
-      // 关键：将 UMD external 的 'Cesium' 映射到 npm 包名 'cesium'
-      'Cesium': 'cesium',
+      // 关键：必须指向浏览器 ESM 入口，不能用 'cesium'（会解析到 Node.js 的 index.cjs）
+      'Cesium': path.resolve(__dirname, 'node_modules/cesium/Source/Cesium.js'),
     }
   },
   define: {
@@ -84,11 +86,16 @@ export default defineConfig({
     CESIUM_BASE_URL: JSON.stringify('/cesium')
   },
   optimizeDeps: {
-    include: ['cesium']
+    include: ['cesium'],
+    // 关键：排除已打包的 UMD 包，避免 Vite 重新解析其内部依赖
+    exclude: ['@metagl/sdk-plotting']
   }
 })
 ```
 
+> **为什么不能写 `'Cesium': 'cesium'`？**
+> Vite 按包名解析 `cesium` 时会读取 `package.json` 的 `main` 字段，指向 `index.cjs`——这是一个 Node.js CommonJS 入口，包含 `__dirname`、`path.join` 等浏览器不可用的 API。运行时会报 `ReferenceError: __dirname is not defined`。必须直接指向 `Source/Cesium.js` 浏览器构建。
+
 ##### 2.2 静态资源拷贝
 
 sdk-plotting 的 `resources/` 目录（图片、纹理等）需要通过 `vite-plugin-static-copy` 或其他方式复制到构建输出：
@@ -258,8 +265,9 @@ cd publish && npm publish --access public  # 发布
 - **LACDT 未定义**：确保 `lacdt.plotting.js` 在 Cesium 之后加载
 
 ### npm import 方式
+- **`__dirname is not defined`**：Cesium 别名不能写 `'cesium'`（会解析到 Node.js `index.cjs`），必须指向 `Source/Cesium.js` 浏览器入口
+- **白屏无报错**：Vite 缓存了旧依赖路径，需删除 `node_modules/.vite/` 后重启（从 `file:` 引用切换到 npm 版本时必做）
 - **Cannot assign to "e" because it is a constant**：构建产物问题，需重新 `npm run build`
-- **Cesium could not be resolved**：在 `vite.config.js` 中添加 `'Cesium': 'cesium'` 别名
 - **SDK 无法扩展 Cesium**：UMD 格式的 SDK 会扩展 `window.Cesium`，需在 import 之前确保 Cesium 已挂载到 `window`，且对象未被 `Object.freeze()`
 
 ## 许可证

package/lacdt.plotting.d.ts

@@ -3589,7 +3589,7 @@ class Tools {
 }
 
   class AnimationConfig {
-    static animationRegister: (typeof SingleAnimation | typeof StateChangeAnimation | typeof CssNumberAnimation | typeof CssPropChangeAnimation | typeof SubtitleAnimation | typeof CameraSetAnimation | typeof GeojsonVisibleAnimation | typeof PopulationTimeAnimation | typeof CssMaskAnimation | typeof PathAnimation | typeof CameraRoamAnimation | typeof PageShowAnimation | typeof GxModelAnimation | typeof PathShowAnimation | typeof FollowAnimation | typeof SurroundAnimation | typeof SpiralAnimation | typeof ArrowDirectAnimation | typeof VideoAnimation | typeof AudioAnimation | typeof AutoRotationAnimation | typeof ZoomToFlyAnimation | typeof PolygonMaskAnimation)[];
+    static animationRegister: (typeof SingleAnimation | typeof CameraSetAnimation | typeof StateChangeAnimation | typeof CssPropChangeAnimation | typeof SubtitleAnimation | typeof CssNumberAnimation | typeof GeojsonVisibleAnimation | typeof PopulationTimeAnimation | typeof CssMaskAnimation | typeof PathAnimation | typeof CameraRoamAnimation | typeof PageShowAnimation | typeof GxModelAnimation | typeof PathShowAnimation | typeof FollowAnimation | typeof SurroundAnimation | typeof SpiralAnimation | typeof ArrowDirectAnimation | typeof VideoAnimation | typeof AudioAnimation | typeof AutoRotationAnimation | typeof ZoomToFlyAnimation | typeof PolygonMaskAnimation)[];
     static animationList: Array<AnimationItem>;
     static init(): void;
 }
@@ -18705,7 +18705,7 @@ class Tools {
 }
 
   class AnimationConfig {
-    static animationRegister: (typeof SingleAnimation | typeof StateChangeAnimation | typeof CssNumberAnimation | typeof CssPropChangeAnimation | typeof SubtitleAnimation | typeof CameraSetAnimation | typeof GeojsonVisibleAnimation | typeof PopulationTimeAnimation | typeof CssMaskAnimation | typeof PathAnimation | typeof CameraRoamAnimation | typeof PageShowAnimation | typeof GxModelAnimation | typeof PathShowAnimation | typeof FollowAnimation | typeof SurroundAnimation | typeof SpiralAnimation | typeof ArrowDirectAnimation | typeof VideoAnimation | typeof AudioAnimation | typeof AutoRotationAnimation | typeof ZoomToFlyAnimation | typeof PolygonMaskAnimation)[];
+    static animationRegister: (typeof SingleAnimation | typeof CameraSetAnimation | typeof StateChangeAnimation | typeof CssPropChangeAnimation | typeof SubtitleAnimation | typeof CssNumberAnimation | typeof GeojsonVisibleAnimation | typeof PopulationTimeAnimation | typeof CssMaskAnimation | typeof PathAnimation | typeof CameraRoamAnimation | typeof PageShowAnimation | typeof GxModelAnimation | typeof PathShowAnimation | typeof FollowAnimation | typeof SurroundAnimation | typeof SpiralAnimation | typeof ArrowDirectAnimation | typeof VideoAnimation | typeof AudioAnimation | typeof AutoRotationAnimation | typeof ZoomToFlyAnimation | typeof PolygonMaskAnimation)[];
     static animationList: Array<AnimationItem>;
     static init(): void;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metagl/sdk-plotting",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Geovis Earth SDK Plotting Module",
   "main": "./lacdt.plotting.js",
   "module": "./lacdt.plotting.js",

package/types/Models/AnimationConfig.d.ts

@@ -23,7 +23,7 @@ import { AutoRotationAnimation } from '../PlottingTool/Animation/Items/AutoRotat
 import { ZoomToFlyAnimation } from '../PlottingTool/Animation/Items/ZoomToFlyAnimation';
 import { PolygonMaskAnimation } from '../PlottingTool/Animation/Items/PolygonMaskAnimation';
 export declare class AnimationConfig {
-    static animationRegister: (typeof SingleAnimation | typeof StateChangeAnimation | typeof CssNumberAnimation | typeof CssPropChangeAnimation | typeof SubtitleAnimation | typeof CameraSetAnimation | typeof GeojsonVisibleAnimation | typeof PopulationTimeAnimation | typeof CssMaskAnimation | typeof PathAnimation | typeof CameraRoamAnimation | typeof PageShowAnimation | typeof GxModelAnimation | typeof PathShowAnimation | typeof FollowAnimation | typeof SurroundAnimation | typeof SpiralAnimation | typeof ArrowDirectAnimation | typeof VideoAnimation | typeof AudioAnimation | typeof AutoRotationAnimation | typeof ZoomToFlyAnimation | typeof PolygonMaskAnimation)[];
+    static animationRegister: (typeof SingleAnimation | typeof CameraSetAnimation | typeof StateChangeAnimation | typeof CssPropChangeAnimation | typeof SubtitleAnimation | typeof CssNumberAnimation | typeof GeojsonVisibleAnimation | typeof PopulationTimeAnimation | typeof CssMaskAnimation | typeof PathAnimation | typeof CameraRoamAnimation | typeof PageShowAnimation | typeof GxModelAnimation | typeof PathShowAnimation | typeof FollowAnimation | typeof SurroundAnimation | typeof SpiralAnimation | typeof ArrowDirectAnimation | typeof VideoAnimation | typeof AudioAnimation | typeof AutoRotationAnimation | typeof ZoomToFlyAnimation | typeof PolygonMaskAnimation)[];
     static animationList: Array<AnimationItem>;
     static init(): void;
 }