forgecad 0.9.2 → 0.9.3

package/dist/assets/cli/{render-Ci3jjyT1.js → render-DZHmUySW.js}

@@ -1,8 +1,8 @@
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-import { D as DoubleSide, bF as initSolverWasm, bE as initKernel, S as Scene, bG as BoxGeometry, bc as MeshStandardMaterial, a4 as BackSide, a$ as PointLight, M as Mesh, aa as MeshBasicMaterial, bH as localAabbPlaneRelation, h as Vector2, bI as ShapeUtils, g as Vector3, e as Color, aB as resolveForgeRenderStyle, b8 as getRenderStylePreset, ax as setParamOverrides, b5 as runScript, a0 as MathUtils, G as Box3, bJ as Group, b2 as shapeToGeometry, b6 as MeshPhysicalMaterial, b9 as AdditiveBlending, aG as LineBasicMaterial, b7 as LineSegments, aF as BufferGeometry, P as PerspectiveCamera, k as ShaderMaterial, bK as intersectWithPlane, W as WebGLRenderer, A as ACESFilmicToneMapping, c as SRGBColorSpace, bL as parseCameraCliSpec, bM as PMREMGenerator, aU as CanvasTexture, aV as Object3D, aW as FogExp2, aX as Fog, aY as AmbientLight, b0 as DirectionalLight, aZ as HemisphereLight, by as findJointAnimationClip, p as Plane, Y as Vector4, $ as Matrix4, bf as SDF_RAYMARCH_PROXY_VERTEX_SHADER, be as buildSdfRaymarchFragmentShader, O as OrthographicCamera, bz as resolveJointAnimation, bA as resolveJointViewValues, R as Raycaster, aT as BufferAttribute, bN as worldAuthorPlaneToLocal, a_ as SpotLight } from "../sectionPlaneMath-DXJ_TdIW.js";
-import { m as mergeViewportRenderSceneStates, p as parseRenderSceneCliSpec } from "../renderSceneState-DAnqvxSt.js";
+import { D as DoubleSide, bF as initSolverWasm, bE as initKernel, S as Scene, bG as BoxGeometry, bc as MeshStandardMaterial, a4 as BackSide, a$ as PointLight, M as Mesh, aa as MeshBasicMaterial, bH as localAabbPlaneRelation, h as Vector2, bI as ShapeUtils, g as Vector3, e as Color, aB as resolveForgeRenderStyle, b8 as getRenderStylePreset, ax as setParamOverrides, b5 as runScript, a0 as MathUtils, G as Box3, bJ as Group, b2 as shapeToGeometry, b6 as MeshPhysicalMaterial, b9 as AdditiveBlending, aG as LineBasicMaterial, b7 as LineSegments, aF as BufferGeometry, P as PerspectiveCamera, k as ShaderMaterial, bK as intersectWithPlane, W as WebGLRenderer, A as ACESFilmicToneMapping, c as SRGBColorSpace, bL as parseCameraCliSpec, bM as PMREMGenerator, aU as CanvasTexture, aV as Object3D, aW as FogExp2, aX as Fog, aY as AmbientLight, b0 as DirectionalLight, aZ as HemisphereLight, by as findJointAnimationClip, p as Plane, Y as Vector4, $ as Matrix4, bf as SDF_RAYMARCH_PROXY_VERTEX_SHADER, be as buildSdfRaymarchFragmentShader, O as OrthographicCamera, bz as resolveJointAnimation, bA as resolveJointViewValues, R as Raycaster, aT as BufferAttribute, bN as worldAuthorPlaneToLocal, a_ as SpotLight } from "../sectionPlaneMath-BxfokaJE.js";
+import { m as mergeViewportRenderSceneStates, p as parseRenderSceneCliSpec } from "../renderSceneState-BBUrnsUN.js";
 const CAD_MATERIAL_PROPS = {
   color: 6003669,
   metalness: 0.05,
@@ -1069,6 +1069,34 @@ function analyzeDistanceInspection(entries, rawOptions = {}) {
     warnings: [...connectivity.warnings]
   };
 }
