Skip to content

OpenSpatial 0.1.0 — Initial Framework Release

Latest

Choose a tag to compare

@helbertgs helbertgs released this 25 Jun 02:13
c5c671c

OpenSpatial 0.1.0

This is the first public release of OpenSpatial, an open-source, cross-platform 3D spatial mathematics framework inspired by Apple's Spatial framework.


✨ Overview

OpenSpatial provides a Swift-native foundation for 3D mathematical primitives, transformations, and spatial computations designed to work across:

  • macOS
  • iOS / tvOS / watchOS
  • Linux
  • Windows
  • WebAssembly (Wasm)
  • Android (experimental support)

The API is designed to closely mirror Apple's Spatial framework while remaining fully open-source and platform-agnostic.


🚀 Features

3D Primitives

  • Point3D
  • Vector3D
  • Size3D
  • Rect3D
  • Ray3D
  • Pose3D
  • ScaledPose3D
  • Rotation3D
  • Quaternion3D
  • EulerAngles
  • SphericalCoordinates3D

Transforms

  • AffineTransform3D
  • ProjectiveTransform3D

Coordinate Systems

  • CoordinateSpace3D
  • CoordinateSpaceValue3D
  • WorldReferenceCoordinateSpace

Protocol System

  • Primitive3D
  • Rotatable3D
  • Translatable3D
  • Scalable3D
  • Shearable3D
  • Clampable3D
  • Volumetric

🧪 Testing

  • Full unit test suite included
  • Coverage for core mathematical operations
  • Edge cases for floating-point precision and geometric stability
  • Cross-platform test validation (macOS, Linux, Windows)

📚 Documentation

  • DocC documentation enabled
  • GitHub Pages deployment configured
  • Swift Package Index support added

⚙️ Infrastructure

This release includes a complete development foundation:

  • GitHub Actions CI (macOS, Linux, Windows)
  • Codecov integration for test coverage tracking
  • DocC automated deployment pipeline
  • Swift Package Index configuration

⚠️ Status

This is an early development release (0.1.0).

The API is expected to evolve during the 0.x series as the framework is validated in real-world usage.

Breaking changes may occur before 1.0.0.


🙏 Acknowledgements

Inspired by Apple’s Spatial framework and modern spatial computing systems.

Built with Swift 6 and a focus on cross-platform compatibility.


🔗 Repository

https://github.com/helbertgs/OpenSpatial