Major clean up and improvements to vimwiki compatibility and documentation.

Reviewed-on: #1

crates/nuwiki-lsp/tests/commands_checkboxes.rs

@@ -47,6 +47,24 @@ fn cycle_state_walks_progression() {
     assert_eq!(ops::cycle_state("[-]"), Some("[ ]"));
 }
 
+#[test]
+fn cycle_state_back_is_exact_inverse() {
+    // `glp` walks the progression in reverse — every step must undo the
+    // matching `cycle_state` step.
+    assert_eq!(ops::cycle_state_back("[ ]"), Some("[X]"));
+    assert_eq!(ops::cycle_state_back("[X]"), Some("[O]"));
+    assert_eq!(ops::cycle_state_back("[O]"), Some("[o]"));
+    assert_eq!(ops::cycle_state_back("[o]"), Some("[.]"));
+    assert_eq!(ops::cycle_state_back("[.]"), Some("[ ]"));
+    assert_eq!(ops::cycle_state_back("[-]"), Some("[ ]"));
+    // Composing forward then backward returns to the start for every
+    // in-cycle marker.
+    for s in ["[ ]", "[.]", "[o]", "[O]", "[X]"] {
+        let fwd = ops::cycle_state(s).unwrap();
+        assert_eq!(ops::cycle_state_back(fwd), Some(s));
+    }
+}
+
 #[test]
 fn reject_state_toggles_dash_marker() {
     assert_eq!(ops::reject_state("[ ]"), Some("[-]"));