cesium-xs-sdk 1.0.0

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "cesium-xs-sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "基于 Cesium 1.137 封装的 SDK",
+  "main": "dist/cesium-xs-sdk.cjs.js",
+  "module": "dist/cesium-xs-sdk.esm.js",
+  "browser": "dist/cesium-xs-sdk.umd.js",
+  "types": "src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/cesium-xs-sdk.esm.js",
+      "require": "./dist/cesium-xs-sdk.cjs.js",
+      "types": "./src/index.d.ts"
+    },
+    "./vue": {
+      "import": "./src/vue.js",
+      "types": "./src/vue.d.ts"
+    },
+    "./vue2": {
+      "import": "./src/vue2.js",
+      "types": "./src/vue2.d.ts"
+    },
+    "./react": {
+      "import": "./src/react.js",
+      "types": "./src/react.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "src/",
+    "README.md",
+    "package.json"
+  ],
+  "keywords": [
+    "cesium",
+    "gis",
+    "3d",
+    "sdk",
+    "cesium-xs-sdk"
+  ],
+  "author": "成都玄宿科技有限公司",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/d1564427109/cesium-xs-sdk.git"
+  },
+  "scripts": {
+    "build": "rollup -c",
+    "package-offline": "node scripts/package-offline.js",
+    "release": "npm run build && npm run package-offline",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:unit": "vitest",
+    "test:e2e": "playwright test",
+    "test:e2e:ui": "playwright test --ui",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "cesium": "^1.137.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.45.0",
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-replace": "^5.0.5",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "archiver": "^7.0.1",
+    "http-server": "^14.1.1",
+    "jsdom": "^24.1.0",
+    "rollup": "^4.9.6",
+    "rollup-plugin-dts": "^6.4.1",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  }
+}

package/src/core/Config.js

