From d19e5d84ee21502fd3440511d4ffb1ee1f49d3b2 Mon Sep 17 00:00:00 2001
From: 魏曹先生 <1992414357@qq.com>
Date: Wed, 4 Feb 2026 00:27:16 +0800
Subject: Refactor build system and implement complete renderer system

- Split monolithic build.rs into modular async generators
- Add renderer override system with type-safe dispatch
- Implement command template macro for consistent command definitions
- Add proc-macro crates for command and renderer systems
- Reorganize directory structure for better separation of concerns
- Update documentation to reflect new architecture
---
 templates/_commands.rs.template                    | 40 ++++++++++++++++++++++
 .../_override_renderer_dispatcher.rs.template      | 13 +++++++
 templates/_override_renderer_entry.rs.template     | 13 +++++++
 templates/_registry.rs.template                    | 33 ------------------
 templates/_renderers.rs.template                   | 16 ---------
 templates/_specific_renderer_matching.rs.template  | 14 ++++++++
 6 files changed, 80 insertions(+), 49 deletions(-)
 create mode 100644 templates/_commands.rs.template
 create mode 100644 templates/_override_renderer_dispatcher.rs.template
 create mode 100644 templates/_override_renderer_entry.rs.template
 delete mode 100644 templates/_registry.rs.template
 delete mode 100644 templates/_renderers.rs.template
 create mode 100644 templates/_specific_renderer_matching.rs.template

(limited to 'templates')

diff --git a/templates/_commands.rs.template b/templates/_commands.rs.template
new file mode 100644
index 0000000..84d2db4
--- /dev/null
+++ b/templates/_commands.rs.template
@@ -0,0 +1,40 @@
+// Auto generated by build.rs
+use crate::systems::cmd::cmd_system::{JVCommand, JVCommandContext};
+use crate::systems::cmd::errors::CmdProcessError;
+<<LINE>>
+/// Input parameters, execute a command node
+pub async fn jv_cmd_process_node(
+    node: &str,
+    args: Vec<String>,
+    ctx: JVCommandContext,
+    renderer_override: String
+) -> Result<crate::systems::render::renderer::JVRenderResult, crate::systems::cmd::errors::CmdProcessError> {
+    match node {
+// PROCESS
+// -- TEMPLATE START --
+        // Command `<<KEY>>`
+        "<<NODE_NAME>>" => {
+            if renderer_override == "default" {
+                return crate::<<COMMAND_TYPE>>::process_to_render_system(
+                    args, ctx,
+                )
+                .await;
+            } else {
+                return crate::<<COMMAND_TYPE>>::process_to_renderer_override(
+                    args,
+                    ctx,
+                    renderer_override,
+                )
+                .await;
+            }
+        }
+// -- TEMPLATE END --
+        _ => {}
+    }
+    return Err(CmdProcessError::NoNodeFound(node.to_string()));
+}
+<<LINE>>
+/// Get all command nodes
+pub fn jv_cmd_nodes() -> Vec<String> {
+    vec!<<NODES>>
+}
diff --git a/templates/_override_renderer_dispatcher.rs.template b/templates/_override_renderer_dispatcher.rs.template
new file mode 100644
index 0000000..64d2f40
--- /dev/null
+++ b/templates/_override_renderer_dispatcher.rs.template
@@ -0,0 +1,13 @@
+match renderer_override {
+// MATCH
+// -- TEMPLATE START --
+    "<<NAME>>" => {
+        RendererType::render(&concrete_data).await
+    }
+// -- TEMPLATE END --
+    _ => {
+        return Err(CmdProcessError::Render(CmdRenderError::RendererNotFound(
+            renderer_override.to_string(),
+        )));
+    }
+}
diff --git a/templates/_override_renderer_entry.rs.template b/templates/_override_renderer_entry.rs.template
new file mode 100644
index 0000000..06b2c35
--- /dev/null
+++ b/templates/_override_renderer_entry.rs.template
@@ -0,0 +1,13 @@
+// Auto generated by build.rs
+match type_name.as_str() {
+// MATCHING
+// -- TEMPLATE START --
+    "JVOutputTypeName" => {
+        let concrete_data = data
+            .downcast::<JVOutputType>()
+            .map_err(|_| CmdProcessError::DowncastFailed)?;
+        include!("../render/_override_renderer_dispatcher.rs")
+    }
+    _ => return Err(CmdProcessError::NoMatchingCommand),
+// -- TEMPLATE END --
+}
diff --git a/templates/_registry.rs.template b/templates/_registry.rs.template
deleted file mode 100644
index 957484c..0000000
--- a/templates/_registry.rs.template
+++ /dev/null
@@ -1,33 +0,0 @@
-// Auto generated by build.rs
-use crate::systems::cmd::cmd_system::{JVCommand, JVCommandContext};
-use crate::systems::cmd::errors::CmdProcessError;
-<<LINE>>
-/// Input parameters, execute a command node
-pub async fn jv_cmd_process_node(
-    node: &str,
-    args: Vec<String>,
-    ctx: JVCommandContext,
-    renderer_override: String
-) -> Result<crate::systems::cmd::renderer::JVRenderResult, crate::systems::cmd::errors::CmdProcessError> {
-    match node {
-// PROCESS
-// -- TEMPLATE START --
-        // Command `<<KEY>>`
-        "<<NODE_NAME>>" => {
-            return crate::<<COMMAND_TYPE>>::process_with_renderer_flag(
-                args,
-                ctx,
-                renderer_override
-            )
-            .await;
-        }
-// -- TEMPLATE END --
-        _ => {}
-    }
-    return Err(CmdProcessError::NoNodeFound(node.to_string()));
-}
-<<LINE>>
-/// Get all command nodes
-pub fn jv_cmd_nodes() -> Vec<String> {
-    vec!<<NODES>>
-}
diff --git a/templates/_renderers.rs.template b/templates/_renderers.rs.template
deleted file mode 100644
index 37f0f1b..0000000
--- a/templates/_renderers.rs.template
+++ /dev/null
@@ -1,16 +0,0 @@
-match renderer_str {
-// MATCH
-// -- TEMPLATE START --
-    "<<NAME>>" => {
-        Self::process_with_renderer::<
-            RendererType
-        >(args, ctx)
-        .await
-    }
-// -- TEMPLATE END --
-    _ => {
-        return Err(CmdProcessError::Render(CmdRenderError::RendererNotFound(
-            renderer_str.to_string(),
-        )));
-    }
-}
diff --git a/templates/_specific_renderer_matching.rs.template b/templates/_specific_renderer_matching.rs.template
new file mode 100644
index 0000000..9b3765f
--- /dev/null
+++ b/templates/_specific_renderer_matching.rs.template
@@ -0,0 +1,14 @@
+match type_name_str {
+// MATCHING
+// -- TEMPLATE START --
+    "OutputTypeName" => {
+        RendererType::render(
+            &data
+                .downcast::<OutputType>()
+                .unwrap(),
+        )
+        .await
+    }
+// -- TEMPLATE END --
+    _ => Err(CmdRenderError::RendererNotFound(type_name)),
+}
-- 
cgit