Add resolved appearance engine and paired theme settings

Resolve light, dark and automatic appearance centrally and publish live theme snapshots to native surfaces and the appearance portal. Add paired preset families, custom theme imports, accessibility transforms and contrast-safe transitions.

Refine the Settings gallery and Auto controls, move overrides under advanced customization, and share palette-aware switches and circular slider thumbs. Document configuration and include theme licenses and integration coverage.

feresectl/src/main.rs

@@ -16,6 +16,9 @@ fn main() -> Result<(), Box<dyn Error>> {
         }
         return autostart::run();
     }
+    if env::args().nth(1).as_deref() == Some("theme") {
+        return theme_command(env::args().skip(2).collect());
+    }
     let (command, args) = parse_args(env::args().skip(1))?;
     let request = Request {
         version: VERSION,
@@ -43,6 +46,44 @@ fn main() -> Result<(), Box<dyn Error>> {
     }
 }
 
+fn theme_command(args: Vec<String>) -> Result<(), Box<dyn Error>> {
+    let mut connection = ferese_ipc::theme::Connection::connect()?;
+    match args.as_slice() {
+        [command] if command == "get" || command == "status" => {
+            println!("{}", serde_json::to_string_pretty(&connection.get()?)?);
+        }
+        [command] if command == "subscribe" => {
+            let mut snapshot = connection.get()?;
+            loop {
+                println!("{}", serde_json::to_string(&snapshot)?);
+                snapshot = connection.watch(snapshot.revision)?;
+            }
+        }
+        [command, mode] if command == "mode" && matches!(mode.as_str(), "light" | "dark" | "auto") => {
+            println!(
+                "{}",
+                serde_json::to_string_pretty(&connection.call("theme-set-mode", json!({"mode": mode}))?)?
+            );
+        }
+        [command, path] if command == "preview" => {
+            let source = fs::read_to_string(path)?;
+            println!(
+                "{}",
+                serde_json::to_string_pretty(&connection.call(
+                    "theme-preview",
+                    json!({"source": source, "directory": std::path::Path::new(path).canonicalize()?.parent()})
+                )?)?
+            );
+        }
+        _ => {
+            return Err(
+                "usage: feresectl theme <get|status|subscribe|mode light|mode dark|mode auto|preview PATH>".into(),
+            );
+        }
+    }
+    Ok(())
+}
+
 // The compositor stages the PNG in a private directory and replies with its
 // path. Open it before unlinking so a failure never destroys the only copy, and
 // stream the bytes with explicit writes: println! would corrupt binary output.