datastar/site/routes_examples.go

package site

import (
	"context"
	"errors"
	"fmt"
	"net/http"
	"strings"

	"github.com/a-h/templ"
	"github.com/go-chi/chi/v5"
	"github.com/go-sanitize/sanitize"
	"github.com/gorilla/sessions"
	"github.com/samber/lo"
)

var (
	sanitizer *sanitize.Sanitizer
)

func setupExamples(ctx context.Context, router chi.Router, signals sessions.Store) (err error) {
	mdDataset, err := markdownRenders(ctx, "examples")
	if err != nil {
		return err
	}

	sanitizer, err = sanitize.New()
	if err != nil {
		return fmt.Errorf("error creating sanitizer: %w", err)
	}

	sidebarGroups := []*SidebarGroup{
		{
			Label: "Ported HTMX Examples",
			Links: []*SidebarLink{
				{ID: "click_to_edit"},
				{ID: "bulk_update"},
				{ID: "click_to_load"},
				{ID: "delete_row"},
				{ID: "edit_row"},
				{ID: "lazy_load"},
				{ID: "indicator"},
				{ID: "inline_validation"},
				{ID: "infinite_scroll"},
				{ID: "active_search"},
				{ID: "progress_bar"},
				{ID: "value_select"},
				{ID: "animations"},
				{ID: "file_upload"},
				{ID: "dialogs_browser"},
				{ID: "lazy_tabs"},
				{ID: "sortable"},
			},
		},
		{
			Label: "Reactive Examples",
			Links: []*SidebarLink{
				{ID: "plugin_order"},
				{ID: "polling"},
				{ID: "ignore_attributes"},
				{ID: "bind_keys"},
				{ID: "classes"},
				{ID: "scroll_into_view"},
				{ID: "on_load"},
				{ID: "model_binding"},
				{ID: "disable_button"},
				{ID: "merge_options"},
				{ID: "redirects"},
				{ID: "view_transition_api"},
				{ID: "view_transition_on_click"},
				{ID: "title_update_backend"},
				{ID: "signals_change"},
				{ID: "csrf"},
				{ID: "multiline_signals"},
				{ID: "multi_select"},
				{ID: "raf_update"},
				{ID: "update_signals"},
				{ID: "signals_ifmissing"},
				{ID: "invalid_signals"},
				{ID: "offline_sync"},
				{ID: "session_storage"},
				{ID: "refs"},
				{ID: "multiline_expressions"},
				{ID: "custom_events"},
				{ID: "toggle_visibility"},
				{ID: "cloak"},
				{ID: "img_src_bind"},
				{ID: "dbmon"},
				{ID: "bad_apple"},
				{ID: "web_component"},
				{ID: "persist"},
				{ID: "execute_script"},
				{ID: "dispatch_custom_event"},
				{ID: "replace_url_from_backend"},
				{ID: "replace_url_from_signals"},
				{ID: "prefetch"},
				{ID: "debounce_and_throttle"},
			},
		},
		{
			Label: "Backend Examples",
			Links: []*SidebarLink{
				{ID: "quick_primer_go"},
				{ID: "templ_counter"},
				{ID: "form_data"},
				{ID: "custom_validity"},
				{ID: "click_outside"},
				{ID: "timing"},
				{ID: "aliased_data_attributes"},
				{ID: "merge_fragment"},
				{ID: "key_casing"},
				{ID: "signals_ifmissing_onload"},
				{ID: "signals_change_path"},
			},
		},
	}
	lo.ForEach(sidebarGroups, func(group *SidebarGroup, grpIdx int) {
		lo.ForEach(group.Links, func(link *SidebarLink, linkIdx int) {
			link.URL = templ.SafeURL("/examples/" + link.ID)
			link.Label = strings.ToUpper(strings.ReplaceAll(link.ID, "_", " "))

			if linkIdx > 0 {
				link.Prev = group.Links[linkIdx-1]
			} else if grpIdx > 0 {
				prvGrp := sidebarGroups[grpIdx-1]
				link.Prev = prvGrp.Links[len(prvGrp.Links)-1]
			}

			if linkIdx < len(group.Links)-1 {
				link.Next = group.Links[linkIdx+1]
			} else if grpIdx < len(sidebarGroups)-1 {
				nxtGrp := sidebarGroups[grpIdx+1]
				link.Next = nxtGrp.Links[0]
			}
		})
	})

	router.Route("/examples", func(examplesRouter chi.Router) {
		examplesRouter.Get("/", func(w http.ResponseWriter, r *http.Request) {
			http.Redirect(w, r, string(sidebarGroups[0].Links[0].URL), http.StatusFound)
		})

		examplesRouter.Get("/{name}", func(w http.ResponseWriter, r *http.Request) {
			ctx := r.Context()
			name := chi.URLParam(r, "name")
			mdData, ok := mdDataset[name]
			if !ok {
				http.Error(w, "not found", http.StatusNotFound)
				return
			}

			var currentLink *SidebarLink
			for _, group := range sidebarGroups {
				for _, link := range group.Links {
					if link.ID == name {
						currentLink = link
						break
					}
				}
			}

			SidebarPage(r, sidebarGroups, currentLink, mdData.Title, mdData.Description, mdData.Contents).Render(ctx, w)
		})

		if err := errors.Join(
			setupExamplesQuiz(examplesRouter),
			setupExamplesQuizSlow(examplesRouter),
			setupExamplesClickToEdit(examplesRouter),
			setupExamplesBulkUpdate(examplesRouter),
			setupExamplesClickToLoad(examplesRouter),
			setupExamplesEditRow(examplesRouter),
			setupExamplesDeleteRow(examplesRouter),
			setupExamplesLazyLoad(examplesRouter),
			setupExamplesIndicator(examplesRouter),
			setupExamplesOnLoad(examplesRouter, signals),
			setupExamplesDisableButton(examplesRouter),
			setupExampleInlineValidation(examplesRouter),
			setupExamplesInfiniteScroll(examplesRouter),
			setupExamplesActiveSearch(examplesRouter),
			setupExamplesProgressBar(examplesRouter),
			setupExamplesValueSelect(examplesRouter),
			setupExamplesAnimations(examplesRouter),
			setupExamplesFileUpload(examplesRouter),
			setupExamplesDialogsBrowser(examplesRouter),
			setupExamplesLazyTabs(examplesRouter),
			setupExamplesMergeOptions(examplesRouter),
			setupExamplesRedirects(examplesRouter),
			setupExamplesUpdateSignals(examplesRouter),
			setupExamplesOfflineSync(examplesRouter, signals),
			setupExamplesDbmon(examplesRouter),
			setupExamplesBadApple(examplesRouter),
			setupExamplesExecuteScript(examplesRouter),
			setupExamplesDispatchCustomEvent(examplesRouter),
			setupExamplesReplaceURL(examplesRouter),
			setupExamplesPrefetch(examplesRouter),
			setupExamplesSignalsIfMissing(examplesRouter),
			setupExamplesViewTransitionAPI(examplesRouter),
			setupExamplesModelBinding(examplesRouter),
			setupExamplesTitleUpdateBackend(examplesRouter),
			setupExamplesSignalsChanged(examplesRouter, signals),
			setupExamplesPolling(examplesRouter),
			setupExamplesCSRF(examplesRouter),
			setupExamplesScrollIntoView(examplesRouter),
			setupExamplesQuickPrimerGo(examplesRouter),
			setupExamplesTemplCounter(examplesRouter, signals),
			setupExamplesToggleVisibility(examplesRouter),
			setupExamplesFormData(examplesRouter),
			setupExamplesCustomValidity(examplesRouter),
			setupExamplesMergeFragment(examplesRouter),
		); err != nil {
			panic(fmt.Sprintf("error setting up examples routes: %s", err))
		}
	})

	return nil
}