feat(core): rename `builds` feature to `build`

Replace the `builds` feature with `build` across the crate, keeping
a backward-compatible alias for the old name.  Update all internal
visibility from `#[doc(hidden)] pub mod` to `pub(crate) mod` and
reorganize the `__private` module into a dedicated `private.rs`.

19 files changed, 127 insertions, 107 deletions

diff --git a/.run/version-files.toml b/.run/version-files.toml
index ca104d2..b69a568 100644
--- a/.run/version-files.toml
+++ b/.run/version-files.toml
@@ -17,3 +17,7 @@ pattern = "version = \"{VER}\""
 [[file]]
 file = "./docs/res/guide.txt"
 pattern = "mingling = \"{VER}\""
+
+[[file]]
+file = "./mingling_core/src/lib.rs"
+pattern = "mingling = \"{VER}\""
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ed7ad66..62ec971 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -171,6 +171,13 @@ None
 
     _No migration is required — these are purely additive derives that expand the type's capabilities without affecting existing behavior._
 
+**[`core`]** Added the `build` feature (renamed from `builds`) to `mingling_core` and `mingling`. The old `builds` feature has been deprecated in favor of `build`, with a backward-compatibility alias retained in `mingling/Cargo.toml`:
+
+- **`mingling_core/Cargo.toml`**: Renamed the feature from `builds` to `build`.
+- **`mingling/Cargo.toml`**: Changed the feature dependency from `mingling_core/builds` to `mingling_core/build`. A deprecated `builds` feature alias is kept as `builds = ["mingling_core/build"]` with a note indicating it will be removed in a future breaking change.
+
+    _No behavioral changes — the `build` feature provides identical functionality to the old `builds` feature. Downstream code using `builds` continues to work via the alias, but should migrate to `build`._
+
 #### Features:
 
 1. **[`core`]** Added `RenderResult::new()` method for creating a new `RenderResult` with default values (empty text and exit code 0). This provides a more explicit and discoverable constructor compared to `RenderResult::default()`, making it clearer when a fresh result is being created for use with `write!`/`writeln!`.
diff --git a/GETTING_STARTED.md b/GETTING_STARTED.md
index 621471e..516122e 100644
--- a/GETTING_STARTED.md
+++ b/GETTING_STARTED.md
@@ -239,7 +239,7 @@ In your `build.rs`, generate the shell scripts:
 
 ```rust
 // BUILD TIME
-// Features: ["comp", "builds"]
+// Features: ["comp", "build"]
 mingling::build::build_comp_scripts(env!("CARGO_PKG_NAME")).unwrap();
 ```
 
diff --git a/docs/_zh_CN/pages/advanced/1-completion.md b/docs/_zh_CN/pages/advanced/1-completion.md
index 3941404..a6500db 100644
--- a/docs/_zh_CN/pages/advanced/1-completion.md
+++ b/docs/_zh_CN/pages/advanced/1-completion.md
@@ -15,8 +15,8 @@ features = ["comp"]
 [build-dependencies.mingling]
 features = [
     "comp",
-    # 启用 `builds` 特性以提供构建期支持
-    "builds"
+    # 启用 `build` 特性以提供构建期支持
+    "build"
 ]
 ```
  
diff --git a/docs/pages/advanced/1-completion.md b/docs/pages/advanced/1-completion.md
index a90c3ce..52350db 100644
--- a/docs/pages/advanced/1-completion.md
+++ b/docs/pages/advanced/1-completion.md
@@ -15,8 +15,8 @@ features = ["comp"]
 [build-dependencies.mingling]
 features = [
     "comp",
-    # Enable `builds` for build-time support
-    "builds"
+    # Enable `build` for build-time support
+    "build"
 ]
 ```
  
diff --git a/examples/example-completion/Cargo.toml b/examples/example-completion/Cargo.toml
index 1c6b327..00c7f8c 100644
--- a/examples/example-completion/Cargo.toml
+++ b/examples/example-completion/Cargo.toml
@@ -20,8 +20,8 @@ features = [
     "comp",
 
     # If you want to build completion scripts,
-    # enable `builds` features
-    "builds",
+    # enable `build` features
+    "build",
 ]
 
 [workspace]
