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.

1 files changed, 0 insertions, 102 deletions

diff --git a/examples/example-argument-parse/src/main.rs b/examples/example-argument-parse/src/main.rs
deleted file mode 100644
index d45c4af..0000000
--- a/examples/example-argument-parse/src/main.rs
+++ /dev/null
@@ -1,102 +0,0 @@
-//! Example Argument Parse
-//!
-//! > This example demonstrates how to use the `parser` feature to parse user input
-//!
-//! Run:
-//! ```bash
-//! cargo run --manifest-path examples/example-argument-parse/Cargo.toml --quiet -- transfer README.md --size 32kib
-//! cargo run --manifest-path examples/example-argument-parse/Cargo.toml --quiet -- transfer src/ --dir
-//! cargo run --manifest-path examples/example-argument-parse/Cargo.toml --quiet -- strict-transfer README.md
-//! cargo run --manifest-path examples/example-argument-parse/Cargo.toml --quiet -- strict-transfer --dir
-//! ```
-//!
-//! Output:
-//! ```plaintext
-//! file: README.md (32768)
-//! dir: src/ (1048576)
-//! file: README.md (1048576)
-//! Error: name is not provided
-//! ```
-
-use mingling::{macros::route, prelude::*};
-use std::io::Write;
-
-dispatcher!("transfer", EntryTransfer);
-dispatcher!("strict-transfer", EntryStrictTransfer);
-
-pack!(ResultFile = (bool, usize, String)); // (IsDir, Size, Name)
-
-#[chain]
-fn handle_transfer_parse(args: EntryTransfer) -> Next {
-    // --------- IMPORTANT ---------
-    // First parse flag arguments (like --dir/-D), then positional arguments
-    let result: ResultFile = args
-        // Name --dir --size 20mib
-        //            ^^^^^^^^^^^^_ first
-        .pick::<bool>(["--dir", "-D"])
-        // Name --dir
-        //      ^^^^^_ second (or `-D`)
-        .pick_or::<usize>("--size", 1024 * 1024_usize)
-        // Name
-        // ^^^^_ finally, pick positional arg
-        .pick::<String>(())
-        .after(|str| str.trim().replace(' ', ""))
-        // Unpack to tuple (is_dir, size, name)
-        .unpack()
-        // Convert into ResultFile
-        .into();
-    // --------- IMPORTANT ---------
-    result.into()
-}
-
-pack!(ErrorNoNameProvided = ());
-
-#[chain]
-fn handle_strict_transfer_parse(args: EntryStrictTransfer) -> Next {
-    // --------- IMPORTANT ---------
-    // Strict parsing: error immediately if the name is not provided
-    let result: ResultFile = route! { // Use `route!` to wrap a Picker that contains `or_route`
-        args
-            .pick::<bool>(["--dir", "-D"])
-            .pick_or::<usize>("--size", 1024 * 1024_usize)
-            // Finally parse the positional argument; if not found, route to `ErrorNoNameProvided`
-            .pick_or_route::<String, _>((), ErrorNoNameProvided::default())
-            .after(|str| str.trim().replace(' ', ""))
-            .unpack()
-    }
-    // Convert into ResultFile
-    .into();
-    // --------- IMPORTANT ---------
-    result.to_chain()
-}
-
-/// Renders the parsed transfer result (file/dir, size, name).
-#[renderer]
-fn render_result_file(result: ResultFile) -> RenderResult {
-    let (is_dir, size, name) = result.into();
-    let mut result = RenderResult::new();
-    writeln!(
-        result,
-        "{}: {} ({})",
-        if is_dir { "dir" } else { "file" },
-        name,
-        size
-    )
-    .ok();
-    result
-}
-
-/// Renders the error when no name is provided.
-#[renderer]
-fn render_error_no_name_provided(_: ErrorNoNameProvided) -> RenderResult {
-    let mut result = RenderResult::new();
-    writeln!(result, "Error: name is not provided").ok();
-    result
-}
-
-gen_program!();
-
-fn main() {
-    let program = ThisProgram::new();
-    program.exec_and_exit();
-}