@nebula-spatial/viewer 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this package are documented in this file.
 
+## 0.4.1
+
+### Added
+
+- 内置普通模型预览新增 FBX 格式，支持按 `.fbx` 扩展名自动识别，并复用模型舞台、相机适配、up-axis 切换和资源释放契约；FBX 优先按文件 `GlobalSettings` 的正向 Y/Z up-axis 声明转换到 Viewer 的 Z-up 世界，无法判断时回退 Y-up，并可由显式 `upAxis` 覆盖；FBXLoader 生成的传统 Lambert/Phong 材质会转换为可由 Viewer 环境光照明的 PBR 材质。
+
 ## 0.4.0
 
 0.4.0 将 Viewer 从以 CAD 为主的 facade 扩展为统一资产预览器，并把 3D 模型与仿真资产接入同一个 Three.js 场景、相机、渲染器和帧循环。CAD 专属状态仍保留在 `viewer.cad`，但资产生命周期、内置 UI、加载状态和扩展机制已统一。

package/README.md

@@ -1,7 +1,7 @@
 # @nebula-spatial/viewer
 
 浏览器侧只读 Three.js 统一资产 Viewer Facade。负责场景运行时、相机、输入、拾取、渲染循环和
-资源释放；`openAsset()` 统一加载 CAD、GLB/glTF、URDF、MJCF 与 USD，`viewer.cad` 保留与
+资源释放；`openAsset()` 统一加载 CAD、GLB/glTF、FBX、URDF、MJCF 与 USD，`viewer.cad` 保留与
 `@nebula-spatial/cad-loader` 集成的兼容能力。
 
 Viewer 不解析 DXF/DWG，也不提供编辑命令、历史记录或业务状态管理。
@@ -211,6 +211,8 @@ Three.js Camera。应用成功后会同步发布 `camera-change` 和 `viewport-c
 
 ```ts
 const preview = viewer.openAsset('/models/robot.glb', { format: 'auto' });
+// .fbx 扩展名同样可自动识别：
+const fbxPreview = viewer.openAsset('/models/chair.fbx');
 const stop = preview.subscribe((snapshot) => updateLoadingUi(snapshot));
 await preview.ready;
 await preview.close();
@@ -221,7 +223,7 @@ stop();
 旧句柄的 `close()` 只等待自己的资源清理，不会关闭后来打开的资产。`closeAsset()` 关闭调用瞬间
 的活动资产。普通模型以 borrowed 方式挂入唯一 scene runtime，GPU 资源只由模型 session 释放。
 
-GLB/glTF 文件没有权威的 up 轴声明（规范 Y-up，CAD 导出常为 Z-up）。预览世界固定 Z-up；
+GLB/glTF 与 FBX 模型的 authored up 轴在 Viewer 中统一由 `upAxis` 声明。预览世界固定 Z-up；FBX 会先读取 `GlobalSettings` 中正向的 Y/Z `UpAxis` 与 `UpAxisSign` 声明，声明缺失、损坏或当前不支持时才回退到 Y-up。显式传入的 `upAxis` 始终优先；GLB/glTF 为兼容 CAD-kernel 导出继续默认使用 Z-up；
 对轴向错误的模型传 `upAxis: 'y'` 打开（仅旋转资产根节点，不移动相机与世界），或运行期用
 `preview.setUpAxis('y' | 'z')` / `preview.getUpAxis()` 切换（切换后自动重铺地面并重新适配
 相机，不平移贴地）。能力标志为 `capabilities.canReorientUpAxis`。仿真资产的格式自带 up 轴，
@@ -286,21 +288,22 @@ const preview = viewer.openAsset('https://cdn.example.com/robot/scene.xml', {
     },
   },
 });
