Remove the remaining moon-surface landmark band from premium-art levels

The level-3 screenshot confirmed that the last broad green crater/tint strip was still coming from the generated moon-surface layer rather than the premium background itself. This removes the feature outright across the few levels that still opted into it and trims the parallax lifecycle to match the smaller visual stack.

Constraint: Preserve the rest of the premium-background presentation stack while removing the crater/tint band source completely
Rejected: Keep moonSurface config and gate it off per level | leaves dead visual infrastructure in the runtime without a planned return path
Rejected: Add another alpha/tint tweak on top of moonSurface | treats the symptom while preserving the unwanted layer
Confidence: high
Scope-risk: moderate
Reversibility: clean
Directive: If further visual cleanup is needed, evaluate the remaining ambient layers individually instead of rebuilding a generalized landmark overlay path
Tested: bunx tsc --noEmit; bun run lint; bun test; bun run build; bun run levels:validate; bun run knip; bun run bundle:check
Not-tested: Manual in-game screenshot capture after this exact release build

Author: vriesdcrv

CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.1.20] - 2026-04-28
+
+### Changed
+- Removed the remaining generated moon-surface landmark layer so premium-art levels no longer render the green crater/tint band over gameplay space.
+- Deleted the moon-surface config surface, generator, lifecycle wiring, and update/layout paths instead of leaving the layer dormant behind flags.
+- Simplified the shared parallax lifecycle by removing moon-surface creation/destruction from the level-visual orchestration context.
+
+### Quality
+- Updated parallax lifecycle regression coverage to reflect the smaller background stack after moon-surface removal.
+- Verified with `bunx tsc --noEmit`, `bun run lint`, `bun test`, `bun run build`, `bun run levels:validate`, `bun run knip`, and `bun run bundle:check`.
+
 ## [1.1.19] - 2026-04-28
 
 ### Changed

docs/releases/1.1.20.md

@@ -0,0 +1,38 @@
+# Release 1.1.20 — remove the moon-surface crater/tint band layer
+
+## Highlights
+
+- Removes the remaining moon-surface landmark layer that was still drawing a broad green crater/tint band over premium-art levels.
+- Deletes the moon-surface system outright instead of leaving it behind as dormant config and lifecycle wiring.
+- Keeps the rest of the premium-background stack intact while simplifying the parallax lifecycle.
+
+## What changed
+
+- Moon-surface feature removal:
+  - `src/config/levels/types.ts`
+  - `src/config/levels/definitions/ionStormSector.ts`
+  - `src/config/levels/definitions/nebulaPass.ts`
+  - `src/config/levels/definitions/wreckfieldRun.ts`
+  - `src/systems/parallax/backgroundMotion.ts`
+  - `src/systems/parallax/levelVisualLayerLifecycle.ts`
+  - `src/systems/parallax/levelVisualLayerLifecycleContext.ts`
+  - `src/systems/ParallaxBackground.ts`
+  - Deleted `src/systems/parallax/moonSurfaceGenerator.ts`
+  - Deleted `src/systems/parallax/moonSurfaceLayerLifecycle.ts`
+
+- Regression coverage updates:
+  - `tests/ParallaxBackground.test.ts`
+  - `tests/levelVisualLayerLifecycle.test.ts`
+  - `tests/levelVisualLayerLifecycleContext.test.ts`
+  - Deleted `tests/moonSurfaceGenerator.test.ts`
+  - Deleted `tests/moonSurfaceLayerLifecycle.test.ts`
+
+## Validation
+
+- `bunx tsc --noEmit`
+- `bun run lint`
+- `bun test`
+- `bun run build`
+- `bun run levels:validate`
+- `bun run knip`
+- `bun run bundle:check`

docs/releases/README.md

@@ -2,6 +2,8 @@
 
 Latest first.
 
+- [`1.1.20`](./1.1.20.md) — removes the moon-surface crater/tint band layer from premium-art levels and deletes the feature outright
+
 - [`1.1.19`](./1.1.19.md) — stops stacking the legacy starfield under premium backgrounds and makes the premium art fully opaque
 
 - [`1.1.18`](./1.1.18.md) — removes moon-surface prop overlays from the premium-background levels that still used them

package.json

