aboutsummaryrefslogtreecommitdiff
path: root/CHANGELOG.md
diff options
context:
space:
mode:
author魏曹先生 <1992414357@qq.com>2026-08-03 00:27:31 +0800
committer魏曹先生 <1992414357@qq.com>2026-08-03 00:28:29 +0800
commit3668b49c0d3423f1d5d10bb6b4a0e0e7b61f2046 (patch)
treeb006a40678f68c3d9c53a9035ca251596701ecef /CHANGELOG.md
parenteaf1ce9fa63e364774a4685b777cacdbb4f63df6 (diff)
docs: Add preset feature groups and improve feature docs
Add convenience presets (`mini`, `advanced`, `full`, `build_advanced`, `build_full`) to `mingling/Cargo.toml` and document them in both English and Chinese feature docs. Update getting-started guides to reflect the new default `core`/`macros` features.
Diffstat (limited to 'CHANGELOG.md')
-rw-r--r--CHANGELOG.md12
1 files changed, 12 insertions, 0 deletions
diff --git a/CHANGELOG.md b/CHANGELOG.md
index bcb3ec3..baa7f19 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -156,6 +156,18 @@ None
7. **[`core`]** **[`comp`]** Added `Suggest::combine(self, other: impl Into<Suggest>) -> Self` method that merges two `Suggest` values. If both are `Suggest::Suggest`, their inner `BTreeSet`s are merged (all items from `other` are added into `self`). Otherwise, the first `Suggest::Suggest` (or `FileCompletion`) is returned unchanged, and the other value is discarded. This enables ergonomic aggregation of completion suggestions from multiple sources.
+**[`features`]** Added preset feature groups to `mingling/Cargo.toml`, providing convenience combinations for common use cases:
+
+- **`mini`** — `extras`, `picker`. Minimal mode for small CLI tools.
+- **`advanced`** — `extras`, `picker`, `repl`, `comp`, `dispatch_tree`, `structural_renderer`. Full-featured mode for medium-sized applications.
+- **`full`** — `extras`, `picker`, `repl`, `clap`, `comp`, `dispatch_tree`, `structural_renderer_full`, `pathf`. Complete mode for large, feature-comprehensive applications.
+- **`build_advanced`** — `build`, `comp`. Build-time configuration for generating completion scripts etc.
+- **`build_full`** — `build`, `comp`, `pathf`, `dispatch_tree`. Full build-time configuration including the path analyzer.
+
+ `build_advanced` and `build_full` are intended for use in `[build-dependencies]` alongside their corresponding runtime feature groups.
+
+ Also reorganized the `[features]` section of `mingling/Cargo.toml` into logical subsections (Presets, Core, Special features, Features, LEGACY) for improved maintainability and documentation.
+
#### **BREAKING CHANGES** (API CHANGES):
1. **[`macros`]** **[BREAKING]** Renamed the `extra_macros` feature to `extras`. All feature-gated macro re-exports in `mingling/src/lib.rs` (and throughout the codebase) have been updated from `#[cfg(feature = "extra_macros")]` to `#[cfg(feature = "extras")]`.