[refactor] remove node as dependency in 3d node (#6707)

## Summary

This PR refactors the Load3d 3D rendering system to remove its direct
dependency on LGraphNode, making it a more decoupled and reusable
component. The core rendering engine is now framework-agnostic and can
be used in any context, not just within LiteGraph nodes.

## Changes

1. Decoupled Load3d from LGraphNode
  - Before: Load3d directly accessed node.widgets and node.properties
- After: Load3d accepts optional parameters and callbacks, delegating
node integration to the calling code

2. Event-Driven State Management
  - Removed internal storage from Load3d core components
- Camera, controls, and view helper managers now emit cameraChanged
events instead of directly storing state
- External code (e.g., useLoad3d) listens to events and handles
persistence to node.properties

3. Reactive Dimension Updates

- Introduced getDimensions callback to support reactive dimension
updates
- Fixes the issue where dimension changes in vueNodes mode required a
refresh
- The callback is invoked on every render to get fresh width/height
values

4. Improved Configuration System

- Load3DConfiguration now accepts properties: Dictionary<NodeProperty |
undefined> instead of custom storage
  interface
  - Uses official LiteGraph type definitions (Dictionary, NodeProperty)
  - More semantic parameter naming: storage → properties

┆Issue is synchronized with this [Notion
page](https://www.notion.so/PR-6707-refactor-remove-node-as-dependency-in-3d-node-2ab6d73d365081ffac1cdce354781ce8)
by [Unito](https://www.unito.io)

src/extensions/core/load3d/Load3DConfiguration.ts

@@ -2,10 +2,13 @@ import Load3d from '@/extensions/core/load3d/Load3d'
 import Load3dUtils from '@/extensions/core/load3d/Load3dUtils'
 import type {
   CameraConfig,
+  CameraState,
   LightConfig,
   ModelConfig,
   SceneConfig
 } from '@/extensions/core/load3d/interfaces'
+import type { Dictionary } from '@/lib/litegraph/src/interfaces'
+import type { NodeProperty } from '@/lib/litegraph/src/LGraphNode'
 import type { IBaseWidget } from '@/lib/litegraph/src/types/widgets'
 import { useSettingStore } from '@/platform/settings/settingStore'
 import { api } from '@/scripts/api'
@@ -13,14 +16,17 @@ import { api } from '@/scripts/api'
 type Load3DConfigurationSettings = {
   loadFolder: string
   modelWidget: IBaseWidget
-  cameraState?: any
+  cameraState?: CameraState
   width?: IBaseWidget
   height?: IBaseWidget
   bgImagePath?: string
 }
 
 class Load3DConfiguration {
-  constructor(private load3d: Load3d) {}
+  constructor(
+    private load3d: Load3d,
+    private properties?: Dictionary<NodeProperty | undefined>
+  ) {}
 
   configureForSaveMesh(loadFolder: 'input' | 'output', filePath: string) {
     this.setupModelHandlingForSaveMesh(filePath, loadFolder)
@@ -62,7 +68,7 @@ class Load3DConfiguration {
   private setupModelHandling(
     modelWidget: IBaseWidget,
     loadFolder: string,
-    cameraState?: any
+    cameraState?: CameraState
   ) {
     const onModelWidgetUpdate = this.createModelUpdateHandler(
       loadFolder,
@@ -110,48 +116,48 @@ class Load3DConfiguration {
   }
 
   private loadSceneConfig(): SceneConfig {
-    const defaultConfig: SceneConfig = {
+    if (this.properties && 'Scene Config' in this.properties) {
+      return this.properties['Scene Config'] as SceneConfig
+    }
+
+    return {
       showGrid: useSettingStore().get('Comfy.Load3D.ShowGrid'),
       backgroundColor:
         '#' + useSettingStore().get('Comfy.Load3D.BackgroundColor'),
       backgroundImage: ''
-    }
-
-    const config = this.load3d.loadNodeProperty('Scene Config', defaultConfig)
-    this.load3d.node.properties['Scene Config'] = config
-    return config
+    } as SceneConfig
   }
 
   private loadCameraConfig(): CameraConfig {
-    const defaultConfig: CameraConfig = {
-      cameraType: useSettingStore().get('Comfy.Load3D.CameraType'),
-      fov: 35
+    if (this.properties && 'Camera Config' in this.properties) {
+      return this.properties['Camera Config'] as CameraConfig
     }
 
-    const config = this.load3d.loadNodeProperty('Camera Config', defaultConfig)
-    this.load3d.node.properties['Camera Config'] = config
-    return config
+    return {
+      cameraType: useSettingStore().get('Comfy.Load3D.CameraType'),
+      fov: 35
+    } as CameraConfig
   }
 
   private loadLightConfig(): LightConfig {
-    const defaultConfig: LightConfig = {
-      intensity: useSettingStore().get('Comfy.Load3D.LightIntensity')
+    if (this.properties && 'Light Config' in this.properties) {
+      return this.properties['Light Config'] as LightConfig
     }
 
-    const config = this.load3d.loadNodeProperty('Light Config', defaultConfig)
-    this.load3d.node.properties['Light Config'] = config
-    return config
+    return {
+      intensity: useSettingStore().get('Comfy.Load3D.LightIntensity')
+    } as LightConfig
   }
 
   private loadModelConfig(): ModelConfig {
-    const defaultConfig: ModelConfig = {
-      upDirection: 'original',
-      materialMode: 'original'
+    if (this.properties && 'Model Config' in this.properties) {
+      return this.properties['Model Config'] as ModelConfig
     }
 
-    const config = this.load3d.loadNodeProperty('Model Config', defaultConfig)
-    this.load3d.node.properties['Model Config'] = config
-    return config
+    return {
+      upDirection: 'original',
+      materialMode: 'original'
+    } as ModelConfig
   }
 
   private applySceneConfig(config: SceneConfig, bgImagePath?: string) {
@@ -188,7 +194,10 @@ class Load3DConfiguration {
     this.load3d.setMaterialMode(config.materialMode)
   }
 
-  private createModelUpdateHandler(loadFolder: string, cameraState?: any) {
+  private createModelUpdateHandler(
+    loadFolder: string,
+    cameraState?: CameraState
+  ) {
     let isFirstLoad = true
     return async (value: string | number | boolean | object) => {
       if (!value) return
@@ -209,7 +218,7 @@ class Load3DConfiguration {
       const modelConfig = this.loadModelConfig()
       this.applyModelConfig(modelConfig)
 
-      if (isFirstLoad && cameraState && typeof cameraState === 'object') {
+      if (isFirstLoad && cameraState) {
         try {
           this.load3d.setCameraState(cameraState)
         } catch (error) {
@@ -230,8 +239,8 @@ class Load3DConfiguration {
     const subfolderParts = pathParts.slice(1, -1)
     const subfolder = subfolderParts.join('/')
 
-    if (subfolder) {
-      this.load3d.node.properties['Resource Folder'] = subfolder
+    if (subfolder && this.properties) {
+      this.properties['Resource Folder'] = subfolder
     }
   }
 }