@@ -1,6 +1,6 @@
 {
   "name": "space-explorer",
-  "version": "1.1.19",
+  "version": "1.1.20",
   "author": "Douwe de Vries",
   "license": "MIT",
   "private": true,

src/config/levels/definitions/ionStormSector.ts

@@ -198,11 +198,4 @@ export const ION_STORM_SECTOR_LEVEL: LevelConfig = {
       },
     },
   }),
-  moonSurface: {
-    scrollSpeed: 0.14,
-    surfaceColor: 0x20372d,
-    accentColor: 0x52f7a6,
-    craterCount: 5,
-    horizonGlow: 0.96,
-  },
 };

src/config/levels/definitions/nebulaPass.ts

@@ -204,13 +204,6 @@ export const NEBULA_PASS_LEVEL: LevelConfig = {
       },
     },
   }),
-  moonSurface: {
-    scrollSpeed: 0.08,
-    surfaceColor: 0x24163c,
-    accentColor: 0xc67bff,
-    craterCount: 6,
-    horizonGlow: 0.92,
-  },
   passingPlanets: [
     { scrollSpeed: 0.015, planetPalette: [0x7445b0, 0xc593ff], size: 200, yPosition: 0.18, alpha: 0.2, ringChance: 0.5 },
     { scrollSpeed: 0.025, planetPalette: [0x3d8f99, 0x87fff0], size: 100, yPosition: 0.72, alpha: 0.15, ringChance: 0.3 },

src/config/levels/definitions/wreckfieldRun.ts

@@ -213,11 +213,4 @@ export const WRECKFIELD_RUN_LEVEL: LevelConfig = {
       },
     },
   }),
-  moonSurface: {
-    scrollSpeed: 0.12,
-    surfaceColor: 0x2a3535,
-    accentColor: 0x53e2d5,
-    craterCount: 12,
-    horizonGlow: 0.8,
-  },
 };

src/config/levels/types.ts

@@ -134,18 +134,9 @@ export interface LevelConfig extends LevelThemeSummary {
   asteroidInterval: number;
   sections: LevelSectionConfig[];
   music: LevelMusicConfig;
-  moonSurface?: MoonSurfaceConfig;
   passingPlanets?: PassingPlanetConfig[];
 }
 
