add default config for IPC

Author: paperbenni

src/bin/ctl/commands.rs

@@ -220,6 +220,12 @@ pub enum ModeAction {
     Toggle { name: String },
 }
 
+#[derive(Debug, Clone, Subcommand)]
+pub enum ConfigAction {
+    /// Print a commented-out default config to stdout
+    Default,
+}
+
 #[derive(Debug, Clone, Subcommand)]
 pub enum CommandKind {
     Action {
@@ -290,6 +296,10 @@ pub enum CommandKind {
     Wallpaper {
         path: String,
     },
+    Config {
+        #[command(subcommand)]
+        action: ConfigAction,
+    },
 }
 
 #[derive(Debug, Parser)]
@@ -509,5 +519,6 @@ pub fn command_to_ipc(command: CommandKind) -> IpcCommand {
         }
         CommandKind::Wallpaper { path } => IpcCommand::Wallpaper(path),
         CommandKind::UpdateStatus { text } => IpcCommand::UpdateStatus(text),
+        CommandKind::Config { .. } => unreachable!("config is handled locally"),
     }
 }

src/bin/instantwmctl.rs

@@ -191,6 +191,17 @@ fn main() {
     let cli = Cli::parse();
 
     let command = match &cli.command {
+        ctl::CommandKind::Config { action } => {
+            match action {
+                ctl::commands::ConfigAction::Default => {
+                    println!(
+                        "{}",
+                        instantwm::config::config_toml::generate_commented_config()
+                    );
+                }
+            }
+            return;
+        }
         ctl::CommandKind::Action { name, args, list } => {
             if *list {
                 let actions = instantwm::config::keybind_config::get_actions_for_ipc();

src/config/config_toml.rs

@@ -258,6 +258,48 @@ pub fn load_config_file() -> ThemeConfig {
     }
 }
 
+/// Generate a commented-out default config template.
+///
+/// All settings are commented out so that:
+/// - Users can see what options are available
+/// - Defaults are not baked in, so they track upstream changes
+pub fn generate_commented_config() -> String {
+    let config = ThemeConfig::default();
+    let full = toml::to_string_pretty(&config).expect("failed to serialize default config");
+
+    let mut out = String::new();
+    out.push_str("# instantWM configuration\n");
+    out.push_str("#\n");
+    out.push_str(
+        "# This file is optional. instantWM uses sensible defaults when no config exists.\n",
+    );
+    out.push_str("# Uncomment and modify any section below to override defaults.\n");
+    out.push_str("#\n");
+    out.push_str("# Config changes are applied on reload (instantwmctl reload).\n");
+    out.push_str("#\n");
+    out.push_str(
+        "# Use `instantwm --print-config` to see the full default config with all values.\n",
+    );
+    out.push_str("# Use `instantwm --list-actions` to see valid action names for keybinds.\n");
+    out.push_str("#\n\n");
+
+    for line in full.lines() {
+        if line.trim().is_empty() {
+            out.push('\n');
+        } else if line.starts_with('[') {
+            out.push_str("# ");
+            out.push_str(line);
+            out.push('\n');
+        } else {
+            out.push_str("# ");
+            out.push_str(line);
+            out.push('\n');
+        }
+    }
+
+    out
+}
+
 fn load_and_merge_config(path: &Path, visited: &mut HashSet<PathBuf>) -> Result<toml::Value, ()> {
     let canonical_path = path.canonicalize().map_err(|e| {
         eprintln!("instantwm: could not canonicalize path {:?}: {e}", path);