@yangyongtao/gaea 1.1.28 → 1.1.30

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## [1.1.30] - 2026-09-09
+
+### Added
+- Vite 插件生产构建支持：新增 `closeBundle` 钩子，`vite build` 时自动把引擎静态资源（`Gaea.js` / `Gaea.wasm` / `Gaea.pck` / `Gaea.worker.js` / `static/` / `math/` / `image/` / `font/` / `icon/` 等）从包内 `public` 复制到输出目录（默认 `dist`，遵循 `build.outDir`）。修复此前生产包访问 `/Gaea.js` 返回 404 的问题。`configResolved` 记录输出目录；拷贝时跳过输出目录中已存在的文件，保证消费者自身 `public/` 下的资源优先。
+
+## [1.1.29] - 2026-09-04
+
+### Fixed
+- 2D/3D 切换严格隐藏 3D 图标：新增 `_markersVisible` 全局状态，`showAllMarkers` / `hideAllMarkers` 同步更新；`addScreenIcon` 新增图标按当前状态显隐；`setCategoryVisible` 显示分类、复位按钮、`lockedModesSwitch` 解锁恢复图标时均叠加全局可见性判断，杜绝 2D 模式下图标残留
+
 ## [1.1.28] - 2026-09-01
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yangyongtao/gaea",
-  "version": "1.1.28",
+  "version": "1.1.30",
   "description": "Gaea 3D visualization component library - Vue 3 components based on Godot WASM engine. Includes WMTS layer loading, camera view control, Vite plugin auto-injection, etc.",
   "type": "module",
   "main": "src/index.cjs",

package/src/GaeaMethods.js