-export interface MoonSurfaceConfig {
-  scrollSpeed: number;
-  surfaceColor: number;
-  accentColor: number;
-  craterCount: number;
-  horizonGlow: number;
-}
-
 export interface PassingPlanetConfig {
   scrollSpeed: number;
   planetPalette: [number, number];

src/systems/ParallaxBackground.ts

@@ -5,7 +5,6 @@ import {
   scrollStarLayers,
   updateDebrisMoteMotion,
   updateForegroundSilhouetteMotion,
-  updateMoonSurfaceMotion,
   updatePassingPlanetMotion,
   updatePlanetLayerMotion,
   updateTwinkleMotion,
@@ -29,18 +28,12 @@ import {
   type PremiumBackgroundScrollSnapshot,
 } from './parallax/premiumBackgroundLayers';
 import { updateHazardOverlay as updateHazardOverlayRuntime } from './parallax/hazardOverlayRuntime';
-import {
-  createMoonSurfaceLayer as createMoonSurfaceLayerHelper,
-  destroyMoonSurfaceLayer as destroyMoonSurfaceLayerHelper,
-  layoutMoonSurfaceLayer as layoutMoonSurfaceLayerHelper,
-  type MoonSurfaceState,
-} from './parallax/moonSurfaceLayerLifecycle';
-import { type ForegroundSilhouetteState } from './parallax/foregroundSilhouetteLifecycle';
 import {
   getPassingPlanetOffscreenThreshold,
   resetPassingPlanetPosition,
   type PassingPlanetState,
 } from './parallax/passingPlanetLifecycle';
+import { type ForegroundSilhouetteState } from './parallax/foregroundSilhouetteLifecycle';
 import {
   createPlanetLayer as createPlanetLayerHelper,
   destroyPlanetLayer as destroyPlanetLayerHelper,
@@ -78,7 +71,6 @@ export class ParallaxBackground {
   private planetLayer: PlanetLayerState | null = null;
   private debrisMotes: DebrisMoteState[] = [];
   private twinkles: TwinkleState[] = [];
-  private moonSurface: MoonSurfaceState | null = null;
   private passingPlanetSprites: PassingPlanetState[] = [];
   private elapsed = 0;
   private currentWidth = 0;
@@ -187,10 +179,6 @@ export class ParallaxBackground {
     });
   }
 
-  private createMoonSurfaceLayer(scene: Phaser.Scene, config: LevelConfig): void {
-    this.moonSurface = createMoonSurfaceLayerHelper(scene, config, this.getViewportSize());
-  }
-
   private setPassingPlanetSprites(states: PassingPlanetState[]): void {
     this.passingPlanetSprites = states;
   }
@@ -210,10 +198,8 @@ export class ParallaxBackground {
       PASSING_PLANET_RESPAWN_MIN_X,
       PASSING_PLANET_RESPAWN_MAX_X,
       STARFIELD_TILE_DEPTHS,
-      this.createMoonSurfaceLayer.bind(this),
       this.createPlanetLayer.bind(this),
       this.createDebrisMotes.bind(this),
-      this.destroyMoonSurfaceLayer.bind(this),
       this.destroyPlanetLayer.bind(this),
       this.destroyDebrisMotes.bind(this),
       (states) => this.setPassingPlanetSprites(states),
@@ -360,7 +346,6 @@ export class ParallaxBackground {
     updatePlanetLayerMotion(this.planetLayer, this.elapsed, this.atmosphereAlpha, this.landmarkAlpha);
     updateDebrisMoteMotion(this.debrisMotes, this.elapsed, delta, this.atmosphereAlpha);
     updateTwinkleMotion(this.twinkles, this.elapsed, this.atmosphereTwinkle);
-    updateMoonSurfaceMotion(this.moonSurface, this.elapsed, this.atmosphereAlpha, this.landmarkAlpha);
     updatePassingPlanetMotion(
       this.passingPlanetSprites,
       delta,
@@ -404,7 +389,6 @@ export class ParallaxBackground {
   }
 
   private layoutLevelVisualLayers(): void {
-    this.layoutMoonSurfaceLayer();
     this.layoutPlanetLayer();
   }
 
@@ -423,10 +407,6 @@ export class ParallaxBackground {
     layoutPlanetLayerHelper(this.planetLayer, this.getViewportSize());
   }
 
-  private layoutMoonSurfaceLayer(): void {
-    layoutMoonSurfaceLayerHelper(this.moonSurface, this.getViewportSize());
-  }
-
   // ---------------------------------------------------------------------------
   // Cleanup
   // ---------------------------------------------------------------------------
@@ -438,9 +418,4 @@ export class ParallaxBackground {
   private destroyDebrisMotes(): void {
     this.debrisMotes = destroyDebrisMotesHelper(this.debrisMotes);
   }
-
-  private destroyMoonSurfaceLayer(): void {
-    this.moonSurface = destroyMoonSurfaceLayerHelper(this.scene, this.moonSurface);
-  }
-
 }

src/systems/parallax/backgroundMotion.ts

@@ -32,15 +32,6 @@ interface TwinkleMotionState {
   baseMaxAlpha: number;
 }
 
-interface MoonSurfaceMotionState {
-  sprite: Phaser.GameObjects.Image;
-  baseX: number;
-  baseY: number;
-  baseAlpha: number;
-  motionSpeed: number;
-  motionAmplitude: number;
-}
-
 interface PassingPlanetMotionState {
   sprite: Phaser.GameObjects.Image;
   scrollSpeed: number;
@@ -118,25 +109,6 @@ export function updateTwinkleMotion(
   }
 }
 
-export function updateMoonSurfaceMotion(
-  moonSurface: MoonSurfaceMotionState | null,
-  elapsed: number,
-  atmosphereAlpha: number,
-  landmarkAlpha: number
-): void {
-  if (!moonSurface) {
-    return;
-  }
-
-  const phase = elapsed * moonSurface.motionSpeed;
-  const scrollOffset = Math.sin(phase) * moonSurface.motionAmplitude;
-  moonSurface.sprite.x = moonSurface.baseX + scrollOffset;
-  moonSurface.sprite.y = moonSurface.baseY;
-  moonSurface.sprite.setAlpha(
-    Phaser.Math.Clamp(moonSurface.baseAlpha * (0.94 + (atmosphereAlpha - 1) * 0.5) * landmarkAlpha, 0.24, 0.62)
-  );
-}
-
 export function updatePassingPlanetMotion(
   planets: PassingPlanetMotionState[],
   delta: number,