@tonybfox/threejs-tools 1.0.0

package/dist/view-helper/index.cjs

@@ -0,0 +1,430 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/view-helper/src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  ViewHelper: () => ViewHelper
+});
+module.exports = __toCommonJS(src_exports);
+
+// packages/view-helper/src/ViewHelper.ts
+var THREE = __toESM(require("three"));
+var AXIS_COLORS = {
+  x: "#ed4358",
+  y: "#82cc19",
+  z: "#3185eb"
+};
+var ViewHelper = class extends THREE.EventDispatcher {
+  constructor(camera, domElement, options = {}) {
+    super();
+    this.viewport = new THREE.Vector4();
+    // Animation properties
+    this.animating = false;
+    this.targetPosition = new THREE.Vector3();
+    this.targetQuaternion = new THREE.Quaternion();
+    this.q1 = new THREE.Quaternion();
+    this.q2 = new THREE.Quaternion();
+    this.dummy = new THREE.Object3D();
+    this.radius = 0;
+    this.turnRate = 2 * Math.PI;
+    // turn rate in angles per second
+    this.tempVecA = new THREE.Vector3();
+    // Interactive elements
+    this.interactiveObjects = [];
+    this.raycaster = new THREE.Raycaster();
+    this.mouse = new THREE.Vector2();
+    this.controls = options.controls;
+    this.camera = this.controls?.camera ?? camera;
+    this.domElement = domElement || document.body;
+    const defaultCenter = options.center ?? (this.controls ? this.controls.getTarget(new THREE.Vector3()) : new THREE.Vector3());
+    this.options = {
+      container: options.container || document.body,
+      size: options.size || 128,
+      position: options.position || "bottom-right",
+      offset: options.offset || { x: 20, y: 20 },
+      center: defaultCenter.clone(),
+      labels: {
+        x: options.labels?.x || "",
+        y: options.labels?.y || "",
+        z: options.labels?.z || "",
+        ...options.labels
+      }
+    };
+    this.center = this.options.center.clone();
+    this.scene = new THREE.Scene();
+    this.scene.background = null;
+    this.orthoCamera = new THREE.OrthographicCamera(-2, 2, 2, -2, 0, 4);
+    this.orthoCamera.position.set(0, 0, 2);
+    this.createAxes();
+    this.createSprites();
+    this.setupEventListeners();
+  }
+  syncActiveCamera() {
+    if (this.controls) {
+      this.camera = this.controls.camera;
+    }
+    return this.camera;
+  }
+  getCameraPosition(target) {
+    if (this.controls) {
+      return this.controls.getPosition(target);
+    }
+    return target.copy(this.camera.position);
+  }
+  createAxes() {
+    const geometry = new THREE.CylinderGeometry(0.04, 0.04, 0.8, 5).rotateZ(-Math.PI / 2).translate(0.4, 0, 0);
+    const xAxisMaterial = new THREE.MeshBasicMaterial({
+      color: AXIS_COLORS.x,
+      toneMapped: false
+    });
+    const yAxisMaterial = new THREE.MeshBasicMaterial({
+      color: AXIS_COLORS.y,
+      toneMapped: false
+    });
+    const zAxisMaterial = new THREE.MeshBasicMaterial({
+      color: AXIS_COLORS.z,
+      toneMapped: false
+    });
+    this.axes = {
+      x: new THREE.Mesh(geometry.clone(), xAxisMaterial),
+      y: new THREE.Mesh(geometry.clone(), yAxisMaterial),
+      z: new THREE.Mesh(geometry.clone(), zAxisMaterial)
+    };
+    this.axes.y.rotation.z = Math.PI / 2;
+    this.axes.z.rotation.y = -Math.PI / 2;
+    this.scene.add(this.axes.x);
+    this.scene.add(this.axes.y);
+    this.scene.add(this.axes.z);
+  }
+  createSprites() {
+    const posXSprite = this.createSprite(AXIS_COLORS.x, this.options.labels.x);
+    const posYSprite = this.createSprite(AXIS_COLORS.y, this.options.labels.y);
+    const posZSprite = this.createSprite(AXIS_COLORS.z, this.options.labels.z);
+    const negXSprite = this.createSprite(AXIS_COLORS.x);
+    const negYSprite = this.createSprite(AXIS_COLORS.y);
+    const negZSprite = this.createSprite(AXIS_COLORS.z);
+    this.sprites = {
+      posX: posXSprite,
+      posY: posYSprite,
+      posZ: posZSprite,
+      negX: negXSprite,
+      negY: negYSprite,
+      negZ: negZSprite
+    };
+    this.sprites.posX.position.set(1, 0, 0);
+    this.sprites.posY.position.set(0, 1, 0);
+    this.sprites.posZ.position.set(0, 0, 1);
+    this.sprites.negX.position.set(-1, 0, 0);
+    this.sprites.negY.position.set(0, -1, 0);
+    this.sprites.negZ.position.set(0, 0, -1);
+    this.sprites.negX.material.opacity = 0.2;
+    this.sprites.negY.material.opacity = 0.2;
+    this.sprites.negZ.material.opacity = 0.2;
+    this.sprites.posX.userData.type = "posX";
+    this.sprites.posY.userData.type = "posY";
+    this.sprites.posZ.userData.type = "posZ";
+    this.sprites.negX.userData.type = "negX";
+    this.sprites.negY.userData.type = "negY";
+    this.sprites.negZ.userData.type = "negZ";
+    Object.values(this.sprites).forEach((sprite) => {
+      this.scene.add(sprite);
+      this.interactiveObjects.push(sprite);
+    });
+  }
+  createSprite(color, text) {
+    const pixelRatio = window.devicePixelRatio || 1;
+    const size = 128 * pixelRatio;
+    const radius = 28 * pixelRatio;
+    const canvas = document.createElement("canvas");
+    canvas.width = size;
+    canvas.height = size;
+    const context = canvas.getContext("2d");
+    context.imageSmoothingEnabled = true;
+    context.imageSmoothingQuality = "high";
+    context.scale(pixelRatio, pixelRatio);
+    const center = size / (2 * pixelRatio);
+    const actualRadius = radius / pixelRatio;
+    context.beginPath();
+    context.arc(center, center, actualRadius, 0, 2 * Math.PI);
+    context.closePath();
+    context.fillStyle = color;
+    context.fill();
+    if (text) {
+      context.font = "bold 48px Arial, sans-serif";
+      context.textAlign = "center";
+      context.textBaseline = "middle";
+      context.fillStyle = "#ffffff";
+      context.strokeStyle = "#000000";
+      context.lineWidth = 2;
+      context.strokeText(text, center, center);
+      context.fillText(text, center, center);
+    }
+    const texture = new THREE.CanvasTexture(canvas);
+    texture.colorSpace = THREE.SRGBColorSpace;
+    texture.generateMipmaps = false;
+    texture.minFilter = THREE.LinearFilter;
+    texture.magFilter = THREE.LinearFilter;
+    return new THREE.Sprite(
+      new THREE.SpriteMaterial({
+        map: texture,
+        toneMapped: false,
+        alphaTest: 0.1
+      })
+    );
+  }
+  setupEventListeners() {
+    this.pointerDownHandler = (event) => {
+      this.handleClick(event);
+    };
+    this.domElement.addEventListener("pointerdown", this.pointerDownHandler);
+  }
+  render(renderer) {
+    this.renderer = renderer;
+    const activeCamera = this.syncActiveCamera();
+    this.scene.quaternion.copy(activeCamera.quaternion).invert();
+    this.scene.updateMatrixWorld();
+    const size = this.options.size;
+    const canvasWidth = renderer.domElement.width / renderer.getPixelRatio();
+    const canvasHeight = renderer.domElement.height / renderer.getPixelRatio();
+    let x, y;
+    switch (this.options.position) {
+      case "top-left":
+        x = this.options.offset.x;
+        y = canvasHeight - size - this.options.offset.y;
+        break;
+      case "top-right":
+        x = canvasWidth - size - this.options.offset.x;
+        y = canvasHeight - size - this.options.offset.y;
+        break;
+      case "bottom-left":
+        x = this.options.offset.x;
+        y = this.options.offset.y;
+        break;
+      case "bottom-right":
+      default:
+        x = canvasWidth - size - this.options.offset.x;
+        y = this.options.offset.y;
+        break;
+    }
+    renderer.getViewport(this.viewport);
+    const autoClear = renderer.autoClear;
+    renderer.setViewport(x, y, size, size);
+    renderer.autoClear = false;
+    renderer.setScissorTest(true);
+    renderer.setScissor(x, y, size, size);
+    renderer.clear(false, false, true);
+    renderer.render(this.scene, this.orthoCamera);
+    renderer.setScissorTest(false);
+    renderer.autoClear = autoClear;
+    renderer.setViewport(
+      this.viewport.x,
+      this.viewport.y,
+      this.viewport.z,
+      this.viewport.w
+    );
+  }
+  handleClick(event) {
+    if (this.animating || !this.renderer) return false;
+    this.syncActiveCamera();
+    const rect = this.domElement.getBoundingClientRect();
+    const size = this.options.size;
+    let offsetX, offsetY;
+    switch (this.options.position) {
+      case "top-left":
+        offsetX = rect.left + this.options.offset.x;
+        offsetY = rect.top + this.options.offset.y;
+        break;
+      case "top-right":
+        offsetX = rect.left + rect.width - size - this.options.offset.x;
+        offsetY = rect.top + this.options.offset.y;
+        break;
+      case "bottom-left":
+        offsetX = rect.left + this.options.offset.x;
+        offsetY = rect.top + rect.height - size - this.options.offset.y;
+        break;
+      case "bottom-right":
+      default:
+        offsetX = rect.left + rect.width - size - this.options.offset.x;
+        offsetY = rect.top + rect.height - size - this.options.offset.y;
+        break;
+    }
+    this.mouse.x = (event.clientX - offsetX) / size * 2 - 1;
+    this.mouse.y = -((event.clientY - offsetY) / size) * 2 + 1;
+    if (this.mouse.x < -1 || this.mouse.x > 1 || this.mouse.y < -1 || this.mouse.y > 1) {
+      return false;
+    }
+    this.raycaster.setFromCamera(this.mouse, this.orthoCamera);
+    const intersects = this.raycaster.intersectObjects(this.interactiveObjects);
+    if (intersects.length > 0) {
+      const intersection = intersects[0];
+      const object = intersection.object;
+      this.prepareAnimationData(object, this.center);
+      if (this.controls) {
+        this.startControlsAnimation(this.center);
+      } else {
+        this.animating = true;
+        this.dispatchEvent({ type: "animationStart" });
+      }
+      return true;
+    }
+    return false;
+  }
+  prepareAnimationData(object, focusPoint) {
+    switch (object.userData.type) {
+      case "posX":
+        this.targetPosition.set(1, 0, 0);
+        this.targetQuaternion.setFromEuler(new THREE.Euler(0, Math.PI * 0.5, 0));
+        break;
+      case "posY":
+        this.targetPosition.set(0, 1, 0);
+        this.targetQuaternion.setFromEuler(
+          new THREE.Euler(-Math.PI * 0.5, 0, 0)
+        );
+        break;
+      case "posZ":
+        this.targetPosition.set(0, 0, 1);
+        this.targetQuaternion.setFromEuler(new THREE.Euler());
+        break;
+      case "negX":
+        this.targetPosition.set(-1, 0, 0);
+        this.targetQuaternion.setFromEuler(
+          new THREE.Euler(0, -Math.PI * 0.5, 0)
+        );
+        break;
+      case "negY":
+        this.targetPosition.set(0, -1, 0);
+        this.targetQuaternion.setFromEuler(new THREE.Euler(Math.PI * 0.5, 0, 0));
+        break;
+      case "negZ":
+        this.targetPosition.set(0, 0, -1);
+        this.targetQuaternion.setFromEuler(new THREE.Euler(0, Math.PI, 0));
+        break;
+      default:
+        console.error("ViewHelper: Invalid axis.");
+        return;
+    }
+    const cameraPosition = this.getCameraPosition(this.tempVecA);
+    this.radius = cameraPosition.distanceTo(focusPoint);
+    this.targetPosition.multiplyScalar(this.radius).add(focusPoint);
+    this.dummy.position.copy(focusPoint);
+    this.dummy.lookAt(cameraPosition);
+    this.q1.copy(this.dummy.quaternion);
+    this.dummy.lookAt(this.targetPosition);
+    this.q2.copy(this.dummy.quaternion);
+  }
+  startControlsAnimation(focusPoint) {
+    const controls = this.controls;
+    if (!controls) {
+      return;
+    }
+    controls.stop?.();
+    this.animating = true;
+    this.dispatchEvent({ type: "animationStart" });
+    const applyLookAt = () => controls.setLookAt(
+      this.targetPosition.x,
+      this.targetPosition.y,
+      this.targetPosition.z,
+      focusPoint.x,
+      focusPoint.y,
+      focusPoint.z,
+      true
+    );
+    try {
+      void Promise.resolve(applyLookAt()).catch((error) => {
+        console.warn("ViewHelper: Unable to set camera look-at.", error);
+      }).finally(() => {
+        this.animating = false;
+        this.dispatchEvent({ type: "animationEnd" });
+      });
+    } catch (error) {
+      console.warn("ViewHelper: Unable to set camera look-at.", error);
+      this.animating = false;
+      this.dispatchEvent({ type: "animationEnd" });
+    }
+  }
+  update(delta) {
+    this.syncActiveCamera();
+    if (this.controls) {
+      return;
+    }
+    if (!this.animating) return;
+    const step = delta * this.turnRate;
+    this.q1.rotateTowards(this.q2, step);
+    this.camera.position.set(0, 0, 1).applyQuaternion(this.q1).multiplyScalar(this.radius).add(this.center);
+    this.camera.quaternion.rotateTowards(this.targetQuaternion, step);
+    if (this.q1.angleTo(this.q2) === 0) {
+      this.animating = false;
+      this.dispatchEvent({ type: "animationEnd" });
+    }
+  }
+  setLabels(labelX, labelY, labelZ) {
+    if (labelX !== void 0) this.options.labels.x = labelX;
+    if (labelY !== void 0) this.options.labels.y = labelY;
+    if (labelZ !== void 0) this.options.labels.z = labelZ;
+    this.updateLabels();
+  }
+  updateLabels() {
+    this.sprites.posX.material.map?.dispose();
+    this.sprites.posY.material.map?.dispose();
+    this.sprites.posZ.material.map?.dispose();
+    this.sprites.posX.material.dispose();
+    this.sprites.posY.material.dispose();
+    this.sprites.posZ.material.dispose();
+    const newPosX = this.createSprite(AXIS_COLORS.x, this.options.labels.x);
+    const newPosY = this.createSprite(AXIS_COLORS.y, this.options.labels.y);
+    const newPosZ = this.createSprite(AXIS_COLORS.z, this.options.labels.z);
+    this.sprites.posX.material = newPosX.material;
+    this.sprites.posY.material = newPosY.material;
+    this.sprites.posZ.material = newPosZ.material;
+  }
+  dispose() {
+    this.axes.x.geometry.dispose();
+    this.axes.y.geometry.dispose();
+    this.axes.z.geometry.dispose();
+    this.axes.x.material.dispose();
+    this.axes.y.material.dispose();
+    this.axes.z.material.dispose();
+    Object.values(this.sprites).forEach((sprite) => {
+      sprite.material.map?.dispose();
+      sprite.material.dispose();
+    });
+    if (this.pointerDownHandler) {
+      this.domElement.removeEventListener(
+        "pointerdown",
+        this.pointerDownHandler
+      );
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ViewHelper
+});
+//# sourceMappingURL=index.cjs.map

package/dist/view-helper/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../packages/view-helper/src/index.ts","../../packages/view-helper/src/ViewHelper.ts"],"sourcesContent":["export { ViewHelper } from './ViewHelper'\nexport type {\n  ViewHelperOptions,\n  ViewHelperEvent,\n  ViewHelperCameraController,\n} from './ViewHelper'\n","import * as THREE from 'three'\n\n// Hard-coded axis colors matching TransformControls\nconst AXIS_COLORS = {\n  x: '#ed4358',\n  y: '#82cc19',\n  z: '#3185eb',\n} as const\n\nexport interface ViewHelperCameraController {\n  camera: THREE.Camera\n  getPosition(target: THREE.Vector3): THREE.Vector3\n  getTarget(target: THREE.Vector3): THREE.Vector3\n  setLookAt(\n    positionX: number,\n    positionY: number,\n    positionZ: number,\n    targetX: number,\n    targetY: number,\n    targetZ: number,\n    enableTransition?: boolean\n  ): Promise<void> | void\n  stop?(): void\n}\n\nexport interface ViewHelperOptions {\n  container?: HTMLElement\n  size?: number\n  position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'\n  offset?: { x: number; y: number }\n  center?: THREE.Vector3\n  labels?: {\n    x?: string\n    y?: string\n    z?: string\n  }\n  controls?: ViewHelperCameraController\n}\n\n// Define event types for the view helper\ninterface ViewHelperEventMap {\n  animationStart: {}\n  animationEnd: {}\n}\n\nexport interface ViewHelperEvent {\n  type: 'animationStart' | 'animationEnd'\n}\n\nexport class ViewHelper extends THREE.EventDispatcher<ViewHelperEventMap> {\n  private camera: THREE.Camera\n  private domElement: HTMLElement\n  private options: Required<Omit<ViewHelperOptions, 'controls'>>\n  private scene: THREE.Scene\n  private orthoCamera: THREE.OrthographicCamera\n  private renderer?: THREE.WebGLRenderer\n  private viewport: THREE.Vector4 = new THREE.Vector4()\n  private controls?: ViewHelperCameraController\n  private pointerDownHandler!: (event: PointerEvent) => void\n\n  // Animation properties\n  public animating: boolean = false\n  public center: THREE.Vector3\n  private targetPosition: THREE.Vector3 = new THREE.Vector3()\n  private targetQuaternion: THREE.Quaternion = new THREE.Quaternion()\n  private q1: THREE.Quaternion = new THREE.Quaternion()\n  private q2: THREE.Quaternion = new THREE.Quaternion()\n  private dummy: THREE.Object3D = new THREE.Object3D()\n  private radius: number = 0\n  private turnRate: number = 2 * Math.PI // turn rate in angles per second\n  private tempVecA: THREE.Vector3 = new THREE.Vector3()\n\n  // Interactive elements\n  private interactiveObjects: THREE.Object3D[] = []\n  private raycaster: THREE.Raycaster = new THREE.Raycaster()\n  private mouse: THREE.Vector2 = new THREE.Vector2()\n\n  // Helper objects\n  private axes!: {\n    x: THREE.Mesh\n    y: THREE.Mesh\n    z: THREE.Mesh\n  }\n  private sprites!: {\n    posX: THREE.Sprite\n    posY: THREE.Sprite\n    posZ: THREE.Sprite\n    negX: THREE.Sprite\n    negY: THREE.Sprite\n    negZ: THREE.Sprite\n  }\n\n  constructor(\n    camera: THREE.Camera,\n    domElement?: HTMLElement,\n    options: ViewHelperOptions = {}\n  ) {\n    super()\n    this.controls = options.controls\n    this.camera = this.controls?.camera ?? camera\n    this.domElement = domElement || document.body\n\n    const defaultCenter =\n      options.center ??\n      (this.controls\n        ? this.controls.getTarget(new THREE.Vector3())\n        : new THREE.Vector3())\n\n    // Set default options\n    this.options = {\n      container: options.container || document.body,\n      size: options.size || 128,\n      position: options.position || 'bottom-right',\n      offset: options.offset || { x: 20, y: 20 },\n      center: defaultCenter.clone(),\n      labels: {\n        x: options.labels?.x || '',\n        y: options.labels?.y || '',\n        z: options.labels?.z || '',\n        ...options.labels,\n      },\n    }\n\n    this.center = this.options.center.clone()\n\n    this.scene = new THREE.Scene()\n    this.scene.background = null // Make background transparent\n    this.orthoCamera = new THREE.OrthographicCamera(-2, 2, 2, -2, 0, 4)\n    this.orthoCamera.position.set(0, 0, 2)\n\n    this.createAxes()\n    this.createSprites()\n    this.setupEventListeners()\n  }\n\n  private syncActiveCamera(): THREE.Camera {\n    if (this.controls) {\n      this.camera = this.controls.camera\n    }\n    return this.camera\n  }\n\n  private getCameraPosition(target: THREE.Vector3): THREE.Vector3 {\n    if (this.controls) {\n      return this.controls.getPosition(target)\n    }\n    return target.copy(this.camera.position)\n  }\n\n  private createAxes(): void {\n    const geometry = new THREE.CylinderGeometry(0.04, 0.04, 0.8, 5)\n      .rotateZ(-Math.PI / 2)\n      .translate(0.4, 0, 0)\n\n    const xAxisMaterial = new THREE.MeshBasicMaterial({\n      color: AXIS_COLORS.x,\n      toneMapped: false,\n    })\n    const yAxisMaterial = new THREE.MeshBasicMaterial({\n      color: AXIS_COLORS.y,\n      toneMapped: false,\n    })\n    const zAxisMaterial = new THREE.MeshBasicMaterial({\n      color: AXIS_COLORS.z,\n      toneMapped: false,\n    })\n\n    this.axes = {\n      x: new THREE.Mesh(geometry.clone(), xAxisMaterial),\n      y: new THREE.Mesh(geometry.clone(), yAxisMaterial),\n      z: new THREE.Mesh(geometry.clone(), zAxisMaterial),\n    }\n\n    this.axes.y.rotation.z = Math.PI / 2\n    this.axes.z.rotation.y = -Math.PI / 2\n\n    this.scene.add(this.axes.x)\n    this.scene.add(this.axes.y)\n    this.scene.add(this.axes.z)\n  }\n\n  private createSprites(): void {\n    const posXSprite = this.createSprite(AXIS_COLORS.x, this.options.labels.x)\n    const posYSprite = this.createSprite(AXIS_COLORS.y, this.options.labels.y)\n    const posZSprite = this.createSprite(AXIS_COLORS.z, this.options.labels.z)\n    // Use faded versions of the axis colors for negative axes\n    const negXSprite = this.createSprite(AXIS_COLORS.x)\n    const negYSprite = this.createSprite(AXIS_COLORS.y)\n    const negZSprite = this.createSprite(AXIS_COLORS.z)\n\n    this.sprites = {\n      posX: posXSprite,\n      posY: posYSprite,\n      posZ: posZSprite,\n      negX: negXSprite,\n      negY: negYSprite,\n      negZ: negZSprite,\n    }\n\n    // Position sprites\n    this.sprites.posX.position.set(1, 0, 0)\n    this.sprites.posY.position.set(0, 1, 0)\n    this.sprites.posZ.position.set(0, 0, 1)\n    this.sprites.negX.position.set(-1, 0, 0)\n    this.sprites.negY.position.set(0, -1, 0)\n    this.sprites.negZ.position.set(0, 0, -1)\n\n    // Set opacity for negative axes\n    this.sprites.negX.material.opacity = 0.2\n    this.sprites.negY.material.opacity = 0.2\n    this.sprites.negZ.material.opacity = 0.2\n\n    // Set user data for interaction\n    this.sprites.posX.userData.type = 'posX'\n    this.sprites.posY.userData.type = 'posY'\n    this.sprites.posZ.userData.type = 'posZ'\n    this.sprites.negX.userData.type = 'negX'\n    this.sprites.negY.userData.type = 'negY'\n    this.sprites.negZ.userData.type = 'negZ'\n\n    // Add to scene and interactive objects\n    Object.values(this.sprites).forEach((sprite) => {\n      this.scene.add(sprite)\n      this.interactiveObjects.push(sprite)\n    })\n  }\n\n  private createSprite(color: string, text?: string): THREE.Sprite {\n    // Use higher resolution for crisp rendering\n    const pixelRatio = window.devicePixelRatio || 1\n    const size = 128 * pixelRatio\n    const radius = 28 * pixelRatio\n\n    const canvas = document.createElement('canvas')\n    canvas.width = size\n    canvas.height = size\n\n    const context = canvas.getContext('2d')!\n\n    // Enable high-quality rendering\n    context.imageSmoothingEnabled = true\n    context.imageSmoothingQuality = 'high'\n\n    // Scale for device pixel ratio\n    context.scale(pixelRatio, pixelRatio)\n\n    const center = size / (2 * pixelRatio)\n    const actualRadius = radius / pixelRatio\n\n    // Draw circle background\n    context.beginPath()\n    context.arc(center, center, actualRadius, 0, 2 * Math.PI)\n    context.closePath()\n    context.fillStyle = color\n    context.fill()\n\n    if (text) {\n      context.font = 'bold 48px Arial, sans-serif'\n      context.textAlign = 'center'\n      context.textBaseline = 'middle'\n      context.fillStyle = '#ffffff'\n\n      // Add text stroke for better visibility\n      context.strokeStyle = '#000000'\n      context.lineWidth = 2\n      context.strokeText(text, center, center)\n      context.fillText(text, center, center)\n    }\n\n    const texture = new THREE.CanvasTexture(canvas)\n    texture.colorSpace = THREE.SRGBColorSpace\n    texture.generateMipmaps = false\n    texture.minFilter = THREE.LinearFilter\n    texture.magFilter = THREE.LinearFilter\n\n    return new THREE.Sprite(\n      new THREE.SpriteMaterial({\n        map: texture,\n        toneMapped: false,\n        alphaTest: 0.1,\n      })\n    )\n  }\n\n  private setupEventListeners(): void {\n    this.pointerDownHandler = (event: PointerEvent) => {\n      this.handleClick(event)\n    }\n    this.domElement.addEventListener('pointerdown', this.pointerDownHandler)\n  }\n\n  public render(renderer: THREE.WebGLRenderer): void {\n    this.renderer = renderer\n\n    const activeCamera = this.syncActiveCamera()\n\n    // Update helper orientation to match camera\n    this.scene.quaternion.copy(activeCamera.quaternion).invert()\n    this.scene.updateMatrixWorld()\n\n    const size = this.options.size\n    const canvasWidth = renderer.domElement.width / renderer.getPixelRatio()\n    const canvasHeight = renderer.domElement.height / renderer.getPixelRatio()\n\n    let x: number, y: number\n\n    switch (this.options.position) {\n      case 'top-left':\n        x = this.options.offset.x\n        y = canvasHeight - size - this.options.offset.y\n        break\n      case 'top-right':\n        x = canvasWidth - size - this.options.offset.x\n        y = canvasHeight - size - this.options.offset.y\n        break\n      case 'bottom-left':\n        x = this.options.offset.x\n        y = this.options.offset.y\n        break\n      case 'bottom-right':\n      default:\n        x = canvasWidth - size - this.options.offset.x\n        y = this.options.offset.y\n        break\n    }\n\n    // Store current viewport and autoClear setting\n    renderer.getViewport(this.viewport)\n    const autoClear = renderer.autoClear\n\n    // Set viewport for helper and disable autoClear\n    renderer.setViewport(x, y, size, size)\n    renderer.autoClear = false\n\n    // Clear only depth buffer in the helper area\n    renderer.setScissorTest(true)\n    renderer.setScissor(x, y, size, size)\n    renderer.clear(false, false, true) // clear depth only\n\n    // Render helper\n    renderer.render(this.scene, this.orthoCamera)\n\n    // Restore settings\n    renderer.setScissorTest(false)\n    renderer.autoClear = autoClear\n    renderer.setViewport(\n      this.viewport.x,\n      this.viewport.y,\n      this.viewport.z,\n      this.viewport.w\n    )\n  }\n\n  public handleClick(event: PointerEvent): boolean {\n    if (this.animating || !this.renderer) return false\n\n    this.syncActiveCamera()\n\n    const rect = this.domElement.getBoundingClientRect()\n    const size = this.options.size // Use logical size for click detection\n\n    // Calculate helper viewport bounds\n    let offsetX: number, offsetY: number\n\n    switch (this.options.position) {\n      case 'top-left':\n        offsetX = rect.left + this.options.offset.x\n        offsetY = rect.top + this.options.offset.y\n        break\n      case 'top-right':\n        offsetX = rect.left + rect.width - size - this.options.offset.x\n        offsetY = rect.top + this.options.offset.y\n        break\n      case 'bottom-left':\n        offsetX = rect.left + this.options.offset.x\n        offsetY = rect.top + rect.height - size - this.options.offset.y\n        break\n      case 'bottom-right':\n      default:\n        offsetX = rect.left + rect.width - size - this.options.offset.x\n        offsetY = rect.top + rect.height - size - this.options.offset.y\n        break\n    }\n\n    // Convert click coordinates to helper-relative coordinates\n    this.mouse.x = ((event.clientX - offsetX) / size) * 2 - 1\n    this.mouse.y = -((event.clientY - offsetY) / size) * 2 + 1\n\n    // Check if click is within helper bounds\n    if (\n      this.mouse.x < -1 ||\n      this.mouse.x > 1 ||\n      this.mouse.y < -1 ||\n      this.mouse.y > 1\n    ) {\n      return false\n    }\n\n    this.raycaster.setFromCamera(this.mouse, this.orthoCamera)\n    const intersects = this.raycaster.intersectObjects(this.interactiveObjects)\n\n    if (intersects.length > 0) {\n      const intersection = intersects[0]\n      const object = intersection.object\n      this.prepareAnimationData(object, this.center)\n      if (this.controls) {\n        this.startControlsAnimation(this.center)\n      } else {\n        this.animating = true\n        this.dispatchEvent({ type: 'animationStart' })\n      }\n      return true\n    }\n\n    return false\n  }\n\n  private prepareAnimationData(\n    object: THREE.Object3D,\n    focusPoint: THREE.Vector3\n  ): void {\n    switch (object.userData.type) {\n      case 'posX':\n        this.targetPosition.set(1, 0, 0)\n        this.targetQuaternion.setFromEuler(new THREE.Euler(0, Math.PI * 0.5, 0))\n        break\n      case 'posY':\n        this.targetPosition.set(0, 1, 0)\n        this.targetQuaternion.setFromEuler(\n          new THREE.Euler(-Math.PI * 0.5, 0, 0)\n        )\n        break\n      case 'posZ':\n        this.targetPosition.set(0, 0, 1)\n        this.targetQuaternion.setFromEuler(new THREE.Euler())\n        break\n      case 'negX':\n        this.targetPosition.set(-1, 0, 0)\n        this.targetQuaternion.setFromEuler(\n          new THREE.Euler(0, -Math.PI * 0.5, 0)\n        )\n        break\n      case 'negY':\n        this.targetPosition.set(0, -1, 0)\n        this.targetQuaternion.setFromEuler(new THREE.Euler(Math.PI * 0.5, 0, 0))\n        break\n      case 'negZ':\n        this.targetPosition.set(0, 0, -1)\n        this.targetQuaternion.setFromEuler(new THREE.Euler(0, Math.PI, 0))\n        break\n      default:\n        console.error('ViewHelper: Invalid axis.')\n        return\n    }\n\n    const cameraPosition = this.getCameraPosition(this.tempVecA)\n    this.radius = cameraPosition.distanceTo(focusPoint)\n    this.targetPosition.multiplyScalar(this.radius).add(focusPoint)\n\n    this.dummy.position.copy(focusPoint)\n    this.dummy.lookAt(cameraPosition)\n    this.q1.copy(this.dummy.quaternion)\n\n    this.dummy.lookAt(this.targetPosition)\n    this.q2.copy(this.dummy.quaternion)\n  }\n\n  private startControlsAnimation(focusPoint: THREE.Vector3): void {\n    const controls = this.controls\n    if (!controls) {\n      return\n    }\n\n    controls.stop?.()\n    this.animating = true\n    this.dispatchEvent({ type: 'animationStart' })\n\n    const applyLookAt = () =>\n      controls.setLookAt(\n        this.targetPosition.x,\n        this.targetPosition.y,\n        this.targetPosition.z,\n        focusPoint.x,\n        focusPoint.y,\n        focusPoint.z,\n        true\n      )\n\n    try {\n      void Promise.resolve(applyLookAt())\n        .catch((error) => {\n          console.warn('ViewHelper: Unable to set camera look-at.', error)\n        })\n        .finally(() => {\n          this.animating = false\n          this.dispatchEvent({ type: 'animationEnd' })\n        })\n    } catch (error) {\n      console.warn('ViewHelper: Unable to set camera look-at.', error)\n      this.animating = false\n      this.dispatchEvent({ type: 'animationEnd' })\n    }\n  }\n\n  public update(delta: number): void {\n    this.syncActiveCamera()\n\n    if (this.controls) {\n      return\n    }\n\n    if (!this.animating) return\n\n    const step = delta * this.turnRate\n\n    // Animate position by doing a slerp and then scaling the position on the unit sphere\n    this.q1.rotateTowards(this.q2, step)\n    this.camera.position\n      .set(0, 0, 1)\n      .applyQuaternion(this.q1)\n      .multiplyScalar(this.radius)\n      .add(this.center)\n\n    // Animate orientation\n    this.camera.quaternion.rotateTowards(this.targetQuaternion, step)\n\n    if (this.q1.angleTo(this.q2) === 0) {\n      this.animating = false\n      this.dispatchEvent({ type: 'animationEnd' })\n    }\n  }\n\n  public setLabels(labelX?: string, labelY?: string, labelZ?: string): void {\n    if (labelX !== undefined) this.options.labels.x = labelX\n    if (labelY !== undefined) this.options.labels.y = labelY\n    if (labelZ !== undefined) this.options.labels.z = labelZ\n\n    this.updateLabels()\n  }\n\n  private updateLabels(): void {\n    // Dispose old materials\n    this.sprites.posX.material.map?.dispose()\n    this.sprites.posY.material.map?.dispose()\n    this.sprites.posZ.material.map?.dispose()\n    this.sprites.posX.material.dispose()\n    this.sprites.posY.material.dispose()\n    this.sprites.posZ.material.dispose()\n\n    // Create new sprites with updated labels\n    const newPosX = this.createSprite(AXIS_COLORS.x, this.options.labels.x)\n    const newPosY = this.createSprite(AXIS_COLORS.y, this.options.labels.y)\n    const newPosZ = this.createSprite(AXIS_COLORS.z, this.options.labels.z)\n\n    // Update sprites\n    this.sprites.posX.material = newPosX.material\n    this.sprites.posY.material = newPosY.material\n    this.sprites.posZ.material = newPosZ.material\n  }\n\n  public dispose(): void {\n    // Dispose geometries\n    this.axes.x.geometry.dispose()\n    this.axes.y.geometry.dispose()\n    this.axes.z.geometry.dispose()\n\n    // Dispose materials\n    ;(this.axes.x.material as THREE.Material).dispose()\n    ;(this.axes.y.material as THREE.Material).dispose()\n    ;(this.axes.z.material as THREE.Material).dispose()\n\n    // Dispose sprite materials and textures\n    Object.values(this.sprites).forEach((sprite) => {\n      sprite.material.map?.dispose()\n      sprite.material.dispose()\n    })\n\n    // Remove event listeners\n    if (this.pointerDownHandler) {\n      this.domElement.removeEventListener(\n        'pointerdown',\n        this.pointerDownHandler\n      )\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/view-helper/index.d.mts

@@ -0,0 +1,75 @@
+import * as THREE from 'three';
+
+interface ViewHelperCameraController {
+    camera: THREE.Camera;
+    getPosition(target: THREE.Vector3): THREE.Vector3;
+    getTarget(target: THREE.Vector3): THREE.Vector3;
+    setLookAt(positionX: number, positionY: number, positionZ: number, targetX: number, targetY: number, targetZ: number, enableTransition?: boolean): Promise<void> | void;
+    stop?(): void;
+}
+interface ViewHelperOptions {
+    container?: HTMLElement;
+    size?: number;
+    position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    offset?: {
+        x: number;
+        y: number;
+    };
+    center?: THREE.Vector3;
+    labels?: {
+        x?: string;
+        y?: string;
+        z?: string;
+    };
+    controls?: ViewHelperCameraController;
+}
+interface ViewHelperEventMap {
+    animationStart: {};
+    animationEnd: {};
+}
+interface ViewHelperEvent {
+    type: 'animationStart' | 'animationEnd';
+}
+declare class ViewHelper extends THREE.EventDispatcher<ViewHelperEventMap> {
+    private camera;
+    private domElement;
+    private options;
+    private scene;
+    private orthoCamera;
+    private renderer?;
+    private viewport;
+    private controls?;
+    private pointerDownHandler;
+    animating: boolean;
+    center: THREE.Vector3;
+    private targetPosition;
+    private targetQuaternion;
+    private q1;
+    private q2;
+    private dummy;
+    private radius;
+    private turnRate;
+    private tempVecA;
+    private interactiveObjects;
+    private raycaster;
+    private mouse;
+    private axes;
+    private sprites;
+    constructor(camera: THREE.Camera, domElement?: HTMLElement, options?: ViewHelperOptions);
+    private syncActiveCamera;
+    private getCameraPosition;
+    private createAxes;
+    private createSprites;
+    private createSprite;
+    private setupEventListeners;
+    render(renderer: THREE.WebGLRenderer): void;
+    handleClick(event: PointerEvent): boolean;
+    private prepareAnimationData;
+    private startControlsAnimation;
+    update(delta: number): void;
+    setLabels(labelX?: string, labelY?: string, labelZ?: string): void;
+    private updateLabels;
+    dispose(): void;
+}
+
+export { ViewHelper, type ViewHelperCameraController, type ViewHelperEvent, type ViewHelperOptions };

package/dist/view-helper/index.d.ts

@@ -0,0 +1,75 @@
+import * as THREE from 'three';
+
+interface ViewHelperCameraController {
+    camera: THREE.Camera;
+    getPosition(target: THREE.Vector3): THREE.Vector3;
+    getTarget(target: THREE.Vector3): THREE.Vector3;
+    setLookAt(positionX: number, positionY: number, positionZ: number, targetX: number, targetY: number, targetZ: number, enableTransition?: boolean): Promise<void> | void;
+    stop?(): void;
+}
+interface ViewHelperOptions {
+    container?: HTMLElement;
+    size?: number;
+    position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    offset?: {
+        x: number;
+        y: number;
+    };
+    center?: THREE.Vector3;
+    labels?: {
+        x?: string;
+        y?: string;
+        z?: string;
+    };
+    controls?: ViewHelperCameraController;
+}
+interface ViewHelperEventMap {
+    animationStart: {};
+    animationEnd: {};
+}
+interface ViewHelperEvent {
+    type: 'animationStart' | 'animationEnd';
+}
+declare class ViewHelper extends THREE.EventDispatcher<ViewHelperEventMap> {
+    private camera;
+    private domElement;
+    private options;
+    private scene;
+    private orthoCamera;
+    private renderer?;
+    private viewport;
+    private controls?;
+    private pointerDownHandler;
+    animating: boolean;
+    center: THREE.Vector3;
+    private targetPosition;
+    private targetQuaternion;
+    private q1;
+    private q2;
+    private dummy;
+    private radius;
+    private turnRate;
+    private tempVecA;
+    private interactiveObjects;
+    private raycaster;
+    private mouse;
+    private axes;
+    private sprites;
+    constructor(camera: THREE.Camera, domElement?: HTMLElement, options?: ViewHelperOptions);
+    private syncActiveCamera;
+    private getCameraPosition;
+    private createAxes;
+    private createSprites;
+    private createSprite;
+    private setupEventListeners;
+    render(renderer: THREE.WebGLRenderer): void;
+    handleClick(event: PointerEvent): boolean;
+    private prepareAnimationData;
+    private startControlsAnimation;
+    update(delta: number): void;
+    setLabels(labelX?: string, labelY?: string, labelZ?: string): void;
+    private updateLabels;
+    dispose(): void;
+}
+
+export { ViewHelper, type ViewHelperCameraController, type ViewHelperEvent, type ViewHelperOptions };

package/dist/view-helper/index.mjs

@@ -0,0 +1,7 @@
+import {
+  ViewHelper
+} from "../chunk-R64RVBRM.mjs";
+export {
+  ViewHelper
+};
+//# sourceMappingURL=index.mjs.map

package/dist/view-helper/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}