@reicek/neataptic-ts 0.1.25 → 0.1.26

package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/README.md

@@ -48,40 +48,13 @@ deliberate: the lower-band renderer should respond to camera motion like a
 piece of scenic lighting, not reach into gameplay entities or playback HUD
 state.
 
-### PlaybackGroundGridHorizontalGeometryFactory
-
-```ts
-PlaybackGroundGridHorizontalGeometryFactory(): PlaybackGroundGridHorizontalGeometry
-```
-
-Lazy builder used when one horizontal geometry cache entry is missing.
-
-Horizontal depth bands depend only on stable scene dimensions, so callers can
-defer their construction until a cache miss proves the work is actually
-needed.
-
-### PlaybackGroundGridVerticalGeometryFactory
-
-```ts
-PlaybackGroundGridVerticalGeometryFactory(): PlaybackGroundGridVerticalGeometry
-```
-
-Lazy builder used when one vertical geometry cache entry is missing.
-
-Vertical rays additionally depend on wrapped scroll state, so the cache keeps
-a compact builder hook rather than eagerly storing every possible cycle.
-
-### PlaybackGroundGridVerticalSceneMetricsFactory
-
-```ts
-PlaybackGroundGridVerticalSceneMetricsFactory(): PlaybackGroundGridVerticalSceneMetrics
-```
+### PlaybackBackgroundGroundGridResolvedScene
 
-Lazy builder used when one vertical scene-metrics cache entry is missing.
+Geometry and style package resolved before drawing the ground grid.
 
-Scene metrics such as projected anchor bounds are pure functions of the
-viewport, which makes them ideal cache inputs for the performance-sensitive
-lower-band renderer.
+Splitting scene resolution from drawing keeps canvas code simple: by the time
+the renderer runs, every geometric and palette decision has already been made
+and packed into one immutable object graph.
 
 ### PlaybackBackgroundGroundGridSceneContext
 
@@ -91,6 +64,14 @@ This is the adapted subset of the shared background scene that the ground
 grid cares about: horizon position, lower-band bounds, and the centered
 vanishing point that gives the grid its forced-perspective look.
 
+### PlaybackBackgroundGroundGridSourceScene
+
+Helper alias used when adapting the shared background scene context.
+
+The parent background module owns the full sky-plus-ground scene contract;
+the grid renderer narrows that shape to only the fields needed for the lower
+band so the dependency direction stays clear.
+
 ### PlaybackBackgroundGroundGridStyle
 
 Theme-owned style contract for the neon ground grid.
@@ -99,20 +80,47 @@ The ground grid uses three coordinated colors: the structural line work, a
 fog wash that softens the lower band, and small pulse markers that briefly
 travel along eligible tracks.
 
-### PlaybackGroundGridPulseOrientation
+### PlaybackGroundGridAnchorBounds
 
-Travel orientation used by lightweight pulse overlays.
+Visible horizon bounds projected onto the bottom anchor line.
 
-Horizontal pulses skim along depth bands, while vertical pulses ride the
-perspective rays toward or away from the horizon.
+Perspective rays begin conceptually at the horizon and terminate on the floor
+anchor line, so this structure captures the visible lane span after the
+horizon segment has been projected downward.
 
-### PlaybackBackgroundGroundGridResolvedScene
+### PlaybackGroundGridAnchorBoundsInput
 
-Geometry and style package resolved before drawing the ground grid.
+Input used when projecting a visible horizon span onto anchor space.
 
-Splitting scene resolution from drawing keeps canvas code simple: by the time
-the renderer runs, every geometric and palette decision has already been made
-and packed into one immutable object graph.
+### PlaybackGroundGridAnchorProjectionInput
+
+Input used when projecting one horizon x-position onto the floor anchor line.
+
+### PlaybackGroundGridGeometry
+
+Pure geometry bundle generated before canvas drawing begins.
+
+Horizontal bands, vertical rays, and the optional pulse are resolved into one
+package so the draw layer can stay strictly about paint order.
+
+### PlaybackGroundGridHorizontalGeometry
+
+Cached horizontal geometry bundle reused across matching scene sizes.
+
+Horizontal depth lines are stable for a given viewport, which makes them the
+cheapest part of the grid to cache aggressively.
+
+### PlaybackGroundGridHorizontalGeometryFactory
+
+```ts
+PlaybackGroundGridHorizontalGeometryFactory(): PlaybackGroundGridHorizontalGeometry
+```
+
+Lazy builder used when one horizontal geometry cache entry is missing.
+
+Horizontal depth bands depend only on stable scene dimensions, so callers can
+defer their construction until a cache miss proves the work is actually
+needed.
 
 ### PlaybackGroundGridLineSegment
 
@@ -121,20 +129,28 @@ Declarative line segment model used by the ground-grid renderer.
 The grid is built as plain data first so batch builders can group segments by
 shared style before any canvas path or glow work happens.
 
-### PlaybackGroundGridSegmentBatch
+### PlaybackGroundGridPulse
 
-Ordered batch of line segments that share one render style.
+One visible pulse square rendered above the grid lines.
 
-Grouping segments by alpha, blur, and thickness reduces canvas state churn
-and gives the renderer a natural place to cache `Path2D` instances when the
-environment supports them.
+These pulses are tiny accent lights, not gameplay markers. Their job is to
+give the lower band a hint of moving circuitry without competing with birds,
+pipes, or the active network HUD.
 
-### PlaybackGroundGridVerticalRayInput
+### PlaybackGroundGridPulseInput
 
-Internal helper contract used while generating vertical-ray sub-segments.
+Input contract used while resolving one deterministic pulse event.
 
-Each vertical ray is split into depth-aware pieces so stroke thickness and
-glow can evolve as the ray approaches the viewer instead of staying uniform.
+Pulses are deterministic decoration: given the same frame and scene, the same
+lane should light up. This input bundle gathers the candidate paths needed to
+make that choice without consulting external state.
+
+### PlaybackGroundGridPulseOrientation
+
+Travel orientation used by lightweight pulse overlays.
+
+Horizontal pulses skim along depth bands, while vertical pulses ride the
+perspective rays toward or away from the horizon.
 
 ### PlaybackGroundGridPulsePath
 
@@ -143,27 +159,43 @@ Simplified path used by one visible pulse event.
 Pulses do not need the full batch geometry; they only need a single lane to
 travel along, represented here as a start-end segment plus local thickness.
 
-### PlaybackGroundGridPulse
+### PlaybackGroundGridPulseTimingState
 
-One visible pulse square rendered above the grid lines.
+Timing state resolved for one deterministic ground-grid pulse slot.
 
-These pulses are tiny accent lights, not gameplay markers. Their job is to
-give the lower band a hint of moving circuitry without competing with birds,
-pipes, or the active network HUD.
+The slot model keeps pulse timing legible: each pulse has a start bucket, an
+elapsed time inside that bucket, and a normalized progress value used by the
+position and fade helpers.
 
-### PlaybackGroundGridGeometry
+### PlaybackGroundGridPulseTrackThicknessInput
 
-Pure geometry bundle generated before canvas drawing begins.
+Input used when adapting a pulse position into a local track thickness.
 
