From d3b4027f5926569cb9371b2ea62b6be9387ea650 Mon Sep 17 00:00:00 2001
From: 魏曹先生 <1992414357@qq.com>
Date: Fri, 5 Jun 2026 21:08:07 +0800
Subject: Add example pages and sync-examples tool for docs

---
 examples/example-argument-parse/page.toml      | 10 ++++++++++
 examples/example-async-support/page.toml       | 10 ++++++++++
 examples/example-basic/page.toml               | 10 ++++++++++
 examples/example-clap-binding/page.toml        | 10 ++++++++++
 examples/example-completion/page.toml          | 10 ++++++++++
 examples/example-custom-pickable/page.toml     | 10 ++++++++++
 examples/example-dispatch-tree/page.toml       | 10 ++++++++++
 examples/example-enum-tag/page.toml            | 10 ++++++++++
 examples/example-error-handling/page.toml      | 10 ++++++++++
 examples/example-exitcode/page.toml            | 10 ++++++++++
 examples/example-general-renderer/page.toml    | 10 ++++++++++
 examples/example-help/page.toml                | 10 ++++++++++
 examples/example-hook/page.toml                | 10 ++++++++++
 examples/example-implicit-dispatcher/page.toml | 10 ++++++++++
 examples/example-panic-unwind/page.toml        | 10 ++++++++++
 examples/example-repl-basic/page.toml          | 10 ++++++++++
 examples/example-resources/page.toml           | 10 ++++++++++
 examples/example-setup/page.toml               | 10 ++++++++++
 examples/example-unit-test/page.toml           | 10 ++++++++++
 19 files changed, 190 insertions(+)
 create mode 100644 examples/example-argument-parse/page.toml
 create mode 100644 examples/example-async-support/page.toml
 create mode 100644 examples/example-basic/page.toml
 create mode 100644 examples/example-clap-binding/page.toml
 create mode 100644 examples/example-completion/page.toml
 create mode 100644 examples/example-custom-pickable/page.toml
 create mode 100644 examples/example-dispatch-tree/page.toml
 create mode 100644 examples/example-enum-tag/page.toml
 create mode 100644 examples/example-error-handling/page.toml
 create mode 100644 examples/example-exitcode/page.toml
 create mode 100644 examples/example-general-renderer/page.toml
 create mode 100644 examples/example-help/page.toml
 create mode 100644 examples/example-hook/page.toml
 create mode 100644 examples/example-implicit-dispatcher/page.toml
 create mode 100644 examples/example-panic-unwind/page.toml
 create mode 100644 examples/example-repl-basic/page.toml
 create mode 100644 examples/example-resources/page.toml
 create mode 100644 examples/example-setup/page.toml
 create mode 100644 examples/example-unit-test/page.toml

(limited to 'examples')

