package main

import (
    dhuam "github.com/yourcompany/dhuam"
    "github.com/yourcompany/dhuam/middleware"
)

func main() {
    e := dhuam.Default()
    e.Use(middleware.CORS())

    e.GET("/hello/:name", func(c *dhuam.Context) {
        c.String(200, "Hello, %s!", c.Param("name"))
    })

    e.Run(":8080")
}

e := dhuam.Default()

// 基础路由
e.GET("/users", listUsers)
e.POST("/users", createUser)
e.PUT("/users/:id", updateUser)
e.DELETE("/users/:id", deleteUser)

// 路由组
api := e.Group("/api/v1")
api.Use(authMiddleware)
api.GET("/users", listUsers)

// 嵌套路由组
admin := api.Group("/admin")
admin.GET("/dashboard", dashboard)

// 全局中间件
e.Use(middleware.RequestID())
e.Use(middleware.Logger())
e.Use(middleware.Recovery())
e.Use(middleware.CORS())
e.Use(middleware.Secure())
e.Use(middleware.Compress())
e.Use(middleware.RateLimit(100, 200))

// 认证
e.Use(middleware.Auth(func(token string) (bool, error) {
    return validateToken(token), nil
}))

// 路由组中间件
api := e.Group("/api")
api.Use(middleware.RateLimit(50, 100))

// 路径参数
id := c.Param("id")           // /users/:id

// 查询参数
page := c.Query("page")
page := c.DefaultQuery("page", "1")
vals := c.QueryArray("tag")   // ?tag=a&tag=b
val, ok := c.GetQuery("page") // (value, exists)

// 表单
name := c.PostForm("name")
name := c.DefaultPostForm("name", "")
vals := c.PostFormArray("tag")

// 文件上传
file, _ := c.FormFile("upload")
c.SaveUploadedFile(file, "/path/to/save")

// Header
auth := c.GetHeader("Authorization")

// Cookie
val, err := c.Cookie("session")

type CreateUser struct {
    Name  string `json:"name" validate:"required,min=2"`
    Email string `json:"email" validate:"required,email"`
}

// 自动绑定（根据 Content-Type）
var req CreateUser
if err := c.Bind(&req); err != nil {
    return
}

// 指定绑定方式
c.BindJSON(&req)
c.BindXML(&req)
c.BindQuery(&req)    // ?name=xxx&email=xxx
c.BindHeader(&req)   // X-Name: xxx
c.BindUri(&req)      // /users/:id → uri:"id"

// ShouldBind 系列（不自动 Abort）
c.ShouldBindJSON(&req)
c.ShouldBindXML(&req)
c.ShouldBindQuery(&req)
c.ShouldBindHeader(&req)
c.ShouldBindUri(&req)

// 自定义绑定器
c.ShouldBindWith(&req, binding.JSON{})

// 常用响应
dhuam.OK(c, data)              // 200
dhuam.Created(c, data)         // 201
dhuam.NoContent(c)             // 204
dhuam.BadRequest(c, "msg")    // 400
dhuam.Unauthorized(c, "msg")  // 401
dhuam.NotFoundError(c, "msg") // 404

// Context 方法
c.JSON(200, data)              // JSON
c.XML(200, data)               // XML
c.String(200, "hello %s", n)  // 纯文本
c.HTML(200, "<h1>Hi</h1>")    // HTML 字符串
c.Data(200, "image/png", b)   // 原始数据

// 高级 JSON
c.SecureJSON(200, data)        // 防 JSON 劫持
c.AsciiJSON(200, data)         // ASCII JSON
c.PureJSON(200, data)          // 不转义 HTML
c.JSONP(200, "cb", data)       // JSONP

// 文件
c.File("/path/to/file")
c.FileAttachment("/path", "download.pdf")  // 带下载文件名
c.FileFromFS("file.txt", fs)

// 流式
c.SSEvent("message", data)     // Server-Sent Event
c.Stream(func(w io.Writer) bool { ... })

// 其他
c.Redirect(302, "/new")
c.DataFromReader(200, size, "video/mp4", reader, headers)

// 键值存取
c.Set("user", user)
val, _ := c.Get("user")
c.GetString("key")
c.GetInt("key")
c.GetBool("key")
c.GetFloat64("key")
c.GetStringSlice("key")
c.GetStringMap("key")

// 请求信息
c.ClientIP()                    // 客户端 IP
c.ContentType()                 // Content-Type
c.IsAjax()                      // 是否 AJAX
c.IsWebsocket()                 // 是否 WebSocket
c.FullPath()                    // 路由完整路径 /users/:id

// 中间件控制
c.Next()                        // 下一个处理器
c.Abort()                       // 中止
c.AbortWithStatus(403)
c.AbortWithStatusJSON(403, H{"error": "forbidden"})
c.AbortWithError(500, err)

// Context 实现了 context.Context 接口
c.Done()
c.Deadline()
c.Err()
c.Value("key")

e := dhuam.New()

// 加载模板
e.LoadHTMLGlob("templates/*")
e.LoadHTMLFiles("templates/index.html", "templates/about.html")

// 自定义模板函数
e.FuncMap["upper"] = strings.ToUpper
e.LoadHTMLGlob("templates/*")

// 使用模板
e.GET("/", func(c *dhuam.Context) {
    c.HTMLTemplate(200, "index.html", H{"title": "Home"})
})

// 设置自定义 template.Template
tmpl := template.Must(template.New("").ParseGlob("views/*"))
e.SetHTMLTemplate(tmpl)

// 基础用法
e.Static("/assets", "./public")
e.StaticFile("/favicon.ico", "./favicon.ico")
e.StaticFS("/files", http.Dir("./uploads"))

