@nebula-spatial/viewer 0.3.0 → 0.4.1

package/dist/mujoco-runtime-s85kwjo7.js

@@ -0,0 +1,208 @@
+var E = Object.defineProperty;
+var M = (r, t, i) => t in r ? E(r, t, { enumerable: !0, configurable: !0, writable: !0, value: i }) : r[t] = i;
+var p = (r, t, i) => M(r, typeof t != "symbol" ? t + "" : t, i);
+import T from "@mujoco/mujoco";
+import I from "@mujoco/mujoco/mujoco.wasm?url";
+let w = 0;
+function F(r, t) {
+  const i = `/viewer-simulation-${++w}`;
+  r.mkdir(i);
+  const n = /* @__PURE__ */ new Set([i]), o = /* @__PURE__ */ new Set(), a = (e, s) => {
+    const c = e.replaceAll("\\", "/").split("/");
+    if (c[0] === "" || c.some((u) => u === ".." || u.includes(":"))) throw b(`Invalid package path: ${e}`, "E_SIMULATION_PATH");
+    const l = c.filter((u) => u && u !== ".");
+    if (!l.length) throw b("Package path is empty.", "E_SIMULATION_PATH");
+    let m = i;
+    for (const u of l.slice(0, -1))
+      m += `/${u}`, n.has(m) || (r.mkdir(m), n.add(m));
+    const d = `${i}/${l.join("/")}`;
+    return r.writeFile(d, s), o.add(d), d;
+  }, h = () => {
+    for (const e of o) r.unlink(e);
+    o.clear();
+    for (const e of [...n].reverse()) r.rmdir(e);
+    n.clear();
+  };
+  try {
+    for (const [e, s] of t) a(e, s);
+    return { writeEntry: (e) => a("__viewer_entry.xml", e), dispose: h };
+  } catch (e) {
+    throw h(), e;
+  }
+}
+function b(r, t) {
+  return Object.assign(new Error(r), { code: t });
+}
+function O({
+  target: r,
+  point: t,
+  velocity: i,
+  stiffness: n,
+  damping: o,
+  maxForce: a,
+  strength: h
+}) {
+  const e = [
+    n * (r[0] - t[0]) - o * i[0],
+    n * (r[1] - t[1]) - o * i[1],
+    n * (r[2] - t[2]) - o * i[2]
+  ], s = Math.hypot(e[0], e[1], e[2]), c = a * h;
+  if (s > c && s > 0) {
+    const l = c / s;
+    e[0] *= l, e[1] *= l, e[2] *= l;
+  }
+  return e;
+}
+const f = 1 / 240, A = 0.05, v = 80, x = 1.15, g = 3.5, y = 14;
+class C {
+  constructor() {
+    p(this, "mujoco", null);
+    p(this, "model", null);
+    p(this, "data", null);
+    p(this, "grab", null);
+    p(this, "lastGrabForce", [0, 0, 0]);
+    p(this, "velocityBuffer", new Float64Array(6));
+    p(this, "initialControls", []);
+    p(this, "accumulator", 0);
+    p(this, "initialVelocities", []);
+  }
+  async initialize(t, i) {
+    var h;
+    this.mujoco ?? (this.mujoco = await T({ locateFile: (e) => e.endsWith(".wasm") ? i ? new URL(e, i).href : I : e }));
+    const n = F(this.mujoco.FS, t.files);
+    let o = null, a = null;
+    try {
+      o = this.mujoco.MjModel.from_xml_path(n.writeEntry(t.xml));
+      for (const e of t.massOverrides ?? []) {
+        const s = this.mujoco.mj_name2id(o, this.mujoco.mjtObj.mjOBJ_BODY.value, e.body);
+        if (s <= 0 || !Number.isFinite(e.mass) || e.mass <= 0 || !(o.body_mass[s] > 0)) throw new Error(`Invalid mass override: ${e.body}`);
+        const c = e.mass / o.body_mass[s];
+        o.body_mass[s] = e.mass;
+        for (let l = 0; l < 3; l++) o.body_inertia[s * 3 + l] *= c;
+      }
+      a = new this.mujoco.MjData(o), (h = t.massOverrides) != null && h.length && this.mujoco.mj_setConst(o, a), o.opt.timestep = f, this.applyInitialControls(a, t.initialControls), this.applyInitialVelocities(o, a, t.initialVelocities), this.mujoco.mj_forward(o, a);
+    } catch (e) {
+      throw a == null || a.delete(), o == null || o.delete(), _(e, "E_MUJOCO_INITIALIZE");
+    } finally {
+      n.dispose();
+    }
+    this.disposeModel(), this.model = o, this.data = a, this.initialControls = t.initialControls ?? [], this.initialVelocities = t.initialVelocities ?? [], this.accumulator = 0;
+  }
+  beginGrab({
+    bodyId: t,
+    localPoint: i,
+    target: n,
+    stiffness: o = v,
+    damping: a,
+    maxForce: h,
+    dampingRatio: e = x,
+    maxTargetSpeed: s = g,
+    targetResponse: c = y
+  }) {
+    var j;
+    const l = Math.max(((j = this.model) == null ? void 0 : j.body_mass[t]) ?? 1, 1e-3), m = a ?? 2 * Math.sqrt(o * l) * e, d = h ?? Math.max(120, l * 60), u = [n[0], n[1], n[2]];
+    this.grab = {
+      bodyId: t,
+      localPoint: [i[0], i[1], i[2]],
+      target: [...u],
+      requestedTarget: u,
+      stiffness: o,
+      damping: m,
+      maxForce: d,
+      strength: 1,
+      maxTargetSpeed: s,
+      targetResponse: c
+    };
+  }
+  updateGrabTarget(t) {
+    this.grab && (this.grab.requestedTarget = [t[0], t[1], t[2]]);
+  }
+  updateGrabStrength(t) {
+    this.grab && (this.grab.strength = t);
+  }
+  applyGrabForce() {
+    if (!this.grab || !this.model || !this.data || !this.mujoco) return;
+    const { bodyId: t, localPoint: i, target: n, stiffness: o, damping: a, maxForce: h, strength: e } = this.grab, s = this.data.xmat.subarray(t * 9, t * 9 + 9), c = this.data.xpos.subarray(t * 3, t * 3 + 3), l = [
+      c[0] + s[0] * i[0] + s[1] * i[1] + s[2] * i[2],
+      c[1] + s[3] * i[0] + s[4] * i[1] + s[5] * i[2],
+      c[2] + s[6] * i[0] + s[7] * i[1] + s[8] * i[2]
+    ];
+    this.mujoco.mj_objectVelocity(
+      this.model,
+      this.data,
+      this.mujoco.mjtObj.mjOBJ_BODY.value,
+      t,
+      this.velocityBuffer,
+      0
+    );
+    const m = this.velocityBuffer, d = [
+      l[0] - c[0],
+      l[1] - c[1],
+      l[2] - c[2]
+    ], u = [
+      m[3] + m[1] * d[2] - m[2] * d[1],
+      m[4] + m[2] * d[0] - m[0] * d[2],
+      m[5] + m[0] * d[1] - m[1] * d[0]
+    ], j = O({ target: n, point: l, velocity: u, stiffness: o, damping: a, maxForce: h, strength: e });
+    this.lastGrabForce = [...j], this.data.qfrc_applied.fill(0), this.mujoco.mj_applyFT(
+      this.model,
+      this.data,
+      j,
+      [0, 0, 0],
+      l,
+      t,
+      this.data.qfrc_applied
+    );
+  }
+  endGrab() {
+    this.data && this.data.qfrc_applied.fill(0), this.lastGrabForce = [0, 0, 0], this.grab = null;
+  }
+  step(t) {
+    if (!this.mujoco || !this.model || !this.data || t <= 0) return !1;
+    this.accumulator += Math.min(t, A);
+    let i = !1;
+    for (; this.accumulator >= f; )
+      this.updateGrabTargetForStep(), this.applyGrabForce(), this.mujoco.mj_step(this.model, this.data), this.accumulator -= f, i = !0;
+    return i;
+  }
+  updateGrabTargetForStep() {
+    const t = this.grab;
+    if (!t) return;
+    const i = t.requestedTarget ?? t.target, n = (t.maxTargetSpeed ?? g) * Math.max(1, Math.sqrt(t.strength)), o = t.targetResponse ?? y, a = 1 - Math.exp(-o * f), h = n * f;
+    for (let e = 0; e < 3; e++) {
+      const s = i[e] - t.target[e], c = Math.sign(s) * Math.min(Math.abs(s) * a, h);
+      t.target[e] += c;
+    }
+  }
+  reset() {
+    !this.mujoco || !this.model || !this.data || (this.endGrab(), this.mujoco.mj_resetData(this.model, this.data), this.applyInitialControls(this.data, this.initialControls), this.applyInitialVelocities(this.model, this.data, this.initialVelocities), this.mujoco.mj_forward(this.model, this.data), this.accumulator = 0);
+  }
+  dispose() {
+    this.disposeModel(), this.mujoco = null;
+  }
+  applyInitialControls(t, i) {
+    if (i != null && i.length) {
+      if (i.length !== t.ctrl.length) throw _(new Error(`Initial control count ${i.length} does not match MuJoCo actuator count ${t.ctrl.length}.`), "E_MUJOCO_INITIALIZE");
+      t.ctrl.set(i);
+    }
+  }
+  applyInitialVelocities(t, i, n) {
+    for (const o of n ?? []) {
+      const a = this.mujoco.mj_name2id(t, this.mujoco.mjtObj.mjOBJ_BODY.value, o.body), h = a >= 0 ? t.body_jntadr[a] : -1;
+      if (h < 0 || t.jnt_type[h] !== this.mujoco.mjtJoint.mjJNT_FREE.value || o.velocity.length !== 6 || !o.velocity.every(Number.isFinite))
+        throw _(new Error(`Invalid free-body initial velocity: ${o.body}`), "E_MUJOCO_INITIALIZE");
+      i.qvel.set(o.velocity, t.jnt_dofadr[h]);
+    }
+  }
+  disposeModel() {
+    var t, i;
+    this.endGrab(), (t = this.data) == null || t.delete(), (i = this.model) == null || i.delete(), this.data = null, this.model = null, this.initialControls = [], this.initialVelocities = [], this.accumulator = 0;
+  }
+}
+function _(r, t) {
+  const i = r instanceof Error ? r : new Error(String(r));
+  return Object.assign(i, { code: t });
+}
+export {
+  C as MujocoRuntime
+};