@@ -290,6 +290,7 @@ export class GaeaApp {
     this.tLayers = [];
     this.layerCategories = this.config.layerCategories || [];
     this._screenIconList = [];
+    this._markersVisible = true; // 全局图标可见性（2D 模式下强制隐藏，3D 下恢复）
     this._hiddenCategories = new Set();
     this._tilesetMap = {}; // 已加载的 3D Tiles 引用，key 为 tileset 名称
     this._secIsClickArr = [];
@@ -560,9 +561,11 @@ export class GaeaApp {
       // 解锁视角（内部会调 UseAutoVisible 恢复非断面图标）
       this.lockedModesSwitch(false);
       // 恢复被 hiddenScreenWithClass 隐藏的图标 DOM
-      document.querySelectorAll('.gaea-locationLineStyle, .gaea-iconscreen, .gaea-iconGif').forEach(el => {
-        el.style.display = '';
-      });
+      if (this._markersVisible) {
+        document.querySelectorAll('.gaea-locationLineStyle, .gaea-iconscreen, .gaea-iconGif').forEach(el => {
+          el.style.display = '';
+        });
+      }
       // 断面模型缩回
       if (this._raisedSection) {
         this._raisedSection.TranslateObjectLocal(new Gaea.Vector3(0, -44, 0));
@@ -912,11 +915,11 @@ export class GaeaApp {
     }
     const els = document.querySelectorAll('.gaea-cat-' + categoryKey);
     console.log('[GaeaApp] setCategoryVisible:', categoryKey, visible, '元素数:', els.length);
-    els.forEach(el => { el.style.display = visible ? '' : 'none'; });
+    els.forEach(el => { el.style.display = visible && this._markersVisible ? '' : 'none'; });
     // 同步引擎可见性
     const items = this._screenIconList.filter(item => item.category === categoryKey);
     items.forEach(item => {
-      if (visible) {
+      if (visible && this._markersVisible) {
         item.element.UseAutoVisible();
         item.element.EnablePick = true;
       } else {
@@ -1799,6 +1802,7 @@ export class GaeaApp {
           child.AddChild(screen, false);
           const screenItem = { element: screen, type: type || null, category };
           this._screenIconList.push(screenItem);
+          this._applyMarkerVisibility(screenItem);
           return screen;
         }
       }
@@ -1810,9 +1814,19 @@ export class GaeaApp {
     Gaea.World.Instance.RenderableObjectList.AddLast(screen);
     const screenItem = { element: screen, type: type || null, category };
      this._screenIconList.push(screenItem);
+    this._applyMarkerVisibility(screenItem);
     return screen;
   }
 
+  /** 根据全局图标可见性状态（_markersVisible）应用单个图标显隐 */
+  _applyMarkerVisibility(screenItem) {
+    if (this._markersVisible) return;
+    screenItem.element.ForceSetVisible(false);
+    screenItem.element.EnablePick = false;
+    const el = document.getElementById(screenItem.element.DivID);
+    if (el) el.style.display = 'none';
+  }
+
   /** 记录当前视角，返回 URI 字符串 */
   favorite() {
     return Gaea.GaeaCamera.ConvertBy(Gaea.World.Instance.DefaultCamera).Favorite();
@@ -2095,7 +2109,7 @@ export class GaeaApp {
       Gaea.World.Instance.CameraController.LockedEntity = null;
       // 解锁时恢复非断面图标的自动可见
       this._screenIconList.forEach(item => {
-        if (!item.type) {
+        if (!item.type && this._markersVisible) {
           item.element.UseAutoVisible();
           item.element.EnablePick = true;
         }
@@ -2377,6 +2391,7 @@ export class GaeaApp {
 
   /** 显示所有屏幕标记 */
   showAllMarkers = () => {
+    this._markersVisible = true;
     this._screenIconList.forEach(item => {
       // 跳过被隐藏分类的标记
       if (this._hiddenCategories.has(item.category)) return
@@ -2390,6 +2405,7 @@ export class GaeaApp {
 
   /** 隐藏所有屏幕标记 */
   hideAllMarkers = () => {
+    this._markersVisible = false;
     this._screenIconList.forEach(item => {
       item.element.ForceSetVisible(false)
       item.element.EnablePick = false

package/src/vite-plugin.js

@@ -6,6 +6,7 @@
  * 2. 提供 /Gaea.js /Gaea.wasm /Gaea.pck 等静态文件
  * 3. 设置 COEP/COOP 头（SharedArrayBuffer 必需）
  * 4. 检测跨域隔离状态并自动刷新
+ * 5. 生产构建时把引擎静态资源复制到输出目录（closeBundle）
  *
  * 消费者用法（vite.config.js）：
  *   import { gaeaVitePlugin } from '@yangyongtao/gaea/plugin';
@@ -19,6 +20,24 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const pkgPublic = path.resolve(__dirname, '..', 'public');
 
+// 生产构建需复制的引擎静态资源：
+// - 顶层引擎文件（与注入的 <script src="/Gaea.js"> 位置保持一致，位于站点根路径）
+// - 子目录（serveLocal 指向 /static/，引擎还会访问 math/ image/ font/ icon/）
+const BUILD_TOP_FILES = [
+  'Gaea.js',
+  'Gaea.wasm',
+  'Gaea.pck',
+  'Gaea.worker.js',
+  'Gaea.audio.worklet.js',
+  'GaeaApp.html',
+  'GaeaModule.html',
+  'index.js',
+  'constants.js',
+  'jsencrypt.min.js',
+  'web-control.min.js',
+];
+const BUILD_COPY_DIRS = ['static/', 'math/', 'image/', 'font/', 'icon/'];
+
 const MIME = {
   '.wasm': 'application/wasm',
   '.pck': 'application/octet-stream',
@@ -37,10 +56,19 @@ const COEP_HEADERS = {
 };
 
 export default function gaeaVitePlugin() {
+  let resolvedOutDir = '';
+
   return {
     name: 'vite-plugin-gaea',
     enforce: 'pre',
 
+    // 记录生产构建的输出目录（closeBundle 时用于定位拷贝目标）
+    configResolved(config) {
+      resolvedOutDir = config.build?.outDir
+        ? path.resolve(config.root || process.cwd(), config.build.outDir)
+        : '';
+    },
+
     configureServer(server) {
       // COEP/COOP 头只对非 WebSocket 请求设置，避免破坏 Vite HMR
       server.middlewares.stack.unshift({
@@ -97,6 +125,46 @@ export default function gaeaVitePlugin() {
       });
     },
 
+    // 生产构建：把引擎静态资源复制到输出目录。
+    // configureServer 只在 dev 模式生效，vite build 不会运行，因此这里需自行拷贝。
+    closeBundle() {
+      const outRoot = resolvedOutDir || path.resolve(process.cwd(), 'dist');
+      if (!fs.existsSync(pkgPublic)) {
+        console.warn('[gaea] 未找到 gaea public 目录，跳过引擎资源复制:', pkgPublic);
+        return;
+      }
+
+      // 不覆盖输出目录中已存在的文件（消费者 public/ 下的资源优先）
+      const copyFile = (src, dest) => {
+        if (fs.existsSync(dest)) return;
+        fs.copyFileSync(src, dest);
+      };
+      const copyDir = (src, dest) => {
+        if (!fs.existsSync(src)) return;
+        for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+          const s = path.join(src, entry.name);
+          const d = path.join(dest, entry.name);
+          if (entry.isDirectory()) {
+            copyDir(s, d);
+          } else if (!fs.existsSync(d)) {
+            fs.mkdirSync(path.dirname(d), { recursive: true });
+            fs.copyFileSync(s, d);
+          }
+        }
+      };
+
+      fs.mkdirSync(outRoot, { recursive: true });
+      for (const name of BUILD_TOP_FILES) {
+        const src = path.join(pkgPublic, name);
+        if (fs.existsSync(src)) copyFile(src, path.join(outRoot, name));
+      }
+      for (const dir of BUILD_COPY_DIRS) {
+        const src = path.join(pkgPublic, dir);
+        if (fs.existsSync(src)) copyDir(src, path.join(outRoot, dir));
+      }
+      console.log('[gaea] 引擎资源已复制到输出目录:', outRoot);
+    },
+
     transformIndexHtml(html) {
       // 自动注入 Gaea.js（消费者无需在 HTML 中手动写 <script src="/Gaea.js">）
       if (!html.includes('/Gaea.js')) {