Migrate all apps to defpage declarative page routes

Replace Python GET page handlers with declarative defpage definitions in .sx
files across all 8 apps (sx docs, orders, account, market, cart, federation,
events, blog). Each app now has sxc/pages/ with setup functions, layout
registrations, page helpers, and .sx defpage declarations.

Core infrastructure: add g I/O primitive, PageDef support for auth/layout/
data/content/filter/aside/menu slots, post_author auth level, and custom
layout registration. Remove ~1400 lines of render_*_page/render_*_oob
boilerplate. Update all endpoint references in routes, sx_components, and
templates to defpage_* naming.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

market/bp/all_markets/routes.py

@@ -2,70 +2,57 @@
 All-markets blueprint — shows markets across ALL pages.
 
 Mounted at / (root of market app). No slug context.
-
-Routes:
-  GET  /              — full page with first page of markets
-  GET  /all-markets   — HTMX fragment for infinite scroll
+GET / handled by defpage. GET /all-markets is pagination fragment.
 """
 from __future__ import annotations
 
-from quart import Blueprint, g, request, render_template, make_response
+from quart import Blueprint, g, request
 
-from shared.browser.app.utils.htmx import is_htmx_request
 from shared.sx.helpers import sx_response
 from shared.infrastructure.data_client import fetch_data
 from shared.contracts.dtos import PostDTO, dto_from_dict
 from shared.services.registry import services
 
 
+async def _load_markets(page, per_page=20):
+    """Load all markets + page info for container badges."""
+    markets, has_more = await services.market.list_marketplaces(
+        g.s, page=page, per_page=per_page,
+    )
+
+    # Batch-load page info for container_ids
+    page_info = {}
+    if markets:
+        post_ids = list({
+            m.container_id for m in markets
+            if m.container_type == "page"
+        })
+        if post_ids:
+            raw_posts = await fetch_data("blog", "posts-by-ids",
+                                         params={"ids": ",".join(str(i) for i in post_ids)},
+                                         required=False) or []
+            for raw_p in raw_posts:
+                p = dto_from_dict(PostDTO, raw_p)
+                page_info[p.id] = {"title": p.title, "slug": p.slug}
+
+    return markets, has_more, page_info
+
+
 def register() -> Blueprint:
     bp = Blueprint("all_markets", __name__)
 
-    async def _load_markets(page, per_page=20):
-        """Load all markets + page info for container badges."""
-        markets, has_more = await services.market.list_marketplaces(
-            g.s, page=page, per_page=per_page,
-        )
-
-        # Batch-load page info for container_ids
-        page_info = {}
-        if markets:
-            post_ids = list({
-                m.container_id for m in markets
-                if m.container_type == "page"
-            })
-            if post_ids:
-                raw_posts = await fetch_data("blog", "posts-by-ids",
-                                             params={"ids": ",".join(str(i) for i in post_ids)},
-                                             required=False) or []
-                for raw_p in raw_posts:
-                    p = dto_from_dict(PostDTO, raw_p)
-                    page_info[p.id] = {"title": p.title, "slug": p.slug}
-
-        return markets, has_more, page_info
-
-    @bp.get("/")
-    async def index():
+    @bp.before_request
+    async def _prepare_page_data():
+        """Load all-markets data for defpage routes."""
+        endpoint = request.endpoint or ""
+        if not endpoint.endswith("defpage_all_markets_index"):
+            return
         page = int(request.args.get("page", 1))
         markets, has_more, page_info = await _load_markets(page)
-
-        ctx = dict(
-            markets=markets,
-            has_more=has_more,
-            page_info=page_info,
-            page=page,
-        )
-
-        from shared.sx.page import get_template_context
-        from sx.sx_components import render_all_markets_page, render_all_markets_oob
-
-        tctx = await get_template_context()
-        if is_htmx_request():
-            sx_src = await render_all_markets_oob(tctx, markets, has_more, page_info, page)
-            return sx_response(sx_src)
-        else:
-            html = await render_all_markets_page(tctx, markets, has_more, page_info, page)
-            return await make_response(html, 200)
+        g.all_markets_data = {
+            "markets": markets, "has_more": has_more,
+            "page_info": page_info, "page": page,
+        }
 
     @bp.get("/all-markets")
     async def markets_fragment():

market/bp/browse/routes.py

@@ -5,17 +5,13 @@ from quart import (
     g,
     Blueprint,
     abort,
-    render_template,
-    render_template_string,
     make_response,
-    current_app,
 )
 from shared.config import config
 from .services.nav import category_context, get_nav
 from .services.blacklist.category import is_category_blocked
 
 from .services import (
-  _hx_fragment_request,
   _productInfo,
   _vary,
   _current_url_without_page,
@@ -33,27 +29,9 @@ def register():
     register_product(),
   )
 
-  @browse_bp.get("/")
-  @cache_page(tag="browse")
-  async def home():
-      """
-      Market landing page.
-      Uses the post data hydrated by the app-level before_request (g.post_data).
-      """
-      p_data = getattr(g, "post_data", None) or {}
-
-      # Determine which template to use based on request type
-      from shared.sx.page import get_template_context
-      from sx.sx_components import render_market_home_page, render_market_home_oob
-
-      ctx = await get_template_context()
-      ctx.update(p_data)
-      if not is_htmx_request():
-          html = await render_market_home_page(ctx)
-          return await make_response(html)
-      else:
-          sx_src = await render_market_home_oob(ctx)
-          return sx_response(sx_src)
+  # Mount defpage for market home (GET /)
+  from shared.sx.pages import mount_pages
+  mount_pages(browse_bp, "market", names=["market-home"])
 
   @browse_bp.get("/all/")
   @cache_page(tag="browse")

market/bp/market/admin/routes.py

@@ -1,31 +1,13 @@
 from __future__ import annotations
 
-from quart import (
-    render_template, make_response, Blueprint
-)
-
-
-from shared.browser.app.authz import require_admin
+from quart import Blueprint
 
 
 def register():
     bp = Blueprint("admin", __name__, url_prefix='/admin')
-    
-    # ---------- Pages ----------
-    @bp.get("/")
-    @require_admin
-    async def admin():
-        from shared.browser.app.utils.htmx import is_htmx_request
 
-        from shared.sx.page import get_template_context
-        from sx.sx_components import render_market_admin_page, render_market_admin_oob
+    # Mount defpage for market admin (GET /)
+    from shared.sx.pages import mount_pages
+    mount_pages(bp, "market", names=["market-admin"])
 
-        tctx = await get_template_context()
-        if not is_htmx_request():
-            html = await render_market_admin_page(tctx)
-            return await make_response(html)
-        else:
-            from shared.sx.helpers import sx_response
-            sx_src = await render_market_admin_oob(tctx)
-            return sx_response(sx_src)
     return bp

market/bp/page_admin/routes.py

@@ -6,7 +6,6 @@ import unicodedata
 from quart import make_response, request, g, Blueprint
 
 from shared.browser.app.authz import require_admin
-from shared.browser.app.utils.htmx import is_htmx_request
 from shared.services.registry import services
 from shared.sx.helpers import sx_response
 
@@ -27,19 +26,16 @@ def _slugify(value: str, max_len: int = 255) -> str:
 def register():
     bp = Blueprint("page_admin", __name__)
 
-    @bp.get("/")
-    @require_admin
-    async def admin(**kwargs):
+    @bp.before_request
+    async def _prepare_page_data():
+        """Pre-render page admin content for defpage (async helper)."""
+        endpoint = request.endpoint or ""
+        if request.method != "GET" or not endpoint.endswith("defpage_page_admin"):
+            return
         from shared.sx.page import get_template_context
-        from sx.sx_components import render_page_admin_page, render_page_admin_oob
-
-        tctx = await get_template_context()
-        if not is_htmx_request():
-            html = await render_page_admin_page(tctx)
-            return await make_response(html)
-        else:
-            sx_src = await render_page_admin_oob(tctx)
-            return sx_response(sx_src)
+        from sx.sx_components import _markets_admin_panel_sx
+        ctx = await get_template_context()
+        g.page_admin_content = await _markets_admin_panel_sx(ctx)
 
     @bp.post("/new/")
     @require_admin

market/bp/page_markets/routes.py

@@ -2,55 +2,40 @@
 Page-markets blueprint — shows markets for a single page.
 
 Mounted at /<slug> (page-scoped). Requires g.post_data from hydrate_post.
-
-Routes:
-  GET  /<slug>/              — full page scoped to this page
-  GET  /<slug>/page-markets  — HTMX fragment for infinite scroll
+GET / handled by defpage. GET /page-markets is pagination fragment.
 """
 from __future__ import annotations
 