@@ -0,0 +1,176 @@
+/**
+ * 全局配置类（对应平台 Application 单件）
+ * 管理 Cesium Token、默认参数、模块开关
+ */
+export class Config {
+    static instance = null;
+    // 单例模式
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = new Config();
+        }
+        return this.instance;
+    }
+
+    constructor() {
+        // 默认配置（对齐平台参数规范）
+        this.config = {
+            cesiumToken: '', // Cesium Ion Token
+            // 场景默认参数
+            scene: {
+                animation: false,
+                timeline: false,
+                baseLayerPicker: false,
+                fullscreenButton: false,
+                geocoder: false,
+                homeButton: false,
+                infoBox: false,
+                sceneModePicker: false,
+                selectionIndicator: false,
+                navigationHelpButton: false,
+                navigationInstructionsInitiallyVisible: false,
+                depthTestAgainstTerrain: true, // 默认开启深度检测
+            },
+            // 图元默认样式：延迟到 getConfig 时再构造，避免在 Cesium 未加载/未 mock 时崩溃
+            // （对 SSR 和单元测试更友好）
+        };
+    }
+
+    /**
+     * 构造图元默认样式（延迟初始化）
+     * @private
+     */
+    #getGraphicDefaults() {
+        if (typeof Cesium === 'undefined') {
+            return {};
+        }
+
+        const withAlpha = (color, alpha) => {
+            if (color && typeof color.withAlpha === 'function') {
+                return color.withAlpha(alpha);
+            }
+            return color;
+        };
+
+        return {
+            point: { pixelSize: 8, color: Cesium.Color.RED },
+            line: { width: 2, material: Cesium.Color.BLUE },
+            polygon: { color: withAlpha(Cesium.Color.GREEN, 0.5) },
+            plot: {
+                polygon: {
+                    color: withAlpha(Cesium.Color.BLUE, 0.5),
+                    outlineColor: Cesium.Color.BLUE,
+                    outlineWidth: 2
+                },
+                line: {
+                    material: Cesium.Color.BLUE,
+                    width: 2
+                }
+            }
+        };
+    }
+
+    /**
+     * 设置全局配置（参数化配置）
+     * @param {Object} options 配置项（支持部分覆盖）
+     * @example
+     * Config.getInstance().setConfig({
+     *   cesiumToken: 'your-token',
+     *   scene: { terrainProvider: await Cesium.createWorldTerrainAsync() }
+     * });
+     */
+    setConfig(options) {
+        for (const k in options) {
+            // 1. 标量/数组/null -> 直接覆盖
+            if (
+                typeof options[k] !== 'object' ||
+                Array.isArray(options[k]) ||
+                options[k] === null
+            ) {
+                this.config[k] = options[k];
+                continue;
+            }
+
+            // 2. scene -> 深度缺省合并
+            if (k === 'scene') {
+                this.config.scene = this.config.scene || {};
+                this.#defaultsDeep(this.config.scene, options.scene);
+                continue;
+            }
+
+            // 3. 其他对象 -> 浅层缺省（或按需改成深度）
+            this.config[k] = this.config[k] || {};
+            this.#defaultsShallow(this.config[k], options[k]);
+        }
+
+        console.log('config', this.config);
+
+
+        // Token 同步
+        if (options.cesiumToken) {
+            Cesium.Ion.defaultAccessToken = options.cesiumToken;
+        }
+    }
+
+    /**
+     * 获取全局配置
+     * @returns {Object} 完整配置
+     */
+    getConfig() {
+        const graphicDefaults = this.#getGraphicDefaults();
+        const userGraphic = this.config.graphic || {};
+
+        // 深度合并 plot，避免用户只传 polygon 时丢失 line 默认样式
+        const plot = userGraphic.plot
+            ? { ...graphicDefaults.plot, ...userGraphic.plot }
+            : graphicDefaults.plot;
+
+        return {
+            ...this.config,
+            graphic: {
+                ...graphicDefaults,
+                ...userGraphic,
+                plot
+            }
+        };
+    }
+
+    #defaultsDeep(target, src) {
+        for (const k in src) {
+            const sv = src[k];
+            const tv = target[k];
+
+            // 1. 非对象 || 数组 || null -> 直接补缺失
+            if (typeof sv !== 'object' || Array.isArray(sv) || sv === null) {
+                if (!Object.prototype.hasOwnProperty.call(target, k)) {
+                    target[k] = sv;
+                }
+                continue;
+            }
+
+            // 2. 特殊类实例（Promise、TerrainProvider…）-> 整棵补缺失，不展开
+            if (
+                sv instanceof Promise ||
+                (sv.constructor && sv.constructor.name !== 'Object')   // 普通 Object 字面量才继续
+            ) {
+                if (!Object.prototype.hasOwnProperty.call(target, k)) {
+                    target[k] = sv;
+                }
+                continue;
+            }
+
+            // 3. 普通对象 -> 递归
+            target[k] = tv || {};
+            this.#defaultsDeep(target[k], sv);
+        }
+    }
+
+    /* 浅层缺省工具 */
+    #defaultsShallow(target, src) {
+        for (const k in src) {
+            if (!Object.prototype.hasOwnProperty.call(target, k)) {
+                target[k] = src[k];
+            }
+        }
+    }
+}

package/src/core/ModuleManager.js

