From 28afaa2c5685fe81d3f85457c7bd4e2ae41036ff Mon Sep 17 00:00:00 2001 From: Kyle Isom Date: Fri, 27 Mar 2026 13:04:15 -0700 Subject: [PATCH] Implement mcdoc v0.1.0: public documentation server Single-binary Go server that fetches markdown from Gitea (mc org), renders to HTML with goldmark (GFM, chroma syntax highlighting, heading anchors), and serves a navigable read-only documentation site. Features: - Boot fetch with retry, webhook refresh, 15-minute poll fallback - In-memory cache with atomic per-repo swap - chi router with htmx partial responses for SPA-like navigation - HMAC-SHA256 webhook validation - Responsive CSS, TOC generation, priority doc ordering - $PORT env var support for MCP agent port assignment 33 tests across config, cache, render, and server packages. Co-Authored-By: Claude Opus 4.6 (1M context) --- .gitignore | 5 + .golangci.yaml | 80 +++++++ CLAUDE.md | 2 +- Dockerfile | 24 ++ Makefile | 31 +++ cmd/mcdoc/main.go | 25 ++ cmd/mcdoc/server.go | 144 +++++++++++ deploy/examples/mcdoc.toml | 19 ++ deploy/mcdoc-rift.toml | 14 ++ go.mod | 18 ++ go.sum | 39 +++ internal/cache/cache.go | 159 +++++++++++++ internal/cache/cache_test.go | 165 +++++++++++++ internal/config/config.go | 164 +++++++++++++ internal/config/config_test.go | 154 ++++++++++++ internal/gitea/client.go | 161 +++++++++++++ internal/render/render.go | 123 ++++++++++ internal/render/render_test.go | 99 ++++++++ internal/server/fetch.go | 218 +++++++++++++++++ internal/server/server.go | 422 +++++++++++++++++++++++++++++++++ internal/server/server_test.go | 325 +++++++++++++++++++++++++ mcdoc.toml.example | 19 ++ web/embed.go | 6 + web/static/htmx.min.js | 1 + web/static/style.css | 343 +++++++++++++++++++++++++++ web/templates/doc.html | 17 ++ web/templates/error.html | 7 + web/templates/index.html | 14 ++ web/templates/layout.html | 42 ++++ web/templates/loading.html | 20 ++ web/templates/repo.html | 11 + 31 files changed, 2870 insertions(+), 1 deletion(-) create mode 100644 .gitignore create mode 100644 .golangci.yaml create mode 100644 Dockerfile create mode 100644 Makefile create mode 100644 cmd/mcdoc/main.go create mode 100644 cmd/mcdoc/server.go create mode 100644 deploy/examples/mcdoc.toml create mode 100644 deploy/mcdoc-rift.toml create mode 100644 go.mod create mode 100644 go.sum create mode 100644 internal/cache/cache.go create mode 100644 internal/cache/cache_test.go create mode 100644 internal/config/config.go create mode 100644 internal/config/config_test.go create mode 100644 internal/gitea/client.go create mode 100644 internal/render/render.go create mode 100644 internal/render/render_test.go create mode 100644 internal/server/fetch.go create mode 100644 internal/server/server.go create mode 100644 internal/server/server_test.go create mode 100644 mcdoc.toml.example create mode 100644 web/embed.go create mode 100644 web/static/htmx.min.js create mode 100644 web/static/style.css create mode 100644 web/templates/doc.html create mode 100644 web/templates/error.html create mode 100644 web/templates/index.html create mode 100644 web/templates/layout.html create mode 100644 web/templates/loading.html create mode 100644 web/templates/repo.html diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..6134edc --- /dev/null +++ b/.gitignore @@ -0,0 +1,5 @@ +/mcdoc +srv/ +.idea/ +.vscode/ +.DS_Store diff --git a/.golangci.yaml b/.golangci.yaml new file mode 100644 index 0000000..ff150bc --- /dev/null +++ b/.golangci.yaml @@ -0,0 +1,80 @@ +version: "2" + +run: + timeout: 5m + tests: true + +linters: + default: none + enable: + - errcheck + - govet + - ineffassign + - unused + - errorlint + - gosec + - staticcheck + - revive + + settings: + errcheck: + check-blank: false + check-type-assertions: true + + govet: + enable-all: true + disable: + - shadow + - fieldalignment + + gosec: + severity: medium + confidence: medium + excludes: + - G104 + + errorlint: + errorf: true + asserts: true + comparison: true + + revive: + rules: + - name: error-return + severity: error + - name: unexported-return + severity: error + - name: error-strings + severity: warning + - name: if-return + severity: warning + - name: increment-decrement + severity: warning + - name: var-naming + severity: warning + - name: range + severity: warning + - name: time-naming + severity: warning + - name: indent-error-flow + severity: warning + - name: early-return + severity: warning + +formatters: + enable: + - gofmt + - goimports + +issues: + max-issues-per-linter: 0 + max-same-issues: 0 + + exclusions: + paths: + - vendor + rules: + - path: "_test\\.go" + linters: + - gosec + text: "G101" diff --git a/CLAUDE.md b/CLAUDE.md index 859a22c..aef81f2 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -34,7 +34,7 @@ go test ./internal/server -run TestDocPage ## Tech Stack - **Language:** Go 1.25+, `CGO_ENABLED=0`, statically linked -- **Module path:** `git.wntrmute.dev/kyle/mcdoc` +- **Module path:** `git.wntrmute.dev/mc/mcdoc` - **Config:** TOML via `go-toml/v2`, env overrides via `MCDOC_*` - **HTTP:** chi router, htmx for navigation - **Rendering:** goldmark (GFM), chroma (syntax highlighting) diff --git a/Dockerfile b/Dockerfile new file mode 100644 index 0000000..1c07064 --- /dev/null +++ b/Dockerfile @@ -0,0 +1,24 @@ +FROM golang:1.25-alpine AS builder + +ARG VERSION=dev + +RUN apk add --no-cache git + +WORKDIR /build +COPY go.mod go.sum ./ +RUN go mod download + +COPY . . +RUN CGO_ENABLED=0 go build -trimpath -ldflags="-s -w -X main.version=${VERSION}" -o mcdoc ./cmd/mcdoc + +FROM alpine:3.21 + +RUN apk add --no-cache ca-certificates tzdata + +COPY --from=builder /build/mcdoc /usr/local/bin/mcdoc + +WORKDIR /srv/mcdoc +EXPOSE 8080 + +ENTRYPOINT ["mcdoc"] +CMD ["server", "--config", "/srv/mcdoc/mcdoc.toml"] diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..5775204 --- /dev/null +++ b/Makefile @@ -0,0 +1,31 @@ +.PHONY: build test vet lint clean docker all devserver + +LDFLAGS := -trimpath -ldflags="-s -w -X main.version=$(shell git describe --tags --always --dirty)" + +mcdoc: + CGO_ENABLED=0 go build $(LDFLAGS) -o mcdoc ./cmd/mcdoc + +build: + go build ./... + +test: + go test ./... + +vet: + go vet ./... + +lint: + golangci-lint run ./... + +clean: + rm -f mcdoc + +docker: + docker build --build-arg VERSION=$(shell git describe --tags --always --dirty) -t mcdoc -f Dockerfile . + +devserver: mcdoc + @mkdir -p srv + @if [ ! -f srv/mcdoc.toml ]; then cp deploy/examples/mcdoc.toml srv/mcdoc.toml; echo "Created srv/mcdoc.toml from example — edit before running."; fi + ./mcdoc server --config srv/mcdoc.toml + +all: vet lint test mcdoc diff --git a/cmd/mcdoc/main.go b/cmd/mcdoc/main.go new file mode 100644 index 0000000..153cfad --- /dev/null +++ b/cmd/mcdoc/main.go @@ -0,0 +1,25 @@ +package main + +import ( + "fmt" + "os" + + "github.com/spf13/cobra" +) + +var version = "dev" + +func main() { + root := &cobra.Command{ + Use: "mcdoc", + Short: "Metacircular documentation server", + Version: version, + } + + root.AddCommand(serverCmd()) + + if err := root.Execute(); err != nil { + fmt.Fprintf(os.Stderr, "error: %v\n", err) + os.Exit(1) + } +} diff --git a/cmd/mcdoc/server.go b/cmd/mcdoc/server.go new file mode 100644 index 0000000..5cd4812 --- /dev/null +++ b/cmd/mcdoc/server.go @@ -0,0 +1,144 @@ +package main + +import ( + "context" + "log/slog" + "net/http" + "os" + "os/signal" + "syscall" + "time" + + "github.com/spf13/cobra" + + "git.wntrmute.dev/mc/mcdoc/internal/cache" + "git.wntrmute.dev/mc/mcdoc/internal/config" + "git.wntrmute.dev/mc/mcdoc/internal/gitea" + "git.wntrmute.dev/mc/mcdoc/internal/render" + "git.wntrmute.dev/mc/mcdoc/internal/server" +) + +func serverCmd() *cobra.Command { + var configPath string + + cmd := &cobra.Command{ + Use: "server", + Short: "Start the documentation server", + RunE: func(cmd *cobra.Command, args []string) error { + return runServer(configPath) + }, + } + + cmd.Flags().StringVar(&configPath, "config", "/srv/mcdoc/mcdoc.toml", "path to config file") + + return cmd +} + +func runServer(configPath string) error { + cfg, err := config.Load(configPath) + if err != nil { + return err + } + + level := slog.LevelInfo + switch cfg.Log.Level { + case "debug": + level = slog.LevelDebug + case "warn": + level = slog.LevelWarn + case "error": + level = slog.LevelError + } + log := slog.New(slog.NewTextHandler(os.Stderr, &slog.HandlerOptions{Level: level})) + + log.Info("starting mcdoc", + "version", version, + "listen", cfg.Server.ListenAddr, + "gitea", cfg.Gitea.URL, + "org", cfg.Gitea.Org, + ) + + contentCache := cache.New() + renderer := render.New() + giteaClient := gitea.NewClient(cfg.Gitea.URL, cfg.Gitea.Org, cfg.Gitea.FetchTimeout.Duration) + + fetcher := server.NewFetcher(server.FetcherConfig{ + Client: giteaClient, + Renderer: renderer, + ExcludePaths: cfg.Gitea.ExcludePaths.Patterns, + ExcludeRepos: cfg.Gitea.ExcludeRepos.Names, + Concurrency: cfg.Gitea.MaxConcurrency, + Log: log, + }) + + ctx, cancel := context.WithCancel(context.Background()) + defer cancel() + + bgCfg := server.BackgroundConfig{ + Cache: contentCache, + Fetcher: fetcher, + PollInterval: cfg.Gitea.PollInterval.Duration, + Log: log, + } + go server.StartBackgroundFetch(ctx, bgCfg) + + refreshRepo := func(repo string) { + repos, err := giteaClient.ListRepos(ctx) + if err != nil { + log.Error("webhook: list repos failed", "error", err) + return + } + for _, r := range repos { + if r.Name == repo { + info, err := fetcher.FetchRepo(ctx, r) + if err != nil { + log.Error("webhook: fetch failed", "repo", repo, "error", err) + return + } + contentCache.SetRepo(info) + log.Info("webhook: refreshed repo", "repo", repo) + return + } + } + log.Warn("webhook: repo not found in org", "repo", repo) + } + + srv, err := server.New(server.Config{ + Cache: contentCache, + WebhookSecret: cfg.Gitea.WebhookSecret, + OnWebhook: refreshRepo, + Log: log, + }) + if err != nil { + return err + } + + httpServer := &http.Server{ + Addr: cfg.Server.ListenAddr, + Handler: srv.Handler(), + ReadTimeout: 30 * time.Second, + WriteTimeout: 30 * time.Second, + IdleTimeout: 120 * time.Second, + } + + sigCh := make(chan os.Signal, 1) + signal.Notify(sigCh, syscall.SIGINT, syscall.SIGTERM) + + errCh := make(chan error, 1) + go func() { + log.Info("listening", "addr", cfg.Server.ListenAddr) + errCh <- httpServer.ListenAndServe() + }() + + select { + case sig := <-sigCh: + log.Info("shutting down", "signal", sig) + cancel() + shutdownCtx, shutdownCancel := context.WithTimeout(context.Background(), 10*time.Second) + defer shutdownCancel() + return httpServer.Shutdown(shutdownCtx) + case err := <-errCh: + cancel() + return err + } +} diff --git a/deploy/examples/mcdoc.toml b/deploy/examples/mcdoc.toml new file mode 100644 index 0000000..7998de4 --- /dev/null +++ b/deploy/examples/mcdoc.toml @@ -0,0 +1,19 @@ +[server] +listen_addr = ":8080" + +[gitea] +url = "https://git.wntrmute.dev" +org = "mc" +webhook_secret = "change-me" +poll_interval = "15m" +fetch_timeout = "30s" +max_concurrency = 4 + +[gitea.exclude_paths] +patterns = ["vendor/", ".claude/", "node_modules/", ".junie/"] + +[gitea.exclude_repos] +names = [] + +[log] +level = "info" diff --git a/deploy/mcdoc-rift.toml b/deploy/mcdoc-rift.toml new file mode 100644 index 0000000..20f8a1e --- /dev/null +++ b/deploy/mcdoc-rift.toml @@ -0,0 +1,14 @@ +name = "mcdoc" +node = "rift" +version = "v0.1.0" + +[build.images] +mcdoc = "Dockerfile" + +[[components]] +name = "mcdoc" + +[[components.routes]] +port = 443 +mode = "l7" +hostname = "docs.metacircular.net" diff --git a/go.mod b/go.mod new file mode 100644 index 0000000..63e55d0 --- /dev/null +++ b/go.mod @@ -0,0 +1,18 @@ +module git.wntrmute.dev/mc/mcdoc + +go 1.25.7 + +require ( + github.com/alecthomas/chroma/v2 v2.18.0 + github.com/go-chi/chi/v5 v5.2.5 + github.com/pelletier/go-toml/v2 v2.3.0 + github.com/spf13/cobra v1.10.2 + github.com/yuin/goldmark v1.7.12 + github.com/yuin/goldmark-highlighting/v2 v2.0.0-20230729083705-37449abec8cc +) + +require ( + github.com/dlclark/regexp2 v1.11.5 // indirect + github.com/inconshreveable/mousetrap v1.1.0 // indirect + github.com/spf13/pflag v1.0.9 // indirect +) diff --git a/go.sum b/go.sum new file mode 100644 index 0000000..969f850 --- /dev/null +++ b/go.sum @@ -0,0 +1,39 @@ +github.com/alecthomas/assert/v2 v2.11.0 h1:2Q9r3ki8+JYXvGsDyBXwH3LcJ+WK5D0gc5E8vS6K3D0= +github.com/alecthomas/assert/v2 v2.11.0/go.mod h1:Bze95FyfUr7x34QZrjL+XP+0qgp/zg8yS+TtBj1WA3k= +github.com/alecthomas/chroma/v2 v2.2.0/go.mod h1:vf4zrexSH54oEjJ7EdB65tGNHmH3pGZmVkgTP5RHvAs= +github.com/alecthomas/chroma/v2 v2.18.0 h1:6h53Q4hW83SuF+jcsp7CVhLsMozzvQvO8HBbKQW+gn4= +github.com/alecthomas/chroma/v2 v2.18.0/go.mod h1:RVX6AvYm4VfYe/zsk7mjHueLDZor3aWCNE14TFlepBk= +github.com/alecthomas/repr v0.0.0-20220113201626-b1b626ac65ae/go.mod h1:2kn6fqh/zIyPLmm3ugklbEi5hg5wS435eygvNfaDQL8= +github.com/alecthomas/repr v0.4.0 h1:GhI2A8MACjfegCPVq9f1FLvIBS+DrQ2KQBFZP1iFzXc= +github.com/alecthomas/repr v0.4.0/go.mod h1:Fr0507jx4eOXV7AlPV6AVZLYrLIuIeSOWtW57eE/O/4= +github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g= +github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/dlclark/regexp2 v1.4.0/go.mod h1:2pZnwuY/m+8K6iRw6wQdMtk+rH5tNGR1i55kozfMjCc= +github.com/dlclark/regexp2 v1.7.0/go.mod h1:DHkYz0B9wPfa6wondMfaivmHpzrQ3v9q8cnmRbL6yW8= +github.com/dlclark/regexp2 v1.11.5 h1:Q/sSnsKerHeCkc/jSTNq1oCm7KiVgUMZRDUoRu0JQZQ= +github.com/dlclark/regexp2 v1.11.5/go.mod h1:DHkYz0B9wPfa6wondMfaivmHpzrQ3v9q8cnmRbL6yW8= +github.com/go-chi/chi/v5 v5.2.5 h1:Eg4myHZBjyvJmAFjFvWgrqDTXFyOzjj7YIm3L3mu6Ug= +github.com/go-chi/chi/v5 v5.2.5/go.mod h1:X7Gx4mteadT3eDOMTsXzmI4/rwUpOwBHLpAfupzFJP0= +github.com/hexops/gotextdiff v1.0.3 h1:gitA9+qJrrTCsiCl7+kh75nPqQt1cx4ZkudSTLoUqJM= +github.com/hexops/gotextdiff v1.0.3/go.mod h1:pSWU5MAI3yDq+fZBTazCSJysOMbxWL1BSow5/V2vxeg= +github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8= +github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw= +github.com/pelletier/go-toml/v2 v2.3.0 h1:k59bC/lIZREW0/iVaQR8nDHxVq8OVlIzYCOJf421CaM= +github.com/pelletier/go-toml/v2 v2.3.0/go.mod h1:2gIqNv+qfxSVS7cM2xJQKtLSTLUE9V8t9Stt+h56mCY= +github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM= +github.com/spf13/cobra v1.10.2 h1:DMTTonx5m65Ic0GOoRY2c16WCbHxOOw6xxezuLaBpcU= +github.com/spf13/cobra v1.10.2/go.mod h1:7C1pvHqHw5A4vrJfjNwvOdzYu0Gml16OCs2GRiTUUS4= +github.com/spf13/pflag v1.0.9 h1:9exaQaMOCwffKiiiYk6/BndUBv+iRViNW+4lEMi0PvY= +github.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg= +github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= +github.com/yuin/goldmark v1.4.15/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY= +github.com/yuin/goldmark v1.7.12 h1:YwGP/rrea2/CnCtUHgjuolG/PnMxdQtPMO5PvaE2/nY= +github.com/yuin/goldmark v1.7.12/go.mod h1:ip/1k0VRfGynBgxOz0yCqHrbZXhcjxyuS66Brc7iBKg= +github.com/yuin/goldmark-highlighting/v2 v2.0.0-20230729083705-37449abec8cc h1:+IAOyRda+RLrxa1WC7umKOZRsGq4QrFFMYApOeHzQwQ= +github.com/yuin/goldmark-highlighting/v2 v2.0.0-20230729083705-37449abec8cc/go.mod h1:ovIvrum6DQJA4QsJSovrkC4saKHQVs7TvcaeO8AIl5I= +go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg= +gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= diff --git a/internal/cache/cache.go b/internal/cache/cache.go new file mode 100644 index 0000000..dfe1140 --- /dev/null +++ b/internal/cache/cache.go @@ -0,0 +1,159 @@ +package cache + +import ( + "sort" + "strings" + "sync" + "time" + + "git.wntrmute.dev/mc/mcdoc/internal/render" +) + +// Document represents a single rendered markdown document. +type Document struct { + Repo string + FilePath string // original path with .md extension + URLPath string // path without .md extension + Title string // first heading or filename + HTML string + Headings []render.Heading + LastUpdated time.Time +} + +// RepoInfo holds metadata about a repository and its documents. +type RepoInfo struct { + Name string + Description string + Docs []*Document + CommitSHA string + FetchedAt time.Time +} + +// Cache stores rendered documents in memory with atomic per-repo swaps. +type Cache struct { + mu sync.RWMutex + repos map[string]*RepoInfo + ready bool +} + +// New creates an empty cache. +func New() *Cache { + return &Cache{ + repos: make(map[string]*RepoInfo), + } +} + +// SetRepo atomically replaces all documents for a repository. +func (c *Cache) SetRepo(info *RepoInfo) { + sortDocs(info.Docs) + + c.mu.Lock() + c.repos[info.Name] = info + c.mu.Unlock() +} + +// RemoveRepo removes a repository from the cache. +func (c *Cache) RemoveRepo(name string) { + c.mu.Lock() + delete(c.repos, name) + c.mu.Unlock() +} + +// SetReady marks the cache as ready to serve requests. +func (c *Cache) SetReady() { + c.mu.Lock() + c.ready = true + c.mu.Unlock() +} + +// IsReady returns whether the initial fetch has completed. +func (c *Cache) IsReady() bool { + c.mu.RLock() + defer c.mu.RUnlock() + return c.ready +} + +// ListRepos returns all cached repos, sorted by name. +func (c *Cache) ListRepos() []*RepoInfo { + c.mu.RLock() + defer c.mu.RUnlock() + + repos := make([]*RepoInfo, 0, len(c.repos)) + for _, r := range c.repos { + repos = append(repos, r) + } + sort.Slice(repos, func(i, j int) bool { + return repos[i].Name < repos[j].Name + }) + return repos +} + +// GetRepo returns info for a specific repository. +func (c *Cache) GetRepo(name string) (*RepoInfo, bool) { + c.mu.RLock() + defer c.mu.RUnlock() + r, ok := c.repos[name] + return r, ok +} + +// GetDocument returns a document by repo name and URL path. +func (c *Cache) GetDocument(repo, urlPath string) (*Document, bool) { + c.mu.RLock() + defer c.mu.RUnlock() + + r, ok := c.repos[repo] + if !ok { + return nil, false + } + + for _, doc := range r.Docs { + if doc.URLPath == urlPath { + return doc, true + } + } + return nil, false +} + +// GetCommitSHA returns the cached commit SHA for a repo. +func (c *Cache) GetCommitSHA(repo string) string { + c.mu.RLock() + defer c.mu.RUnlock() + + r, ok := c.repos[repo] + if !ok { + return "" + } + return r.CommitSHA +} + +// docPriority defines the sort order for well-known filenames. +var docPriority = map[string]int{ + "README": 0, + "ARCHITECTURE": 1, + "RUNBOOK": 2, + "CLAUDE": 3, +} + +func sortDocs(docs []*Document) { + sort.Slice(docs, func(i, j int) bool { + pi, oki := docPriority[baseNameUpper(docs[i].URLPath)] + pj, okj := docPriority[baseNameUpper(docs[j].URLPath)] + + switch { + case oki && okj: + return pi < pj + case oki: + return true + case okj: + return false + default: + return strings.ToLower(docs[i].URLPath) < strings.ToLower(docs[j].URLPath) + } + }) +} + +func baseNameUpper(urlPath string) string { + parts := strings.Split(urlPath, "/") + base := parts[len(parts)-1] + return strings.ToUpper(base) +} diff --git a/internal/cache/cache_test.go b/internal/cache/cache_test.go new file mode 100644 index 0000000..f0568d8 --- /dev/null +++ b/internal/cache/cache_test.go @@ -0,0 +1,165 @@ +package cache + +import ( + "testing" + "time" + + "git.wntrmute.dev/mc/mcdoc/internal/render" +) + +func TestSetAndGetRepo(t *testing.T) { + c := New() + + info := &RepoInfo{ + Name: "testrepo", + Description: "A test repo", + CommitSHA: "abc123", + FetchedAt: time.Now(), + Docs: []*Document{ + {Repo: "testrepo", URLPath: "README", Title: "README", HTML: "