-from quart import Blueprint, g, request, render_template, make_response
+from quart import Blueprint, g, request
 
-from shared.browser.app.utils.htmx import is_htmx_request
 from shared.sx.helpers import sx_response
 from shared.services.registry import services
 
 
+async def _load_markets(post_id, page, per_page=20):
+    """Load markets for this page's container."""
+    markets, has_more = await services.market.list_marketplaces(
+        g.s, "page", post_id, page=page, per_page=per_page,
+    )
+    return markets, has_more
+
+
 def register() -> Blueprint:
     bp = Blueprint("page_markets", __name__)
 
-    async def _load_markets(post_id, page, per_page=20):
-        """Load markets for this page's container."""
-        markets, has_more = await services.market.list_marketplaces(
-            g.s, "page", post_id, page=page, per_page=per_page,
-        )
-        return markets, has_more
-
-    @bp.get("/")
-    async def index():
+    @bp.before_request
+    async def _prepare_page_data():
+        """Load page-markets data for defpage routes."""
+        endpoint = request.endpoint or ""
+        if not endpoint.endswith("defpage_page_markets_index"):
+            return
         post = g.post_data["post"]
         page = int(request.args.get("page", 1))
-
         markets, has_more = await _load_markets(post["id"], page)
-
-        ctx = dict(
-            markets=markets,
-            has_more=has_more,
-            page_info={},
-            page=page,
-        )
-
-        from shared.sx.page import get_template_context
-        from sx.sx_components import render_page_markets_page, render_page_markets_oob
-
-        tctx = await get_template_context()
-        tctx["post"] = post
-        if is_htmx_request():
-            sx_src = await render_page_markets_oob(tctx, markets, has_more, page)
-            return sx_response(sx_src)
-        else:
-            html = await render_page_markets_page(tctx, markets, has_more, page)
-            return await make_response(html, 200)
+        g.page_markets_data = {
+            "markets": markets, "has_more": has_more,
+            "page": page, "post_slug": post.get("slug", ""),
+        }
 
     @bp.get("/page-markets")
     async def markets_fragment():