diff --git a/examples/example-argument-parse/page.toml b/examples/example-argument-parse/page.toml
new file mode 100644
index 0000000..1a85621
--- /dev/null
+++ b/examples/example-argument-parse/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-argument-parse"
+name = "Argument Parse"
+icon = "📋"
+category = "parsing"
+desc = """
+Example Argument Parse
+"""
+tags = ["pick", "Pickable"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-async-support/page.toml b/examples/example-async-support/page.toml
new file mode 100644
index 0000000..a54ff04
--- /dev/null
+++ b/examples/example-async-support/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-async-support"
+name = "Async Support"
+icon = "⚡"
+category = "runtime"
+desc = """
+Example Async Runtime Support
+"""
+tags = ["async", "tokio"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-basic/page.toml b/examples/example-basic/page.toml
new file mode 100644
index 0000000..a9e1a15
--- /dev/null
+++ b/examples/example-basic/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-basic"
+name = "Basic"
+icon = "🚀"
+category = "core"
+desc = """
+Example The Basic Usage of Mingling
+"""
+tags = ["dispatcher!", "#[chain]", "#[renderer]"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-clap-binding/page.toml b/examples/example-clap-binding/page.toml
new file mode 100644
index 0000000..bd8a9eb
--- /dev/null
+++ b/examples/example-clap-binding/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-clap-binding"
+name = "Clap Binding"
+icon = "🔗"
+category = "parsing"
+desc = """
+Example Clap Binding
+"""
+tags = ["clap"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-completion/page.toml b/examples/example-completion/page.toml
new file mode 100644
index 0000000..029cfb5
--- /dev/null
+++ b/examples/example-completion/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-completion"
+name = "Completion"
+icon = "🔄"
+category = "ux"
+desc = """
+Example Completion
+"""
+tags = ["comp"]
+files = ["src/main.rs", "build.rs", "Cargo.toml"]
diff --git a/examples/example-custom-pickable/page.toml b/examples/example-custom-pickable/page.toml
new file mode 100644
index 0000000..9b6cd05
--- /dev/null
+++ b/examples/example-custom-pickable/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-custom-pickable"
+name = "Custom Pickable"
+icon = "🎯"
+category = "parsing"
+desc = """
+Example Custom Pickable
+"""
+tags = ["Pickable", "custom"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-dispatch-tree/page.toml b/examples/example-dispatch-tree/page.toml
new file mode 100644
index 0000000..220ea16
--- /dev/null
+++ b/examples/example-dispatch-tree/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-dispatch-tree"
+name = "Dispatch Tree"
+icon = "🌳"
+category = "dispatch"
+desc = """
+Example Dispatch Tree
+"""
+tags = ["dispatch_tree"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-enum-tag/page.toml b/examples/example-enum-tag/page.toml
new file mode 100644
index 0000000..01eb9b0
--- /dev/null
+++ b/examples/example-enum-tag/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-enum-tag"
+name = "Enum Tag"
+icon = "🏷️"
+category = "parsing"
+desc = """
+Example Enum Tag
+"""
+tags = ["enum_tag", "Pickable"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-error-handling/page.toml b/examples/example-error-handling/page.toml
new file mode 100644
index 0000000..7c07928
--- /dev/null
+++ b/examples/example-error-handling/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-error-handling"
+name = "Error Handling"
+icon = "⚠️"
+category = "runtime"
+desc = """
+Example Error Handling
+"""
+tags = ["Result"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-exitcode/page.toml b/examples/example-exitcode/page.toml
new file mode 100644
index 0000000..f0be05c
--- /dev/null
+++ b/examples/example-exitcode/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-exitcode"
+name = "Exitcode"
+icon = "🚪"
+category = "runtime"
+desc = """
+Example Error Handling
+"""
+tags = ["ExitCode"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-general-renderer/page.toml b/examples/example-general-renderer/page.toml
new file mode 100644
index 0000000..c07b26a
--- /dev/null
+++ b/examples/example-general-renderer/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-general-renderer"
+name = "General Renderer"
+icon = "📤"
+category = "output"
+desc = """
+Example General Renderer
+"""
+tags = ["general_renderer", "--json", "--yaml"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-help/page.toml b/examples/example-help/page.toml
new file mode 100644
index 0000000..38e3632
--- /dev/null
+++ b/examples/example-help/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-help"
+name = "Help"
+icon = "💡"
+category = "ux"
+desc = """
+Example Help
+"""
+tags = ["#[helper]"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-hook/page.toml b/examples/example-hook/page.toml
new file mode 100644
index 0000000..beca75a
--- /dev/null
+++ b/examples/example-hook/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-hook"
+name = "Hook"
+icon = "🪝"
+category = "runtime"
+desc = """
+Example Hook
+"""
+tags = ["ProgramHook"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-implicit-dispatcher/page.toml b/examples/example-implicit-dispatcher/page.toml
new file mode 100644
index 0000000..2812b79
--- /dev/null
+++ b/examples/example-implicit-dispatcher/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-implicit-dispatcher"
+name = "Implicit Dispatcher"
+icon = "🫥"
+category = "dispatch"
+desc = """
+Example Implicit Dispatcher
+"""
+tags = ["implicit"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-panic-unwind/page.toml b/examples/example-panic-unwind/page.toml
new file mode 100644
index 0000000..8b9a7cd
--- /dev/null
+++ b/examples/example-panic-unwind/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-panic-unwind"
+name = "Panic Unwind"
+icon = "💥"
+category = "runtime"
+desc = """
+Example Panic Unwind
+"""
+tags = ["panic_unwind"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-repl-basic/page.toml b/examples/example-repl-basic/page.toml
new file mode 100644
index 0000000..83d92c0
--- /dev/null
+++ b/examples/example-repl-basic/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-repl-basic"
+name = "REPL Basic"
+icon = "🔁"
+category = "repl"
+desc = """
+Example REPL Basic
+"""
+tags = ["repl"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-resources/page.toml b/examples/example-resources/page.toml
new file mode 100644
index 0000000..0121f8a
--- /dev/null
+++ b/examples/example-resources/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-resources"
+name = "Resources"
+icon = "📦"
+category = "advanced"
+desc = """
+Example Resource Injection
+"""
+tags = ["Resources", "injection"]
+files = ["Cargo.toml", "src/main.rs", "src/lib.rs"]
diff --git a/examples/example-setup/page.toml b/examples/example-setup/page.toml
new file mode 100644
index 0000000..c12443e
--- /dev/null
+++ b/examples/example-setup/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-setup"
+name = "Setup"
+icon = "🏗️"
+category = "core"
+desc = """
+Example Setup
+"""
+tags = ["#[setup]", "extra_macros"]
+files = ["src/main.rs", "Cargo.toml"]
diff --git a/examples/example-unit-test/page.toml b/examples/example-unit-test/page.toml
new file mode 100644
index 0000000..7356cc2
--- /dev/null
+++ b/examples/example-unit-test/page.toml
@@ -0,0 +1,10 @@
+[example]
+id = "example-unit-test"
+name = "Unit Test"
+icon = "🧪"
+category = "testing"
+desc = """
+Example Unit Test
+"""
+tags = ["testing", "extra_macros"]
+files = ["Cargo.toml", "src/main.rs"]
-- 
cgit