package/dist/plugins.d.ts

@@ -1,6 +1,7 @@
 import type { Box3, Object3D } from 'three';
 import type { CadHit, CadSelection, CadViewerSnapshot, CadViewerEventMap } from './cad/types';
-import type { ViewerEventMap, ViewerViewMode } from './types';
+import type { ViewerEventMap, ViewerViewMode, ViewerUiTheme } from './types';
+import type { AssetControlState, AssetLoaderContribution, AssetPreviewSnapshot, AssetUpAxis } from './assets/types';
 export interface Disposable {
     dispose(): void;
 }
@@ -9,6 +10,9 @@ export interface ToolbarItem {
     readonly label: string;
     readonly title?: string;
     readonly disabled?: boolean;
+    readonly pressed?: boolean;
+    /** Inline SVG markup (24x24 viewBox, `currentColor` stroke). */
+    readonly icon?: string;
     readonly onClick: () => void;
 }
 export interface ViewerState {
@@ -17,10 +21,18 @@ export interface ViewerState {
     readonly highlightedObject: Object3D | null;
     readonly isDisposed: boolean;
 }
+/** Read-only view of the active asset. Never exposes the mutable `AssetPreview` handle. */
+export interface ViewerAssetReadApi {
+    /** Snapshot of the active asset; `null` when no asset is open. */
+    $read(): AssetPreviewSnapshot | null;
+    /** Authoritative control state, safe to bind button pressed states to. */
+    $readControl(): AssetControlState;
+}
 export interface ViewerPluginContext {
     readonly cad: {
         $read(): CadViewerSnapshot;
     };
+    readonly asset: ViewerAssetReadApi;
     readonly viewer: {
         $getState(): ViewerState;
     };
@@ -29,6 +41,14 @@ export interface ViewerPluginContext {
         setSelection(selection: CadSelection | null): void;
         fitDocument(): boolean;
         setViewMode(mode: ViewerViewMode): void;
+        play(): boolean;
+        pause(): boolean;
+        reset(): boolean;
+        fitView(): boolean;
+        setUpAxis(axis: AssetUpAxis): boolean;
+        setGroundVisible(visible: boolean): boolean;
+        setCollisionVisible(visible: boolean): boolean;
+        setTheme(theme: ViewerUiTheme): boolean;
     };
     readonly events: {
         on<K extends keyof (ViewerEventMap & CadViewerEventMap)>(type: K, listener: (event: (ViewerEventMap & CadViewerEventMap)[K]) => void): () => void;
@@ -82,7 +102,7 @@ export type ViewerContributionPoint = {
     readonly kind: 'fit-policy';
     readonly id: string;
     readonly resolve: (ctx: ViewerPluginContext) => Box3 | null;
-};
+} | AssetLoaderContribution;
 export interface ViewerPlugin {
     readonly id: string;
     activate(context: ViewerPluginContext): void | Promise<void>;
@@ -90,25 +110,49 @@ export interface ViewerPlugin {
 }
 type SnapshotReader = () => CadViewerSnapshot;
 type StateReader = () => ViewerState;
+type AssetReader = () => AssetPreviewSnapshot | null;
+type ControlStateReader = () => AssetControlState;
 type PluginEventMap = ViewerEventMap & CadViewerEventMap;
 type EventSubscriber = <K extends keyof PluginEventMap>(type: K, listener: (event: PluginEventMap[K]) => void) => () => void;
 type CommandApi = ViewerPluginContext['commands'];
+/**
+ * Layout channel the plugin manager delegates to. The engine owns zone
+ * containers, insets computation and the `ui-layout-change` broadcast; the
+ * manager only forwards contribution nodes into it.
+ */
+export interface PluginLayoutPort {
+    mountPlugin(node: Node, position?: 'left' | 'right' | 'top' | 'bottom' | 'overlay'): Disposable;
+    /** Built-in UI path: the package owns the styling of nodes mounted this way. */
+    mountBuiltin(node: Node, options: {
+        zone: 'left' | 'right' | 'top' | 'bottom' | 'overlay';
+        group?: string;
+    }): Disposable;
+}
 export declare class ViewerPluginManager implements ViewerPluginRegistry {
     private readonly readCad;
     private readonly readState;
+    private readonly readAsset;
+    private readonly readControlState;
     private readonly subscribe;
     private readonly commands;
     private readonly hostElement;
+    private readonly layout;
     private readonly pluginsById;
     private readonly contributions;
     private readonly commandContributions;
+    private readonly builtinPlugins;
+    private readonly contributionRemovedListeners;
     private refreshingInspectors;
     private disposed;
-    constructor(readCad: SnapshotReader, readState: StateReader, subscribe: EventSubscriber, commands: CommandApi, hostElement: HTMLElement);
+    constructor(readCad: SnapshotReader, readState: StateReader, readAsset: AssetReader, readControlState: ControlStateReader, subscribe: EventSubscriber, commands: CommandApi, hostElement: HTMLElement, layout?: PluginLayoutPort | null);
     register(plugin: ViewerPlugin): Disposable;
     use(plugins: readonly ViewerPlugin[], options?: {
         replace?: boolean;
     }): void;
+    registerBuiltin(plugin: ViewerPlugin): Disposable;
+    getAssetLoaders(): readonly AssetLoaderContribution[];
+    onAssetLoaderRemoved(listener: (loader: AssetLoaderContribution) => void): Disposable;
+    private onContributionRemoved;
     private deactivate;
     disposeAll(): void;
     dispose(): void;

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
+};