Teskooano
Play
← All Releases

ReleaseTag 0.3.0 on GitHub

Teskooano 0.3.0

Version 0.3.0 rebuilt the simulation core and brought our own Solar System into Teskooano. You can read the full story in the dev diary, Cataclysms and Creation.

Highlights

  • A new physics system built from the ground up, with a choice of algorithms and integrators.
  • Sol, our own Solar System, as a built-in system.
  • A multi-star lighting system: real colour and luminosity from the star type, the body’s albedo and its distance.
  • Multiple shadows: moons cast shadows on planets, and planets cast shadows on ring systems.
  • A new comet type with a coma and tail that react to the star’s distance and direction.
  • New information panels for light, shadows, gravity and other physical details.
  • An improved travel camera and notification system.
  • Labels with each body’s distance and speed, and AU markers out to 100,000 AU that hide to reduce clutter.
  • Better orbit and prediction lines, with labels showing how long a body takes to get there.
  • Improved procedural system generation.

Detailed changes

App: Teskooano

Added

  • @teskooano/core-physics: Introduced createSimulationStream in simulation/simulation.ts, an RxJS-based function to create an Observable stream of simulation step results. This replaces the previous imperative runSimulation function.
  • @teskooano/core-physics: Added SimulationParameters interface to group parameters for the updateSimulation function.
  • @teskooano/systems-procedural-generation: generatePlanetObservable function in generators/planet.ts: Returns an RxJS Observable to emit generated planet and associated ring system data reactively.
  • @teskooano/data-types: CelestialObjectProperties interface to celestial.ts.
  • @teskooano/data-types: SliderValueChangePayload interface to events.ts.