diff --git a/examples/example-completion/src/main.rs b/examples/example-completion/src/main.rs
index 45cc8ef..d65be49 100644
--- a/examples/example-completion/src/main.rs
+++ b/examples/example-completion/src/main.rs
@@ -7,7 +7,7 @@
 //! To make your completions work, you need to generate a completion script using Mingling's tools
 //!
 //! 1. Enable features
-//!    You need to enable the `builds` and `comp` features for `mingling` in `[build-dependencies]`
+//!    You need to enable the `build` and `comp` features for `mingling` in `[build-dependencies]`
 //!
 //! 2. Write `build.rs`
 //!    Write the following in `build.rs`
diff --git a/examples/example-pathfinder/Cargo.toml b/examples/example-pathfinder/Cargo.toml
index bd362f2..bc41bd2 100644
--- a/examples/example-pathfinder/Cargo.toml
+++ b/examples/example-pathfinder/Cargo.toml
@@ -18,8 +18,8 @@ features = [
     # Enable `pathf` features
     "pathf",
 
-    # Enable the `builds` feature for build-time support
-    "builds",
+    # Enable the `build` feature for build-time support
+    "build",
 ]
 
 [workspace]
diff --git a/mingling/Cargo.toml b/mingling/Cargo.toml
index 351384f..9bf82a7 100644
--- a/mingling/Cargo.toml
+++ b/mingling/Cargo.toml
@@ -43,7 +43,8 @@ macros = ["dep:mingling_macros", "mingling_macros/default"]
 nightly = ["mingling_core/nightly", "mingling_macros/nightly"]
 debug = ["mingling_core/debug"]
 async = ["mingling_core/async", "mingling_macros/async"]
-builds = ["mingling_core/builds"]
+
+build = ["mingling_core/build"]
 
 default = ["core", "macros"]
 
@@ -92,6 +93,9 @@ extra_macros = ["mingling_macros/extra_macros"]
 # Section only shown in docs.rs
 docs_rs = []
 
+# This is an old name, will be Breaking Change in the future
+builds = ["mingling_core/build"]
+
 [dependencies]
 mingling_core = { workspace = true, optional = true }
 mingling_macros = { workspace = true, optional = true }