-Horizontal bands, vertical rays, and the optional pulse are resolved into one
-package so the draw layer can stay strictly about paint order.
+Because the grid uses perspective-weighted stroke widths, the pulse size must
+be adjusted to the local lane thickness rather than using one fixed square.
 
-### PlaybackGroundGridHorizontalGeometry
+### PlaybackGroundGridPulseTravelRatioInput
 
-Cached horizontal geometry bundle reused across matching scene sizes.
+Direction and timing state used when resolving pulse travel progress.
 
-Horizontal depth lines are stable for a given viewport, which makes them the
-cheapest part of the grid to cache aggressively.
+Some pulse lanes feel better moving away from the viewer and others toward
+it, so travel resolution keeps orientation and forward/reverse intent paired
+with the current lifetime progress.
+
+### PlaybackGroundGridSegmentBatch
+
+Ordered batch of line segments that share one render style.
+
+Grouping segments by alpha, blur, and thickness reduces canvas state churn
+and gives the renderer a natural place to cache `Path2D` instances when the
+environment supports them.
+
+### PlaybackGroundGridVerticalCycleContext
+
+Wrapped vertical-cycle state derived from scroll for one frame.
+
+The perspective rays repeat on a fixed cycle. Wrapping the scroll state lets
+the renderer reuse cached geometry while still appearing to drift sideways.
 
 ### PlaybackGroundGridVerticalGeometry
 
@@ -173,6 +205,31 @@ Vertical rays move with scroll, but only within a repeating wrapped cycle.
 Caching at that granularity captures most of the reuse without pretending the
 rays are globally static.
 
+### PlaybackGroundGridVerticalGeometryFactory
+
+```ts
+PlaybackGroundGridVerticalGeometryFactory(): PlaybackGroundGridVerticalGeometry
+```
+
+Lazy builder used when one vertical geometry cache entry is missing.
+
+Vertical rays additionally depend on wrapped scroll state, so the cache keeps
+a compact builder hook rather than eagerly storing every possible cycle.
+
+### PlaybackGroundGridVerticalPulseContinuationState
+
+Cached continuation state used to keep one vertical pulse on the same ray.
+
+Without this continuity state a vertical pulse could jitter between adjacent
+rays across frames, which looks like noise instead of a deliberate light.
+
+### PlaybackGroundGridVerticalRayInput
+
+Internal helper contract used while generating vertical-ray sub-segments.
+
+Each vertical ray is split into depth-aware pieces so stroke thickness and
+glow can evolve as the ray approaches the viewer instead of staying uniform.
+
 ### PlaybackGroundGridVerticalSceneMetrics
 
 Cached scene metrics reused across matching vertical-grid frames.
@@ -181,93 +238,85 @@ These metrics answer the expensive geometric questions once per viewport,
 such as how wide the visible anchor span is and how many perspective lanes
 can fit while preserving the intended spacing.
 
-### PlaybackGroundGridAnchorBounds
+### PlaybackGroundGridVerticalSceneMetricsFactory
 
-Visible horizon bounds projected onto the bottom anchor line.
+```ts
+PlaybackGroundGridVerticalSceneMetricsFactory(): PlaybackGroundGridVerticalSceneMetrics
+```
 
-Perspective rays begin conceptually at the horizon and terminate on the floor
-anchor line, so this structure captures the visible lane span after the
-horizon segment has been projected downward.
+Lazy builder used when one vertical scene-metrics cache entry is missing.
 
-### PlaybackGroundGridAnchorBoundsInput
+Scene metrics such as projected anchor bounds are pure functions of the
+viewport, which makes them ideal cache inputs for the performance-sensitive
+lower-band renderer.
 
-Input used when projecting a visible horizon span onto anchor space.
+## browser-entry/playback/background/ground-grid/playback.background.ground-grid.constants.ts
 
-### PlaybackGroundGridAnchorProjectionInput
+### FLAPPY_BACKGROUND_GROUND_GRID_STYLE
 
-Input used when projecting one horizon x-position onto the floor anchor line.
+Frozen neon style bundle reused by the playback ground-grid renderer.
 
-### PlaybackGroundGridVerticalCycleContext
+The values stay theme-owned but are materialized once so the renderer does
+not allocate a new style object during every frame.
 
-Wrapped vertical-cycle state derived from scroll for one frame.
+### FLAPPY_GROUND_GRID_APPROX_FRAME_DURATION_MS
 
-The perspective rays repeat on a fixed cycle. Wrapping the scroll state lets
-the renderer reuse cached geometry while still appearing to drift sideways.
+Approximate playback frame duration used for deterministic pulse timing.
 
-### PlaybackGroundGridPulseInput
+The pulse system is designed to feel stable at ordinary browser animation
+cadence without requiring access to wall-clock time in every helper.
 
-Input contract used while resolving one deterministic pulse event.
+### FLAPPY_GROUND_GRID_DEPTH_CURVE_EXPONENT
 
-Pulses are deterministic decoration: given the same frame and scene, the same
-lane should light up. This input bundle gathers the candidate paths needed to
-make that choice without consulting external state.
+Non-linear exponent used to compress depth lines toward the horizon.
 
-### PlaybackGroundGridPulseTimingState
+This is the main perspective stylization control: higher values bunch more of
+the depth bands near the horizon and leave broader spacing near the viewer.
 
-Timing state resolved for one deterministic ground-grid pulse slot.
+### FLAPPY_GROUND_GRID_FOG_ALPHA
 
-The slot model keeps pulse timing legible: each pulse has a start bucket, an
-elapsed time inside that bucket, and a normalized progress value used by the
-position and fade helpers.
+Peak opacity used by the lower-band neon fog wash.
 
-### PlaybackGroundGridPulseTravelRatioInput
+The fog should tint the band, not obscure the line geometry, so the opacity
+is intentionally modest.
 
-Direction and timing state used when resolving pulse travel progress.
+### FLAPPY_GROUND_GRID_FOG_HEIGHT_RATIO
 
-Some pulse lanes feel better moving away from the viewer and others toward
-it, so travel resolution keeps orientation and forward/reverse intent paired
-with the current lifetime progress.
+Height ratio reserved for the subtle lower-band neon fog wash.
 
-### PlaybackGroundGridPulseTrackThicknessInput
+The fog sits in the lower portion of the band so it enriches the foreground
+without muting the crisp horizon seam.
 
-Input used when adapting a pulse position into a local track thickness.
+### FLAPPY_GROUND_GRID_HORIZONTAL_LINE_COUNT
 
-Because the grid uses perspective-weighted stroke widths, the pulse size must
-be adjusted to the local lane thickness rather than using one fixed square.
+Number of horizontal depth bands used by the neon ground grid.
 
-### PlaybackGroundGridVerticalPulseContinuationState
+More bands increase the sense of depth, but they also thicken the lower band
+visually and add more line work to each frame.
 
-Cached continuation state used to keep one vertical pulse on the same ray.
+### FLAPPY_GROUND_GRID_MAX_ALPHA
 
-Without this continuity state a vertical pulse could jitter between adjacent
-rays across frames, which looks like noise instead of a deliberate light.
+Maximum alpha used by the nearest depth and perspective lines.
 
