From ffd2925b5fb619a91cd66f0e35a518c9077838d4 Mon Sep 17 00:00:00 2001
From: 魏曹先生 <1992414357@qq.com>
Date: Mon, 3 Aug 2026 18:01:56 +0800
Subject: feat(comp): add prefix and suffix methods to Suggest

---
 CHANGELOG.md                      |  7 +++++
 mingling_core/src/comp/suggest.rs | 66 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 73 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index bf51abb..aa80b79 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -70,6 +70,13 @@ None
 
     This enables `prog [PARAM]... <subcommand>` style invocations to resolve the subcommand correctly, while a "broken" path such as `prog -v hello -a someone` still fails to match a `hello someone` node (since `-a someone` lies _after_ the first matched node and participates normally).
 
+4. **[`core:comp`]** Added `add_prefix()` and `add_suffix()` methods to `Suggest` for batch-transforming suggestion text:
+
+    - **`add_prefix(self, prefix: impl Into<String>) -> Suggest`** — Takes the current `Suggest` value and prepends the given prefix to the suggestion text of every item. If the `Suggest` value is `Suggest::FileCompletion`, it is returned unchanged. For example, `["foo", "bar"]` with prefix `"--"` becomes `["--foo", "--bar"]`.
+    - **`add_suffix(self, suffix: impl Into<String>) -> Suggest`** — Takes the current `Suggest` value and appends the given suffix to the suggestion text of every item. If the `Suggest` value is `Suggest::FileCompletion`, it is returned unchanged. For example, `["foo", "bar"]` with suffix `"="` becomes `["foo=", "bar="]`.
+
+    Both methods consume the original `Suggest` value and return a new one, enabling ergonomic chaining with the existing `combine()` method for transforming completion suggestion sets.
+
 #### Optimizations:
 
 1. **[`pathf`]** Added `is_module` field to `AnalyzeItem` and a new constructor `AnalyzeItem::local_module(module, item_name)` which sets `is_module: true`. The `type_mapping_builder` now tracks whether an item is a module: when generating `type_using.rs`, module items produce `use path::to::module::*;` (glob import) instead of the standard `use path::to::TypeName;` direct import. Non-module items continue to use direct imports as before. The internal data structure changed from `Vec<(String, String)>` to `Vec<(String, String, bool)>` to carry the `is_module` flag through the pipeline.
diff --git a/mingling_core/src/comp/suggest.rs b/mingling_core/src/comp/suggest.rs
index dda5026..804d622 100644
--- a/mingling_core/src/comp/suggest.rs
+++ b/mingling_core/src/comp/suggest.rs
@@ -92,6 +92,72 @@ impl Suggest {
             self.insert(SuggestItem::WithDescription(item, desc_str.clone()));
         }
     }
+
+    /// Adds a prefix to every suggestion in the `Suggest` set.
+    ///
+    /// This method takes the current `Suggest` value and prepends the given
+    /// prefix to the suggestion text of each item. If the `Suggest` value is
+    /// [`Suggest::FileCompletion`], it is returned unchanged.
+    ///
+    /// # Arguments
+    ///
+    /// * `prefix` — The string to prepend to each suggestion. Must implement
+    ///   `Into<String>`.
+    ///
+    /// # Returns
+    ///
+    /// A new `Suggest` value where each item's suggestion text is prefixed
+    /// with the given string. For example, `["foo", "bar"]` with prefix `"--"`
+    /// becomes `["--foo", "--bar"]`.
+    pub fn add_prefix(self, prefix: impl Into<String>) -> Suggest {
+        let suggest = match self {
+            Suggest::Suggest(s) => s,
+            Suggest::FileCompletion => return Suggest::FileCompletion,
+        };
+        let prefix = prefix.into();
+        let prefixed = suggest
+            .into_iter()
+            .map(|item| {
+                let mut new_item = item;
+                new_item.set_suggest(format!("{}{}", prefix, new_item.suggest()));
+                new_item
+            })
+            .collect();
+        Suggest::Suggest(prefixed)
+    }
+
+    /// Appends a suffix to every suggestion in the `Suggest` set.
+    ///
+    /// This method takes the current `Suggest` value and appends the given
+    /// suffix to the suggestion text of each item. If the `Suggest` value is
+    /// [`Suggest::FileCompletion`], it is returned unchanged.
+    ///
+    /// # Arguments
+    ///
+    /// * `suffix` — The string to append to each suggestion. Must implement
+    ///   `Into<String>`.
+    ///
+    /// # Returns
+    ///
+    /// A new `Suggest` value where each item's suggestion text is suffixed
+    /// with the given string. For example, `["foo", "bar"]` with suffix `"="`
+    /// becomes `["foo=", "bar="]`.
+    pub fn add_suffix(self, suffix: impl Into<String>) -> Suggest {
+        let suggest = match self {
+            Suggest::Suggest(s) => s,
+            Suggest::FileCompletion => return Suggest::FileCompletion,
+        };
+        let suffix = suffix.into();
+        let suffixed = suggest
+            .into_iter()
+            .map(|item| {
+                let mut new_item = item;
+                new_item.set_suggest(format!("{}{}", new_item.suggest(), suffix));
+                new_item
+            })
+            .collect();
+        Suggest::Suggest(suffixed)
+    }
 }
 
 impl<T> From<T> for Suggest
-- 
cgit