-await preview.ready;
-```
-
-对于私有 OSS/S3/CDN，常见的预签名 URL 只授权一个具体 Object Key。`root.usd` 的签名通常不能
-复用于 `asset.usdc`、`physics/physics.usda`、纹理等兄弟资源，也不能把入口 URL 的 query
-原样拼接到其他路径。`resourceResolver.resolve(path)` 必须为每个 `path` 返回独立有效的签名 URL
-或已经取得的 `Blob`；入口 URL 自身也必须仍在有效期内。USD loader 会先提取分层 USD 的外部
-引用，再通过该 resolver 递归取得 layer、mesh、material 和 texture 资源；任一依赖返回 401/403
-都会作为鉴权加载失败报告，不会进入视觉降级流程。
-
-`{ kind: 'files', files, entry }` 只表示浏览器已经持有的本地 `File | Blob` 文件包，不能把远端
+await preview.ready;
+```
+
+对于私有 OSS/S3/CDN，常见的预签名 URL 只授权一个具体 Object Key。`root.usd` 的签名通常不能
+复用于 `asset.usdc`、`physics/physics.usda`、纹理等兄弟资源，也不能把入口 URL 的 query
+原样拼接到其他路径。`resourceResolver.resolve(path)` 必须为每个 `path` 返回独立有效的签名 URL
+或已经取得的 `Blob`；入口 URL 自身也必须仍在有效期内。USD loader 会先提取分层 USD 的外部
+引用，再通过该 resolver 递归取得 layer、mesh、material 和 texture 资源；任一依赖返回 401/403
+都会作为鉴权加载失败报告，不会进入视觉降级流程。
+
+`{ kind: 'files', files, entry }` 只表示浏览器已经持有的本地 `File | Blob` 文件包，不能把远端
 URL 字符串放进 `files[].file`。业务层负责入口选择、必要的格式判断、鉴权和依赖映射；不能只依赖
-Viewer 自动识别所有资产形态，也不能把本地样本验证等同于任意远端资产都兼容。普通 glTF 的
-外部资源仍由 `GLTFLoader` 按 URL 请求，不应假设所有格式的子资源都经过 `resourceResolver`；
-私有 glTF 资产优先采用同源/签名目录，或交付为 GLB。
+Viewer 自动识别所有资产形态，也不能把本地样本验证等同于任意远端资产都兼容。普通 glTF 与 FBX 的
+外部资源仍由对应 Three.js loader 按 URL 请求，不应假设这些格式的子资源都经过 `resourceResolver`；
+私有 glTF/FBX 资产优先采用同源或可独立鉴权的资源目录。单个本地 FBX 文件适合使用内嵌纹理；
+若纹理是外置文件，应使用可保持相对目录结构的远端 URL。
 
 OpenUSD 使用 pthread WASM，部署必须在安全上下文中提供以下响应头：
 

package/dist/assets/types.d.ts

