feat: middleware examples, golit serve warm path, and SSR benchmarks

[zeroedin]

Summary

Adds PHP and Rack middleware examples that SSR Lit via golit, a long-lived golit serve command for a warm Renderer, container/local wiring, and benchmark scripts.

Changes

• golit serve: GET /health, POST /render (full HTML → transformed HTML), mutex around RenderHTML, graceful shutdown.
• Middleware: GOLIT_SERVE_URL uses HTTP to the warm server; unset falls back to per-request golit transform exec.
• Containers: docker-entrypoint.sh starts golit serve unless GOLIT_DISABLED (used by bench for with/without compare).
• Benchmarks: bench.sh + Make targets; curl TTFB/size; optional --browser / --trace; macOS-friendly stats (no gawk asort).
• .gitignore: ignore root binary as /golit only so cmd/golit/*.go is not ignored.

Notes

Rebuild images after merge for warm-path benches (make container).

Made with Cursor

[Copilot]

Pull request overview

Adds warm-path SSR support via a long-lived golit serve HTTP server, plus PHP and Ruby middleware examples (with containers and benchmarking scripts) to demonstrate per-request SSR without batch transforms.

Changes:

• Introduces golit serve (HTTP GET /health, POST /render) to reuse a warm Renderer across requests.
• Adds PHP front-controller and Ruby Rack middleware examples that SSR HTML via golit serve (or fall back to per-request golit transform).
• Adds container wiring, benchmark scripts, and documentation updates for the new examples and warm/cold paths.

Reviewed changes

Copilot reviewed 33 out of 34 changed files in this pull request and generated 13 comments.

Show a summary per file

File	Description
README.md	Documents new middleware examples, golit serve, and benchmark workflow.
cmd/golit/main.go	Adds CLI dispatch/help text for the new serve command.
cmd/golit/serve.go	Implements the warm SSR HTTP server around a long-lived Renderer.
.gitignore	Stops ignoring cmd/golit/* by only ignoring the root /golit binary.
examples/bench/perf-snippet.js	Adds a Performance API snippet for optional browser-based benchmark metrics.
examples/php-middleware/Makefile	Adds build/serve/container/bench targets for PHP middleware demo.
examples/php-middleware/package.json	Adds Lit dependency for the PHP demo component.
examples/php-middleware/golit.yaml	Adds local transform config pointing at bundles/.
examples/php-middleware/.gitignore	Ignores bundles/node_modules/bench results for PHP demo.
examples/php-middleware/components/my-counter.js	Adds the demo Lit <my-counter> component.
examples/php-middleware/public/router.php	Implements PHP front controller and SSR middleware (warm serve or cold transform).
examples/php-middleware/public/pages/_layout.php	Adds shared HTML layout, import map, and optional perf instrumentation.
examples/php-middleware/public/pages/home.php	Adds PHP demo home page with <my-counter>.
examples/php-middleware/public/pages/about.php	Adds PHP demo about page explaining the SSR pipeline.
examples/php-middleware/dev-serve.sh	Starts golit serve locally before running PHP (warm path).
examples/php-middleware/docker-entrypoint.sh	Starts golit serve in container unless SSR is disabled.
examples/php-middleware/Containerfile	Builds a runnable container image for the PHP middleware demo.
examples/php-middleware/bench.sh	Benchmarks container startup/TTFB/size/memory with SSR on vs off.
examples/ruby-middleware/Makefile	Adds build/serve/container/bench targets for Ruby middleware demo.
examples/ruby-middleware/package.json	Adds Lit dependency for the Ruby demo component.
examples/ruby-middleware/golit.yaml	Adds local transform config pointing at bundles/.
examples/ruby-middleware/.gitignore	Ignores bundles/node_modules/bench results and Gemfile.lock for Ruby demo.
examples/ruby-middleware/Gemfile	Adds Rack/Puma dependencies for the Ruby demo.
examples/ruby-middleware/config.ru	Adds a minimal Rack app and mounts the SSR middleware.
examples/ruby-middleware/lib/golit_middleware.rb	Implements Rack middleware for warm serve / cold transform SSR.
examples/ruby-middleware/views/layout.erb	Adds shared HTML layout, import map, and optional perf instrumentation.
examples/ruby-middleware/views/home.erb	Adds Ruby demo home page with <my-counter>.
examples/ruby-middleware/views/about.erb	Adds Ruby demo about page explaining the SSR pipeline.
examples/ruby-middleware/components/my-counter.js	Adds the demo Lit <my-counter> component.
examples/ruby-middleware/dev-serve.sh	Starts golit serve locally before running rackup (warm path).
examples/ruby-middleware/docker-entrypoint.sh	Starts golit serve in container unless SSR is disabled.
examples/ruby-middleware/Containerfile	Builds a runnable container image for the Ruby middleware demo.
examples/ruby-middleware/bench.sh	Benchmarks container startup/TTFB/size/memory with SSR on vs off.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.