docs: enable systems_wasm docs

src/systems/systems_wasm/Cargo.toml

@@ -6,12 +6,10 @@ edition = "2018"
 
 [lib]
 test = false
-doctest = false
-doc = false
 
 [dependencies]
 uom = "0.30.0"
 systems = { path = "../systems" }
 msfs = { git = "https://github.com/flybywiresim/msfs-rs", branch = "main" }
 fxhash = "0.2.1"
-enum_dispatch = "0.3.7"
+enum_dispatch = "0.3.7"

src/systems/systems_wasm/src/aspects.rs

@@ -56,9 +56,9 @@ pub(super) trait Aspect {
     }
 }
 
-/// Type used to configure and build an [Aspect].
+/// Type used to configure an aspect of the connectivity between MSFS and the simulation.
 ///
-/// It should be noted that the resulting [Aspect] executes its tasks in the order in which they
+/// It should be noted that the resulting aspect executes its tasks in the order in which they
 /// were declared. Declaration order is important when one action depends on another action.
 /// When e.g. a variable that is mapped should then be written to an event, be sure to
 /// declare the mapping before the event writing.

src/systems/systems_wasm/src/electrical.rs

@@ -1,7 +1,10 @@
-use std::error::Error;
+#[cfg(not(target_arch = "wasm32"))]
+use crate::msfs::legacy::execute_calculator_code;
+#[cfg(target_arch = "wasm32")]
+use msfs::legacy::execute_calculator_code;
 
 use crate::{ExecuteOn, MsfsAspectBuilder, Variable};
-use msfs::legacy::execute_calculator_code;
+use std::error::Error;
 use systems::shared::{to_bool, ElectricalBusType};
 
 pub(super) fn electrical_buses<const N: usize>(

src/systems/systems_wasm/src/failures.rs

@@ -1,6 +1,10 @@
-use fxhash::FxHashMap;
+#[cfg(not(target_arch = "wasm32"))]
+use crate::msfs::legacy::NamedVariable;
+#[cfg(target_arch = "wasm32")]
 use msfs::legacy::NamedVariable;
 
+use fxhash::FxHashMap;
+
 use systems::failures::FailureType;
 
 pub(super) struct Failures {

src/systems/systems_wasm/src/lib.rs

@@ -1,18 +1,22 @@
-#![cfg(any(target_arch = "wasm32", doc))]
 #[macro_use]
 pub mod aspects;
 mod electrical;
 mod failures;
+mod msfs;
+
+#[cfg(not(target_arch = "wasm32"))]
+use crate::msfs::legacy::{AircraftVariable, NamedVariable};
+#[cfg(target_arch = "wasm32")]
+use ::msfs::legacy::{AircraftVariable, NamedVariable};
 
 use crate::aspects::{Aspect, ExecuteOn, MsfsAspectBuilder};
 use crate::electrical::{auxiliary_power_unit, electrical_buses};
-use failures::Failures;
-use fxhash::FxHashMap;
-use msfs::{
-    legacy::{AircraftVariable, NamedVariable},
+use ::msfs::{
     sim_connect::{data_definition, Period, SimConnect, SimConnectRecv, SIMCONNECT_OBJECT_ID_USER},
     MSFSEvent,
 };
+use failures::Failures;
+use fxhash::FxHashMap;
 use std::fmt::{Display, Formatter};
 use std::{error::Error, time::Duration};
 use systems::shared::ElectricalBusType;

src/systems/systems_wasm/src/msfs.rs

@@ -0,0 +1,47 @@
+///! Module declared to be able to compile documentation.
+///! Does not provide any meaningful functionality.
+#[cfg(not(target_arch = "wasm32"))]
+pub(crate) mod legacy {
+    use std::cell::Cell;
+    use std::rc::Rc;
+
+    pub fn execute_calculator_code<T>(_code: &str) {}
+
+    #[derive(Debug)]
+    pub struct AircraftVariable {}
+
+    impl AircraftVariable {
+        pub fn from(
+            _name: &str,
+            _units: &str,
+            _index: usize,
+        ) -> Result<Self, Box<dyn std::error::Error>> {
+            Ok(Self {})
+        }
+
+        pub fn get(&self) -> f64 {
+            0.
+        }
+    }
+
+    #[derive(Debug)]
+    pub struct NamedVariable {
+        value: Rc<Cell<f64>>,
+    }
+
+    impl NamedVariable {
+        pub fn from(_name: &str) -> Self {
+            Self {
+                value: Rc::new(Cell::new(0.)),
+            }
+        }
+
+        pub fn get_value(&self) -> f64 {
+            self.value.get()
+        }
+
+        pub fn set_value(&self, value: f64) {
+            self.value.set(value);
+        }
+    }
+}