errors

Overview ¶

Package errors provides structured, actionable error messages for Vango.

The errors package implements a comprehensive error system that:

• Shows exact source locations (file, line, column)
• Explains what went wrong in plain language
• Suggests how to fix issues with code examples
• Links to documentation for deeper understanding

Error Categories ¶

Errors are organized into categories:

• compile: Build-time errors (type mismatches, missing imports)
• runtime: Execution errors (signal read outside component, nil pointer)
• hydration: Server/client mismatch errors
• protocol: Wire protocol errors (invalid messages, connection issues)
• validation: User input errors (form validation, route parameters)

Error Codes ¶

Each error has a unique code (e.g., "E001") that maps to:

• A short message describing the error
• A detailed explanation
• A documentation URL

Usage ¶

err := errors.New("E001").
    WithLocation("app/routes/index.go", 15, 12).
    WithSuggestion("Allocate and read signals inside a vango.Setup() render closure")

fmt.Println(err.Format())
// Output:
// ERROR E001: Signal read outside component context
//
//   app/routes/index.go:15:12
//
//     13 │ func HomePage(p vango.NoProps) vango.Component {
//     14 │     return vango.Setup(p, func(s vango.SetupCtx[vango.NoProps]) vango.RenderFn {
//     15 │         count := setup.Signal(&s, 0)
//   → 16 │         return func() *vango.VNode { return Div(Textf("%d", count.Get())) }
//        │                                                     ^
//     17 │     })
//     18 │ }
//
//   Hint: Allocate signals in Setup and read them in the render closure
//
//   Learn more: https://vango.dev/docs/errors/E001