@marble.fun/track-catalog 3.0.0

package/src/three/theme-catalog.ts

@@ -0,0 +1,1457 @@
+import {
+  createThemeMaterialSet,
+  MATERIAL_SLOT_DEBUG_THEME,
+  NEUTRAL_STUDIO_THEME,
+  type MaterialRecipe,
+  type MaterialPatternRecipe,
+  type ThemeMaterialSlot,
+  type ThemeId,
+  type TrackThemeDefinition,
+} from './track-theme'
+import { VAMPIRE_CASTLE_THEME } from './vampire-castle-appearance'
+import {
+  WILD_WEST_RAIL_MATERIAL_ID,
+  WILD_WEST_RAIL_TIE_MATERIAL_ID,
+  WILD_WEST_WOODEN_PLANKS_FLOOR_ID,
+} from './railroad-appearance'
+import { WILD_WEST_ANTIQUE_BRASS_MATERIAL_ID, WILD_WEST_GUNMETAL_FLIPPER_MATERIAL_ID } from './rugged-track-appearance'
+import { SHARED_STONE_TRACK_BLOCK_MATERIAL_ID } from './stone-track-shell-appearance'
+import {
+  WILD_WEST_CANYON_BUTTRESS_SUPPORT_ID,
+  WILD_WEST_TIMBER_TRESTLE_SUPPORT_ID,
+  WILD_WEST_TRESTLE_METAL_MATERIAL_ID,
+} from '../pages/play/race/track-appearance-support'
+import { WILD_WEST_SAND_FLOOR_ID, WILD_WEST_SAND_SHOULDER_MATERIAL_ID } from './wild-west-sand-appearance'
+import {
+  SHARED_ROPE_WALL_BACKING_MATERIAL,
+  SHARED_ROPE_WALL_BACKING_MATERIAL_ID,
+  SHARED_ROPE_WALL_END_GRAIN_MATERIAL,
+  SHARED_ROPE_WALL_END_GRAIN_MATERIAL_ID,
+  SHARED_ROPE_WALL_MATERIAL,
+  SHARED_ROPE_WALL_MATERIAL_ID,
+  SHARED_ROPE_WALL_TIMBER_MATERIAL,
+  SHARED_ROPE_WALL_TIMBER_MATERIAL_ID,
+} from './rope-wall-appearance'
+import {
+  JUNGLE_TEMPLE_BRONZE_MATERIAL_ID,
+  JUNGLE_TEMPLE_FACADE_MATERIAL_ID,
+  JUNGLE_TEMPLE_PLATFORM_MATERIAL_ID,
+  JUNGLE_TEMPLE_STONE_MATERIAL_ID,
+  JUNGLE_TEMPLE_TIMBER_MATERIAL_ID,
+} from './jungle-temple-appearance'
+import {
+  createPaintedValleyMaterials,
+  PAINTED_VALLEY_BIRCH_PLANK_MATERIAL,
+  PAINTED_VALLEY_BIRCH_RANCH_FENCE_MATERIAL,
+  PAINTED_VALLEY_GRASS_ORANGE_DIRT_PATH_FLOOR_ID,
+  PAINTED_VALLEY_GRASS_ORANGE_DIRT_PATH_MATERIAL,
+  PAINTED_VALLEY_GRASS_SHOULDER_MATERIAL,
+  PAINTED_VALLEY_GRASS_SHOULDER_MATERIAL_ID,
+  PAINTED_VALLEY_THEME_ID,
+  PAINTED_VALLEY_TROPICAL_FLOWER_HEDGE_CORE_MATERIAL,
+  PAINTED_VALLEY_TROPICAL_FLOWER_HEDGE_WALL_ID,
+} from './painted-valley-appearance'
+import {
+  JAPANESE_SAKURA_BRIDGE_FENCE_ID,
+  JAPANESE_SAKURA_BRIDGE_HARDWARE_ID,
+  JAPANESE_SAKURA_BRIDGE_HARDWARE_MATERIAL,
+  JAPANESE_SAKURA_BRIDGE_TIMBER_ID,
+  JAPANESE_SAKURA_BRIDGE_TIMBER_MATERIAL,
+  JAPANESE_SAKURA_DRAGON_STONE_MATERIAL,
+  JAPANESE_SAKURA_DRAGON_STONE_SUPPORT_ID,
+  JAPANESE_SAKURA_CASTLE_KAWARA_ID,
+  JAPANESE_SAKURA_CASTLE_KAWARA_MATERIAL,
+  JAPANESE_SAKURA_CASTLE_MASONRY_ID,
+  JAPANESE_SAKURA_CASTLE_MASONRY_MATERIAL,
+  JAPANESE_SAKURA_CASTLE_PAVERS_ID,
+  JAPANESE_SAKURA_CASTLE_PAVERS_MATERIAL,
+  JAPANESE_SAKURA_REDWOOD_PLANKS_ID,
+  JAPANESE_SAKURA_REDWOOD_PLANKS_MATERIAL,
+  JAPANESE_SAKURA_VERMILION_UNDERBRIDGE_SUPPORT_ID,
+  JAPANESE_SAKURA_PORTAL_FOUNDATION_STONE_ID,
+  JAPANESE_SAKURA_PORTAL_FOUNDATION_STONE_MATERIAL,
+  JAPANESE_SAKURA_CASTLE_PLASTER_MATERIAL,
+  JAPANESE_SAKURA_CASTLE_TIMBER_ID,
+  JAPANESE_SAKURA_CASTLE_TIMBER_MATERIAL,
+  JAPANESE_SAKURA_CASTLE_WALL_ID,
+} from './japanese-sakura-appearance'
+import {
+  SPACE_STATION_ARMORED_WALL_ID,
+  SPACE_STATION_CENTER_GUIDE_ID,
+  SPACE_STATION_CENTER_GUIDE_MATERIAL,
+  SPACE_STATION_FLOOR_DECK_BASE_ID,
+  SPACE_STATION_FLOOR_DECK_BASE_MATERIAL,
+  SPACE_STATION_FLOOR_DECK_ID,
+  SPACE_STATION_FLOOR_DECK_MATERIAL,
+  SPACE_STATION_HOVER_GRID_FLOOR_ID,
+  SPACE_STATION_HOVER_GRID_FLOOR_MATERIAL,
+  SPACE_STATION_WALL_CHASSIS_MATERIAL,
+  SPACE_STATION_WALL_LIGHT_ID,
+  SPACE_STATION_WALL_LIGHT_MATERIAL,
+  SPACE_STATION_WALL_PANEL_ID,
+  SPACE_STATION_WALL_PANEL_MATERIAL,
+  SPACE_STATION_WALL_RIB_ID,
+  SPACE_STATION_WALL_RIB_MATERIAL,
+  SPACE_STATION_WALL_TRIM_ID,
+  SPACE_STATION_WALL_TRIM_MATERIAL,
+} from './space-station-appearance'
+import { createSharedObstacleMetalMaterials } from './shared-obstacle-metal'
+
+const panorama = (id: ThemeId): string => `/themes/panoramas/${id}.ktx2`
+const openGraphPreview = (id: ThemeId): string => `/images/social/og/${id}.webp`
+const uiPreview = (id: ThemeId, role: 'thumbnail' | 'picker' | 'loading'): string =>
+  `/themes/previews/${id}-${role}.webp`
+
+export const WILD_WEST_COVERED_MINE_IRON_ID = 'wild-west.covered-mine-iron'
+export const WILD_WEST_COVERED_MINE_TIMBER_ID = 'wild-west.covered-mine-timber'
+
+const wood: MaterialPatternRecipe = {
+  kind: 'wood',
+  primary: '#8a4f26',
+  secondary: '#3c2114',
+  worldSize: [2.4, 2.4],
+}
+const jungleMossBark: MaterialPatternRecipe = {
+  kind: 'moss-bark',
+  primary: '#574128',
+  secondary: '#619646',
+  worldSize: [2.5, 2.5],
+}
+const jungleVines: MaterialPatternRecipe = {
+  kind: 'jungle-vines',
+  primary: '#16371f',
+  secondary: '#86c95b',
+  worldSize: [2.5, 2.5],
+}
+const jungleLeafCanopy: MaterialPatternRecipe = {
+  kind: 'leaf-canopy',
+  primary: '#2f7e3a',
+  secondary: '#a7da59',
+  worldSize: [2.5, 2.5],
+}
+const wildWestWoodenPlanks: MaterialPatternRecipe = {
+  kind: 'bridge-planks',
+  primary: '#b8743f',
+  secondary: '#211711',
+  worldSize: [8, 4.8],
+}
+
+const wildWestRoughGround: MaterialPatternRecipe = {
+  kind: 'rough-wood',
+  primary: '#d6ad78',
+  secondary: '#321b10',
+  worldSize: [2.5, 2.5],
+}
+
+const wildWestWoodenPlankMaterial: MaterialRecipe = {
+  kind: 'standard',
+  color: '#aa7857',
+  roughness: 0.76,
+  metalness: 0,
+  envMapIntensity: 0.18,
+  pattern: wildWestWoodenPlanks,
+  textureUrl: '/themes/textures/old-assets/shared-rope-bridge-mossy-planks-v2-albedo.webp',
+  normalTextureUrl: '/themes/textures/old-assets/shared-rope-bridge-mossy-planks-v2-normal.png',
+  roughnessTextureUrl: '/themes/textures/old-assets/shared-rope-bridge-mossy-planks-v2-roughness.png',
+  aoTextureUrl: '/themes/textures/old-assets/shared-rope-bridge-mossy-planks-v2-ao.png',
+  textureWorldSize: [1.8, 0.72],
+  normalScale: [0.86, 0.86],
+  aoMapIntensity: 0.64,
+}
+
+/** The approved plank timber reoriented for upright stockade grain. */
+const wildWestStockadeTimberMaterial: MaterialRecipe = {
+  kind: 'standard',
+  color: wildWestWoodenPlankMaterial.color,
+  roughness: wildWestWoodenPlankMaterial.roughness,
+  metalness: 0,
+  envMapIntensity: wildWestWoodenPlankMaterial.envMapIntensity,
+  pattern: {
+    kind: 'rough-wood',
+    primary: '#4b321f',
+    secondary: '#17100c',
+    worldSize: [0.72, 1.8],
+  },
+  textureUrl: '/themes/textures/old-assets/wild-west-stockade-plank-timber-v1-albedo.webp',
+  normalTextureUrl: '/themes/textures/old-assets/wild-west-stockade-plank-timber-v1-normal.png',
+  roughnessTextureUrl: '/themes/textures/old-assets/wild-west-stockade-plank-timber-v1-roughness.png',
+  aoTextureUrl: '/themes/textures/old-assets/wild-west-stockade-plank-timber-v1-ao.png',
+  textureWorldSize: [0.72, 1.8],
+  normalScale: wildWestWoodenPlankMaterial.normalScale,
+  aoMapIntensity: wildWestWoodenPlankMaterial.aoMapIntensity,
+}
+
+const wildWestRailMaterial: MaterialRecipe = {
+  kind: 'physical',
+  color: '#464846',
+  roughness: 0.42,
+  metalness: 0.92,
+  clearcoat: 0.08,
+  clearcoatRoughness: 0.38,
+  envMapIntensity: 1.18,
+}
+
+const wildWestRailTieMaterial: MaterialRecipe = {
+  kind: 'standard',
+  color: '#ffffff',
+  roughness: 0.96,
+  metalness: 0,
+  envMapIntensity: 0.18,
+  pattern: {
+    kind: 'rough-wood',
+    primary: '#3f291a',
+    secondary: '#17100c',
+    worldSize: [1.6, 0.55],
+  },
+  bumpScale: 0.035,
+}
+
+const wildWestGunmetalMaterial: MaterialRecipe = {
+  kind: 'physical',
+  color: '#ffffff',
+  roughness: 0.12,
+  metalness: 0.98,
+  clearcoat: 0.92,
+  clearcoatRoughness: 0.045,
+  envMapIntensity: 2.4,
+  pattern: {
+    kind: 'gunmetal-silver',
+    primary: '#eef2f2',
+    secondary: '#91a09d',
+    worldSize: [0.72, 0.72],
+  },
+  bumpScale: 0.018,
+}
+
+const wildWestTrestleIronMaterial: MaterialRecipe = {
+  kind: 'physical',
+  color: '#a4aaa7',
+  roughness: 0.28,
+  metalness: 0.92,
+  clearcoat: 0.24,
+  clearcoatRoughness: 0.22,
+  envMapIntensity: 1.3,
+  pattern: {
+    kind: 'gunmetal-silver',
+    primary: '#b7bcb8',
+    secondary: '#4d5350',
+    worldSize: [0.65, 0.65],
+  },
+  bumpScale: 0.025,
+}
+
+const wildWestSand: MaterialPatternRecipe = {
+  kind: 'sand',
+  primary: '#d2a05f',
+  secondary: '#6f3d24',
+  // Match the production image cadence so preview/test fallbacks do not
+  // visibly rescale when the browser asset finishes loading.
+  worldSize: [2.65, 2.65],
+}
+
+const wildWestSandyTrackMaterial: MaterialRecipe = {
+  kind: 'standard',
+  color: '#ffffff',
+  roughness: 0.98,
+  metalness: 0,
+  envMapIntensity: 0.48,
+  pattern: wildWestSand,
+  textureUrl: '/themes/textures/old-assets/wild-west-sand-track-v2.png',
+  textureWorldSize: [2.65, 2.65],
+  bumpScale: 0.14,
+  surfaceTreatment: {
+    kind: 'floor-perimeter-overlay',
+    materialId: WILD_WEST_SAND_SHOULDER_MATERIAL_ID,
+    bandWidth: 0.34,
+    featherWidth: 0.12,
+    normalOffset: 0.004,
+  },
+}
+
+export const JUNGLE_TEMPLE_FLAGSTONE_FLOOR_ID = 'jungle.temple-flagstone'
+export const JUNGLE_TEMPLE_MASONRY_WALL_ID = 'jungle.temple-masonry'
+export const GLOBAL_HAMMERED_GOLD_MATERIAL_ID = 'shared.hammered-gold'
+export const ANCIENT_EGYPT_PAVING_FLOOR_ID = 'ancient-egypt.temple-paving'
+export const ANCIENT_EGYPT_ASHLAR_WALL_ID = 'ancient-egypt.temple-ashlar'
+export const ANCIENT_EGYPT_PORTAL_SANDSTONE_ID = 'ancient-egypt.portal-sandstone'
+export const ANCIENT_EGYPT_PORTAL_CARVED_SANDSTONE_ID = 'ancient-egypt.portal-carved-sandstone'
+export const ANCIENT_EGYPT_PORTAL_AGED_GOLD_ID = 'ancient-egypt.portal-aged-gold'
+export const ANCIENT_EGYPT_PYRAMID_LIMESTONE_ID = 'ancient-egypt.pyramid-limestone'
+export const ANCIENT_EGYPT_PYRAMID_GOLD_ID = GLOBAL_HAMMERED_GOLD_MATERIAL_ID
+
+const jungleTempleFlagstoneMaterial: MaterialRecipe = {
+  kind: 'standard',
+  color: '#ffffff',
+  roughness: 0.98,
+  metalness: 0,
+  envMapIntensity: 0.58,
+  textureUrl: '/themes/textures/jungle-temple-mossy-flagstone-v3-albedo.webp',
+  normalTextureUrl: '/themes/textures/jungle-temple-mossy-flagstone-v3-normal.png',
+  heightTextureUrl: '/themes/textures/jungle-temple-mossy-flagstone-v3-height.png',
+  roughnessTextureUrl: '/themes/textures/jungle-temple-mossy-flagstone-v3-roughness.png',
+  aoTextureUrl: '/themes/textures/jungle-temple-mossy-flagstone-v3-ao.png',
+  textureWorldSize: [4.2, 4.2],
+  normalScale: [0.78, 0.78],
+  bumpScale: 0.04,
+  aoMapIntensity: 0.65,
+}
+
+const jungleTempleMasonryMaterial: MaterialRecipe = {
+  kind: 'standard',
+  color: '#ffffff',
+  roughness: 0.99,
+  metalness: 0,
+  envMapIntensity: 0.54,
+  textureUrl: '/themes/textures/jungle-temple-elevator-masonry-v3-albedo.webp',
+  normalTextureUrl: '/themes/textures/jungle-temple-elevator-masonry-v3-normal.png',
+  heightTextureUrl: '/themes/textures/jungle-temple-elevator-masonry-v3-height.png',
+  roughnessTextureUrl: '/themes/textures/jungle-temple-elevator-masonry-v3-roughness.png',
+  aoTextureUrl: '/themes/textures/jungle-temple-elevator-masonry-v3-ao.png',
+  textureWorldSize: [4.6, 4.6],
+  normalScale: [1.08, 1.08],
+  bumpScale: 0.085,
+  aoMapIntensity: 0.76,
+}
+
+const jungleTempleBlockStoneMaterial: MaterialRecipe = {
+  kind: 'standard',
+  color: '#ffffff',
+  roughness: 0.98,
+  metalness: 0,
+  envMapIntensity: 0.5,
+  textureUrl: '/themes/textures/jungle-temple-mossy-block-stone-v3-albedo.webp',
+  normalTextureUrl: '/themes/textures/jungle-temple-mossy-block-stone-v3-normal.png',
+  heightTextureUrl: '/themes/textures/jungle-temple-mossy-block-stone-v3-height.png',
+  roughnessTextureUrl: '/themes/textures/jungle-temple-mossy-block-stone-v3-roughness.png',
+  aoTextureUrl: '/themes/textures/jungle-temple-mossy-block-stone-v3-ao.png',
+  textureWorldSize: [1.7777777778, 1.7777777778],
+  normalScale: [0.62, 0.62],
+  bumpScale: 0.025,
+  aoMapIntensity: 0.56,
+}
+
+const ancientEgyptPavingMaterial: MaterialRecipe = {
+  kind: 'standard',
+  color: '#ffffff',
+  roughness: 0.97,
+  metalness: 0,
+  envMapIntensity: 1,
+  textureUrl: '/themes/textures/ancient-egypt-paving-v5-approved-albedo.webp',
+  normalTextureUrl: '/themes/textures/ancient-egypt-paving-v5-approved-normal.webp',
+  heightTextureUrl: '/themes/textures/ancient-egypt-paving-v5-approved-height.webp',
+  roughnessTextureUrl: '/themes/textures/ancient-egypt-paving-v5-approved-roughness.webp',
+  aoTextureUrl: '/themes/textures/ancient-egypt-paving-v5-approved-ao.webp',
+  textureWorldSize: [4.4, 4.4],
+  normalScale: [0.55, 0.55],
+  bumpScale: 0.01,
+  aoMapIntensity: 0.48,
+}
+
+const ancientEgyptAshlarMaterial: MaterialRecipe = {
+  kind: 'standard',
+  color: '#ffffff',
+  roughness: 0.96,
+  metalness: 0,
+  envMapIntensity: 0.66,
+  textureUrl: '/themes/textures/ancient-egypt-ashlar-v3-limestone-albedo.webp',
+  normalTextureUrl: '/themes/textures/ancient-egypt-ashlar-v2-normal.webp',
+  heightTextureUrl: '/themes/textures/ancient-egypt-ashlar-v2-height.webp',
+  roughnessTextureUrl: '/themes/textures/ancient-egypt-ashlar-v2-roughness.webp',
+  aoTextureUrl: '/themes/textures/ancient-egypt-ashlar-v2-ao.webp',
+  textureWorldSize: [5.2, 5.2],
+  normalScale: [1.08, 1.08],
+  bumpScale: 0.08,
+  aoMapIntensity: 0.74,
+}
+
+const ancientEgyptBlockLimestoneMaterial: MaterialRecipe = {
+  kind: 'standard',
+  color: '#ffffff',
+  roughness: 0.95,
+  metalness: 0,
+  envMapIntensity: 1,
+  textureUrl: '/themes/textures/ancient-egypt-block-limestone-v1-albedo.webp',
+  normalTextureUrl: '/themes/textures/ancient-egypt-block-limestone-v1-normal.webp',
+  heightTextureUrl: '/themes/textures/ancient-egypt-block-limestone-v1-height.webp',
+  roughnessTextureUrl: '/themes/textures/ancient-egypt-block-limestone-v1-roughness.webp',
+  aoTextureUrl: '/themes/textures/ancient-egypt-block-limestone-v1-ao.webp',
+  textureWorldSize: [1.7777777778, 1.7777777778],
+  normalScale: [0.55, 0.55],
+  bumpScale: 0.018,
+  aoMapIntensity: 0.48,
+}
+
+const ancientEgyptPortalCarvedSandstoneMaterial: MaterialRecipe = {
+  ...ancientEgyptAshlarMaterial,
+  normalScale: [1.2, 1.2],
+  bumpScale: 0.095,
+  aoMapIntensity: 0.8,
+}
+
+const ancientEgyptPyramidLimestoneMaterial: MaterialRecipe = {
+  kind: 'standard',
+  color: '#ffffff',
+  roughness: 1,
+  metalness: 0,
+  envMapIntensity: 0.82,
+  textureUrl: '/themes/textures/ancient-egypt-pyramid-limestone-v1-albedo.webp',
+  normalTextureUrl: '/themes/textures/ancient-egypt-pyramid-limestone-v1-normal.png',
+  heightTextureUrl: '/themes/textures/ancient-egypt-pyramid-limestone-v1-height.png',
+  roughnessTextureUrl: '/themes/textures/ancient-egypt-pyramid-limestone-v1-roughness.png',
+  aoTextureUrl: '/themes/textures/ancient-egypt-pyramid-limestone-v1-ao.png',
+  textureWorldSize: [2, 2],
+  normalScale: [0.42, 0.42],
+  bumpScale: 0.02,
+  aoMapIntensity: 0.35,
+}
+
+const globalHammeredGoldMaterial: MaterialRecipe = {
+  kind: 'physical',
+  color: '#ffffff',
+  roughness: 1,
+  metalness: 0.88,
+  emissive: '#6b3200',
+  emissiveIntensity: 0.18,
+  clearcoat: 0.42,
+  clearcoatRoughness: 0.16,
+  envMapIntensity: 1.9,
+  textureUrl: '/themes/textures/shared-hammered-gold-v1-albedo.webp',
+  normalTextureUrl: '/themes/textures/shared-hammered-gold-v1-normal.png',
+  heightTextureUrl: '/themes/textures/shared-hammered-gold-v1-height.png',
+  roughnessTextureUrl: '/themes/textures/shared-hammered-gold-v1-roughness.png',
+  aoTextureUrl: '/themes/textures/shared-hammered-gold-v1-ao.png',
+  textureWorldSize: [1.2, 1.2],
+  normalScale: [0.55, 0.55],
+  bumpScale: 0.014,
+  aoMapIntensity: 0.25,
+}
+
+const ancientEgyptPortalAgedGoldMaterial: MaterialRecipe = {
+  kind: 'physical',
+  color: '#ffd56a',
+  roughness: 0.22,
+  metalness: 0.96,
+  clearcoat: 0.34,
+  clearcoatRoughness: 0.2,
+  envMapIntensity: 1.9,
+}
+
+function createJungleMaterials(): Record<ThemeMaterialSlot, MaterialRecipe> {
+  const materials = createThemeMaterialSet(
+    {
+      laneSurface: '#d8efd0',
+      laneEdge: '#24452b',
+      laneGuard: '#4f8f45',
+      structure: '#5a4930',
+      structureSecondary: '#243521',
+      mechanism: '#526743',
+      moving: '#ef7d3d',
+      route: '#d7ee67',
+      hazard: '#ee563c',
+      finish: '#ffe27a',
+      energy: '#4ee1be',
+      portal: '#b06cff',
+      glass: '#86dfc8',
+      worldGround: '#284b28',
+      worldPrimary: '#493824',
+      worldSecondary: '#607744',
+      foliage: '#39933f',
+      accent: '#b5da4b',
+      dark: '#142317',
+    },
+    {
+      surfacePattern: jungleVines,
+      guardEmissive: '#17391b',
+      transparentGuardBacking: true,
+      structurePattern: jungleMossBark,
+      trackRoughness: 0.9,
+      trackMetalness: 0,
+      guardMetalness: 0,
+    },
+  )
+
+  materials['lane.surface'] = {
+    kind: 'physical',
+    color: '#ffffff',
+    roughness: 0.78,
+    metalness: 0,
+    clearcoat: 0.08,
+    clearcoatRoughness: 0.68,
+    transparent: false,
+    opacity: 1,
+    depthWrite: true,
+    envMapIntensity: 0.46,
+    pattern: jungleVines,
+  }
+  materials['world.ground'] = {
+    ...materials['world.ground'],
+    pattern: jungleVines,
+    roughness: 0.94,
+  }
+  materials['world.foliage'] = {
+    ...materials['world.foliage'],
+    pattern: jungleLeafCanopy,
+  }
+  return materials
+}
+
+export const ROCKY_MOUNTAIN_WILD_WEST_THEME: TrackThemeDefinition = {
+  id: 'rocky-mountain-wild-west',
+  version: 1,
+  label: 'Rocky Mountain Wild West',
+  shortLabel: 'Wild West',
+  description: 'Weathered timber, iron straps, desert dust, cactuses, and mountain sun.',
+  thumbnailUrl: uiPreview('rocky-mountain-wild-west', 'thumbnail'),
+  pickerPreviewUrl: uiPreview('rocky-mountain-wild-west', 'picker'),
+  loadingPreviewUrl: uiPreview('rocky-mountain-wild-west', 'loading'),
+  previewUrl: openGraphPreview('rocky-mountain-wild-west'),
+  panoramaUrl: panorama('rocky-mountain-wild-west'),
+  materials: {
+    ...createThemeMaterialSet(
+      {
+        laneSurface: '#c59562',
+        laneEdge: '#382b1e',
+        laneGuard: '#efc18d',
+        structure: '#5b4429',
+        structureSecondary: '#27331f',
+        mechanism: '#69714d',
+        moving: '#ef7d3d',
+        route: '#e6f05f',
+        hazard: '#ee563c',
+        finish: '#ffe27a',
+        energy: '#4ee1be',
+        portal: '#b06cff',
+        glass: '#86dfc8',
+        worldGround: '#35512d',
+        worldPrimary: '#6a4b2b',
+        worldSecondary: '#6b7554',
+        foliage: '#3f8f3e',
+        accent: '#ff943f',
+        dark: '#182318',
+      },
+      {
+        surfacePattern: wildWestRoughGround,
+        surfaceBumpScale: 0.16,
+        guardPattern: {
+          kind: 'stick-fence',
+          primary: '#e0a968',
+          secondary: '#6a3f25',
+          worldSize: [1.6, 1.6],
+        },
+        guardEmissive: '#4a250f',
+        transparentGuardBacking: true,
+        structurePattern: {
+          kind: 'bark',
+          primary: '#76502b',
+          secondary: '#273f24',
+          worldSize: [2.5, 2.5],
+        },
+        trackRoughness: 0.94,
+        trackMetalness: 0,
+        guardMetalness: 0,
+      },
+    ),
+    'lane.surface': wildWestSandyTrackMaterial,
+    'lane.guard': wildWestStockadeTimberMaterial,
+    ...createSharedObstacleMetalMaterials({ light: '#aeb5b0', dark: '#68716c' }),
+  },
+  detailMaterials: {
+    [SHARED_ROPE_WALL_END_GRAIN_MATERIAL_ID]: SHARED_ROPE_WALL_END_GRAIN_MATERIAL,
+    [WILD_WEST_GUNMETAL_FLIPPER_MATERIAL_ID]: wildWestGunmetalMaterial,
+    [WILD_WEST_RAIL_MATERIAL_ID]: wildWestRailMaterial,
+    [WILD_WEST_RAIL_TIE_MATERIAL_ID]: wildWestRailTieMaterial,
+    [WILD_WEST_SAND_SHOULDER_MATERIAL_ID]: {
+      kind: 'standard',
+      color: '#ffffff',
+      roughness: 1,
+      metalness: 0,
+      envMapIntensity: 0.42,
+      pattern: {
+        kind: 'sand',
+        primary: '#c9824f',
+        secondary: '#8a5033',
+        worldSize: [2.35, 2.35],
+      },
+      textureUrl: '/themes/textures/old-assets/wild-west-dirt-shoulder-v4.png',
+      textureWorldSize: [2.8, 2.8],
+      bumpScale: 0.08,
+    },
+    'wild-west.mine-timber': {
+      kind: 'standard',
+      color: '#ffffff',
+      roughness: 0.96,
+      metalness: 0,
+      envMapIntensity: 0.28,
+      pattern: {
+        kind: 'fence-timber',
+        primary: '#563522',
+        secondary: '#19100c',
+        worldSize: [1.6, 0.55],
+      },
+      textureUrl: '/themes/textures/old-assets/wild-west-portal-hand-hewn-timber-v2-albedo.webp',
+      normalTextureUrl: '/themes/textures/old-assets/wild-west-portal-hand-hewn-timber-v2-normal.png',
+      heightTextureUrl: '/themes/textures/old-assets/wild-west-portal-hand-hewn-timber-v2-height.png',
+      roughnessTextureUrl: '/themes/textures/old-assets/wild-west-portal-hand-hewn-timber-v2-roughness.png',
+      aoTextureUrl: '/themes/textures/old-assets/wild-west-portal-hand-hewn-timber-v2-ao.png',
+      textureWorldSize: [1.6, 0.55],
+      normalScale: [0.86, 0.86],
+      bumpScale: 0.045,
+      aoMapIntensity: 0.68,
+    },
+    [WILD_WEST_COVERED_MINE_TIMBER_ID]: {
+      kind: 'standard',
+      color: '#ffffff',
+      roughness: 0.88,
+      metalness: 0,
+      envMapIntensity: 0.42,
+      pattern: {
+        kind: 'fence-timber',
+        primary: '#6d3519',
+        secondary: '#1f0d06',
+        worldSize: [1.8, 0.72],
+      },
+      textureUrl: '/themes/textures/wild-west-covered-mine-timber-v1-albedo.webp',
+      normalTextureUrl: '/themes/textures/wild-west-covered-mine-timber-v1-normal.png',
+      heightTextureUrl: '/themes/textures/wild-west-covered-mine-timber-v1-height.png',
+      roughnessTextureUrl: '/themes/textures/wild-west-covered-mine-timber-v1-roughness.png',
+      aoTextureUrl: '/themes/textures/wild-west-covered-mine-timber-v1-ao.png',
+      textureWorldSize: [1.8, 0.72],
+      normalScale: [0.58, 0.58],
+      bumpScale: 0.026,
+      aoMapIntensity: 0.52,
+    },
+    [WILD_WEST_COVERED_MINE_IRON_ID]: {
+      kind: 'physical',
+      color: '#ffffff',
+      roughness: 0.58,
+      metalness: 0.68,
+      clearcoat: 0.06,
+      clearcoatRoughness: 0.68,
+      envMapIntensity: 1.14,
+      pattern: {
+        kind: 'gunmetal-silver',
+        primary: '#555752',
+        secondary: '#332017',
+        worldSize: [1.45, 1.45],
+      },
+      textureUrl: '/themes/textures/wild-west-covered-mine-iron-v1-albedo.webp',
+      normalTextureUrl: '/themes/textures/wild-west-covered-mine-iron-v1-normal.png',
+      heightTextureUrl: '/themes/textures/wild-west-covered-mine-iron-v1-height.png',
+      roughnessTextureUrl: '/themes/textures/wild-west-covered-mine-iron-v1-roughness.png',
+      aoTextureUrl: '/themes/textures/wild-west-covered-mine-iron-v1-ao.png',
+      textureWorldSize: [1.45, 1.45],
+      normalScale: [0.46, 0.46],
+      bumpScale: 0.018,
+      aoMapIntensity: 0.48,
+    },
+    'wild-west.warm-ivory-bone': {
+      kind: 'standard',
+      color: '#d7c49a',
+      roughness: 0.82,
+      metalness: 0,
+      envMapIntensity: 0.72,
+      pattern: {
+        kind: 'rock',
+        primary: '#dfcfaa',
+        secondary: '#8d7958',
+        worldSize: [0.72, 0.72],
+      },
+      bumpScale: 0.018,
+    },
+    [WILD_WEST_ANTIQUE_BRASS_MATERIAL_ID]: {
+      kind: 'physical',
+      color: '#ffffff',
+      roughness: 0.52,
+      metalness: 0.76,
+      clearcoat: 0.12,
+      clearcoatRoughness: 0.62,
+      envMapIntensity: 1.05,
+      textureUrl: '/themes/textures/jungle-temple-bronze-amber-ai-v1.webp',
+      textureWorldSize: [1.2, 1.2],
+      bumpScale: 0.025,
+    },
+    [WILD_WEST_TRESTLE_METAL_MATERIAL_ID]: wildWestTrestleIronMaterial,
+  },
+  appearancePresets: {
+    floor: [
+      {
+        id: WILD_WEST_WOODEN_PLANKS_FLOOR_ID,
+        label: 'Planks',
+        material: wildWestWoodenPlankMaterial,
+      },
+      {
+        id: WILD_WEST_SAND_FLOOR_ID,
+        label: 'Sand',
+        default: true,
+        material: wildWestSandyTrackMaterial,
+      },
+    ],
+    rail: [
+      {
+        id: WILD_WEST_RAIL_MATERIAL_ID,
+        label: 'Rails',
+        detailStyle: 'wild-west-railroad',
+        material: wildWestRailMaterial,
+      },
+    ],
+    support: [
+      {
+        id: WILD_WEST_TIMBER_TRESTLE_SUPPORT_ID,
+        label: 'Timber',
+        supportStyle: 'wild-west-timber-trestle',
+        material: wildWestWoodenPlankMaterial,
+      },
+      {
+        id: WILD_WEST_CANYON_BUTTRESS_SUPPORT_ID,
+        label: 'Canyon',
+        supportStyle: 'wild-west-canyon-buttress',
+        material: {
+          kind: 'standard',
+          color: '#ffffff',
+          roughness: 0.86,
+          metalness: 0,
+          envMapIntensity: 0.48,
+          textureUrl: '/themes/textures/wild-west-canyon-sandstone-v1-albedo.webp',
+          normalTextureUrl: '/themes/textures/wild-west-canyon-sandstone-v1-normal.webp',
+          heightTextureUrl: '/themes/textures/wild-west-canyon-sandstone-v1-height.webp',
+          roughnessTextureUrl: '/themes/textures/wild-west-canyon-sandstone-v1-roughness.webp',
+          aoTextureUrl: '/themes/textures/wild-west-canyon-sandstone-v1-ao.webp',
+          textureWorldSize: [3.6, 3.6],
+          bumpScale: 0.06,
+          normalScale: [0.65, 0.65],
+          aoMapIntensity: 0.55,
+        },
+      },
+      {
+        id: WILD_WEST_TRESTLE_METAL_MATERIAL_ID,
+        label: 'Trestle iron detail',
+        supportStyle: 'wild-west-timber-trestle',
+        material: wildWestTrestleIronMaterial,
+        hidden: true,
+      },
+    ],
+    wall: [
+      {
+        id: 'wild-west.short-ranch-fence',
+        label: 'Fence',
+        detailStyle: 'wild-west-short-ranch-fence',
+        material: SHARED_ROPE_WALL_TIMBER_MATERIAL,
+      },
+      {
+        id: 'wild-west.tall-stockade',
+        label: 'Stockade',
+        detailStyle: 'wild-west-tall-stockade',
+        default: true,
+        material: wildWestStockadeTimberMaterial,
+      },
+      {
+        id: 'wild-west.covered-mine-canopy',
+        label: 'Mine Canopy',
+        detailStyle: 'wild-west-short-ranch-fence',
+        canopyStyle: 'wild-west-covered-mine',
+        material: {
+          kind: 'standard',
+          color: '#f0d0aa',
+          roughness: 0.88,
+          metalness: 0.02,
+          envMapIntensity: 0.86,
+          pattern: {
+            kind: 'fence-timber',
+            primary: '#714022',
+            secondary: '#1f130e',
+            worldSize: [1.1, 1.1],
+          },
+          bumpScale: 0.1,
+        },
+      },
+    ],
+  },
+  environment: {
+    background: '#b96d39',
+    fog: '#c68b5c',
+    fogNear: 90,
+    fogFar: 330,
+    environmentIntensity: 0.82,
+  },
+  lighting: {
+    skyColor: '#ffe5c2',
+    groundColor: '#4a2515',
+    ambientIntensity: 1.45,
+    keyColor: '#ffd28d',
+    keyIntensity: 4.1,
+    keyPosition: [-30, 46, 26],
+    rimColor: '#8fb9dc',
+    rimIntensity: 1.05,
+    rimPosition: [30, 20, -32],
+    exposure: 1.04,
+  },
+  world: { kit: 'wild-west', density: 0.9 },
+  particles: {
+    style: 'dust',
+    color: '#ffd1a0',
+    secondaryColor: '#b86f3e',
+    count: 260,
+    size: 0.17,
+    speed: 0.72,
+    opacity: 0.34,
+  },
+  ambience: { style: 'desert', volume: 0.055 },
+}
+
+export const ANCIENT_EGYPT_THEME: TrackThemeDefinition = {
+  id: 'ancient-egypt',
+  version: 1,
+  label: 'Ancient Egypt',
+  shortLabel: 'Ancient Egypt',
+  description: 'Sunlit pyramids, sandstone temples, Nile palms, obelisks, and drifting desert gold.',
+  thumbnailUrl: uiPreview('ancient-egypt', 'thumbnail'),
+  pickerPreviewUrl: uiPreview('ancient-egypt', 'picker'),
+  loadingPreviewUrl: uiPreview('ancient-egypt', 'loading'),
+  previewUrl: openGraphPreview('ancient-egypt'),
+  panoramaUrl: panorama('ancient-egypt'),
+  materials: {
+    ...createThemeMaterialSet(
+      {
+        laneSurface: '#c58a4b',
+        laneEdge: '#5d3822',
+        laneGuard: '#ffffff',
+        structure: '#b97738',
+        structureSecondary: '#4a3022',
+        mechanism: '#806142',
+        moving: '#d8a23f',
+        route: '#f4cf68',
+        hazard: '#b8442d',
+        finish: '#f5df8b',
+        energy: '#42b9c7',
+        portal: '#2d71a8',
+        glass: '#bce4df',
+        worldGround: '#b9793c',
+        worldPrimary: '#d0a05d',
+        worldSecondary: '#8b5b35',
+        foliage: '#416f4b',
+        accent: '#2d6f91',
+        dark: '#271910',
+      },
+      {
+        surfacePattern: {
+          kind: 'painted-stone',
+          primary: '#d1a366',
+          secondary: '#8d5c35',
+          worldSize: [2, 2],
+        },
+        trackRoughness: 0.9,
+        trackMetalness: 0.01,
+        guardMetalness: 0.04,
+      },
+    ),
+    'lane.surface': ancientEgyptPavingMaterial,
+    'lane.edge': ancientEgyptBlockLimestoneMaterial,
+    'lane.guard': ancientEgyptBlockLimestoneMaterial,
+    'lane.guard.backing': ancientEgyptBlockLimestoneMaterial,
+    'structure.primary': ancientEgyptAshlarMaterial,
+    'structure.secondary': ancientEgyptAshlarMaterial,
+    ...createSharedObstacleMetalMaterials({ light: '#d9a83e', dark: '#a27125' }),
+  },
+  appearancePresets: {
+    floor: [
+      {
+        id: ANCIENT_EGYPT_PAVING_FLOOR_ID,
+        label: 'Sandstone Paving',
+        default: true,
+        material: ancientEgyptPavingMaterial,
+      },
+      {
+        id: WILD_WEST_WOODEN_PLANKS_FLOOR_ID,
+        label: 'Planks',
+        material: wildWestWoodenPlankMaterial,
+      },
+      {
+        id: WILD_WEST_SAND_FLOOR_ID,
+        label: 'Sand',
+        material: wildWestSandyTrackMaterial,
+      },
+    ],
+    wall: [
+      {
+        id: ANCIENT_EGYPT_ASHLAR_WALL_ID,
+        label: 'Temple Blocks',
+        default: true,
+        detailStyle: 'shared-stone-block-shell',
+        material: ancientEgyptBlockLimestoneMaterial,
+      },
+      {
+        id: SHARED_ROPE_WALL_MATERIAL_ID,
+        label: 'Rope Wall',
+        detailStyle: 'shared-rope-wall',
+        material: SHARED_ROPE_WALL_MATERIAL,
+      },
+    ],
+  },
+  detailMaterials: {
+    [SHARED_STONE_TRACK_BLOCK_MATERIAL_ID]: ancientEgyptBlockLimestoneMaterial,
+    [SHARED_ROPE_WALL_BACKING_MATERIAL_ID]: SHARED_ROPE_WALL_BACKING_MATERIAL,
+    [SHARED_ROPE_WALL_END_GRAIN_MATERIAL_ID]: SHARED_ROPE_WALL_END_GRAIN_MATERIAL,
+    [SHARED_ROPE_WALL_TIMBER_MATERIAL_ID]: SHARED_ROPE_WALL_TIMBER_MATERIAL,
+    [ANCIENT_EGYPT_PORTAL_SANDSTONE_ID]: ancientEgyptAshlarMaterial,
+    [ANCIENT_EGYPT_PORTAL_CARVED_SANDSTONE_ID]: ancientEgyptPortalCarvedSandstoneMaterial,
+    [ANCIENT_EGYPT_PORTAL_AGED_GOLD_ID]: ancientEgyptPortalAgedGoldMaterial,
+    [ANCIENT_EGYPT_PYRAMID_LIMESTONE_ID]: ancientEgyptPyramidLimestoneMaterial,
+    [ANCIENT_EGYPT_PYRAMID_GOLD_ID]: globalHammeredGoldMaterial,
+  },
+  environment: {
+    background: '#c78549',
+    fog: '#d6a76d',
+    fogNear: 100,
+    fogFar: 350,
+    environmentIntensity: 0.86,
+  },
+  lighting: {
+    skyColor: '#ffe0ae',
+    groundColor: '#59341f',
+    ambientIntensity: 1.5,
+    keyColor: '#ffd087',
+    keyIntensity: 4.3,
+    keyPosition: [-34, 43, 22],
+    rimColor: '#79a9c9',
+    rimIntensity: 0.95,
+    rimPosition: [28, 22, -34],
+    exposure: 1.05,
+  },
+  world: { kit: 'ancient-egypt', density: 0.88 },
+  particles: {
+    style: 'dust',
+    color: '#f7d49a',
+    secondaryColor: '#b8753e',
+    count: 230,
+    size: 0.16,
+    speed: 0.58,
+    opacity: 0.3,
+  },
+  ambience: { style: 'desert', volume: 0.05 },
+}
+
+export const JAPANESE_SAKURA_LAKE_THEME: TrackThemeDefinition = {
+  id: 'japanese-sakura-lake',
+  version: 1,
+  label: 'Japanese Sakura',
+  shortLabel: 'Sakura Lake',
+  description: 'Cherry blossoms, vermilion gates, lakeside temples, and a brilliant blue spring sky.',
+  thumbnailUrl: uiPreview('japanese-sakura-lake', 'thumbnail'),
+  pickerPreviewUrl: uiPreview('japanese-sakura-lake', 'picker'),
+  loadingPreviewUrl: uiPreview('japanese-sakura-lake', 'loading'),
+  previewUrl: openGraphPreview('japanese-sakura-lake'),
+  panoramaUrl: panorama('japanese-sakura-lake'),
+  materials: {
+    ...createThemeMaterialSet(
+      {
+        laneSurface: '#b98258',
+        laneEdge: '#4a2924',
+        laneGuard: '#ffffff',
+        structure: '#743b2f',
+        structureSecondary: '#28262b',
+        mechanism: '#65565a',
+        moving: '#e45d63',
+        route: '#ffd080',
+        hazard: '#d72f38',
+        finish: '#fff0b0',
+        energy: '#68d8dc',
+        portal: '#bd86e8',
+        glass: '#bdebf2',
+        worldGround: '#5f8c55',
+        worldPrimary: '#bd3432',
+        worldSecondary: '#49332d',
+        foliage: '#eaa1bb',
+        accent: '#f4c6d8',
+        dark: '#211a20',
+      },
+      {
+        surfacePattern: {
+          kind: 'painted-wood',
+          primary: '#ba855b',
+          secondary: '#70412f',
+          worldSize: [2.4, 2.4],
+        },
+        structurePattern: wood,
+        trackRoughness: 0.76,
+        trackMetalness: 0.03,
+        guardMetalness: 0.08,
+        clearcoat: 0.2,
+      },
+    ),
+    // The Japanese theme's ordinary wall is the same approved plaster used
+    // by the castle-wall preset. The old red procedural timber grid was a
+    // legacy default, not a separate architectural material.
+    'lane.guard': JAPANESE_SAKURA_CASTLE_PLASTER_MATERIAL,
+    'lane.guard.backing': JAPANESE_SAKURA_CASTLE_PLASTER_MATERIAL,
+    'lane.surface': JAPANESE_SAKURA_REDWOOD_PLANKS_MATERIAL,
+    ...createSharedObstacleMetalMaterials({ light: '#ffffff', dark: '#c4ccd0' }),
+  },
+  appearancePresets: {
+    floor: [
+      {
+        id: JAPANESE_SAKURA_REDWOOD_PLANKS_ID,
+        label: 'Redwood Planks',
+        default: true,
+        material: JAPANESE_SAKURA_REDWOOD_PLANKS_MATERIAL,
+      },
+      {
+        id: JAPANESE_SAKURA_CASTLE_PAVERS_ID,
+        label: 'Castle Pavers',
+        material: JAPANESE_SAKURA_CASTLE_PAVERS_MATERIAL,
+      },
+    ],
+    wall: [
+      {
+        id: JAPANESE_SAKURA_CASTLE_WALL_ID,
+        label: 'Castle Wall',
+        default: true,
+        detailStyle: 'japanese-sakura-castle-wall',
+        material: JAPANESE_SAKURA_CASTLE_PLASTER_MATERIAL,
+      },
+      {
+        id: JAPANESE_SAKURA_BRIDGE_FENCE_ID,
+        label: 'Bridge Fence',
+        detailStyle: 'japanese-sakura-vermilion-bridge-fence',
+        material: JAPANESE_SAKURA_BRIDGE_TIMBER_MATERIAL,
+      },
+      {
+        id: 'japanese-sakura.roofed-gate-canopy',
+        label: 'Roofed Gate',
+        canopyStyle: 'japanese-sakura-roofed-gate',
+        material: JAPANESE_SAKURA_BRIDGE_TIMBER_MATERIAL,
+      },
+    ],
+    support: [
+      {
+        id: JAPANESE_SAKURA_VERMILION_UNDERBRIDGE_SUPPORT_ID,
+        label: 'Timber Underbridge',
+        supportStyle: 'japanese-sakura-vermilion-underbridge',
+        material: JAPANESE_SAKURA_BRIDGE_TIMBER_MATERIAL,
+      },
+      {
+        id: JAPANESE_SAKURA_DRAGON_STONE_SUPPORT_ID,
+        label: 'Stone Piers',
+        supportStyle: 'japanese-sakura-dragon-stone',
+        material: JAPANESE_SAKURA_DRAGON_STONE_MATERIAL,
+      },
+    ],
+  },
+  detailMaterials: {
+    [JAPANESE_SAKURA_BRIDGE_TIMBER_ID]: JAPANESE_SAKURA_BRIDGE_TIMBER_MATERIAL,
+    [JAPANESE_SAKURA_BRIDGE_HARDWARE_ID]: JAPANESE_SAKURA_BRIDGE_HARDWARE_MATERIAL,
+    [JAPANESE_SAKURA_CASTLE_TIMBER_ID]: JAPANESE_SAKURA_CASTLE_TIMBER_MATERIAL,
+    [JAPANESE_SAKURA_CASTLE_MASONRY_ID]: JAPANESE_SAKURA_CASTLE_MASONRY_MATERIAL,
+    [JAPANESE_SAKURA_CASTLE_KAWARA_ID]: JAPANESE_SAKURA_CASTLE_KAWARA_MATERIAL,
+    [JAPANESE_SAKURA_PORTAL_FOUNDATION_STONE_ID]: JAPANESE_SAKURA_PORTAL_FOUNDATION_STONE_MATERIAL,
+  },
+  environment: {
+    background: '#79bde8',
+    fog: '#b9d9e8',
+    fogNear: 96,
+    fogFar: 340,
+    environmentIntensity: 0.92,
+  },
+  lighting: {
+    skyColor: '#d9f2ff',
+    groundColor: '#405a40',
+    ambientIntensity: 1.55,
+    keyColor: '#fff1cf',
+    keyIntensity: 4,
+    keyPosition: [-28, 48, 24],
+    rimColor: '#efb9d0',
+    rimIntensity: 1.1,
+    rimPosition: [32, 22, -30],
+    exposure: 1.06,
+  },
+  world: { kit: 'japanese-sakura-lake', density: 0.9 },
+  particles: {
+    style: 'petals',
+    color: '#ffd8e7',
+    secondaryColor: '#ed8eb1',
+    count: 320,
+    size: 0.16,
+    speed: 0.38,
+    opacity: 0.66,
+  },
+  ambience: { style: 'sakura-lake', volume: 0.045 },
+}
+
+export const INTERGALACTIC_SPACE_STATION_THEME: TrackThemeDefinition = {
+  id: 'intergalactic-space-station',
+  version: 1,
+  label: 'Intergalactic Space Station',
+  shortLabel: 'Space Station',
+  description: 'Armored modular decks, cyan energy conduits, planets, and drifting starlight.',
+  thumbnailUrl: uiPreview('intergalactic-space-station', 'thumbnail'),
+  pickerPreviewUrl: uiPreview('intergalactic-space-station', 'picker'),
+  loadingPreviewUrl: uiPreview('intergalactic-space-station', 'loading'),
+  previewUrl: openGraphPreview('intergalactic-space-station'),
+  panoramaUrl: panorama('intergalactic-space-station'),
+  materials: {
+    ...createThemeMaterialSet(
+      {
+        laneSurface: '#35424e',
+        laneEdge: '#111b25',
+        laneGuard: '#7e8c99',
+        structure: '#43515e',
+        structureSecondary: '#111a24',
+        mechanism: '#33424f',
+        moving: '#ff9d3d',
+        route: '#3ceaff',
+        hazard: '#ff5b4f',
+        finish: '#eaffff',
+        energy: '#48bfff',
+        portal: '#ab73ff',
+        glass: '#8edfff',
+        worldGround: '#111a24',
+        worldPrimary: '#7e8c99',
+        worldSecondary: '#263746',
+        foliage: '#526475',
+        accent: '#31dfff',
+        dark: '#060912',
+      },
+      {
+        trackRoughness: 0.5,
+        trackMetalness: 0.68,
+        guardMetalness: 0.72,
+        clearcoat: 0.08,
+      },
+    ),
+    'lane.surface': SPACE_STATION_FLOOR_DECK_MATERIAL,
+    'lane.guard': SPACE_STATION_WALL_CHASSIS_MATERIAL,
+    'lane.guard.backing': SPACE_STATION_WALL_CHASSIS_MATERIAL,
+    ...createSharedObstacleMetalMaterials({ light: '#68b8c7', dark: '#356d79' }),
+  },
+  appearancePresets: {
+    floor: [
+      {
+        id: SPACE_STATION_FLOOR_DECK_ID,
+        label: 'Modular Deck',
+        default: true,
+        material: SPACE_STATION_FLOOR_DECK_MATERIAL,
+      },
+      {
+        id: SPACE_STATION_HOVER_GRID_FLOOR_ID,
+        label: 'Hover Grid',
+        material: SPACE_STATION_HOVER_GRID_FLOOR_MATERIAL,
+      },
+    ],
+    wall: [
+      {
+        id: SPACE_STATION_ARMORED_WALL_ID,
+        label: 'Station Bulkhead',
+        default: true,
+        detailStyle: 'space-station-armored-wall',
+        material: SPACE_STATION_WALL_CHASSIS_MATERIAL,
+      },
+    ],
+  },
+  detailMaterials: {
+    [SPACE_STATION_FLOOR_DECK_BASE_ID]: SPACE_STATION_FLOOR_DECK_BASE_MATERIAL,
+    [SPACE_STATION_WALL_PANEL_ID]: SPACE_STATION_WALL_PANEL_MATERIAL,
+    [SPACE_STATION_WALL_RIB_ID]: SPACE_STATION_WALL_RIB_MATERIAL,
+    [SPACE_STATION_WALL_TRIM_ID]: SPACE_STATION_WALL_TRIM_MATERIAL,
+    [SPACE_STATION_WALL_LIGHT_ID]: SPACE_STATION_WALL_LIGHT_MATERIAL,
+    [SPACE_STATION_CENTER_GUIDE_ID]: SPACE_STATION_CENTER_GUIDE_MATERIAL,
+  },
+  environment: {
+    background: '#070916',
+    fog: '#101626',
+    fogNear: 110,
+    fogFar: 410,
+    environmentIntensity: 1.15,
+  },
+  lighting: {
+    skyColor: '#a8cfff',
+    groundColor: '#070b14',
+    ambientIntensity: 1.42,
+    keyColor: '#dceaff',
+    keyIntensity: 3.7,
+    keyPosition: [-20, 48, 34],
+    rimColor: '#8a5dff',
+    rimIntensity: 2,
+    rimPosition: [38, 28, -42],
+    exposure: 1.152,
+    practical: {
+      color: '#31edff',
+      intensity: 150,
+      distance: 28,
+      decay: 2,
+      count: 4,
+      heightOffset: 2.4,
+    },
+  },
+  world: { kit: 'space-station', density: 0.82 },
+  particles: {
+    style: 'space-drift',
+    color: '#d8f4ff',
+    secondaryColor: '#7b8dff',
+    count: 560,
+    size: 0.15,
+    speed: 2.4,
+    opacity: 0.72,
+  },
+  ambience: { style: 'space', volume: 0.045 },
+}
+
+export const LOW_POLY_JUNGLE_THEME: TrackThemeDefinition = {
+  id: 'low-poly-jungle',
+  version: 1,
+  label: 'Low-Poly Jungle',
+  shortLabel: 'Jungle',
+  description: 'Open vine-lattice lanes, climbing plants, broad leaves, mossy roots, and waterfall mist.',
+  thumbnailUrl: uiPreview('low-poly-jungle', 'thumbnail'),
+  pickerPreviewUrl: uiPreview('low-poly-jungle', 'picker'),
+  loadingPreviewUrl: uiPreview('low-poly-jungle', 'loading'),
+  previewUrl: openGraphPreview('low-poly-jungle'),
+  panoramaUrl: panorama('low-poly-jungle'),
+  materials: {
+    ...createJungleMaterials(),
+    'lane.surface': jungleTempleFlagstoneMaterial,
+    'lane.edge': jungleTempleBlockStoneMaterial,
+    'lane.guard': jungleTempleBlockStoneMaterial,
+    'lane.guard.backing': jungleTempleBlockStoneMaterial,
+    'structure.primary': jungleTempleMasonryMaterial,
+    'structure.secondary': jungleTempleMasonryMaterial,
+    ...createSharedObstacleMetalMaterials({ light: '#d3a23f', dark: '#9a7028' }),
+    'mechanism.flipper.primary': globalHammeredGoldMaterial,
+    'mechanism.flipper.secondary': globalHammeredGoldMaterial,
+  },
+  appearancePresets: {
+    floor: [
+      {
+        id: WILD_WEST_WOODEN_PLANKS_FLOOR_ID,
+        label: 'Planks',
+        material: wildWestWoodenPlankMaterial,
+      },
+      {
+        id: JUNGLE_TEMPLE_FLAGSTONE_FLOOR_ID,
+        label: 'Temple Flagstones',
+        default: true,
+        material: jungleTempleFlagstoneMaterial,
+      },
+    ],
+    wall: [
+      {
+        id: JUNGLE_TEMPLE_MASONRY_WALL_ID,
+        label: 'Temple Masonry',
+        default: true,
+        detailStyle: 'shared-stone-block-shell',
+        material: jungleTempleBlockStoneMaterial,
+      },
+      {
+        id: SHARED_ROPE_WALL_MATERIAL_ID,
+        label: 'Rope Wall',
+        detailStyle: 'shared-rope-wall',
+        material: SHARED_ROPE_WALL_MATERIAL,
+      },
+    ],
+  },
+  detailMaterials: {
+    [SHARED_STONE_TRACK_BLOCK_MATERIAL_ID]: jungleTempleBlockStoneMaterial,
+    [SHARED_ROPE_WALL_BACKING_MATERIAL_ID]: SHARED_ROPE_WALL_BACKING_MATERIAL,
+    [SHARED_ROPE_WALL_END_GRAIN_MATERIAL_ID]: SHARED_ROPE_WALL_END_GRAIN_MATERIAL,
+    [SHARED_ROPE_WALL_TIMBER_MATERIAL_ID]: SHARED_ROPE_WALL_TIMBER_MATERIAL,
+    [JUNGLE_TEMPLE_STONE_MATERIAL_ID]: jungleTempleMasonryMaterial,
+    [JUNGLE_TEMPLE_FACADE_MATERIAL_ID]: {
+      kind: 'standard',
+      color: '#ffffff',
+      roughness: 0.78,
+      metalness: 0,
+      envMapIntensity: 0.66,
+      textureUrl: '/themes/textures/jungle-temple-serpent-facade-v3-albedo.webp',
+      normalTextureUrl: '/themes/textures/jungle-temple-serpent-facade-v3-normal.png',
+      heightTextureUrl: '/themes/textures/jungle-temple-serpent-facade-v3-height.png',
+      roughnessTextureUrl: '/themes/textures/jungle-temple-serpent-facade-v3-roughness.png',
+      aoTextureUrl: '/themes/textures/jungle-temple-serpent-facade-v3-ao.png',
+      textureWorldSize: [1, 1],
+      normalScale: [0.72, 0.72],
+      bumpScale: 0.035,
+      aoMapIntensity: 0.58,
+    },
+    [JUNGLE_TEMPLE_TIMBER_MATERIAL_ID]: {
+      kind: 'toon',
+      color: '#ffffff',
+      roughness: 0.91,
+      metalness: 0,
+      gradientSteps: 5,
+      inkColor: '#17120c',
+      inkStrength: 0.08,
+      envMapIntensity: 0.7,
+      textureUrl: '/themes/textures/jungle-temple-timber-ai-v1.webp',
+      textureWorldSize: [3.6, 3.6],
+      bumpScale: 0.07,
+    },
+    [JUNGLE_TEMPLE_PLATFORM_MATERIAL_ID]: {
+      kind: 'toon',
+      color: '#ffffff',
+      roughness: 0.94,
+      metalness: 0,
+      gradientSteps: 5,
+      inkColor: '#1b160e',
+      inkStrength: 0.07,
+      envMapIntensity: 0.72,
+      textureUrl: '/themes/textures/jungle-temple-bamboo-platform-ai-v1.webp',
+      textureWorldSize: [4, 4],
+      bumpScale: 0.055,
+    },
+    [JUNGLE_TEMPLE_BRONZE_MATERIAL_ID]: {
+      kind: 'physical',
+      color: '#ffffff',
+      roughness: 0.52,
+      metalness: 0.76,
+      clearcoat: 0.12,
+      clearcoatRoughness: 0.62,
+      envMapIntensity: 1.05,
+      textureUrl: '/themes/textures/jungle-temple-bronze-amber-ai-v1.webp',
+      textureWorldSize: [3.2, 3.2],
+      bumpScale: 0.035,
+    },
+  },
+  environment: {
+    background: '#5e8b4c',
+    fog: '#7aa66b',
+    fogNear: 72,
+    fogFar: 285,
+    environmentIntensity: 0.78,
+  },
+  lighting: {
+    skyColor: '#dff4b4',
+    groundColor: '#132816',
+    ambientIntensity: 1.72,
+    keyColor: '#fff0a5',
+    keyIntensity: 4.05,
+    keyPosition: [-24, 46, 20],
+    rimColor: '#65c3a1',
+    rimIntensity: 1.28,
+    rimPosition: [32, 24, -30],
+    exposure: 1.08,
+  },
+  world: { kit: 'jungle', density: 1 },
+  particles: {
+    style: 'fireflies',
+    color: '#edff83',
+    secondaryColor: '#ff9f5d',
+    count: 260,
+    size: 0.14,
+    speed: 0.42,
+    opacity: 0.62,
+  },
+  ambience: { style: 'jungle', volume: 0.045 },
+}
+
+export const PAINTED_VALLEY_THEME: TrackThemeDefinition = {
+  id: PAINTED_VALLEY_THEME_ID,
+  version: 1,
+  label: 'Painted Valley',
+  shortLabel: 'Painted Valley',
+  description: 'Hand-painted grass paths, pale birch boardwalks, ranch fences, tropical flowers, and drifting petals.',
+  thumbnailUrl: uiPreview(PAINTED_VALLEY_THEME_ID, 'thumbnail'),
+  pickerPreviewUrl: uiPreview(PAINTED_VALLEY_THEME_ID, 'picker'),
+  loadingPreviewUrl: uiPreview(PAINTED_VALLEY_THEME_ID, 'loading'),
+  previewUrl: openGraphPreview(PAINTED_VALLEY_THEME_ID),
+  panoramaUrl: panorama(PAINTED_VALLEY_THEME_ID),
+  materials: {
+    ...createPaintedValleyMaterials(),
+    ...createSharedObstacleMetalMaterials({ light: '#d37b65', dark: '#965144' }),
+  },
+  detailMaterials: {
+    [PAINTED_VALLEY_GRASS_SHOULDER_MATERIAL_ID]: PAINTED_VALLEY_GRASS_SHOULDER_MATERIAL,
+    'wild-west.mine-timber': PAINTED_VALLEY_BIRCH_PLANK_MATERIAL,
+  },
+  appearancePresets: {
+    floor: [
+      {
+        id: PAINTED_VALLEY_GRASS_ORANGE_DIRT_PATH_FLOOR_ID,
+        label: 'Grass Path',
+        default: true,
+        material: PAINTED_VALLEY_GRASS_ORANGE_DIRT_PATH_MATERIAL,
+      },
+      {
+        id: WILD_WEST_WOODEN_PLANKS_FLOOR_ID,
+        label: 'Planks',
+        material: PAINTED_VALLEY_BIRCH_PLANK_MATERIAL,
+      },
+    ],
+    wall: [
+      {
+        id: 'wild-west.short-ranch-fence',
+        label: 'Birch Fence',
+        default: true,
+        detailStyle: 'wild-west-short-ranch-fence',
+        material: PAINTED_VALLEY_BIRCH_RANCH_FENCE_MATERIAL,
+      },
+      {
+        id: PAINTED_VALLEY_TROPICAL_FLOWER_HEDGE_WALL_ID,
+        label: 'Flower Hedge',
+        detailStyle: 'jungle-flower-hedge',
+        material: PAINTED_VALLEY_TROPICAL_FLOWER_HEDGE_CORE_MATERIAL,
+      },
+    ],
+  },
+  environment: {
+    background: '#93c6df',
+    fog: '#b7d1b7',
+    fogNear: 92,
+    fogFar: 360,
+    environmentIntensity: 0.66,
+  },
+  lighting: {
+    skyColor: '#d9eddd',
+    groundColor: '#405641',
+    ambientIntensity: 1.38,
+    keyColor: '#fff1bf',
+    keyIntensity: 2.85,
+    keyPosition: [-34, 48, 28],
+    rimColor: '#8eb8c4',
+    rimIntensity: 0.9,
+    rimPosition: [32, 22, -36],
+    exposure: 0.9,
+  },
+  world: { kit: 'studio', density: 0 },
+  particles: {
+    style: 'petals',
+    color: '#fff4e1',
+    secondaryColor: '#e9a9a3',
+    count: 230,
+    size: 0.18,
+    speed: 0.58,
+    opacity: 0.72,
+  },
+  ambience: { style: 'meadow', volume: 0.045 },
+}
+
+export const PRODUCTION_TRACK_THEMES = [
+  ROCKY_MOUNTAIN_WILD_WEST_THEME,
+  ANCIENT_EGYPT_THEME,
+  JAPANESE_SAKURA_LAKE_THEME,
+  INTERGALACTIC_SPACE_STATION_THEME,
+  PAINTED_VALLEY_THEME,
+  LOW_POLY_JUNGLE_THEME,
+] as const
+
+export const TRACK_THEMES = [
+  ...PRODUCTION_TRACK_THEMES,
+  VAMPIRE_CASTLE_THEME,
+  NEUTRAL_STUDIO_THEME,
+  MATERIAL_SLOT_DEBUG_THEME,
+] as const
+
+const themesById = new Map(TRACK_THEMES.map(theme => [theme.id, theme]))
+
+export interface ThemeResolution {
+  theme: TrackThemeDefinition
+  requestedId: string
+  usedFallback: boolean
+}
+
+export function resolveTrackTheme(themeId: string): ThemeResolution {
+  const theme = themesById.get(themeId)
+  return theme
+    ? { theme, requestedId: themeId, usedFallback: false }
+    : { theme: NEUTRAL_STUDIO_THEME, requestedId: themeId, usedFallback: true }
+}
+
+export function getTrackTheme(themeId: string): TrackThemeDefinition {
+  return resolveTrackTheme(themeId).theme
+}