Changed

  • @teskooano/web-apis: Refactored various API utility modules for code clarity and conciseness, removing redundant comments and logging (including idle-detection, invoker-commands, media-recorder, network, observers, popover, remote-playback, screen-capture, storage, workers).
  • @teskooano/web-apis: Updated resizeObserver.ts to use RxJS BehaviorSubject for state management, replacing nanostores.
  • @teskooano/web-apis: Simplified type definitions and internal logic in several modules for better maintainability.
  • @teskooano/renderer-threejs: Updated RendererStateAdapter.ts to consume RxJS Observables (celestialObjects$, simulationState$) from @teskooano/core-state.
  • @teskooano/renderer-threejs: Modified RendererStateAdapter.ts to use renderableActions.setAllRenderableObjects and visualSettings.next() for state updates, aligning with RxJS patterns.
  • @teskooano/renderer-threejs: Added seed and temperature properties to RenderableCelestialObject within RendererStateAdapter.ts.
  • @teskooano/renderer-threejs-core: Updated StateManager.ts to use RxJS Observables (celestialObjects$, simulationState$) and helper functions (getCelestialObjects, getSimulationState) from @teskooano/core-state.
  • @teskooano/renderer-threejs-core: Subscription logic in StateManager.ts now uses RxJS pipe, pairwise, and startWith for more robust state diffing.
  • @teskooano/renderer-threejs-core: Unsubscribe logic now uses RxJS Subscription objects.
  • @teskooano/renderer-threejs-core: Exported RendererCelestialObject type from index.ts.
  • @teskooano/renderer-threejs-core: Extensive comment removal and minor code cleanup across various files, including SceneManager.ts, test files (__tests__/*), events.ts, index.ts, and setup.ts.
  • Refactor: The @teskooano/renderer-threejs-effects package has been split into @teskooano/renderer-threejs-lighting and @teskooano/renderer-threejs-lod.
  • @teskooano/renderer-threejs-interaction: ControlsManager.ts now uses getSimulationState and setSimulationState from @teskooano/core-state for camera state updates.
  • @teskooano/renderer-threejs-interaction: CSS2DManager.ts:
    • Added pre-render checks to find and remove orphaned labels and to hide any CSS2DObject in the scene without a parent, improving stability.
    • Simplified internal logic for managing pointer-events.
  • @teskooano/renderer-threejs-interaction: Extensive comment removal and minor code cleanup across various files, including test files and setup.ts.
  • @teskooano/renderer-threejs-interaction: Removed Playwright and Vitest browser-specific triple-slash directives from setup.ts.
  • @teskooano/renderer-threejs-objects: Major Refactor (Mesh Creation):
    • Deleted the monolithic MeshFactory.ts class.
    • Introduced a new object-manager/mesh-creators/ directory with dedicated functions for creating meshes for specific celestial object types (e.g., createStarMesh, createPlanetMesh, createRingSystemMesh, etc.).
    • Each creator function now handles fetching appropriate LOD levels from CelestialRenderer instances and constructing THREE.LOD objects.
    • Added createFallbackSphere.ts for consistent fallback mesh generation.
  • @teskooano/renderer-threejs-objects: Updated exports in object-manager/index.ts to include new managers like AccelerationVisualizer, DebrisEffectManager, ObjectLifecycleManager, and the new mesh creator exports.
  • @teskooano/renderer-threejs-objects: Refactored RendererUpdater.ts:
    • Simplified update logic for standard and specialized renderers.
    • The dispose() method is now empty, indicating a change in how renderer resources are managed or disposed of.
    • General comment cleanup.
  • @teskooano/renderer-threejs-orbits: Dependency Update: Replaced nanostores with rxjs for state management.
  • @teskooano/renderer-threejs-orbits: RxJS Integration:
    • OrbitManager.ts and orbit-manager/keplerian-manager.ts now consume renderableStore.renderableObjects$ (an RxJS Observable) and getCelestialObjects() from @teskooano/core-state (note: getCelestialObjects() is part of gameStateService).
    • Both managers subscribe to renderableStore.renderableObjects$ to get the latest data for orbit calculations.
    • OrbitManager.ts subscription to RendererStateAdapter.$visualSettings now uses RxJS subscribe and unsubscribe methods.
    • The dispose method in KeplerianOrbitManager now correctly unsubscribes from the renderableStore.renderableObjects$ observable.
  • @teskooano/renderer-threejs-orbits: Extensive comment removal and minor code cleanup across most files, including OrbitManager.ts, orbit-manager/keplerian-manager.ts, orbit-manager/orbit-calculator.ts, and orbit-manager/verlet-predictor.ts.
  • @teskooano/core-physics: Refactored various modules (orbital/orbital.ts, spatial/octree.ts, units/*, utils/*) for code clarity and conciseness by removing redundant comments and performing minor cleanup.
  • @teskooano/core-physics: Simplified parameter passing to updateSimulation by using the new SimulationParameters interface.
  • @teskooano/core-state: Major Refactor: Migrated core game state management (simulationState, celestialObjectsStore, celestialHierarchyStore, renderableObjectsStore, panelState) from Nanostores (atom, map) to RxJS BehaviorSubject.
    • State stores now expose an Observable (e.g., simulationState$) for reactive subscriptions and getter functions (e.g., getSimulationState()) for direct access.
    • Setter functions (e.g., setSimulationState()) and specific action dispatchers are now used for state modification.
  • @teskooano/core-state: Updated physics.ts to use new RxJS-based state accessors (getSimulationState, getCelestialObjects).
  • @teskooano/core-state: Refactored factory.ts to use new state setters (setSimulationState, setCelestialHierarchy) and getters, and removed redundant comments.
  • @teskooano/core-state: Simplified stores.ts, panelRegistry.ts, and panelState.ts by removing unnecessary comments and adapting to RxJS.
  • @teskooano/core-state: Updated currentSeed in stores.ts to use BehaviorSubject.
  • @teskooano/core-state: Introduced accelerationVectors$ observable in stores.ts.
  • @teskooano/core-state: Revised exports in packages/core/state/src/game/index.ts to reflect the new RxJS structure.
  • @teskooano/systems-celestial: Major Refactor (Materials & Textures):
    • Removed the entire old procedural texture generation system (deleted textures/ directory including TextureFactory.ts, TextureGeneratorBase.ts, and individual generator classes like GasGiantTextureGenerator.ts, TerrestrialTextureGenerator.ts, etc.).
    • Removed the old material management system (deleted MaterialFactory.ts and individual material classes like PlanetMaterial.ts, StarMaterial.ts, etc.).
    • Introduced a new materials/ directory with dedicated functions for material creation:
      • createProceduralPlanetMaterial.ts: For generating planet materials, likely using shaders and uniforms defined in types/procedural.ts.
      • createRingMaterial.ts: For ring system materials.
      • createStarMaterial.ts: For star materials.
    • Updated BaseTerrestrialRenderer.ts, RingSystemRenderer.ts, and BaseStarRenderer.ts to use these new material creation functions instead of the old factories.
  • @teskooano/systems-celestial: Added types/procedural.ts defining ProceduralPlanetUniforms for shader-based planet rendering.
  • @teskooano/systems-celestial: General comment cleanup and minor refactoring in utils/event-dispatch.ts and vitest.config.ts.
  • @teskooano/systems-procedural-generation: Major Refactor (Planet Surface Properties):
    • Renamed createDetailedSurfaceProperties to createProceduralSurfaceProperties in utils.ts.
    • createProceduralSurfaceProperties now consistently returns a ProceduralSurfaceProperties object for all planet types.
    • This function now defines specific procedural parameters (noise settings, bump scale) and detailed color palettes (low, mid1, mid2, high) tailored for each PlanetType (TERRESTRIAL, ROCKY, BARREN, DESERT, ICE, LAVA, OCEAN).
    • Added shininess and specularStrength to the ProceduralSurfaceProperties output, supporting more unified shader-based rendering.
  • @teskooano/systems-procedural-generation: generators/planet.ts now uses the new generatePlanetObservable and createProceduralSurfaceProperties.
  • @teskooano/systems-procedural-generation: Extensive comment removal and minor code cleanup in generators/star.ts, name-generator.ts, seeded-random.ts, and utils.ts.
  • @teskooano/data-types: Significantly reduced comments across most files for brevity (celestial.ts, events.ts, globals.d.ts, index.spec.ts, main.ts, scaling.ts, ui.ts).
  • @teskooano/data-types: Reordered exports in index.ts and added globals.d.ts to the exports.
  • Major refactor of camera management, centralizing control logic within the CameraManager plugin. CameraManager now orchestrates camera movements, transitions, and object following.
  • FocusControl plugin updated to integrate with the new CameraManager for handling focus and follow requests, using followObject.
  • ModularSpaceRenderer methods related to direct camera control (updateCamera, setFollowTarget) have been deprecated, with functionality moved to CameraManager and ControlsManager.

Removed

  • @teskooano/systems-celestial: Deleted AtmosphereMaterial.ts, BaseCelestialMaterial.ts, GasGiantMaterial.ts, SpaceRockMaterial.ts, SunMaterial.ts as part of the material system overhaul.
  • @teskooano/systems-celestial: Deleted textures/RingTextureGenerator.ts (and other texture generators as noted above).

Package: Data Types

Added

  • Added USER_CAMERA_MANIPULATION: "user-camera-manipulation" to CustomEvents in events.ts.
  • Added CAMERA_TRANSITION_COMPLETE: "camera-transition-complete" to CustomEvents in events.ts.

Package: Renderer ThreeJS Interaction

Changed

  • Refactored ControlsManager.ts:
    • Introduced new GSAP-based camera transition methods: transitionTo (for position and target) and transitionTargetTo (for target only), replacing older, more complex transition logic.
    • Added private helper methods _beginTransition and _endTransition to encapsulate common transition setup and teardown logic.
    • Simplified the startFollowing method to only store the target object and offset, with CameraManager now responsible for initiating the move to the follow position.
    • The setFollowTarget method has been deprecated; its responsibilities are now split between CameraManager (initiating transitions) and the simplified startFollowing.
    • Now emits CustomEvents.USER_CAMERA_MANIPULATION when the user manually changes the camera via controls.
    • Now emits CustomEvents.CAMERA_TRANSITION_COMPLETE when a GSAP transition finishes, providing details about the transition type and any focused object.