router

func BuildMetadataNode ¶

func BuildMetadataNode(parseRouterMetadata Metadata) *runtime.Element

BuildMetadataNode renders route-managed metadata as SSR-safe head children.

The generated tags are marked so the client router can reconcile and clean up only framework-owned metadata during hydration and later navigations.

func BuildRouteService ¶

func BuildRouteService() pluginruntime.RouteService

BuildRouteService returns one native stub route service.

func DecodeQuery ¶

func DecodeQuery[T any](parseValues url.Values) (T, error)

DecodeQuery decodes URL query values into a typed struct T using `query:"name"` tags (falling back to the lowercased field name), then validates the result with the validate package using any `validate:"..."` tags on the same struct. It is the typed-search-params path: read `?page=2&sort=desc` into a struct once, with conversion and validation, instead of scattering `q.Get("page")` + manual strconv + bounds checks across the codebase.

Supported field kinds: string, bool, the sized int/uint kinds, float32/64, and []string (for repeated params). A missing param leaves the field at its zero value — mark it `validate:"required"` to reject that. A malformed value (e.g. page=abc for an int) or an unsupported field kind returns an error; validation failures return the validate.Result (which implements error and carries per-field messages).

type ListQuery struct {
    Page int    `query:"page" validate:"gte=1"`
    Sort string `query:"sort" validate:"omitempty,oneof=asc desc"`
    Tags []string `query:"tag"`
}
q, err := router.DecodeQuery[ListQuery](values) // err is a validate.Result on bad input

func EncodeQuery ¶

func EncodeQuery(parseValue any) url.Values

EncodeQuery renders a typed struct (or a non-nil pointer to one) back into url.Values using the same `query:"name"` tags, skipping zero-valued fields so the resulting URL stays clean. It is the inverse of DecodeQuery, for building links and updating the address bar from typed state. By contract it takes a struct: a non-struct, nil pointer, or other value has no query fields and returns an empty url.Values (it never panics) — DecodeQuery is the validated counterpart, so encoding stays intentionally permissive.

func FragmentHref ¶

func FragmentHref(parseFragment string) string

FragmentHref returns "#<fragment>" on non-browser builds.

func Href ¶

func Href(parsePath string) string

Href returns the path unchanged on non-browser builds (no active router mode to resolve against). The mode-aware implementation lives in the js/wasm build.

func OnNavigate ¶

func OnNavigate(parseFn func(Location)) func()

OnNavigate registers a navigation callback. On non-browser builds there is no live navigation, so it stores nothing and returns a no-op unsubscribe.

func RegisteredRoutes ¶

func RegisteredRoutes() []string

RegisteredRoutes returns a non-nil empty route list outside the browser runtime, where the active router table (and the Router type) are not available. The *Router method lives only in the js/wasm build alongside the type itself.