hello

"}, + {Repo: "testrepo", URLPath: "ARCHITECTURE", Title: "Architecture", HTML: "

arch

"}, + }, + } + c.SetRepo(info) + + got, ok := c.GetRepo("testrepo") + if !ok { + t.Fatal("expected repo to exist") + } + if got.Name != "testrepo" { + t.Fatalf("got name %q, want %q", got.Name, "testrepo") + } + if len(got.Docs) != 2 { + t.Fatalf("got %d docs, want 2", len(got.Docs)) + } +} + +func TestGetDocument(t *testing.T) { + c := New() + c.SetRepo(&RepoInfo{ + Name: "r", + Docs: []*Document{ + {Repo: "r", URLPath: "foo/bar", Title: "Bar", HTML: "

bar

"}, + }, + }) + + doc, ok := c.GetDocument("r", "foo/bar") + if !ok { + t.Fatal("expected document to exist") + } + if doc.Title != "Bar" { + t.Fatalf("got title %q, want %q", doc.Title, "Bar") + } + + _, ok = c.GetDocument("r", "nonexistent") + if ok { + t.Fatal("expected document to not exist") + } + + _, ok = c.GetDocument("nonexistent", "foo/bar") + if ok { + t.Fatal("expected repo to not exist") + } +} + +func TestListReposSorted(t *testing.T) { + c := New() + c.SetRepo(&RepoInfo{Name: "mcr"}) + c.SetRepo(&RepoInfo{Name: "abc"}) + c.SetRepo(&RepoInfo{Name: "mcp"}) + + repos := c.ListRepos() + if len(repos) != 3 { + t.Fatalf("got %d repos, want 3", len(repos)) + } + if repos[0].Name != "abc" || repos[1].Name != "mcp" || repos[2].Name != "mcr" { + t.Fatalf("unexpected order: %s, %s, %s", repos[0].Name, repos[1].Name, repos[2].Name) + } +} + +func TestDocSortOrder(t *testing.T) { + c := New() + c.SetRepo(&RepoInfo{ + Name: "r", + Docs: []*Document{ + {URLPath: "CLAUDE"}, + {URLPath: "zebra"}, + {URLPath: "README"}, + {URLPath: "ARCHITECTURE"}, + {URLPath: "alpha"}, + {URLPath: "RUNBOOK"}, + }, + }) + + repo, _ := c.GetRepo("r") + expected := []string{"README", "ARCHITECTURE", "RUNBOOK", "CLAUDE", "alpha", "zebra"} + for i, doc := range repo.Docs { + if doc.URLPath != expected[i] { + t.Errorf("position %d: got %q, want %q", i, doc.URLPath, expected[i]) + } + } +} + +func TestReadyState(t *testing.T) { + c := New() + if c.IsReady() { + t.Fatal("new cache should not be ready") + } + c.SetReady() + if !c.IsReady() { + t.Fatal("cache should be ready after SetReady") + } +} + +func TestGetCommitSHA(t *testing.T) { + c := New() + if sha := c.GetCommitSHA("nope"); sha != "" { + t.Fatalf("expected empty sha, got %q", sha) + } + + c.SetRepo(&RepoInfo{Name: "r", CommitSHA: "abc123"}) + if sha := c.GetCommitSHA("r"); sha != "abc123" { + t.Fatalf("expected abc123, got %q", sha) + } +} + +func TestAtomicRepoSwap(t *testing.T) { + c := New() + c.SetRepo(&RepoInfo{ + Name: "r", + Docs: []*Document{{URLPath: "old", Title: "Old"}}, + }) + + c.SetRepo(&RepoInfo{ + Name: "r", + Docs: []*Document{{URLPath: "new", Title: "New"}}, + }) + + repo, _ := c.GetRepo("r") + if len(repo.Docs) != 1 || repo.Docs[0].URLPath != "new" { + t.Fatal("expected atomic swap to replace docs") + } +} + +func TestRemoveRepo(t *testing.T) { + c := New() + c.SetRepo(&RepoInfo{Name: "r"}) + c.RemoveRepo("r") + + _, ok := c.GetRepo("r") + if ok { + t.Fatal("expected repo to be removed") + } +} + +// Ensure Document's Headings field works with the render package type. +func TestDocumentHeadingsType(t *testing.T) { + doc := &Document{ + Headings: []render.Heading{ + {Level: 1, ID: "title", Text: "Title"}, + }, + } + if doc.Headings[0].Text != "Title" { + t.Fatal("unexpected heading text") + } +} diff --git a/internal/config/config.go b/internal/config/config.go new file mode 100644 index 0000000..6be0fbb --- /dev/null +++ b/internal/config/config.go @@ -0,0 +1,164 @@ +package config + +import ( + "fmt" + "os" + "reflect" + "strings" + "time" + + "github.com/pelletier/go-toml/v2" +) + +type Config struct { + Server ServerConfig `toml:"server"` + Gitea GiteaConfig `toml:"gitea"` + Log LogConfig `toml:"log"` +} + +type ServerConfig struct { + ListenAddr string `toml:"listen_addr"` +} + +type GiteaConfig struct { + URL string `toml:"url"` + Org string `toml:"org"` + WebhookSecret string `toml:"webhook_secret"` + PollInterval Duration `toml:"poll_interval"` + FetchTimeout Duration `toml:"fetch_timeout"` + MaxConcurrency int `toml:"max_concurrency"` + ExcludePaths ExcludePaths `toml:"exclude_paths"` + ExcludeRepos ExcludeRepos `toml:"exclude_repos"` +} + +type ExcludePaths struct { + Patterns []string `toml:"patterns"` +} + +type ExcludeRepos struct { + Names []string `toml:"names"` +} + +type LogConfig struct { + Level string `toml:"level"` +} + +// Duration wraps time.Duration for TOML string parsing. +type Duration struct { + time.Duration +} + +func (d *Duration) UnmarshalText(text []byte) error { + var err error + d.Duration, err = time.ParseDuration(string(text)) + return err +} + +func (d Duration) MarshalText() ([]byte, error) { + return []byte(d.String()), nil +} + +func Load(path string) (*Config, error) { + data, err := os.ReadFile(path) // #nosec G304 -- config path is operator-controlled + if err != nil { + return nil, fmt.Errorf("read config: %w", err) + } + + cfg := &Config{ + Server: ServerConfig{ + ListenAddr: ":8080", + }, + Gitea: GiteaConfig{ + URL: "https://git.wntrmute.dev", + Org: "mc", + PollInterval: Duration{15 * time.Minute}, + FetchTimeout: Duration{30 * time.Second}, + MaxConcurrency: 4, + ExcludePaths: ExcludePaths{ + Patterns: []string{"vendor/", ".claude/", "node_modules/", ".junie/"}, + }, + }, + Log: LogConfig{ + Level: "info", + }, + } + + if err := toml.Unmarshal(data, cfg); err != nil { + return nil, fmt.Errorf("parse config: %w", err) + } + + applyEnvOverrides(cfg) + + if err := cfg.validate(); err != nil { + return nil, fmt.Errorf("validate config: %w", err) + } + + return cfg, nil +} + +func (c *Config) validate() error { + if c.Server.ListenAddr == "" { + return fmt.Errorf("server.listen_addr is required") + } + if c.Gitea.URL == "" { + return fmt.Errorf("gitea.url is required") + } + if c.Gitea.Org == "" { + return fmt.Errorf("gitea.org is required") + } + if c.Gitea.MaxConcurrency < 1 { + return fmt.Errorf("gitea.max_concurrency must be >= 1") + } + return nil +} + +// applyEnvOverrides checks for MCDOC_* environment variables and applies +// them to the config. Also checks $PORT for MCP agent port assignment. +func applyEnvOverrides(cfg *Config) { + if port := os.Getenv("PORT"); port != "" { + cfg.Server.ListenAddr = ":" + port + } + + applyEnvToStruct("MCDOC", reflect.ValueOf(cfg).Elem()) +} + +func applyEnvToStruct(prefix string, v reflect.Value) { + t := v.Type() + for i := range t.NumField() { + field := t.Field(i) + fv := v.Field(i) + + tag := field.Tag.Get("toml") + if tag == "" || tag == "-" { + continue + } + + envKey := prefix + "_" + strings.ToUpper(tag) + + if fv.Kind() == reflect.Struct && field.Type != reflect.TypeOf(Duration{}) { + applyEnvToStruct(envKey, fv) + continue + } + + envVal := os.Getenv(envKey) + if envVal == "" { + continue + } + + switch fv.Kind() { + case reflect.String: + fv.SetString(envVal) + case reflect.Int: + var n int + if _, err := fmt.Sscanf(envVal, "%d", &n); err == nil { + fv.SetInt(int64(n)) + } + } + + if field.Type == reflect.TypeOf(Duration{}) { + if d, err := time.ParseDuration(envVal); err == nil { + fv.Set(reflect.ValueOf(Duration{d})) + } + } + } +} diff --git a/internal/config/config_test.go b/internal/config/config_test.go new file mode 100644 index 0000000..7f40018 --- /dev/null +++ b/internal/config/config_test.go @@ -0,0 +1,154 @@ +package config + +import ( + "os" + "path/filepath" + "testing" + "time" +) + +func TestLoadValidConfig(t *testing.T) { + dir := t.TempDir() + path := filepath.Join(dir, "mcdoc.toml") + + content := ` +[server] +listen_addr = ":9090" + +[gitea] +url = "https://git.example.com" +org = "myorg" +webhook_secret = "secret123" +poll_interval = "5m" +fetch_timeout = "10s" +max_concurrency = 2 + +[gitea.exclude_paths] +patterns = ["vendor/"] + +[gitea.exclude_repos] +names = ["ignore-me"] + +[log] +level = "debug" +` + if err := os.WriteFile(path, []byte(content), 0600); err != nil { + t.Fatalf("write config: %v", err) + } + + cfg, err := Load(path) + if err != nil { + t.Fatalf("load: %v", err) + } + + if cfg.Server.ListenAddr != ":9090" { + t.Fatalf("listen_addr = %q, want :9090", cfg.Server.ListenAddr) + } + if cfg.Gitea.URL != "https://git.example.com" { + t.Fatalf("gitea.url = %q", cfg.Gitea.URL) + } + if cfg.Gitea.Org != "myorg" { + t.Fatalf("gitea.org = %q", cfg.Gitea.Org) + } + if cfg.Gitea.PollInterval.Duration != 5*time.Minute { + t.Fatalf("poll_interval = %v", cfg.Gitea.PollInterval.Duration) + } + if cfg.Gitea.FetchTimeout.Duration != 10*time.Second { + t.Fatalf("fetch_timeout = %v", cfg.Gitea.FetchTimeout.Duration) + } + if cfg.Gitea.MaxConcurrency != 2 { + t.Fatalf("max_concurrency = %d", cfg.Gitea.MaxConcurrency) + } + if len(cfg.Gitea.ExcludePaths.Patterns) != 1 { + t.Fatalf("exclude_paths = %v", cfg.Gitea.ExcludePaths.Patterns) + } + if len(cfg.Gitea.ExcludeRepos.Names) != 1 { + t.Fatalf("exclude_repos = %v", cfg.Gitea.ExcludeRepos.Names) + } + if cfg.Log.Level != "debug" { + t.Fatalf("log.level = %q", cfg.Log.Level) + } +} + +func TestLoadDefaults(t *testing.T) { + dir := t.TempDir() + path := filepath.Join(dir, "mcdoc.toml") + + // Minimal config — everything should get defaults + if err := os.WriteFile(path, []byte(""), 0600); err != nil { + t.Fatalf("write config: %v", err) + } + + cfg, err := Load(path) + if err != nil { + t.Fatalf("load: %v", err) + } + + if cfg.Server.ListenAddr != ":8080" { + t.Fatalf("default listen_addr = %q, want :8080", cfg.Server.ListenAddr) + } + if cfg.Gitea.URL != "https://git.wntrmute.dev" { + t.Fatalf("default gitea.url = %q", cfg.Gitea.URL) + } + if cfg.Gitea.PollInterval.Duration != 15*time.Minute { + t.Fatalf("default poll_interval = %v", cfg.Gitea.PollInterval.Duration) + } +} + +func TestLoadMissingFile(t *testing.T) { + _, err := Load("/nonexistent/mcdoc.toml") + if err == nil { + t.Fatal("expected error for missing file") + } +} + +func TestPortEnvOverride(t *testing.T) { + dir := t.TempDir() + path := filepath.Join(dir, "mcdoc.toml") + if err := os.WriteFile(path, []byte(""), 0600); err != nil { + t.Fatalf("write config: %v", err) + } + + t.Setenv("PORT", "12345") + cfg, err := Load(path) + if err != nil { + t.Fatalf("load: %v", err) + } + if cfg.Server.ListenAddr != ":12345" { + t.Fatalf("PORT override: got %q, want :12345", cfg.Server.ListenAddr) + } +} + +func TestEnvOverride(t *testing.T) { + dir := t.TempDir() + path := filepath.Join(dir, "mcdoc.toml") + if err := os.WriteFile(path, []byte(""), 0600); err != nil { + t.Fatalf("write config: %v", err) + } + + t.Setenv("MCDOC_GITEA_ORG", "custom-org") + cfg, err := Load(path) + if err != nil { + t.Fatalf("load: %v", err) + } + if cfg.Gitea.Org != "custom-org" { + t.Fatalf("env override: got %q, want custom-org", cfg.Gitea.Org) + } +} + +func TestValidationFailsOnEmptyURL(t *testing.T) { + dir := t.TempDir() + path := filepath.Join(dir, "mcdoc.toml") + content := ` +[gitea] +url = "" +` + if err := os.WriteFile(path, []byte(content), 0600); err != nil { + t.Fatalf("write config: %v", err) + } + + _, err := Load(path) + if err == nil { + t.Fatal("expected validation error for empty gitea.url") + } +} diff --git a/internal/gitea/client.go b/internal/gitea/client.go new file mode 100644 index 0000000..ef22136 --- /dev/null +++ b/internal/gitea/client.go @@ -0,0 +1,161 @@ +package gitea + +import ( + "context" + "encoding/json" + "fmt" + "io" + "net/http" + "strings" + "time" +) + +// Repo represents a Gitea repository. +type Repo struct { + Name string `json:"name"` + Description string `json:"description"` + DefaultBranch string `json:"default_branch"` +} + +// TreeEntry represents a file in a Gitea repo tree. +type TreeEntry struct { + Path string `json:"path"` + Type string `json:"type"` // "blob" or "tree" +} + +// TreeResponse is the Gitea API response for a recursive tree listing. +type TreeResponse struct { + Tree []TreeEntry `json:"tree"` +} + +// CommitMeta holds minimal commit info for a file. +type CommitMeta struct { + SHA string `json:"sha"` + Date time.Time `json:"-"` +} + +// RepoCommit is used to extract the latest commit SHA for a repo. +type RepoCommit struct { + SHA string `json:"sha"` + Commit repoCommitInfo `json:"commit"` +} + +type repoCommitInfo struct { + Committer commitPerson `json:"committer"` +} + +type commitPerson struct { + Date time.Time `json:"date"` +} + +// Client fetches content from a Gitea instance. +type Client struct { + baseURL string + org string + httpClient *http.Client +} + +// NewClient creates a Gitea API client. +func NewClient(baseURL, org string, timeout time.Duration) *Client { + return &Client{ + baseURL: strings.TrimRight(baseURL, "/"), + org: org, + httpClient: &http.Client{ + Timeout: timeout, + }, + } +} + +// ListRepos returns all repositories in the configured organization. +func (c *Client) ListRepos(ctx context.Context) ([]Repo, error) { + var allRepos []Repo + page := 1 + + for { + url := fmt.Sprintf("%s/api/v1/orgs/%s/repos?page=%d&limit=50", c.baseURL, c.org, page) + var repos []Repo + if err := c.getJSON(ctx, url, &repos); err != nil { + return nil, fmt.Errorf("list repos page %d: %w", page, err) + } + if len(repos) == 0 { + break + } + allRepos = append(allRepos, repos...) + page++ + } + + return allRepos, nil +} + +// ListMarkdownFiles returns paths to all .md files in a repo's default branch. +func (c *Client) ListMarkdownFiles(ctx context.Context, repo, branch string) ([]string, error) { + url := fmt.Sprintf("%s/api/v1/repos/%s/%s/git/trees/%s?recursive=true", + c.baseURL, c.org, repo, branch) + + var tree TreeResponse + if err := c.getJSON(ctx, url, &tree); err != nil { + return nil, fmt.Errorf("list tree for %s: %w", repo, err) + } + + var files []string + for _, entry := range tree.Tree { + if entry.Type == "blob" && strings.HasSuffix(strings.ToLower(entry.Path), ".md") { + files = append(files, entry.Path) + } + } + return files, nil +} + +// FetchFileContent returns the raw content of a file in a repo. +func (c *Client) FetchFileContent(ctx context.Context, repo, branch, filepath string) ([]byte, error) { + url := fmt.Sprintf("%s/api/v1/repos/%s/%s/raw/%s?ref=%s", + c.baseURL, c.org, repo, filepath, branch) + return c.getRaw(ctx, url) +} + +// LatestCommitSHA returns the SHA of the latest commit on a branch. +func (c *Client) LatestCommitSHA(ctx context.Context, repo, branch string) (string, time.Time, error) { + url := fmt.Sprintf("%s/api/v1/repos/%s/%s/commits?sha=%s&limit=1", + c.baseURL, c.org, repo, branch) + + var commits []RepoCommit + if err := c.getJSON(ctx, url, &commits); err != nil { + return "", time.Time{}, fmt.Errorf("latest commit for %s: %w", repo, err) + } + if len(commits) == 0 { + return "", time.Time{}, fmt.Errorf("no commits found for %s/%s", repo, branch) + } + + return commits[0].SHA, commits[0].Commit.Committer.Date, nil +} + +func (c *Client) getJSON(ctx context.Context, url string, target interface{}) error { + body, err := c.getRaw(ctx, url) + if err != nil { + return err + } + return json.Unmarshal(body, target) +} + +func (c *Client) getRaw(ctx context.Context, url string) ([]byte, error) { + req, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil) + if err != nil { + return nil, fmt.Errorf("create request: %w", err) + } + + resp, err := c.httpClient.Do(req) + if err != nil { + return nil, fmt.Errorf("fetch %s: %w", url, err) + } + defer func() { _ = resp.Body.Close() }() + + if resp.StatusCode != http.StatusOK { + return nil, fmt.Errorf("fetch %s: status %d", url, resp.StatusCode) + } + + body, err := io.ReadAll(resp.Body) + if err != nil { + return nil, fmt.Errorf("read response from %s: %w", url, err) + } + return body, nil +} diff --git a/internal/render/render.go b/internal/render/render.go new file mode 100644 index 0000000..ada919f --- /dev/null +++ b/internal/render/render.go @@ -0,0 +1,123 @@ +package render + +import ( + "bytes" + "fmt" + "regexp" + "strings" + + chromahtml "github.com/alecthomas/chroma/v2/formatters/html" + "github.com/yuin/goldmark" + highlighting "github.com/yuin/goldmark-highlighting/v2" + "github.com/yuin/goldmark/ast" + "github.com/yuin/goldmark/extension" + "github.com/yuin/goldmark/parser" + "github.com/yuin/goldmark/renderer/html" + "github.com/yuin/goldmark/text" +) + +// Heading represents a heading extracted from a document for TOC generation. +type Heading struct { + Level int + ID string + Text string +} + +// Result holds the rendered HTML and extracted metadata. +type Result struct { + HTML string + Headings []Heading +} + +// Renderer converts markdown to HTML using goldmark. +type Renderer struct { + md goldmark.Markdown +} + +// New creates a Renderer with GFM, syntax highlighting, and heading anchors. +func New() *Renderer { + md := goldmark.New( + goldmark.WithExtensions( + extension.GFM, + highlighting.NewHighlighting( + highlighting.WithStyle("github"), + highlighting.WithFormatOptions( + chromahtml.WithClasses(true), + ), + ), + ), + goldmark.WithParserOptions( + parser.WithAutoHeadingID(), + ), + goldmark.WithRendererOptions( + html.WithUnsafe(), + ), + ) + + return &Renderer{md: md} +} + +// Render converts markdown source to HTML and extracts headings. +func (r *Renderer) Render(source []byte) (*Result, error) { + var buf bytes.Buffer + if err := r.md.Convert(source, &buf); err != nil { + return nil, fmt.Errorf("render markdown: %w", err) + } + + headings := extractHeadings(source, r.md.Parser()) + + return &Result{ + HTML: buf.String(), + Headings: headings, + }, nil +} + +func extractHeadings(source []byte, p parser.Parser) []Heading { + reader := text.NewReader(source) + doc := p.Parse(reader) + + var headings []Heading + _ = ast.Walk(doc, func(n ast.Node, entering bool) (ast.WalkStatus, error) { + if !entering { + return ast.WalkContinue, nil + } + + heading, ok := n.(*ast.Heading) + if !ok { + return ast.WalkContinue, nil + } + + id, _ := n.AttributeString("id") + idStr := "" + if idBytes, ok := id.([]byte); ok { + idStr = string(idBytes) + } + + var textBuf bytes.Buffer + for child := n.FirstChild(); child != nil; child = child.NextSibling() { + if t, ok := child.(*ast.Text); ok { + textBuf.Write(t.Segment.Value(source)) + } + } + + headings = append(headings, Heading{ + Level: heading.Level, + ID: idStr, + Text: textBuf.String(), + }) + + return ast.WalkContinue, nil + }) + + return headings +} + +var nonAlphanumeric = regexp.MustCompile(`[^a-z0-9]+`) + +// Slugify creates a URL-safe slug from text, matching goldmark's auto heading IDs. +func Slugify(text string) string { + text = strings.ToLower(text) + text = nonAlphanumeric.ReplaceAllString(text, "-") + text = strings.Trim(text, "-") + return text +} diff --git a/internal/render/render_test.go b/internal/render/render_test.go new file mode 100644 index 0000000..eb9d991 --- /dev/null +++ b/internal/render/render_test.go @@ -0,0 +1,99 @@ +package render + +import ( + "strings" + "testing" +) + +func TestRenderBasicMarkdown(t *testing.T) { + r := New() + result, err := r.Render([]byte("# Hello\n\nThis is a paragraph.")) + if err != nil { + t.Fatalf("render: %v", err) + } + if !strings.Contains(result.HTML, "This is a paragraph.

