@reicek/neataptic-ts 0.1.21 → 0.1.23

package/test/examples/flappy_bird/constants/README.md

@@ -0,0 +1,1163 @@
+# constants
+
+## constants/constants.ts
+
+### constants
+
+Legacy Flappy constants barrel.
+
+Constants are now organized into small, category-focused modules
+(`constants.*.ts`). This file remains as a compatibility export surface so
+existing imports continue to work while callers migrate gradually.
+
+Educational note:
+Treat this file as the folder map, not the best place to learn individual
+values. The category modules below are where the real documentation lives:
+physics, pipes, observation, runtime, rendering, network layout, and so on.
+
+### DEFAULT_CONTAINER_ID
+
+### FLAPPY_BIAS_TIER_CENTER_THRESHOLD
+
+### FLAPPY_BIAS_TIER_EDGE_START_ABS_VALUE
+
+### FLAPPY_BIAS_TIER_MAX_ABS_VALUE
+
+### FLAPPY_BIRD_AURA_ALPHA
+
+### FLAPPY_BIRD_AURA_BLUR_MULTIPLIER
+
+### FLAPPY_BIRD_AURA_EXPAND_PX
+
+### FLAPPY_BIRD_BODY_GLOW_BLUR_PX
+
+### FLAPPY_BIRD_CHAMPION_EXTRA_GLOW_BLUR_PX
+
+### FLAPPY_BIRD_HEIGHT_PX
+
+### FLAPPY_BIRD_RADIUS_PX
+
+### FLAPPY_BIRD_VIEWPORT_X_RATIO
+
+### FLAPPY_BIRD_X_PX
+
+### FLAPPY_BOX_MIN_COLUMNS
+
+### FLAPPY_BOX_MIN_ROWS
+
+### FLAPPY_BROWSER_ELITISM_COUNT
+
+### FLAPPY_BROWSER_POPULATION_SIZE
+
+### FLAPPY_CENTER_BLUE_RAMP
+
+### FLAPPY_CHAMPION_TRAIL_MAX_POINTS
+
+### FLAPPY_CONNECTION_TIER_CENTER_THRESHOLD
+
+### FLAPPY_CONNECTION_TIER_EDGE_START_ABS_VALUE
+
+### FLAPPY_CONNECTION_TIER_MAX_ABS_VALUE
+
+### FLAPPY_CONTROL_SUBSTEPS_PER_FRAME
+
+### FLAPPY_DEFAULT_RNG_SEED
+
+### FLAPPY_DIFFICULTY_RAMP_PIPES
+
+### FLAPPY_EMULATION_SPEED_MULTIPLIER
+
+### FLAPPY_ENABLE_RUNTIME_INSTRUMENTATION
+
+### FLAPPY_FITNESS_ALIGNMENT_WEIGHT_PER_FRAME
+
+### FLAPPY_FITNESS_APPROACH_PROGRESS_WEIGHT
+
+### FLAPPY_FITNESS_BONUS_PER_PIPE
+
+### FLAPPY_FITNESS_CENTERING_PROGRESS_WEIGHT
+
+### FLAPPY_FITNESS_CLEARANCE_WEIGHT_PER_FRAME
+
+### FLAPPY_FITNESS_SECOND_GAP_ALIGNMENT_WEIGHT_PER_FRAME
+
+### FLAPPY_FITNESS_STABLE_VELOCITY_WEIGHT_PER_FRAME
+
+### FLAPPY_FITNESS_SURVIVAL_WEIGHT
+
+### FLAPPY_FITNESS_TERMINAL_ALIGNMENT_BONUS_WEIGHT
+
+### FLAPPY_FITNESS_TERMINAL_PROGRESS_BONUS_WEIGHT
+
+### FLAPPY_FLAP_THRESHOLD
+
+### FLAPPY_FLAP_VELOCITY_PX_PER_FRAME
+
+### FLAPPY_FRAME_GLYPH_ROW_HEIGHT_PX
+
+### FLAPPY_FRAME_MIN_COLUMNS
+
+### FLAPPY_FRAME_MIN_GLYPH_WIDTH_PX
+
+### FLAPPY_FRAME_MONOSPACE_FONT
+
+### FLAPPY_FRAME_RESERVED_COLUMNS
+
+### FLAPPY_GLYPH_BOTTOM_LEFT
+
+### FLAPPY_GLYPH_BOTTOM_RIGHT
+
+### FLAPPY_GLYPH_HORIZONTAL
+
+### FLAPPY_GLYPH_SPACE
+
+### FLAPPY_GLYPH_TOP_LEFT
+
+### FLAPPY_GLYPH_TOP_RIGHT
+
+### FLAPPY_GLYPH_VERTICAL
+
+### FLAPPY_GRAVITY_PX_PER_FRAME2
+
+### FLAPPY_HALF
+
+### FLAPPY_HEADER_CANVAS_HEIGHT_PX
+
+### FLAPPY_HEADER_TITLE_TEXT
+
+### FLAPPY_HUD_INITIALIZING_TEXT
+
+### FLAPPY_HUD_OFF_TEXT
+
+### FLAPPY_HUD_UPDATE_INTERVAL_FRAMES
+
+### FLAPPY_HUD_UPDATES_WINDOW_MS
+
+### FLAPPY_HUD_UPDATES_WINDOW_SECONDS
+
+### FLAPPY_HUD_ZERO_DECIMAL_TEXT
+
+### FLAPPY_HUD_ZERO_TEXT
+
+### FLAPPY_INSTRUMENTATION_STATS_KEYS
+
+### FLAPPY_LIGHT_NEON_RAMP
+
+### FLAPPY_MAX_DIFFICULTY_EDGE_TO_EDGE_PIPE_SPACING_PX
+
+### FLAPPY_MAX_DIFFICULTY_PIPE_PITCH_PX
+
+### FLAPPY_MAX_FALL_SPEED_PX_PER_FRAME
+
+### FLAPPY_MAX_FRAMES_PER_EPISODE
+
+### FLAPPY_MEMORY_ACTION_WINDOW_STEPS
+
+### FLAPPY_MEMORY_CORE_FEATURE_COUNT
+
+### FLAPPY_MEMORY_STACKED_FRAME_COUNT
+
+### FLAPPY_MIN_CLEARANCE_MARGIN_PX
+
+### FLAPPY_MIN_EDGE_TO_EDGE_PIPE_SPACING_PX
+
+### FLAPPY_MIN_PIPE_RECOVERY_FRAMES
+
+### FLAPPY_MINOR_GC_WINDOW_MS
+
+### FLAPPY_MONOSPACE_FONT_FAMILY
+
+### FLAPPY_NEON_BIRD_PALETTE
+
+### FLAPPY_NEON_PALETTE
+
+### FLAPPY_NETWORK_ARCHITECTURE_COLUMN_SEPARATOR
+
+### FLAPPY_NETWORK_ARCHITECTURE_LINE_SEPARATOR
+
+### FLAPPY_NETWORK_BASELINE_HEIGHT_PX
+
+### FLAPPY_NETWORK_EMPTY_HIDDEN_LAYER_LABEL
+
+### FLAPPY_NETWORK_GRAPH_BOTTOM_PADDING_PX
+
+### FLAPPY_NETWORK_GRAPH_INNER_PADDING_PX
+
+### FLAPPY_NETWORK_GRAPH_LEFT_PADDING_PX
+
+### FLAPPY_NETWORK_GRAPH_RIGHT_PADDING_PX
+
+### FLAPPY_NETWORK_GRAPH_TOP_PADDING_PX
+
+### FLAPPY_NETWORK_HEADER_FONT_SIZE_PX
+
+### FLAPPY_NETWORK_HEADER_TEXT_COLOR
+
+### FLAPPY_NETWORK_HIDDEN_LAYER_SEPARATOR
+
+### FLAPPY_NETWORK_HIDDEN_LAYER_SIZES
+
+### FLAPPY_NETWORK_HIDDEN_NODE_STROKE_COLOR
+
+### FLAPPY_NETWORK_INFERRED_HIDDEN_LAYER_PREFIX
+
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_BAND_GAP_PX
+
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_BAND_WIDTH_PX
+
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_FONT_SIZE_PX
+
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_FONT_WEIGHT
+
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_MIN_HEIGHT_PX
+
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_RADIUS_PX
+
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_TEXT_COLOR
+
+### FLAPPY_NETWORK_INPUT_LAYER_TARGET_GAP_PX
+
+### FLAPPY_NETWORK_INPUT_SIZE
+
+### FLAPPY_NETWORK_LAYER_COMPLEXITY_BASELINE_COUNT
+
+### FLAPPY_NETWORK_LAYER_COMPLEXITY_HEIGHT_STEP_PX
+
+### FLAPPY_NETWORK_LEGEND_BACKGROUND
+
+### FLAPPY_NETWORK_LEGEND_BIAS_TITLE_COLOR
+
+### FLAPPY_NETWORK_LEGEND_BOTTOM_PADDING_PX
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_FONT_SIZE_PX
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_HEIGHT_THRESHOLD_PX
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_ROW_HEIGHT_PX
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_SECTION_GAP_PX
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_SECTION_TITLE_HEIGHT_PX
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_WIDTH_PX
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_WIDTH_THRESHOLD_PX
+
+### FLAPPY_NETWORK_LEGEND_CONNECTION_LINE_WIDTH_PX
+
+### FLAPPY_NETWORK_LEGEND_CONNECTION_TITLE_COLOR
+
+### FLAPPY_NETWORK_LEGEND_GRAPH_GAP_PX
+
+### FLAPPY_NETWORK_LEGEND_HEADER_COLOR
+
+### FLAPPY_NETWORK_LEGEND_HEADER_HEIGHT_PX
+
+### FLAPPY_NETWORK_LEGEND_MARGIN_PX
+
+### FLAPPY_NETWORK_LEGEND_MIN_TOP_PX
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_FONT_SIZE_PX
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_ROW_HEIGHT_PX
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_SECTION_GAP_PX
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_SECTION_TITLE_HEIGHT_PX
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_WIDTH_PX
+
+### FLAPPY_NETWORK_LEGEND_RIGHT_SIDE_THRESHOLD_RATIO
+
+### FLAPPY_NETWORK_LEGEND_ROW_TEXT_COLOR
+
+### FLAPPY_NETWORK_LEGEND_TARGET_TOP_PX
+
+### FLAPPY_NETWORK_LEGEND_TOP_LEFT_THRESHOLD_PX
+
+### FLAPPY_NETWORK_MAX_HEIGHT_PX
+
+### FLAPPY_NETWORK_MAX_NODE_HEIGHT_PX
+
+### FLAPPY_NETWORK_MAX_NODE_WIDTH_PX
+
+### FLAPPY_NETWORK_MIN_DRAWABLE_SIZE_PX
+
+### FLAPPY_NETWORK_MIN_HEIGHT_PX
+
+### FLAPPY_NETWORK_MIN_INTER_NODE_GAP_PX
+
+### FLAPPY_NETWORK_MIN_LABEL_HEIGHT_PX
+
+### FLAPPY_NETWORK_MIN_NODE_FIT_HEIGHT_PX
+
+### FLAPPY_NETWORK_MIN_NODE_HEIGHT_LABEL_EXTRA_PX
+
+### FLAPPY_NETWORK_MIN_NODE_INNER_PADDING_PX
+
+### FLAPPY_NETWORK_MIN_NODE_WIDTH_PX
+
+### FLAPPY_NETWORK_NODE_DENSITY_BASELINE_COUNT
+
+### FLAPPY_NETWORK_NODE_DENSITY_HEIGHT_STEP_PX
+
+### FLAPPY_NETWORK_NODE_HEIGHT_DENSITY_DIVISOR
+
+### FLAPPY_NETWORK_NODE_HEIGHT_DENSITY_MIN_DENOMINATOR
+
+### FLAPPY_NETWORK_NODE_HEIGHT_LAYER_WIDTH_DIVISOR
+
+### FLAPPY_NETWORK_NODE_HEIGHT_LAYER_WIDTH_MIN_DENOMINATOR
+
+### FLAPPY_NETWORK_NODE_LABEL_FILL_COLOR
+
+### FLAPPY_NETWORK_NODE_LABEL_FONT_WEIGHT
+
+### FLAPPY_NETWORK_NODE_LABEL_SIZE_RATIO
+
+### FLAPPY_NETWORK_NODE_LAYOUT_PADDING_PX
+
+### FLAPPY_NETWORK_NODE_TOP_MARGIN_PX
+
+### FLAPPY_NETWORK_NODE_WIDTH_LAYER_WIDTH_DIVISOR
+
+### FLAPPY_NETWORK_NODE_WIDTH_LAYER_WIDTH_MIN_DENOMINATOR
+
+### FLAPPY_NETWORK_NODE_WIDTH_TO_HEIGHT_RATIO
+
+### FLAPPY_NETWORK_OUTPUT_NODE_GLOW_COLOR
+
+### FLAPPY_NETWORK_OUTPUT_NODE_STROKE_COLOR
+
+### FLAPPY_NETWORK_OUTPUT_SIZE
+
+### FLAPPY_NETWORK_TOPOLOGY_HEIGHT_MULTIPLIER
+
+### FLAPPY_NON_CHAMPION_BODY_GLOW_BLUR_PX
+
+### FLAPPY_NON_CHAMPION_OPACITY
+
+### FLAPPY_NORMALIZATION_EPSILON
+
+### FLAPPY_PIPE_COLLISION_ENTRANCE_EXPAND_PX
+
+### FLAPPY_PIPE_COLLISION_SIDE_EXPAND_PX
+
+### FLAPPY_PIPE_ENTRY_RIM_INSET_PX
+
+### FLAPPY_PIPE_GAP_CENTER_MAX_DELTA_PX
+
+### FLAPPY_PIPE_GAP_CENTER_MAX_Y_PX
+
+### FLAPPY_PIPE_GAP_CENTER_MIN_Y_PX
+
+### FLAPPY_PIPE_GAP_MIN_PX
+
+### FLAPPY_PIPE_GAP_PX
+
+### FLAPPY_PIPE_GAP_RANDOM_JITTER_PX
+
+### FLAPPY_PIPE_GAP_SHRINK_PER_PIPE_PX
+
+### FLAPPY_PIPE_GAP_START_MULTIPLIER
+
+### FLAPPY_PIPE_OUTLINE_CYAN_GLOW_BLUR_PX
+
+### FLAPPY_PIPE_OUTLINE_CYAN_GLOW_COLOR
+
+### FLAPPY_PIPE_OUTLINE_ENTRANCE_GAP_PX
+
+### FLAPPY_PIPE_OUTLINE_GLOW_ALPHA
+
+### FLAPPY_PIPE_OUTLINE_GLOW_STROKE_WIDTH_PX
+
+### FLAPPY_PIPE_OUTLINE_SIDE_GAP_PX
+
+### FLAPPY_PIPE_OUTLINE_STROKE_WIDTH_PX
+
+### FLAPPY_PIPE_SPAWN_INTERVAL_FRAMES
+
+### FLAPPY_PIPE_SPAWN_INTERVAL_MIN_FRAMES
+
+### FLAPPY_PIPE_SPAWN_INTERVAL_SHRINK_PER_PIPE_FRAMES
+
+### FLAPPY_PIPE_SPAWN_INTERVAL_START_MULTIPLIER
+
+### FLAPPY_PIPE_SPEED_MAX_PX_PER_FRAME
+
+### FLAPPY_PIPE_SPEED_PX_PER_FRAME
+
+### FLAPPY_PIPE_WIDTH_PX
+
+### FLAPPY_REGULAR_NEON_RAMP
+
+### FLAPPY_SCREEN_PADDING_PX
+
+### FLAPPY_STARFIELD_CANVAS_CONTEXT_ID
+
+### FLAPPY_STARFIELD_COMPOSITE_SOURCE_OVER
+
+### FLAPPY_STARFIELD_CYAN_FILL_STYLE
+
+### FLAPPY_STARFIELD_FAR_SCROLL_RATIO
+
+### FLAPPY_STARFIELD_FULL_ALPHA
+
+### FLAPPY_STARFIELD_INCLUSIVE_RANGE_OFFSET
+
+### FLAPPY_STARFIELD_LAYER_SPECS
+
+### FLAPPY_STARFIELD_MID_SCROLL_RATIO
+
+### FLAPPY_STARFIELD_MIN_DIMENSION_PX
+
+### FLAPPY_STARFIELD_NEAR_SCROLL_RATIO
+
+### FLAPPY_STARFIELD_NO_BLUR_PX
+
+### FLAPPY_STARFIELD_ORIGIN_PX
+
+### FLAPPY_STARFIELD_TILE_HEIGHT_PX
+
+### FLAPPY_STARFIELD_TILE_WIDTH_PX
+
+### FLAPPY_STARFIELD_TRANSPARENT_SHADOW_COLOR
+
+### FLAPPY_STARFIELD_UNSIGNED_NORMALIZATION_DIVISOR
+
+### FLAPPY_STARFIELD_XORSHIFT_LEFT_SHIFT_FINAL
+
+### FLAPPY_STARFIELD_XORSHIFT_LEFT_SHIFT_PRIMARY
+
+### FLAPPY_STARFIELD_XORSHIFT_RIGHT_SHIFT
+
+### FLAPPY_STATS_ARCHITECTURE_KEYS
+
+### FLAPPY_STATS_KEYS
+
+### FLAPPY_STATS_ROWS
+
+### FLAPPY_STATS_SECTION_KEYS
+
+### FLAPPY_STATUS_EVOLVING_TEXT
+
+### FLAPPY_STATUS_PLAYING_TEXT
+
+### FLAPPY_TARGET_FLAP_INTERVAL_FRAMES
+
+### FLAPPY_TIER_ABOVE_COLOR
+
+### FLAPPY_TIER_EDGE_COUNT
+
+### FLAPPY_TIER_LOGARITHMIC_STEEPNESS
+
+### FLAPPY_TITLE_BOX_MARGIN_COLUMNS
+
+### FLAPPY_TITLE_BOX_MIN_HALF_SPAN
+
+### FLAPPY_TITLE_BOX_MIN_OUTER_GAP_COLUMNS
+
+### FLAPPY_TITLE_BOX_MIN_WIDTH
+
+### FLAPPY_TITLE_BOX_WIDTH_RATIO
+
+### FLAPPY_TRAIL_EDGE_FADE_DISTANCE_PX
+
+### FLAPPY_TRAIL_LINE_WIDTH_PX
+
+### FLAPPY_TRAIL_MAX_POINTS
+
+### FLAPPY_TRAIL_MIN_HORIZONTAL_SEGMENT_PX
+
+### FLAPPY_TRAIL_MIN_VERTICAL_SEGMENT_PX
+
+### FLAPPY_TRAIL_OPACITY_FACTOR
+
+### FLAPPY_UI_CANVAS_INSET_SHADOW
+
+### FLAPPY_UI_CONTENT_COLUMN_TOP_PADDING_PX
+
+### FLAPPY_UI_DOUBLE_PANEL_BORDER
+
+### FLAPPY_UI_NETWORK_CANVAS_BACKGROUND
+
+### FLAPPY_UI_NETWORK_HOST_BACKGROUND
+
+### FLAPPY_UI_NETWORK_HOST_FIXED_HEIGHT_PX
+
+### FLAPPY_UI_NETWORK_HOST_INITIAL_HEIGHT_PX
+
+### FLAPPY_UI_NETWORK_HOST_INSET_PX
+
+### FLAPPY_UI_OUTER_FRAME_BACKGROUND
+
+### FLAPPY_UI_OUTER_FRAME_MIN_SIDE_PADDING_PX
+
+### FLAPPY_UI_OUTER_FRAME_SIDE_PADDING_OFFSET_PX
+
+### FLAPPY_UI_SPLIT_BRIDGE_COLOR
+
+### FLAPPY_UI_STATS_ROW_BORDER
+
+### FLAPPY_UI_STATS_SECTION_BORDER
+
+### FLAPPY_UI_UNIFIED_INSET_SHADOW
+
+### FLAPPY_VIEWPORT_MIN_NETWORK_HEIGHT_BUDGET_PX
+
+### FLAPPY_VIEWPORT_MINIMUM_SIMULATION_HEIGHT_PX
+
+### FLAPPY_VIEWPORT_MINIMUM_SIMULATION_HEIGHT_RATIO
+
+### FLAPPY_VIEWPORT_MINIMUM_STATS_HEIGHT_PX
+
+### FLAPPY_VIEWPORT_MOBILE_MINIMAL_UI_BREAKPOINT_PX
+
+### FLAPPY_VIEWPORT_NETWORK_ONLY_BREAKPOINT_PX
+
+### FLAPPY_VIEWPORT_NETWORK_OVERLAY_HIDDEN_BREAKPOINT_PX
+
+### FLAPPY_VIEWPORT_SIMULATION_BOTTOM_MARGIN_PX
+
+### FLAPPY_VIEWPORT_VERTICAL_LAYOUT_GUTTER_PX
+
+### FLAPPY_WORLD_HEIGHT_PX
+
+### FLAPPY_WORLD_WIDTH_PX
+
+## constants/constants.birds.ts
+
+### constants.birds
+
+Bird, trail, and champion-highlight rendering constants.
+
+This module centralizes all per-bird visual treatments so appearance tuning
+stays decoupled from simulation and UI layout logic.
+
+### FLAPPY_BIRD_AURA_ALPHA
+
+### FLAPPY_BIRD_AURA_BLUR_MULTIPLIER
+
+### FLAPPY_BIRD_AURA_EXPAND_PX
+
+### FLAPPY_BIRD_BODY_GLOW_BLUR_PX
+
+### FLAPPY_BIRD_CHAMPION_EXTRA_GLOW_BLUR_PX
+
+### FLAPPY_CHAMPION_TRAIL_MAX_POINTS
+
+### FLAPPY_NON_CHAMPION_BODY_GLOW_BLUR_PX
+
+### FLAPPY_NON_CHAMPION_OPACITY
+
+### FLAPPY_TRAIL_EDGE_FADE_DISTANCE_PX
+
+### FLAPPY_TRAIL_LINE_WIDTH_PX
+
+### FLAPPY_TRAIL_MAX_POINTS
+
+### FLAPPY_TRAIL_MIN_HORIZONTAL_SEGMENT_PX
+
+### FLAPPY_TRAIL_MIN_VERTICAL_SEGMENT_PX
+
+## constants/constants.frame.ts
+
+### constants.frame
+
+Glyph frame and text-layout constants for browser HUD rendering.
+
+These values keep the box-drawing title/header and text frame deterministic
+across browsers with slightly different font metrics.
+
+### FLAPPY_BOX_MIN_COLUMNS
+
+### FLAPPY_BOX_MIN_ROWS
+
+### FLAPPY_FRAME_GLYPH_ROW_HEIGHT_PX
+
+### FLAPPY_FRAME_MIN_COLUMNS
+
+### FLAPPY_FRAME_MIN_GLYPH_WIDTH_PX
+
+### FLAPPY_FRAME_MONOSPACE_FONT
+
+### FLAPPY_FRAME_RESERVED_COLUMNS
+
+### FLAPPY_GLYPH_BOTTOM_LEFT
+
+### FLAPPY_GLYPH_BOTTOM_RIGHT
+
+### FLAPPY_GLYPH_HORIZONTAL
+
+### FLAPPY_GLYPH_SPACE
+
+### FLAPPY_GLYPH_TOP_LEFT
+
+### FLAPPY_GLYPH_TOP_RIGHT
+
+### FLAPPY_GLYPH_VERTICAL
+
+### FLAPPY_HEADER_CANVAS_HEIGHT_PX
+
+### FLAPPY_HEADER_TITLE_TEXT
+
+### FLAPPY_MONOSPACE_FONT_FAMILY
+
+### FLAPPY_TITLE_BOX_MARGIN_COLUMNS
+
+### FLAPPY_TITLE_BOX_MIN_HALF_SPAN
+
+### FLAPPY_TITLE_BOX_MIN_OUTER_GAP_COLUMNS
+
+### FLAPPY_TITLE_BOX_MIN_WIDTH
+
+### FLAPPY_TITLE_BOX_WIDTH_RATIO
+
+## constants/constants.pipes.ts
+
+### FLAPPY_PIPE_COLLISION_ENTRANCE_EXPAND_PX
+
+### FLAPPY_PIPE_COLLISION_SIDE_EXPAND_PX
+
+### FLAPPY_PIPE_GAP_CENTER_MAX_Y_PX
+
+### FLAPPY_PIPE_GAP_CENTER_MIN_Y_PX
+
+### FLAPPY_PIPE_GAP_PX
+
+### FLAPPY_PIPE_OUTLINE_ENTRANCE_GAP_PX
+
+### FLAPPY_PIPE_OUTLINE_SIDE_GAP_PX
+
+### FLAPPY_PIPE_OUTLINE_STROKE_WIDTH_PX
+
+### FLAPPY_PIPE_SPAWN_INTERVAL_FRAMES
+
+### FLAPPY_PIPE_SPEED_PX_PER_FRAME
+
+### FLAPPY_PIPE_WIDTH_PX
+
+## constants/constants.stats.ts
+
+### FLAPPY_INSTRUMENTATION_STATS_KEYS
+
+### FLAPPY_NETWORK_LEGEND_HEADER_COLOR
+
+### FLAPPY_STATS_ARCHITECTURE_KEYS
+
+### FLAPPY_STATS_KEYS
+
+### FLAPPY_STATS_ROWS
+
+### FLAPPY_STATS_SECTION_KEYS
+
+### FLAPPY_UI_STATS_ROW_BORDER
+
+### FLAPPY_UI_STATS_SECTION_BORDER
+
+## constants/constants.world.ts
+
+### constants.world
+
+Flappy world and episode-shape constants.
+
+This module groups stable geometry and run-budget values that define the
+simulation envelope. Keeping these together makes it easier to reason about
+how large the world is, where the bird is anchored, and when an episode ends.
+
+### FLAPPY_BIRD_HEIGHT_PX
+
+### FLAPPY_BIRD_RADIUS_PX
+
+### FLAPPY_BIRD_X_PX
+
+### FLAPPY_ENABLE_RUNTIME_INSTRUMENTATION
+
+### FLAPPY_MAX_FRAMES_PER_EPISODE
+
+### FLAPPY_WORLD_HEIGHT_PX
+
+### FLAPPY_WORLD_WIDTH_PX
+
+## constants/constants.layout.ts
+
+### constants.layout
+
+Browser UI layout and responsive-viewport constants.
+
+This module contains spacing, panel sizing, and breakpoint values used to
+keep the demo readable from compact to wide viewports.
+
+### FLAPPY_BIRD_VIEWPORT_X_RATIO
+
+### FLAPPY_SCREEN_PADDING_PX
+
+### FLAPPY_UI_CANVAS_INSET_SHADOW
+
+### FLAPPY_UI_CONTENT_COLUMN_TOP_PADDING_PX
+
+### FLAPPY_UI_DOUBLE_PANEL_BORDER
+
+### FLAPPY_UI_NETWORK_CANVAS_BACKGROUND
+
+### FLAPPY_UI_NETWORK_HOST_BACKGROUND
+
+### FLAPPY_UI_NETWORK_HOST_FIXED_HEIGHT_PX
+
+### FLAPPY_UI_NETWORK_HOST_INITIAL_HEIGHT_PX
+
+### FLAPPY_UI_NETWORK_HOST_INSET_PX
+
+### FLAPPY_UI_OUTER_FRAME_BACKGROUND
+
+### FLAPPY_UI_OUTER_FRAME_MIN_SIDE_PADDING_PX
+
+### FLAPPY_UI_OUTER_FRAME_SIDE_PADDING_OFFSET_PX
+
+### FLAPPY_UI_SPLIT_BRIDGE_COLOR
+
+### FLAPPY_UI_UNIFIED_INSET_SHADOW
+
+### FLAPPY_VIEWPORT_MIN_NETWORK_HEIGHT_BUDGET_PX
+
+### FLAPPY_VIEWPORT_MINIMUM_SIMULATION_HEIGHT_PX
+
+### FLAPPY_VIEWPORT_MINIMUM_SIMULATION_HEIGHT_RATIO
+
+### FLAPPY_VIEWPORT_MINIMUM_STATS_HEIGHT_PX
+
+### FLAPPY_VIEWPORT_MOBILE_MINIMAL_UI_BREAKPOINT_PX
+
+### FLAPPY_VIEWPORT_NETWORK_ONLY_BREAKPOINT_PX
+
+### FLAPPY_VIEWPORT_NETWORK_OVERLAY_HIDDEN_BREAKPOINT_PX
+
+### FLAPPY_VIEWPORT_SIMULATION_BOTTOM_MARGIN_PX
+
+### FLAPPY_VIEWPORT_VERTICAL_LAYOUT_GUTTER_PX
+
+## constants/constants.fitness.ts
+
+### constants.fitness
+
+Flappy reward-shaping constants.
+
+These values tune the learning signal seen by evolution. Separating them from
+world/physics constants keeps behavior tuning explicit and easier to teach.
+
+### FLAPPY_FITNESS_ALIGNMENT_WEIGHT_PER_FRAME
+
+### FLAPPY_FITNESS_APPROACH_PROGRESS_WEIGHT
+
+### FLAPPY_FITNESS_BONUS_PER_PIPE
+
+### FLAPPY_FITNESS_CENTERING_PROGRESS_WEIGHT
+
+### FLAPPY_FITNESS_CLEARANCE_WEIGHT_PER_FRAME
+
+### FLAPPY_FITNESS_SECOND_GAP_ALIGNMENT_WEIGHT_PER_FRAME
+
+### FLAPPY_FITNESS_STABLE_VELOCITY_WEIGHT_PER_FRAME
+
+### FLAPPY_FITNESS_SURVIVAL_WEIGHT
+
+### FLAPPY_FITNESS_TERMINAL_ALIGNMENT_BONUS_WEIGHT
+
+### FLAPPY_FITNESS_TERMINAL_PROGRESS_BONUS_WEIGHT
+
+## constants/constants.network.ts
+
+### constants.network
+
+Flappy policy-network and temporal memory constants.
+
+This module defines observation window shape and initial architecture sizing
+used when seeding agents for evolution.
+
+### FLAPPY_MEMORY_ACTION_WINDOW_STEPS
+
+### FLAPPY_MEMORY_CORE_FEATURE_COUNT
+
+### FLAPPY_MEMORY_STACKED_FRAME_COUNT
+
+### FLAPPY_NETWORK_HIDDEN_LAYER_SIZES
+
+### FLAPPY_NETWORK_INPUT_SIZE
+
+### FLAPPY_NETWORK_OUTPUT_SIZE
+
+## constants/constants.palette.ts
+
+### constants.palette
+
+Browser visual palette constants for the Flappy demo.
+
+This module centralizes theme colors and diverging ramps so visual tuning is
+easy to find and consistent across HUD, birds, pipes, and network overlays.
+
+### FLAPPY_CENTER_BLUE_RAMP
+
+### FLAPPY_LIGHT_NEON_RAMP
+
+### FLAPPY_NEON_BIRD_PALETTE
+
+### FLAPPY_NEON_PALETTE
+
+### FLAPPY_NETWORK_HEADER_TEXT_COLOR
+
+### FLAPPY_NETWORK_HIDDEN_NODE_STROKE_COLOR
+
+### FLAPPY_NETWORK_LEGEND_BIAS_TITLE_COLOR
+
+### FLAPPY_NETWORK_LEGEND_CONNECTION_TITLE_COLOR
+
+### FLAPPY_NETWORK_LEGEND_ROW_TEXT_COLOR
+
+### FLAPPY_NETWORK_NODE_LABEL_FILL_COLOR
+
+### FLAPPY_NETWORK_OUTPUT_NODE_GLOW_COLOR
+
+### FLAPPY_NETWORK_OUTPUT_NODE_STROKE_COLOR
+
+### FLAPPY_REGULAR_NEON_RAMP
+
+### FLAPPY_TIER_ABOVE_COLOR
+
+## constants/constants.physics.ts
+
+### constants.physics
+
+Flappy physics and control-cadence constants.
+
+Values in this module shape how quickly the bird falls, how strongly a flap
+responds, and how often a policy can react inside each visible frame.
+
+Small changes here have outsized behavioral impact because they reshape the
+control problem the policy is trying to solve.
+
+### FLAPPY_CONTROL_SUBSTEPS_PER_FRAME
+
+### FLAPPY_FLAP_VELOCITY_PX_PER_FRAME
+
+### FLAPPY_GRAVITY_PX_PER_FRAME2
+
+### FLAPPY_MAX_FALL_SPEED_PX_PER_FRAME
+
+### FLAPPY_TARGET_FLAP_INTERVAL_FRAMES
+
+## constants/constants.runtime.ts
+
+### DEFAULT_CONTAINER_ID
+
+### FLAPPY_BROWSER_ELITISM_COUNT
+
+### FLAPPY_BROWSER_POPULATION_SIZE
+
+### FLAPPY_DEFAULT_RNG_SEED
+
+### FLAPPY_EMULATION_SPEED_MULTIPLIER
+
+### FLAPPY_FLAP_THRESHOLD
+
+### FLAPPY_HALF
+
+### FLAPPY_HUD_INITIALIZING_TEXT
+
+### FLAPPY_HUD_OFF_TEXT
+
+### FLAPPY_HUD_UPDATE_INTERVAL_FRAMES
+
+### FLAPPY_HUD_UPDATES_WINDOW_MS
+
+### FLAPPY_HUD_UPDATES_WINDOW_SECONDS
+
+### FLAPPY_HUD_ZERO_DECIMAL_TEXT
+
+### FLAPPY_HUD_ZERO_TEXT
+
+### FLAPPY_MINOR_GC_WINDOW_MS
+
+### FLAPPY_NORMALIZATION_EPSILON
+
+### FLAPPY_STATUS_EVOLVING_TEXT
+
+### FLAPPY_STATUS_PLAYING_TEXT
+
+## constants/constants.rendering.ts
+
+### constants.rendering
+
+Shared rendering-policy constants.
+
+These values are consumed by browser playback drawing but intentionally live
+in shared Flappy constants to keep legacy imports stable during migration.
+
+### FLAPPY_TRAIL_OPACITY_FACTOR
+
+## constants/constants.starfield.ts
+
+### FLAPPY_STARFIELD_CANVAS_CONTEXT_ID
+
+### FLAPPY_STARFIELD_COMPOSITE_SOURCE_OVER
+
+### FLAPPY_STARFIELD_CYAN_FILL_STYLE
+
+### FLAPPY_STARFIELD_FAR_SCROLL_RATIO
+
+### FLAPPY_STARFIELD_FULL_ALPHA
+
+### FLAPPY_STARFIELD_INCLUSIVE_RANGE_OFFSET
+
+### FLAPPY_STARFIELD_LAYER_SPECS
+
+### FLAPPY_STARFIELD_MID_SCROLL_RATIO
+
+### FLAPPY_STARFIELD_MIN_DIMENSION_PX
+
+### FLAPPY_STARFIELD_NEAR_SCROLL_RATIO
+
+### FLAPPY_STARFIELD_NO_BLUR_PX
+
+### FLAPPY_STARFIELD_ORIGIN_PX
+
+### FLAPPY_STARFIELD_TILE_HEIGHT_PX
+
+### FLAPPY_STARFIELD_TILE_WIDTH_PX
+
+### FLAPPY_STARFIELD_TRANSPARENT_SHADOW_COLOR
+
+### FLAPPY_STARFIELD_UNSIGNED_NORMALIZATION_DIVISOR
+
+### FLAPPY_STARFIELD_XORSHIFT_LEFT_SHIFT_FINAL
+
+### FLAPPY_STARFIELD_XORSHIFT_LEFT_SHIFT_PRIMARY
+
+### FLAPPY_STARFIELD_XORSHIFT_RIGHT_SHIFT
+
+## constants/constants.difficulty.ts
+
+### FLAPPY_DIFFICULTY_RAMP_PIPES
+
+### FLAPPY_MAX_DIFFICULTY_EDGE_TO_EDGE_PIPE_SPACING_PX
+
+### FLAPPY_MAX_DIFFICULTY_PIPE_PITCH_PX
+
+### FLAPPY_MIN_CLEARANCE_MARGIN_PX
+
+### FLAPPY_MIN_EDGE_TO_EDGE_PIPE_SPACING_PX
+
+### FLAPPY_MIN_PIPE_RECOVERY_FRAMES
+
+### FLAPPY_PIPE_GAP_CENTER_MAX_DELTA_PX
+
+### FLAPPY_PIPE_GAP_MIN_PX
+
+### FLAPPY_PIPE_GAP_RANDOM_JITTER_PX
+
+### FLAPPY_PIPE_GAP_SHRINK_PER_PIPE_PX
+
+### FLAPPY_PIPE_GAP_START_MULTIPLIER
+
+### FLAPPY_PIPE_SPAWN_INTERVAL_MIN_FRAMES
+
+### FLAPPY_PIPE_SPAWN_INTERVAL_SHRINK_PER_PIPE_FRAMES
+
+### FLAPPY_PIPE_SPAWN_INTERVAL_START_MULTIPLIER
+
+### FLAPPY_PIPE_SPEED_MAX_PX_PER_FRAME
+
+## constants/constants.observation.ts
+
+### constants.observation
+
+Shared observation-normalization constants.
+
+These values are used by both browser playback and headless environment
+simulation when building normalized feature vectors.
+
+Keeping normalization constants shared is important because even tiny drift in
+feature scaling would make trainer, worker, and browser policies "see"
+different worlds.
+
+### FLAPPY_NORMALIZATION_EPSILON
+
+## constants/constants.pipe-render.ts
+
+### FLAPPY_PIPE_ENTRY_RIM_INSET_PX
+
+### FLAPPY_PIPE_OUTLINE_CYAN_GLOW_BLUR_PX
+
+### FLAPPY_PIPE_OUTLINE_CYAN_GLOW_COLOR
+
+### FLAPPY_PIPE_OUTLINE_ENTRANCE_GAP_PX
+
+### FLAPPY_PIPE_OUTLINE_GLOW_ALPHA
+
+### FLAPPY_PIPE_OUTLINE_GLOW_STROKE_WIDTH_PX
+
+### FLAPPY_PIPE_OUTLINE_SIDE_GAP_PX
+
+### FLAPPY_PIPE_OUTLINE_STROKE_WIDTH_PX
+
+## constants/constants.network-view.ts
+
+### constants.network-view
+
+Network visualization layout and tier-mapping constants.
+
+These values define graph padding, node sizing, legend geometry, and tier
+thresholds used to map connection and bias magnitudes to color ramps.
+
+### FLAPPY_BIAS_TIER_CENTER_THRESHOLD
+
+### FLAPPY_BIAS_TIER_EDGE_START_ABS_VALUE
+
+### FLAPPY_BIAS_TIER_MAX_ABS_VALUE
+
+### FLAPPY_CONNECTION_TIER_CENTER_THRESHOLD
+
+### FLAPPY_CONNECTION_TIER_EDGE_START_ABS_VALUE
+
+### FLAPPY_CONNECTION_TIER_MAX_ABS_VALUE
+
+### FLAPPY_NETWORK_ARCHITECTURE_COLUMN_SEPARATOR
+
+### FLAPPY_NETWORK_ARCHITECTURE_LINE_SEPARATOR
+
+### FLAPPY_NETWORK_BASELINE_HEIGHT_PX
+
+### FLAPPY_NETWORK_EMPTY_HIDDEN_LAYER_LABEL
+
+### FLAPPY_NETWORK_GRAPH_BOTTOM_PADDING_PX
+
+### FLAPPY_NETWORK_GRAPH_INNER_PADDING_PX
+
+### FLAPPY_NETWORK_GRAPH_LEFT_PADDING_PX
+
+### FLAPPY_NETWORK_GRAPH_RIGHT_PADDING_PX
+
+### FLAPPY_NETWORK_GRAPH_TOP_PADDING_PX
+
+### FLAPPY_NETWORK_HEADER_FONT_SIZE_PX
+
+### FLAPPY_NETWORK_HIDDEN_LAYER_SEPARATOR
+
+### FLAPPY_NETWORK_INFERRED_HIDDEN_LAYER_PREFIX
+
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_BAND_GAP_PX
+
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_BAND_WIDTH_PX
+
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_FONT_SIZE_PX
+
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_FONT_WEIGHT
+
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_MIN_HEIGHT_PX
+
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_RADIUS_PX
+
+### FLAPPY_NETWORK_INPUT_GROUP_LABEL_TEXT_COLOR
+
+### FLAPPY_NETWORK_INPUT_LAYER_TARGET_GAP_PX
+
+### FLAPPY_NETWORK_LAYER_COMPLEXITY_BASELINE_COUNT
+
+### FLAPPY_NETWORK_LAYER_COMPLEXITY_HEIGHT_STEP_PX
+
+### FLAPPY_NETWORK_LEGEND_BACKGROUND
+
+### FLAPPY_NETWORK_LEGEND_BOTTOM_PADDING_PX
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_FONT_SIZE_PX
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_HEIGHT_THRESHOLD_PX
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_ROW_HEIGHT_PX
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_SECTION_GAP_PX
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_SECTION_TITLE_HEIGHT_PX
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_WIDTH_PX
+
+### FLAPPY_NETWORK_LEGEND_COMPACT_WIDTH_THRESHOLD_PX
+
+### FLAPPY_NETWORK_LEGEND_CONNECTION_LINE_WIDTH_PX
+
+### FLAPPY_NETWORK_LEGEND_GRAPH_GAP_PX
+
+### FLAPPY_NETWORK_LEGEND_HEADER_HEIGHT_PX
+
+### FLAPPY_NETWORK_LEGEND_MARGIN_PX
+
+### FLAPPY_NETWORK_LEGEND_MIN_TOP_PX
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_FONT_SIZE_PX
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_ROW_HEIGHT_PX
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_SECTION_GAP_PX
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_SECTION_TITLE_HEIGHT_PX
+
+### FLAPPY_NETWORK_LEGEND_REGULAR_WIDTH_PX
+
+### FLAPPY_NETWORK_LEGEND_RIGHT_SIDE_THRESHOLD_RATIO
+
+### FLAPPY_NETWORK_LEGEND_TARGET_TOP_PX
+
+### FLAPPY_NETWORK_LEGEND_TOP_LEFT_THRESHOLD_PX
+
+### FLAPPY_NETWORK_MAX_HEIGHT_PX
+
+### FLAPPY_NETWORK_MAX_NODE_HEIGHT_PX
+
+### FLAPPY_NETWORK_MAX_NODE_WIDTH_PX
+
+### FLAPPY_NETWORK_MIN_DRAWABLE_SIZE_PX
+
+### FLAPPY_NETWORK_MIN_HEIGHT_PX
+
+### FLAPPY_NETWORK_MIN_INTER_NODE_GAP_PX
+
+### FLAPPY_NETWORK_MIN_LABEL_HEIGHT_PX
+
+### FLAPPY_NETWORK_MIN_NODE_FIT_HEIGHT_PX
+
+### FLAPPY_NETWORK_MIN_NODE_HEIGHT_LABEL_EXTRA_PX
+
+### FLAPPY_NETWORK_MIN_NODE_INNER_PADDING_PX
+
+### FLAPPY_NETWORK_MIN_NODE_WIDTH_PX
+
+### FLAPPY_NETWORK_NODE_DENSITY_BASELINE_COUNT
+
+### FLAPPY_NETWORK_NODE_DENSITY_HEIGHT_STEP_PX
+
+### FLAPPY_NETWORK_NODE_HEIGHT_DENSITY_DIVISOR
+
+### FLAPPY_NETWORK_NODE_HEIGHT_DENSITY_MIN_DENOMINATOR
+
+### FLAPPY_NETWORK_NODE_HEIGHT_LAYER_WIDTH_DIVISOR
+
+### FLAPPY_NETWORK_NODE_HEIGHT_LAYER_WIDTH_MIN_DENOMINATOR
+
+### FLAPPY_NETWORK_NODE_LABEL_FONT_WEIGHT
+
+### FLAPPY_NETWORK_NODE_LABEL_SIZE_RATIO
+
+### FLAPPY_NETWORK_NODE_LAYOUT_PADDING_PX
+
+### FLAPPY_NETWORK_NODE_TOP_MARGIN_PX
+
+### FLAPPY_NETWORK_NODE_WIDTH_LAYER_WIDTH_DIVISOR
+
+### FLAPPY_NETWORK_NODE_WIDTH_LAYER_WIDTH_MIN_DENOMINATOR
+
+### FLAPPY_NETWORK_NODE_WIDTH_TO_HEIGHT_RATIO
+
+### FLAPPY_NETWORK_TOPOLOGY_HEIGHT_MULTIPLIER
+
+### FLAPPY_TIER_EDGE_COUNT
+
+### FLAPPY_TIER_LOGARITHMIC_STEEPNESS