7a7a9f5e6b
refactor(utils): group utils/ files into topic folders (Phase L, part 1) ( #689 )
...
111 of 122 top-level src/utils/ files move into 16 topic folders (audio,
cache, cover, share, server, playback, playlist, deviceSync, waveform,
mix, format, export, changelog, ui, perf, componentHelpers). True
singletons with no cluster stay at the utils/ root.
Pure file-move: a path-aware codemod rewrote 539 relative-import
specifiers across 275 files; no logic touched. The hot-path coverage
gate list (.github/frontend-hot-path-files.txt) is updated to the new
paths for the 11 gated utils files — a mechanical consequence of the
move, not a CI change. tsc is green.
2026-05-14 14:27:44 +02:00
3dc50a2ef0
refactor(orbit): I.6 — split utils/orbit.ts 989 → 77 LOC across 10 modules ( #678 )
...
* refactor(orbit): extract constants, helpers, and state math
First extraction step of the utils/orbit.ts split. Pure, no-I/O code
moves into utils/orbit/ submodules; utils/orbit.ts becomes a re-export
shim so every call site outside this directory keeps importing from
'../utils/orbit' unchanged.
- utils/orbit/constants.ts: ORBIT_HEARTBEAT_ALIVE_MS,
ORBIT_ORPHAN_TTL_MS, ORBIT_SHUFFLE_INTERVAL_MS, ORBIT_REMOVED_TTL_MS.
- utils/orbit/helpers.ts: generateSessionId, serialiseOrbitState +
OrbitStateTooLarge, serialiseOutboxMeta, suggestionKey,
parseOutboxPlaylistName.
- utils/orbit/stateMath.ts: patchOrbitState, maybeShuffleQueue,
effectiveShuffleIntervalMs, computeOrbitDriftMs,
applyOutboxSnapshotsToState, OutboxSnapshot type.
utils/orbit.ts: 989 → 806 LOC.
* refactor(orbit): extract remote I/O + share link
Pull readOrbitState / writeOrbitState / writeOrbitHeartbeat /
findSessionPlaylistId into utils/orbit/remote.ts. Pull
parseOrbitShareLink / buildOrbitShareLink + OrbitShareLink into
utils/orbit/shareLink.ts. Re-exported from the orbit.ts shim.
utils/orbit.ts: 806 → 721 LOC.
* refactor(orbit): extract host lifecycle
Pull startOrbitSession, endOrbitSession, triggerOrbitShuffleNow,
updateOrbitSettings, hostEnqueueToOrbit (and the StartOrbitArgs
interface) into utils/orbit/host.ts. Re-exported from the orbit.ts shim.
utils/orbit.ts: 721 → 546 LOC.
* refactor(orbit): extract host moderation
Pull kickOrbitParticipant, removeOrbitParticipant, and
setOrbitSuggestionBlocked into utils/orbit/moderation.ts. Re-exported
from the orbit.ts shim.
utils/orbit.ts: 546 → 422 LOC.
* refactor(orbit): extract guest lifecycle + suggest pipeline
Pull joinOrbitSession / leaveOrbitSession (+ OrbitJoinError), the suggest
gate (evaluateOrbitSuggestGate / OrbitSuggestGateReason /
OrbitSuggestBlockedError / suggestOrbitTrack), and the host-side
approve / decline reactions into utils/orbit/guest.ts. Re-exported from
the orbit.ts shim.
utils/orbit.ts: 422 → 244 LOC.
* refactor(orbit): extract sweep + cleanup, collapse shim
Pull sweepGuestOutboxes (+ private listGuestOutboxes / readOutbox) into
utils/orbit/sweep.ts and cleanupOrphanedOrbitPlaylists into
utils/orbit/cleanup.ts.
utils/orbit.ts collapses to a pure re-export shim — every external import
path stays the same, the file just lists which symbol lives in which
submodule.
utils/orbit.ts: 244 → 77 LOC.
Full split: 989 LOC monolith → 10 single-concern modules, none over 210 LOC.
2026-05-14 01:08:45 +02:00
Frank Stellmacher