From 0f9ca0745e3e80c751404f45cb2b97d4d14c97d3 Mon Sep 17 00:00:00 2001
From: 魏曹先生 <1992414357@qq.com>
Date: Sat, 1 Aug 2026 22:42:41 +0800
Subject: refactor!: rename `extra_macros` feature to `extras`

Update all references across docs, examples, and configuration files to
use the shorter `extras` feature name.
---
 examples/example-argument-parse/Cargo.toml               | 2 +-
 examples/example-argument-picker/Cargo.toml              | 2 +-
 examples/example-combine-pathf-dispatch-tree/Cargo.toml  | 2 +-
 examples/example-combine-pathf-dispatch-tree/page.toml   | 2 +-
 examples/example-combine-pathf-dispatch-tree/src/main.rs | 2 +-
 examples/example-command-macro/Cargo.toml                | 4 ++--
 examples/example-custom-pickable/Cargo.toml              | 2 +-
 examples/example-implicit-dispatcher/Cargo.toml          | 2 +-
 examples/example-implicit-dispatcher/page.toml           | 2 +-
 examples/example-implicit-dispatcher/src/main.rs         | 2 +-
 examples/example-outside-type/Cargo.toml                 | 2 +-
 examples/example-outside-type/page.toml                  | 2 +-
 examples/example-pack-err/Cargo.toml                     | 2 +-
 examples/example-pack-err/page.toml                      | 2 +-
 examples/example-repl-basic/Cargo.toml                   | 2 +-
 examples/example-setup/Cargo.toml                        | 2 +-
 examples/example-setup/page.toml                         | 2 +-
 examples/example-unit-test/Cargo.toml                    | 2 +-
 examples/example-unit-test/page.toml                     | 2 +-
 examples/full-todolist/Cargo.toml                        | 2 +-
 20 files changed, 21 insertions(+), 21 deletions(-)

(limited to 'examples')

diff --git a/examples/example-argument-parse/Cargo.toml b/examples/example-argument-parse/Cargo.toml
index 401ec38..e08adcd 100644
--- a/examples/example-argument-parse/Cargo.toml
+++ b/examples/example-argument-parse/Cargo.toml
@@ -7,6 +7,6 @@ edition = "2024"
 path = "../../mingling"
 
 # Enable `parser` features
-features = ["parser", "extra_macros"]
+features = ["parser", "extras"]
 
 [workspace]
diff --git a/examples/example-argument-picker/Cargo.toml b/examples/example-argument-picker/Cargo.toml
index 686b95b..779c00b 100644
--- a/examples/example-argument-picker/Cargo.toml
+++ b/examples/example-argument-picker/Cargo.toml
@@ -7,6 +7,6 @@ edition = "2024"
 path = "../../mingling"
 
 # Enable `picker` features
-features = ["picker", "extra_macros"]
+features = ["picker", "extras"]
 
 [workspace]
diff --git a/examples/example-combine-pathf-dispatch-tree/Cargo.toml b/examples/example-combine-pathf-dispatch-tree/Cargo.toml
index 862c5ac..2c866f7 100644
--- a/examples/example-combine-pathf-dispatch-tree/Cargo.toml
+++ b/examples/example-combine-pathf-dispatch-tree/Cargo.toml
@@ -6,7 +6,7 @@ edition = "2024"
 [dependencies]
 mingling = { path = "../../mingling", features = [
     "dispatch_tree",
-    "extra_macros",
+    "extras",
     "pathf",
 ] }
 
diff --git a/examples/example-combine-pathf-dispatch-tree/page.toml b/examples/example-combine-pathf-dispatch-tree/page.toml
index e8f32f2..88557af 100644
--- a/examples/example-combine-pathf-dispatch-tree/page.toml
+++ b/examples/example-combine-pathf-dispatch-tree/page.toml
@@ -6,5 +6,5 @@ category = "advanced"
 desc = """
 Demonstrates combining the `pathf` and `dispatch_tree` features. Types are defined in submodules and automatically resolved. Requires `dispatch_tree` in both `[dependencies]` and `[build-dependencies]`.
 """
-tags = ["pathf", "dispatch_tree", "extra_macros", "build.rs"]
+tags = ["pathf", "dispatch_tree", "extras", "build.rs"]
 files = ["src/main.rs", "src/sub/mod.rs", "build.rs", "Cargo.toml"]