-### PlaybackBackgroundGroundGridSourceScene
+### FLAPPY_GROUND_GRID_MAX_BLUR_PX
 
-Helper alias used when adapting the shared background scene context.
+Blur radius used by the farthest depth lines near the horizon.
 
-The parent background module owns the full sky-plus-ground scene contract;
-the grid renderer narrows that shape to only the fields needed for the lower
-band so the dependency direction stays clear.
+### FLAPPY_GROUND_GRID_MAX_THICKNESS_PX
 
-## browser-entry/playback/background/ground-grid/playback.background.ground-grid.constants.ts
+Maximum stroke width used by near depth lines.
 
-### FLAPPY_GROUND_GRID_HORIZONTAL_LINE_COUNT
+### FLAPPY_GROUND_GRID_MIN_ALPHA
 
-Number of horizontal depth bands used by the neon ground grid.
+Minimum alpha used by the farthest horizontal depth lines.
 
-More bands increase the sense of depth, but they also thicken the lower band
-visually and add more line work to each frame.
+### FLAPPY_GROUND_GRID_MIN_BLUR_PX
 
-### FLAPPY_GROUND_GRID_TARGET_VERTICAL_LINE_SPACING_PX
+Blur radius used by the nearest depth lines at the bottom edge.
 
-Target visible spacing between adjacent vertical rays at the pipe floor.
+### FLAPPY_GROUND_GRID_MIN_THICKNESS_PX
 
-The lower pipes visually attach to a projected floor band in the grid. The
-important invariant is phase repeat, not just raw gap width: each new pipe at
-max difficulty should land on the same relative grid position as the previous
-one. That requires matching the full pipe-to-pipe pitch, not only the open
-edge-to-edge gap between pipe bodies.
+Minimum stroke width used by far depth lines.
 
 ### FLAPPY_GROUND_GRID_MIN_VERTICAL_LINE_COUNT
 
@@ -276,26 +325,16 @@ Minimum visible perspective-ray count used on very narrow viewports.
 Even on a small canvas, the grid still needs at least a few rays to read as
 perspective instead of a flat block of horizontal stripes.
 
-### FLAPPY_GROUND_GRID_VERTICAL_OVERFLOW_COUNT
-
-Extra off-screen perspective rays drawn for seamless wrap.
-
-Overflow rays prevent the parallax cycle from exposing empty gaps when the
-wrapped scroll offset lands near a lane boundary.
-
-### FLAPPY_GROUND_GRID_TARGET_VERTICAL_SEGMENT_HEIGHT_PX
-
-Target screen-space height for one vertical-ray style segment (pixels).
+### FLAPPY_GROUND_GRID_PIPE_CONNECTION_LINE_OFFSET_FROM_BOTTOM
 
-Segmenting the rays lets the renderer vary alpha, thickness, and blur by
-depth rather than drawing each ray with one flat style.
+Near-edge horizontal line offset used for the lower-pipe floor illusion.
 
-### FLAPPY_GROUND_GRID_APPROX_FRAME_DURATION_MS
+`1` targets the first usable grid band above the bottom edge rather than the
+terminal line that coincides with the lower-band boundary itself.
 
-Approximate playback frame duration used for deterministic pulse timing.
+### FLAPPY_GROUND_GRID_PULSE_ALPHA
 
-The pulse system is designed to feel stable at ordinary browser animation
-cadence without requiring access to wall-clock time in every helper.
+Peak opacity used by visible pulse squares.
 
 ### FLAPPY_GROUND_GRID_PULSE_INTERVAL_MS
 
@@ -311,36 +350,18 @@ Lifetime of one pulse as it travels across its chosen line (milliseconds).
 The lifetime is slightly shorter than the full interval so one pulse fades
 out before the next slot becomes active.
 
-### FLAPPY_GROUND_GRID_PULSE_ALPHA
-
-Peak opacity used by visible pulse squares.
-
-### FLAPPY_GROUND_GRID_PULSE_MIN_SIZE_PX
-
-Smallest visible pulse square size (pixels).
-
 ### FLAPPY_GROUND_GRID_PULSE_MAX_SIZE_PX
 
 Largest visible pulse square size (pixels).
 
-### FLAPPY_GROUND_GRID_VERTICAL_PULSE_START_RATIO
-
-Earliest progress ratio allowed for vertical pulse travel.
-
-Vertical pulses start a little away from the horizon so they are visible as
-distinct squares instead of immediately disappearing into compressed depth.
-
-### FLAPPY_GROUND_GRID_VERTICAL_PULSE_END_RATIO
-
-Latest progress ratio allowed for vertical pulse travel.
-
-Ending early keeps the pulse out of the extreme foreground, where its square
-would become too large and visually heavy.
-
 ### FLAPPY_GROUND_GRID_PULSE_MIN_ELIGIBLE_THICKNESS_PX
 
 Minimum horizontal line thickness eligible for pulse travel.
 
+### FLAPPY_GROUND_GRID_PULSE_MIN_SIZE_PX
+
+Smallest visible pulse square size (pixels).
+
 ### FLAPPY_GROUND_GRID_PULSE_PREFERRED_HORIZONTAL_START_RATIO
 
 Earliest eligible slice of horizontal lines used for visible pulse picks.
@@ -352,26 +373,12 @@ of the compressed lines nearest the horizon.
 
 Horizontal inset that keeps vertical pulse picks away from clipped edges.
 
-### FLAPPY_GROUND_GRID_UNSIGNED_NORMALIZATION_DIVISOR
-
-Normalization divisor used for deterministic pulse hash generation.
-
-The pulse selection helpers convert unsigned integer hashes into stable
-floating-point picks in the unit interval.
-
-### FLAPPY_GROUND_GRID_DEPTH_CURVE_EXPONENT
-
-Non-linear exponent used to compress depth lines toward the horizon.
-
-This is the main perspective stylization control: higher values bunch more of
-the depth bands near the horizon and leave broader spacing near the viewer.
-
-### FLAPPY_GROUND_GRID_PIPE_CONNECTION_LINE_OFFSET_FROM_BOTTOM
+### FLAPPY_GROUND_GRID_SCROLL_OFFSET_QUANTIZATION_DECIMALS
 
-Near-edge horizontal line offset used for the lower-pipe floor illusion.
+Decimal precision used when quantizing the wrapped vertical-ray offset.
 
-`1` targets the first usable grid band above the bottom edge rather than the
-terminal line that coincides with the lower-band boundary itself.
+Quantization stabilizes cache reuse by preventing tiny floating-point drift
+from generating effectively identical geometry variants.
 
 ### FLAPPY_GROUND_GRID_SCROLL_RATIO
 
@@ -380,76 +387,86 @@ Scroll ratio applied to the moving vertical perspective rays.
 Keeping the rays slower than gameplay motion makes the grid feel like a deep
 environmental layer rather than a surface glued to the pipes.
 
-### FLAPPY_GROUND_GRID_SCROLL_OFFSET_QUANTIZATION_DECIMALS
-
-Decimal precision used when quantizing the wrapped vertical-ray offset.
+### FLAPPY_GROUND_GRID_TARGET_VERTICAL_LINE_SPACING_PX
 
