v0.1.4-pre.008-fix.002

crates/ksp-app-config-desk/src/splash.rs

@@ -1,5 +1,5 @@
 // file: crates/ksp-app-config-desk/src/splash.rs
-// version: 2
+// version: 3
 
 //! Common splash settings and frontend event contracts for Config Desk.
 
@@ -17,6 +17,8 @@ const MAX_SPLASH_FADE_MS: u32 = 10_000;
 pub(crate) struct SplashSettings {
     minimum_ms: u64,
     fade_ms: u32,
+    minimum_source: ksp_config_lib::ConfigEnvironmentSource,
+    fade_source: ksp_config_lib::ConfigEnvironmentSource,
 }
 
 impl SplashSettings {
@@ -47,13 +49,18 @@ impl SplashSettings {
             std::result::Result::Ok(value) => value,
             std::result::Result::Err(error) => return std::result::Result::Err(error),
         };
-        return std::result::Result::Ok(Self { minimum_ms, fade_ms });
+        return std::result::Result::Ok(Self { minimum_ms, fade_ms, minimum_source: minimum.source(), fade_source: fade.source() });
     }
 
     /// Returns safe in-memory timings used when the managed environment cannot be resolved.
     #[must_use]
     pub(crate) const fn fallback() -> Self {
-        return Self { minimum_ms: DEFAULT_SPLASH_MINIMUM_MS, fade_ms: DEFAULT_SPLASH_FADE_MS };
+        return Self {
+            minimum_ms: DEFAULT_SPLASH_MINIMUM_MS,
+            fade_ms: DEFAULT_SPLASH_FADE_MS,
+            minimum_source: ksp_config_lib::ConfigEnvironmentSource::Fallback,
+            fade_source: ksp_config_lib::ConfigEnvironmentSource::Fallback,
+        };
     }
 
     /// Returns the minimum visible duration after splash frontend readiness.
@@ -67,6 +74,32 @@ impl SplashSettings {
     pub(crate) const fn fade_ms(self) -> u32 {
         return self.fade_ms;
     }
+
+    /// Returns the safe provenance code for the minimum duration.
+    #[must_use]
+    pub(crate) const fn minimum_source(self) -> &'static str {
+        return environment_source_code(self.minimum_source);
+    }
+
+    /// Returns the safe provenance code for the fade duration.
+    #[must_use]
+    pub(crate) const fn fade_source(self) -> &'static str {
+        return environment_source_code(self.fade_source);
+    }
+
+    /// Returns the minimum backend lifecycle duration from readiness until main activation.
+    #[must_use]
+    pub(crate) fn expected_backend_lifecycle_ms(self) -> u64 {
+        return self.minimum_ms + u64::from(self.fade_ms);
+    }
+}
+
+const fn environment_source_code(source: ksp_config_lib::ConfigEnvironmentSource) -> &'static str {
+    return match source {
+        ksp_config_lib::ConfigEnvironmentSource::Process => "process",
+        ksp_config_lib::ConfigEnvironmentSource::DotEnv => "dotenv",
+        ksp_config_lib::ConfigEnvironmentSource::Fallback => "fallback",
+    };
 }
 
 /// Command emitted by Rust to the splash frontend.