+function formatAvailableViews(views) {
+  const names = Object.keys(views ?? {}).sort();
+  if (names.length === 0) {
+    return "No named render views are declared with scene({ views }).";
+  }
+  return `Available views: ${names.join(", ")}.`;
+}
+function sceneViewCameraToViewportCameraState(camera) {
+  return {
+    projectionMode: camera.type ?? "perspective",
+    position: camera.position,
+    target: camera.target,
+    up: camera.up ?? [0, 0, 1],
+    ...camera.fov !== void 0 ? { fov: camera.fov } : {}
+  };
+}
+function resolveNamedSceneViewCamera(sceneConfig, viewName) {
+  const normalizedName = viewName.trim();
+  if (!normalizedName) {
+    throw new Error("Named render view cannot be empty.");
+  }
+  const views = (sceneConfig == null ? void 0 : sceneConfig.views) ?? null;
+  const view = views == null ? void 0 : views[normalizedName];
+  if (!view) {
+    throw new Error(`Named render view "${normalizedName}" was not found. ${formatAvailableViews(views)}`);
+  }
+  return sceneViewCameraToViewportCameraState(view.camera);
+}
 function edgesStrokeAttrs(preset) {
   switch (preset) {
     case "off":
@@ -1290,6 +1318,24 @@ let rendererPixelRatio = 1;
 let rendererContextKey = "";
 let captureSession = null;
 let studioEnvTexture = null;
+function createCaptureDebugLogger(enabled) {
+  const start = performance.now();
+  let previous = start;
+  return (phase, detail = {}) => {
+    if (!enabled) return;
+    const now = performance.now();
+    const sinceStart = (now - start).toFixed(1);
+    const delta = (now - previous).toFixed(1);
+    previous = now;
+    let detailText = "";
+    try {
+      detailText = Object.keys(detail).length > 0 ? ` ${JSON.stringify(detail)}` : "";
+    } catch {
+      detailText = " [detail-unserializable]";
+    }
+    console.info(`[forge-capture:debug] +${sinceStart}ms Δ${delta}ms ${phase}${detailText}`);
+  };
+}
 const COLLISION_SOURCE_OPACITY = 0.22;
 const COLLISION_SOURCE_COLOR = [180, 200, 220];
 const COLLISION_HIGHLIGHT_COLOR = [255, 68, 16];
@@ -2429,11 +2475,19 @@ function parseColor(input, fallback) {
     return new Color(fallback);
   }
 }
-function buildSectionMeshPayload(objectId, shape) {
+function buildSectionMeshPayload(objectId, shape, debug, objectName) {
   try {
+    const start = performance.now();
     const mesh = shape.getMesh();
     const bb = shape.boundingBox();
     if (!mesh.triVerts.length || !mesh.vertProperties.length) return null;
+    debug == null ? void 0 : debug("sectionMesh:built", {
+      objectId,
+      name: objectName,
+      ms: Number((performance.now() - start).toFixed(1)),
+      triangles: Math.floor(mesh.triVerts.length / 3),
+      vertices: Math.floor(mesh.vertProperties.length / Math.max(1, mesh.numProp))
+    });
     return {
       meshId: `capture:${objectId}`,
       numProp: mesh.numProp,
@@ -2444,7 +2498,12 @@ function buildSectionMeshPayload(objectId, shape) {
         max: [bb.max[0], bb.max[1], bb.max[2]]
       }
     };
-  } catch {
+  } catch (err) {
+    debug == null ? void 0 : debug("sectionMesh:error", {
+      objectId,
+      name: objectName,
+      error: err instanceof Error ? err.message : String(err)
+    });
     return null;
   }
 }
@@ -2842,23 +2901,51 @@ function applyObjectTransforms(session, animationProgress) {
   });
   session.collisionReport = null;
 }