-Quantization stabilizes cache reuse by preventing tiny floating-point drift
-from generating effectively identical geometry variants.
+Target visible spacing between adjacent vertical rays at the pipe floor.
 
-### FLAPPY_GROUND_GRID_MIN_ALPHA
+The lower pipes visually attach to a projected floor band in the grid. The
+important invariant is phase repeat, not just raw gap width: each new pipe at
+max difficulty should land on the same relative grid position as the previous
+one. That requires matching the full pipe-to-pipe pitch, not only the open
+edge-to-edge gap between pipe bodies.
 
-Minimum alpha used by the farthest horizontal depth lines.
+### FLAPPY_GROUND_GRID_TARGET_VERTICAL_SEGMENT_HEIGHT_PX
 
-### FLAPPY_GROUND_GRID_MAX_ALPHA
+Target screen-space height for one vertical-ray style segment (pixels).
 
-Maximum alpha used by the nearest depth and perspective lines.
+Segmenting the rays lets the renderer vary alpha, thickness, and blur by
+depth rather than drawing each ray with one flat style.
 
-### FLAPPY_GROUND_GRID_MAX_BLUR_PX
+### FLAPPY_GROUND_GRID_UNSIGNED_NORMALIZATION_DIVISOR
 
-Blur radius used by the farthest depth lines near the horizon.
+Normalization divisor used for deterministic pulse hash generation.
 
-### FLAPPY_GROUND_GRID_MIN_BLUR_PX
+The pulse selection helpers convert unsigned integer hashes into stable
+floating-point picks in the unit interval.
 
-Blur radius used by the nearest depth lines at the bottom edge.
+### FLAPPY_GROUND_GRID_VERTICAL_OVERFLOW_COUNT
 
-### FLAPPY_GROUND_GRID_MIN_THICKNESS_PX
+Extra off-screen perspective rays drawn for seamless wrap.
 
-Minimum stroke width used by far depth lines.
+Overflow rays prevent the parallax cycle from exposing empty gaps when the
+wrapped scroll offset lands near a lane boundary.
 
-### FLAPPY_GROUND_GRID_MAX_THICKNESS_PX
+### FLAPPY_GROUND_GRID_VERTICAL_PULSE_END_RATIO
 
-Maximum stroke width used by near depth lines.
+Latest progress ratio allowed for vertical pulse travel.
 
-### FLAPPY_GROUND_GRID_FOG_HEIGHT_RATIO
+Ending early keeps the pulse out of the extreme foreground, where its square
+would become too large and visually heavy.
 
-Height ratio reserved for the subtle lower-band neon fog wash.
+### FLAPPY_GROUND_GRID_VERTICAL_PULSE_START_RATIO
 
-The fog sits in the lower portion of the band so it enriches the foreground
-without muting the crisp horizon seam.
+Earliest progress ratio allowed for vertical pulse travel.
 
-### FLAPPY_GROUND_GRID_FOG_ALPHA
+Vertical pulses start a little away from the horizon so they are visible as
+distinct squares instead of immediately disappearing into compressed depth.
 
-Peak opacity used by the lower-band neon fog wash.
+## browser-entry/playback/background/ground-grid/playback.background.ground-grid.services.ts
 
-The fog should tint the band, not obscure the line geometry, so the opacity
-is intentionally modest.
+### drawGroundGridFog
 
-### FLAPPY_BACKGROUND_GROUND_GRID_STYLE
+```ts
+drawGroundGridFog(
+  context: CanvasRenderingContext2D,
+  resolvedScene: PlaybackBackgroundGroundGridResolvedScene,
+): void
+```
 
-Frozen neon style bundle reused by the playback ground-grid renderer.
+Draws the lower-band atmospheric wash behind the neon line work.
 
-The values stay theme-owned but are materialized once so the renderer does
-not allocate a new style object during every frame.
+Parameters:
+- `context` - - Canvas 2D drawing context.
+- `resolvedScene` - - Geometry and style for the current viewport.
 
-## browser-entry/playback/background/ground-grid/playback.background.ground-grid.services.ts
+Returns: Nothing.
 
-### drawPlaybackGroundGrid
+### drawGroundGridPulse
 
 ```ts
-drawPlaybackGroundGrid(
+drawGroundGridPulse(
   context: CanvasRenderingContext2D,
-  resolvedScene: PlaybackBackgroundGroundGridResolvedScene,
-  geometry: PlaybackGroundGridGeometry,
+  pulse: PlaybackGroundGridPulse | null,
+  fillColor: string,
 ): void
 ```
 
-Draws the resolved neon ground grid inside the lower background band.
+Draws one pulse square above the grid lines and below gameplay entities.
 
 Parameters:
 - `context` - - Canvas 2D drawing context.
-- `resolvedScene` - - Geometry and style for the current viewport.
-- `geometry` - - Precomputed horizontal and vertical line segments.
+- `pulse` - - Visible pulse square for the current frame.
+- `fillColor` - - Core neon fill color.
 
 Returns: Nothing.
 
@@ -489,39 +506,22 @@ Parameters:
 
 Returns: Nothing.
 
-### drawGroundGridFog
+### drawPlaybackGroundGrid
 
 ```ts
-drawGroundGridFog(
+drawPlaybackGroundGrid(
   context: CanvasRenderingContext2D,
   resolvedScene: PlaybackBackgroundGroundGridResolvedScene,
+  geometry: PlaybackGroundGridGeometry,
 ): void
 ```
 
-Draws the lower-band atmospheric wash behind the neon line work.
+Draws the resolved neon ground grid inside the lower background band.
 
 Parameters:
 - `context` - - Canvas 2D drawing context.
 - `resolvedScene` - - Geometry and style for the current viewport.
-
-Returns: Nothing.
-
-### drawGroundGridPulse
-
-```ts
-drawGroundGridPulse(
-  context: CanvasRenderingContext2D,
-  pulse: PlaybackGroundGridPulse | null,
-  fillColor: string,
-): void
-```
-
-Draws one pulse square above the grid lines and below gameplay entities.
-
-Parameters:
-- `context` - - Canvas 2D drawing context.
-- `pulse` - - Visible pulse square for the current frame.
-- `fillColor` - - Core neon fill color.
+- `geometry` - - Precomputed horizontal and vertical line segments.
 
 Returns: Nothing.
 
@@ -598,54 +598,28 @@ page resize invalidates every cached geometry variant and fog gradient.
 Parameters:
 - `sceneContext` - - Current lower-band scene geometry.
 
-Returns: Stable viewport-size cache key for the current frame.
-
-### resolveGroundGridViewportCacheKey
-
-```ts
-resolveGroundGridViewportCacheKey(
-  sceneContext: PlaybackBackgroundGroundGridSceneContext,
-): string
-```
-
-Resolves the viewport-size cache key used by the ground-grid caches.
-
-Parameters:
-- `sceneContext` - - Current lower-band scene geometry.
-
-Returns: Cache key that changes whenever the page size changes.
-
-### resolveGroundGridSceneCacheKey
-
-```ts
-resolveGroundGridSceneCacheKey(
-  sceneContext: PlaybackBackgroundGroundGridSceneContext,
-): string
-```
-
-Resolves the stable local-scene cache key for ground-grid geometry.
-
-Parameters:
-- `sceneContext` - - Current lower-band scene geometry.
-
-Returns: Scene key suitable for static horizontal and vertical cache entries.
+Returns: Stable viewport-size cache key for the current frame.
 