diff --git a/examples/example-combine-pathf-dispatch-tree/src/main.rs b/examples/example-combine-pathf-dispatch-tree/src/main.rs
index 98b3e4c..7407d32 100644
--- a/examples/example-combine-pathf-dispatch-tree/src/main.rs
+++ b/examples/example-combine-pathf-dispatch-tree/src/main.rs
@@ -8,7 +8,7 @@
 //! > AND `[build-dependencies]` so that pathf's builder can detect
 //! > `__internal_dispatcher_*` types needed by the dispatch tree.
 //! >
-//! > Also requires `extra_macros` for the implicit `dispatcher!("hello")` form.
+//! > Also requires `extras` for the implicit `dispatcher!("hello")` form.
 //!
 //! Run:
 //! ```bash
diff --git a/examples/example-command-macro/Cargo.toml b/examples/example-command-macro/Cargo.toml
index b73c2c6..f0596a7 100644
--- a/examples/example-command-macro/Cargo.toml
+++ b/examples/example-command-macro/Cargo.toml
@@ -6,8 +6,8 @@ edition = "2024"
 [dependencies.mingling]
 path = "../../mingling"
 features = [
-    # Use `extra_macros` to introduce the `#[command]` macro
-    "extra_macros",
+    # Use `extras` to introduce the `#[command]` macro
+    "extras",
 
     # Use `picker` to parse arguments
     "picker",
diff --git a/examples/example-custom-pickable/Cargo.toml b/examples/example-custom-pickable/Cargo.toml
index 6e46c8c..9324bd6 100644
--- a/examples/example-custom-pickable/Cargo.toml
+++ b/examples/example-custom-pickable/Cargo.toml
@@ -6,6 +6,6 @@ edition = "2024"
 [dependencies.mingling]
 path = "../../mingling"
 
-features = ["parser", "extra_macros"]
+features = ["parser", "extras"]
 
 [workspace]
diff --git a/examples/example-implicit-dispatcher/Cargo.toml b/examples/example-implicit-dispatcher/Cargo.toml
index 3e68e38..2bfa000 100644
--- a/examples/example-implicit-dispatcher/Cargo.toml
+++ b/examples/example-implicit-dispatcher/Cargo.toml
@@ -5,6 +5,6 @@ edition = "2024"
 
 [dependencies.mingling]
 path = "../../mingling"
-features = ["extra_macros"]
+features = ["extras"]
 
 [workspace]
diff --git a/examples/example-implicit-dispatcher/page.toml b/examples/example-implicit-dispatcher/page.toml
index 4bea717..12f8839 100644
--- a/examples/example-implicit-dispatcher/page.toml
+++ b/examples/example-implicit-dispatcher/page.toml
@@ -4,7 +4,7 @@ name = "Implicit Dispatcher"
 icon = "🫥"
 category = "dispatch"
 desc = """
-Shows the abbreviated `dispatcher!("cmd.path")` syntax from `extra_macros` that auto-derives struct names from the command path.
+Shows the abbreviated `dispatcher!("cmd.path")` syntax from `extras` that auto-derives struct names from the command path.
 """
 tags = ["implicit"]
 files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-implicit-dispatcher/src/main.rs b/examples/example-implicit-dispatcher/src/main.rs
index 3dc7f83..340d585 100644
--- a/examples/example-implicit-dispatcher/src/main.rs
+++ b/examples/example-implicit-dispatcher/src/main.rs
@@ -1,6 +1,6 @@
 //! Example Implicit Dispatcher
 //!
-//! > This example demonstrates how to use the implicit `dispatcher!` definition syntax enabled by `extra_macros`
+//! > This example demonstrates how to use the implicit `dispatcher!` definition syntax enabled by `extras`
 
 use mingling::prelude::*;
 
diff --git a/examples/example-outside-type/Cargo.toml b/examples/example-outside-type/Cargo.toml
index e2ca5ba..19d4e43 100644
--- a/examples/example-outside-type/Cargo.toml
+++ b/examples/example-outside-type/Cargo.toml
@@ -6,7 +6,7 @@ edition = "2024"
 [dependencies.mingling]
 path = "../../mingling"
 features = [
-    "extra_macros",
+    "extras",
 ]
 
 [workspace]
diff --git a/examples/example-outside-type/page.toml b/examples/example-outside-type/page.toml
index 41e543f..df6dfb1 100644
--- a/examples/example-outside-type/page.toml
+++ b/examples/example-outside-type/page.toml
@@ -6,5 +6,5 @@ category = "advanced"
 desc = """
 Demonstrates how to use the `group!()` macro to convert an external type into a type recognizable by Mingling
 """
-tags = ["group!", "extra_macros"]
+tags = ["group!", "extras"]
 files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-pack-err/Cargo.toml b/examples/example-pack-err/Cargo.toml
index 5d61319..ddab6fd 100644
--- a/examples/example-pack-err/Cargo.toml
+++ b/examples/example-pack-err/Cargo.toml
@@ -10,7 +10,7 @@ serde = { version = "1.0.228", features = ["derive"] }
 path = "../../mingling"
 features = [
     "structural_renderer",
-    "extra_macros",
+    "extras",
 ]
 
 [workspace]
diff --git a/examples/example-pack-err/page.toml b/examples/example-pack-err/page.toml
index 37f2c31..7423087 100644
--- a/examples/example-pack-err/page.toml
+++ b/examples/example-pack-err/page.toml
@@ -6,5 +6,5 @@ category = "macros"
 desc = """
 Demonstrates how to use the `pack_err!` macro to define error types with automatic `name` field (snake_case at compile time) and optional `info` field. Also shows `--json` serialization when `structural_renderer` is enabled.
 """
-tags = ["pack_err!", "extra_macros", "structural_renderer", "--json"]
+tags = ["pack_err!", "extras", "structural_renderer", "--json"]
 files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-repl-basic/Cargo.toml b/examples/example-repl-basic/Cargo.toml
index c20deb9..3289939 100644
--- a/examples/example-repl-basic/Cargo.toml
+++ b/examples/example-repl-basic/Cargo.toml
@@ -5,7 +5,7 @@ edition = "2024"
 
 [dependencies.mingling]
 path = "../../mingling"
-features = ["repl", "parser", "extra_macros"]
+features = ["repl", "parser", "extras"]
 
 [dependencies]
 just_fmt = "0.1.2"
diff --git a/examples/example-setup/Cargo.toml b/examples/example-setup/Cargo.toml
index 64a0f4e..17398b7 100644
--- a/examples/example-setup/Cargo.toml
+++ b/examples/example-setup/Cargo.toml
@@ -4,6 +4,6 @@ version = "0.1.0"
 edition = "2024"
 
 [dependencies]
-mingling = { path = "../../mingling", features = ["extra_macros"] }
+mingling = { path = "../../mingling", features = ["extras"] }
 
 [workspace]
diff --git a/examples/example-setup/page.toml b/examples/example-setup/page.toml
index 9c1fc97..1c8667f 100644
--- a/examples/example-setup/page.toml
+++ b/examples/example-setup/page.toml
@@ -6,5 +6,5 @@ category = "core"
 desc = """
 Demonstrates how to build a custom `ProgramSetup` with `#[program_setup]` for modular configuration of program behaviour.
 """
-tags = ["#[setup]", "extra_macros"]
+tags = ["#[setup]", "extras"]
 files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-unit-test/Cargo.toml b/examples/example-unit-test/Cargo.toml
index a735c5c..97a277c 100644
--- a/examples/example-unit-test/Cargo.toml
+++ b/examples/example-unit-test/Cargo.toml
@@ -4,6 +4,6 @@ version = "0.1.0"
 edition = "2024"
 
 [dependencies]
-mingling = { path = "../../mingling", features = ["extra_macros"] }
+mingling = { path = "../../mingling", features = ["extras"] }
 
 [workspace]
diff --git a/examples/example-unit-test/page.toml b/examples/example-unit-test/page.toml
index d8a248c..1d49300 100644
--- a/examples/example-unit-test/page.toml
+++ b/examples/example-unit-test/page.toml
@@ -6,5 +6,5 @@ category = "testing"
 desc = """
 Shows how to write unit tests for Chain and Renderer functions using the `entry!` macro and assertion helpers.
 """
-tags = ["testing", "extra_macros"]
+tags = ["testing", "extras"]
 files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/full-todolist/Cargo.toml b/examples/full-todolist/Cargo.toml
index e10f0e7..9d6f1a7 100644
--- a/examples/full-todolist/Cargo.toml
+++ b/examples/full-todolist/Cargo.toml
@@ -11,7 +11,7 @@ serde_json = "1.0.150"
 path = "../../mingling"
 features = [
     "parser",
-    "extra_macros",
+    "extras",
     "structural_renderer",
 ]
 
-- 
cgit