")
+//line posts.gsx:105:3
+ _gsxgw.Node(ctx, components.Alert(components.AlertProps{Kind: components.AlertError, Msg: errMsg}))
+//line posts.gsx:106:3
+ _gsxgw.Node(ctx, components.Input(components.InputProps{Name: "title", Label: "Title", Value: p.Title, ErrMsg: ""}))
+//line posts.gsx:107:3
+ _gsxgw.Node(ctx, components.Input(components.InputProps{Name: "slug", Label: "Slug (auto if blank)", Value: p.Slug, ErrMsg: ""}))
+//line posts.gsx:113:3
+ _gsxgw.S("")
+//line posts.gsx:114:4
+ _gsxgw.S("Category ")
+//line posts.gsx:115:4
+ _gsxgw.S("")
+//line posts.gsx:119:5
+ _gsxgw.S("— pick one — ")
+//line posts.gsx:120:5
+ for _, c := range cats {
+//line posts.gsx:121:6
+ _gsxgw.S("")
+//line posts.gsx:122:7
+ _gsxgw.Text(string(c.Name))
+ _gsxgw.S(" ")
+ }
+ _gsxgw.S(" ")
+//line posts.gsx:127:3
+ _gsxgw.Node(ctx, components.Textarea(components.TextareaProps{Name: "body", Label: "Body", Value: p.Body, ErrMsg: ""}))
+//line posts.gsx:128:3
+ _gsxgw.S("")
+//line posts.gsx:129:4
+ _gsxgw.S(" ")
+//line posts.gsx:132:3
+ _gsxgw.S("")
+//line posts.gsx:133:4
+ _gsxgw.Node(ctx, components.Button(components.ButtonProps{Label: "Save", Attrs: gsx.Attrs{}.Merge(gsx.Attrs{"type": "submit"})}))
+//line posts.gsx:134:4
+ _gsxgw.S("
Cancel
+ Users
+
+
+
+ { for _, u := range props.Users {
+
+
+ { u.Username }
+ { if u.IsAdmin {
+
+ admin
+
+ } }
+
+
+
+ } }
+
+
+
+
+
+
+}
diff --git a/examples/blog/admin/users.templ b/examples/blog/admin/users.templ
deleted file mode 100644
index b6faa0c..0000000
--- a/examples/blog/admin/users.templ
+++ /dev/null
@@ -1,74 +0,0 @@
-package admin
-
-import (
- "net/http"
-
- "github.com/jackielii/structpages/examples/blog/auth"
- "github.com/jackielii/structpages/examples/blog/store"
- "github.com/jackielii/structpages/examples/blog/ui/components"
- "github.com/jackielii/structpages/examples/blog/ui/layout"
-)
-
-type userListPage struct{}
-
-type userListProps struct {
- User store.User
- Users []store.User
-}
-
-func (userListPage) Props(r *http.Request, s *store.Store) (userListProps, error) {
- user, _ := auth.UserFromContext(r.Context())
- return userListProps{User: user, Users: s.ListUsers()}, nil
-}
-
-templ (p userListPage) Page(props userListProps) {
- @layout.AdminShell("Users", props.User) {
- @p.Content(props)
- }
-}
-
-templ (userListPage) Content(props userListProps) {
- Users
-
- @components.Card("Existing users") {
-
- for _, u := range props.Users {
-
-
- { u.Username }
- if u.IsAdmin {
- admin
- }
-
-
-
- }
-
- }
- @components.Card("Create user") {
-
- }
-
Users ")
+//line users.gsx:28:3
+ _gsxgw.S("")
+//line users.gsx:29:4
+ _gsxgw.Node(ctx, components.Card(components.CardProps{Title: "Existing users", Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line users.gsx:30:5
+ _gsxgw.S("
")
+//line users.gsx:31:6
+ for _, u := range props.Users {
+//line users.gsx:32:7
+ _gsxgw.S("")
+//line users.gsx:33:8
+ _gsxgw.S("")
+//line users.gsx:34:9
+ _gsxgw.Text(string(u.Username))
+//line users.gsx:35:9
+ if u.IsAdmin {
+//line users.gsx:36:10
+ _gsxgw.S("admin ")
+ }
+ _gsxgw.S(" ")
+//line users.gsx:43:8
+ _gsxgw.S(" ")
+ }
+ _gsxgw.S(" ")
+ return _gsxgw.Err()
+ })}))
+//line users.gsx:59:4
+ _gsxgw.Node(ctx, components.Card(components.CardProps{Title: "Create user", Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line users.gsx:60:5
+ _gsxgw.S("
")
+ return _gsxgw.Err()
+ })}))
+ _gsxgw.S("
{ props.Category.Name }
- Posts filed under this category.
-
- if len(props.Posts) == 0 {
-
Nothing here yet.
- }
- for _, post := range props.Posts {
- @PostCard(post)
- }
-
- @components.Pagination(props.Pagination)
-
+component (p categoryPage) Page(props categoryProps) {
+
+ { props.Category.Name }
+
+ Posts filed under this category.
+
+
+ { if len(props.Posts) == 0 {
+
Nothing here yet.
+ } }
+ { for _, post := range props.Posts {
+
+ } }
+ { components.Pagination(props.Pagination) }
+
}
diff --git a/examples/blog/blog/category.x.go b/examples/blog/blog/category.x.go
new file mode 100644
index 0000000..d72660f
--- /dev/null
+++ b/examples/blog/blog/category.x.go
@@ -0,0 +1,95 @@
+// Code generated by gsx; DO NOT EDIT.
+
+package blog
+
+import (
+ "context"
+ "io"
+ "net/http"
+ "strconv"
+
+ "github.com/gsxhq/gsx"
+ "github.com/jackielii/structpages/examples/blog/store"
+ "github.com/jackielii/structpages/examples/blog/ui/components"
+ "github.com/jackielii/structpages/examples/blog/ui/layout"
+)
+
+type categoryPage struct{}
+
+type categoryProps struct {
+ Category store.Category
+ Posts []store.Post
+ Pagination components.PageNav
+}
+
+func (categoryPage) Props(r *http.Request, s *store.Store) (categoryProps, error) {
+ slug := r.PathValue("slug")
+ cat, err := s.GetCategoryBySlug(slug)
+ if err != nil {
+ return categoryProps{}, err
+ }
+ page, _ := strconv.Atoi(r.URL.Query().Get("page"))
+ if page < 1 {
+ page = 1
+ }
+ posts, total := s.ListPosts(store.PostFilter{
+ CategoryID: cat.ID,
+ Page: page,
+ PageSize: store.DefaultPageSize,
+ })
+
+ ctx := r.Context()
+ return categoryProps{
+ Category: cat,
+ Posts: posts,
+ Pagination: components.PageNav{
+ Page: page,
+ PageSize: store.DefaultPageSize,
+ Total: total,
+ URL: func(target int) (string, error) {
+ return components.URL(ctx,
+ []any{categoryPage{}, "?page={page}"},
+ "page", target,
+ )
+ },
+ },
+ }, nil
+}
+
+//line category.gsx:54:1
+func (p categoryPage) Page(props categoryProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line category.gsx:55:2
+ _gsxgw.Node(ctx, layout.PublicShell(layout.PublicShellProps{Title: props.Category.Name, Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line category.gsx:56:3
+ _gsxgw.S("")
+//line category.gsx:56:43
+ _gsxgw.Text(string(props.Category.Name))
+ _gsxgw.S(" ")
+//line category.gsx:57:3
+ _gsxgw.S("Posts filed under this category.
")
+//line category.gsx:60:3
+ _gsxgw.S("")
+//line category.gsx:61:4
+ if len(props.Posts) == 0 {
+//line category.gsx:62:5
+ _gsxgw.S("
Nothing here yet.
")
+ }
+//line category.gsx:64:4
+ for _, post := range props.Posts {
+//line category.gsx:65:5
+ _gsxgw.Node(ctx, PostCard(PostCardProps{P: post}))
+ }
+ _gsxgw.S("
")
+//line category.gsx:68:21
+ _gsxgw.Node(ctx, components.Pagination(props.Pagination))
+ _gsxgw.S("
")
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
diff --git a/examples/blog/blog/components.templ b/examples/blog/blog/components.gsx
similarity index 63%
rename from examples/blog/blog/components.templ
rename to examples/blog/blog/components.gsx
index 500cb42..16b6e9c 100644
--- a/examples/blog/blog/components.templ
+++ b/examples/blog/blog/components.gsx
@@ -1,27 +1,28 @@
-// Feature-local templ components for the public blog. These are templ
+// Feature-local gsx components for the public blog. These are standalone
// functions (not page methods) so other handlers in this package can target
// them via RenderComponent — most notably the comment handler, which
// re-renders CommentsList after a successful POST.
package blog
import (
- "github.com/jackielii/structpages"
"github.com/jackielii/structpages/examples/blog/store"
- "github.com/jackielii/structpages/examples/blog/ui/components"
)
-templ PostMeta(p store.Post) {
+component PostMeta(p store.Post) {
Posted { p.CreatedAt.Format("Jan 2, 2006") }
}
-templ PostCard(p store.Post) {
+component PostCard(p store.Post) {
-
+ url("slug", p.Slug)}
+ >
{ p.Title }
- @PostMeta(p)
+
{ p.Body }
}
@@ -29,19 +30,21 @@ templ PostCard(p store.Post) {
// CommentsList is a standalone function component so the commentHandler
// can re-render it from ServeHTTP via RenderComponent(CommentsList(...)).
// It owns its own wrapper id, which doubles as the HTMX hx-target.
-templ CommentsList(comments []store.Comment) {
-
- if len(comments) == 0 {
-
No comments yet — be the first.
- }
- for _, c := range comments {
+component CommentsList(comments []store.Comment) {
+
}
diff --git a/examples/blog/blog/components.x.go b/examples/blog/blog/components.x.go
new file mode 100644
index 0000000..039cabd
--- /dev/null
+++ b/examples/blog/blog/components.x.go
@@ -0,0 +1,140 @@
+// Code generated by gsx; DO NOT EDIT.
+
+package blog
+
+import (
+ "context"
+ "io"
+ "strconv"
+
+ "github.com/gsxhq/gsx"
+ _gsxf0 "github.com/jackielii/structpages"
+ "github.com/jackielii/structpages/examples/blog/store"
+)
+
+type PostMetaProps struct {
+ P store.Post
+ Attrs gsx.Attrs
+}
+
+//line components.gsx:11:1
+func PostMeta(_gsxp PostMetaProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ p := _gsxp.P
+ _gsxgw := gsx.W(_gsxw)
+//line components.gsx:12:2
+ _gsxgw.S("
Posted ")
+//line components.gsx:13:10
+ _gsxgw.Text(string(p.CreatedAt.Format("Jan 2, 2006")))
+ _gsxgw.S("
")
+ return _gsxgw.Err()
+ })
+}
+
+type PostCardProps struct {
+ P store.Post
+ Attrs gsx.Attrs
+}
+
+//line components.gsx:17:1
+func PostCard(_gsxp PostCardProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ p := _gsxp.P
+ _gsxgw := gsx.W(_gsxw)
+//line components.gsx:18:2
+ _gsxgw.S("
")
+//line components.gsx:19:3
+ _gsxgw.S("")
+//line components.gsx:23:4
+ _gsxgw.Text(string(p.Title))
+ _gsxgw.S(" ")
+//line components.gsx:25:3
+ _gsxgw.Node(ctx, PostMeta(PostMetaProps{P: p}))
+//line components.gsx:26:3
+ _gsxgw.S("")
+//line components.gsx:26:55
+ _gsxgw.Text(string(p.Body))
+ _gsxgw.S("
")
+ return _gsxgw.Err()
+ })
+}
+
+// CommentsList is a standalone function component so the commentHandler
+// can re-render it from ServeHTTP via RenderComponent(CommentsList(...)).
+// It owns its own wrapper id, which doubles as the HTMX hx-target.
+
+type CommentsListProps struct {
+ Comments []store.Comment
+ Attrs gsx.Attrs
+}
+
+//line components.gsx:33:1
+func CommentsList(_gsxp CommentsListProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ comments := _gsxp.Comments
+ _gsxgw := gsx.W(_gsxw)
+//line components.gsx:34:2
+ _gsxgw.S("
")
+//line components.gsx:35:3
+ if len(comments) == 0 {
+//line components.gsx:36:4
+ _gsxgw.S("No comments yet — be the first.
")
+ }
+//line components.gsx:40:3
+ for _, c := range comments {
+//line components.gsx:41:4
+ _gsxgw.S("")
+//line components.gsx:42:5
+ _gsxgw.S("")
+//line components.gsx:43:6
+ _gsxgw.Text(string(c.Author))
+ _gsxgw.S(" · ")
+//line components.gsx:43:22
+ _gsxgw.Text(string(c.CreatedAt.Format("15:04 Jan 2")))
+ _gsxgw.S(" ")
+//line components.gsx:45:5
+ _gsxgw.S("")
+//line components.gsx:45:44
+ _gsxgw.Text(string(c.Body))
+ _gsxgw.S("
")
+ }
+//line components.gsx:48:3
+ _gsxgw.S("Total: ")
+//line components.gsx:48:44
+ _gsxgw.Text(strconv.FormatInt(int64(len(comments)), 10))
+ _gsxgw.S("
+ Recent Posts
+
+ { for _, post := range props.Posts {
+
+ } }
+
+
+
+
+}
diff --git a/examples/blog/blog/home.templ b/examples/blog/blog/home.templ
deleted file mode 100644
index d8be302..0000000
--- a/examples/blog/blog/home.templ
+++ /dev/null
@@ -1,52 +0,0 @@
-package blog
-
-import (
- "net/http"
-
- "github.com/jackielii/structpages/examples/blog/store"
- "github.com/jackielii/structpages/examples/blog/ui/components"
- "github.com/jackielii/structpages/examples/blog/ui/layout"
-)
-
-type homePage struct{}
-
-type homeProps struct {
- Posts []store.Post
- Categories []store.Category
-}
-
-// Props demonstrates the simplest pattern: load data using a DI-injected
-// *store.Store. The framework passes *http.Request and *store.Store by
-// matching parameter types against the registry built in main.
-func (homePage) Props(_ *http.Request, s *store.Store) (homeProps, error) {
- posts, _ := s.ListPosts(store.PostFilter{PageSize: 5})
- return homeProps{Posts: posts, Categories: s.ListCategories()}, nil
-}
-
-// Page wraps the layout for full-document loads. HTMX nav links target
-// #content, which causes structpages to dispatch to Content() instead.
-templ (p homePage) Page(props homeProps) {
- @layout.PublicShell("Home") {
- @p.Content(props)
- }
-}
-
-templ (homePage) Content(props homeProps) {
- Recent Posts
-
- for _, post := range props.Posts {
- @PostCard(post)
- }
-
- @components.Card("Browse by category") {
-
- }
-}
diff --git a/examples/blog/blog/home.x.go b/examples/blog/blog/home.x.go
new file mode 100644
index 0000000..a5def35
--- /dev/null
+++ b/examples/blog/blog/home.x.go
@@ -0,0 +1,82 @@
+// Code generated by gsx; DO NOT EDIT.
+
+package blog
+
+import (
+ "context"
+ "io"
+ "net/http"
+
+ "github.com/gsxhq/gsx"
+ _gsxf0 "github.com/jackielii/structpages"
+ "github.com/jackielii/structpages/examples/blog/store"
+ "github.com/jackielii/structpages/examples/blog/ui/components"
+ "github.com/jackielii/structpages/examples/blog/ui/layout"
+)
+
+type homePage struct{}
+
+type homeProps struct {
+ Posts []store.Post
+ Categories []store.Category
+}
+
+// Props loads page data. Returns homeProps directly — gsx now emits method
+// components as func (p homePage) Page(props homeProps) gsx.Node without a wrapper struct.
+func (homePage) Props(_ *http.Request, s *store.Store) (homeProps, error) {
+ posts, _ := s.ListPosts(store.PostFilter{PageSize: 5})
+ return homeProps{Posts: posts, Categories: s.ListCategories()}, nil
+}
+
+// Page renders the full document. The former Content() method is inlined here:
+// gsx's generated-props wrapping makes a separate Content(props) method
+// undispatchable by structpages alongside Page(props) (both would need the same
+// single Props-return type). See GAP notes.
+
+//line home.gsx:29:1
+func (p homePage) Page(props homeProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line home.gsx:30:2
+ _gsxgw.Node(ctx, layout.PublicShell(layout.PublicShellProps{Title: "Home", Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line home.gsx:31:3
+ _gsxgw.S("Recent Posts ")
+//line home.gsx:32:3
+ _gsxgw.S("")
+//line home.gsx:33:4
+ for _, post := range props.Posts {
+//line home.gsx:34:5
+ _gsxgw.Node(ctx, PostCard(PostCardProps{P: post}))
+ }
+ _gsxgw.S("
")
+//line home.gsx:37:3
+ _gsxgw.Node(ctx, components.Card(components.CardProps{Title: "Browse by category", Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line home.gsx:38:4
+ _gsxgw.S("")
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
diff --git a/examples/blog/blog/post.gsx b/examples/blog/blog/post.gsx
new file mode 100644
index 0000000..cef8761
--- /dev/null
+++ b/examples/blog/blog/post.gsx
@@ -0,0 +1,88 @@
+package blog
+
+import (
+ "net/http"
+
+ "github.com/gsxhq/gsx"
+ "github.com/jackielii/structpages/examples/blog/store"
+ "github.com/jackielii/structpages/examples/blog/ui/components"
+ "github.com/jackielii/structpages/examples/blog/ui/layout"
+)
+
+type postPage struct{}
+
+type postProps struct {
+ Post store.Post
+ Author store.User
+ Category store.Category
+ Comments []store.Comment
+}
+
+func (postPage) Props(r *http.Request, s *store.Store) (postProps, error) {
+ slug := r.PathValue("slug")
+ p, err := s.GetPostBySlug(slug)
+ if err != nil {
+ return postProps{}, err
+ }
+ author, _ := s.GetUser(p.AuthorID)
+ category, _ := s.GetCategory(p.CategoryID)
+ return postProps{
+ Post: p,
+ Author: author,
+ Category: category,
+ Comments: s.ListComments(p.ID),
+ }, nil
+}
+
+component (p postPage) Page(props postProps) {
+
+
+ { props.Post.Title }
+
+ by { props.Author.Username }
+ { if props.Category.Slug != "" {
+ · url("slug", props.Category.Slug)
+ }
+ >
+ { props.Category.Name }
+
+ } }
+
+
+
+
+
+}
diff --git a/examples/blog/blog/post.templ b/examples/blog/blog/post.templ
deleted file mode 100644
index c78f3ab..0000000
--- a/examples/blog/blog/post.templ
+++ /dev/null
@@ -1,72 +0,0 @@
-package blog
-
-import (
- "net/http"
-
- "github.com/jackielii/structpages"
- "github.com/jackielii/structpages/examples/blog/store"
- "github.com/jackielii/structpages/examples/blog/ui/components"
- "github.com/jackielii/structpages/examples/blog/ui/layout"
-)
-
-type postPage struct{}
-
-type postProps struct {
- Post store.Post
- Author store.User
- Category store.Category
- Comments []store.Comment
-}
-
-func (postPage) Props(r *http.Request, s *store.Store) (postProps, error) {
- slug := r.PathValue("slug")
- p, err := s.GetPostBySlug(slug)
- if err != nil {
- return postProps{}, err
- }
- author, _ := s.GetUser(p.AuthorID)
- category, _ := s.GetCategory(p.CategoryID)
- return postProps{
- Post: p,
- Author: author,
- Category: category,
- Comments: s.ListComments(p.ID),
- }, nil
-}
-
-templ (p postPage) Page(props postProps) {
- @layout.PublicShell(props.Post.Title) {
- @p.Content(props)
- }
-}
-
-templ (postPage) Content(props postProps) {
-
- { props.Post.Title }
-
- by { props.Author.Username }
- if props.Category.Slug != "" {
- · { props.Category.Name }
- }
-
-
-
-
- Comments
- @CommentsList(props.Comments)
-
-
-}
diff --git a/examples/blog/blog/post.x.go b/examples/blog/blog/post.x.go
new file mode 100644
index 0000000..7dafc62
--- /dev/null
+++ b/examples/blog/blog/post.x.go
@@ -0,0 +1,119 @@
+// Code generated by gsx; DO NOT EDIT.
+
+package blog
+
+import (
+ "context"
+ "io"
+ "net/http"
+
+ "github.com/gsxhq/gsx"
+ _gsxf0 "github.com/jackielii/structpages"
+ "github.com/jackielii/structpages/examples/blog/store"
+ "github.com/jackielii/structpages/examples/blog/ui/components"
+ "github.com/jackielii/structpages/examples/blog/ui/layout"
+)
+
+type postPage struct{}
+
+type postProps struct {
+ Post store.Post
+ Author store.User
+ Category store.Category
+ Comments []store.Comment
+}
+
+func (postPage) Props(r *http.Request, s *store.Store) (postProps, error) {
+ slug := r.PathValue("slug")
+ p, err := s.GetPostBySlug(slug)
+ if err != nil {
+ return postProps{}, err
+ }
+ author, _ := s.GetUser(p.AuthorID)
+ category, _ := s.GetCategory(p.CategoryID)
+ return postProps{
+ Post: p,
+ Author: author,
+ Category: category,
+ Comments: s.ListComments(p.ID),
+ }, nil
+}
+
+//line post.gsx:37:1
+func (p postPage) Page(props postProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line post.gsx:38:2
+ _gsxgw.Node(ctx, layout.PublicShell(layout.PublicShellProps{Title: props.Post.Title, Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line post.gsx:39:3
+ _gsxgw.S("")
+//line post.gsx:40:4
+ _gsxgw.S("")
+//line post.gsx:40:39
+ _gsxgw.Text(string(props.Post.Title))
+ _gsxgw.S(" ")
+//line post.gsx:41:4
+ _gsxgw.S("by ")
+//line post.gsx:42:8
+ _gsxgw.Text(string(props.Author.Username))
+//line post.gsx:43:5
+ if props.Category.Slug != "" {
+ _gsxgw.S("· ")
+//line post.gsx:44:9
+ _gsxgw.S("")
+//line post.gsx:50:7
+ _gsxgw.Text(string(props.Category.Name))
+ _gsxgw.S(" ")
+ }
+ _gsxgw.S("
")
+//line post.gsx:54:4
+ _gsxgw.S("")
+//line post.gsx:55:5
+ _gsxgw.S("
")
+//line post.gsx:55:8
+ _gsxgw.Text(string(props.Post.Body))
+ _gsxgw.S("
")
+//line post.gsx:58:3
+ _gsxgw.S("")
+//line post.gsx:59:4
+ _gsxgw.S("Comments ")
+//line post.gsx:60:4
+ _gsxgw.Node(ctx, CommentsList(CommentsListProps{Comments: props.Comments}))
+//line post.gsx:61:4
+ _gsxgw.S(" ")
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
diff --git a/examples/blog/blog/search.gsx b/examples/blog/blog/search.gsx
new file mode 100644
index 0000000..afa51fe
--- /dev/null
+++ b/examples/blog/blog/search.gsx
@@ -0,0 +1,75 @@
+package blog
+
+import (
+ "net/http"
+
+ "github.com/jackielii/structpages"
+ "github.com/jackielii/structpages/examples/blog/store"
+ "github.com/jackielii/structpages/examples/blog/ui/layout"
+)
+
+type searchPage struct{}
+
+type searchProps struct {
+ Query string
+ Posts []store.Post
+}
+
+// Props uses RenderTarget to load less when HTMX only wants the results
+// fragment. On the initial page load it returns the full searchProps; when the
+// Results fragment is targeted it renders just that component via RenderComponent.
+func (p searchPage) Props(r *http.Request, s *store.Store, target structpages.RenderTarget) (searchProps, error) {
+ q := r.URL.Query().Get("q")
+ sp := searchProps{Query: q}
+ if q != "" {
+ sp.Posts, _ = s.ListPosts(store.PostFilter{Search: q})
+ }
+ if target.Is(p.Results) {
+ return searchProps{}, structpages.RenderComponent(p.Results(sp))
+ }
+ return sp, nil
+}
+
+component (p searchPage) Page(props searchProps) {
+
+ Search
+
+
+}
+
+component (p searchPage) Results(props searchProps) {
+ id} class="space-y-4">
+ { if props.Query == "" {
+
Type a query to search.
+ } else if len(props.Posts) == 0 {
+
+ No results for "
+ { props.Query }
+ ".
+
+ } else {
+
+ { resultsCount(len(props.Posts)) }
+
+ { for _, post := range props.Posts {
+
+ } }
+ } }
+ Search
-
- @p.Results(props)
-}
-
-templ (searchPage) Results(props searchProps) {
-
- if props.Query == "" {
-
Type a query to search.
- } else if len(props.Posts) == 0 {
-
No results for "{ props.Query }".
- } else {
-
{ resultsCount(len(props.Posts)) }
- for _, post := range props.Posts {
- @PostCard(post)
- }
- }
-
Search ")
+//line search.gsx:36:3
+ _gsxgw.S("")
+//line search.gsx:52:3
+ _gsxgw.Node(ctx, p.Results(props))
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
+
+//line search.gsx:56:1
+func (p searchPage) Results(props searchProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line search.gsx:57:2
+ _gsxgw.S("")
+//line search.gsx:58:3
+ if props.Query == "" {
+//line search.gsx:59:4
+ _gsxgw.S("Type a query to search.
")
+ } else {
+//line search.gsx:60:10
+ if len(props.Posts) == 0 {
+//line search.gsx:61:4
+ _gsxgw.S("No results for \"")
+//line search.gsx:63:5
+ _gsxgw.Text(string(props.Query))
+ _gsxgw.S("\".
")
+ } else {
+//line search.gsx:67:4
+ _gsxgw.S("")
+//line search.gsx:68:5
+ _gsxgw.Text(string(resultsCount(len(props.Posts))))
+ _gsxgw.S("
")
+//line search.gsx:70:4
+ for _, post := range props.Posts {
+//line search.gsx:71:5
+ _gsxgw.Node(ctx, PostCard(PostCardProps{P: post}))
+ }
+ }
+ }
+ _gsxgw.S("")
+ return _gsxgw.Err()
+ })
+}
diff --git a/examples/blog/go.mod b/examples/blog/go.mod
index 863813a..81d1739 100644
--- a/examples/blog/go.mod
+++ b/examples/blog/go.mod
@@ -4,29 +4,11 @@ go 1.26.1
require github.com/jackielii/structpages v0.0.0-00010101000000-000000000000
-require github.com/a-h/templ v0.3.1020 // indirect
-
require (
- github.com/a-h/parse v0.0.0-20250122154542-74294addb73e // indirect
- github.com/andybalholm/brotli v1.1.0 // indirect
- github.com/cenkalti/backoff/v4 v4.3.0 // indirect
- github.com/cli/browser v1.3.0 // indirect
- github.com/fatih/color v1.16.0 // indirect
- github.com/fsnotify/fsnotify v1.7.0 // indirect
github.com/gsxhq/gsx v0.0.0
github.com/jackielii/ctxkey v1.0.1 // indirect
- github.com/mattn/go-colorable v0.1.13 // indirect
- github.com/mattn/go-isatty v0.0.20 // indirect
- github.com/natefinch/atomic v1.0.1 // indirect
- golang.org/x/mod v0.37.0 // indirect
- golang.org/x/net v0.56.0 // indirect
- golang.org/x/sync v0.21.0 // indirect
- golang.org/x/sys v0.46.0 // indirect
- golang.org/x/tools v0.46.0 // indirect
)
replace github.com/jackielii/structpages => ../..
-tool github.com/a-h/templ/cmd/templ
-
replace github.com/gsxhq/gsx => /Users/jackieli/personal/gsxhq/gsx
diff --git a/examples/blog/go.sum b/examples/blog/go.sum
index df0b1bd..2108c87 100644
--- a/examples/blog/go.sum
+++ b/examples/blog/go.sum
@@ -1,45 +1,4 @@
-github.com/a-h/parse v0.0.0-20250122154542-74294addb73e h1:HjVbSQHy+dnlS6C3XajZ69NYAb5jbGNfHanvm1+iYlo=
-github.com/a-h/parse v0.0.0-20250122154542-74294addb73e/go.mod h1:3mnrkvGpurZ4ZrTDbYU84xhwXW2TjTKShSwjRi2ihfQ=
-github.com/a-h/templ v0.3.1020 h1:ypAT/L5ySWEnZ6Zft/5yfoWXYYkhFNvEFOeeqecg4tw=
-github.com/a-h/templ v0.3.1020/go.mod h1:A2DlK61v+K+NRoGnhmYbNYVmtYHcFO5/AisMvBdDxTM=
-github.com/andybalholm/brotli v1.1.0 h1:eLKJA0d02Lf0mVpIDgYnqXcUn0GqVmEFny3VuID1U3M=
-github.com/andybalholm/brotli v1.1.0/go.mod h1:sms7XGricyQI9K10gOSf56VKKWS4oLer58Q+mhRPtnY=
-github.com/cenkalti/backoff/v4 v4.3.0 h1:MyRJ/UdXutAwSAT+s3wNd7MfTIcy71VQueUuFK343L8=
-github.com/cenkalti/backoff/v4 v4.3.0/go.mod h1:Y3VNntkOUPxTVeUxJ/G5vcM//AlwfmyYozVcomhLiZE=
-github.com/cli/browser v1.3.0 h1:LejqCrpWr+1pRqmEPDGnTZOjsMe7sehifLynZJuqJpo=
-github.com/cli/browser v1.3.0/go.mod h1:HH8s+fOAxjhQoBUAsKuPCbqUuxZDhQ2/aD+SzsEfBTk=
-github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
-github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/fatih/color v1.16.0 h1:zmkK9Ngbjj+K0yRhTVONQh1p/HknKYSlNT+vZCzyokM=
-github.com/fatih/color v1.16.0/go.mod h1:fL2Sau1YI5c0pdGEVCbKQbLXB6edEj1ZgiY4NijnWvE=
-github.com/fsnotify/fsnotify v1.7.0 h1:8JEhPFa5W2WU7YfeZzPNqzMP6Lwt7L2715Ggo0nosvA=
-github.com/fsnotify/fsnotify v1.7.0/go.mod h1:40Bi/Hjc2AVfZrqy+aj+yEI+/bRxZnMJyTJwOpGvigM=
github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
github.com/jackielii/ctxkey v1.0.1 h1:CcgbR+fQbrzZJWxI/7Ec4EhzUbmTU1sfI1gV7MAgjIg=
github.com/jackielii/ctxkey v1.0.1/go.mod h1:fo4HOwrvSnc3n8o5qZ5L+FVcSyQn+d67CCnlEbH24uc=
-github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA=
-github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=
-github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM=
-github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
-github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
-github.com/natefinch/atomic v1.0.1 h1:ZPYKxkqQOx3KZ+RsbnP/YsgvxWQPGxjC0oBt2AhwV0A=
-github.com/natefinch/atomic v1.0.1/go.mod h1:N/D/ELrljoqDyT3rZrsUmtsuzvHkeB/wWjHV22AZRbM=
-github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
-github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
-github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
-golang.org/x/mod v0.37.0 h1:vF1DjpVEshcIqoEaauuHebaLk1O1forxjxBaVn884JQ=
-golang.org/x/mod v0.37.0/go.mod h1:m8S8VeM9r4dzDwjrKO0a1sZP3YjeMamRRlD+fmR2Q/0=
-golang.org/x/net v0.56.0 h1:Rw8j/hFzGvJUZwNBXnAtf5sVDVt+65SK2C7IxCxZt5o=
-golang.org/x/net v0.56.0/go.mod h1:D3Ku6r+V6JROoZK144D2XfMHFcMq/0zSfLelVTCFKec=
-golang.org/x/sync v0.21.0 h1:HLII4xRRTtCRkxYp4HNFF0Js/Og6q2i++KXbg0gHCwM=
-golang.org/x/sync v0.21.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
-golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.46.0 h1:noSf2Fq6F8DBgS+LysIkx7rIExoNHJsxOAtPp4rthXw=
-golang.org/x/sys v0.46.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
-golang.org/x/tools v0.46.0 h1:7jTurBkPZu4moS/Uy4OQT1M+QBlsj3wejyZwsT8Z7rk=
-golang.org/x/tools v0.46.0/go.mod h1:FrD85F8l+NWL+9XWBSyVSHO6Ne4jutsfIFba7AWQ5Ys=
-gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
-gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
diff --git a/examples/blog/ui/components/components.templ b/examples/blog/ui/components/components.gsx
similarity index 60%
rename from examples/blog/ui/components/components.templ
rename to examples/blog/ui/components/components.gsx
index 626ed6c..423096b 100644
--- a/examples/blog/ui/components/components.templ
+++ b/examples/blog/ui/components/components.gsx
@@ -2,7 +2,7 @@
// every feature package: buttons, form fields, alerts, cards, pagination,
// and the styled error component used by the global error handler.
//
-// Each function is a standalone templ component (not a method on a page
+// Each function is a standalone gsx component (not a method on a page
// struct). That means they can be addressed by HTMX as targets via their
// kebab-cased name — e.g. hx-target="#pagination" matches Pagination.
package components
@@ -26,90 +26,107 @@ func alertClasses(kind AlertKind) string {
}
}
-templ Alert(kind AlertKind, msg string) {
- if msg != "" {
- { msg }
- }
+component Alert(kind AlertKind, msg string) {
+ { if msg != "" {
+
+ { msg }
+
+ } }
}
-templ Card(title string) {
+component Card(title string) {
- if title != "" {
- { title }
- }
- { children... }
+ { if title != "" {
+
+ { title }
+
+ } }
+ { children }
}
-templ Button(label string, attrs templ.Attributes) {
+// Button takes only its label; any extra attributes (type, hx-*, etc.) fall
+// through to the root automatically — no explicit attrs param.
+component Button(label string) {
{ label }
}
-templ Input(name, label, value, errMsg string) {
+component Input(name, label, value, errMsg string) {
{ label }
{ errMsg }
- }
+ } }
}
-templ Textarea(name, label, value, errMsg string) {
+component Textarea(name, label, value, errMsg string) {
{ label }
- if errMsg != "" {
+ { if errMsg != "" {
{ errMsg }
- }
+ } }
}
// Pagination is rendered as a standalone function component so HTMX requests
// with HX-Target: #pagination resolve here regardless of which page hosts it.
-templ Pagination(p PaginationProps) {
+component Pagination(p PageNav) {
}
// ErrorPage is the full document rendered by main.errorHandler for non-HTMX
// errors. ErrorBlock is the partial used for HTMX requests.
-templ ErrorPage(status int, msg string) {
+component ErrorPage(status int, msg string) {
@@ -119,16 +136,18 @@ templ ErrorPage(status int, msg string) {
- @ErrorBlock(status, msg)
+
}
-templ ErrorBlock(status int, msg string) {
+component ErrorBlock(status int, msg string) {
}
diff --git a/examples/blog/ui/components/components.x.go b/examples/blog/ui/components/components.x.go
new file mode 100644
index 0000000..cf1f0f4
--- /dev/null
+++ b/examples/blog/ui/components/components.x.go
@@ -0,0 +1,348 @@
+// Code generated by gsx; DO NOT EDIT.
+
+package components
+
+import (
+ "context"
+ "io"
+ "strconv"
+
+ "github.com/gsxhq/gsx"
+)
+
+type AlertKind string
+
+const (
+ AlertInfo AlertKind = "info"
+ AlertError AlertKind = "error"
+ AlertSuccess AlertKind = "success"
+)
+
+func alertClasses(kind AlertKind) string {
+ switch kind {
+ case AlertError:
+ return "border-red-200 bg-red-50 text-red-800"
+ case AlertSuccess:
+ return "border-emerald-200 bg-emerald-50 text-emerald-800"
+ default:
+ return "border-slate-200 bg-slate-50 text-slate-800"
+ }
+}
+
+type AlertProps struct {
+ Kind AlertKind
+ Msg string
+}
+
+//line components.gsx:29:1
+func Alert(_gsxp AlertProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ kind := _gsxp.Kind
+ msg := _gsxp.Msg
+ _gsxgw := gsx.W(_gsxw)
+//line components.gsx:30:2
+ if msg != "" {
+//line components.gsx:31:3
+ _gsxgw.S("")
+//line components.gsx:32:4
+ _gsxgw.Text(string(msg))
+ _gsxgw.S("
")
+ }
+ return _gsxgw.Err()
+ })
+}
+
+type CardProps struct {
+ Title string
+ Children gsx.Node
+ Attrs gsx.Attrs
+}
+
+//line components.gsx:37:1
+func Card(_gsxp CardProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ title := _gsxp.Title
+ children := _gsxp.Children
+ _gsxgw := gsx.W(_gsxw)
+//line components.gsx:38:2
+ _gsxgw.S("")
+//line components.gsx:39:3
+ if title != "" {
+//line components.gsx:40:4
+ _gsxgw.S("")
+//line components.gsx:41:5
+ _gsxgw.Text(string(title))
+ _gsxgw.S(" ")
+ }
+//line components.gsx:44:3
+ _gsxgw.Node(ctx, children)
+ _gsxgw.S(" ")
+ return _gsxgw.Err()
+ })
+}
+
+// Button takes only its label; any extra attributes (type, hx-*, etc.) fall
+// through to the root automatically — no explicit attrs param.
+
+type ButtonProps struct {
+ Label string
+ Attrs gsx.Attrs
+}
+
+//line components.gsx:50:1
+func Button(_gsxp ButtonProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ label := _gsxp.Label
+ _gsxgw := gsx.W(_gsxw)
+//line components.gsx:51:2
+ _gsxgw.S("")
+//line components.gsx:54:3
+ _gsxgw.Text(string(label))
+ _gsxgw.S(" ")
+ return _gsxgw.Err()
+ })
+}
+
+type InputProps struct {
+ Name string
+ Label string
+ Value string
+ ErrMsg string
+ Attrs gsx.Attrs
+}
+
+//line components.gsx:58:1
+func Input(_gsxp InputProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ name := _gsxp.Name
+ label := _gsxp.Label
+ value := _gsxp.Value
+ errMsg := _gsxp.ErrMsg
+ _gsxgw := gsx.W(_gsxw)
+//line components.gsx:59:2
+ _gsxgw.S("")
+//line components.gsx:60:3
+ _gsxgw.S("")
+//line components.gsx:60:55
+ _gsxgw.Text(string(label))
+ _gsxgw.S(" ")
+//line components.gsx:61:3
+ _gsxgw.S("")
+//line components.gsx:69:50
+ _gsxgw.Text(string(errMsg))
+ _gsxgw.S(" ")
+ }
+ _gsxgw.S(" ")
+ return _gsxgw.Err()
+ })
+}
+
+type TextareaProps struct {
+ Name string
+ Label string
+ Value string
+ ErrMsg string
+ Attrs gsx.Attrs
+}
+
+//line components.gsx:74:1
+func Textarea(_gsxp TextareaProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ name := _gsxp.Name
+ label := _gsxp.Label
+ value := _gsxp.Value
+ errMsg := _gsxp.ErrMsg
+ _gsxgw := gsx.W(_gsxw)
+//line components.gsx:75:2
+ _gsxgw.S("")
+//line components.gsx:76:3
+ _gsxgw.S("")
+//line components.gsx:76:55
+ _gsxgw.Text(string(label))
+ _gsxgw.S(" ")
+//line components.gsx:77:3
+ _gsxgw.S("")
+//line components.gsx:84:3
+ if errMsg != "" {
+//line components.gsx:85:4
+ _gsxgw.S("")
+//line components.gsx:85:50
+ _gsxgw.Text(string(errMsg))
+ _gsxgw.S(" ")
+ }
+ _gsxgw.S(" ")
+ return _gsxgw.Err()
+ })
+}
+
+// Pagination is rendered as a standalone function component so HTMX requests
+// with HX-Target: #pagination resolve here regardless of which page hosts it.
+
+//line components.gsx:92:1
+func Pagination(p PageNav) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line components.gsx:93:2
+ _gsxgw.S("")
+ return _gsxgw.Err()
+ })
+}
+
+// ErrorPage is the full document rendered by main.errorHandler for non-HTMX
+// errors. ErrorBlock is the partial used for HTMX requests.
+
+type ErrorPageProps struct {
+ Status int
+ Msg string
+}
+
+//line components.gsx:129:1
+func ErrorPage(_gsxp ErrorPageProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ status := _gsxp.Status
+ msg := _gsxp.Msg
+ _gsxgw := gsx.W(_gsxw)
+ _gsxgw.S("")
+//line components.gsx:131:2
+ _gsxgw.S("")
+//line components.gsx:132:3
+ _gsxgw.S("")
+//line components.gsx:133:4
+ _gsxgw.S("Error ")
+//line components.gsx:134:17
+ _gsxgw.Text(strconv.FormatInt(int64(status), 10))
+ _gsxgw.S(" ")
+//line components.gsx:135:4
+ _gsxgw.S("")
+//line components.gsx:137:3
+ _gsxgw.S("")
+//line components.gsx:138:4
+ _gsxgw.S("")
+//line components.gsx:139:5
+ _gsxgw.Node(ctx, ErrorBlock(ErrorBlockProps{Status: status, Msg: msg}))
+ _gsxgw.S(" ")
+ return _gsxgw.Err()
+ })
+}
+
+type ErrorBlockProps struct {
+ Status int
+ Msg string
+ Attrs gsx.Attrs
+}
+
+//line components.gsx:145:1
+func ErrorBlock(_gsxp ErrorBlockProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ status := _gsxp.Status
+ msg := _gsxp.Msg
+ _gsxgw := gsx.W(_gsxw)
+//line components.gsx:146:2
+ _gsxgw.S("")
+//line components.gsx:147:3
+ _gsxgw.S("
")
+//line components.gsx:147:52
+ _gsxgw.Text(strconv.FormatInt(int64(status), 10))
+ _gsxgw.S("
")
+//line components.gsx:148:3
+ _gsxgw.S("
")
+//line components.gsx:148:32
+ _gsxgw.Text(string(msg))
+ _gsxgw.S("
")
+//line components.gsx:149:3
+ _gsxgw.S("
Back to home { title } — structpages blog
+
+
+
+
+
+
+ { children }
+
+
+
+}
+
+// AdminShell wraps the authenticated admin app.
+component AdminShell(title string, current store.User) {
+
+
+
+ Admin — { title }
+
+
+
+
+
+
+ { children }
+
+
+
+}
diff --git a/examples/blog/ui/layout/layout.templ b/examples/blog/ui/layout/layout.templ
deleted file mode 100644
index 4675a1f..0000000
--- a/examples/blog/ui/layout/layout.templ
+++ /dev/null
@@ -1,77 +0,0 @@
-// Package layout exports the shared HTML shells used by every page.
-// Feature packages call PublicShell or AdminShell with { children... }
-// instead of writing their own document.
-package layout
-
-import (
- "github.com/jackielii/structpages"
- "github.com/jackielii/structpages/examples/blog/store"
-)
-
-// PublicShell wraps reader-facing pages. Cross-feature links (e.g. the admin
-// link) use structpages.Ref so this package never imports admin or blog —
-// keeping the dependency graph one-way (features → ui).
-templ PublicShell(title string) {
-
-
-
- { title } — structpages blog
-
-
-
-
-
-
- { children... }
-
-
-
-}
-
-// AdminShell wraps the authenticated admin app.
-templ AdminShell(title string, current store.User) {
-
-
-
- Admin — { title }
-
-
-
-
-
-
- { children... }
-
-
-
-}
diff --git a/examples/blog/ui/layout/layout.x.go b/examples/blog/ui/layout/layout.x.go
new file mode 100644
index 0000000..12462e4
--- /dev/null
+++ b/examples/blog/ui/layout/layout.x.go
@@ -0,0 +1,205 @@
+// Code generated by gsx; DO NOT EDIT.
+
+package layout
+
+import (
+ "context"
+ "io"
+
+ "github.com/gsxhq/gsx"
+ "github.com/jackielii/structpages"
+ _gsxf0 "github.com/jackielii/structpages"
+ "github.com/jackielii/structpages/examples/blog/store"
+)
+
+// PublicShell wraps reader-facing pages. Cross-feature links (e.g. the admin
+// link) use structpages.Ref so this package never imports admin or blog —
+// keeping the dependency graph one-way (features → ui).
+
+type PublicShellProps struct {
+ Title string
+ Children gsx.Node
+}
+
+//line layout.gsx:14:1
+func PublicShell(_gsxp PublicShellProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ title := _gsxp.Title
+ children := _gsxp.Children
+ _gsxgw := gsx.W(_gsxw)
+ _gsxgw.S("")
+//line layout.gsx:16:2
+ _gsxgw.S("")
+//line layout.gsx:17:3
+ _gsxgw.S("")
+//line layout.gsx:18:4
+ _gsxgw.S("")
+//line layout.gsx:23:11
+ _gsxgw.Text(string(title))
+ _gsxgw.S(" — structpages blog ")
+//line layout.gsx:24:4
+ _gsxgw.S("")
+//line layout.gsx:25:4
+ _gsxgw.S("")
+//line layout.gsx:27:3
+ _gsxgw.S("")
+//line layout.gsx:28:4
+ _gsxgw.S("")
+//line layout.gsx:60:4
+ _gsxgw.S("")
+//line layout.gsx:61:5
+ _gsxgw.Node(ctx, children)
+ _gsxgw.S(" ")
+ return _gsxgw.Err()
+ })
+}
+
+// AdminShell wraps the authenticated admin app.
+
+type AdminShellProps struct {
+ Title string
+ Current store.User
+ Children gsx.Node
+}
+
+//line layout.gsx:68:1
+func AdminShell(_gsxp AdminShellProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ title := _gsxp.Title
+ current := _gsxp.Current
+ children := _gsxp.Children
+ _gsxgw := gsx.W(_gsxw)
+ _gsxgw.S("")
+//line layout.gsx:70:2
+ _gsxgw.S("")
+//line layout.gsx:71:3
+ _gsxgw.S("")
+//line layout.gsx:72:4
+ _gsxgw.S("Admin — ")
+//line layout.gsx:77:21
+ _gsxgw.Text(string(title))
+ _gsxgw.S(" ")
+//line layout.gsx:78:4
+ _gsxgw.S("")
+//line layout.gsx:79:4
+ _gsxgw.S("")
+//line layout.gsx:81:3
+ _gsxgw.S("")
+//line layout.gsx:82:4
+ _gsxgw.S("")
+//line layout.gsx:133:4
+ _gsxgw.S("")
+//line layout.gsx:134:5
+ _gsxgw.Node(ctx, children)
+ _gsxgw.S(" ")
+ return _gsxgw.Err()
+ })
+}
diff --git a/examples/htmx-render-target/go.mod b/examples/htmx-render-target/go.mod
index dceb489..b714bd1 100644
--- a/examples/htmx-render-target/go.mod
+++ b/examples/htmx-render-target/go.mod
@@ -4,29 +4,11 @@ go 1.26.1
require github.com/jackielii/structpages v0.0.0
-require github.com/a-h/templ v0.3.1020 // indirect
-
require (
- github.com/a-h/parse v0.0.0-20250122154542-74294addb73e // indirect
- github.com/andybalholm/brotli v1.1.0 // indirect
- github.com/cenkalti/backoff/v4 v4.3.0 // indirect
- github.com/cli/browser v1.3.0 // indirect
- github.com/fatih/color v1.16.0 // indirect
- github.com/fsnotify/fsnotify v1.7.0 // indirect
github.com/gsxhq/gsx v0.0.0
github.com/jackielii/ctxkey v1.0.1 // indirect
- github.com/mattn/go-colorable v0.1.13 // indirect
- github.com/mattn/go-isatty v0.0.20 // indirect
- github.com/natefinch/atomic v1.0.1 // indirect
- golang.org/x/mod v0.37.0 // indirect
- golang.org/x/net v0.56.0 // indirect
- golang.org/x/sync v0.21.0 // indirect
- golang.org/x/sys v0.46.0 // indirect
- golang.org/x/tools v0.46.0 // indirect
)
replace github.com/jackielii/structpages => ../..
-tool github.com/a-h/templ/cmd/templ
-
replace github.com/gsxhq/gsx => /Users/jackieli/personal/gsxhq/gsx
diff --git a/examples/htmx-render-target/go.sum b/examples/htmx-render-target/go.sum
index df0b1bd..2108c87 100644
--- a/examples/htmx-render-target/go.sum
+++ b/examples/htmx-render-target/go.sum
@@ -1,45 +1,4 @@
-github.com/a-h/parse v0.0.0-20250122154542-74294addb73e h1:HjVbSQHy+dnlS6C3XajZ69NYAb5jbGNfHanvm1+iYlo=
-github.com/a-h/parse v0.0.0-20250122154542-74294addb73e/go.mod h1:3mnrkvGpurZ4ZrTDbYU84xhwXW2TjTKShSwjRi2ihfQ=
-github.com/a-h/templ v0.3.1020 h1:ypAT/L5ySWEnZ6Zft/5yfoWXYYkhFNvEFOeeqecg4tw=
-github.com/a-h/templ v0.3.1020/go.mod h1:A2DlK61v+K+NRoGnhmYbNYVmtYHcFO5/AisMvBdDxTM=
-github.com/andybalholm/brotli v1.1.0 h1:eLKJA0d02Lf0mVpIDgYnqXcUn0GqVmEFny3VuID1U3M=
-github.com/andybalholm/brotli v1.1.0/go.mod h1:sms7XGricyQI9K10gOSf56VKKWS4oLer58Q+mhRPtnY=
-github.com/cenkalti/backoff/v4 v4.3.0 h1:MyRJ/UdXutAwSAT+s3wNd7MfTIcy71VQueUuFK343L8=
-github.com/cenkalti/backoff/v4 v4.3.0/go.mod h1:Y3VNntkOUPxTVeUxJ/G5vcM//AlwfmyYozVcomhLiZE=
-github.com/cli/browser v1.3.0 h1:LejqCrpWr+1pRqmEPDGnTZOjsMe7sehifLynZJuqJpo=
-github.com/cli/browser v1.3.0/go.mod h1:HH8s+fOAxjhQoBUAsKuPCbqUuxZDhQ2/aD+SzsEfBTk=
-github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
-github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/fatih/color v1.16.0 h1:zmkK9Ngbjj+K0yRhTVONQh1p/HknKYSlNT+vZCzyokM=
-github.com/fatih/color v1.16.0/go.mod h1:fL2Sau1YI5c0pdGEVCbKQbLXB6edEj1ZgiY4NijnWvE=
-github.com/fsnotify/fsnotify v1.7.0 h1:8JEhPFa5W2WU7YfeZzPNqzMP6Lwt7L2715Ggo0nosvA=
-github.com/fsnotify/fsnotify v1.7.0/go.mod h1:40Bi/Hjc2AVfZrqy+aj+yEI+/bRxZnMJyTJwOpGvigM=
github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
github.com/jackielii/ctxkey v1.0.1 h1:CcgbR+fQbrzZJWxI/7Ec4EhzUbmTU1sfI1gV7MAgjIg=
github.com/jackielii/ctxkey v1.0.1/go.mod h1:fo4HOwrvSnc3n8o5qZ5L+FVcSyQn+d67CCnlEbH24uc=
-github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA=
-github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=
-github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM=
-github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
-github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
-github.com/natefinch/atomic v1.0.1 h1:ZPYKxkqQOx3KZ+RsbnP/YsgvxWQPGxjC0oBt2AhwV0A=
-github.com/natefinch/atomic v1.0.1/go.mod h1:N/D/ELrljoqDyT3rZrsUmtsuzvHkeB/wWjHV22AZRbM=
-github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
-github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
-github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
-golang.org/x/mod v0.37.0 h1:vF1DjpVEshcIqoEaauuHebaLk1O1forxjxBaVn884JQ=
-golang.org/x/mod v0.37.0/go.mod h1:m8S8VeM9r4dzDwjrKO0a1sZP3YjeMamRRlD+fmR2Q/0=
-golang.org/x/net v0.56.0 h1:Rw8j/hFzGvJUZwNBXnAtf5sVDVt+65SK2C7IxCxZt5o=
-golang.org/x/net v0.56.0/go.mod h1:D3Ku6r+V6JROoZK144D2XfMHFcMq/0zSfLelVTCFKec=
-golang.org/x/sync v0.21.0 h1:HLII4xRRTtCRkxYp4HNFF0Js/Og6q2i++KXbg0gHCwM=
-golang.org/x/sync v0.21.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
-golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.46.0 h1:noSf2Fq6F8DBgS+LysIkx7rIExoNHJsxOAtPp4rthXw=
-golang.org/x/sys v0.46.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
-golang.org/x/tools v0.46.0 h1:7jTurBkPZu4moS/Uy4OQT1M+QBlsj3wejyZwsT8Z7rk=
-golang.org/x/tools v0.46.0/go.mod h1:FrD85F8l+NWL+9XWBSyVSHO6Ne4jutsfIFba7AWQ5Ys=
-gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
-gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
diff --git a/examples/htmx-render-target/pages.gsx b/examples/htmx-render-target/pages.gsx
new file mode 100644
index 0000000..72149c8
--- /dev/null
+++ b/examples/htmx-render-target/pages.gsx
@@ -0,0 +1,175 @@
+package main
+
+// Shared standalone function components (can be used across multiple pages).
+// These demonstrate the power of RenderTarget — no wrapper methods needed.
+
+component UserStatsWidget(stats UserStats) {
+
+}
+
+component SalesChartWidget(data SalesData) {
+
+}
+
+component NotificationsList(notifications []Notification) {
+
+}
+
+// Dashboard page.
+
+type dashboard struct{}
+
+component (p dashboard) Page(props dashboardData) {
+
+ Dashboard
+
+ This example demonstrates the RenderTarget API with standalone function components.
+
+
+ Click "Refresh" buttons to see HTMX partial updates — each widget loads only its own data!
+
+
+
id}>
+
+
id}>
+
+
id}>
+
+
+
+
How it works:
+
+
+ ✅
+ Standalone functions
+ — UserStatsWidget, SalesChartWidget, NotificationsList are shared components
+
+
+ ✅
+ Conditional loading
+ — Props checks target.Is() and loads only needed data
+
+
+ ✅
+ RenderComponent (direct)
+ — construct the gsx component with its props struct and pass directly
+
+
+ ✅
+ No wrapper methods
+ — No need to create dashboard.UserStats() method!
+
+
+ ✅
+ HTMX integration
+ — HTMXRenderTarget automatically handles partial updates
+
+
+
RenderTarget API Example
+
+
+
+ { children }
+
+
+
+}
+
+component ErrorPage(err error) {
+
+
+
+}
+
+component ErrorComp(err error) {
+ Error
+ { err.Error() }
+}
diff --git a/examples/htmx-render-target/pages.templ b/examples/htmx-render-target/pages.templ
deleted file mode 100644
index 9cb3b90..0000000
--- a/examples/htmx-render-target/pages.templ
+++ /dev/null
@@ -1,270 +0,0 @@
-package main
-
-import (
- "context"
- "fmt"
- "math/rand/v2"
- "net/http"
- "time"
-
- "github.com/jackielii/structpages"
-)
-
-// Shared standalone function components (can be used across multiple pages)
-// These demonstrate the power of RenderTarget - no need for wrapper methods!
-templ UserStatsWidget(stats UserStats) {
-
-}
-
-templ SalesChartWidget(data SalesData) {
-
-}
-
-templ NotificationsList(notifications []Notification) {
-
-}
-
-// Dashboard page using RenderTarget API
-
-type dashboard struct{}
-
-type DashboardProps struct {
- Stats UserStats
- Sales SalesData
- Notifications []Notification
-}
-
-type UserStats struct {
- ActiveUsers int
- NewToday int
-}
-
-type SalesData struct {
- Points []DataPoint
- Total float64
-}
-
-type DataPoint struct {
- Label string
- Value int
-}
-
-type Notification struct {
- Message string
- Time time.Time
-}
-
-// Props demonstrates conditional data loading with RenderTarget
-func (p dashboard) Props(r *http.Request, target structpages.RenderTarget) (DashboardProps, error) {
- // Check which component is being requested and load only necessary data
- switch {
- case target.Is(UserStatsWidget):
- // Only load user stats (lightweight query)
- stats := loadUserStats()
- comp := UserStatsWidget(stats)
- // Use RenderComponent with target to render just this widget
- return DashboardProps{}, structpages.RenderComponent(comp)
-
- case target.Is(SalesChartWidget):
- // Only load sales data (expensive query - avoid loading unnecessarily)
- sales := loadSalesData()
- return DashboardProps{}, structpages.RenderComponent(target, sales)
-
- case target.Is(NotificationsList):
- // Only load notifications
- notifications := loadNotifications()
- return DashboardProps{}, structpages.RenderComponent(target, notifications)
-
- case target.Is(p.Page):
- // Full page load - load all data
- return DashboardProps{
- Stats: loadUserStats(),
- Sales: loadSalesData(),
- Notifications: loadNotifications(),
- }, nil
-
- default:
- // Fallback to full page
- return DashboardProps{
- Stats: loadUserStats(),
- Sales: loadSalesData(),
- Notifications: loadNotifications(),
- }, nil
- }
-}
-
-templ (p dashboard) Page(props DashboardProps) {
- @html() {
- Dashboard
- This example demonstrates the new RenderTarget API with standalone function components.
- Click "Refresh" buttons to see HTMX partial updates - each widget loads only its own data!
-
-
- @UserStatsWidget(props.Stats)
-
-
- @SalesChartWidget(props.Sales)
-
-
- @NotificationsList(props.Notifications)
-
-
-
How it works:
-
- ✅ Standalone functions - UserStatsWidget, SalesChartWidget, NotificationsList are shared components
- ✅ Conditional loading - Props checks target.Is() and loads only needed data
- ✅ RenderComponent - Passes specific data to each widget
- ✅ No wrapper methods - No need to create dashboard.UserStats() method!
- ✅ HTMX integration - HTMXRenderTarget automatically handles partial updates
-
-
RenderTarget API Example
-
-
-
-
- { children... }
-
-
-
-}
-
-// Error handling
-templ errorPage(err error) {
- @html() {
- @errorComp(err)
- }
-}
-
-templ errorComp(err error) {
- Error
- { err.Error() }
-}
-
-// Helper functions
-func urlFor(ctx context.Context, page any, args ...any) (string, error) {
- s, err := structpages.URLFor(ctx, page, args...)
- return s, err
-}
-
-func idFor(ctx context.Context, v any) (string, error) {
- return structpages.ID(ctx, v)
-}
-
-func idForTarget(ctx context.Context, v any) (string, error) {
- return structpages.IDTarget(ctx, v)
-}
diff --git a/examples/htmx-render-target/pages.x.go b/examples/htmx-render-target/pages.x.go
new file mode 100644
index 0000000..85c5820
--- /dev/null
+++ b/examples/htmx-render-target/pages.x.go
@@ -0,0 +1,316 @@
+// Code generated by gsx; DO NOT EDIT.
+
+package main
+
+import (
+ "context"
+ "io"
+ "strconv"
+
+ "github.com/gsxhq/gsx"
+ _gsxstd "github.com/gsxhq/gsx/std"
+ _gsxf0 "github.com/jackielii/structpages"
+)
+
+// Shared standalone function components (can be used across multiple pages).
+// These demonstrate the power of RenderTarget — no wrapper methods needed.
+
+//line pages.gsx:6:1
+func UserStatsWidget(stats UserStats) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:7:2
+ _gsxgw.S("")
+ return _gsxgw.Err()
+ })
+}
+
+//line pages.gsx:21:1
+func SalesChartWidget(data SalesData) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:22:2
+ _gsxgw.S("")
+ return _gsxgw.Err()
+ })
+}
+
+type NotificationsListProps struct {
+ Notifications []Notification
+ Attrs gsx.Attrs
+}
+
+//line pages.gsx:44:1
+func NotificationsList(_gsxp NotificationsListProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ notifications := _gsxp.Notifications
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:45:2
+ _gsxgw.S("")
+//line pages.gsx:46:3
+ _gsxgw.S("
Recent Notifications ")
+//line pages.gsx:47:3
+ _gsxgw.S("
")
+//line pages.gsx:48:4
+ for _, n := range notifications {
+//line pages.gsx:49:5
+ _gsxgw.S("")
+//line pages.gsx:50:6
+ _gsxgw.Text(string(n.Message))
+ _gsxgw.S(" ")
+//line pages.gsx:50:20
+ _gsxgw.S("(")
+//line pages.gsx:50:28
+ _gsxgw.Text(string(n.Time.Format("15:04")))
+ _gsxgw.S(") ")
+ }
+ _gsxgw.S(" ")
+//line pages.gsx:54:3
+ _gsxgw.S("
Refresh Notifications Dashboard ")
+//line pages.gsx:71:3
+ _gsxgw.S("This example demonstrates the RenderTarget API with standalone function components.
")
+//line pages.gsx:74:3
+ _gsxgw.S("Click \"Refresh\" buttons to see HTMX partial updates — each widget loads only its own data!
")
+//line pages.gsx:77:3
+ _gsxgw.S("")
+//line pages.gsx:80:4
+ _gsxgw.S("
")
+//line pages.gsx:81:5
+ _gsxgw.Node(ctx, UserStatsWidget(props.Stats))
+ _gsxgw.S(" ")
+//line pages.gsx:84:5
+ _gsxgw.Node(ctx, SalesChartWidget(props.Sales))
+ _gsxgw.S("")
+//line pages.gsx:86:4
+ _gsxgw.S("")
+//line pages.gsx:87:5
+ _gsxgw.Node(ctx, NotificationsList(NotificationsListProps{Notifications: props.Notifications}))
+ _gsxgw.S("")
+//line pages.gsx:90:3
+ _gsxgw.S("")
+//line pages.gsx:93:4
+ _gsxgw.S("
How it works: ")
+//line pages.gsx:94:4
+ _gsxgw.S("
")
+//line pages.gsx:95:5
+ _gsxgw.S("✅ ")
+//line pages.gsx:96:10
+ _gsxgw.S("Standalone functions — UserStatsWidget, SalesChartWidget, NotificationsList are shared components ")
+//line pages.gsx:100:5
+ _gsxgw.S("✅ ")
+//line pages.gsx:101:10
+ _gsxgw.S("Conditional loading — Props checks target.Is() and loads only needed data ")
+//line pages.gsx:105:5
+ _gsxgw.S("✅ ")
+//line pages.gsx:106:10
+ _gsxgw.S("RenderComponent (direct) — construct the gsx component with its props struct and pass directly ")
+//line pages.gsx:110:5
+ _gsxgw.S("✅ ")
+//line pages.gsx:111:10
+ _gsxgw.S("No wrapper methods — No need to create dashboard.UserStats() method! ")
+//line pages.gsx:115:5
+ _gsxgw.S("✅ ")
+//line pages.gsx:116:10
+ _gsxgw.S("HTMX integration — HTMXRenderTarget automatically handles partial updates RenderTarget API Example ")
+//line pages.gsx:133:4
+ _gsxgw.S("")
+//line pages.gsx:151:3
+ _gsxgw.S("")
+//line pages.gsx:152:4
+ _gsxgw.S("")
+//line pages.gsx:152:10
+ _gsxgw.Node(ctx, children)
+ _gsxgw.S(" ")
+//line pages.gsx:153:4
+ _gsxgw.S("")
+ return _gsxgw.Err()
+ })
+}
+
+type ErrorPageProps struct {
+ Err error
+}
+
+//line pages.gsx:166:1
+func ErrorPage(_gsxp ErrorPageProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ err := _gsxp.Err
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:167:2
+ _gsxgw.Node(ctx, Html(HtmlProps{Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:168:3
+ _gsxgw.Node(ctx, ErrorComp(ErrorCompProps{Err: err}))
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
+
+type ErrorCompProps struct {
+ Err error
+}
+
+//line pages.gsx:172:1
+func ErrorComp(_gsxp ErrorCompProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ err := _gsxp.Err
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:173:2
+ _gsxgw.S("Error ")
+//line pages.gsx:174:2
+ _gsxgw.S("")
+//line pages.gsx:174:5
+ _gsxgw.Text(string(err.Error()))
+ _gsxgw.S("
")
+ return _gsxgw.Err()
+ })
+}
diff --git a/examples/htmx/go.mod b/examples/htmx/go.mod
index 922fd71..8cbbdda 100644
--- a/examples/htmx/go.mod
+++ b/examples/htmx/go.mod
@@ -5,34 +5,10 @@ go 1.26.1
require github.com/jackielii/structpages v0.0.0-00010101000000-000000000000
require (
- github.com/a-h/templ v0.3.1020 // indirect
- github.com/tdewolff/parse/v2 v2.8.13 // indirect
-)
-
-require (
- github.com/a-h/parse v0.0.0-20250122154542-74294addb73e // indirect
- github.com/andybalholm/brotli v1.1.0 // indirect
- github.com/cenkalti/backoff/v4 v4.3.0 // indirect
- github.com/cli/browser v1.3.0 // indirect
- github.com/fatih/color v1.16.0 // indirect
- github.com/fsnotify/fsnotify v1.7.0 // indirect
github.com/gsxhq/gsx v0.0.0
github.com/jackielii/ctxkey v1.0.1 // indirect
- github.com/mattn/go-colorable v0.1.13 // indirect
- github.com/mattn/go-isatty v0.0.20 // indirect
- github.com/natefinch/atomic v1.0.1 // indirect
- golang.org/x/mod v0.37.0 // indirect
- golang.org/x/net v0.56.0 // indirect
- golang.org/x/sync v0.21.0 // indirect
- golang.org/x/sys v0.46.0 // indirect
- golang.org/x/tools v0.46.0 // indirect
)
replace github.com/jackielii/structpages => ../..
-tool (
- github.com/a-h/templ/cmd/templ
- github.com/gsxhq/gsx/cmd/gsx
-)
-
replace github.com/gsxhq/gsx => ../../../gsxhq/gsx
diff --git a/examples/htmx/go.sum b/examples/htmx/go.sum
index c04a9f5..2108c87 100644
--- a/examples/htmx/go.sum
+++ b/examples/htmx/go.sum
@@ -1,48 +1,4 @@
-github.com/a-h/parse v0.0.0-20250122154542-74294addb73e h1:HjVbSQHy+dnlS6C3XajZ69NYAb5jbGNfHanvm1+iYlo=
-github.com/a-h/parse v0.0.0-20250122154542-74294addb73e/go.mod h1:3mnrkvGpurZ4ZrTDbYU84xhwXW2TjTKShSwjRi2ihfQ=
-github.com/a-h/templ v0.3.1020 h1:ypAT/L5ySWEnZ6Zft/5yfoWXYYkhFNvEFOeeqecg4tw=
-github.com/a-h/templ v0.3.1020/go.mod h1:A2DlK61v+K+NRoGnhmYbNYVmtYHcFO5/AisMvBdDxTM=
-github.com/andybalholm/brotli v1.1.0 h1:eLKJA0d02Lf0mVpIDgYnqXcUn0GqVmEFny3VuID1U3M=
-github.com/andybalholm/brotli v1.1.0/go.mod h1:sms7XGricyQI9K10gOSf56VKKWS4oLer58Q+mhRPtnY=
-github.com/cenkalti/backoff/v4 v4.3.0 h1:MyRJ/UdXutAwSAT+s3wNd7MfTIcy71VQueUuFK343L8=
-github.com/cenkalti/backoff/v4 v4.3.0/go.mod h1:Y3VNntkOUPxTVeUxJ/G5vcM//AlwfmyYozVcomhLiZE=
-github.com/cli/browser v1.3.0 h1:LejqCrpWr+1pRqmEPDGnTZOjsMe7sehifLynZJuqJpo=
-github.com/cli/browser v1.3.0/go.mod h1:HH8s+fOAxjhQoBUAsKuPCbqUuxZDhQ2/aD+SzsEfBTk=
-github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
-github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/fatih/color v1.16.0 h1:zmkK9Ngbjj+K0yRhTVONQh1p/HknKYSlNT+vZCzyokM=
-github.com/fatih/color v1.16.0/go.mod h1:fL2Sau1YI5c0pdGEVCbKQbLXB6edEj1ZgiY4NijnWvE=
-github.com/fsnotify/fsnotify v1.7.0 h1:8JEhPFa5W2WU7YfeZzPNqzMP6Lwt7L2715Ggo0nosvA=
-github.com/fsnotify/fsnotify v1.7.0/go.mod h1:40Bi/Hjc2AVfZrqy+aj+yEI+/bRxZnMJyTJwOpGvigM=
github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
github.com/jackielii/ctxkey v1.0.1 h1:CcgbR+fQbrzZJWxI/7Ec4EhzUbmTU1sfI1gV7MAgjIg=
github.com/jackielii/ctxkey v1.0.1/go.mod h1:fo4HOwrvSnc3n8o5qZ5L+FVcSyQn+d67CCnlEbH24uc=
-github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA=
-github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=
-github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM=
-github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
-github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
-github.com/natefinch/atomic v1.0.1 h1:ZPYKxkqQOx3KZ+RsbnP/YsgvxWQPGxjC0oBt2AhwV0A=
-github.com/natefinch/atomic v1.0.1/go.mod h1:N/D/ELrljoqDyT3rZrsUmtsuzvHkeB/wWjHV22AZRbM=
-github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
-github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
-github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
-github.com/tdewolff/parse/v2 v2.8.13 h1:si/8rLw5BZZTWCCiMm9A3f6x+RmqYfrkEeXCgpX5ick=
-github.com/tdewolff/parse/v2 v2.8.13/go.mod h1:XdsoSFThlVIRIajAuqz1evNY7bagZS8LBOPA3aVopwQ=
-github.com/tdewolff/test v1.0.12/go.mod h1:XPuWBzvdUzhCuxWO1ojpXsyzsA5bFoS3tO/Q3kFuTG8=
-golang.org/x/mod v0.37.0 h1:vF1DjpVEshcIqoEaauuHebaLk1O1forxjxBaVn884JQ=
-golang.org/x/mod v0.37.0/go.mod h1:m8S8VeM9r4dzDwjrKO0a1sZP3YjeMamRRlD+fmR2Q/0=
-golang.org/x/net v0.56.0 h1:Rw8j/hFzGvJUZwNBXnAtf5sVDVt+65SK2C7IxCxZt5o=
-golang.org/x/net v0.56.0/go.mod h1:D3Ku6r+V6JROoZK144D2XfMHFcMq/0zSfLelVTCFKec=
-golang.org/x/sync v0.21.0 h1:HLII4xRRTtCRkxYp4HNFF0Js/Og6q2i++KXbg0gHCwM=
-golang.org/x/sync v0.21.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
-golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.46.0 h1:noSf2Fq6F8DBgS+LysIkx7rIExoNHJsxOAtPp4rthXw=
-golang.org/x/sys v0.46.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
-golang.org/x/tools v0.46.0 h1:7jTurBkPZu4moS/Uy4OQT1M+QBlsj3wejyZwsT8Z7rk=
-golang.org/x/tools v0.46.0/go.mod h1:FrD85F8l+NWL+9XWBSyVSHO6Ne4jutsfIFba7AWQ5Ys=
-gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
-gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
diff --git a/examples/htmx/pages.gsx b/examples/htmx/pages.gsx
new file mode 100644
index 0000000..be1a6da
--- /dev/null
+++ b/examples/htmx/pages.gsx
@@ -0,0 +1,111 @@
+package main
+
+import (
+ "fmt"
+)
+
+type index struct {
+ product `route:"/product Product"`
+ team `route:"/team Team"`
+ contact `route:"/contact Contact"`
+ throw `route:"/throw Throw"`
+}
+type product struct{}
+type team struct{}
+type contact struct{}
+type throw struct{}
+
+component (p index) Page() {
+
+
+}
+
+component (p index) Main() {
+ Welcome to the Index Page
+
+ Navigate to the product, team, or contact pages using the links below:
+
+ url} hx-target="#main">Throw (Err)
+}
+
+component (p product) Page() {
+
+
+}
+
+component (p product) Main() {
+ Product Page
+ This is the product page.
+}
+
+component (p team) Page() {
+
+
+}
+
+component (p team) Main() {
+ Team Page
+ This is the team page.
+}
+
+component (p contact) Page() {
+
+
+}
+
+component (p contact) Main() {
+ Contact Page
+ This is the contact page.
+}
+
+func errFunc() (string, error) { return "", fmt.Errorf("this is an error") }
+component (p throw) Page() {
+ { errFunc() }
+}
+
+component Layout() {
+
+
+
+ HTMX Example
+
+
+
+ { children }
+
+
+}
+
+component ErrorPage(err error) {
+
+
+
+}
+
+component ErrorComp(err error) {
+ Error
+ { err.Error() }
+}
diff --git a/examples/htmx/pages.templ b/examples/htmx/pages.templ
deleted file mode 100644
index 94c3ce5..0000000
--- a/examples/htmx/pages.templ
+++ /dev/null
@@ -1,104 +0,0 @@
-package main
-
-import (
- "context"
- "github.com/jackielii/structpages"
-)
-
-type index struct {
- product `route:"/product Product"`
- team `route:"/team Team"`
- contact `route:"/contact Contact"`
-}
-
-templ (p index) Page() {
- @html() {
- @p.Main()
- }
-}
-
-templ (index) Main() {
- Welcome to the Index Page
- Navigate to the product, team, or contact pages using the links below:
-}
-
-type product struct{}
-
-templ (p product) Page() {
- @html() {
- @p.Main()
- }
-}
-
-templ (product) Main() {
- Product Page
- This is the product page.
-}
-
-type team struct{}
-
-templ (p team) Page() {
- @html() {
- @p.Main()
- }
-}
-
-templ (team) Main() {
- Team Page
- This is the team page.
-}
-
-type contact struct{}
-
-templ (p contact) Page() {
- @html() {
- @p.Main()
- }
-}
-
-templ (contact) Main() {
- Contact Page
- This is the contact page.
-}
-
-templ html() {
-
-
-
- HTMX Example
-
-
-
-
- { children... }
-
-
-
-}
-
-templ errorPage(err error) {
- @html() {
- @errorComp(err)
- }
-}
-
-templ errorComp(err error) {
- Error
- { err.Error() }
-}
-
-func urlFor(ctx context.Context, page any, args ...any) (templ.SafeURL, error) {
- s, err := structpages.URLFor(ctx, page, args...)
- return templ.SafeURL(s), err
-}
diff --git a/examples/htmx/pages.x.go b/examples/htmx/pages.x.go
new file mode 100644
index 0000000..e16c952
--- /dev/null
+++ b/examples/htmx/pages.x.go
@@ -0,0 +1,280 @@
+// Code generated by gsx; DO NOT EDIT.
+
+package main
+
+import (
+ "context"
+ "fmt"
+ "io"
+
+ "github.com/gsxhq/gsx"
+ _gsxf0 "github.com/jackielii/structpages"
+)
+
+type index struct {
+ product `route:"/product Product"`
+ team `route:"/team Team"`
+ contact `route:"/contact Contact"`
+ throw `route:"/throw Throw"`
+}
+type product struct{}
+type team struct{}
+type contact struct{}
+type throw struct{}
+
+//line pages.gsx:18:1
+func (p index) Page() gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:19:2
+ _gsxgw.Node(ctx, Layout(LayoutProps{Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:20:3
+ _gsxgw.Node(ctx, p.Main())
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
+
+//line pages.gsx:24:1
+func (p index) Main() gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:25:2
+ _gsxgw.S("Welcome to the Index Page ")
+//line pages.gsx:26:2
+ _gsxgw.S("Navigate to the product, team, or contact pages using the links below:
")
+//line pages.gsx:29:2
+ _gsxgw.S("Throw (Err)")
+ return _gsxgw.Err()
+ })
+}
+
+//line pages.gsx:32:1
+func (p product) Page() gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:33:2
+ _gsxgw.Node(ctx, Layout(LayoutProps{Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:34:3
+ _gsxgw.Node(ctx, p.Main())
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
+
+//line pages.gsx:38:1
+func (p product) Main() gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:39:2
+ _gsxgw.S("Product Page ")
+//line pages.gsx:40:2
+ _gsxgw.S("This is the product page.
")
+ return _gsxgw.Err()
+ })
+}
+
+//line pages.gsx:43:1
+func (p team) Page() gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:44:2
+ _gsxgw.Node(ctx, Layout(LayoutProps{Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:45:3
+ _gsxgw.Node(ctx, p.Main())
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
+
+//line pages.gsx:49:1
+func (p team) Main() gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:50:2
+ _gsxgw.S("Team Page ")
+//line pages.gsx:51:2
+ _gsxgw.S("This is the team page.
")
+ return _gsxgw.Err()
+ })
+}
+
+//line pages.gsx:54:1
+func (p contact) Page() gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:55:2
+ _gsxgw.Node(ctx, Layout(LayoutProps{Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:56:3
+ _gsxgw.Node(ctx, p.Main())
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
+
+//line pages.gsx:60:1
+func (p contact) Main() gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:61:2
+ _gsxgw.S("Contact Page ")
+//line pages.gsx:62:2
+ _gsxgw.S("This is the contact page.
")
+ return _gsxgw.Err()
+ })
+}
+
+func errFunc() (string, error) { return "", fmt.Errorf("this is an error") }
+
+//line pages.gsx:66:1
+func (p throw) Page() gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:67:2
+ _gsxgw.S("")
+//line pages.gsx:67:5
+ _gsxv1, _gsxerr := errFunc()
+ if _gsxerr != nil {
+ return _gsxerr
+ }
+ _gsxgw.Text(string(_gsxv1))
+ _gsxgw.S("
")
+ return _gsxgw.Err()
+ })
+}
+
+type LayoutProps struct {
+ Children gsx.Node
+}
+
+//line pages.gsx:70:1
+func Layout(_gsxp LayoutProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ children := _gsxp.Children
+ _gsxgw := gsx.W(_gsxw)
+ _gsxgw.S("")
+//line pages.gsx:72:2
+ _gsxgw.S("")
+//line pages.gsx:73:3
+ _gsxgw.S("")
+//line pages.gsx:74:4
+ _gsxgw.S("HTMX Example ")
+//line pages.gsx:78:3
+ _gsxgw.S("")
+//line pages.gsx:79:4
+ _gsxgw.S("")
+//line pages.gsx:80:5
+ _gsxgw.S("")
+//line pages.gsx:81:6
+ _gsxgw.S("")
+//line pages.gsx:82:7
+ _gsxgw.S("")
+//line pages.gsx:83:8
+ _gsxgw.S("Home ")
+//line pages.gsx:85:7
+ _gsxgw.S("")
+//line pages.gsx:86:8
+ _gsxgw.S("Product ")
+//line pages.gsx:88:7
+ _gsxgw.S("")
+//line pages.gsx:89:8
+ _gsxgw.S("Team ")
+//line pages.gsx:91:7
+ _gsxgw.S("")
+//line pages.gsx:92:8
+ _gsxgw.S("Contact ")
+//line pages.gsx:97:4
+ _gsxgw.S("")
+//line pages.gsx:97:20
+ _gsxgw.Node(ctx, children)
+ _gsxgw.S(" ")
+ return _gsxgw.Err()
+ })
+}
+
+type ErrorPageProps struct {
+ Err error
+}
+
+//line pages.gsx:102:1
+func ErrorPage(_gsxp ErrorPageProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ err := _gsxp.Err
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:103:2
+ _gsxgw.Node(ctx, Layout(LayoutProps{Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:104:3
+ _gsxgw.Node(ctx, ErrorComp(ErrorCompProps{Err: err}))
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
+
+type ErrorCompProps struct {
+ Err error
+}
+
+//line pages.gsx:108:1
+func ErrorComp(_gsxp ErrorCompProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ err := _gsxp.Err
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:109:2
+ _gsxgw.S("Error ")
+//line pages.gsx:110:2
+ _gsxgw.S("")
+//line pages.gsx:110:5
+ _gsxgw.Text(string(err.Error()))
+ _gsxgw.S("
")
+ return _gsxgw.Err()
+ })
+}
diff --git a/examples/lint-misuse/pages.gsx b/examples/lint-misuse/pages.gsx
new file mode 100644
index 0000000..8c5391b
--- /dev/null
+++ b/examples/lint-misuse/pages.gsx
@@ -0,0 +1,28 @@
+package main
+
+import (
+ "fmt"
+ "strconv"
+)
+
+// BadLinks mirrors the templ original — it deliberately uses hard-coded
+// internal URLs so the structpages-lint [url-attr] rule has targets to flag.
+// In gsx the component uses inline params just like the templ version.
+//
+// NOTE ON gsx AUTO-ESCAPING: gsx escapes URL-context attributes
+// (href, hx-get, action, …) by context. That means a dynamically-
+// constructed javascript: or data: URL would be neutralised, preventing
+// XSS via URL sinks. However, the [url-attr] lint rule catches a
+// different problem — routing-correctness: hard-coded path strings that
+// bypass structpages.URLFor break when routes are renamed. That class of
+// bug is orthogonal to XSS escaping, so gsx's auto-escaping does NOT
+// make these findings go away. The lint still has value in gsx projects.
+component BadLinks(id int, name string) {
+ Hard-coded internal
+ Expression literal
+ Concat
+ Sprintf
+ Bad hx-get
+
+ External (allowed)
+}
diff --git a/examples/lint-misuse/pages.templ b/examples/lint-misuse/pages.templ
deleted file mode 100644
index 52ce673..0000000
--- a/examples/lint-misuse/pages.templ
+++ /dev/null
@@ -1,19 +0,0 @@
-package main
-
-import (
- "fmt"
- "strconv"
-)
-
-templ BadLinks(id int, name string) {
- Hard-coded internal
- Expression literal
- Concat
- Sprintf
- Bad hx-get
-
- External (allowed)
-
-
- Suppressed
-}
diff --git a/examples/lint-misuse/pages.x.go b/examples/lint-misuse/pages.x.go
new file mode 100644
index 0000000..6420e6c
--- /dev/null
+++ b/examples/lint-misuse/pages.x.go
@@ -0,0 +1,64 @@
+// Code generated by gsx; DO NOT EDIT.
+
+package main
+
+import (
+ "context"
+ "fmt"
+ "io"
+ "strconv"
+
+ "github.com/gsxhq/gsx"
+)
+
+// BadLinks mirrors the templ original — it deliberately uses hard-coded
+// internal URLs so the structpages-lint [url-attr] rule has targets to flag.
+// In gsx the component uses inline params just like the templ version.
+//
+// NOTE ON gsx AUTO-ESCAPING: gsx escapes URL-context attributes
+// (href, hx-get, action, …) by context. That means a dynamically-
+// constructed javascript: or data: URL would be neutralised, preventing
+// XSS via URL sinks. However, the [url-attr] lint rule catches a
+// different problem — routing-correctness: hard-coded path strings that
+// bypass structpages.URLFor break when routes are renamed. That class of
+// bug is orthogonal to XSS escaping, so gsx's auto-escaping does NOT
+// make these findings go away. The lint still has value in gsx projects.
+
+type BadLinksProps struct {
+ Id int
+ Name string
+}
+
+//line pages.gsx:20:1
+func BadLinks(_gsxp BadLinksProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ id := _gsxp.Id
+ name := _gsxp.Name
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:21:2
+ _gsxgw.S("Hard-coded internal ")
+//line pages.gsx:22:2
+ _gsxgw.S("Expression literal ")
+//line pages.gsx:23:2
+ _gsxgw.S("Concat ")
+//line pages.gsx:24:2
+ _gsxgw.S("Sprintf ")
+//line pages.gsx:25:2
+ _gsxgw.S("Bad hx-get ")
+//line pages.gsx:26:2
+ _gsxgw.S("")
+//line pages.gsx:27:2
+ _gsxgw.S("External (allowed) ")
+ return _gsxgw.Err()
+ })
+}
diff --git a/examples/simple/go.mod b/examples/simple/go.mod
index 688aa22..d1de761 100644
--- a/examples/simple/go.mod
+++ b/examples/simple/go.mod
@@ -4,29 +4,11 @@ go 1.26.1
require github.com/jackielii/structpages v0.0.0-00010101000000-000000000000
-require github.com/a-h/templ v0.3.1020 // indirect
-
require (
- github.com/a-h/parse v0.0.0-20250122154542-74294addb73e // indirect
- github.com/andybalholm/brotli v1.1.0 // indirect
- github.com/cenkalti/backoff/v4 v4.3.0 // indirect
- github.com/cli/browser v1.3.0 // indirect
- github.com/fatih/color v1.16.0 // indirect
- github.com/fsnotify/fsnotify v1.7.0 // indirect
github.com/gsxhq/gsx v0.0.0
github.com/jackielii/ctxkey v1.0.1 // indirect
- github.com/mattn/go-colorable v0.1.13 // indirect
- github.com/mattn/go-isatty v0.0.20 // indirect
- github.com/natefinch/atomic v1.0.1 // indirect
- golang.org/x/mod v0.37.0 // indirect
- golang.org/x/net v0.56.0 // indirect
- golang.org/x/sync v0.21.0 // indirect
- golang.org/x/sys v0.46.0 // indirect
- golang.org/x/tools v0.46.0 // indirect
)
replace github.com/jackielii/structpages => ../..
-tool github.com/a-h/templ/cmd/templ
-
replace github.com/gsxhq/gsx => ../../../gsxhq/gsx
diff --git a/examples/simple/go.sum b/examples/simple/go.sum
index df0b1bd..2108c87 100644
--- a/examples/simple/go.sum
+++ b/examples/simple/go.sum
@@ -1,45 +1,4 @@
-github.com/a-h/parse v0.0.0-20250122154542-74294addb73e h1:HjVbSQHy+dnlS6C3XajZ69NYAb5jbGNfHanvm1+iYlo=
-github.com/a-h/parse v0.0.0-20250122154542-74294addb73e/go.mod h1:3mnrkvGpurZ4ZrTDbYU84xhwXW2TjTKShSwjRi2ihfQ=
-github.com/a-h/templ v0.3.1020 h1:ypAT/L5ySWEnZ6Zft/5yfoWXYYkhFNvEFOeeqecg4tw=
-github.com/a-h/templ v0.3.1020/go.mod h1:A2DlK61v+K+NRoGnhmYbNYVmtYHcFO5/AisMvBdDxTM=
-github.com/andybalholm/brotli v1.1.0 h1:eLKJA0d02Lf0mVpIDgYnqXcUn0GqVmEFny3VuID1U3M=
-github.com/andybalholm/brotli v1.1.0/go.mod h1:sms7XGricyQI9K10gOSf56VKKWS4oLer58Q+mhRPtnY=
-github.com/cenkalti/backoff/v4 v4.3.0 h1:MyRJ/UdXutAwSAT+s3wNd7MfTIcy71VQueUuFK343L8=
-github.com/cenkalti/backoff/v4 v4.3.0/go.mod h1:Y3VNntkOUPxTVeUxJ/G5vcM//AlwfmyYozVcomhLiZE=
-github.com/cli/browser v1.3.0 h1:LejqCrpWr+1pRqmEPDGnTZOjsMe7sehifLynZJuqJpo=
-github.com/cli/browser v1.3.0/go.mod h1:HH8s+fOAxjhQoBUAsKuPCbqUuxZDhQ2/aD+SzsEfBTk=
-github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
-github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/fatih/color v1.16.0 h1:zmkK9Ngbjj+K0yRhTVONQh1p/HknKYSlNT+vZCzyokM=
-github.com/fatih/color v1.16.0/go.mod h1:fL2Sau1YI5c0pdGEVCbKQbLXB6edEj1ZgiY4NijnWvE=
-github.com/fsnotify/fsnotify v1.7.0 h1:8JEhPFa5W2WU7YfeZzPNqzMP6Lwt7L2715Ggo0nosvA=
-github.com/fsnotify/fsnotify v1.7.0/go.mod h1:40Bi/Hjc2AVfZrqy+aj+yEI+/bRxZnMJyTJwOpGvigM=
github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
github.com/jackielii/ctxkey v1.0.1 h1:CcgbR+fQbrzZJWxI/7Ec4EhzUbmTU1sfI1gV7MAgjIg=
github.com/jackielii/ctxkey v1.0.1/go.mod h1:fo4HOwrvSnc3n8o5qZ5L+FVcSyQn+d67CCnlEbH24uc=
-github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA=
-github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=
-github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM=
-github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
-github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
-github.com/natefinch/atomic v1.0.1 h1:ZPYKxkqQOx3KZ+RsbnP/YsgvxWQPGxjC0oBt2AhwV0A=
-github.com/natefinch/atomic v1.0.1/go.mod h1:N/D/ELrljoqDyT3rZrsUmtsuzvHkeB/wWjHV22AZRbM=
-github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
-github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
-github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
-golang.org/x/mod v0.37.0 h1:vF1DjpVEshcIqoEaauuHebaLk1O1forxjxBaVn884JQ=
-golang.org/x/mod v0.37.0/go.mod h1:m8S8VeM9r4dzDwjrKO0a1sZP3YjeMamRRlD+fmR2Q/0=
-golang.org/x/net v0.56.0 h1:Rw8j/hFzGvJUZwNBXnAtf5sVDVt+65SK2C7IxCxZt5o=
-golang.org/x/net v0.56.0/go.mod h1:D3Ku6r+V6JROoZK144D2XfMHFcMq/0zSfLelVTCFKec=
-golang.org/x/sync v0.21.0 h1:HLII4xRRTtCRkxYp4HNFF0Js/Og6q2i++KXbg0gHCwM=
-golang.org/x/sync v0.21.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
-golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.46.0 h1:noSf2Fq6F8DBgS+LysIkx7rIExoNHJsxOAtPp4rthXw=
-golang.org/x/sys v0.46.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
-golang.org/x/tools v0.46.0 h1:7jTurBkPZu4moS/Uy4OQT1M+QBlsj3wejyZwsT8Z7rk=
-golang.org/x/tools v0.46.0/go.mod h1:FrD85F8l+NWL+9XWBSyVSHO6Ne4jutsfIFba7AWQ5Ys=
-gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
-gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
diff --git a/examples/simple/pages.gsx b/examples/simple/pages.gsx
new file mode 100644
index 0000000..94861ae
--- /dev/null
+++ b/examples/simple/pages.gsx
@@ -0,0 +1,72 @@
+package main
+
+// Page structs + route tags are plain Go — pass through unchanged.
+type index struct {
+ product `route:"/product Product"`
+ team `route:"/team Team"`
+ contact `route:"/contact Contact"`
+}
+type product struct{}
+type team struct{}
+type contact struct{}
+
+component (p index) Page() {
+
+ Welcome to the Index Page
+
+ Navigate to the product, team, or contact pages using the links below:
+
+
+}
+
+component (p product) Page() {
+
+ Product Page
+ This is the product page.
+
+}
+
+component (p team) Page() {
+
+ Team Page
+ This is the team page.
+
+}
+
+component (p contact) Page() {
+
+ Contact Page
+ This is the contact page.
+
+}
+
+component Layout() {
+
+
+
+ Simple Example
+
+
+
+ { children }
+
+
+}
diff --git a/examples/simple/pages.templ b/examples/simple/pages.templ
deleted file mode 100644
index 91157f8..0000000
--- a/examples/simple/pages.templ
+++ /dev/null
@@ -1,73 +0,0 @@
-package main
-
-import "context"
-import "github.com/jackielii/structpages"
-
-type index struct {
- product `route:"/product Product"`
- team `route:"/team Team"`
- contact `route:"/contact Contact"`
-}
-
-templ (index) Page() {
- @html() {
- Welcome to the Index Page
- Navigate to the product, team, or contact pages using the links below:
- }
-}
-
-type product struct{}
-
-templ (product) Page() {
- @html() {
- Product Page
- This is the product page.
- }
-}
-
-type team struct{}
-
-templ (team) Page() {
- @html() {
- Team Page
- This is the team page.
- }
-}
-
-type contact struct{}
-
-templ (contact) Page() {
- @html() {
- Contact Page
- This is the contact page.
- }
-}
-
-templ html() {
-
-
-
- Simple Example
-
-
-
-
- { children... }
-
-
-
-}
-
-func urlFor(ctx context.Context, page any, args ...any) (string, error) {
- return structpages.URLFor(ctx, page, args...)
-}
diff --git a/examples/simple/pages.x.go b/examples/simple/pages.x.go
new file mode 100644
index 0000000..7380abf
--- /dev/null
+++ b/examples/simple/pages.x.go
@@ -0,0 +1,168 @@
+// Code generated by gsx; DO NOT EDIT.
+
+package main
+
+import (
+ "context"
+ "io"
+
+ "github.com/gsxhq/gsx"
+ _gsxf0 "github.com/jackielii/structpages"
+)
+
+// Page structs + route tags are plain Go — pass through unchanged.
+type index struct {
+ product `route:"/product Product"`
+ team `route:"/team Team"`
+ contact `route:"/contact Contact"`
+}
+type product struct{}
+type team struct{}
+type contact struct{}
+
+//line pages.gsx:13:1
+func (p index) Page() gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:14:2
+ _gsxgw.Node(ctx, Layout(LayoutProps{Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:15:3
+ _gsxgw.S("Welcome to the Index Page ")
+//line pages.gsx:16:3
+ _gsxgw.S("Navigate to the product, team, or contact pages using the links below:
")
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
+
+//line pages.gsx:22:1
+func (p product) Page() gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:23:2
+ _gsxgw.Node(ctx, Layout(LayoutProps{Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:24:3
+ _gsxgw.S("Product Page ")
+//line pages.gsx:25:3
+ _gsxgw.S("This is the product page.
")
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
+
+//line pages.gsx:29:1
+func (p team) Page() gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:30:2
+ _gsxgw.Node(ctx, Layout(LayoutProps{Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:31:3
+ _gsxgw.S("Team Page ")
+//line pages.gsx:32:3
+ _gsxgw.S("This is the team page.
")
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
+
+//line pages.gsx:36:1
+func (p contact) Page() gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:37:2
+ _gsxgw.Node(ctx, Layout(LayoutProps{Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:38:3
+ _gsxgw.S("Contact Page ")
+//line pages.gsx:39:3
+ _gsxgw.S("This is the contact page.
")
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
+
+type LayoutProps struct {
+ Children gsx.Node
+}
+
+//line pages.gsx:43:1
+func Layout(_gsxp LayoutProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ children := _gsxp.Children
+ _gsxgw := gsx.W(_gsxw)
+ _gsxgw.S("")
+//line pages.gsx:45:2
+ _gsxgw.S("")
+//line pages.gsx:46:3
+ _gsxgw.S("")
+//line pages.gsx:47:4
+ _gsxgw.S("Simple Example ")
+//line pages.gsx:50:3
+ _gsxgw.S("")
+//line pages.gsx:51:4
+ _gsxgw.S("")
+//line pages.gsx:52:5
+ _gsxgw.S("")
+//line pages.gsx:53:6
+ _gsxgw.S("")
+//line pages.gsx:54:7
+ _gsxgw.S("")
+//line pages.gsx:55:8
+ _gsxgw.S("Home ")
+//line pages.gsx:57:7
+ _gsxgw.S("")
+//line pages.gsx:58:8
+ _gsxgw.S("Product ")
+//line pages.gsx:60:7
+ _gsxgw.S("")
+//line pages.gsx:61:8
+ _gsxgw.S("Team ")
+//line pages.gsx:63:7
+ _gsxgw.S("")
+//line pages.gsx:64:8
+ _gsxgw.S("Contact ")
+//line pages.gsx:69:4
+ _gsxgw.S("")
+//line pages.gsx:69:10
+ _gsxgw.Node(ctx, children)
+ _gsxgw.S(" ")
+ return _gsxgw.Err()
+ })
+}
diff --git a/examples/todo/go.mod b/examples/todo/go.mod
index 7ccebcf..0c703ab 100644
--- a/examples/todo/go.mod
+++ b/examples/todo/go.mod
@@ -4,29 +4,11 @@ go 1.26.1
require github.com/jackielii/structpages v0.0.0
-require github.com/a-h/templ v0.3.1020 // indirect
-
require (
- github.com/a-h/parse v0.0.0-20250122154542-74294addb73e // indirect
- github.com/andybalholm/brotli v1.1.0 // indirect
- github.com/cenkalti/backoff/v4 v4.3.0 // indirect
- github.com/cli/browser v1.3.0 // indirect
- github.com/fatih/color v1.16.0 // indirect
- github.com/fsnotify/fsnotify v1.7.0 // indirect
github.com/gsxhq/gsx v0.0.0
github.com/jackielii/ctxkey v1.0.1 // indirect
- github.com/mattn/go-colorable v0.1.13 // indirect
- github.com/mattn/go-isatty v0.0.20 // indirect
- github.com/natefinch/atomic v1.0.1 // indirect
- golang.org/x/mod v0.37.0 // indirect
- golang.org/x/net v0.56.0 // indirect
- golang.org/x/sync v0.21.0 // indirect
- golang.org/x/sys v0.46.0 // indirect
- golang.org/x/tools v0.46.0 // indirect
)
replace github.com/jackielii/structpages => ../..
-tool github.com/a-h/templ/cmd/templ
-
replace github.com/gsxhq/gsx => /Users/jackieli/personal/gsxhq/gsx
diff --git a/examples/todo/go.sum b/examples/todo/go.sum
index df0b1bd..2108c87 100644
--- a/examples/todo/go.sum
+++ b/examples/todo/go.sum
@@ -1,45 +1,4 @@
-github.com/a-h/parse v0.0.0-20250122154542-74294addb73e h1:HjVbSQHy+dnlS6C3XajZ69NYAb5jbGNfHanvm1+iYlo=
-github.com/a-h/parse v0.0.0-20250122154542-74294addb73e/go.mod h1:3mnrkvGpurZ4ZrTDbYU84xhwXW2TjTKShSwjRi2ihfQ=
-github.com/a-h/templ v0.3.1020 h1:ypAT/L5ySWEnZ6Zft/5yfoWXYYkhFNvEFOeeqecg4tw=
-github.com/a-h/templ v0.3.1020/go.mod h1:A2DlK61v+K+NRoGnhmYbNYVmtYHcFO5/AisMvBdDxTM=
-github.com/andybalholm/brotli v1.1.0 h1:eLKJA0d02Lf0mVpIDgYnqXcUn0GqVmEFny3VuID1U3M=
-github.com/andybalholm/brotli v1.1.0/go.mod h1:sms7XGricyQI9K10gOSf56VKKWS4oLer58Q+mhRPtnY=
-github.com/cenkalti/backoff/v4 v4.3.0 h1:MyRJ/UdXutAwSAT+s3wNd7MfTIcy71VQueUuFK343L8=
-github.com/cenkalti/backoff/v4 v4.3.0/go.mod h1:Y3VNntkOUPxTVeUxJ/G5vcM//AlwfmyYozVcomhLiZE=
-github.com/cli/browser v1.3.0 h1:LejqCrpWr+1pRqmEPDGnTZOjsMe7sehifLynZJuqJpo=
-github.com/cli/browser v1.3.0/go.mod h1:HH8s+fOAxjhQoBUAsKuPCbqUuxZDhQ2/aD+SzsEfBTk=
-github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
-github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
-github.com/fatih/color v1.16.0 h1:zmkK9Ngbjj+K0yRhTVONQh1p/HknKYSlNT+vZCzyokM=
-github.com/fatih/color v1.16.0/go.mod h1:fL2Sau1YI5c0pdGEVCbKQbLXB6edEj1ZgiY4NijnWvE=
-github.com/fsnotify/fsnotify v1.7.0 h1:8JEhPFa5W2WU7YfeZzPNqzMP6Lwt7L2715Ggo0nosvA=
-github.com/fsnotify/fsnotify v1.7.0/go.mod h1:40Bi/Hjc2AVfZrqy+aj+yEI+/bRxZnMJyTJwOpGvigM=
github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
github.com/jackielii/ctxkey v1.0.1 h1:CcgbR+fQbrzZJWxI/7Ec4EhzUbmTU1sfI1gV7MAgjIg=
github.com/jackielii/ctxkey v1.0.1/go.mod h1:fo4HOwrvSnc3n8o5qZ5L+FVcSyQn+d67CCnlEbH24uc=
-github.com/mattn/go-colorable v0.1.13 h1:fFA4WZxdEF4tXPZVKMLwD8oUnCTTo08duU7wxecdEvA=
-github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=
-github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM=
-github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
-github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
-github.com/natefinch/atomic v1.0.1 h1:ZPYKxkqQOx3KZ+RsbnP/YsgvxWQPGxjC0oBt2AhwV0A=
-github.com/natefinch/atomic v1.0.1/go.mod h1:N/D/ELrljoqDyT3rZrsUmtsuzvHkeB/wWjHV22AZRbM=
-github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
-github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
-github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
-github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
-golang.org/x/mod v0.37.0 h1:vF1DjpVEshcIqoEaauuHebaLk1O1forxjxBaVn884JQ=
-golang.org/x/mod v0.37.0/go.mod h1:m8S8VeM9r4dzDwjrKO0a1sZP3YjeMamRRlD+fmR2Q/0=
-golang.org/x/net v0.56.0 h1:Rw8j/hFzGvJUZwNBXnAtf5sVDVt+65SK2C7IxCxZt5o=
-golang.org/x/net v0.56.0/go.mod h1:D3Ku6r+V6JROoZK144D2XfMHFcMq/0zSfLelVTCFKec=
-golang.org/x/sync v0.21.0 h1:HLII4xRRTtCRkxYp4HNFF0Js/Og6q2i++KXbg0gHCwM=
-golang.org/x/sync v0.21.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
-golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
-golang.org/x/sys v0.46.0 h1:noSf2Fq6F8DBgS+LysIkx7rIExoNHJsxOAtPp4rthXw=
-golang.org/x/sys v0.46.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
-golang.org/x/tools v0.46.0 h1:7jTurBkPZu4moS/Uy4OQT1M+QBlsj3wejyZwsT8Z7rk=
-golang.org/x/tools v0.46.0/go.mod h1:FrD85F8l+NWL+9XWBSyVSHO6Ne4jutsfIFba7AWQ5Ys=
-gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
-gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
diff --git a/examples/todo/pages.templ b/examples/todo/pages.gsx
similarity index 79%
rename from examples/todo/pages.templ
rename to examples/todo/pages.gsx
index 10fee51..c90223f 100644
--- a/examples/todo/pages.templ
+++ b/examples/todo/pages.gsx
@@ -1,9 +1,10 @@
package main
import (
- "github.com/jackielii/structpages"
"net/http"
"strconv"
+
+ "github.com/jackielii/structpages"
)
type index struct {
@@ -12,13 +13,13 @@ type index struct {
deleteTodo `route:"DELETE /delete/{id} DeleteTodo"`
}
-templ (p index) Page() {
- @html() {
+component (p index) Page() {
+
TODO App
-
- }
+
}
-templ (p index) TodoList() {
- @todoList()
+component (p index) TodoList() {
+ No todos yet. Add one above!
- }
+ } }
}
-templ html() {
+component Layout() {
@@ -125,20 +126,20 @@ templ html() {
margin: 2rem auto;
padding: 2rem;
}
-
+
.form-group {
display: flex;
gap: 0.5rem;
margin-bottom: 2rem;
}
-
+
.form-group input {
flex: 1;
padding: 0.75rem;
border: 1px solid #ddd;
border-radius: 4px;
}
-
+
.form-group button {
padding: 0.75rem 1.5rem;
background: #007bff;
@@ -147,16 +148,16 @@ templ html() {
border-radius: 4px;
cursor: pointer;
}
-
+
.form-group button:hover {
background: #0056b3;
}
-
+
.todo-list {
list-style: none;
padding: 0;
}
-
+
.todo-item {
display: flex;
align-items: center;
@@ -167,26 +168,26 @@ templ html() {
margin-bottom: 0.5rem;
background: white;
}
-
+
.todo-item.completed {
opacity: 0.6;
}
-
+
.todo-item.completed .todo-text {
text-decoration: line-through;
}
-
+
.todo-content {
display: flex;
align-items: center;
gap: 0.75rem;
flex: 1;
}
-
+
.todo-text {
flex: 1;
}
-
+
.delete-btn {
background: #dc3545;
color: white;
@@ -200,11 +201,11 @@ templ html() {
align-items: center;
justify-content: center;
}
-
+
.delete-btn:hover {
background: #c82333;
}
-
+
.empty-state {
text-align: center;
color: #666;
@@ -214,20 +215,18 @@ templ html() {
-
- { children... }
-
+ { children }
}
-templ errorPage(err error) {
- @html() {
- @errorComp(err)
- }
+component ErrorPage(err error) {
+
+
+
}
-templ errorComp(err error) {
+component ErrorComp(err error) {
Error
{ err.Error() }
}
diff --git a/examples/todo/pages.x.go b/examples/todo/pages.x.go
new file mode 100644
index 0000000..8a3cdb1
--- /dev/null
+++ b/examples/todo/pages.x.go
@@ -0,0 +1,257 @@
+// Code generated by gsx; DO NOT EDIT.
+
+package main
+
+import (
+ "context"
+ "io"
+ "net/http"
+ "strconv"
+
+ "github.com/gsxhq/gsx"
+ "github.com/jackielii/structpages"
+ _gsxf0 "github.com/jackielii/structpages"
+)
+
+type index struct {
+ add `route:"POST /add AddTodo" form:"text"`
+ toggle `route:"POST /toggle/{id} ToggleTodo"`
+ deleteTodo `route:"DELETE /delete/{id} DeleteTodo"`
+}
+
+//line pages.gsx:16:1
+func (p index) Page() gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:17:2
+ _gsxgw.Node(ctx, Layout(LayoutProps{Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:18:3
+ _gsxgw.S("")
+//line pages.gsx:19:4
+ _gsxgw.S("
TODO App ")
+//line pages.gsx:20:4
+ _gsxgw.S("
")
+//line pages.gsx:26:5
+ _gsxgw.S("")
+//line pages.gsx:27:6
+ _gsxgw.S("Add Todo
")
+//line pages.gsx:36:4
+ _gsxgw.S("")
+//line pages.gsx:37:5
+ _gsxgw.Node(ctx, p.TodoList())
+ _gsxgw.S(" No todos yet. Add one above!
")
+ }
+ return _gsxgw.Err()
+ })
+}
+
+type LayoutProps struct {
+ Children gsx.Node
+}
+
+//line pages.gsx:116:1
+func Layout(_gsxp LayoutProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ children := _gsxp.Children
+ _gsxgw := gsx.W(_gsxw)
+ _gsxgw.S("")
+//line pages.gsx:118:2
+ _gsxgw.S("")
+//line pages.gsx:119:3
+ _gsxgw.S("")
+//line pages.gsx:120:4
+ _gsxgw.S("TODO App ")
+//line pages.gsx:123:4
+ _gsxgw.S("")
+//line pages.gsx:217:3
+ _gsxgw.S("")
+//line pages.gsx:218:4
+ _gsxgw.S("")
+//line pages.gsx:218:23
+ _gsxgw.Node(ctx, children)
+ _gsxgw.S(" ")
+ return _gsxgw.Err()
+ })
+}
+
+type ErrorPageProps struct {
+ Err error
+}
+
+//line pages.gsx:223:1
+func ErrorPage(_gsxp ErrorPageProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ err := _gsxp.Err
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:224:2
+ _gsxgw.Node(ctx, Layout(LayoutProps{Children: gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:225:3
+ _gsxgw.Node(ctx, ErrorComp(ErrorCompProps{Err: err}))
+ return _gsxgw.Err()
+ })}))
+ return _gsxgw.Err()
+ })
+}
+
+type ErrorCompProps struct {
+ Err error
+}
+
+//line pages.gsx:229:1
+func ErrorComp(_gsxp ErrorCompProps) gsx.Node {
+ return gsx.Func(func(ctx context.Context, _gsxw io.Writer) error {
+ err := _gsxp.Err
+ _gsxgw := gsx.W(_gsxw)
+//line pages.gsx:230:2
+ _gsxgw.S("Error ")
+//line pages.gsx:231:2
+ _gsxgw.S("")
+//line pages.gsx:231:5
+ _gsxgw.Text(string(err.Error()))
+ _gsxgw.S("
")
+ return _gsxgw.Err()
+ })
+}
diff --git a/gsx.toml b/gsx.toml
new file mode 100644
index 0000000..2e544d0
--- /dev/null
+++ b/gsx.toml
@@ -0,0 +1,13 @@
+# gsx project config, shared by every example module in this repo.
+#
+# Registers the structpages URL/ID helpers as gsx pipeline filters so templates
+# can write `{ page{} |> url }`, `{ x |> id }`, `{ x |> target }` instead of the
+# ctx-threading, error-returning structpages.URLFor / ID / IDTarget calls.
+#
+# The stock `gsx` binary discovers this file by walking up from the example dir
+# to the git repo root, so no per-example cmd/gen generator is needed. Generate
+# with: gsx generate .
+[filters]
+url = "github.com/jackielii/structpages.URLFor"
+id = "github.com/jackielii/structpages.ID"
+target = "github.com/jackielii/structpages.IDTarget"