") { + t.Fatalf("expected paragraph, got: %s", result.HTML) + } +} + +func TestRenderGFMTable(t *testing.T) { + md := "| A | B |\n|---|---|\n| 1 | 2 |" + r := New() + result, err := r.Render([]byte(md)) + if err != nil { + t.Fatalf("render: %v", err) + } + if !strings.Contains(result.HTML, "") { + t.Fatalf("expected table, got: %s", result.HTML) + } +} + +func TestRenderCodeHighlighting(t *testing.T) { + md := "```go\nfunc main() {}\n```" + r := New() + result, err := r.Render([]byte(md)) + if err != nil { + t.Fatalf("render: %v", err) + } + // chroma with classes should produce class attributes + if !strings.Contains(result.HTML, "class=") { + t.Fatalf("expected syntax highlighting classes, got: %s", result.HTML) + } +} + +func TestExtractHeadings(t *testing.T) { + md := "# Title\n## Section\n### Subsection" + r := New() + result, err := r.Render([]byte(md)) + if err != nil { + t.Fatalf("render: %v", err) + } + if len(result.Headings) != 3 { + t.Fatalf("expected 3 headings, got %d", len(result.Headings)) + } + if result.Headings[0].Level != 1 || result.Headings[0].Text != "Title" { + t.Fatalf("unexpected first heading: %+v", result.Headings[0]) + } + if result.Headings[1].Level != 2 || result.Headings[1].Text != "Section" { + t.Fatalf("unexpected second heading: %+v", result.Headings[1]) + } +} + +func TestHeadingAnchors(t *testing.T) { + md := "# Hello World" + r := New() + result, err := r.Render([]byte(md)) + if err != nil { + t.Fatalf("render: %v", err) + } + if len(result.Headings) == 0 { + t.Fatal("no headings extracted") + } + if result.Headings[0].ID == "" { + t.Fatal("expected heading ID to be set") + } +} + +func TestSlugify(t *testing.T) { + tests := []struct { + input string + want string + }{ + {"Hello World", "hello-world"}, + {"API Design", "api-design"}, + {"foo--bar", "foo-bar"}, + {" leading spaces ", "leading-spaces"}, + } + for _, tt := range tests { + got := Slugify(tt.input) + if got != tt.want { + t.Errorf("Slugify(%q) = %q, want %q", tt.input, got, tt.want) + } + } +} diff --git a/internal/server/fetch.go b/internal/server/fetch.go new file mode 100644 index 0000000..9439ecf --- /dev/null +++ b/internal/server/fetch.go @@ -0,0 +1,218 @@ +package server + +import ( + "context" + "log/slog" + "path/filepath" + "strings" + "sync" + "time" + + "git.wntrmute.dev/mc/mcdoc/internal/cache" + "git.wntrmute.dev/mc/mcdoc/internal/gitea" + "git.wntrmute.dev/mc/mcdoc/internal/render" +) + +// Fetcher coordinates fetching content from Gitea and populating the cache. +type Fetcher struct { + client *gitea.Client + renderer *render.Renderer + excludePaths []string + excludeRepos map[string]bool + concurrency int + log *slog.Logger +} + +// FetcherConfig holds fetcher configuration. +type FetcherConfig struct { + Client *gitea.Client + Renderer *render.Renderer + ExcludePaths []string + ExcludeRepos []string + Concurrency int + Log *slog.Logger +} + +// NewFetcher creates a Fetcher. +func NewFetcher(cfg FetcherConfig) *Fetcher { + excludeRepos := make(map[string]bool, len(cfg.ExcludeRepos)) + for _, name := range cfg.ExcludeRepos { + excludeRepos[name] = true + } + + if cfg.Concurrency < 1 { + cfg.Concurrency = 4 + } + if cfg.Log == nil { + cfg.Log = slog.Default() + } + + return &Fetcher{ + client: cfg.Client, + renderer: cfg.Renderer, + excludePaths: cfg.ExcludePaths, + excludeRepos: excludeRepos, + concurrency: cfg.Concurrency, + log: cfg.Log, + } +} + +// FetchRepo fetches and renders all markdown files for a single repo. +func (f *Fetcher) FetchRepo(ctx context.Context, repo gitea.Repo) (*cache.RepoInfo, error) { + files, err := f.client.ListMarkdownFiles(ctx, repo.Name, repo.DefaultBranch) + if err != nil { + return nil, err + } + + sha, commitDate, err := f.client.LatestCommitSHA(ctx, repo.Name, repo.DefaultBranch) + if err != nil { + f.log.Warn("could not get latest commit", "repo", repo.Name, "error", err) + } + + var docs []*cache.Document + for _, filePath := range files { + if f.isExcluded(filePath) { + continue + } + + content, err := f.client.FetchFileContent(ctx, repo.Name, repo.DefaultBranch, filePath) + if err != nil { + f.log.Warn("skip file", "repo", repo.Name, "file", filePath, "error", err) + continue + } + + result, err := f.renderer.Render(content) + if err != nil { + f.log.Warn("render failed", "repo", repo.Name, "file", filePath, "error", err) + continue + } + + urlPath := strings.TrimSuffix(filePath, filepath.Ext(filePath)) + title := titleFromHeadings(result.Headings) + if title == "" { + title = titleFromPath(filePath) + } + + docs = append(docs, &cache.Document{ + Repo: repo.Name, + FilePath: filePath, + URLPath: urlPath, + Title: title, + HTML: result.HTML, + Headings: result.Headings, + LastUpdated: commitDate, + }) + } + + return &cache.RepoInfo{ + Name: repo.Name, + Description: repo.Description, + Docs: docs, + CommitSHA: sha, + FetchedAt: time.Now(), + }, nil +} + +func (f *Fetcher) isExcluded(filePath string) bool { + for _, pattern := range f.excludePaths { + if strings.Contains(filePath, pattern) { + return true + } + } + return false +} + +func titleFromHeadings(headings []render.Heading) string { + for _, h := range headings { + if h.Level == 1 { + return h.Text + } + } + if len(headings) > 0 { + return headings[0].Text + } + return "" +} + +func titleFromPath(filePath string) string { + base := filepath.Base(filePath) + return strings.TrimSuffix(base, filepath.Ext(base)) +} + +func fetchAllRepos(ctx context.Context, cfg BackgroundConfig) error { + repos, err := cfg.Fetcher.client.ListRepos(ctx) + if err != nil { + return err + } + + sem := make(chan struct{}, cfg.Fetcher.concurrency) + var wg sync.WaitGroup + var mu sync.Mutex + var firstErr error + + for _, repo := range repos { + if cfg.Fetcher.excludeRepos[repo.Name] { + continue + } + + wg.Add(1) + go func(r gitea.Repo) { + defer wg.Done() + sem <- struct{}{} + defer func() { <-sem }() + + info, err := cfg.Fetcher.FetchRepo(ctx, r) + if err != nil { + cfg.Log.Warn("fetch repo failed", "repo", r.Name, "error", err) + mu.Lock() + if firstErr == nil { + firstErr = err + } + mu.Unlock() + return + } + + if len(info.Docs) > 0 { + cfg.Cache.SetRepo(info) + } + cfg.Log.Info("fetched repo", "repo", r.Name, "docs", len(info.Docs)) + }(repo) + } + + wg.Wait() + return nil +} + +func pollForChanges(ctx context.Context, cfg BackgroundConfig) error { + repos, err := cfg.Fetcher.client.ListRepos(ctx) + if err != nil { + return err + } + + for _, repo := range repos { + if cfg.Fetcher.excludeRepos[repo.Name] { + continue + } + + sha, _, err := cfg.Fetcher.client.LatestCommitSHA(ctx, repo.Name, repo.DefaultBranch) + if err != nil { + cfg.Log.Warn("poll: could not check commit", "repo", repo.Name, "error", err) + continue + } + + cached := cfg.Cache.GetCommitSHA(repo.Name) + if sha == cached { + continue + } + + cfg.Log.Info("repo changed, re-fetching", "repo", repo.Name, "old_sha", cached, "new_sha", sha) + info, err := cfg.Fetcher.FetchRepo(ctx, repo) + if err != nil { + cfg.Log.Warn("poll: re-fetch failed", "repo", repo.Name, "error", err) + continue + } + cfg.Cache.SetRepo(info) + } + + return nil +} diff --git a/internal/server/server.go b/internal/server/server.go new file mode 100644 index 0000000..b64e57b --- /dev/null +++ b/internal/server/server.go @@ -0,0 +1,422 @@ +package server + +import ( + "context" + "crypto/hmac" + "crypto/sha256" + "encoding/hex" + "fmt" + "html/template" + "io" + "io/fs" + "log/slog" + "net/http" + "strings" + "time" + + "github.com/go-chi/chi/v5" + + "git.wntrmute.dev/mc/mcdoc/internal/cache" + "git.wntrmute.dev/mc/mcdoc/internal/render" + "git.wntrmute.dev/mc/mcdoc/web" +) + +// Server is the mcdoc HTTP server. +type Server struct { + cache *cache.Cache + pages map[string]*template.Template + loadingTmpl *template.Template + webhookSecret string + onWebhook func(repo string) + log *slog.Logger +} + +// Config holds server configuration. +type Config struct { + Cache *cache.Cache + WebhookSecret string + OnWebhook func(repo string) + Log *slog.Logger +} + +// New creates a server with its routes. +func New(cfg Config) (*Server, error) { + tmplFS, err := fs.Sub(web.Content, "templates") + if err != nil { + return nil, fmt.Errorf("open templates: %w", err) + } + + funcMap := template.FuncMap{ + "safeHTML": func(s string) template.HTML { + return template.HTML(s) // #nosec G203 -- content is rendered from markdown by our own renderer + }, + } + + layoutTmpl, err := template.New("layout.html").Funcs(funcMap).ParseFS(tmplFS, "layout.html") + if err != nil { + return nil, fmt.Errorf("parse layout: %w", err) + } + + pageNames := []string{"index.html", "repo.html", "doc.html", "error.html"} + pages := make(map[string]*template.Template, len(pageNames)) + for _, name := range pageNames { + clone, err := layoutTmpl.Clone() + if err != nil { + return nil, fmt.Errorf("clone layout for %s: %w", name, err) + } + _, err = clone.ParseFS(tmplFS, name) + if err != nil { + return nil, fmt.Errorf("parse %s: %w", name, err) + } + pages[name] = clone + } + + loadingTmpl, err := template.New("loading.html").ParseFS(tmplFS, "loading.html") + if err != nil { + return nil, fmt.Errorf("parse loading template: %w", err) + } + + if cfg.Log == nil { + cfg.Log = slog.Default() + } + + return &Server{ + cache: cfg.Cache, + pages: pages, + loadingTmpl: loadingTmpl, + webhookSecret: cfg.WebhookSecret, + onWebhook: cfg.OnWebhook, + log: cfg.Log, + }, nil +} + +// Handler returns the chi router with all routes mounted. +func (s *Server) Handler() http.Handler { + r := chi.NewRouter() + + staticFS, err := fs.Sub(web.Content, "static") + if err != nil { + s.log.Error("failed to open static fs", "error", err) + } else { + r.Handle("/static/*", http.StripPrefix("/static/", http.FileServer(http.FS(staticFS)))) + } + + r.Get("/health", s.handleHealth) + r.Post("/webhook", s.handleWebhook) + r.Get("/", s.handleIndex) + r.Get("/{repo}/", s.handleRepo) + r.Get("/{repo}/*", s.handleDoc) + + return r +} + +// Breadcrumb is a navigation element. +type Breadcrumb struct { + Label string + URL string +} + +// SidebarItem is a sidebar navigation entry. +type SidebarItem struct { + Label string + URL string + Active bool +} + +type pageData struct { + Title string + Breadcrumbs []Breadcrumb + Sidebar []SidebarItem + LastUpdated string + + // Index page + Repos []*cache.RepoInfo + + // Repo page + RepoName string + RepoDescription string + Docs []*cache.Document + + // Doc page + Content template.HTML + TOC []render.Heading + + // Error page + Code int + Message string +} + +func (s *Server) handleHealth(w http.ResponseWriter, r *http.Request) { + if !s.cache.IsReady() { + w.WriteHeader(http.StatusServiceUnavailable) + _, _ = w.Write([]byte("loading")) + return + } + w.WriteHeader(http.StatusOK) + _, _ = w.Write([]byte("ok")) +} + +func (s *Server) handleIndex(w http.ResponseWriter, r *http.Request) { + if !s.cache.IsReady() { + s.renderLoading(w) + return + } + + data := pageData{ + Repos: s.cache.ListRepos(), + } + s.render(w, r, "index.html", data, http.StatusOK) +} + +func (s *Server) handleRepo(w http.ResponseWriter, r *http.Request) { + if !s.cache.IsReady() { + s.renderLoading(w) + return + } + + repoName := chi.URLParam(r, "repo") + repoName = sanitizePath(repoName) + + repo, ok := s.cache.GetRepo(repoName) + if !ok { + s.renderError(w, r, http.StatusNotFound, "Repository not found.") + return + } + + data := pageData{ + Title: repo.Name, + RepoName: repo.Name, + RepoDescription: repo.Description, + Docs: repo.Docs, + Breadcrumbs: []Breadcrumb{ + {Label: repo.Name, URL: "/" + repo.Name + "/"}, + }, + } + s.render(w, r, "repo.html", data, http.StatusOK) +} + +func (s *Server) handleDoc(w http.ResponseWriter, r *http.Request) { + if !s.cache.IsReady() { + s.renderLoading(w) + return + } + + repoName := chi.URLParam(r, "repo") + repoName = sanitizePath(repoName) + docPath := chi.URLParam(r, "*") + docPath = sanitizePath(docPath) + + doc, ok := s.cache.GetDocument(repoName, docPath) + if !ok { + s.renderError(w, r, http.StatusNotFound, "Document not found.") + return + } + + repo, _ := s.cache.GetRepo(repoName) + var sidebar []SidebarItem + if repo != nil { + for _, d := range repo.Docs { + sidebar = append(sidebar, SidebarItem{ + Label: d.Title, + URL: "/" + repoName + "/" + d.URLPath, + Active: d.URLPath == docPath, + }) + } + } + + lastUpdated := "" + if !doc.LastUpdated.IsZero() { + lastUpdated = doc.LastUpdated.Format("2006-01-02 15:04 UTC") + } + + data := pageData{ + Title: doc.Title + " — " + repoName, + Content: template.HTML(doc.HTML), // #nosec G203 -- rendered by our goldmark pipeline + TOC: doc.Headings, + Sidebar: sidebar, + Breadcrumbs: []Breadcrumb{ + {Label: repoName, URL: "/" + repoName + "/"}, + {Label: doc.Title, URL: "/" + repoName + "/" + doc.URLPath}, + }, + LastUpdated: lastUpdated, + } + s.render(w, r, "doc.html", data, http.StatusOK) +} + +func (s *Server) handleWebhook(w http.ResponseWriter, r *http.Request) { + if s.webhookSecret == "" { + http.Error(w, "webhook not configured", http.StatusInternalServerError) + return + } + + body, err := io.ReadAll(io.LimitReader(r.Body, 1<<20)) + if err != nil { + http.Error(w, "bad request", http.StatusBadRequest) + return + } + + sig := r.Header.Get("X-Gitea-Signature") + if !verifyHMAC(body, sig, s.webhookSecret) { + http.Error(w, "invalid signature", http.StatusForbidden) + return + } + + repoName := extractRepoName(body) + if repoName == "" { + http.Error(w, "cannot determine repo", http.StatusBadRequest) + return + } + + s.log.Info("webhook received", "repo", repoName) + if s.onWebhook != nil { + go s.onWebhook(repoName) + } + + w.WriteHeader(http.StatusNoContent) +} + +func (s *Server) render(w http.ResponseWriter, r *http.Request, name string, data pageData, status int) { + if r.Header.Get("HX-Request") == "true" { + s.renderPartial(w, name, data, status) + return + } + + tmpl, ok := s.pages[name] + if !ok { + s.log.Error("page template not found", "template", name) + http.Error(w, "internal error", http.StatusInternalServerError) + return + } + + w.Header().Set("Content-Type", "text/html; charset=utf-8") + w.WriteHeader(status) + if err := tmpl.ExecuteTemplate(w, "layout.html", data); err != nil { + s.log.Error("render template", "template", name, "error", err) + } +} + +func (s *Server) renderPartial(w http.ResponseWriter, name string, data pageData, status int) { + tmpl, ok := s.pages[name] + if !ok { + s.log.Error("page template not found for partial", "template", name) + http.Error(w, "internal error", http.StatusInternalServerError) + return + } + + w.Header().Set("Content-Type", "text/html; charset=utf-8") + w.WriteHeader(status) + if err := tmpl.ExecuteTemplate(w, "content", data); err != nil { + s.log.Error("render partial", "template", name, "error", err) + } +} + +func (s *Server) renderLoading(w http.ResponseWriter) { + w.Header().Set("Content-Type", "text/html; charset=utf-8") + w.WriteHeader(http.StatusServiceUnavailable) + if err := s.loadingTmpl.Execute(w, nil); err != nil { + s.log.Error("render loading", "error", err) + } +} + +func (s *Server) renderError(w http.ResponseWriter, r *http.Request, code int, message string) { + data := pageData{ + Title: http.StatusText(code), + Code: code, + Message: message, + } + s.render(w, r, "error.html", data, code) +} + +func verifyHMAC(body []byte, signature, secret string) bool { + if signature == "" { + return false + } + + mac := hmac.New(sha256.New, []byte(secret)) + mac.Write(body) + expected := hex.EncodeToString(mac.Sum(nil)) + return hmac.Equal([]byte(expected), []byte(signature)) +} + +// extractRepoName pulls the repo name from a Gitea webhook JSON payload. +// We do minimal parsing to avoid importing encoding/json for a single field. +func extractRepoName(body []byte) string { + // Look for "repository":{"...", "name":"" + s := string(body) + idx := strings.Index(s, `"repository"`) + if idx < 0 { + return "" + } + sub := s[idx:] + nameIdx := strings.Index(sub, `"name":"`) + if nameIdx < 0 { + return "" + } + start := nameIdx + len(`"name":"`) + end := strings.Index(sub[start:], `"`) + if end < 0 { + return "" + } + return sanitizePath(sub[start : start+end]) +} + +// sanitizePath removes path traversal components. +func sanitizePath(p string) string { + // Remove all .. segments before cleaning to prevent traversal. + segments := strings.Split(p, "/") + var clean []string + for _, seg := range segments { + if seg == ".." || seg == "." || seg == "" { + continue + } + clean = append(clean, seg) + } + return strings.Join(clean, "/") +} + +// StartBackgroundFetch coordinates the initial fetch and periodic polling. +func StartBackgroundFetch(ctx context.Context, cfg BackgroundConfig) { + log := cfg.Log + if log == nil { + log = slog.Default() + } + + // Initial fetch with retries + for { + if err := fetchAllRepos(ctx, cfg); err != nil { + log.Error("initial fetch failed, retrying in 30s", "error", err) + select { + case <-ctx.Done(): + return + case <-time.After(30 * time.Second): + continue + } + } + cfg.Cache.SetReady() + log.Info("initial fetch complete") + break + } + + // Poll loop + ticker := time.NewTicker(cfg.PollInterval) + defer ticker.Stop() + + for { + select { + case <-ctx.Done(): + return + case <-ticker.C: + if err := pollForChanges(ctx, cfg); err != nil { + log.Warn("poll failed", "error", err) + } + } + } +} + +// BackgroundConfig holds configuration for background fetching. +type BackgroundConfig struct { + Cache *cache.Cache + Fetcher *Fetcher + PollInterval time.Duration + Log *slog.Logger +} diff --git a/internal/server/server_test.go b/internal/server/server_test.go new file mode 100644 index 0000000..e51935f --- /dev/null +++ b/internal/server/server_test.go @@ -0,0 +1,325 @@ +package server + +import ( + "crypto/hmac" + "crypto/sha256" + "encoding/hex" + "net/http" + "net/http/httptest" + "strings" + "testing" + "time" + + "git.wntrmute.dev/mc/mcdoc/internal/cache" + "git.wntrmute.dev/mc/mcdoc/internal/render" +) + +func newTestServer(t *testing.T, c *cache.Cache, secret string) *Server { + t.Helper() + srv, err := New(Config{ + Cache: c, + WebhookSecret: secret, + }) + if err != nil { + t.Fatalf("new server: %v", err) + } + return srv +} + +func TestHealthNotReady(t *testing.T) { + c := cache.New() + srv := newTestServer(t, c, "") + handler := srv.Handler() + + req := httptest.NewRequest(http.MethodGet, "/health", nil) + w := httptest.NewRecorder() + handler.ServeHTTP(w, req) + + if w.Code != http.StatusServiceUnavailable { + t.Fatalf("expected 503, got %d", w.Code) + } +} + +func TestHealthReady(t *testing.T) { + c := cache.New() + c.SetReady() + srv := newTestServer(t, c, "") + handler := srv.Handler() + + req := httptest.NewRequest(http.MethodGet, "/health", nil) + w := httptest.NewRecorder() + handler.ServeHTTP(w, req) + + if w.Code != http.StatusOK { + t.Fatalf("expected 200, got %d", w.Code) + } +} + +func TestIndexNotReady(t *testing.T) { + c := cache.New() + srv := newTestServer(t, c, "") + handler := srv.Handler() + + req := httptest.NewRequest(http.MethodGet, "/", nil) + w := httptest.NewRecorder() + handler.ServeHTTP(w, req) + + if w.Code != http.StatusServiceUnavailable { + t.Fatalf("expected 503, got %d", w.Code) + } +} + +func TestIndexReady(t *testing.T) { + c := cache.New() + c.SetRepo(&cache.RepoInfo{Name: "testrepo", Description: "A test"}) + c.SetReady() + + srv := newTestServer(t, c, "") + handler := srv.Handler() + + req := httptest.NewRequest(http.MethodGet, "/", nil) + w := httptest.NewRecorder() + handler.ServeHTTP(w, req) + + if w.Code != http.StatusOK { + t.Fatalf("expected 200, got %d", w.Code) + } + if !strings.Contains(w.Body.String(), "testrepo") { + t.Fatal("expected testrepo in index page") + } +} + +func TestRepoPage(t *testing.T) { + c := cache.New() + c.SetRepo(&cache.RepoInfo{ + Name: "mcr", + Docs: []*cache.Document{ + {Repo: "mcr", URLPath: "README", Title: "README"}, + }, + }) + c.SetReady() + + srv := newTestServer(t, c, "") + handler := srv.Handler() + + req := httptest.NewRequest(http.MethodGet, "/mcr/", nil) + w := httptest.NewRecorder() + handler.ServeHTTP(w, req) + + if w.Code != http.StatusOK { + t.Fatalf("expected 200, got %d", w.Code) + } + if !strings.Contains(w.Body.String(), "README") { + t.Fatal("expected README in repo page") + } +} + +func TestRepoPageNotFound(t *testing.T) { + c := cache.New() + c.SetReady() + srv := newTestServer(t, c, "") + handler := srv.Handler() + + req := httptest.NewRequest(http.MethodGet, "/nonexistent/", nil) + w := httptest.NewRecorder() + handler.ServeHTTP(w, req) + + if w.Code != http.StatusNotFound { + t.Fatalf("expected 404, got %d", w.Code) + } +} + +func TestDocPage(t *testing.T) { + c := cache.New() + c.SetRepo(&cache.RepoInfo{ + Name: "mcr", + Docs: []*cache.Document{ + { + Repo: "mcr", + URLPath: "ARCHITECTURE", + Title: "Architecture", + HTML: "

