docs: document file-based router migration (frontend routing rewrite)
Rewrite the frontend routing documentation for the TanStack Router
file-based system (PR #1447) and record the migration with reasoning:
- architecture/frontend/Routing.md: full rewrite — request flow,
router bootstrap + defaults, single Register + staticData typing,
auth/status gate, role tiers, beforeLoad flag gates (fail-closed
trade-off documented), 404 split, redirect-after-login, route-owned
search state (#1238), loaders, navigation conventions, nav
projection, Vite codegen, add-a-route and add-a-flag walkthroughs;
4 validated mermaid diagrams
- codes/frontend/routes: RouteGuards rewritten for pathless layouts +
beforeLoad (HOC guidance removed); RoutesIndex rewritten as the
verified 29-route catalog
- changes/refactors: new dated migration entry with self-contained
reasoning for every design decision
- stale old-router references corrected across Feature-Flags,
Authentication, Roles, Frontend Structure/Overview, ReportingUnitBlockDetails,
Formula pages, LayoutSideNav, and index/log files; the deleted
search-params sync hook converted to a removal record
- block details accuracy: the route keeps its dedicated
reporting-unit-block-details-enabled flag (beforeLoad, same pattern
as RU details); its lack of role restriction predates the migration
(#1254 dropped the D9-era ADMIN gate on 2026-10-13) — preserved
1:1, not changed by the migration
Refactor markdown links to standard format across documentation
- Converted wikilinks ([[Target|Display]]) to standard markdown links ([Display](Target)) in various markdown files.
- Updated references in ConditionalField.md, FileUploadInput.md, FormulaInput.md, ReadonlyInput.md, Layout components, Waste components, context-and-hook documentation, core components, and Cypress documentation.
- Ensured consistency in link formatting for better readability and navigation.
Refactor documentation links to use wiki-style formatting for improved navigation consistency across components and services. Update references in various markdown files including Components, Form, Layout, Waste, context-and-hook, and testing documentation. Ensure all related components and services are correctly linked for better accessibility and clarity.
feat: add DistrictListing and DistrictSelection components with detailed documentation
- Introduced DistrictListing component for displaying and selecting forest districts with search functionality and preference persistence.
- Created DistrictSelection component as a flexible shell for managing selectable lists, supporting custom query hooks and filter functions.
- Added EmptySection component for consistent empty state presentation across the app.
- Developed PageTitle component for shared page headers, including breadcrumb navigation and under-construction tags.
- Implemented Subtitle component for consistent secondary text styling.
- Added various Tag components (ColorTag, DateTag, EmptyValueTag, UnderConstructionTag, YesNoTag) for displaying status and value representations.
- Comprehensive documentation provided for all new components, detailing props, usage, and styling.