// 高级配置
e.StaticWithConfig(dhuam.StaticConfig{
    Root:                   "./public",
    Prefix:                 "/static",
    EnableDirectoryListing: true,   // 目录列表
    EnableETag:             true,   // ETag 缓存
    EnableCache:            true,   // Cache-Control
    MaxAge:                 3600,   // 缓存 1 小时
    SPAFallback:            true,   // SPA 模式
    DenyPatterns:           []string{".env", ".git"},  // 禁止访问
})

// SPA 模式（快捷方式）
e.StaticSPA("./dist")  // 未匹配路由 → dist/index.html

// 内置日志
e.SetLogger(log.NewDefaultLogger())

// slog
e.SetLogger(log.NewSlogLogger())

// zap
zapLogger, _ := log.NewZapLogger()
e.SetLogger(zapLogger)

// 全局日志
log.Info("Server started on :%d", 8080)
log.Error("Failed: %v", err)

// 实现 Plugin 接口
type Plugin interface {
    Name() string
    Init(e *Engine) error
    Register(e *Engine) error
}

// 可选接口
type PluginWithShutdown interface { Shutdown() error }
type PluginWithMiddleware interface { Middlewares() []HandlerFunc }
type PluginWithRoutes interface { RegisterRoutes(group *RouterGroup) error }

e := dhuam.New()

// 安装内置插件
e.Install(&dhuam.HealthCheckPlugin{
    Path: "/health",
    CheckFunc: func() map[string]interface{} {
        return map[string]interface{}{"db": "ok"}
    },
})

e.Install(&dhuam.CORSPlugin{
    AllowOrigins: []string{"https://example.com"},
})

e.Install(&dhuam.MetricsPlugin{Path: "/metrics"})
e.Install(&dhuam.InfoPlugin{Path: "/info"})

// 自定义插件
type MyPlugin struct{ dhuam.BasePlugin }

func (p *MyPlugin) Name() string { return "my-plugin" }
func (p *MyPlugin) Init(e *dhuam.Engine) error { return nil }
func (p *MyPlugin) Register(e *dhuam.Engine) error { return nil }

// 带中间件的插件
func (p *MyPlugin) Middlewares() []dhuam.HandlerFunc {
    return []dhuam.HandlerFunc{myMiddleware}
}

// 带路由的插件
func (p *MyPlugin) RegisterRoutes(g *dhuam.RouterGroup) error {
    g.GET("/hello", func(c *dhuam.Context) { c.String(200, "hi") })
    return nil
}

// 带关闭钩子的插件
func (p *MyPlugin) Shutdown() error {
    // 清理资源
    return nil
}

e.Install(&MyPlugin{})

// 自定义前缀安装
e.InstallGroup(&MyPlugin{}, "/api/my-plugin")

// 查看已安装插件
plugins := e.Plugins()

// 关闭所有插件
e.ShutdownPlugins()

e := dhuam.New()

// TCP
e.Run(":8080")

// TLS
e.RunTLS(":443", "cert.pem", "key.pem")

// Unix Socket
e.RunUnix("/tmp/dhuam.sock")

// 文件描述符
e.RunFd(3)

// 自定义 Listener
ln, _ := net.Listen("tcp", ":8080")
e.RunListener(ln)

// 优雅关闭
dhuam.RunWithGracefulShutdown(":8080", func(e *dhuam.Engine) {
    e.GET("/", handler)
}, 5*time.Second)

config := &ai.AIConfig{
    DeepSeekKey:  "sk-xxx",
    AnthropicKey: "sk-xxx",
    ZhipuKey:     "xxx.xxx",
    DefaultModel: "deepseek-chat",
}
client := ai.NewClient(config)

config := &ai.AIConfig{
    OllamaBaseURL:  "http://localhost:11434",
    VLLMBaseURL:    "http://localhost:8000",
    LLamaCppBaseURL: "http://localhost:8080",
}

// 非流式
resp, _ := client.Chat(ctx, &ai.ChatRequest{
    Model:    "deepseek-chat",
    Messages: []ai.Message{{Role: "user", Content: "Hello!"}},
})

// 流式
stream, _ := client.ChatStream(ctx, req)
for chunk := range stream { ... }

// 快速对话
answer, _ := client.QuickChat(ctx, "deepseek-chat", "你好")

import "github.com/yourcompany/dhuam/i18n"

// 初始化（默认英文）
i18n.Init(i18n.En)

// 切换为中文
i18n.Init(i18n.Zh)

// 翻译
msg := i18n.T(i18n.MsgNotFound)              // "资源未找到"
msgEN := i18n.Tl(i18n.En, i18n.MsgNotFound)  // "resource not found"

// 注册自定义消息
i18n.RegisterMessages(i18n.Zh, map[i18n.MessageKey]string{
    "welcome": "欢迎",
    "goodbye": "再见",
})

// 支持的语言：en, zh, ja, ko, fr, de, es, ru, ar, pt

// 适配标准 http.Handler 中间件
e.Use(dhuam.WrapMiddleware(cors.Handler(cors.Options{
    AllowedOrigins: []string{"*"},
})))

// 适配标准 http.HandlerFunc
e.Use(dhuam.WrapF(func(w http.ResponseWriter, r *http.Request) {
    w.Header().Set("X-Custom", "value")
}))

// 适配 gorilla/negroni 风格
e.Use(dhuam.FromNegroni(func(w, r, next) {
    // ...
    next(w, r)
}))

// 适配 alice 链
chain := alice.New(mw1, mw2)
e.Use(dhuam.FromAlice(chain))

// 集成第三方路由器
e.GET("/metrics", dhuam.WrapHTTPHandler(promhttp.Handler()))