partforge 0.123.0 → 0.124.0

package/types/index.d.ts

@@ -110,10 +110,6 @@ export interface MountElements {
     measure?: HTMLElement | null;
     annotate?: HTMLElement | null;
     railToggle?: HTMLElement | null;
-    /** Realistic-mode toggle (default id `#realistic`). */
-    realistic?: HTMLButtonElement | null;
-    /** Environment picker, an empty `<select>` the mount fills (default id `#environment`). Shown only while realistic. */
-    environment?: HTMLSelectElement | null;
   };
 }
 
@@ -194,13 +190,16 @@ export interface MountOptions {
   annotateSend?: "viewbar" | "host";
   /**
    * A previous mount's `runtime.getViewerState()`, handed back so this mount
-   * resumes the camera, projection and cutaway where that one left them. For a
+   * resumes the camera, projection, cutaway, render mode, chosen environment
+   * and per-style feature lines where that one left them (the last three
+   * outrank what is stored). For a
    * host that applies edits by REMOUNTING: the part changed, the user's view of
    * it should not.
    *
-   * Omit on a first mount — the viewer then restores its own persisted camera
-   * and projection as before. Restore is best-effort per field: a pose this
-   * part cannot support is dropped, never fatal.
+   * Omit on a first mount — the viewer then restores its own persisted camera,
+   * in perspective (the projection is automatic, so it is not persisted).
+   * Restore is best-effort per field: a pose this part cannot support is
+   * dropped, never fatal.
    */
   viewerState?: ViewerState | null;
   /**
@@ -267,6 +266,13 @@ export interface CutawayState {
 export interface ViewerState {
   /** The live camera pose, or `null` when the viewer could not report one. */
   camera: { pos: [number, number, number]; target: [number, number, number] } | null;
+  /**
+   * The live projection. It is AUTOMATIC — orthographic only on a view cube
+   * face view (Fusion 360's "Perspective with Ortho Faces"), left by the first
+   * rotation — so `"orthographic"` is restored only when `camera` is itself a
+   * face view (looking straight down a world axis); carried with any other
+   * camera, or none, the remount comes back in perspective.
+   */
   projection: "perspective" | "orthographic";
   cutaway: CutawayState | null;
   /** Always reported by `getViewerState()` — the mode being headed for, so a realistic switch still loading reads `"realistic"` (a failed one settles to `"cad"`). Optional on the way back in (a state saved by an older partforge has none). */

package/src/framework/realistic-controls.js

@@ -1,78 +0,0 @@
-// Viewbar chrome for realistic mode: a toggle button and an environment <select>.
-// Both optional (a host without the elements simply has no built-in controls and
-// drives runtime.renderMode / runtime.environment itself). Same shape as
-// viewer-controls.js. The state shown is always the viewer's: the toggle is
-// pressed only once realistic has actually landed, and the menu shows the
-// environment in effect (a failed switch snaps it back).
-import { ENVIRONMENTS } from "./materials/environments.js";
-import { saveRenderMode, saveEnvironment } from "./view-state.js";
-import { attachButtonTooltips } from "./tooltip.js";
-
-const LABEL = "Realistic view";
-const ERROR_LABEL = "Couldn't load realistic view";
-
-export function attachRealisticControls(viewer, { toggle, envMenu } = {}, { tooltip } = {}) {
-  const binding = tooltip && toggle ? attachButtonTooltips(tooltip, [{ element: toggle }]) : null;
-  if (envMenu && !envMenu.options.length) {
-    for (const env of Object.values(ENVIRONMENTS)) {
-      const o = document.createElement("option");
-      o.value = env.id;
-      o.textContent = env.label;
-      envMenu.append(o);
-    }
-    envMenu.setAttribute("aria-label", "Environment");
-  }
-
-  // The last mode event's busy/error, so an environment event or sync() —
-  // which carry neither — re-render without clearing them.
-  let busy = false;
-  let error = null;
-
-  function render() {
-    const mode = viewer.getRenderMode();
-    if (toggle) {
-      const on = mode === "realistic";
-      toggle.classList.toggle("on", on);
-      toggle.setAttribute("aria-pressed", String(on));
-      if (busy) toggle.dataset.busy = "true"; else delete toggle.dataset.busy;
-      const label = error ? ERROR_LABEL : LABEL;
-      toggle.setAttribute("aria-label", label);
-      if (!tooltip) toggle.title = label;
-    }
-    if (envMenu) {
-      envMenu.hidden = mode !== "realistic";
-      envMenu.value = viewer.getEnvironment();
-    }
-    binding?.sync();
-  }
-
-  // A click while realistic is still loading is a change of mind: back to CAD.
-  // What persists is what the viewer says took effect, not what was asked for.
-  const onToggle = () => {
-    const next = viewer.getRenderMode() === "realistic" || busy ? "cad" : "realistic";
-    viewer.setRenderMode(next).then(saveRenderMode, () => {});
-  };
-  const onEnv = () => {
-    viewer.setEnvironment(envMenu.value).then(saveEnvironment, () => {});
-  };
-  toggle?.addEventListener("click", onToggle);
-  envMenu?.addEventListener("change", onEnv);
-  const offMode = viewer.onRenderModeChange((e) => {
-    busy = !!e?.busy;
-    error = e?.error ?? null;
-    render();
-  });
-  const offEnv = viewer.onEnvironmentChange(() => render());
-  render();
-
-  return {
-    sync: render,
-    detach() {
-      toggle?.removeEventListener("click", onToggle);
-      envMenu?.removeEventListener("change", onEnv);
-      offMode();
-      offEnv();
-      binding?.detach();
-    },
-  };
-}