brep-io-kernel 1.0.0

package/src/features/spline/SplineEditorSession.js

@@ -0,0 +1,988 @@
+import * as THREE from "three";
+import { CombinedTransformControls  } from "../../UI/controls/CombinedTransformControls.js";
+import { BREP } from "../../BREP/BREP.js";
+import {
+  DEFAULT_RESOLUTION,
+  normalizeSplineData,
+  buildHermitePolyline,
+  cloneSplineData,
+} from "./splineUtils.js";
+
+const noop = () => { };
+
+export class SplineEditorSession {
+  constructor(viewer, featureID, options = {}) {
+    this.viewer = viewer || null;
+    this.featureID =
+      featureID != null ? String(featureID) : options?.featureID || null;
+    this.options = options || {};
+
+    this._featureRef = options.featureRef || null;
+    this._previewResolution = DEFAULT_RESOLUTION;
+    this._splineData = normalizeSplineData(
+      cloneSplineData(this._featureRef?.persistentData?.spline || null)
+    );
+
+    this._objectsById = new Map();
+    this._extensionLines = new Map();
+    this._selectedId = null;
+    this._hiddenArtifacts = [];
+
+    this._transformsById = new Map();
+    this._transformListeners = new Map();
+    this._isTransformDragging = false;
+
+    this._extensionLineMaterial = null;
+
+    this._previewGroup = null;
+    this._line = null;
+
+    this._onSplineChange =
+      typeof options.onSplineChange === "function"
+        ? options.onSplineChange
+        : noop;
+    this._onSelectionChange =
+      typeof options.onSelectionChange === "function"
+        ? options.onSelectionChange
+        : noop;
+
+    this._active = false;
+  }
+
+  _updateTransformVisibility() {
+    if (!this._transformsById) {
+      return;
+    }
+
+    // Check if preview group exists, if not rebuild it
+    this._ensurePreviewGroup();
+
+    for (const [id, transformEntry] of this._transformsById.entries()) {
+      if (!transformEntry) {
+        continue;
+      }
+      const { control } = transformEntry;
+      const active = id === this._selectedId;
+
+      if (control) {
+        control.enabled = active;
+        control.visible = active;
+
+        // Ensure proper scene management - remove from scene when inactive
+        if (this.viewer?.scene) {
+          if (active) {
+            // Add to scene if not already present
+            if (!this.viewer.scene.children.includes(control)) {
+              this.viewer.scene.add(control);
+            }
+          } else {
+            // Remove from scene when inactive
+            if (this.viewer.scene.children.includes(control)) {
+              this.viewer.scene.remove(control);
+            }
+          }
+        }
+      }
+    }
+    if (!this._selectedId) {
+      this._isTransformDragging = false;
+    }
+  }
+
+  isActive() {
+    return this._active;
+  }
+
+  hasTransformControls() {
+    return this._transformsById && this._transformsById.size > 0;
+  }
+
+  getTransformControlCount() {
+    return this._transformsById ? this._transformsById.size : 0;
+  }
+
+  getSplineData() {
+    return cloneSplineData(this._splineData);
+  }
+
+  getSelectedId() {
+    return this._selectedId;
+  }
+
+  setFeatureRef(featureRef) {
+    this._featureRef = featureRef || null;
+  }
+
+  /**
+   * Activate the editing session. Builds preview geometry and attaches transform controls.
+   * @param {Object|null} initialSpline
+   * @param {Object} [options]
+   * @param {Object} [options.featureRef]
+   * @param {number} [options.previewResolution]
+   * @param {string} [options.initialSelection]
+   * @returns {boolean}
+   */
+  activate(initialSpline = null, options = {}) {
+    if (!this.viewer) {
+      return false;
+    }
+
+    if (this._active) {
+      this.dispose();
+    }
+
+    const featureRef = options.featureRef ?? this._featureRef ?? null;
+    this._featureRef = featureRef;
+
+    const resCandidate =
+      options.previewResolution ??
+      Number(featureRef?.inputParams?.curveResolution);
+    if (Number.isFinite(resCandidate) && resCandidate >= 4) {
+      this._previewResolution = Math.max(4, Math.floor(resCandidate));
+    } else {
+      this._previewResolution = DEFAULT_RESOLUTION;
+    }
+
+    const source = initialSpline
+      ? cloneSplineData(initialSpline)
+      : cloneSplineData(featureRef?.persistentData?.spline || null);
+    this._splineData = normalizeSplineData(source);
+
+    this._hideExistingArtifacts();
+    this._initMaterials();
+    this._buildPreviewGroup();
+    // Set up initial selection before rebuild
+    const initialSelection = options.initialSelection || null;
+    if (initialSelection) {
+      this._selectedId = initialSelection;
+    }
+
+    this._rebuildAll({ preserveSelection: !!initialSelection });
+
+    this._active = true;
+
+    // Register with viewer to enable spline mode (suppress normal scene picking)
+    if (this.viewer && typeof this.viewer.startSplineMode === 'function') {
+      this.viewer.startSplineMode(this);
+    }
+
+    // Hook into viewer's controls change event to update transform controls
+    this._setupControlsListener();
+
+    this._notifySelectionChange(this._selectedId);
+    this._renderOnce();
+    return true;
+  }
+
+  /**
+   * Tear down preview/controls and restore original artifacts.
+   */
+  dispose() {
+    // Unregister from viewer to disable spline mode
+    if (this.viewer && typeof this.viewer.endSplineMode === 'function') {
+      this.viewer.endSplineMode();
+    }
+
+    // Remove controls change listener
+    this._teardownControlsListener();
+
+    this._teardownAllTransforms();
+    this._destroyPreviewGroup();
+    this._restoreArtifacts();
+    this._disposeMaterials();
+    if (this._selectedId !== null) {
+      this._selectedId = null;
+      this._notifySelectionChange(null);
+    }
+    this._active = false;
+  }
+
+  /**
+   * Update session spline data and rebuild preview.
+   * @param {Object} spline
+   * @param {Object} [options]
+   * @param {boolean} [options.preserveSelection=true]
+    * @param {boolean} [options.silent=false]
+   * @param {string} [options.reason="manual"]
+   */
+  setSplineData(spline, options = {}) {
+
+    const {
+      preserveSelection = true,
+      silent = false,
+      reason = "manual",
+    } = options;
+
+    const normalized = normalizeSplineData(cloneSplineData(spline));
+    this._splineData = normalized;
+
+    // Update the feature's persistent data immediately
+    this._updateFeaturePersistentData();
+
+    // CRITICAL FIX: Don't rebuild everything if this is just a transform update
+    if (reason === "transform" && preserveSelection) {
+      // Just update the preview line, don't rebuild point handles (which destroys transforms)
+      this._rebuildPreviewLine();
+      this._updateExtensionLinesForAllPoints();
+    } else {
+      this._rebuildAll({ preserveSelection });
+    }
+
+    if (!silent) {
+      this._notifySplineChange(reason);
+    } else {
+      this._renderOnce();
+    }
+  }
+
+  selectObject(id, options = {}) {
+    const { silent = false, forceRedraw = false } = options || {};
+    const nextId = id == null ? null : String(id);
+
+    if (this._selectedId === nextId && !forceRedraw) {
+      if (!silent) {
+        this._notifySelectionChange(this._selectedId);
+      }
+      return;
+    }
+
+    // Ensure preview group exists before changing selection
+    this._ensurePreviewGroup();
+
+    this._selectedId = nextId;
+
+    // If forcing redraw, rebuild everything to ensure fresh state
+    if (forceRedraw) {
+      this._rebuildAll({ preserveSelection: true });
+    }
+
+    this._updateSelectionVisuals();
+
+    this._updateTransformVisibility();
+
+    if (!silent) {
+      this._notifySelectionChange(this._selectedId);
+    }
+
+    this._renderOnce();
+  }
+
+  clearSelection() {
+    this.selectObject(null);
+  }
+
+  hideGizmo() {
+    this.clearSelection();
+  }
+
+  /**
+   * Force cleanup of any stale objects in the scene
+   */
+  forceCleanup() {
+
+    if (!this.viewer?.scene) return;
+
+    // Find and remove any stale transform controls
+    const toRemove = [];
+    this.viewer.scene.traverse((obj) => {
+      // Look for transform controls that might be stale
+      if (obj.type === 'CombinedTransformControls' || obj.isTransformGizmo) {
+        // Check if this control is in our current transforms map
+        let isValid = false;
+        if (this._transformsById) {
+          for (const entry of this._transformsById.values()) {
+            if (entry.control === obj) {
+              isValid = true;
+              break;
+            }
+          }
+        }
+        if (!isValid) {
+          toRemove.push(obj);
+        }
+      }
+    });
+
+    // Remove stale objects
+    for (const obj of toRemove) {
+      try {
+        this.viewer.scene.remove(obj);
+        obj.dispose?.();
+      } catch (error) {
+        /* ignore */
+      }
+    }
+
+    this._renderOnce();
+  }
+
+  _renderOnce() {
+    try {
+      this.viewer?.render?.();
+    } catch {
+      /* noop */
+    }
+  }
+
+  _setupControlsListener() {
+    // Listen to camera/controls changes to update transform controls screen size
+    this._controlsChangeHandler = () => {
+      if (this._transformsById) {
+        for (const [id, transformEntry] of this._transformsById.entries()) {
+          const control = transformEntry?.control;
+          if (control && typeof control.update === 'function') {
+            try {
+              control.update();
+            } catch (error) {
+              console.warn(`SplineEditorSession: Failed to update transform control ${id}:`, error);
+            }
+          }
+        }
+      }
+    };
+
+    // Hook into the viewer's controls change event
+    if (this.viewer?.controls && typeof this.viewer.controls.addEventListener === 'function') {
+      this.viewer.controls.addEventListener('change', this._controlsChangeHandler);
+      this.viewer.controls.addEventListener('end', this._controlsChangeHandler);
+    }
+  }
+
+  _teardownControlsListener() {
+    if (this._controlsChangeHandler && this.viewer?.controls) {
+      try {
+        this.viewer.controls.removeEventListener('change', this._controlsChangeHandler);
+        this.viewer.controls.removeEventListener('end', this._controlsChangeHandler);
+      } catch (error) {
+        console.warn('SplineEditorSession: Failed to remove controls listeners:', error);
+      }
+    }
+    this._controlsChangeHandler = null;
+  }
+
+  _notifySplineChange(reason, extra = null) {
+    try {
+      this._onSplineChange(this.getSplineData(), reason, extra);
+    } catch {
+      /* ignore listener errors */
+    }
+  }
+
+  _updateFeaturePersistentData() {
+    // Update the feature's persistent data immediately
+    if (this._featureRef) {
+      this._featureRef.persistentData = this._featureRef.persistentData || {};
+      this._featureRef.persistentData.spline = cloneSplineData(this._splineData);
+      
+      // Mark the feature as dirty for rebuild
+      this._featureRef.lastRunInputParams = {};
+      this._featureRef.timestamp = 0;
+      this._featureRef.dirty = true;
+    }
+  }
+
+  _notifySelectionChange(id) {
+    try {
+      this._onSelectionChange(id);
+    } catch {
+      /* ignore listener errors */
+    }
+  }
+
+  _hideExistingArtifacts() {
+    const scene = this.viewer?.scene;
+    if (!scene) return;
+    this._hiddenArtifacts = [];
+    scene.traverse((obj) => {
+      if (obj && obj.owningFeatureID === this.featureID && obj.visible) {
+        this._hiddenArtifacts.push({ obj, visible: obj.visible });
+        obj.visible = false;
+      }
+    });
+  }
+
+  _restoreArtifacts() {
+    for (const entry of this._hiddenArtifacts) {
+      try {
+        entry.obj.visible = entry.visible;
+      } catch {
+        /* ignore */
+      }
+    }
+    this._hiddenArtifacts = [];
+  }
+
+  _initMaterials() {
+    // Extension line material - thicker than the main spline
+    this._extensionLineMaterial = new THREE.LineBasicMaterial({
+      color: "blue",
+      linewidth: 3, // Thicker than the main spline
+      transparent: true,
+      opacity: 0.85,
+      depthTest: false,
+    });
+  }
+
+  _disposeMaterials() {
+    try {
+      this._extensionLineMaterial?.dispose?.();
+    } catch {
+      /* noop */
+    }
+    this._extensionLineMaterial = null;
+  }
+
+  _buildPreviewGroup() {
+    const scene = this.viewer?.scene;
+    if (!scene) return;
+
+
+
+    // remove the actual spline from the scene. The spline generated by the feature it self, not the preview
+    // The object to be removed from the scene will have the same name as the feature ID
+    const existingSpline = scene.getObjectByName(this.featureID);
+    if (existingSpline) {
+      scene.remove(existingSpline);
+    }
+
+    // Search the scene for an existing preview group and reuse it rather than creating a new one
+    const existingGroupName = `SplineEditorPreview:${this.featureID || ""}`;
+    const existingGroup = scene.getObjectByName(existingGroupName);
+    if (existingGroup) {
+      this._previewGroup = existingGroup;
+      // remove all children from existing group
+      while (this._previewGroup.children.length > 0) {
+        this._previewGroup.remove(this._previewGroup.children[0]);
+      }
+    } else {
+      this._previewGroup = new THREE.Group();
+    }
+
+
+    this._previewGroup.name = `SplineEditorPreview:${this.featureID || ""}`;
+    this._previewGroup.userData = this._previewGroup.userData || {};
+    this._previewGroup.userData.excludeFromFit = true;
+    this._previewGroup.userData.preventRemove = true;
+
+    const lineMaterial = new THREE.LineBasicMaterial({
+      color: 0xffffff,
+      linewidth: 2,
+    });
+
+    const geometry = new THREE.BufferGeometry();
+    geometry.setAttribute("position", new THREE.Float32BufferAttribute([], 3));
+
+    this._line = new THREE.Line(geometry, lineMaterial);
+    this._line.userData = this._line.userData || {};
+    this._line.userData.excludeFromFit = true;
+    this._line.renderOrder = 10000;
+    this._previewGroup.add(this._line);
+
+    scene.add(this._previewGroup);
+  }
+
+  _ensurePreviewGroup() {
+    const scene = this.viewer.scene;
+
+    // Check if the preview group still exists in the scene
+    if (!this._previewGroup || !this.viewer?.scene) {
+      this._buildPreviewGroup();
+      return;
+    }
+
+    // Check if the preview group was removed from the scene
+
+    const existingGroupName = `SplineEditorPreview:${this.featureID || ""}`;
+    const foundInScene = scene.getObjectByName(existingGroupName);
+
+    if (!foundInScene) {
+      // Preview group was removed, sync with latest persistent data and rebuild
+      const latestSplineData = this._featureRef?.persistentData?.spline;
+      if (latestSplineData) {
+        this._splineData = normalizeSplineData(cloneSplineData(latestSplineData));
+      }
+
+      // Update preview resolution from current feature parameters
+      const resCandidate = Number(this._featureRef?.inputParams?.curveResolution);
+      if (Number.isFinite(resCandidate) && resCandidate >= 4) {
+        this._previewResolution = Math.max(4, Math.floor(resCandidate));
+      }
+
+      this._buildPreviewGroup();
+      this._rebuildAll({ preserveSelection: true });
+    }
+  }
+
+  _destroyPreviewGroup() {
+    if (!this._previewGroup || !this.viewer?.scene) {
+      this._teardownAllTransforms();
+      return;
+    }
+    this._teardownAllTransforms();
+    this._removeExtensionLines();
+    try {
+      if (this._line) {
+        this._line.geometry?.dispose();
+        this._line.material?.dispose();
+      }
+    } catch {
+      /* noop */
+    }
+    try {
+      // Clear the preventRemove flag before removing from scene
+      if (this._previewGroup.userData) {
+        this._previewGroup.userData.preventRemove = false;
+      }
+      this.viewer.scene.remove(this._previewGroup);
+    } catch {
+      /* noop */
+    }
+    this._previewGroup = null;
+    this._line = null;
+    this._objectsById.clear();
+    this._extensionLines.clear();
+  }
+
+  _createTransformControl(id, mesh) {
+    if (!this.viewer?.scene || !this.viewer?.camera || !this.viewer?.renderer) {
+
+      return null;
+    }
+    if (!CombinedTransformControls) {
+
+      return null;
+    }
+    const control = new CombinedTransformControls(
+      this.viewer.camera,
+      this.viewer.renderer.domElement
+    );
+
+    control.name = `SplineEditorControl:${id}`;
+
+    control.setMode("translate");
+    control.showX = true;
+    control.showY = true;
+    control.showZ = true;
+    control.enabled = false; // Will be enabled when selected
+    control.attach(mesh);
+    control.userData = control.userData || {};
+    control.userData.excludeFromFit = true;
+
+    // Add the transform control directly to the scene
+    this.viewer.scene.add(control);
+
+    const changeHandler = () => this._handleTransformChangeFor(id);
+    const dragHandler = (event) => {
+      this._handleTransformDragging(!!event?.value);
+    };
+    control.addEventListener("change", changeHandler);
+    control.addEventListener("dragging-changed", dragHandler);
+
+    this._transformsById.set(id, { control });
+    this._transformListeners.set(id, { changeHandler, dragHandler });
+    return control;
+  }
+
+  _teardownAllTransforms() {
+    if (!this._transformsById?.size) {
+      this._isTransformDragging = false;
+      return;
+    }
+
+    for (const [id, transformEntry] of this._transformsById.entries()) {
+
+      const control = transformEntry?.control || null;
+      const listeners = this._transformListeners.get(id);
+
+      if (control && listeners) {
+        try {
+          control.removeEventListener("change", listeners.changeHandler);
+        } catch (error) {
+          /* ignore */
+        }
+        try {
+          control.removeEventListener("dragging-changed", listeners.dragHandler);
+        } catch (error) {
+          /* ignore */
+        }
+      }
+
+      try {
+        control?.detach?.();
+      } catch (error) {
+        /* ignore */
+      }
+
+      // Remove control from scene
+      if (control) {
+        try {
+          this.viewer?.scene?.remove(control);
+        } catch (error) {
+          /* ignore */
+        }
+      }
+
+      try {
+        control?.dispose?.();
+      } catch (error) {
+        /* ignore */
+      }
+    }
+    this._transformsById.clear();
+    this._transformListeners.clear();
+    this._isTransformDragging = false;
+  }
+
+  _rebuildAll({ preserveSelection }) {
+
+    // Force cleanup of any stale objects before rebuild
+    this.forceCleanup();
+
+    const previousSelection = preserveSelection ? this._selectedId : null;
+
+    this._buildPointHandles();
+
+    this._rebuildPreviewLine();
+
+    if (preserveSelection && previousSelection) {
+      this.selectObject(previousSelection, { silent: true });
+    } else if (!preserveSelection) {
+      this.selectObject(null, { silent: true });
+    }
+
+  }
+
+  _buildPointHandles() {
+
+    if (!this._previewGroup) return;
+
+    this._teardownAllTransforms();
+
+    // Clear EVERYTHING from the preview group - no preservation
+    while (this._previewGroup.children.length > 0) {
+      const child = this._previewGroup.children[0];
+      this._previewGroup.remove(child);
+      try {
+        child.geometry?.dispose();
+        child.material?.dispose();
+      } catch {
+        /* noop */
+      }
+    }
+
+    // Clear all tracking maps completely
+    this._objectsById.clear();
+    this._extensionLines.clear();
+
+    this._initMaterials();
+
+    // Create fresh spline line
+    const lineMaterial = new THREE.LineBasicMaterial({
+      color: 0xffffff,
+      linewidth: 2,
+    });
+    const geometry = new THREE.BufferGeometry();
+    geometry.setAttribute("position", new THREE.Float32BufferAttribute([], 3));
+    this._line = new THREE.Line(geometry, lineMaterial);
+    this._line.name = "SplinePreviewLine";
+    this._previewGroup.add(this._line);
+
+    // Create handles for each point - no separate extension handles
+    this._splineData.points.forEach((pt, index) => {
+      // Create a simple point geometry for invisible click target
+      const pointGeometry = new THREE.BufferGeometry();
+      const position = new Float32Array([
+        Number(pt.position[0]) || 0,
+        Number(pt.position[1]) || 0,
+        Number(pt.position[2]) || 0
+      ]);
+      pointGeometry.setAttribute('position', new THREE.BufferAttribute(position, 3));
+
+      // Create an invisible mesh for raycasting and transform attachment
+      const pointMaterial = new THREE.MeshBasicMaterial({ visible: false });
+      const mesh = new THREE.Mesh(new THREE.SphereGeometry(0.15, 8, 8), pointMaterial);
+      mesh.position.set(position[0], position[1], position[2]);
+
+      // Apply stored rotation to the mesh
+      if (pt.rotation && Array.isArray(pt.rotation) && pt.rotation.length === 9) {
+        const rotMatrix = new THREE.Matrix3().fromArray(pt.rotation);
+        const matrix4 = new THREE.Matrix4().setFromMatrix3(rotMatrix);
+        mesh.setRotationFromMatrix(matrix4);
+      }
+
+      mesh.name = `SplinePoint:${pt.id}`;
+      this._previewGroup.add(mesh);
+
+      // Create a clickable vertex at the same position using BREP.Vertex
+      const vertex = new BREP.Vertex([position[0], position[1], position[2]], {
+        name: `SplineVertex:${pt.id}`,
+      });
+
+      // Add click handler to the vertex to trigger selection
+      vertex.onClick = () => {
+        this.selectObject(`point:${pt.id}`);
+      };
+
+      // Store reference to the point for identification - set on both vertex and internal point
+      vertex.userData = vertex.userData || {};
+      vertex.userData.splineFeatureId = this.featureID;
+      vertex.userData.splinePointId = pt.id;
+      vertex.userData.isSplineVertex = true;
+
+      // Also set userData on the internal Points object that gets hit by raycaster
+      if (vertex._point) {
+        vertex._point.userData = vertex._point.userData || {};
+        vertex._point.userData.splineFeatureId = this.featureID;
+        vertex._point.userData.splinePointId = pt.id;
+        vertex._point.userData.isSplineVertex = true;
+        // Copy the onClick handler to the internal point
+        vertex._point.onClick = vertex.onClick;
+      }
+
+      // Add vertex to preview group
+      this._previewGroup.add(vertex);
+
+      const entryId = `point:${pt.id}`;
+      const transform = this._createTransformControl(entryId, mesh);
+      this._objectsById.set(entryId, {
+        type: "point",
+        mesh,
+        vertex, // Store reference to the clickable vertex
+        data: pt,
+        transform,
+      });
+
+      // Create extension lines for this point
+      const forwardKey = `forward-line:${pt.id}`;
+      const backwardKey = `backward-line:${pt.id}`;
+
+      // Forward extension line
+      const forwardGeometry = new THREE.BufferGeometry();
+      const forwardLine = new THREE.Line(forwardGeometry, this._extensionLineMaterial);
+      forwardLine.name = `SplineForwardLine:${pt.id}`;
+      forwardLine.visible = true;
+      forwardLine.frustumCulled = false;
+      this._previewGroup.add(forwardLine);
+      this._extensionLines.set(forwardKey, forwardLine);
+
+      // Backward extension line  
+      const backwardGeometry = new THREE.BufferGeometry();
+      const backwardLine = new THREE.Line(backwardGeometry, this._extensionLineMaterial);
+      backwardLine.name = `SplineBackwardLine:${pt.id}`;
+      backwardLine.visible = true;
+      backwardLine.frustumCulled = false;
+      this._previewGroup.add(backwardLine);
+      this._extensionLines.set(backwardKey, backwardLine);
+
+      // Set the geometry for the extension lines
+      const rotation = pt.rotation || [1, 0, 0, 0, 1, 0, 0, 0, 1];
+      let xAxisDirection = [rotation[0], rotation[1], rotation[2]];
+      
+      const length = Math.sqrt(xAxisDirection[0] * xAxisDirection[0] + xAxisDirection[1] * xAxisDirection[1] + xAxisDirection[2] * xAxisDirection[2]);
+      if (length > 0) {
+        xAxisDirection = [xAxisDirection[0] / length, xAxisDirection[1] / length, xAxisDirection[2] / length];
+      }
+
+      const forwardDir = pt.flipDirection ? [-xAxisDirection[0], -xAxisDirection[1], -xAxisDirection[2]] : xAxisDirection;
+      const backwardDir = pt.flipDirection ? xAxisDirection : [-xAxisDirection[0], -xAxisDirection[1], -xAxisDirection[2]];
+
+      // Forward line geometry
+      if (pt.forwardDistance > 0) {
+        const forwardEnd = [
+          pt.position[0] + forwardDir[0] * pt.forwardDistance,
+          pt.position[1] + forwardDir[1] * pt.forwardDistance,
+          pt.position[2] + forwardDir[2] * pt.forwardDistance
+        ];
+        forwardGeometry.setAttribute("position", new THREE.Float32BufferAttribute([
+          pt.position[0], pt.position[1], pt.position[2],
+          forwardEnd[0], forwardEnd[1], forwardEnd[2]
+        ], 3));
+      }
+
+      // Backward line geometry
+      if (pt.backwardDistance > 0) {
+        const backwardEnd = [
+          pt.position[0] + backwardDir[0] * pt.backwardDistance,
+          pt.position[1] + backwardDir[1] * pt.backwardDistance,
+          pt.position[2] + backwardDir[2] * pt.backwardDistance
+        ];
+        backwardGeometry.setAttribute("position", new THREE.Float32BufferAttribute([
+          pt.position[0], pt.position[1], pt.position[2],
+          backwardEnd[0], backwardEnd[1], backwardEnd[2]
+        ], 3));
+      }
+    });
+
+    this._updateTransformVisibility();
+    
+    // Rebuild the spline curve as well
+    this._rebuildPreviewLine();
+  }
+
+  _rebuildPreviewLine() {
+    if (!this._line) return;
+
+    // Clean up old geometry to prevent memory leaks
+    const oldGeometry = this._line.geometry;
+    if (oldGeometry) {
+      // Clear old attributes
+      const positionAttr = oldGeometry.getAttribute("position");
+      if (positionAttr) {
+        positionAttr.needsUpdate = true;
+      }
+    }
+
+    const bendRadius = Number.isFinite(Number(this._featureRef?.inputParams?.bendRadius))
+      ? Math.max(0.1, Math.min(5.0, Number(this._featureRef.inputParams.bendRadius)))
+      : 1.0;
+
+    const { positions } = buildHermitePolyline(
+      this._splineData,
+      this._previewResolution || DEFAULT_RESOLUTION,
+      bendRadius
+    );
+
+    const array = new Float32Array(positions);
+    this._line.geometry.setAttribute(
+      "position",
+      new THREE.BufferAttribute(array, 3)
+    );
+    if (positions.length >= 3) {
+      this._line.geometry.computeBoundingSphere();
+    }
+
+  }
+
+  _updateSelectionVisuals() {
+    // Update vertex selection states to show which vertex is selected
+    for (const [id, entry] of this._objectsById.entries()) {
+      if (entry.vertex) {
+        const isSelected = id === this._selectedId;
+        entry.vertex.selected = isSelected;
+      }
+    }
+  }
+
+  _handleTransformChangeFor(id = null) {
+
+    const targetId =
+      id && this._objectsById.has(id) ? id : this._selectedId;
+    if (!targetId) return;
+    const entry = this._objectsById.get(targetId);
+    if (!entry || !entry.mesh || !entry.data) return;
+
+    const pos = entry.mesh.position;
+    if (entry.type === "point") {
+      // Update point position
+      entry.data.position = [pos.x, pos.y, pos.z];
+
+      // Update point rotation - extract rotation matrix from mesh
+      const rotMatrix = new THREE.Matrix3().setFromMatrix4(entry.mesh.matrix);
+      entry.data.rotation = rotMatrix.elements.slice(); // Store as flat array
+
+      // Update the vertex position to match the mesh
+      if (entry.vertex) {
+        entry.vertex.position.set(pos.x, pos.y, pos.z);
+      }
+    }
+
+    // Update persistent data immediately after transform changes
+    this._updateFeaturePersistentData();
+
+    this._rebuildPreviewLine();
+    this._updateExtensionLinesForAllPoints();
+    this._notifySplineChange("transform", { selection: targetId });
+    this._renderOnce();
+  }
+
+  _handleTransformDragging(isDragging) {
+    const dragging = !!isDragging;
+
+    this._isTransformDragging = dragging;
+
+    try {
+      if (this.viewer?.controls) {
+        this.viewer.controls.enabled = !dragging;
+      }
+    } catch (error) {
+      /* ignore */
+    }
+
+    // Important: Do NOT clear transforms when dragging stops!
+    // This was causing the gizmos to disappear after dragging
+  }
+
+  _updateExtensionLinesForAllPoints() {
+    // Update extension lines for all points based on current spline data
+    this._splineData.points.forEach((pt) => {
+      this._updateExtensionLinesForPoint(pt);
+    });
+  }
+
+  _updateExtensionLinesForPoint(pt) {
+    const forwardKey = `forward-line:${pt.id}`;
+    const backwardKey = `backward-line:${pt.id}`;
+    
+    const forwardLine = this._extensionLines.get(forwardKey);
+    const backwardLine = this._extensionLines.get(backwardKey);
+
+    if (!forwardLine || !backwardLine) return;
+
+    // Get direction from rotation matrix
+    const rotation = pt.rotation || [1, 0, 0, 0, 1, 0, 0, 0, 1];
+    let xAxisDirection = [rotation[0], rotation[1], rotation[2]];
+    
+    const length = Math.sqrt(xAxisDirection[0] * xAxisDirection[0] + xAxisDirection[1] * xAxisDirection[1] + xAxisDirection[2] * xAxisDirection[2]);
+    if (length > 0) {
+      xAxisDirection = [xAxisDirection[0] / length, xAxisDirection[1] / length, xAxisDirection[2] / length];
+    }
+
+    const forwardDir = pt.flipDirection ? [-xAxisDirection[0], -xAxisDirection[1], -xAxisDirection[2]] : xAxisDirection;
+    const backwardDir = pt.flipDirection ? xAxisDirection : [-xAxisDirection[0], -xAxisDirection[1], -xAxisDirection[2]];
+
+    // Update forward line geometry
+    if (pt.forwardDistance > 0) {
+      const forwardEnd = [
+        pt.position[0] + forwardDir[0] * pt.forwardDistance,
+        pt.position[1] + forwardDir[1] * pt.forwardDistance,
+        pt.position[2] + forwardDir[2] * pt.forwardDistance
+      ];
+      
+      const forwardPosAttr = forwardLine.geometry.getAttribute("position");
+      if (!forwardPosAttr) {
+        forwardLine.geometry.setAttribute("position", new THREE.Float32BufferAttribute([
+          pt.position[0], pt.position[1], pt.position[2],
+          forwardEnd[0], forwardEnd[1], forwardEnd[2]
+        ], 3));
+      } else {
+        const arr = forwardPosAttr.array;
+        arr[0] = pt.position[0]; arr[1] = pt.position[1]; arr[2] = pt.position[2];
+        arr[3] = forwardEnd[0]; arr[4] = forwardEnd[1]; arr[5] = forwardEnd[2];
+        forwardPosAttr.needsUpdate = true;
+      }
+    }
+
+    // Update backward line geometry
+    if (pt.backwardDistance > 0) {
+      const backwardEnd = [
+        pt.position[0] + backwardDir[0] * pt.backwardDistance,
+        pt.position[1] + backwardDir[1] * pt.backwardDistance,
+        pt.position[2] + backwardDir[2] * pt.backwardDistance
+      ];
+      
+      const backwardPosAttr = backwardLine.geometry.getAttribute("position");
+      if (!backwardPosAttr) {
+        backwardLine.geometry.setAttribute("position", new THREE.Float32BufferAttribute([
+          pt.position[0], pt.position[1], pt.position[2],
+          backwardEnd[0], backwardEnd[1], backwardEnd[2]
+        ], 3));
+      } else {
+        const arr = backwardPosAttr.array;
+        arr[0] = pt.position[0]; arr[1] = pt.position[1]; arr[2] = pt.position[2];
+        arr[3] = backwardEnd[0]; arr[4] = backwardEnd[1]; arr[5] = backwardEnd[2];
+        backwardPosAttr.needsUpdate = true;
+      }
+    }
+  }
+
+}