src/lib 80-percent reuse

Before adding src/lib/*.ts, inspect existing helpers and extend an existing module when it covers at least 80% of the need. A new helper file looks cleaner locally but fragments shared behavior; every genuinely new src/lib/**/*.ts module must have module-level JSDoc explaining its contract and rationale.