@@ -0,0 +1,157 @@
+/**
+ * 模块管理器（对应平台 GetModule 逻辑）
+ * 统一管理场景、图元、事件模块的实例
+ */
+import { SceneModule } from '../modules/SceneModule.js';
+import { GraphicModule } from '../modules/GraphicModule.js';
+import { EventModule } from '../modules/EventModule.js';
+import { EditorModule } from '../modules/EditorModule.js';
+import { Config } from './Config.js';
+
+export class ModuleManager {
+    static instance = null;
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = new ModuleManager();
+        }
+        return this.instance;
+    }
+
+    constructor() {
+        this.modules = new Map(); // 模块缓存
+        this.cesiumViewer = null; // Cesium Viewer 实例（全局唯一）
+    }
+
+    /**
+     * 初始化 Cesium 核心实例（插件初始化逻辑）
+     * @param {string|HTMLElement} container 容器ID/元素
+     * @returns {Cesium.Viewer} Cesium 实例
+     */
+    initViewer(container) {
+        if (this.cesiumViewer) return this.cesiumViewer;
+        const config = Config.getInstance().getConfig();
+
+        this.cesiumViewer = new Cesium.Viewer(container, config.scene);
+        // 隐藏版权信息（可选，对齐平台界面规范）
+        const creditContainer = this.cesiumViewer.cesiumWidget?.creditContainer;
+        if (creditContainer) {
+            creditContainer.style.display = 'none';
+        }
+
+        // 初始化所有模块（注入 Viewer 实例）
+        this.registerModule('SceneModule', new SceneModule(this.cesiumViewer));
+        this.registerModule('GraphicModule', new GraphicModule(this.cesiumViewer));
+        this.registerModule('EventModule', new EventModule(this.cesiumViewer));
+
+        // 初始化编辑器模块（依赖其他模块）
+        const editorModule = new EditorModule(this.cesiumViewer);
+        editorModule.setDependencies({
+            graphicModule: this.getModule('GraphicModule'),
+            eventModule: this.getModule('EventModule')
+        }).init();
+        this.registerModule('EditorModule', editorModule);
+
+        return this.cesiumViewer;
+    }
+
+    /**
+     * 获取模块实例（对应平台 GetModule 函数）
+     * @param {string} moduleName 模块名称（SceneModule/GraphicModule/EventModule）
+     * @returns {Object} 模块实例
+     */
+    getModule(moduleName) {
+        if (!this.modules.has(moduleName)) {
+            throw new Error(`模块 ${moduleName} 未注册，请先初始化 Viewer`);
+        }
+        return this.modules.get(moduleName);
+    }
+
+    /**
+     * Cesium Viewer 快捷访问
+     * @returns {Cesium.Viewer}
+     */
+    get viewer() {
+        return this.cesiumViewer;
+    }
+
+    /**
+     * 场景模块快捷访问
+     * @returns {SceneModule}
+     */
+    get sceneModule() {
+        return this.getModule('SceneModule');
+    }
+
+    /**
+     * 图元模块快捷访问
+     * @returns {GraphicModule}
+     */
+    get graphicModule() {
+        return this.getModule('GraphicModule');
+    }
+
+    /**
+     * 事件模块快捷访问
+     * @returns {EventModule}
+     */
+    get eventModule() {
+        return this.getModule('EventModule');
+    }
+
+    /**
+     * 编辑器模块快捷访问
+     * @returns {EditorModule}
+     */
+    get editorModule() {
+        return this.getModule('EditorModule');
+    }
+
+    /**
+     * 注册模块（内部使用）
+     * @param {string} moduleName 模块名称
+     * @param {Object} moduleInstance 模块实例
+     */
+    registerModule(moduleName, moduleInstance) {
+        this.modules.set(moduleName, moduleInstance);
+    }
+
+    /**
+     * 销毁实例（对应平台插件 Destroy 逻辑）
+     */
+    destroy() {
+        if (this.cesiumViewer) {
+            // 先通知各模块释放资源
+            try {
+                const eventModule = this.modules.get('EventModule');
+                if (eventModule && typeof eventModule.unregisterAllObservers === 'function') {
+                    eventModule.unregisterAllObservers();
+                }
+            } catch (e) {
+                console.warn('EventModule 注销失败:', e);
+            }
+
+            try {
+                const editorModule = this.modules.get('EditorModule');
+                if (editorModule && typeof editorModule.destroy === 'function') {
+                    editorModule.destroy();
+                }
+            } catch (e) {
+                console.warn('EditorModule 销毁失败:', e);
+            }
+
+            this.cesiumViewer.destroy();
+            this.cesiumViewer = null;
+            this.modules.clear();
+        }
+    }
+
+    /**
+     * 重置 ModuleManager 单例（用于完全重新初始化）
+     */
+    static reset() {
+        if (ModuleManager.instance) {
+            ModuleManager.instance.destroy();
+            ModuleManager.instance = null;
+        }
+    }
+}