feat(cpp-object-oriented-modular-refactoring): step 18 - load-hierarchy

include/fesa/assembly/load_assembler.h

@@ -3,6 +3,7 @@
 
 #include "fesa/analysis/analysis_model.h"
 #include "fesa/fem/dof_manager.h"
+#include "fesa/loads/load.h"
 #include "fesa/math/sparse_matrix.h"
 #include "fesa/math/vector.h"
 
@@ -16,6 +17,14 @@ class LoadAssembler {
   static Result<Vector> AssembleFullNodalLoad(const AnalysisModel& model,
                                               const DofManager& dofs);
 
+  /// @brief Accumulates explicitly supplied loads in their view order.
+  /// @param loads Non-owning loads whose contribution source orders must match
+  /// their view positions.
+  /// @return A candidate committed only after all contributions validate.
+  static Result<Vector> AssembleFullNodalLoad(const AnalysisModel& model,
+                                              const DofManager& dofs,
+                                              const LoadView& loads);
+
   /// @brief Forms Ff-Kfc*dc in stable free/constrained order.
   /// @note This operation neither factorizes nor invokes a solver.
   static Result<Vector> EffectiveFreeRhs(const Vector& full_load,