chore: make fsRoutes dir and adapter required, add next-adapter convenience module

[uhyo]

Summary

Tightens the experimental fsRoutes plugin option so users are explicit rather than relying on opinionated defaults, and adds a bundled convenience adapter so opting into the built-in convention stays a one-liner.

This is a breaking change to the (experimental) fsRoutes API — not yet covered by semantic versioning.

Changes

• Make fsRoutes.dir and fsRoutes.adapter required. Both previously had opinionated defaults (dir → "./src/pages", adapter → the built-in nextRoutes()); they must now be specified. root was already required.
• Add the @funstack/static/fs-routes/next-adapter convenience module. A bundled module that export defaults nextRoutes(), so users can point adapter at it to use the built-in Next.js-like convention without writing their own re-export file.
• Accept bare module specifiers for adapter. The option now resolves either a bare package import (like @funstack/static/fs-routes/next-adapter) or a path relative to the Vite root, instead of always path.resolve-ing against the root.
• Updated the example, e2e fixture, and docs (API reference + File-System Routing guide) accordingly.

Usage after this change:

funstackStatic({
  ssr: true,
  fsRoutes: {
    dir: "./src/pages",
    root: "./src/root.tsx",
    adapter: "@funstack/static/fs-routes/next-adapter",
  },
});

Commits

1. chore: make fsRoutes dir and adapter required
2. feat: add @funstack/static/fs-routes/next convenience adapter module
3. refactor: rename convenience module to @funstack/static/fs-routes/next-adapter

Test plan

• pnpm build — emits dist/fs-routes/next-adapter.{mjs,d.mts}
• pnpm typecheck clean
• pnpm test:run — 51 unit tests pass
• pnpm lint / pnpm format:check clean
• Built the fs-routing e2e fixture directly — all 7 pages generate, confirming the bare-specifier adapter resolves end to end

Note: the Playwright e2e suite couldn't run to completion in the sandbox (the pre-installed Chromium is at a different path than the chrome-headless-shell the runner expected) — an environment issue, unrelated to these changes. The build phase those tests depend on succeeded.

🤖 Generated with Claude Code

https://claude.ai/code/session_019KZaV9B4HmtACBqoPdL8qK

---

Generated by Claude Code