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/pos_matcher.rs | 71 +++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 mingling_picker/src/parselib/pos_matcher.rs

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

diff --git a/mingling_picker/src/parselib/pos_matcher.rs b/mingling_picker/src/parselib/pos_matcher.rs
new file mode 100644
index 0000000..279e01e
--- /dev/null
+++ b/mingling_picker/src/parselib/pos_matcher.rs
@@ -0,0 +1,71 @@
+use crate::{matcher_needed::*, parselib::seek_end_of_options};
+
+/// `PositionalMatcher` matches positional arguments — values not associated
+/// with any named flag.
+///
+/// # Rules
+///
+/// * Before `--`: skips any argument that starts with the style's long or short
+///   prefix (those belong to named matchers).
+/// * After `--`: takes **everything** — the `--` marker signals that all
+///   remaining values are positional, even if they look like flags.
+/// * Runs at the lowest priority (see [`PickerArgAttr::Positional`](crate::PickerArgAttr::Positional)).
+pub struct PositionalMatcher;
+
+impl PositionalMatcher {
+    /// Check whether `raw` looks like a named flag (starts with a prefix).
+    #[inline(always)]
+    fn is_flag_like(raw: &str, style: &ParserStyle) -> bool {
+        raw.starts_with(style.long_prefix) || raw.starts_with(style.short_prefix)
+    }
+}
+
+impl Matcher for PositionalMatcher {
+    fn on_match_one(
+        args: &[MaskedArg],
+        style: &ParserStyle,
+        _arg_info: &PickerArgInfo,
+    ) -> Option<usize> {
+        let end = seek_end_of_options(args, style);
+
+        for arg in args {
+            if end.is_some_and(|e| arg.raw_idx == e) {
+                // Hit `--`: everything from here on is positional,
+                // including the first arg after `--`.
+                continue;
+            }
+            if end.is_some_and(|e| arg.raw_idx > e) {
+                // After `--`: accept everything.
+                return Some(arg.raw_idx);
+            }
+            // Before `--`: skip flag-like args.
+            if !Self::is_flag_like(arg.raw, style) {
+                return Some(arg.raw_idx);
+            }
+        }
+
+        None
+    }
+
+    fn on_match_all(
+        args: &[MaskedArg],
+        style: &ParserStyle,
+        _arg_info: &PickerArgInfo,
+    ) -> Vec<usize> {
+        let end = seek_end_of_options(args, style);
+        let mut after_end = false;
+        let mut result = Vec::new();
+
+        for arg in args {
+            if end.is_some_and(|e| arg.raw_idx == e) {
+                after_end = true;
+                continue;
+            }
+            if after_end || !Self::is_flag_like(arg.raw, style) {
+                result.push(arg.raw_idx);
+            }
+        }
+
+        result
+    }
+}
-- 
cgit