refactor!: remove legacy parser feature and migrate to picker

The legacy `parser` feature and its module tree (`mingling::parser`,
`Argument`, `Picker`, `Pickable`, etc.) have been fully removed and
replaced by the `picker` feature powered by `arg-picker`.

BREAKING CHANGE: Remove `parser` feature and use `picker` instead.
Migration guide: Replace `features = ["parser"]` with
`features = ["picker"]` and update API usage per the provided table.

3 files changed, 28 insertions, 14 deletions

diff --git a/examples/full-todolist/Cargo.lock b/examples/full-todolist/Cargo.lock
index 4fc964d..ad9f475 100644
--- a/examples/full-todolist/Cargo.lock
+++ b/examples/full-todolist/Cargo.lock
@@ -3,6 +3,23 @@
 version = 4
 
 [[package]]
+name = "arg-picker"
+version = "0.2.0"
+dependencies = [
+ "arg-picker-macros",
+ "just_fmt",
+]
+
+[[package]]
+name = "arg-picker-macros"
+version = "0.2.0"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
 name = "equivalent"
 version = "1.0.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
@@ -67,10 +84,10 @@ dependencies = [
 name = "mingling"
 version = "0.5.0"
 dependencies = [
+ "arg-picker",
  "mingling_core",
  "mingling_macros",
  "serde",
- "size",
 ]
 
 [[package]]
@@ -164,12 +181,6 @@ dependencies = [
 ]
 
 [[package]]
-name = "size"
-version = "0.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1b6709c7b6754dca1311b3c73e79fcce40dd414c782c66d88e8823030093b02b"
-
-[[package]]
 name = "syn"
 version = "2.0.118"
 source = "registry+https://github.com/rust-lang/crates.io-index"
diff --git a/examples/full-todolist/Cargo.toml b/examples/full-todolist/Cargo.toml
index 9d6f1a7..fb3d3be 100644
--- a/examples/full-todolist/Cargo.toml
+++ b/examples/full-todolist/Cargo.toml
@@ -10,7 +10,7 @@ serde_json = "1.0.150"
 [dependencies.mingling]
 path = "../../mingling"
 features = [
-    "parser",
+    "picker",
     "extras",
     "structural_renderer",
 ]
diff --git a/examples/full-todolist/src/main.rs b/examples/full-todolist/src/main.rs
index c0df1df..eea417a 100644
--- a/examples/full-todolist/src/main.rs
+++ b/examples/full-todolist/src/main.rs
@@ -9,9 +9,10 @@
 use mingling::{
     LazyInit, LazyRes,
     macros::route,
+    picker::value::Flag,
     prelude::*,
     res::ResExitCode,
-    setup::{ExitCodeSetup, HelpFlagSetup, StructuralRendererSetup},
+    setup::{ExitCodeSetup, picker::HelpFlagSetup, picker::StructuralRendererSetup},
 };
 use std::io::Write;
 
@@ -51,7 +52,7 @@ fn main() {
     // Setups
     program.with_setup(ExitCodeSetup::default());
     program.with_setup(StructuralRendererSetup);
-    program.with_setup(HelpFlagSetup::new(["--help", "-h"]));
+    program.with_setup(HelpFlagSetup::new(&arg![help: Flag, 'h']));
 
     // Flags
     let all = program.pick_global_flag(["-A", "--all"]);
@@ -74,9 +75,10 @@ fn main() {
 #[chain]
 fn handle_add(args: EntryAdd) -> Next {
     let task: String = route! {
-        args
-            .pick_or_route((), ErrorNoTaskDescriptionProvided::new(()))
-            .unpack()
+        args.pick_or_route(&arg![String], || {
+            ErrorNoTaskDescriptionProvided::new(()).to_chain()
+        })
+        .to_result()
     };
     StateAddTodo::new(task).to_chain()
 }
@@ -115,7 +117,8 @@ fn handle_list(_args: EntryList, todolist: &mut LazyRes<ResTodoList>) -> Next {
 #[chain]
 fn handle_complete(args: EntryComplete) -> Next {
     let index: i32 = route! {
-        args.pick_or_route((), ErrorNoIndexProvided::new(())).unpack()
+        args.pick_or_route(&arg![i32], || ErrorNoIndexProvided::new(()).to_chain())
+            .to_result()
     };
     StateCompleteTodo::new(index).to_chain()
 }