-function updateSectionSweepCaps(session, progress, mode) {
-  var _a;
+function updateSectionSweepCaps(session, progress, mode, debug) {
+  var _a, _b;
   const sweep = session.sweep;
   if (!sweep) return;
   const t = easedSweepProgress(progress, sweep.ease);
   const offset = sweep.from + (sweep.to - sweep.from) * t;
+  debug == null ? void 0 : debug("frame:caps:start", {
+    progress: Number(progress.toFixed(4)),
+    offset: Number(offset.toFixed(4)),
+    mode
+  });
   sweep.clippingPlane.constant = offset;
   clearSectionCapGroups(session);
-  if (mode === "wireframe") return;
+  if (mode === "wireframe") {
+    debug == null ? void 0 : debug("frame:caps:skip-wireframe");
+    return;
+  }
   session.scene.updateMatrixWorld(true);
-  for (const renderable of session.renderables) {
+  let computed = 0;
+  let emitted = 0;
+  for (let index = 0; index < session.renderables.length; index += 1) {
+    const renderable = session.renderables[index];
     if (!renderable.sectionMesh) continue;
     const localPlane = worldAuthorPlaneToLocal({ normal: sweep.normal, offset }, renderable.root.matrixWorld);
     if (!localPlane) continue;
+    const capStart = performance.now();
+    debug == null ? void 0 : debug("frame:cap:start", {
+      index: index + 1,
+      id: renderable.id,
+      name: renderable.name
+    });
     const payload = computeMeshSectionCap(renderable.sectionMesh, localPlane);
-    (_a = payload.warnings) == null ? void 0 : _a.forEach((warning) => sweep.warnings.add(warning));
+    computed += 1;
+    debug == null ? void 0 : debug("frame:cap:end", {
+      index: index + 1,
+      id: renderable.id,
+      name: renderable.name,
+      ms: Number((performance.now() - capStart).toFixed(1)),
+      positions: payload.positions.length / 3,
+      triangles: payload.indices.length / 3,
+      warnings: ((_a = payload.warnings) == null ? void 0 : _a.join(",")) ?? ""
+    });
+    (_b = payload.warnings) == null ? void 0 : _b.forEach((warning) => sweep.warnings.add(warning));
     if (payload.positions.length === 0 || payload.indices.length === 0) continue;
+    emitted += 1;
     const clippingPlanes = (renderable.solidMaterial.clippingPlanes ?? []).filter((plane) => plane !== sweep.clippingPlane);
     const geometry = createSectionCapGeometry(payload);
     const material = createSectionCapMaterial({
@@ -2889,11 +2976,21 @@ function updateSectionSweepCaps(session, progress, mode) {
       renderable.sectionCapGroup.add(outline);
     }
   }
+  debug == null ? void 0 : debug("frame:caps:end", { computed, emitted });
 }
 function renderCaptureFrame(session, opts) {
   const mode = (opts == null ? void 0 : opts.mode) ?? "solid";
   const cameraMotion = (opts == null ? void 0 : opts.cameraMotion) ?? "orbit";
   const shouldProfile = (opts == null ? void 0 : opts.profile) === true;
+  const debug = createCaptureDebugLogger(opts == null ? void 0 : opts.debug);
+  debug("frame:start", {
+    mode,
+    cameraMotion,
+    turn: opts == null ? void 0 : opts.turn,
+    animationProgress: opts == null ? void 0 : opts.animationProgress,
+    sweepProgress: opts == null ? void 0 : opts.sweepProgress,
+    imageFormat: (opts == null ? void 0 : opts.imageFormat) ?? "png"
+  });
   const start = shouldProfile ? performance.now() : 0;
   let mark = start;
   const timings = {
@@ -2921,7 +3018,7 @@ function renderCaptureFrame(session, opts) {
     applyOrbitPose(session, (opts == null ? void 0 : opts.turn) ?? 0, opts == null ? void 0 : opts.pitchDeg);
   }
   captureMark("cameraMs");
-  updateSectionSweepCaps(session, (opts == null ? void 0 : opts.sweepProgress) ?? 0, mode);
+  updateSectionSweepCaps(session, (opts == null ? void 0 : opts.sweepProgress) ?? 0, mode, debug);
   captureMark("capsMs");
   const r = getRenderer(session.size, session.pixelRatio);
   session.scene.updateMatrixWorld(true);
@@ -2930,6 +3027,7 @@ function renderCaptureFrame(session, opts) {
   captureMark("renderMs");
   const png = captureRenderedImage(session.size, (opts == null ? void 0 : opts.imageFormat) === "jpeg" ? "jpeg" : "png", (opts == null ? void 0 : opts.jpegQuality) ?? 0.96);
   captureMark("pngMs");
+  debug("frame:end");
   if (shouldProfile) {
     timings.totalMs = performance.now() - start;
     return { png, timings };
@@ -2982,9 +3080,17 @@ function isFocusVisible(obj, focus, hide) {
   return true;
 }
 function createSession(code, opts) {
-  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
   const size = (opts == null ? void 0 : opts.size) ?? 1024;
   const pixelRatio = (opts == null ? void 0 : opts.pixelRatio) ?? 1;
+  const debug = createCaptureDebugLogger(opts == null ? void 0 : opts.debug);
+  debug("session:start", {
+    capture: (opts == null ? void 0 : opts.capture) ?? "orbit",
+    size,
+    pixelRatio,
+    quality: (opts == null ? void 0 : opts.quality) ?? "high",
+    fileName: (opts == null ? void 0 : opts.fileName) ?? "main.forge.js"
+  });
   const r = getRenderer(size, pixelRatio);
   const renderStyle = resolveForgeRenderStyle(opts == null ? void 0 : opts.renderStyle);
   const renderStylePreset = getRenderStylePreset(renderStyle);
@@ -2995,8 +3101,20 @@ function createSession(code, opts) {
     return { ok: false, error: err instanceof Error ? err.message : String(err) };
   }
   setParamOverrides((opts == null ? void 0 : opts.paramOverrides) ?? {});
-  const result = runScript(code, (opts == null ? void 0 : opts.fileName) || "main.forge.js", (opts == null ? void 0 : opts.allFiles) || {}, { quality: (opts == null ? void 0 : opts.quality) ?? "high" });
+  debug("session:runScript:start");
+  const runStart = performance.now();
+  const result = runScript(code, (opts == null ? void 0 : opts.fileName) || "main.forge.js", (opts == null ? void 0 : opts.allFiles) || {}, {
+    quality: (opts == null ? void 0 : opts.quality) ?? "high",
+    debug: (opts == null ? void 0 : opts.debug) ? (phase, detail) => debug(`runScript:${phase}`, detail) : void 0
+  });
+  debug("session:runScript:end", {
+    ms: Number((performance.now() - runStart).toFixed(1)),
+    objects: ((_a = result.objects) == null ? void 0 : _a.length) ?? 0,
+    cutPlanes: ((_b = result.cutPlanes) == null ? void 0 : _b.length) ?? 0,
+    hasError: Boolean(result.error)
+  });
   if (result.error) {
+    debug("session:error", { error: String(result.error) });
     return { ok: false, error: String(result.error) };
   }
   const focus = (opts == null ? void 0 : opts.focus) ?? null;
@@ -3017,6 +3135,13 @@ function createSession(code, opts) {
     return { ok: false, error: "No renderable shape or SDF returned" };
   }
   const visibleObjs = objs.filter((entry) => entry.visible);
+  debug("session:objects", {
+    totalObjects: result.objects.length,
+    renderableObjects: objs.length,
+    visibleObjects: visibleObjs.length,
+    shapeObjects: visibleObjs.filter((entry) => entry.shape != null).length,
+    sdfObjects: visibleObjs.filter((entry) => entry.sdf != null).length
+  });
   const boundsObjs = visibleObjs.length > 0 ? visibleObjs : objs;
   const objectVisibility = new Map(objs.map((entry) => [entry.source.id, entry.visible]));
   const objectRenderability = new Set(objs.map((entry) => entry.source.id));
@@ -3065,6 +3190,21 @@ function createSession(code, opts) {
   }) : [];
   const scene = new Scene();
   const sceneConfig = result.sceneConfig ?? null;
+  try {
+    if (opts == null ? void 0 : opts.viewName) {
+      if (requestedSceneState == null ? void 0 : requestedSceneState.camera) {
+        return {
+          ok: false,
+          error: "Cannot use --view with an explicit render camera. Remove --camera or the camera field from --scene."
+        };
+      }
+      requestedSceneState = mergeViewportRenderSceneStates(requestedSceneState, {
+        camera: resolveNamedSceneViewCamera(sceneConfig, opts.viewName)
+      });
+    }
+  } catch (err) {
+    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+  }
   scene.background = parseColor((opts == null ? void 0 : opts.background) ?? renderStylePreset.background, DEFAULT_BACKGROUND);
   scene.environment = (opts == null ? void 0 : opts.capture) === "section-sweep" ? null : getStudioEnvironment(r);
   r.toneMappingExposure = renderStylePreset.toneMappingExposure;
@@ -3074,6 +3214,10 @@ function createSession(code, opts) {
     addRenderStyleLights(scene, renderStyle);
   }
   const sceneSummary = summarizeSceneGeometry(boundsObjs);
+  debug("session:summary", {
+    bbox: sceneSummary.bbox,
+    volume: Number(sceneSummary.volume.toFixed(1))
+  });
   const { bbox } = sceneSummary;
   const bb = new Box3(new Vector3(...bbox.min), new Vector3(...bbox.max));
   const center = new Vector3();
@@ -3083,19 +3227,29 @@ function createSession(code, opts) {
   const maxDim = Math.max(1, bsize.x, bsize.y, bsize.z);
   const fov = 45;
   const distance = maxDim / (2 * Math.tan(fov * Math.PI / 360)) * 1.6;
-  const cameraFov = ((_a = requestedSceneState == null ? void 0 : requestedSceneState.camera) == null ? void 0 : _a.fov) ?? ((_b = sceneConfig == null ? void 0 : sceneConfig.camera) == null ? void 0 : _b.fov) ?? fov;
-  const joints = ((_c = result.jointsView) == null ? void 0 : _c.enabled) === false ? [] : ((_d = result.jointsView) == null ? void 0 : _d.joints) ?? [];
-  const jointCouplings = ((_e = result.jointsView) == null ? void 0 : _e.enabled) === false ? [] : ((_f = result.jointsView) == null ? void 0 : _f.couplings) ?? [];
-  const animationClips = ((_g = result.jointsView) == null ? void 0 : _g.enabled) === false ? [] : ((_h = result.jointsView) == null ? void 0 : _h.animations) ?? [];
-  const defaultAnimation = ((_i = result.jointsView) == null ? void 0 : _i.defaultAnimation) ?? null;
+  const cameraFov = ((_c = requestedSceneState == null ? void 0 : requestedSceneState.camera) == null ? void 0 : _c.fov) ?? ((_d = sceneConfig == null ? void 0 : sceneConfig.camera) == null ? void 0 : _d.fov) ?? fov;
+  const joints = ((_e = result.jointsView) == null ? void 0 : _e.enabled) === false ? [] : ((_f = result.jointsView) == null ? void 0 : _f.joints) ?? [];
+  const jointCouplings = ((_g = result.jointsView) == null ? void 0 : _g.enabled) === false ? [] : ((_h = result.jointsView) == null ? void 0 : _h.couplings) ?? [];
+  const animationClips = ((_i = result.jointsView) == null ? void 0 : _i.enabled) === false ? [] : ((_j = result.jointsView) == null ? void 0 : _j.animations) ?? [];
+  const defaultAnimation = ((_k = result.jointsView) == null ? void 0 : _k.defaultAnimation) ?? null;
   let selectedAnimation;
   let sweep = null;
   try {
     selectedAnimation = resolveSelectedAnimation(animationClips, (opts == null ? void 0 : opts.capture) ?? "orbit", defaultAnimation, opts == null ? void 0 : opts.animationName);
     sweep = (opts == null ? void 0 : opts.capture) === "section-sweep" ? createSectionSweepState((opts == null ? void 0 : opts.sweep) ?? {}, bbox) : null;
   } catch (err) {
+    debug("session:sweep:error", { error: err instanceof Error ? err.message : String(err) });
     return { ok: false, error: err instanceof Error ? err.message : String(err) };
   }
+  if (sweep) {
+    debug("session:sweep", {
+      normal: sweep.normal,
+      from: Number(sweep.from.toFixed(4)),
+      to: Number(sweep.to.toFixed(4)),
+      padding: Number(sweep.padding.toFixed(4)),
+      style: sweep.style
+    });
+  }
   const enabledCutPlanes = new Set((opts == null ? void 0 : opts.enabledCutPlanes) ?? []);
   const availableCutPlanes = result.cutPlanes.filter((cp) => new Vector3(cp.normal[0], cp.normal[1], cp.normal[2]).lengthSq() > 1e-8);
   if (enabledCutPlanes.size > 0) {
@@ -3110,8 +3264,23 @@ function createSession(code, opts) {
   }
   const activeCutPlanes = availableCutPlanes.filter((cp) => enabledCutPlanes.has(cp.name));
   const renderables = [];
-  for (const obj of visibleObjs) {
+  debug("session:renderables:start", {
+    visibleObjects: visibleObjs.length,
+    activeCutPlanes: activeCutPlanes.length,
+    sectionSweep: Boolean(sweep)
+  });
+  for (let renderableIndex = 0; renderableIndex < visibleObjs.length; renderableIndex += 1) {
+    const obj = visibleObjs[renderableIndex];
     const mp = obj.materialProps;
+    const objectLabel = obj.source.name || obj.source.id;
+    debug("renderable:start", {
+      index: renderableIndex + 1,
+      total: visibleObjs.length,
+      id: obj.source.id,
+      name: objectLabel,
+      hasShape: Boolean(obj.shape),
+      hasSdf: Boolean(obj.sdf)
+    });
     const applicableCutPlanes = activeCutPlanes.filter((cutPlane) => !isObjectExcludedFromCutPlane(obj.source, cutPlane)).map(toClippingPlane);
     if (sweep && !isObjectExcludedFromCutPlane(obj.source, { normal: sweep.normal, offset: sweep.from })) {
       applicableCutPlanes.push(sweep.clippingPlane);
@@ -3127,7 +3296,16 @@ function createSession(code, opts) {
     let sdfRaymarch;
     let sectionMesh = null;
     if (obj.shape) {
+      const geometryStart = performance.now();
       const geo = shapeToGeometry(obj.shape);
+      debug("renderable:geometry", {
+        index: renderableIndex + 1,
+        id: obj.source.id,
+        name: objectLabel,
+        ms: Number((performance.now() - geometryStart).toFixed(1)),
+        triangles: Math.floor((((_l = geo.solid.getAttribute("position")) == null ? void 0 : _l.count) ?? 0) / 3),
+        edgeSegments: Math.floor((((_m = geo.edges.getAttribute("position")) == null ? void 0 : _m.count) ?? 0) / 2)
+      });
       const materialDefaults = renderStylePreset.material;
       const authoredMaterialOpacity = mp == null ? void 0 : mp.opacity;
       const authoredMaterialTransmission = mp == null ? void 0 : mp.transmission;
@@ -3185,9 +3363,16 @@ function createSession(code, opts) {
         clippingPlanes: applicableCutPlanes
       });
       wire = new LineSegments(geo.edges, wireMaterial);
-      sectionMesh = sweep ? buildSectionMeshPayload(obj.source.id, obj.shape) : null;
+      sectionMesh = sweep ? buildSectionMeshPayload(obj.source.id, obj.shape, debug, objectLabel) : null;
     } else if (obj.sdf) {
+      const sdfStart = performance.now();
       const sdfRenderable = createSdfRaymarchRuntime(obj, applicableCutPlanes);
+      debug("renderable:sdf", {
+        index: renderableIndex + 1,
+        id: obj.source.id,
+        name: objectLabel,
+        ms: Number((performance.now() - sdfStart).toFixed(1))
+      });
       solid = sdfRenderable.mesh;
       solidMaterial = sdfRenderable.material;
       sdfRaymarch = sdfRenderable.runtime;
@@ -3241,7 +3426,7 @@ function createSession(code, opts) {
   }
   const cameraSpec = sceneConfigCameraState && (opts == null ? void 0 : opts.capture) === "section-sweep" ? fitCameraStateToBounds(sceneConfigCameraState, bbox, cameraFov) : (requestedSceneState == null ? void 0 : requestedSceneState.camera) ?? sceneConfigCameraState;
   const cameraRig = buildCameraRig(center, distance, maxDim, cameraSpec, cameraFov);
-  const explicitCameraFov = (cameraSpec == null ? void 0 : cameraSpec.fov) ?? ((_j = sceneConfig == null ? void 0 : sceneConfig.camera) == null ? void 0 : _j.fov);
+  const explicitCameraFov = (cameraSpec == null ? void 0 : cameraSpec.fov) ?? ((_n = sceneConfig == null ? void 0 : sceneConfig.camera) == null ? void 0 : _n.fov);
   if (explicitCameraFov && cameraRig.camera instanceof PerspectiveCamera) {
     cameraRig.camera.fov = explicitCameraFov;
     cameraRig.camera.updateProjectionMatrix();
@@ -3282,9 +3467,11 @@ function createSession(code, opts) {
     captureDefaults: (sceneConfig == null ? void 0 : sceneConfig.capture) ?? null,
     renderStyle
   };
+  debug("session:renderables:end", { renderables: renderables.length });
   setSessionMode(session, "solid");
   applyObjectTransforms(session, 0);
   applyCameraPose(session.camera, session.fixedCameraState);
+  debug("session:ready");
   return { ok: true, session };
 }
 async function setup() {
@@ -3302,10 +3489,13 @@ async function emitInspectProgress(opts, event) {
   }
 }
 window.__forgeRender = async (code, opts) => {
-  var _a;
+  var _a, _b;
   const requestedCameraTokens = (opts == null ? void 0 : opts.cameras) ?? (opts == null ? void 0 : opts.angles);
   const hasDirectionalCameraTokens = Array.isArray(requestedCameraTokens) && requestedCameraTokens.length > 0;
-  const hasExplicitFixedCamera = Boolean((opts == null ? void 0 : opts.camera) || (opts == null ? void 0 : opts.cameraSpec) || ((_a = opts == null ? void 0 : opts.sceneState) == null ? void 0 : _a.camera) || (opts == null ? void 0 : opts.sceneSpec));
+  if ((opts == null ? void 0 : opts.viewName) && hasDirectionalCameraTokens) {
+    return { ok: false, error: "Cannot use --view with --camera or --angles. Choose either a model-declared view or an explicit camera." };
+  }
+  const hasExplicitFixedCamera = Boolean((opts == null ? void 0 : opts.camera) || (opts == null ? void 0 : opts.cameraSpec) || ((_a = opts == null ? void 0 : opts.sceneState) == null ? void 0 : _a.camera) || (opts == null ? void 0 : opts.sceneSpec) || (opts == null ? void 0 : opts.viewName));
   const cameraTokens = hasDirectionalCameraTokens ? requestedCameraTokens : hasExplicitFixedCamera ? ["__fixed"] : ["iso"];
   const requestedChannelList = (opts == null ? void 0 : opts.channels) ?? ["rgb"];
   const requestedChannels = new Set(requestedChannelList);
@@ -3319,6 +3509,7 @@ window.__forgeRender = async (code, opts) => {
     background: opts == null ? void 0 : opts.background,
     camera: opts == null ? void 0 : opts.camera,
     cameraSpec: opts == null ? void 0 : opts.cameraSpec,
+    viewName: opts == null ? void 0 : opts.viewName,
     sceneState: opts == null ? void 0 : opts.sceneState,
     sceneSpec: opts == null ? void 0 : opts.sceneSpec,
     focus: opts == null ? void 0 : opts.focus,
@@ -3380,7 +3571,7 @@ window.__forgeRender = async (code, opts) => {
     try {
       let label;
       if (token === "__fixed") {
-        label = "camera";
+        label = ((_b = opts == null ? void 0 : opts.viewName) == null ? void 0 : _b.trim()) || "camera";
         applyCameraPose(session.camera, session.fixedCameraState);
       } else {
         const parsed = parseCameraToken(token);

package/dist/assets/copy-CQKQppF-.js

@@ -0,0 +1,8 @@
+const COMMERCIAL_USE_CASES = "client, employer, sale, funded product, or closed commercial IP";
+const PRODUCTION_EXPORT_COPY = `Free to export. For ${COMMERCIAL_USE_CASES} work, Pro covers commercial use and support.`;
+const PRO_STORAGE_UPGRADE_COPY = "Upgrade for 500 MB and commercial coverage.";
+export {
+  COMMERCIAL_USE_CASES as C,
+  PRO_STORAGE_UPGRADE_COPY as P,
+  PRODUCTION_EXPORT_COPY as a
+};