0
Fork 0
mirror of https://github.com/TanStack/router.git synced 2026-11-16 19:38:07 +00:00

fix(router-utils): the copy carries only what no output keeps once; identity uses and load-time calls count

Reviewed with five independent read-only passes over the rule; every
finding has a regression row.

- The copy walk stops at other candidates, effectful clusters, eager
  readers of state, what the route module's own roots keep alive and type
  units: each exists once by construction. An exported component reading
  `Route` is copied again; so is one reading an effectful binding or an
  object the route module keeps.
- A reference inside a module-level function an eager reference calls
  runs at load (`runsAtLoad`): `readsKeptEagerly`, the placement
  self-check and verify (e) see a TDZ through `const config = build()`,
  which the new env rooting had exposed for plain literals.
- A function used as a constructor, an `instanceof` or equality operand or
  through `.prototype` has an identity (`identityUse`): not copied.
- A copied export another extracted module reads is imported there from
  its own module; only chunks copy it.
- Provider outputs do not count as needers when homing; a value an
  extracted module and a provider share lives in the export module.
- The env rooting of a shared identity or state is reported
  (`eager-split:shared`). A primitive constant with a member write is no
  state. The one-holder invariant lives with placement's self-checks.
- The build-time eager-export warning names its cause from the bundler's
  module graph: split code importing the module under a chunk group that
  lands with the entry, or an importer through the route file.
- Docs: guide, README, SPEC J2.4, KNOWN-BUGS, hydrate planner comment, test
  comments. Tests: core rows for every finding; fact-check rows for
  constructors, sentinels and sibling exports; the F5 build matrix gains an
  exported class; a new matrix groups the route files with the entry on
  Vite, Rspack, webpack and Rsbuild; Start build and planner rows for an
  exported class.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
Sheraff 2026-11-01 13:59:26 +01:00
commit c2397221de
No known key found for this signature in database
29 changed files with 1141 additions and 147 deletions