diff --git a/mingling_cli/Cargo.toml b/mingling_cli/Cargo.toml
index 906cdd0..330ef5a 100644
--- a/mingling_cli/Cargo.toml
+++ b/mingling_cli/Cargo.toml
@@ -31,7 +31,7 @@ features = [
 [build-dependencies.mingling]
 path = "../mingling"
 features = [
-    "builds",
+    "build",
     "pathf",
 ]
 
diff --git a/mingling_core/Cargo.toml b/mingling_core/Cargo.toml
index 14140c6..f525609 100644
--- a/mingling_core/Cargo.toml
+++ b/mingling_core/Cargo.toml
@@ -14,7 +14,7 @@ categories = ["command-line-interface"]
 nightly = []
 default = []
 async = []
-builds = []
+build = []
 picker = []
 
 dispatch_tree = []
diff --git a/mingling_core/src/any.rs b/mingling_core/src/any.rs
index 3e8fdf0..e922e2e 100644
--- a/mingling_core/src/any.rs
+++ b/mingling_core/src/any.rs
@@ -1,8 +1,8 @@
+use crate::ProgramCollect;
 use crate::error::ChainProcessError;
-use crate::{Grouped, ProgramCollect};
 
-#[doc(hidden)]
-pub mod group;
+mod group;
+pub use group::*;
 
 /// Any type output
 ///
diff --git a/mingling_core/src/asset.rs b/mingling_core/src/asset.rs
index 9b9a5d4..f26952b 100644
--- a/mingling_core/src/asset.rs
+++ b/mingling_core/src/asset.rs
@@ -1,26 +1,9 @@
-#[doc(hidden)]
-pub mod chain;
-
-#[doc(hidden)]
-pub mod dispatcher;
-
-#[doc(hidden)]
-pub mod enum_tag;
-
-#[doc(hidden)]
-pub mod global_resource;
-
-#[doc(hidden)]
-pub mod help;
-
-#[doc(hidden)]
-pub mod lazy_resource;
-
-#[doc(hidden)]
-pub mod node;
-
-#[doc(hidden)]
-pub mod renderer;
-
-#[doc(hidden)]
-pub mod routable;
+pub(crate) mod chain;
+pub(crate) mod dispatcher;
+pub(crate) mod enum_tag;
+pub(crate) mod global_resource;
+pub(crate) mod help;
+pub(crate) mod lazy_resource;
+pub(crate) mod node;
+pub(crate) mod renderer;
+pub(crate) mod routable;
diff --git a/mingling_core/src/build.rs b/mingling_core/src/build.rs
new file mode 100644
index 0000000..7918f3a
--- /dev/null
+++ b/mingling_core/src/build.rs
@@ -0,0 +1,13 @@
+#[doc(hidden)]
+#[cfg(feature = "comp")]
+mod comp;
+
+#[cfg(feature = "comp")]
+pub use comp::*;
+
+#[doc(hidden)]
+#[cfg(feature = "pathf")]
+mod pathf;
+
+#[cfg(feature = "pathf")]
+pub use pathf::*;
diff --git a/mingling_core/src/builds/comp.rs b/mingling_core/src/build/comp.rs
index 2abb1e1..2abb1e1 100644
--- a/mingling_core/src/builds/comp.rs
+++ b/mingling_core/src/build/comp.rs
diff --git a/mingling_core/src/builds/pathf.rs b/mingling_core/src/build/pathf.rs
index d8d4698..d8d4698 100644
--- a/mingling_core/src/builds/pathf.rs
+++ b/mingling_core/src/build/pathf.rs
diff --git a/mingling_core/src/builds.rs b/mingling_core/src/builds.rs
deleted file mode 100644
index 3c52907..0000000
--- a/mingling_core/src/builds.rs
+++ /dev/null
@@ -1,7 +0,0 @@
-#[doc(hidden)]
-#[cfg(feature = "comp")]
-pub mod comp;
-
-#[doc(hidden)]
-#[cfg(feature = "pathf")]
-pub mod pathf;
diff --git a/mingling_core/src/lib.rs b/mingling_core/src/lib.rs
index 31476c9..b9dbd06 100644
--- a/mingling_core/src/lib.rs
+++ b/mingling_core/src/lib.rs
@@ -1,3 +1,4 @@
+// #![deny(missing_docs)]
 //! Mingling Core
 //!
 //! # Intro
@@ -8,7 +9,7 @@
 //!
 //! Recommended to import [mingling](https://crates.io/crates/mingling) to use its features.
 
-#![deny(missing_docs)]
+// Private Modules
 
 mod any;
 mod asset;
@@ -16,20 +17,65 @@ mod program;
 mod renderer;
 mod tester;
 
+/// Module for setting up a `Mingling` program.
+///
+/// This module provides the [`ProgramSetup`] type, which allows users to configure
+/// and initialize the program's execution environment.
+pub mod setup {
+    pub use crate::program::setup::ProgramSetup;
+}
+
+/// This module provides result types for Mingling components.
+///
+/// These are re-exported at the top level via `mingling::res`.
+#[doc(hidden)]
+pub mod core_res {
+    #[cfg(feature = "repl")]
+    pub use crate::program::repl_exec::res::*;
+}
+
+/// Provides the runtime logic for Mingling's dynamic completion system.
+///
+/// This module contains the core functionality for the "comp" (completion) feature,
+/// which enables dynamic tab-completion and input suggestion capabilities within
+/// Mingling applications.
+#[cfg(feature = "comp")]
+pub(crate) mod comp;
+
+/// Provides Mingling's build script module, used in `build.rs` to provide build-time behavior for certain features.
+///
+/// To use it, add the following to your `Cargo.toml` under `[build-dependencies]`, and enable the features
+/// that require build-time behavior from the crate:
+///
+/// ```toml
+/// [build-dependencies.mingling]
+/// version = "0.3.0"
+/// features = [
+///     "build", // Enable it
+///     "comp",  // If you need completion-related build-time behavior, enable this as well
+/// ]
+/// ```
+#[cfg(feature = "build")]
+#[doc(hidden)]
+pub mod build;
+
+// Public Modules
+
 /// Provides a toolkit for `Mingling` testing capabilities.
 pub mod test {
     pub use crate::tester::*;
 }
 
-#[cfg(feature = "structural_renderer")]
-pub use crate::renderer::structural::StructuralRenderer;
+/// Provided for framework developers
+pub mod debug;
 
 // NOT re-exported at top level: the `StructuralData` trait is sealed and only
 // accessible through the derive macro. Users who need the trait can access it
 // via `mingling::renderer::structural::StructuralData` (through the inner alias).
-pub use crate::any::group::*;
-pub use crate::any::*;
+#[cfg(feature = "structural_renderer")]
+pub use crate::renderer::structural::StructuralRenderer;
 
+pub use crate::any::*;
 pub use crate::asset::chain::*;
 pub use crate::asset::dispatcher::*;
 pub use crate::asset::enum_tag::*;
@@ -39,74 +85,32 @@ pub use crate::asset::lazy_resource::*;
 pub use crate::asset::node::*;
 pub use crate::asset::renderer::*;
 pub use crate::asset::routable::*;
+#[cfg(feature = "comp")]
+pub use crate::comp::*;
+pub use crate::program::*;
+pub use crate::renderer::render_result::*;
 
 /// All error types of `Mingling`
 pub mod error {
     pub use crate::asset::chain::error::*;
     pub use crate::exec::error::*;
     pub use crate::program::error::*;
+
     #[cfg(feature = "structural_renderer")]
     pub use crate::renderer::structural::error::*;
-    #[cfg(feature = "pathf")]
-    pub use mingling_pathf::error::*;
-}
-
-pub use crate::program::*;
-
-pub use crate::renderer::render_result::*;
-
-#[cfg(feature = "builds")]
-#[doc(hidden)]
-pub mod builds;
-
-/// Provides build scripts for users
-#[cfg(feature = "builds")]
-pub mod build {
-    #[cfg(feature = "comp")]
-    pub use crate::builds::comp::*;
 
     #[cfg(feature = "pathf")]
-    pub use crate::builds::pathf::*;
+    pub use mingling_pathf::error::*;
 }
 
-/// Provided for framework developers
-pub mod debug;
-
-#[cfg(feature = "comp")]
 #[doc(hidden)]
-pub mod comp;
-
-#[cfg(feature = "comp")]
-pub use crate::comp::*;
+mod private;
 
-/// Module for setting up a `Mingling` program.
+/// Internal API provided by Mingling Core
 ///
-/// This module provides the [`ProgramSetup`] type, which allows users to configure
-/// and initialize the program's execution environment.
-pub mod setup {
-    pub use crate::program::setup::ProgramSetup;
-}
-
-/// Private API — not intended for direct use.
+/// These are used by macros and are not exposed to users, but are still accessible externally.
 #[doc(hidden)]
+#[allow(unused_imports)]
 pub mod __private {
-    use crate::ProgramCollect;
-
-    /// Sealed trait for `StructuralData` — only implementable via derive macro.
-    pub trait StructuralDataSealed<C>
-    where
-        C: ProgramCollect<Enum = C>,
-    {
-    }
-
-    /// Re-export so the derive macro can reference the trait without
-    /// conflicting with the derive macro name at `::mingling::StructuralData`.
-    #[cfg(feature = "structural_renderer")]
-    pub use crate::renderer::structural::structural_data::StructuralData;
-}
-
-#[doc(hidden)]
-pub mod core_res {
-    #[cfg(feature = "repl")]
-    pub use crate::program::repl_exec::res::ResREPL;
+    pub use crate::private::*;
 }
diff --git a/mingling_core/src/private.rs b/mingling_core/src/private.rs
new file mode 100644
index 0000000..371ada2
--- /dev/null
+++ b/mingling_core/src/private.rs
@@ -0,0 +1,12 @@
+/// Sealed trait for `StructuralData` — only implementable via derive macro.
+#[cfg(feature = "structural_renderer")]
+pub trait StructuralDataSealed<C>
+where
+    C: crate::ProgramCollect<Enum = C>,
+{
+}
+
+/// Re-export so the derive macro can reference the trait without
+/// conflicting with the derive macro name at `::mingling::StructuralData`.
+#[cfg(feature = "structural_renderer")]
+pub use crate::renderer::structural::structural_data::StructuralData;