Architecture

content

", + Headings: []render.Heading{ + {Level: 1, ID: "architecture", Text: "Architecture"}, + }, + }, + }, + }) + c.SetReady() + + srv := newTestServer(t, c, "") + handler := srv.Handler() + + req := httptest.NewRequest(http.MethodGet, "/mcr/ARCHITECTURE", nil) + w := httptest.NewRecorder() + handler.ServeHTTP(w, req) + + if w.Code != http.StatusOK { + t.Fatalf("expected 200, got %d", w.Code) + } + body := w.Body.String() + if !strings.Contains(body, "Architecture") { + t.Fatal("expected Architecture in doc page") + } + if !strings.Contains(body, "content") { + t.Fatal("expected rendered content in doc page") + } +} + +func TestDocPageNotFound(t *testing.T) { + c := cache.New() + c.SetRepo(&cache.RepoInfo{Name: "mcr"}) + c.SetReady() + + srv := newTestServer(t, c, "") + handler := srv.Handler() + + req := httptest.NewRequest(http.MethodGet, "/mcr/nonexistent", nil) + w := httptest.NewRecorder() + handler.ServeHTTP(w, req) + + if w.Code != http.StatusNotFound { + t.Fatalf("expected 404, got %d", w.Code) + } +} + +func TestHTMXPartialResponse(t *testing.T) { + c := cache.New() + c.SetRepo(&cache.RepoInfo{Name: "r", Description: "test"}) + c.SetReady() + + srv := newTestServer(t, c, "") + handler := srv.Handler() + + req := httptest.NewRequest(http.MethodGet, "/", nil) + req.Header.Set("HX-Request", "true") + w := httptest.NewRecorder() + handler.ServeHTTP(w, req) + + if w.Code != http.StatusOK { + t.Fatalf("expected 200, got %d", w.Code) + } + body := w.Body.String() + // Partial should not include the full layout (no tag) + if strings.Contains(body, "=0)){return r}else{return null}}if(o&&(o==="*"||o.split(" ").indexOf(n)>=0)){return"unset"}}return r}function re(t,n){let r=null;o(t,function(e){return!!(r=i(t,ue(e),n))});if(r!=="unset"){return r}}function h(e,t){const n=e instanceof Element&&(e.matches||e.matchesSelector||e.msMatchesSelector||e.mozMatchesSelector||e.webkitMatchesSelector||e.oMatchesSelector);return!!n&&n.call(e,t)}function T(e){const t=/<([a-z][^\/\0>\x20\t\r\n\f]*)/i;const n=t.exec(e);if(n){return n[1].toLowerCase()}else{return""}}function q(e){const t=new DOMParser;return t.parseFromString(e,"text/html")}function L(e,t){while(t.childNodes.length>0){e.append(t.childNodes[0])}}function A(e){const t=ne().createElement("script");se(e.attributes,function(e){t.setAttribute(e.name,e.value)});t.textContent=e.textContent;t.async=false;if(Q.config.inlineScriptNonce){t.nonce=Q.config.inlineScriptNonce}return t}function N(e){return e.matches("script")&&(e.type==="text/javascript"||e.type==="module"||e.type==="")}function I(e){Array.from(e.querySelectorAll("script")).forEach(e=>{if(N(e)){const t=A(e);const n=e.parentNode;try{n.insertBefore(t,e)}catch(e){O(e)}finally{e.remove()}}})}function P(e){const t=e.replace(/]*)?>[\s\S]*?<\/head>/i,"");const n=T(t);let r;if(n==="html"){r=new DocumentFragment;const i=q(e);L(r,i.body);r.title=i.title}else if(n==="body"){r=new DocumentFragment;const i=q(t);L(r,i.body);r.title=i.title}else{const i=q('");r=i.querySelector("template").content;r.title=i.title;var o=r.querySelector("title");if(o&&o.parentNode===r){o.remove();r.title=o.innerText}}if(r){if(Q.config.allowScriptTags){I(r)}else{r.querySelectorAll("script").forEach(e=>e.remove())}}return r}function oe(e){if(e){e()}}function t(e,t){return Object.prototype.toString.call(e)==="[object "+t+"]"}function k(e){return typeof e==="function"}function D(e){return t(e,"Object")}function ie(e){const t="htmx-internal-data";let n=e[t];if(!n){n=e[t]={}}return n}function M(t){const n=[];if(t){for(let e=0;e=0}function le(e){return e.getRootNode({composed:true})===document}function F(e){return e.trim().split(/\s+/)}function ce(e,t){for(const n in t){if(t.hasOwnProperty(n)){e[n]=t[n]}}return e}function S(e){try{return JSON.parse(e)}catch(e){O(e);return null}}function B(){const e="htmx:localStorageTest";try{localStorage.setItem(e,e);localStorage.removeItem(e);return true}catch(e){return false}}function U(t){try{const e=new URL(t);if(e){t=e.pathname+e.search}if(!/^\/$/.test(t)){t=t.replace(/\/+$/,"")}return t}catch(e){return t}}function e(e){return vn(ne().body,function(){return eval(e)})}function j(t){const e=Q.on("htmx:load",function(e){t(e.detail.elt)});return e}function V(){Q.logger=function(e,t,n){if(console){console.log(t,e,n)}}}function _(){Q.logger=null}function u(e,t){if(typeof e!=="string"){return e.querySelector(t)}else{return u(ne(),e)}}function x(e,t){if(typeof e!=="string"){return e.querySelectorAll(t)}else{return x(ne(),e)}}function E(){return window}function z(e,t){e=y(e);if(t){E().setTimeout(function(){z(e);e=null},t)}else{c(e).removeChild(e)}}function ue(e){return e instanceof Element?e:null}function $(e){return e instanceof HTMLElement?e:null}function J(e){return typeof e==="string"?e:null}function f(e){return e instanceof Element||e instanceof Document||e instanceof DocumentFragment?e:null}function K(e,t,n){e=ue(y(e));if(!e){return}if(n){E().setTimeout(function(){K(e,t);e=null},n)}else{e.classList&&e.classList.add(t)}}function G(e,t,n){let r=ue(y(e));if(!r){return}if(n){E().setTimeout(function(){G(r,t);r=null},n)}else{if(r.classList){r.classList.remove(t);if(r.classList.length===0){r.removeAttribute("class")}}}}function W(e,t){e=y(e);e.classList.toggle(t)}function Z(e,t){e=y(e);se(e.parentElement.children,function(e){G(e,t)});K(ue(e),t)}function g(e,t){e=ue(y(e));if(e&&e.closest){return e.closest(t)}else{do{if(e==null||h(e,t)){return e}}while(e=e&&ue(c(e)));return null}}function l(e,t){return e.substring(0,t.length)===t}function Y(e,t){return e.substring(e.length-t.length)===t}function ge(e){const t=e.trim();if(l(t,"<")&&Y(t,"/>")){return t.substring(1,t.length-2)}else{return t}}function p(t,r,n){if(r.indexOf("global ")===0){return p(t,r.slice(7),true)}t=y(t);const o=[];{let t=0;let n=0;for(let e=0;e"){t--}}if(n0){const r=ge(o.shift());let e;if(r.indexOf("closest ")===0){e=g(ue(t),ge(r.substr(8)))}else if(r.indexOf("find ")===0){e=u(f(t),ge(r.substr(5)))}else if(r==="next"||r==="nextElementSibling"){e=ue(t).nextElementSibling}else if(r.indexOf("next ")===0){e=pe(t,ge(r.substr(5)),!!n)}else if(r==="previous"||r==="previousElementSibling"){e=ue(t).previousElementSibling}else if(r.indexOf("previous ")===0){e=me(t,ge(r.substr(9)),!!n)}else if(r==="document"){e=document}else if(r==="window"){e=window}else if(r==="body"){e=document.body}else if(r==="root"){e=m(t,!!n)}else if(r==="host"){e=t.getRootNode().host}else{s.push(r)}if(e){i.push(e)}}if(s.length>0){const e=s.join(",");const c=f(m(t,!!n));i.push(...M(c.querySelectorAll(e)))}return i}var pe=function(t,e,n){const r=f(m(t,n)).querySelectorAll(e);for(let e=0;e=0;e--){const o=r[e];if(o.compareDocumentPosition(t)===Node.DOCUMENT_POSITION_FOLLOWING){return o}}};function ae(e,t){if(typeof e!=="string"){return p(e,t)[0]}else{return p(ne().body,e)[0]}}function y(e,t){if(typeof e==="string"){return u(f(t)||document,e)}else{return e}}function xe(e,t,n,r){if(k(t)){return{target:ne().body,event:J(e),listener:t,options:n}}else{return{target:y(e),event:J(t),listener:n,options:r}}}function ye(t,n,r,o){Vn(function(){const e=xe(t,n,r,o);e.target.addEventListener(e.event,e.listener,e.options)});const e=k(n);return e?n:r}function be(t,n,r){Vn(function(){const e=xe(t,n,r);e.target.removeEventListener(e.event,e.listener)});return k(n)?n:r}const ve=ne().createElement("output");function we(e,t){const n=re(e,t);if(n){if(n==="this"){return[Se(e,t)]}else{const r=p(e,n);if(r.length===0){O('The selector "'+n+'" on '+t+" returned no matches!");return[ve]}else{return r}}}}function Se(e,t){return ue(o(e,function(e){return te(ue(e),t)!=null}))}function Ee(e){const t=re(e,"hx-target");if(t){if(t==="this"){return Se(e,"hx-target")}else{return ae(e,t)}}else{const n=ie(e);if(n.boosted){return ne().body}else{return e}}}function Ce(t){const n=Q.config.attributesToSettle;for(let e=0;e0){s=e.substring(0,e.indexOf(":"));n=e.substring(e.indexOf(":")+1)}else{s=e}o.removeAttribute("hx-swap-oob");o.removeAttribute("data-hx-swap-oob");const r=p(t,n,false);if(r){se(r,function(e){let t;const n=o.cloneNode(true);t=ne().createDocumentFragment();t.appendChild(n);if(!Re(s,e)){t=f(n)}const r={shouldSwap:true,target:e,fragment:t};if(!he(e,"htmx:oobBeforeSwap",r))return;e=r.target;if(r.shouldSwap){qe(t);_e(s,e,e,t,i);Te()}se(i.elts,function(e){he(e,"htmx:oobAfterSwap",r)})});o.parentNode.removeChild(o)}else{o.parentNode.removeChild(o);fe(ne().body,"htmx:oobErrorNoTarget",{content:o})}return e}function Te(){const e=u("#--htmx-preserve-pantry--");if(e){for(const t of[...e.children]){const n=u("#"+t.id);n.parentNode.moveBefore(t,n);n.remove()}e.remove()}}function qe(e){se(x(e,"[hx-preserve], [data-hx-preserve]"),function(e){const t=te(e,"id");const n=ne().getElementById(t);if(n!=null){if(e.moveBefore){let e=u("#--htmx-preserve-pantry--");if(e==null){ne().body.insertAdjacentHTML("afterend","
");e=u("#--htmx-preserve-pantry--")}e.moveBefore(n,null)}else{e.parentNode.replaceChild(n,e)}}})}function Le(l,e,c){se(e.querySelectorAll("[id]"),function(t){const n=ee(t,"id");if(n&&n.length>0){const r=n.replace("'","\\'");const o=t.tagName.replace(":","\\:");const e=f(l);const i=e&&e.querySelector(o+"[id='"+r+"']");if(i&&i!==e){const s=t.cloneNode();Oe(t,i);c.tasks.push(function(){Oe(t,s)})}}})}function Ae(e){return function(){G(e,Q.config.addedClass);kt(ue(e));Ne(f(e));he(e,"htmx:load")}}function Ne(e){const t="[autofocus]";const n=$(h(e,t)?e:e.querySelector(t));if(n!=null){n.focus()}}function a(e,t,n,r){Le(e,n,r);while(n.childNodes.length>0){const o=n.firstChild;K(ue(o),Q.config.addedClass);e.insertBefore(o,t);if(o.nodeType!==Node.TEXT_NODE&&o.nodeType!==Node.COMMENT_NODE){r.tasks.push(Ae(o))}}}function Ie(e,t){let n=0;while(n0}function $e(e,t,r,o){if(!o){o={}}e=y(e);const i=o.contextElement?m(o.contextElement,false):ne();const n=document.activeElement;let s={};try{s={elt:n,start:n?n.selectionStart:null,end:n?n.selectionEnd:null}}catch(e){}const l=xn(e);if(r.swapStyle==="textContent"){e.textContent=t}else{let n=P(t);l.title=n.title;if(o.selectOOB){const u=o.selectOOB.split(",");for(let t=0;t0){E().setTimeout(c,r.settleDelay)}else{c()}}function Je(e,t,n){const r=e.getResponseHeader(t);if(r.indexOf("{")===0){const o=S(r);for(const i in o){if(o.hasOwnProperty(i)){let e=o[i];if(D(e)){n=e.target!==undefined?e.target:n}else{e={value:e}}he(n,i,e)}}}else{const s=r.split(",");for(let e=0;e0){const s=o[0];if(s==="]"){e--;if(e===0){if(n===null){t=t+"true"}o.shift();t+=")})";try{const l=vn(r,function(){return Function(t)()},function(){return true});l.source=t;return l}catch(e){fe(ne().body,"htmx:syntax:error",{error:e,source:t});return null}}}else if(s==="["){e++}if(tt(s,n,i)){t+="(("+i+"."+s+") ? ("+i+"."+s+") : (window."+s+"))"}else{t=t+s}n=o.shift()}}}function C(e,t){let n="";while(e.length>0&&!t.test(e[0])){n+=e.shift()}return n}function rt(e){let t;if(e.length>0&&Ye.test(e[0])){e.shift();t=C(e,Qe).trim();e.shift()}else{t=C(e,v)}return t}const ot="input, textarea, select";function it(e,t,n){const r=[];const o=et(t);do{C(o,w);const l=o.length;const c=C(o,/[,\[\s]/);if(c!==""){if(c==="every"){const u={trigger:"every"};C(o,w);u.pollInterval=d(C(o,/[,\[\s]/));C(o,w);var i=nt(e,o,"event");if(i){u.eventFilter=i}r.push(u)}else{const a={trigger:c};var i=nt(e,o,"event");if(i){a.eventFilter=i}C(o,w);while(o.length>0&&o[0]!==","){const f=o.shift();if(f==="changed"){a.changed=true}else if(f==="once"){a.once=true}else if(f==="consume"){a.consume=true}else if(f==="delay"&&o[0]===":"){o.shift();a.delay=d(C(o,v))}else if(f==="from"&&o[0]===":"){o.shift();if(Ye.test(o[0])){var s=rt(o)}else{var s=C(o,v);if(s==="closest"||s==="find"||s==="next"||s==="previous"){o.shift();const h=rt(o);if(h.length>0){s+=" "+h}}}a.from=s}else if(f==="target"&&o[0]===":"){o.shift();a.target=rt(o)}else if(f==="throttle"&&o[0]===":"){o.shift();a.throttle=d(C(o,v))}else if(f==="queue"&&o[0]===":"){o.shift();a.queue=C(o,v)}else if(f==="root"&&o[0]===":"){o.shift();a[f]=rt(o)}else if(f==="threshold"&&o[0]===":"){o.shift();a[f]=C(o,v)}else{fe(e,"htmx:syntax:error",{token:o.shift()})}C(o,w)}r.push(a)}}if(o.length===l){fe(e,"htmx:syntax:error",{token:o.shift()})}C(o,w)}while(o[0]===","&&o.shift());if(n){n[t]=r}return r}function st(e){const t=te(e,"hx-trigger");let n=[];if(t){const r=Q.config.triggerSpecsCache;n=r&&r[t]||it(e,t,r)}if(n.length>0){return n}else if(h(e,"form")){return[{trigger:"submit"}]}else if(h(e,'input[type="button"], input[type="submit"]')){return[{trigger:"click"}]}else if(h(e,ot)){return[{trigger:"change"}]}else{return[{trigger:"click"}]}}function lt(e){ie(e).cancelled=true}function ct(e,t,n){const r=ie(e);r.timeout=E().setTimeout(function(){if(le(e)&&r.cancelled!==true){if(!gt(n,e,Mt("hx:poll:trigger",{triggerSpec:n,target:e}))){t(e)}ct(e,t,n)}},n.pollInterval)}function ut(e){return location.hostname===e.hostname&&ee(e,"href")&&ee(e,"href").indexOf("#")!==0}function at(e){return g(e,Q.config.disableSelector)}function ft(t,n,e){if(t instanceof HTMLAnchorElement&&ut(t)&&(t.target===""||t.target==="_self")||t.tagName==="FORM"&&String(ee(t,"method")).toLowerCase()!=="dialog"){n.boosted=true;let r,o;if(t.tagName==="A"){r="get";o=ee(t,"href")}else{const i=ee(t,"method");r=i?i.toLowerCase():"get";o=ee(t,"action");if(o==null||o===""){o=ne().location.href}if(r==="get"&&o.includes("?")){o=o.replace(/\?[^#]+/,"")}}e.forEach(function(e){pt(t,function(e,t){const n=ue(e);if(at(n)){b(n);return}de(r,o,n,t)},n,e,true)})}}function ht(e,t){const n=ue(t);if(!n){return false}if(e.type==="submit"||e.type==="click"){if(n.tagName==="FORM"){return true}if(h(n,'input[type="submit"], button')&&(h(n,"[form]")||g(n,"form")!==null)){return true}if(n instanceof HTMLAnchorElement&&n.href&&(n.getAttribute("href")==="#"||n.getAttribute("href").indexOf("#")!==0)){return true}}return false}function dt(e,t){return ie(e).boosted&&e instanceof HTMLAnchorElement&&t.type==="click"&&(t.ctrlKey||t.metaKey)}function gt(e,t,n){const r=e.eventFilter;if(r){try{return r.call(t,n)!==true}catch(e){const o=r.source;fe(ne().body,"htmx:eventFilter:error",{error:e,source:o});return true}}return false}function pt(l,c,e,u,a){const f=ie(l);let t;if(u.from){t=p(l,u.from)}else{t=[l]}if(u.changed){if(!("lastValue"in f)){f.lastValue=new WeakMap}t.forEach(function(e){if(!f.lastValue.has(u)){f.lastValue.set(u,new WeakMap)}f.lastValue.get(u).set(e,e.value)})}se(t,function(i){const s=function(e){if(!le(l)){i.removeEventListener(u.trigger,s);return}if(dt(l,e)){return}if(a||ht(e,l)){e.preventDefault()}if(gt(u,l,e)){return}const t=ie(e);t.triggerSpec=u;if(t.handledFor==null){t.handledFor=[]}if(t.handledFor.indexOf(l)<0){t.handledFor.push(l);if(u.consume){e.stopPropagation()}if(u.target&&e.target){if(!h(ue(e.target),u.target)){return}}if(u.once){if(f.triggeredOnce){return}else{f.triggeredOnce=true}}if(u.changed){const n=event.target;const r=n.value;const o=f.lastValue.get(u);if(o.has(n)&&o.get(n)===r){return}o.set(n,r)}if(f.delayed){clearTimeout(f.delayed)}if(f.throttle){return}if(u.throttle>0){if(!f.throttle){he(l,"htmx:trigger");c(l,e);f.throttle=E().setTimeout(function(){f.throttle=null},u.throttle)}}else if(u.delay>0){f.delayed=E().setTimeout(function(){he(l,"htmx:trigger");c(l,e)},u.delay)}else{he(l,"htmx:trigger");c(l,e)}}};if(e.listenerInfos==null){e.listenerInfos=[]}e.listenerInfos.push({trigger:u.trigger,listener:s,on:i});i.addEventListener(u.trigger,s)})}let mt=false;let xt=null;function yt(){if(!xt){xt=function(){mt=true};window.addEventListener("scroll",xt);window.addEventListener("resize",xt);setInterval(function(){if(mt){mt=false;se(ne().querySelectorAll("[hx-trigger*='revealed'],[data-hx-trigger*='revealed']"),function(e){bt(e)})}},200)}}function bt(e){if(!s(e,"data-hx-revealed")&&X(e)){e.setAttribute("data-hx-revealed","true");const t=ie(e);if(t.initHash){he(e,"revealed")}else{e.addEventListener("htmx:afterProcessNode",function(){he(e,"revealed")},{once:true})}}}function vt(e,t,n,r){const o=function(){if(!n.loaded){n.loaded=true;he(e,"htmx:trigger");t(e)}};if(r>0){E().setTimeout(o,r)}else{o()}}function wt(t,n,e){let i=false;se(r,function(r){if(s(t,"hx-"+r)){const o=te(t,"hx-"+r);i=true;n.path=o;n.verb=r;e.forEach(function(e){St(t,e,n,function(e,t){const n=ue(e);if(g(n,Q.config.disableSelector)){b(n);return}de(r,o,n,t)})})}});return i}function St(r,e,t,n){if(e.trigger==="revealed"){yt();pt(r,n,t,e);bt(ue(r))}else if(e.trigger==="intersect"){const o={};if(e.root){o.root=ae(r,e.root)}if(e.threshold){o.threshold=parseFloat(e.threshold)}const i=new IntersectionObserver(function(t){for(let e=0;e0){t.polling=true;ct(ue(r),n,e)}else{pt(r,n,t,e)}}function Et(e){const t=ue(e);if(!t){return false}const n=t.attributes;for(let e=0;e", "+e).join(""));return o}else{return[]}}function Tt(e){const t=g(ue(e.target),"button, input[type='submit']");const n=Lt(e);if(n){n.lastButtonClicked=t}}function qt(e){const t=Lt(e);if(t){t.lastButtonClicked=null}}function Lt(e){const t=g(ue(e.target),"button, input[type='submit']");if(!t){return}const n=y("#"+ee(t,"form"),t.getRootNode())||g(t,"form");if(!n){return}return ie(n)}function At(e){e.addEventListener("click",Tt);e.addEventListener("focusin",Tt);e.addEventListener("focusout",qt)}function Nt(t,e,n){const r=ie(t);if(!Array.isArray(r.onHandlers)){r.onHandlers=[]}let o;const i=function(e){vn(t,function(){if(at(t)){return}if(!o){o=new Function("event",n)}o.call(t,e)})};t.addEventListener(e,i);r.onHandlers.push({event:e,listener:i})}function It(t){ke(t);for(let e=0;eQ.config.historyCacheSize){i.shift()}while(i.length>0){try{localStorage.setItem("htmx-history-cache",JSON.stringify(i));break}catch(e){fe(ne().body,"htmx:historyCacheError",{cause:e,cache:i});i.shift()}}}function Vt(t){if(!B()){return null}t=U(t);const n=S(localStorage.getItem("htmx-history-cache"))||[];for(let e=0;e=200&&this.status<400){he(ne().body,"htmx:historyCacheMissLoad",i);const e=P(this.response);const t=e.querySelector("[hx-history-elt],[data-hx-history-elt]")||e;const n=Ut();const r=xn(n);kn(e.title);qe(e);Ve(n,t,r);Te();Kt(r.tasks);Bt=o;he(ne().body,"htmx:historyRestore",{path:o,cacheMiss:true,serverResponse:this.response})}else{fe(ne().body,"htmx:historyCacheMissLoadError",i)}};e.send()}function Wt(e){zt();e=e||location.pathname+location.search;const t=Vt(e);if(t){const n=P(t.content);const r=Ut();const o=xn(r);kn(t.title);qe(n);Ve(r,n,o);Te();Kt(o.tasks);E().setTimeout(function(){window.scrollTo(0,t.scroll)},0);Bt=e;he(ne().body,"htmx:historyRestore",{path:e,item:t})}else{if(Q.config.refreshOnHistoryMiss){window.location.reload(true)}else{Gt(e)}}}function Zt(e){let t=we(e,"hx-indicator");if(t==null){t=[e]}se(t,function(e){const t=ie(e);t.requestCount=(t.requestCount||0)+1;e.classList.add.call(e.classList,Q.config.requestClass)});return t}function Yt(e){let t=we(e,"hx-disabled-elt");if(t==null){t=[]}se(t,function(e){const t=ie(e);t.requestCount=(t.requestCount||0)+1;e.setAttribute("disabled","");e.setAttribute("data-disabled-by-htmx","")});return t}function Qt(e,t){se(e.concat(t),function(e){const t=ie(e);t.requestCount=(t.requestCount||1)-1});se(e,function(e){const t=ie(e);if(t.requestCount===0){e.classList.remove.call(e.classList,Q.config.requestClass)}});se(t,function(e){const t=ie(e);if(t.requestCount===0){e.removeAttribute("disabled");e.removeAttribute("data-disabled-by-htmx")}})}function en(t,n){for(let e=0;en.indexOf(e)<0)}else{e=e.filter(e=>e!==n)}r.delete(t);se(e,e=>r.append(t,e))}}function on(t,n,r,o,i){if(o==null||en(t,o)){return}else{t.push(o)}if(tn(o)){const s=ee(o,"name");let e=o.value;if(o instanceof HTMLSelectElement&&o.multiple){e=M(o.querySelectorAll("option:checked")).map(function(e){return e.value})}if(o instanceof HTMLInputElement&&o.files){e=M(o.files)}nn(s,e,n);if(i){sn(o,r)}}if(o instanceof HTMLFormElement){se(o.elements,function(e){if(t.indexOf(e)>=0){rn(e.name,e.value,n)}else{t.push(e)}if(i){sn(e,r)}});new FormData(o).forEach(function(e,t){if(e instanceof File&&e.name===""){return}nn(t,e,n)})}}function sn(e,t){const n=e;if(n.willValidate){he(n,"htmx:validation:validate");if(!n.checkValidity()){t.push({elt:n,message:n.validationMessage,validity:n.validity});he(n,"htmx:validation:failed",{message:n.validationMessage,validity:n.validity})}}}function ln(n,e){for(const t of e.keys()){n.delete(t)}e.forEach(function(e,t){n.append(t,e)});return n}function cn(e,t){const n=[];const r=new FormData;const o=new FormData;const i=[];const s=ie(e);if(s.lastButtonClicked&&!le(s.lastButtonClicked)){s.lastButtonClicked=null}let l=e instanceof HTMLFormElement&&e.noValidate!==true||te(e,"hx-validate")==="true";if(s.lastButtonClicked){l=l&&s.lastButtonClicked.formNoValidate!==true}if(t!=="get"){on(n,o,i,g(e,"form"),l)}on(n,r,i,e,l);if(s.lastButtonClicked||e.tagName==="BUTTON"||e.tagName==="INPUT"&&ee(e,"type")==="submit"){const u=s.lastButtonClicked||e;const a=ee(u,"name");nn(a,u.value,o)}const c=we(e,"hx-include");se(c,function(e){on(n,r,i,ue(e),l);if(!h(e,"form")){se(f(e).querySelectorAll(ot),function(e){on(n,r,i,e,l)})}});ln(r,o);return{errors:i,formData:r,values:An(r)}}function un(e,t,n){if(e!==""){e+="&"}if(String(n)==="[object Object]"){n=JSON.stringify(n)}const r=encodeURIComponent(n);e+=encodeURIComponent(t)+"="+r;return e}function an(e){e=qn(e);let n="";e.forEach(function(e,t){n=un(n,t,e)});return n}function fn(e,t,n){const r={"HX-Request":"true","HX-Trigger":ee(e,"id"),"HX-Trigger-Name":ee(e,"name"),"HX-Target":te(t,"id"),"HX-Current-URL":ne().location.href};bn(e,"hx-headers",false,r);if(n!==undefined){r["HX-Prompt"]=n}if(ie(e).boosted){r["HX-Boosted"]="true"}return r}function hn(n,e){const t=re(e,"hx-params");if(t){if(t==="none"){return new FormData}else if(t==="*"){return n}else if(t.indexOf("not ")===0){se(t.slice(4).split(","),function(e){e=e.trim();n.delete(e)});return n}else{const r=new FormData;se(t.split(","),function(t){t=t.trim();if(n.has(t)){n.getAll(t).forEach(function(e){r.append(t,e)})}});return r}}else{return n}}function dn(e){return!!ee(e,"href")&&ee(e,"href").indexOf("#")>=0}function gn(e,t){const n=t||re(e,"hx-swap");const r={swapStyle:ie(e).boosted?"innerHTML":Q.config.defaultSwapStyle,swapDelay:Q.config.defaultSwapDelay,settleDelay:Q.config.defaultSettleDelay};if(Q.config.scrollIntoViewOnBoost&&ie(e).boosted&&!dn(e)){r.show="top"}if(n){const s=F(n);if(s.length>0){for(let e=0;e0?o.join(":"):null;r.scroll=u;r.scrollTarget=i}else if(l.indexOf("show:")===0){const a=l.slice(5);var o=a.split(":");const f=o.pop();var i=o.length>0?o.join(":"):null;r.show=f;r.showTarget=i}else if(l.indexOf("focus-scroll:")===0){const h=l.slice("focus-scroll:".length);r.focusScroll=h=="true"}else if(e==0){r.swapStyle=l}else{O("Unknown modifier in hx-swap: "+l)}}}}return r}function pn(e){return re(e,"hx-encoding")==="multipart/form-data"||h(e,"form")&&ee(e,"enctype")==="multipart/form-data"}function mn(t,n,r){let o=null;Ft(n,function(e){if(o==null){o=e.encodeParameters(t,r,n)}});if(o!=null){return o}else{if(pn(n)){return ln(new FormData,qn(r))}else{return an(r)}}}function xn(e){return{tasks:[],elts:[e]}}function yn(e,t){const n=e[0];const r=e[e.length-1];if(t.scroll){var o=null;if(t.scrollTarget){o=ue(ae(n,t.scrollTarget))}if(t.scroll==="top"&&(n||o)){o=o||n;o.scrollTop=0}if(t.scroll==="bottom"&&(r||o)){o=o||r;o.scrollTop=o.scrollHeight}}if(t.show){var o=null;if(t.showTarget){let e=t.showTarget;if(t.showTarget==="window"){e="body"}o=ue(ae(n,e))}if(t.show==="top"&&(n||o)){o=o||n;o.scrollIntoView({block:"start",behavior:Q.config.scrollBehavior})}if(t.show==="bottom"&&(r||o)){o=o||r;o.scrollIntoView({block:"end",behavior:Q.config.scrollBehavior})}}}function bn(r,e,o,i){if(i==null){i={}}if(r==null){return i}const s=te(r,e);if(s){let e=s.trim();let t=o;if(e==="unset"){return null}if(e.indexOf("javascript:")===0){e=e.slice(11);t=true}else if(e.indexOf("js:")===0){e=e.slice(3);t=true}if(e.indexOf("{")!==0){e="{"+e+"}"}let n;if(t){n=vn(r,function(){return Function("return ("+e+")")()},{})}else{n=S(e)}for(const l in n){if(n.hasOwnProperty(l)){if(i[l]==null){i[l]=n[l]}}}}return bn(ue(c(r)),e,o,i)}function vn(e,t,n){if(Q.config.allowEval){return t()}else{fe(e,"htmx:evalDisallowedError");return n}}function wn(e,t){return bn(e,"hx-vars",true,t)}function Sn(e,t){return bn(e,"hx-vals",false,t)}function En(e){return ce(wn(e),Sn(e))}function Cn(t,n,r){if(r!==null){try{t.setRequestHeader(n,r)}catch(e){t.setRequestHeader(n,encodeURIComponent(r));t.setRequestHeader(n+"-URI-AutoEncoded","true")}}}function On(t){if(t.responseURL&&typeof URL!=="undefined"){try{const e=new URL(t.responseURL);return e.pathname+e.search}catch(e){fe(ne().body,"htmx:badResponseUrl",{url:t.responseURL})}}}function R(e,t){return t.test(e.getAllResponseHeaders())}function Rn(t,n,r){t=t.toLowerCase();if(r){if(r instanceof Element||typeof r==="string"){return de(t,n,null,null,{targetOverride:y(r)||ve,returnPromise:true})}else{let e=y(r.target);if(r.target&&!e||r.source&&!e&&!y(r.source)){e=ve}return de(t,n,y(r.source),r.event,{handler:r.handler,headers:r.headers,values:r.values,targetOverride:e,swapOverride:r.swap,select:r.select,returnPromise:true})}}else{return de(t,n,null,null,{returnPromise:true})}}function Hn(e){const t=[];while(e){t.push(e);e=e.parentElement}return t}function Tn(e,t,n){let r;let o;if(typeof URL==="function"){o=new URL(t,document.location.href);const i=document.location.origin;r=i===o.origin}else{o=t;r=l(t,document.location.origin)}if(Q.config.selfRequestsOnly){if(!r){return false}}return he(e,"htmx:validateUrl",ce({url:o,sameHost:r},n))}function qn(e){if(e instanceof FormData)return e;const t=new FormData;for(const n in e){if(e.hasOwnProperty(n)){if(e[n]&&typeof e[n].forEach==="function"){e[n].forEach(function(e){t.append(n,e)})}else if(typeof e[n]==="object"&&!(e[n]instanceof Blob)){t.append(n,JSON.stringify(e[n]))}else{t.append(n,e[n])}}}return t}function Ln(r,o,e){return new Proxy(e,{get:function(t,e){if(typeof e==="number")return t[e];if(e==="length")return t.length;if(e==="push"){return function(e){t.push(e);r.append(o,e)}}if(typeof t[e]==="function"){return function(){t[e].apply(t,arguments);r.delete(o);t.forEach(function(e){r.append(o,e)})}}if(t[e]&&t[e].length===1){return t[e][0]}else{return t[e]}},set:function(e,t,n){e[t]=n;r.delete(o);e.forEach(function(e){r.append(o,e)});return true}})}function An(o){return new Proxy(o,{get:function(e,t){if(typeof t==="symbol"){const r=Reflect.get(e,t);if(typeof r==="function"){return function(){return r.apply(o,arguments)}}else{return r}}if(t==="toJSON"){return()=>Object.fromEntries(o)}if(t in e){if(typeof e[t]==="function"){return function(){return o[t].apply(o,arguments)}}else{return e[t]}}const n=o.getAll(t);if(n.length===0){return undefined}else if(n.length===1){return n[0]}else{return Ln(e,t,n)}},set:function(t,n,e){if(typeof n!=="string"){return false}t.delete(n);if(e&&typeof e.forEach==="function"){e.forEach(function(e){t.append(n,e)})}else if(typeof e==="object"&&!(e instanceof Blob)){t.append(n,JSON.stringify(e))}else{t.append(n,e)}return true},deleteProperty:function(e,t){if(typeof t==="string"){e.delete(t)}return true},ownKeys:function(e){return Reflect.ownKeys(Object.fromEntries(e))},getOwnPropertyDescriptor:function(e,t){return Reflect.getOwnPropertyDescriptor(Object.fromEntries(e),t)}})}function de(t,n,r,o,i,D){let s=null;let l=null;i=i!=null?i:{};if(i.returnPromise&&typeof Promise!=="undefined"){var e=new Promise(function(e,t){s=e;l=t})}if(r==null){r=ne().body}const M=i.handler||Dn;const X=i.select||null;if(!le(r)){oe(s);return e}const c=i.targetOverride||ue(Ee(r));if(c==null||c==ve){fe(r,"htmx:targetError",{target:te(r,"hx-target")});oe(l);return e}let u=ie(r);const a=u.lastButtonClicked;if(a){const L=ee(a,"formaction");if(L!=null){n=L}const A=ee(a,"formmethod");if(A!=null){if(A.toLowerCase()!=="dialog"){t=A}}}const f=re(r,"hx-confirm");if(D===undefined){const K=function(e){return de(t,n,r,o,i,!!e)};const G={target:c,elt:r,path:n,verb:t,triggeringEvent:o,etc:i,issueRequest:K,question:f};if(he(r,"htmx:confirm",G)===false){oe(s);return e}}let h=r;let d=re(r,"hx-sync");let g=null;let F=false;if(d){const N=d.split(":");const I=N[0].trim();if(I==="this"){h=Se(r,"hx-sync")}else{h=ue(ae(r,I))}d=(N[1]||"drop").trim();u=ie(h);if(d==="drop"&&u.xhr&&u.abortable!==true){oe(s);return e}else if(d==="abort"){if(u.xhr){oe(s);return e}else{F=true}}else if(d==="replace"){he(h,"htmx:abort")}else if(d.indexOf("queue")===0){const W=d.split(" ");g=(W[1]||"last").trim()}}if(u.xhr){if(u.abortable){he(h,"htmx:abort")}else{if(g==null){if(o){const P=ie(o);if(P&&P.triggerSpec&&P.triggerSpec.queue){g=P.triggerSpec.queue}}if(g==null){g="last"}}if(u.queuedRequests==null){u.queuedRequests=[]}if(g==="first"&&u.queuedRequests.length===0){u.queuedRequests.push(function(){de(t,n,r,o,i)})}else if(g==="all"){u.queuedRequests.push(function(){de(t,n,r,o,i)})}else if(g==="last"){u.queuedRequests=[];u.queuedRequests.push(function(){de(t,n,r,o,i)})}oe(s);return e}}const p=new XMLHttpRequest;u.xhr=p;u.abortable=F;const m=function(){u.xhr=null;u.abortable=false;if(u.queuedRequests!=null&&u.queuedRequests.length>0){const e=u.queuedRequests.shift();e()}};const B=re(r,"hx-prompt");if(B){var x=prompt(B);if(x===null||!he(r,"htmx:prompt",{prompt:x,target:c})){oe(s);m();return e}}if(f&&!D){if(!confirm(f)){oe(s);m();return e}}let y=fn(r,c,x);if(t!=="get"&&!pn(r)){y["Content-Type"]="application/x-www-form-urlencoded"}if(i.headers){y=ce(y,i.headers)}const U=cn(r,t);let b=U.errors;const j=U.formData;if(i.values){ln(j,qn(i.values))}const V=qn(En(r));const v=ln(j,V);let w=hn(v,r);if(Q.config.getCacheBusterParam&&t==="get"){w.set("org.htmx.cache-buster",ee(c,"id")||"true")}if(n==null||n===""){n=ne().location.href}const S=bn(r,"hx-request");const _=ie(r).boosted;let E=Q.config.methodsThatUseUrlParams.indexOf(t)>=0;const C={boosted:_,useUrlParams:E,formData:w,parameters:An(w),unfilteredFormData:v,unfilteredParameters:An(v),headers:y,target:c,verb:t,errors:b,withCredentials:i.credentials||S.credentials||Q.config.withCredentials,timeout:i.timeout||S.timeout||Q.config.timeout,path:n,triggeringEvent:o};if(!he(r,"htmx:configRequest",C)){oe(s);m();return e}n=C.path;t=C.verb;y=C.headers;w=qn(C.parameters);b=C.errors;E=C.useUrlParams;if(b&&b.length>0){he(r,"htmx:validation:halted",C);oe(s);m();return e}const z=n.split("#");const $=z[0];const O=z[1];let R=n;if(E){R=$;const Z=!w.keys().next().done;if(Z){if(R.indexOf("?")<0){R+="?"}else{R+="&"}R+=an(w);if(O){R+="#"+O}}}if(!Tn(r,R,C)){fe(r,"htmx:invalidPath",C);oe(l);return e}p.open(t.toUpperCase(),R,true);p.overrideMimeType("text/html");p.withCredentials=C.withCredentials;p.timeout=C.timeout;if(S.noHeaders){}else{for(const k in y){if(y.hasOwnProperty(k)){const Y=y[k];Cn(p,k,Y)}}}const H={xhr:p,target:c,requestConfig:C,etc:i,boosted:_,select:X,pathInfo:{requestPath:n,finalRequestPath:R,responsePath:null,anchor:O}};p.onload=function(){try{const t=Hn(r);H.pathInfo.responsePath=On(p);M(r,H);if(H.keepIndicators!==true){Qt(T,q)}he(r,"htmx:afterRequest",H);he(r,"htmx:afterOnLoad",H);if(!le(r)){let e=null;while(t.length>0&&e==null){const n=t.shift();if(le(n)){e=n}}if(e){he(e,"htmx:afterRequest",H);he(e,"htmx:afterOnLoad",H)}}oe(s);m()}catch(e){fe(r,"htmx:onLoadError",ce({error:e},H));throw e}};p.onerror=function(){Qt(T,q);fe(r,"htmx:afterRequest",H);fe(r,"htmx:sendError",H);oe(l);m()};p.onabort=function(){Qt(T,q);fe(r,"htmx:afterRequest",H);fe(r,"htmx:sendAbort",H);oe(l);m()};p.ontimeout=function(){Qt(T,q);fe(r,"htmx:afterRequest",H);fe(r,"htmx:timeout",H);oe(l);m()};if(!he(r,"htmx:beforeRequest",H)){oe(s);m();return e}var T=Zt(r);var q=Yt(r);se(["loadstart","loadend","progress","abort"],function(t){se([p,p.upload],function(e){e.addEventListener(t,function(e){he(r,"htmx:xhr:"+t,{lengthComputable:e.lengthComputable,loaded:e.loaded,total:e.total})})})});he(r,"htmx:beforeSend",H);const J=E?null:mn(p,r,w);p.send(J);return e}function Nn(e,t){const n=t.xhr;let r=null;let o=null;if(R(n,/HX-Push:/i)){r=n.getResponseHeader("HX-Push");o="push"}else if(R(n,/HX-Push-Url:/i)){r=n.getResponseHeader("HX-Push-Url");o="push"}else if(R(n,/HX-Replace-Url:/i)){r=n.getResponseHeader("HX-Replace-Url");o="replace"}if(r){if(r==="false"){return{}}else{return{type:o,path:r}}}const i=t.pathInfo.finalRequestPath;const s=t.pathInfo.responsePath;const l=re(e,"hx-push-url");const c=re(e,"hx-replace-url");const u=ie(e).boosted;let a=null;let f=null;if(l){a="push";f=l}else if(c){a="replace";f=c}else if(u){a="push";f=s||i}if(f){if(f==="false"){return{}}if(f==="true"){f=s||i}if(t.pathInfo.anchor&&f.indexOf("#")===-1){f=f+"#"+t.pathInfo.anchor}return{type:a,path:f}}else{return{}}}function In(e,t){var n=new RegExp(e.code);return n.test(t.toString(10))}function Pn(e){for(var t=0;t0){E().setTimeout(e,x.swapDelay)}else{e()}}if(f){fe(o,"htmx:responseError",ce({error:"Response Status Error Code "+s.status+" from "+i.pathInfo.requestPath},i))}}const Mn={};function Xn(){return{init:function(e){return null},getSelectors:function(){return null},onEvent:function(e,t){return true},transformResponse:function(e,t,n){return e},isInlineSwap:function(e){return false},handleSwap:function(e,t,n,r){return false},encodeParameters:function(e,t,n){return null}}}function Fn(e,t){if(t.init){t.init(n)}Mn[e]=ce(Xn(),t)}function Bn(e){delete Mn[e]}function Un(e,n,r){if(n==undefined){n=[]}if(e==undefined){return n}if(r==undefined){r=[]}const t=te(e,"hx-ext");if(t){se(t.split(","),function(e){e=e.replace(/ /g,"");if(e.slice(0,7)=="ignore:"){r.push(e.slice(7));return}if(r.indexOf(e)<0){const t=Mn[e];if(t&&n.indexOf(t)<0){n.push(t)}}})}return Un(ue(c(e)),n,r)}var jn=false;ne().addEventListener("DOMContentLoaded",function(){jn=true});function Vn(e){if(jn||ne().readyState==="complete"){e()}else{ne().addEventListener("DOMContentLoaded",e)}}function _n(){if(Q.config.includeIndicatorStyles!==false){const e=Q.config.inlineStyleNonce?` nonce="${Q.config.inlineStyleNonce}"`:"";ne().head.insertAdjacentHTML("beforeend"," ."+Q.config.indicatorClass+"{opacity:0} ."+Q.config.requestClass+" ."+Q.config.indicatorClass+"{opacity:1; transition: opacity 200ms ease-in;} ."+Q.config.requestClass+"."+Q.config.indicatorClass+"{opacity:1; transition: opacity 200ms ease-in;} ")}}function zn(){const e=ne().querySelector('meta[name="htmx-config"]');if(e){return S(e.content)}else{return null}}function $n(){const e=zn();if(e){Q.config=ce(Q.config,e)}}Vn(function(){$n();_n();let e=ne().body;kt(e);const t=ne().querySelectorAll("[hx-trigger='restored'],[data-hx-trigger='restored']");e.addEventListener("htmx:abort",function(e){const t=e.target;const n=ie(t);if(n&&n.xhr){n.xhr.abort()}});const n=window.onpopstate?window.onpopstate.bind(window):null;window.onpopstate=function(e){if(e.state&&e.state.htmx){Wt();se(t,function(e){he(e,"htmx:restored",{document:ne(),triggerEvent:he})})}else{if(n){n(e)}}};E().setTimeout(function(){he(e,"htmx:load",{});e=null},0)});return Q}(); \ No newline at end of file diff --git a/web/static/style.css b/web/static/style.css new file mode 100644 index 0000000..10b3ac1 --- /dev/null +++ b/web/static/style.css @@ -0,0 +1,343 @@ +/* Metacircular Docs — clean technical document styling */ + +:root { + --bg: #fafafa; + --fg: #1a1a1a; + --fg-muted: #555; + --border: #ddd; + --link: #1a56db; + --link-hover: #0f3d91; + --code-bg: #f0f0f0; + --code-border: #ddd; + --sidebar-bg: #f5f5f5; + --sidebar-active: #e8e8e8; + --max-width: 72rem; + --content-width: 70ch; + --font-body: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; + --font-mono: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace; +} + +*, *::before, *::after { + box-sizing: border-box; +} + +html { + font-size: 16px; +} + +body { + margin: 0; + font-family: var(--font-body); + color: var(--fg); + background: var(--bg); + line-height: 1.65; +} + +a { + color: var(--link); + text-decoration: none; +} + +a:hover { + color: var(--link-hover); + text-decoration: underline; +} + +/* Header / Breadcrumbs */ + +header { + border-bottom: 1px solid var(--border); + padding: 0.75rem 1.5rem; + background: #fff; +} + +.breadcrumb { + max-width: var(--max-width); + margin: 0 auto; + font-size: 0.9rem; +} + +.breadcrumb .sep { + color: var(--fg-muted); + margin: 0 0.25rem; +} + +/* Main layout */ + +main { + max-width: var(--max-width); + margin: 0 auto; + display: flex; + gap: 2rem; + padding: 1.5rem; + min-height: calc(100vh - 8rem); +} + +/* Sidebar */ + +.sidebar { + flex: 0 0 14rem; + position: sticky; + top: 1.5rem; + align-self: flex-start; + max-height: calc(100vh - 4rem); + overflow-y: auto; +} + +.sidebar ul { + list-style: none; + padding: 0; + margin: 0; +} + +.sidebar li { + margin: 0; +} + +.sidebar li a { + display: block; + padding: 0.35rem 0.75rem; + border-radius: 4px; + font-size: 0.875rem; + color: var(--fg); +} + +.sidebar li a:hover { + background: var(--sidebar-bg); + text-decoration: none; +} + +.sidebar li.active a { + background: var(--sidebar-active); + font-weight: 600; +} + +/* Content */ + +#content { + flex: 1; + min-width: 0; + max-width: var(--content-width); +} + +/* Index page */ + +.repo-list { + display: grid; + gap: 1rem; +} + +.repo-card { + padding: 1rem 1.25rem; + border: 1px solid var(--border); + border-radius: 6px; + background: #fff; +} + +.repo-card h2 { + margin: 0 0 0.25rem; + font-size: 1.15rem; +} + +.repo-card p { + margin: 0 0 0.5rem; + color: var(--fg-muted); + font-size: 0.9rem; +} + +.doc-count { + font-size: 0.8rem; + color: var(--fg-muted); +} + +/* Repo page */ + +.repo-desc { + color: var(--fg-muted); + margin-bottom: 1.5rem; +} + +.doc-list { + list-style: none; + padding: 0; +} + +.doc-list li { + padding: 0.5rem 0; + border-bottom: 1px solid var(--border); +} + +.doc-list li:last-child { + border-bottom: none; +} + +/* Table of contents */ + +.toc { + margin-bottom: 2rem; + padding: 1rem 1.25rem; + background: var(--sidebar-bg); + border-radius: 6px; + font-size: 0.9rem; +} + +.toc summary { + cursor: pointer; + font-weight: 600; + margin-bottom: 0.5rem; +} + +.toc ul { + list-style: none; + padding: 0; + margin: 0; +} + +.toc li { + padding: 0.15rem 0; +} + +.toc-h2 { padding-left: 0; } +.toc-h3 { padding-left: 1rem; } +.toc-h4 { padding-left: 2rem; } +.toc-h5 { padding-left: 3rem; } + +/* Document content */ + +.doc-content { + line-height: 1.7; +} + +.doc-content h1 { font-size: 1.75rem; margin: 2rem 0 1rem; border-bottom: 1px solid var(--border); padding-bottom: 0.3rem; } +.doc-content h2 { font-size: 1.4rem; margin: 1.75rem 0 0.75rem; border-bottom: 1px solid var(--border); padding-bottom: 0.25rem; } +.doc-content h3 { font-size: 1.15rem; margin: 1.5rem 0 0.5rem; } +.doc-content h4 { font-size: 1rem; margin: 1.25rem 0 0.5rem; } + +.doc-content h1:first-child { margin-top: 0; } + +.doc-content p { + margin: 0.75rem 0; +} + +.doc-content code { + font-family: var(--font-mono); + font-size: 0.875em; + background: var(--code-bg); + padding: 0.15em 0.35em; + border-radius: 3px; +} + +.doc-content pre { + background: var(--code-bg); + border: 1px solid var(--code-border); + border-radius: 6px; + padding: 1rem; + overflow-x: auto; + line-height: 1.45; + font-size: 0.875rem; +} + +.doc-content pre code { + background: none; + padding: 0; + border-radius: 0; +} + +.doc-content table { + border-collapse: collapse; + width: 100%; + margin: 1rem 0; + font-size: 0.9rem; +} + +.doc-content th, .doc-content td { + border: 1px solid var(--border); + padding: 0.5rem 0.75rem; + text-align: left; +} + +.doc-content th { + background: var(--sidebar-bg); + font-weight: 600; +} + +.doc-content blockquote { + margin: 1rem 0; + padding: 0.5rem 1rem; + border-left: 3px solid var(--border); + color: var(--fg-muted); +} + +.doc-content ul, .doc-content ol { + padding-left: 1.5rem; +} + +.doc-content li { + margin: 0.25rem 0; +} + +.doc-content img { + max-width: 100%; + height: auto; +} + +.doc-content hr { + border: none; + border-top: 1px solid var(--border); + margin: 2rem 0; +} + +/* Task list (GFM) */ +.doc-content ul.contains-task-list { + list-style: none; + padding-left: 0; +} + +/* Error page */ + +.error-page { + text-align: center; + padding: 3rem 0; +} + +.error-page h1 { + font-size: 3rem; + color: var(--fg-muted); +} + +/* Loading page */ + +.loading { + text-align: center; + padding: 5rem 0; + color: var(--fg-muted); +} + +/* Footer */ + +footer { + border-top: 1px solid var(--border); + padding: 0.75rem 1.5rem; + text-align: center; + font-size: 0.8rem; + color: var(--fg-muted); +} + +/* Responsive */ + +@media (max-width: 768px) { + main { + flex-direction: column; + padding: 1rem; + } + + .sidebar { + position: static; + flex: none; + max-height: none; + } + + #content { + max-width: 100%; + } +} diff --git a/web/templates/doc.html b/web/templates/doc.html new file mode 100644 index 0000000..24eb71c --- /dev/null +++ b/web/templates/doc.html @@ -0,0 +1,17 @@ +{{define "content"}} +{{if .TOC}} + +{{end}} +
+ {{.Content}} +
+{{end}} diff --git a/web/templates/error.html b/web/templates/error.html new file mode 100644 index 0000000..01ff4dd --- /dev/null +++ b/web/templates/error.html @@ -0,0 +1,7 @@ +{{define "content"}} +
+

{{.Code}}

+

{{.Message}}

+ Back to index +
+{{end}} diff --git a/web/templates/index.html b/web/templates/index.html new file mode 100644 index 0000000..baa33d6 --- /dev/null +++ b/web/templates/index.html @@ -0,0 +1,14 @@ +{{define "content"}} +

Metacircular Platform Documentation

+
+ {{range .Repos}} +
+

{{.Name}}

+ {{if .Description}}

{{.Description}}

{{end}} + {{len .Docs}} document{{if ne (len .Docs) 1}}s{{end}} +
+ {{else}} +

No repositories found.

+ {{end}} +
+{{end}} diff --git a/web/templates/layout.html b/web/templates/layout.html new file mode 100644 index 0000000..fb1418d --- /dev/null +++ b/web/templates/layout.html @@ -0,0 +1,42 @@ + + + + + + {{if .Title}}{{.Title}} — {{end}}Metacircular Docs + + + + +
+ +
+
+ {{if .Sidebar}} + + {{end}} +
+ {{block "content" .}}{{end}} +
+
+
+ {{if .LastUpdated}}{{end}} +
+ + diff --git a/web/templates/loading.html b/web/templates/loading.html new file mode 100644 index 0000000..128ae67 --- /dev/null +++ b/web/templates/loading.html @@ -0,0 +1,20 @@ + + + + + + Loading — Metacircular Docs + + + + +
+
+
+

Metacircular Docs

+

Fetching documentation from Gitea... please wait.

+
+
+
+ + diff --git a/web/templates/repo.html b/web/templates/repo.html new file mode 100644 index 0000000..6780232 --- /dev/null +++ b/web/templates/repo.html @@ -0,0 +1,11 @@ +{{define "content"}} +

{{.RepoName}}

+{{if .RepoDescription}}

{{.RepoDescription}}

{{end}} + +{{end}}