-### resolveGroundGridVerticalCycleCacheKey
+### resolveCachedGroundGridFogGradient
 
 ```ts
-resolveGroundGridVerticalCycleCacheKey(
+resolveCachedGroundGridFogGradient(
+  context: CanvasRenderingContext2D,
   sceneCacheKey: string,
-  wrappedOffsetPx: number,
-): string
+  sceneContext: PlaybackBackgroundGroundGridSceneContext,
+  fogColor: string,
+): CanvasGradient
 ```
 
-Resolves the cache key for one wrapped vertical-geometry cycle.
+Resolves a cached fog gradient for one canvas and local scene.
 
 Parameters:
+- `context` - - Canvas 2D drawing context.
 - `sceneCacheKey` - - Stable scene key for the active viewport.
-- `wrappedOffsetPx` - - Wrapped offset within one lane cycle.
+- `sceneContext` - - Current lower-band scene geometry.
+- `fogColor` - - Theme-owned fog color token.
 
-Returns: Cycle key used for vertical geometry reuse.
+Returns: Cached fog gradient aligned to the lower-band scene.
 
 ### resolveCachedGroundGridHorizontalGeometry
 
@@ -664,6 +638,23 @@ Parameters:
 
 Returns: Cached horizontal geometry bundle for the scene.
 
+### resolveCachedGroundGridVerticalGeometry
+
+```ts
+resolveCachedGroundGridVerticalGeometry(
+  cycleCacheKey: string,
+  factory: PlaybackGroundGridVerticalGeometryFactory,
+): PlaybackGroundGridVerticalGeometry
+```
+
+Resolves cached vertical geometry for one scene and wrapped offset cycle.
+
+Parameters:
+- `cycleCacheKey` - - Scene-and-offset cache key for the active frame.
+- `factory` - - Lazy geometry builder used when the cache misses.
+
+Returns: Cached vertical geometry bundle for the cycle.
+
 ### resolveCachedGroundGridVerticalSceneMetrics
 
 ```ts
@@ -681,79 +672,88 @@ Parameters:
 
 Returns: Cached vertical scene metrics for the scene.
 
-### resolveCachedGroundGridVerticalGeometry
+### resolveGroundGridSceneCacheKey
 
 ```ts
-resolveCachedGroundGridVerticalGeometry(
-  cycleCacheKey: string,
-  factory: PlaybackGroundGridVerticalGeometryFactory,
-): PlaybackGroundGridVerticalGeometry
+resolveGroundGridSceneCacheKey(
+  sceneContext: PlaybackBackgroundGroundGridSceneContext,
+): string
 ```
 
-Resolves cached vertical geometry for one scene and wrapped offset cycle.
+Resolves the stable local-scene cache key for ground-grid geometry.
 
 Parameters:
-- `cycleCacheKey` - - Scene-and-offset cache key for the active frame.
-- `factory` - - Lazy geometry builder used when the cache misses.
+- `sceneContext` - - Current lower-band scene geometry.
 
-Returns: Cached vertical geometry bundle for the cycle.
+Returns: Scene key suitable for static horizontal and vertical cache entries.
 
-### resolveCachedGroundGridFogGradient
+### resolveGroundGridVerticalCycleCacheKey
 
 ```ts
-resolveCachedGroundGridFogGradient(
-  context: CanvasRenderingContext2D,
+resolveGroundGridVerticalCycleCacheKey(
   sceneCacheKey: string,
-  sceneContext: PlaybackBackgroundGroundGridSceneContext,
-  fogColor: string,
-): CanvasGradient
+  wrappedOffsetPx: number,
+): string
 ```
 
-Resolves a cached fog gradient for one canvas and local scene.
+Resolves the cache key for one wrapped vertical-geometry cycle.
 
 Parameters:
-- `context` - - Canvas 2D drawing context.
 - `sceneCacheKey` - - Stable scene key for the active viewport.
+- `wrappedOffsetPx` - - Wrapped offset within one lane cycle.
+
+Returns: Cycle key used for vertical geometry reuse.
+
+### resolveGroundGridViewportCacheKey
+
+```ts
+resolveGroundGridViewportCacheKey(
+  sceneContext: PlaybackBackgroundGroundGridSceneContext,
+): string
+```
+
+Resolves the viewport-size cache key used by the ground-grid caches.
+
+Parameters:
 - `sceneContext` - - Current lower-band scene geometry.
-- `fogColor` - - Theme-owned fog color token.
 
-Returns: Cached fog gradient aligned to the lower-band scene.
+Returns: Cache key that changes whenever the page size changes.
 
 ## browser-entry/playback/background/ground-grid/playback.background.ground-grid.batch.services.ts
 
-### drawGroundGridSegmentBatches
+### drawGroundGridSegmentBatch
 
 ```ts
