Skip to content

Define BodyState and SceneSnapshot engine types #3

@jokiatgithub

Description

@jokiatgithub

Context

Rendering should consume a normalized engine snapshot instead of reaching directly into calculation details. This gives the project a clean boundary between astronomy and Three.js.

Roadmap: https://github.com/jokiatgithub/starwatcher/blob/main/docs/solar-system-engine-roadmap.md

Scope

  • Add BodyState for calculated body position, velocity if available, display metadata, and source metadata.
  • Add SceneSnapshot for timestamp, coordinate frame, bodies, scale profile, warnings, and provenance.
  • Keep the types usable in tests without WebGL.

Acceptance Criteria

  • Types are documented enough for future contributors.
  • A snapshot can represent the current heliocentric scene.
  • Snapshot metadata includes source/accuracy warnings.
  • Existing tests stay green.

Metadata

Metadata

Assignees

No one assigned

    Labels

    engineCore astronomy and scene engine workenhancementNew feature or requestroadmapWork linked to the solar system engine roadmap

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions