docs: improve API reference and fix local builds

API Reference improvements:
- Better organization by category (Core, Node, Connection, etc.)
- Added missing classes: StyleCollection, CreateCommand, CopyCommand, PasteCommand
- Added new structs: NodeValidationState, ProcessingIconStyle
- Added new enums: NodeProcessingStatus, ProcessingIconPos
- Removed non-existent DuplicateCommand
- Fixed anonymous enum warnings with :no-link: directive

Build fix:
- Added breathe config for local Doxygen XML builds

Author: paceholder

docs/api/classes.rst

@@ -1,39 +1,57 @@
 QtNodes Class Reference
 =======================
 
-Basic Classes
--------------
+This page provides auto-generated API documentation from the source code.
+
+Core Classes
+------------
+
+Graph Model
+^^^^^^^^^^^
 
 .. doxygenclass:: QtNodes::AbstractGraphModel
    :members:
 
-.. doxygenstruct:: QtNodes::NodeDataType
+.. doxygenclass:: QtNodes::DataFlowGraphModel
    :members:
 
-.. doxygenclass:: QtNodes::NodeData
-   :members:
+Scene and View
+^^^^^^^^^^^^^^
 
-.. doxygenstruct:: QtNodes::ConnectionId
+.. doxygenclass:: QtNodes::BasicGraphicsScene
    :members:
 
-.. doxygenclass:: QtNodes::BasicGraphicsScene
+.. doxygenclass:: QtNodes::DataFlowGraphicsScene
    :members:
 
 .. doxygenclass:: QtNodes::GraphicsView
    :members:
 
-.. doxygenclass:: QtNodes::GraphicsViewStyle
-   :members:
+Node Classes
+------------
+
+Graphics
+^^^^^^^^
 
 .. doxygenclass:: QtNodes::NodeGraphicsObject
    :members:
+   :no-link:
+
+.. doxygenclass:: QtNodes::NodeState
+   :members:
+
+Painting
+^^^^^^^^
 
 .. doxygenclass:: QtNodes::AbstractNodePainter
    :members:
 
 .. doxygenclass:: QtNodes::DefaultNodePainter
    :members:
 
+Geometry
+^^^^^^^^
+
 .. doxygenclass:: QtNodes::AbstractNodeGeometry
    :members:
 
@@ -43,70 +61,111 @@ Basic Classes
 .. doxygenclass:: QtNodes::DefaultVerticalNodeGeometry
    :members:
 
-.. doxygenclass:: QtNodes::NodeState
-   :members:
+Connection Classes
+------------------
 
-.. doxygenclass:: QtNodes::NodeStyle
+.. doxygenclass:: QtNodes::ConnectionGraphicsObject
    :members:
+   :no-link:
 
-.. doxygenclass:: QtNodes::ConnectionGraphicsObject
+.. doxygenclass:: QtNodes::AbstractConnectionPainter
    :members:
 
 .. doxygenclass:: QtNodes::DefaultConnectionPainter
    :members:
 
+.. doxygenclass:: QtNodes::NodeConnectionInteraction
+   :members:
+
+Data Flow Classes
+-----------------
+
+.. doxygenclass:: QtNodes::NodeDelegateModel
+   :members:
+
+.. doxygenclass:: QtNodes::NodeDelegateModelRegistry
+   :members:
+
+.. doxygenclass:: QtNodes::NodeData
+   :members:
+
+Styling
+-------
+
+.. doxygenclass:: QtNodes::NodeStyle
+   :members:
+
 .. doxygenclass:: QtNodes::ConnectionStyle
    :members:
 
-.. doxygenclass:: QtNodes::NodeConnectionInteraction
+.. doxygenclass:: QtNodes::GraphicsViewStyle
+   :members:
+
+.. doxygenclass:: QtNodes::StyleCollection
    :members:
 
-Undo Redo
----------
+Undo Commands
+-------------
+
+.. doxygenclass:: QtNodes::CreateCommand
+   :members:
 
 .. doxygenclass:: QtNodes::DeleteCommand
    :members:
 
-.. doxygenclass:: QtNodes::DuplicateCommand
+.. doxygenclass:: QtNodes::ConnectCommand
    :members:
 
 .. doxygenclass:: QtNodes::DisconnectCommand
    :members:
 
-.. doxygenclass:: QtNodes::ConnectCommand
+.. doxygenclass:: QtNodes::MoveNodeCommand
    :members:
 
-.. doxygenclass:: QtNodes::MoveNodeCommand
+.. doxygenclass:: QtNodes::CopyCommand
    :members:
 
-Dataflow Classes
-----------------
+.. doxygenclass:: QtNodes::PasteCommand
+   :members:
 
-.. doxygenclass:: QtNodes::DataFlowGraphicsScene
+Data Types
+----------
+
+Structs
+^^^^^^^
+
+.. doxygenstruct:: QtNodes::NodeDataType
    :members:
 
-.. doxygenclass:: QtNodes::DataFlowGraphModel
+.. doxygenstruct:: QtNodes::ConnectionId
    :members:
 
-.. doxygenclass:: QtNodes::NodeDelegateModel
+.. doxygenstruct:: QtNodes::NodeValidationState
    :members:
 
-.. doxygenclass:: QtNodes::NodeDelegateModelRegistry
+.. doxygenstruct:: QtNodes::ProcessingIconStyle
    :members:
 
-Definitions
------------
+Type Definitions
+^^^^^^^^^^^^^^^^
 
 .. doxygentypedef:: QtNodes::NodeId
 
 .. doxygentypedef:: QtNodes::PortIndex
 
+Enumerations
+^^^^^^^^^^^^
+
 .. doxygenenum:: QtNodes::NodeRole
 
 .. doxygenenum:: QtNodes::NodeFlag
 
 .. doxygenenum:: QtNodes::PortRole
 
+.. doxygenenum:: QtNodes::PortType
+
 .. doxygenenum:: QtNodes::ConnectionPolicy
 
-.. doxygenenum:: QtNodes::PortType
+.. doxygenenum:: QtNodes::NodeProcessingStatus
+
+.. doxygenenum:: QtNodes::ProcessingIconPos

docs/conf.py

@@ -21,6 +21,11 @@ def configureDoxyfile(input_dir, output_dir):
     configureDoxyfile(input_dir, output_dir)
     subprocess.call('doxygen', shell=True)
     breathe_projects['QtNodes'] = output_dir + '/xml/'
+else:
+    # Local build: use CMake-generated Doxygen XML
+    build_xml_path = '../build/docs/doxygen/xml/'
+    if os.path.exists(build_xml_path):
+        breathe_projects['QtNodes'] = build_xml_path
 
 
 # -- Project information -----------------------------------------------------