-drawGroundGridSegmentBatches(
+drawGroundGridSegmentBatch(
   context: CanvasRenderingContext2D,
-  batches: readonly PlaybackGroundGridSegmentBatch[],
-  lineColor: string,
+  batch: PlaybackGroundGridSegmentBatch,
 ): void
 ```
 
-Draws one ordered collection of neon segment batches.
+Draws one batch of neon line segments that share one render style.
 
 Parameters:
 - `context` - - Canvas 2D drawing context.
-- `batches` - - Ordered line-segment batches to render.
-- `lineColor` - - Core neon stroke color.
+- `batch` - - Ordered line-segment batch that shares one render style.
 
 Returns: Nothing.
 
-### drawGroundGridSegmentBatch
+### drawGroundGridSegmentBatches
 
 ```ts
-drawGroundGridSegmentBatch(
+drawGroundGridSegmentBatches(
   context: CanvasRenderingContext2D,
-  batch: PlaybackGroundGridSegmentBatch,
+  batches: readonly PlaybackGroundGridSegmentBatch[],
+  lineColor: string,
 ): void
 ```
 
-Draws one batch of neon line segments that share one render style.
+Draws one ordered collection of neon segment batches.
 
 Parameters:
 - `context` - - Canvas 2D drawing context.
-- `batch` - - Ordered line-segment batch that shares one render style.
+- `batches` - - Ordered line-segment batches to render.
+- `lineColor` - - Core neon stroke color.
 
 Returns: Nothing.
 
@@ -812,35 +812,35 @@ Parameters:
 
 Returns: Ordered style batches that can be stroked with fewer state changes.
 
-### resolvePlaybackGroundGridPreferredHorizontalPulsePaths
+### resolvePlaybackGroundGridBatchPath
 
 ```ts
-resolvePlaybackGroundGridPreferredHorizontalPulsePaths(
-  horizontalLines: readonly PlaybackGroundGridLineSegment[],
-): readonly PlaybackGroundGridPulsePath[]
+resolvePlaybackGroundGridBatchPath(
+  segments: readonly PlaybackGroundGridLineSegment[],
+): Path2D | null
 ```
 
-Prefers the nearer, thicker horizontal tracks when picking a pulse lane.
+Resolves one cached draw-ready path for a grouped segment batch.
 
 Parameters:
-- `horizontalLines` - - Visible horizontal grid bands.
+- `segments` - - Ordered line segments that belong to one style batch.
 
-Returns: Pulse-eligible horizontal paths biased toward the foreground.
+Returns: Cached Path2D when available, otherwise null.
 
-### resolvePlaybackGroundGridBatchPath
+### resolvePlaybackGroundGridPreferredHorizontalPulsePaths
 
 ```ts
-resolvePlaybackGroundGridBatchPath(
-  segments: readonly PlaybackGroundGridLineSegment[],
-): Path2D | null
+resolvePlaybackGroundGridPreferredHorizontalPulsePaths(
+  horizontalLines: readonly PlaybackGroundGridLineSegment[],
+): readonly PlaybackGroundGridPulsePath[]
 ```
 
-Resolves one cached draw-ready path for a grouped segment batch.
+Prefers the nearer, thicker horizontal tracks when picking a pulse lane.
 
 Parameters:
-- `segments` - - Ordered line segments that belong to one style batch.
+- `horizontalLines` - - Visible horizontal grid bands.
 
-Returns: Cached Path2D when available, otherwise null.
+Returns: Pulse-eligible horizontal paths biased toward the foreground.
 
 ## browser-entry/playback/background/ground-grid/playback.background.ground-grid.geometry.layout.utils.ts
 
@@ -859,40 +859,6 @@ Parameters:
 
 Returns: Stable anchor bounds and lane spacing for vertical-ray reuse.
 
-### resolvePlaybackGroundGridVerticalCycleContext
-
-```ts
-resolvePlaybackGroundGridVerticalCycleContext(
-  safeLaneSpacingPx: number,
-  lowerBandBottomYPx: number,
-  scrollBasePx: number,
-): PlaybackGroundGridVerticalCycleContext
-```
-
-Resolves the wrapped vertical-geometry cycle for the current scroll value.
-
-Parameters:
-- `safeLaneSpacingPx` - - Stable lane spacing used by current viewport metrics.
-- `lowerBandBottomYPx` - - Lower edge of the visible ground-grid band.
-- `scrollBasePx` - - Shared world scroll used for parallax motion.
-
-Returns: Quantized wrapped offset and safe lane spacing for cache lookups.
-
-### resolvePlaybackGroundGridAnchorBounds
-
-```ts
-resolvePlaybackGroundGridAnchorBounds(
-  input: PlaybackGroundGridAnchorBoundsInput,
-): PlaybackGroundGridAnchorBounds
-```
-
-Projects one visible horizontal span back onto the floor anchor line.
-
-Parameters:
-- `input` - - Visible span bounds and scene geometry.
-
-Returns: Bottom-anchor bounds required to cover the chosen projected span.
-
 ### isPlaybackGroundGridVerticalPulsePathVisible
 
 ```ts
@@ -925,6 +891,21 @@ Parameters:
 
 Returns: Bottom anchor x-position whose ray reaches the projected point.
 
+### resolvePlaybackGroundGridAnchorBounds
+
+```ts
+resolvePlaybackGroundGridAnchorBounds(
+  input: PlaybackGroundGridAnchorBoundsInput,
+): PlaybackGroundGridAnchorBounds
+```
+
+Projects one visible horizontal span back onto the floor anchor line.
+
+Parameters:
+- `input` - - Visible span bounds and scene geometry.
+
+Returns: Bottom-anchor bounds required to cover the chosen projected span.
+
 ### resolvePlaybackGroundGridRetainedWidthRatioAtYPx
 
 ```ts
@@ -948,7 +929,79 @@ Parameters:
 
 Returns: Width-retention ratio in the inclusive `[0, 1]` range.
 
-## browser-entry/playback/background/ground-grid/playback.background.ground-grid.geometry.utils.ts
+### resolvePlaybackGroundGridVerticalCycleContext
+
+```ts
+resolvePlaybackGroundGridVerticalCycleContext(
+  safeLaneSpacingPx: number,
+  lowerBandBottomYPx: number,
+  scrollBasePx: number,
+): PlaybackGroundGridVerticalCycleContext
+```
+
+Resolves the wrapped vertical-geometry cycle for the current scroll value.
+
+Parameters:
+- `safeLaneSpacingPx` - - Stable lane spacing used by current viewport metrics.
+- `lowerBandBottomYPx` - - Lower edge of the visible ground-grid band.
+- `scrollBasePx` - - Shared world scroll used for parallax motion.
+
+Returns: Quantized wrapped offset and safe lane spacing for cache lookups.
+
+## browser-entry/playback/background/ground-grid/playback.background.ground-grid.geometry.utils.ts
+
+### appendPlaybackGroundGridVerticalLineSegments
+
+```ts
+appendPlaybackGroundGridVerticalLineSegments(
+  targetSegments: PlaybackGroundGridLineSegment[],
+  startIndex: number,
+  input: PlaybackGroundGridVerticalRayInput,
+): number
+```
+
+Appends tapered style segments for one perspective ray.
+
+Parameters:
+- `targetSegments` - - Target line-segment buffer.
+- `startIndex` - - Current insertion index within the target buffer.
+- `input` - - Geometry and depth context for one ray.
+
+Returns: Next insertion index after all ray segments have been written.
+
+### buildPlaybackGroundGridHorizontalGeometry
+
+```ts
+buildPlaybackGroundGridHorizontalGeometry(
+  sceneContext: PlaybackBackgroundGroundGridSceneContext,
+): PlaybackGroundGridHorizontalGeometry
+```
+
+Builds the screen-horizontal depth bands for the lower neon plane.
+
+Parameters:
+- `sceneContext` - - Lower-band geometry for the current viewport.
+
+Returns: Ordered far-to-near line segments and pulse subsets.
+
+### buildPlaybackGroundGridVerticalGeometry
+
+```ts
+buildPlaybackGroundGridVerticalGeometry(
+  sceneContext: PlaybackBackgroundGroundGridSceneContext,
+  verticalSceneMetrics: PlaybackGroundGridVerticalSceneMetrics,
+  wrappedOffsetPx: number,
+): PlaybackGroundGridVerticalGeometry
+```
+
+Builds the perspective rays that converge to the centered horizon point.
+
+Parameters:
+- `sceneContext` - - Lower-band geometry for the current viewport.
+- `safeLaneSpacingPx` - - Stable lane spacing used for ray anchors.
+- `wrappedOffsetPx` - - Wrapped offset used for cache reuse and ray placement.
+
+Returns: Wrapped left-to-right perspective rays and pulse subsets.
 
 ### resolvePlaybackGroundGridHorizontalGeometry
 
@@ -982,75 +1035,70 @@ Parameters:
 
 Returns: Wrapped left-to-right perspective rays and pulse subsets.
 
-### buildPlaybackGroundGridHorizontalGeometry
+## browser-entry/playback/background/ground-grid/playback.background.ground-grid.math.utils.ts
+
+### interpolatePlaybackGroundGridPoint
 
 ```ts
-buildPlaybackGroundGridHorizontalGeometry(
-  sceneContext: PlaybackBackgroundGroundGridSceneContext,
-): PlaybackGroundGridHorizontalGeometry
+interpolatePlaybackGroundGridPoint(
+  startXPx: number,
+  startYPx: number,
+  endXPx: number,
+  endYPx: number,
+  interpolationRatio: number,
+): PlaybackGroundGridPoint
 ```
 
-Builds the screen-horizontal depth bands for the lower neon plane.
+Interpolates one point along a perspective ray.
 
 Parameters:
-- `sceneContext` - - Lower-band geometry for the current viewport.
-
-Returns: Ordered far-to-near line segments and pulse subsets.
+- `startXPx` - - Bottom anchor x-position.
+- `startYPx` - - Bottom anchor y-position.
+- `endXPx` - - Vanishing-point x-position.
+- `endYPx` - - Vanishing-point y-position.
+- `interpolationRatio` - - Normalized 0..1 position along the ray.
 
-### buildPlaybackGroundGridVerticalGeometry
+Returns: Interpolated point on the perspective ray.
 
-```ts
-buildPlaybackGroundGridVerticalGeometry(
-  sceneContext: PlaybackBackgroundGroundGridSceneContext,
-  verticalSceneMetrics: PlaybackGroundGridVerticalSceneMetrics,
-  wrappedOffsetPx: number,
-): PlaybackGroundGridVerticalGeometry
-```
+### PlaybackGroundGridPipeConnectionProfile
 
-Builds the perspective rays that converge to the centered horizon point.
+Shared pipe-floor projection resolved from the lower ground-grid geometry.
 
-Parameters:
-- `sceneContext` - - Lower-band geometry for the current viewport.
-- `safeLaneSpacingPx` - - Stable lane spacing used for ray anchors.
-- `wrappedOffsetPx` - - Wrapped offset used for cache reuse and ray placement.
+### PlaybackGroundGridPoint
 
-Returns: Wrapped left-to-right perspective rays and pulse subsets.
+Small point value used when interpolating positions along one grid ray.
 
-### appendPlaybackGroundGridVerticalLineSegments
+### resolvePlaybackGroundGridDepthCurve
 
 ```ts
-appendPlaybackGroundGridVerticalLineSegments(
-  targetSegments: PlaybackGroundGridLineSegment[],
-  startIndex: number,
-  input: PlaybackGroundGridVerticalRayInput,
+resolvePlaybackGroundGridDepthCurve(
+  depthRatio: number,
 ): number
 ```
 
-Appends tapered style segments for one perspective ray.
+Maps a normalized depth ratio into a stronger synthwave spacing curve.
 
 Parameters:
-- `targetSegments` - - Target line-segment buffer.
-- `startIndex` - - Current insertion index within the target buffer.
-- `input` - - Geometry and depth context for one ray.
-
-Returns: Next insertion index after all ray segments have been written.
+- `depthRatio` - - Normalized 0..1 depth where 0 is far and 1 is near.
 
-## browser-entry/playback/background/ground-grid/playback.background.ground-grid.math.utils.ts
+Returns: Curved depth ratio used for line placement and styling.
 
-### resolvePlaybackGroundGridDepthCurve
+### resolvePlaybackGroundGridDepthFromHorizonDistance
 
 ```ts
-resolvePlaybackGroundGridDepthCurve(
-  depthRatio: number,
+resolvePlaybackGroundGridDepthFromHorizonDistance(
+  distanceToHorizonPx: number,
+  maximumDistanceToHorizonPx: number,
 ): number
 ```
 
-Maps a normalized depth ratio into a stronger synthwave spacing curve.
+Resolves normalized depth from a vertical distance away from the horizon.
 
 Parameters:
-- `depthRatio` - - Normalized 0..1 depth where 0 is far and 1 is near.
+- `distanceToHorizonPx` - - Vertical distance from the vanishing horizon.
+- `maximumDistanceToHorizonPx` - - Largest visible vertical horizon distance.
 
-Returns: Curved depth ratio used for line placement and styling.
+Returns: Normalized 0..1 depth where 0 is at the horizon and 1 is nearest.
 
 ### resolvePlaybackGroundGridLineAlpha
 
@@ -1097,23 +1145,6 @@ Parameters:
 
 Returns: Stroke width in pixels.
 
-### resolvePlaybackGroundGridDepthFromHorizonDistance
-
-```ts
-resolvePlaybackGroundGridDepthFromHorizonDistance(
-  distanceToHorizonPx: number,
-  maximumDistanceToHorizonPx: number,
-): number
-```
-
-Resolves normalized depth from a vertical distance away from the horizon.
-
-Parameters:
-- `distanceToHorizonPx` - - Vertical distance from the vanishing horizon.
-- `maximumDistanceToHorizonPx` - - Largest visible vertical horizon distance.
-
-Returns: Normalized 0..1 depth where 0 is at the horizon and 1 is nearest.
-
 ### resolvePlaybackGroundGridPipeConnectionProfile
 
 ```ts
@@ -1134,38 +1165,39 @@ Parameters:
 
 Returns: Pipe-floor y-position plus the matching vertical-ray scroll ratio.
 
-### interpolatePlaybackGroundGridPoint
+## browser-entry/playback/background/ground-grid/playback.background.ground-grid.pulse.selection.utils.ts
+
+### rememberPlaybackGroundGridVerticalPulseSelection
 
 ```ts
-interpolatePlaybackGroundGridPoint(
-  startXPx: number,
-  startYPx: number,
-  endXPx: number,
-  endYPx: number,
-  interpolationRatio: number,
-): PlaybackGroundGridPoint
+rememberPlaybackGroundGridVerticalPulseSelection(
+  pulseSlotIndex: number,
+  continuationState: PlaybackGroundGridVerticalPulseContinuationState,
+): void
 ```
 
-Interpolates one point along a perspective ray.
+Stores the resolved pulse center for continuation on the next frame.
 
 Parameters:
-- `startXPx` - - Bottom anchor x-position.
-- `startYPx` - - Bottom anchor y-position.
-- `endXPx` - - Vanishing-point x-position.
-- `endYPx` - - Vanishing-point y-position.
-- `interpolationRatio` - - Normalized 0..1 position along the ray.
+- `pulseSlotIndex` - - Zero-based pulse slot index.
+- `continuationState` - - Latest visible pulse position for the slot.
 
-Returns: Interpolated point on the perspective ray.
+Returns: Nothing.
 
-### PlaybackGroundGridPoint
+### resolveContinuedVerticalPulsePath
 
-Small point value used when interpolating positions along one grid ray.
+```ts
+resolveContinuedVerticalPulsePath(
+  input: { candidatePulsePaths: readonly PlaybackGroundGridPulsePath[]; pulseSlotIndex: number; frameIndex: number; travelProgressRatio: number; },
+): PlaybackGroundGridPulsePath | null
+```
 
-### PlaybackGroundGridPipeConnectionProfile
+Resolves the nearest continued vertical pulse path for an active slot.
 
-Shared pipe-floor projection resolved from the lower ground-grid geometry.
+Parameters:
+- `input` - - Continuation input for the current frame.
 
-## browser-entry/playback/background/ground-grid/playback.background.ground-grid.pulse.selection.utils.ts
+Returns: Continued pulse path when one can be matched, otherwise null.
 
 ### resolvePlaybackGroundGridVerticalPulseSelection
 
@@ -1192,37 +1224,22 @@ Parameters:
 
 Returns: Vertical pulse path, or null when none are available.
 
-### rememberPlaybackGroundGridVerticalPulseSelection
-
-```ts
-rememberPlaybackGroundGridVerticalPulseSelection(
-  pulseSlotIndex: number,
-  continuationState: PlaybackGroundGridVerticalPulseContinuationState,
-): void
-```
-
-Stores the resolved pulse center for continuation on the next frame.
-
-Parameters:
-- `pulseSlotIndex` - - Zero-based pulse slot index.
-- `continuationState` - - Latest visible pulse position for the slot.
-
-Returns: Nothing.
-
-### resolveContinuedVerticalPulsePath
+### resolveStableVerticalPulsePathCandidates
 
 ```ts
-resolveContinuedVerticalPulsePath(
-  input: { candidatePulsePaths: readonly PlaybackGroundGridPulsePath[]; pulseSlotIndex: number; frameIndex: number; travelProgressRatio: number; },
-): PlaybackGroundGridPulsePath | null
+resolveStableVerticalPulsePathCandidates(
+  verticalPulsePaths: readonly PlaybackGroundGridPulsePath[],
+  visibleVerticalPulsePaths: readonly PlaybackGroundGridPulsePath[],
+): readonly PlaybackGroundGridPulsePath[]
 ```
 
-Resolves the nearest continued vertical pulse path for an active slot.
+Resolves a stable vertical pulse-candidate set for one frame.
 
 Parameters:
-- `input` - - Continuation input for the current frame.
+- `verticalPulsePaths` - - Full vertical ray paths for the current frame.
+- `visibleVerticalPulsePaths` - - Midpoint-visible subset used as fallback.
 
-Returns: Continued pulse path when one can be matched, otherwise null.
+Returns: Stable candidate set for deterministic vertical pulse selection.
 
 ### trimCachedVerticalPulseContinuationState
 
@@ -1239,39 +1256,24 @@ Parameters:
 
 Returns: Nothing.
 
-### resolveStableVerticalPulsePathCandidates
-
-```ts
-resolveStableVerticalPulsePathCandidates(
-  verticalPulsePaths: readonly PlaybackGroundGridPulsePath[],
-  visibleVerticalPulsePaths: readonly PlaybackGroundGridPulsePath[],
-): readonly PlaybackGroundGridPulsePath[]
-```
-
-Resolves a stable vertical pulse-candidate set for one frame.
-
-Parameters:
-- `verticalPulsePaths` - - Full vertical ray paths for the current frame.
-- `visibleVerticalPulsePaths` - - Midpoint-visible subset used as fallback.
-
-Returns: Stable candidate set for deterministic vertical pulse selection.
-
 ## browser-entry/playback/background/ground-grid/playback.background.ground-grid.pulse.timing.utils.ts
 
-### resolvePlaybackGroundGridPulseTiming
+### resolvePlaybackGroundGridHorizontalPulsePath
 
 ```ts
-resolvePlaybackGroundGridPulseTiming(
-  frameIndex: number,
-): PlaybackGroundGridPulseTimingState | null
+resolvePlaybackGroundGridHorizontalPulsePath(
+  horizontalPulsePaths: readonly PlaybackGroundGridPulsePath[],
+  pulseSlotIndex: number,
+): PlaybackGroundGridPulsePath | null
 ```
 
-Resolves timing state for the currently active deterministic pulse slot.
+Selects one thick-enough horizontal band for the current pulse slot.
 
 Parameters:
-- `frameIndex` - - Current deterministic playback frame index.
+- `horizontalPulsePaths` - - Cached horizontal pulse paths eligible for travel.
+- `pulseSlotIndex` - - Zero-based pulse slot index.
 
-Returns: Pulse timing state, or null when no pulse is active in this frame.
+Returns: Horizontal pulse path, or null when none are suitable.
 
 ### resolvePlaybackGroundGridPulseOrientation
 
@@ -1288,22 +1290,20 @@ Parameters:
 
 Returns: Horizontal or vertical pulse travel orientation.
 
-### resolvePlaybackGroundGridHorizontalPulsePath
+### resolvePlaybackGroundGridPulseTiming
 
 ```ts
-resolvePlaybackGroundGridHorizontalPulsePath(
-  horizontalPulsePaths: readonly PlaybackGroundGridPulsePath[],
-  pulseSlotIndex: number,
-): PlaybackGroundGridPulsePath | null
+resolvePlaybackGroundGridPulseTiming(
+  frameIndex: number,
+): PlaybackGroundGridPulseTimingState | null
 ```
 
-Selects one thick-enough horizontal band for the current pulse slot.
+Resolves timing state for the currently active deterministic pulse slot.
 
 Parameters:
-- `horizontalPulsePaths` - - Cached horizontal pulse paths eligible for travel.
-- `pulseSlotIndex` - - Zero-based pulse slot index.
+- `frameIndex` - - Current deterministic playback frame index.
 
-Returns: Horizontal pulse path, or null when none are suitable.
+Returns: Pulse timing state, or null when no pulse is active in this frame.
 
 ### resolvePlaybackGroundGridPulseTravelRatio
 
@@ -1426,6 +1426,25 @@ Parameters:
 
 Returns: Normalized 0..1 depth where 0 is at the horizon and 1 is nearest.
 
+### resolvePlaybackGroundGridGeometry
+
+```ts
+resolvePlaybackGroundGridGeometry(
+  sceneContext: PlaybackBackgroundGroundGridSceneContext,
+  frameIndex: number,
+  scrollBasePx: number,
+): PlaybackGroundGridGeometry
+```
+
+Builds the line geometry for the neon ground grid.
+
+Parameters:
+- `sceneContext` - - Lower-band geometry for the current viewport.
+- `frameIndex` - - Current deterministic playback frame index.
+- `scrollBasePx` - - Shared world scroll used for parallax motion.
+
+Returns: Horizontal depth bands and perspective rays for the current frame.
+
 ### resolvePlaybackGroundGridLineAlpha
 
 ```ts
@@ -1471,25 +1490,6 @@ Parameters:
 
 Returns: Stroke width in pixels.
 
-### resolvePlaybackGroundGridGeometry
-
-```ts
-resolvePlaybackGroundGridGeometry(
-  sceneContext: PlaybackBackgroundGroundGridSceneContext,
-  frameIndex: number,
-  scrollBasePx: number,
-): PlaybackGroundGridGeometry
-```
-
-Builds the line geometry for the neon ground grid.
-
-Parameters:
-- `sceneContext` - - Lower-band geometry for the current viewport.
-- `frameIndex` - - Current deterministic playback frame index.
-- `scrollBasePx` - - Shared world scroll used for parallax motion.
-
-Returns: Horizontal depth bands and perspective rays for the current frame.
-
 ### resolvePlaybackGroundGridSceneContext
 
 ```ts