@@ -2,7 +2,7 @@ import type { Object3D, WebGLRenderer, Scene, Camera, Box3, ColorRepresentation
 import type { CadLoadSource, CadOpenOptions } from '../cad/types';
 import type { ViewerViewMode } from '../types';
 export type AssetPreviewKind = 'cad' | 'model' | 'simulation';
-export type BuiltinAssetFormat = 'cad' | 'glb' | 'gltf' | 'urdf' | 'mjcf' | 'usd' | 'usda' | 'usdc' | 'usdz';
+export type BuiltinAssetFormat = 'cad' | 'glb' | 'gltf' | 'fbx' | 'urdf' | 'mjcf' | 'usd' | 'usda' | 'usdc' | 'usdz';
 export type AssetFormat = BuiltinAssetFormat | (string & {});
 export interface AssetFileEntry {
     readonly path: string;
@@ -37,10 +37,11 @@ export interface OpenAssetOptions {
     readonly mujocoBaseUrl?: string;
     readonly openUsdBaseUrl?: string;
     /**
-     * Which authored axis is "up" for a plain model asset. glTF's normative
-     * coordinate system is Y-up, but CAD-kernel exporters emit Z-up files with no
-     * in-file declaration, so this cannot be inferred reliably. Defaults to 'z',
-     * matching the preview world; 'y' rotates the model root into world +Z.
+     * Which authored axis is "up" for a plain model asset. FBX first uses a
+     * supported positive Y/Z declaration from GlobalSettings, then falls back to
+     * 'y' when it is missing or cannot be read. GLB/glTF retain the existing 'z'
+     * default for CAD-kernel compatibility. An explicit value always wins. 'y'
+     * rotates the model root into world +Z.
      * Ignored by simulation assets, whose formats declare their own up axis.
      */
     readonly upAxis?: AssetUpAxis;

package/dist/{index-Lsk3kHNe.js → index-D0lW4RQP.js}

@@ -5758,7 +5758,7 @@ const ss = {
       kind: "asset-loader",
       id: "nebula.model-loader",
       assetKind: "model",
-      formats: ["glb", "gltf"],
+      formats: ["glb", "gltf", "fbx"],
       presentation: {
         preferredViewMode: "3d",
         interactionMode: "object",
@@ -5769,7 +5769,7 @@ const ss = {
         clearColor: B.dark
       },
       async createSession(e, t) {
-        const { createModelSession: i } = await import("./session-CGaj14lM.js");
+        const { createModelSession: i } = await import("./session-B4uKXhdV.js");
         return i(e, t);
       }
     });
@@ -5853,7 +5853,7 @@ const cs = {
         clearColor: B.dark
       },
       async createSession(e, t) {
-        const { createSimulationSession: i } = await import("./session-B_UiRctl.js").then((r) => r.s);
+        const { createSimulationSession: i } = await import("./session-DNMxzxd5.js").then((r) => r.s);
         return i(e, t);
       }
     });

package/dist/index.js

@@ -1,4 +1,4 @@
-import { c as o } from "./index-Lsk3kHNe.js";
+import { c as o } from "./index-D0lW4RQP.js";
 import { configureCadTextBuilder as t } from "@nebula-spatial/cad-loader";
 export {
   t as configureViewerText,

package/dist/session-B4uKXhdV.js

@@ -0,0 +1,266 @@
+import { Mesh as F, MeshPhongMaterial as m, MeshLambertMaterial as D, MeshStandardMaterial as L, Color as A, Quaternion as w, Vector3 as B, Group as E, LoaderUtils as C, Box3 as N } from "three";
+import { DRACOLoader as v } from "three/examples/jsm/loaders/DRACOLoader.js";
+import { FBXLoader as G } from "three/examples/jsm/loaders/FBXLoader.js";
+import { GLTFLoader as _ } from "three/examples/jsm/loaders/GLTFLoader.js";
+import { S as R, d as O } from "./stage-CFr9ZkwQ.js";
+const b = "Kaydara FBX Binary  \0", X = /(?:^|[\r\n])\s*P:\s*"UpAxis"\s*,\s*"int"\s*,\s*"Integer"\s*,\s*""\s*,\s*(-?\d+)/i, z = /(?:^|[\r\n])\s*P:\s*"UpAxisSign"\s*,\s*"int"\s*,\s*"Integer"\s*,\s*""\s*,\s*(-?\d+)/i;
+function V(e) {
+  try {
+    const n = new Uint8Array(e), r = q(n) ? Y(e) : W(new TextDecoder().decode(n));
+    return !r || r.sign !== 1 ? null : r.axis === 1 ? "y" : r.axis === 2 ? "z" : null;
+  } catch {
+    return null;
+  }
+}
+function q(e) {
+  if (e.byteLength < b.length) return !1;
+  for (let n = 0; n < b.length; n += 1)
+    if (e[n] !== b.charCodeAt(n)) return !1;
+  return !0;
+}
+function W(e) {
+  var t, i;
+  const n = Number.parseInt(((t = X.exec(e)) == null ? void 0 : t[1]) ?? "", 10);
+  if (!Number.isInteger(n)) return null;
+  const r = (i = z.exec(e)) == null ? void 0 : i[1], s = r === void 0 ? 1 : Number.parseInt(r, 10);
+  return Number.isInteger(s) ? { axis: n, sign: s } : null;
+}
+function Y(e) {
+  const n = new DataView(e);
+  if (n.byteLength < 27) return null;
+  const r = n.getUint32(23, !0) >= 7500;
+  let s = 27;
+  for (; s < n.byteLength; ) {
+    const t = T(n, s, r, !1);
+    if (!t) break;
+    if (t.name === "GlobalSettings") return P(n, t.childrenOffset, t.endOffset, r);
+    s = t.endOffset;
+  }
+  return null;
+}
+function P(e, n, r, s) {
+  let t = n, i = null, l = 1;
+  for (; t < r; ) {
+    const a = T(e, t, s, !0);
+    if (!a) break;
+    if (a.name === "P") {
+      const [u, , , , o] = a.properties;
+      u === "UpAxis" && typeof o == "number" && (i = o), u === "UpAxisSign" && typeof o == "number" && (l = o);
+    }
+    if (a.childrenOffset < a.endOffset) {
+      const u = P(e, a.childrenOffset, a.endOffset, s);
+      u && (i ?? (i = u.axis), l = u.sign);
+    }
+    t = a.endOffset;
+  }
+  return i === null ? null : { axis: i, sign: l };
+}
+function T(e, n, r, s) {
+  const t = r ? 25 : 13;
+  if (n + t > e.byteLength) return null;
+  const i = M(e, n, r), l = M(e, n + (r ? 8 : 4), r), a = M(e, n + (r ? 16 : 8), r), u = e.getUint8(n + (r ? 24 : 12));
+  if (i === 0) return null;
+  const o = n + t, c = o + u, f = c + a;
+  if (i > e.byteLength || f > i) return null;
+  const d = new TextDecoder().decode(new Uint8Array(e.buffer, e.byteOffset + o, u)), p = [];
+  if (s) {
+    let h = c;
+    for (let y = 0; y < l; y += 1) {
+      const g = $(e, h);
+      if (p.push(g.value), h = g.nextOffset, h > f) return null;
+    }
+  }
+  return { name: d, endOffset: i, childrenOffset: f, properties: p };
+}
+function M(e, n, r) {
+  if (!r) return e.getUint32(n, !0);
+  const s = e.getBigUint64(n, !0);
+  if (s > BigInt(Number.MAX_SAFE_INTEGER)) throw new Error("FBX offset exceeds the safe integer range.");
+  return Number(s);
+}
+function $(e, n) {
+  const r = String.fromCharCode(e.getUint8(n));
+  switch (r) {
+    case "Y":
+      return { value: e.getInt16(n + 1, !0), nextOffset: n + 3 };
+    case "C":
+      return { value: e.getUint8(n + 1) !== 0, nextOffset: n + 2 };
+    case "I":
+      return { value: e.getInt32(n + 1, !0), nextOffset: n + 5 };
+    case "F":
+      return { value: e.getFloat32(n + 1, !0), nextOffset: n + 5 };
+    case "D":
+      return { value: e.getFloat64(n + 1, !0), nextOffset: n + 9 };
+    case "L":
+      return { value: Number(e.getBigInt64(n + 1, !0)), nextOffset: n + 9 };
+    case "S":
+    case "R": {
+      const s = e.getUint32(n + 1, !0), t = n + 5, i = new Uint8Array(e.buffer, e.byteOffset + t, s);
+      return { value: r === "S" ? new TextDecoder().decode(i) : i, nextOffset: t + s };
+    }
+    case "f":
+    case "d":
+    case "l":
+    case "i":
+    case "b":
+    case "c": {
+      const s = e.getUint32(n + 9, !0);
+      return { value: null, nextOffset: n + 13 + s };
+    }
+    default:
+      throw new Error(`Unsupported FBX property type: ${r}`);
+  }
+}
+function j(e) {
+  const n = /* @__PURE__ */ new Map();
+  e.traverse((r) => {
+    r instanceof F && (Array.isArray(r.material) ? r.material = r.material.map((s) => S(s, n)) : r.material = S(r.material, n));
+  });
+  for (const [r, s] of n)
+    r !== s && r.dispose();
+}
+function S(e, n) {
+  var i, l, a;
+  const r = n.get(e);
+  if (r) return r;
+  if (!(e instanceof m) && !(e instanceof D))
+    return n.set(e, e), e;
+  const s = e instanceof m ? e : null, t = new L({
+    name: e.name,
+    color: ((i = e.color) == null ? void 0 : i.clone()) ?? new A(16777215),
+    map: e.map,
+    emissive: ((l = e.emissive) == null ? void 0 : l.clone()) ?? new A(0),
+    emissiveMap: e.emissiveMap,
+    emissiveIntensity: e.emissiveIntensity,
+    normalMap: e.normalMap,
+    normalMapType: e.normalMapType,
+    normalScale: (a = e.normalScale) == null ? void 0 : a.clone(),
+    bumpMap: e.bumpMap,
+    bumpScale: e.bumpScale,
+    displacementMap: e.displacementMap,
+    displacementScale: e.displacementScale,
+    displacementBias: e.displacementBias,
+    aoMap: e.aoMap,
+    aoMapIntensity: e.aoMapIntensity,
+    alphaMap: e.alphaMap,
+    opacity: e.opacity,
+    transparent: e.transparent,
+    alphaTest: e.alphaTest,
+    side: e.side,
+    depthTest: e.depthTest,
+    depthWrite: e.depthWrite,
+    vertexColors: e.vertexColors,
+    wireframe: e.wireframe,
+    flatShading: e.flatShading,
+    metalness: 0,
+    // Approximate the Blinn-Phong exponent as perceptual roughness. This keeps
+    // glossy FBX materials glossy without pretending they carry metalness data.
+    roughness: s ? Math.min(1, Math.max(0.04, Math.sqrt(2 / (s.shininess + 2)))) : 1
+  });
+  return t.userData = { ...e.userData }, t.visible = e.visible, t.toneMapped = e.toneMapped, t.clippingPlanes = e.clippingPlanes, t.clipIntersection = e.clipIntersection, t.clipShadows = e.clipShadows, t.polygonOffset = e.polygonOffset, t.polygonOffsetFactor = e.polygonOffsetFactor, t.polygonOffsetUnits = e.polygonOffsetUnits, t.dithering = e.dithering, t.needsUpdate = !0, n.set(e, t), t;
+}
+const k = new w().setFromAxisAngle(new B(1, 0, 0), Math.PI / 2), Q = new w();
+function U(e) {
+  return e === "fbx" ? "y" : "z";
+}
+function K(e) {
+  return e === "y" ? k : Q;
+}
+function I(e, n) {
+  const r = K(n);
+  return r.equals(e.quaternion) ? !1 : (e.quaternion.copy(r), e.updateMatrixWorld(!0), !0);
+}
+function re(e, n) {
+  let r = !1, s = null, t = null, i = "z", l;
+  const a = () => {
+    r = !0;
+  }, u = (async () => {
+    i = n.options.upAxis ?? U(n.format);
+    let o = null;
+    try {
+      if (r || n.signal.aborted) throw x();
+      const c = e.url ?? await e.resolve(e.entryPath ?? "");
+      if (o = new E(), o.name = "viewer-model-root", n.format === "fbx") {
+        const d = await fetch(c, { signal: n.signal });
+        if (!d.ok) throw new Error(`FBX request failed: ${d.status} ${d.statusText}`);
+        const p = await d.arrayBuffer();
+        i = n.options.upAxis ?? V(p) ?? U(n.format), o.add(new G().parse(p, C.extractUrlBase(c))), j(o);
+      } else {
+        const d = new v(), p = new _();
+        try {
+          n.options.dracoDecoderPath && d.setDecoderPath(n.options.dracoDecoderPath), p.setDRACOLoader(d);
+          const h = await p.loadAsync(c), y = h.scenes.filter((g) => g !== h.scene);
+          if (o.add(h.scene), r || n.signal.aborted) {
+            for (const g of y) o.add(g);
+            throw x();
+          }
+        } finally {
+          d.dispose();
+        }
+      }
+      if (r || n.signal.aborted) throw x();
+      I(o, i), Z(o);
+      const f = new R(o, n.options.simulationTheme, void 0, "model");
+      s = o, t = f, o = null;
+    } finally {
+      o && O(o);
+    }
+  })();
+  return u.catch(() => {
+  }), {
+    id: `model-${Math.random().toString(36).slice(2)}`,
+    opened: u,
+    get root() {
+      return (t == null ? void 0 : t.root) ?? null;
+    },
+    getFitBounds() {
+      return (t == null ? void 0 : t.getModelBounds()) ?? null;
+    },
+    beforeRender(o, c, f) {
+      return t == null ? void 0 : t.beforeRender(o, c, f);
+    },
+    capabilities: { canPlay: !1, canPause: !1, canReset: !1, hasPhysics: !1, canReorientUpAxis: !0, canToggleGround: !0 },
+    // Session presentation overrides are only consulted for `interactionMode`
+    // and `fitPolicy`; the UI group comes from the loader descriptor. Keep the
+    // two in sync so the override never reads as a contradictory value.
+    presentation: { preferredViewMode: "3d", interactionMode: "object", uiProfile: "model", fitPolicy: "fit-on-ready" },
+    getUpAxis() {
+      return s ? i : null;
+    },
+    setTheme(o) {
+      t == null || t.setTheme(o);
+    },
+    setGroundVisible(o) {
+      t == null || t.setGroundVisible(o);
+    },
+    getGroundVisible() {
+      return (t == null ? void 0 : t.getGroundVisible()) ?? !0;
+    },
+    setUpAxis(o) {
+      if (r || !s || !t || !I(s, o)) return;
+      i = o, t.reseatGround();
+      const c = t.getModelBounds();
+      n.requestRender(), n.fit(c, { padding: 1.15 });
+    },
+    beginDispose: a,
+    dispose() {
+      return a(), l ?? (l = u.catch(() => {
+      }).then(() => {
+        t == null || t.dispose(), t = null, s && O(s), s = null;
+      })), l;
+    }
+  };
+}
+function Z(e) {
+  e.updateMatrixWorld(!0);
+  const n = new N().setFromObject(e);
+  if (n.isEmpty()) throw new Error("模型不包含可显示的几何内容。");
+  const r = n.getSize(new B()), s = Math.max(r.x, r.y, r.z);
+  if (!Number.isFinite(s) || s <= 0) throw new Error("模型尺寸无效。");
+}
+function x() {
+  return Object.assign(new Error("Model load aborted."), { name: "AbortError", code: "E_ABORTED" });
+}
+export {
+  re as createModelSession
+};

package/dist/{session-B_UiRctl.js → session-DNMxzxd5.js}

@@ -1,7 +1,7 @@
 var Ee = Object.defineProperty;
 var Se = (o, e, t) => e in o ? Ee(o, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : o[e] = t;
 var D = (o, e, t) => Se(o, typeof e != "symbol" ? e + "" : e, t);
-import { d as Ae, S as le } from "./stage-BxROW_dP.js";
+import { d as Ae, S as le } from "./stage-CFr9ZkwQ.js";
 import { ConvexGeometry as ve } from "three/examples/jsm/geometries/ConvexGeometry.js";
 import { LineBasicMaterial as Me, LineSegments as Oe, EdgesGeometry as $e, Group as z, MeshStandardMaterial as he, Mesh as I, PlaneGeometry as Re, BoxGeometry as X, SphereGeometry as ee, CylinderGeometry as te, CapsuleGeometry as ye, Vector3 as T, BufferGeometry as Pe, BufferAttribute as ue, Euler as J, MathUtils as Ue, Matrix3 as ce, Matrix4 as k, Quaternion as be, LoadingManager as Fe } from "three";
 import { GLTFLoader as qe } from "three/examples/jsm/loaders/GLTFLoader.js";
@@ -626,7 +626,7 @@ function ut(o, e) {
       const O = e.format;
       if (O === "usd" || O === "usda" || O === "usdc" || O === "usdz") {
         (y = e.reportProgress) == null || y.call(e, "usd", "正在解析 USD 场景与物理刚体...");
-        const E = await (await import("./usd-session-Dcd20Z6G.js")).loadUsdSimulation(o, e, t);
+        const E = await (await import("./usd-session-DDWM5msM.js")).loadUsdSimulation(o, e, t);
         if (i || e.signal.aborted)
           throw E.dispose(), _e();
         p = E.asset, n = E.binding, l = E.dispose, u = E.hasPhysics ? E.step : null, c = E.reset, s = E.hasPhysics, m = E.hasPhysics, b = E.fallback ? { ...E.fallback, stage: "physics-fallback" } : null, (g = e.reportProgress) == null || g.call(e, "stage", "正在构建三维场景与环境光影..."), f = new le(n.root, e.options.simulationTheme, E.runtime), E.runtime ? (r = E.runtime, a = new W(r, Y(r, !0))) : a = E.collision ?? null, a && (a.root.visible = !1, f.attachAuxiliary(a.root));

package/dist/{stage-BxROW_dP.js → stage-CFr9ZkwQ.js}

@@ -2,7 +2,7 @@ var v = Object.defineProperty;
 var y = (c, e, t) => e in c ? v(c, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : c[e] = t;
 var a = (c, e, t) => y(c, typeof e != "symbol" ? e + "" : e, t);
 import * as o from "three";
-import { V as p } from "./index-Lsk3kHNe.js";
+import { V as p } from "./index-D0lW4RQP.js";
 const x = 1, b = (
   /* glsl */
   `

package/dist/{usd-session-Dcd20Z6G.js → usd-session-DDWM5msM.js}

@@ -1,8 +1,8 @@
 import { Group as ot, Mesh as at, Vector3 as _, Quaternion as j, Matrix4 as X, Box3 as ht } from "three";
 import { USDLoader as It } from "@openusd-wasm/three-loader";
 import { PXR as $t } from "@openusd-wasm/pxr";
-import { c as Rt, a as xt, b as At, d as Nt, S as Mt } from "./session-B_UiRctl.js";
-import { d as _t } from "./stage-BxROW_dP.js";
+import { c as Rt, a as xt, b as At, d as Nt, S as Mt } from "./session-DNMxzxd5.js";
+import { d as _t } from "./stage-CFr9ZkwQ.js";
 async function ee(t, e, n) {
   var w;
   Bt();

package/package.json

@@ -1,57 +1,57 @@
-{
-  "name": "@nebula-spatial/viewer",
-  "version": "0.4.0",
-  "description": "Read-only Three.js viewer facade",
-  "license": "ISC",
-  "engines": {
-    "node": ">=18"
-  },
-  "type": "module",
-  "files": [
-    "dist",
-    "README.md",
-    "CHANGELOG.md",
-    "package.json"
-  ],
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    }
-  },
-  "sideEffects": false,
-  "scripts": {
-    "build": "npm run check:boundary && npm run typecheck && npm run build:bundle && npm run build:types && npm run check:dist",
-    "build:bundle": "vite build --config vite.config.ts",
-    "build:types": "tsc --project tsconfig.build.json && node scripts/prune-dist-types.mjs",
-    "check:boundary": "node scripts/check-boundary.mjs",
-    "check:dist": "node scripts/check-dist.mjs",
-    "typecheck": "tsc --project tsconfig.json --noEmit",
-    "test": "vitest run --config vitest.config.ts",
-    "pack:dry": "npm pack --dry-run",
-    "prepack": "npm run build"
-  },
-  "dependencies": {
-    "@mujoco/mujoco": "^3.12.0",
-    "@nebula-spatial/cad-loader": "^0.3.0",
-    "@openusd-wasm/pxr": "0.0.13",
-    "@openusd-wasm/three-loader": "^0.0.13"
-  },
-  "peerDependencies": {
-    "three": "0.182.0"
-  },
-  "devDependencies": {
-    "@types/jsdom": "^27.0.0",
-    "@types/node": "^25.6.0",
-    "@types/three": "0.182.0",
-    "jsdom": "^29.0.2",
-    "three": "0.182.0",
-    "typescript": "^5.6.3",
-    "vite": "^5.4.10",
-    "vitest": "^2.1.8"
-  }
-}
+{
+  "name": "@nebula-spatial/viewer",
+  "version": "0.4.1",
+  "description": "Read-only Three.js viewer facade",
+  "license": "ISC",
+  "engines": {
+    "node": ">=18"
+  },
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "package.json"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "npm run check:boundary && npm run typecheck && npm run build:bundle && npm run build:types && npm run check:dist",
+    "build:bundle": "vite build --config vite.config.ts",
+    "build:types": "tsc --project tsconfig.build.json && node scripts/prune-dist-types.mjs",
+    "check:boundary": "node scripts/check-boundary.mjs",
+    "check:dist": "node scripts/check-dist.mjs",
+    "typecheck": "tsc --project tsconfig.json --noEmit",
+    "test": "vitest run --config vitest.config.ts",
+    "pack:dry": "npm pack --dry-run",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@mujoco/mujoco": "^3.12.0",
+    "@nebula-spatial/cad-loader": "^0.3.0",
+    "@openusd-wasm/pxr": "0.0.13",
+    "@openusd-wasm/three-loader": "^0.0.13"
+  },
+  "peerDependencies": {
+    "three": "0.182.0"
+  },
+  "devDependencies": {
+    "@types/jsdom": "^27.0.0",
+    "@types/node": "^25.6.0",
+    "@types/three": "0.182.0",
+    "jsdom": "^29.0.2",
+    "three": "0.182.0",
+    "typescript": "^5.6.3",
+    "vite": "^5.4.10",
+    "vitest": "^2.1.8"
+  }
+}

package/dist/session-CGaj14lM.js

@@ -1,93 +0,0 @@
-import { Quaternion as y, Vector3 as M, Group as P, Box3 as T } from "three";
-import { DRACOLoader as x } from "three/examples/jsm/loaders/DRACOLoader.js";
-import { GLTFLoader as D } from "three/examples/jsm/loaders/GLTFLoader.js";
-import { S as E, d as w } from "./stage-BxROW_dP.js";
-const G = new y().setFromAxisAngle(new M(1, 0, 0), Math.PI / 2), R = new y();
-function S(r) {
-  return r === "y" ? G : R;
-}
-function b(r, n) {
-  const t = S(n);
-  return t.equals(r.quaternion) ? !1 : (r.quaternion.copy(t), r.updateMatrixWorld(!0), !0);
-}
-function z(r, n) {
-  let t = !1, i = null, e = null, d = "z", f;
-  const l = new x(), p = new D(), m = () => {
-    t = !0;
-  }, a = (async () => {
-    d = n.options.upAxis ?? "z", n.options.dracoDecoderPath && l.setDecoderPath(n.options.dracoDecoderPath), p.setDRACOLoader(l);
-    let o = null;
-    try {
-      if (t || n.signal.aborted) throw h();
-      const s = await p.loadAsync(r.url ?? await r.resolve(r.entryPath ?? ""));
-      o = new P(), o.name = "viewer-model-root";
-      const u = s.scenes.filter((c) => c !== s.scene);
-      if (o.add(s.scene), t || n.signal.aborted) {
-        for (const c of u) o.add(c);
-        throw h();
-      }
-      b(o, d), g(o);
-      const A = new E(o, n.options.simulationTheme, void 0, "model");
-      i = o, e = A, o = null;
-    } finally {
-      o && w(o), l.dispose();
-    }
-  })();
-  return a.catch(() => {
-  }), {
-    id: `model-${Math.random().toString(36).slice(2)}`,
-    opened: a,
-    get root() {
-      return (e == null ? void 0 : e.root) ?? null;
-    },
-    getFitBounds() {
-      return (e == null ? void 0 : e.getModelBounds()) ?? null;
-    },
-    beforeRender(o, s, u) {
-      return e == null ? void 0 : e.beforeRender(o, s, u);
-    },
-    capabilities: { canPlay: !1, canPause: !1, canReset: !1, hasPhysics: !1, canReorientUpAxis: !0, canToggleGround: !0 },
-    // Session presentation overrides are only consulted for `interactionMode`
-    // and `fitPolicy`; the UI group comes from the loader descriptor. Keep the
-    // two in sync so the override never reads as a contradictory value.
-    presentation: { preferredViewMode: "3d", interactionMode: "object", uiProfile: "model", fitPolicy: "fit-on-ready" },
-    getUpAxis() {
-      return i ? d : null;
-    },
-    setTheme(o) {
-      e == null || e.setTheme(o);
-    },
-    setGroundVisible(o) {
-      e == null || e.setGroundVisible(o);
-    },
-    getGroundVisible() {
-      return (e == null ? void 0 : e.getGroundVisible()) ?? !0;
-    },
-    setUpAxis(o) {
-      if (t || !i || !e || !b(i, o)) return;
-      d = o, e.reseatGround();
-      const s = e.getModelBounds();
-      n.requestRender(), n.fit(s, { padding: 1.15 });
-    },
-    beginDispose: m,
-    dispose() {
-      return m(), f ?? (f = a.catch(() => {
-      }).then(() => {
-        e == null || e.dispose(), e = null, i && w(i), i = null;
-      })), f;
-    }
-  };
-}
-function g(r) {
-  r.updateMatrixWorld(!0);
-  const n = new T().setFromObject(r);
-  if (n.isEmpty()) throw new Error("模型不包含可显示的几何内容。");
-  const t = n.getSize(new M()), i = Math.max(t.x, t.y, t.z);
-  if (!Number.isFinite(i) || i <= 0) throw new Error("模型尺寸无效。");
-}
-function h() {
-  return Object.assign(new Error("Model load aborted."), { name: "AbortError", code: "E_ABORTED" });
-}
-export {
-  z as createModelSession
-};