From b9f208deed7b8e012fbcd84202e2fb1d5eb8eeb9 Mon Sep 17 00:00:00 2001
From: 魏曹先生 <1992414357@qq.com>
Date: Fri, 17 Jul 2026 03:24:51 +0800
Subject: feat(picker2): complete Picker2 prototype
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Picker2 replaces the original Picker1 with a two-phase (tag → pick) +
mask-bitmap architecture, decoupling argument matching from type
conversion via a composable matcher pipeline.

Architecture
- FlagMatcher — boolean flags (--verbose)
- ArgMatcher — single flag+value pairs (--name Alice)
- MultiArgMatcher — multi-value flag groups (--files a.txt b.txt)
- PositionalMatcher — positional arguments, respects `--`
- SingleMatcher — composite for Single-type Pickables

Types
- Flag (Active/Inactive) — semantic bool flag value
- String + 14 numeric types via SinglePickable trait
- Vec<T> — greedy multi-value (all SinglePickable types)
- VecUntil<T> — bounded multi-value via BoundaryCheck trait
- VecUntil<T>, pick_string, pick_numbers, pick_bool, pick_flag

Style system
- UNIX_STYLE (kebab), POWERSHELL_STYLE (Pascal), WINDOWS_STYLE (Pascal)
- naming_case auto-conversion via just_fmt integration
- Style-aware separator (= for Unix, : for PS/Windows)

Infrastructure
- internal_repeat! macro generates PickerPattern1..=32
- SinglePickable blanket impl → Pickable
- MultiPickableWithBoundary trait with greedy/bounded variants
- 151 integration tests
- Docs updated for parser feature
---
 mingling_picker/src/parselib/flag_matcher.rs | 82 ++++++++++++++++++++++++++++
 1 file changed, 82 insertions(+)
 create mode 100644 mingling_picker/src/parselib/flag_matcher.rs

(limited to 'mingling_picker/src/parselib/flag_matcher.rs')

diff --git a/mingling_picker/src/parselib/flag_matcher.rs b/mingling_picker/src/parselib/flag_matcher.rs
new file mode 100644
index 0000000..e93d35a
--- /dev/null
+++ b/mingling_picker/src/parselib/flag_matcher.rs
@@ -0,0 +1,82 @@
+use crate::{
+    matcher_needed::*,
+    parselib::{build_possible_flags, get_seeked_first, multi_seek_eq, seek_end_of_options},
+};
+
+/// `FlagMatcher` is used to match flags in command-line arguments.
+///
+/// Flags typically start with `-` or `--` (e.g., `-h`, `--help`),
+/// and do not carry additional values. This matcher is responsible for finding
+/// these flags in the argument list, taking into account that flags after `--`
+/// (end-of-options marker) should not be matched.
+pub struct FlagMatcher;
+
+impl Matcher for FlagMatcher {
+    fn on_match_one(
+        args: &[MaskedArg],
+        style: &ParserStyle,
+        arg_info: &PickerArgInfo,
+    ) -> Option<usize> {
+        let possible_flags = build_possible_flags(style, arg_info);
+        let flag_refs: Vec<&str> = possible_flags.iter().map(|s| s.as_str()).collect();
+        let end_of_options = seek_end_of_options(args, style);
+
+        let result = get_seeked_first(multi_seek_eq(args, &flag_refs, style.case_sensitive));
+
+        match (end_of_options, result) {
+            (Some(end), Some(current)) if current > end => None,
+            _ => result,
+        }
+    }
+
+    fn on_match_all(
+        args: &[MaskedArg],
+        style: &ParserStyle,
+        arg_info: &PickerArgInfo,
+    ) -> Vec<usize> {
+        let possible_flags = build_possible_flags(style, arg_info);
+        single_pass_match_all(args, style, &possible_flags)
+    }
+}
+
+/// Single-pass match: finds the `--` marker and matching flags in one iteration.
+fn single_pass_match_all(
+    args: &[MaskedArg],
+    style: &ParserStyle,
+    possible_flags: &[String],
+) -> Vec<usize> {
+    let flag_refs: Vec<&str> = possible_flags.iter().map(|s| s.as_str()).collect();
+    let eoo = style.end_of_options;
+    let case_sensitive = style.case_sensitive;
+
+    let mut end_pos: Option<usize> = None;
+    let mut matches: Vec<usize> = Vec::new();
+
+    for arg in args {
+        if end_pos.is_none() {
+            let is_eoo = if case_sensitive {
+                arg.raw == eoo
+            } else {
+                arg.raw.eq_ignore_ascii_case(eoo)
+            };
+            if is_eoo {
+                end_pos = Some(arg.raw_idx);
+                continue;
+            }
+        }
+
+        // Only match flags before the end-of-options marker.
+        if end_pos.is_none() {
+            let matched = if case_sensitive {
+                flag_refs.contains(&arg.raw)
+            } else {
+                flag_refs.iter().any(|s| arg.raw.eq_ignore_ascii_case(s))
+            };
+            if matched {
+                matches.push(arg.raw_idx);
+            }
+        }
+    }
+
+    matches
+}
-- 
cgit