Initial commit: Geyser Phase 1 complete - Production-ready GPU texture sharing library

Features:
- Vulkan backend with Windows (HANDLE) and Linux (FD) external memory support
- Metal backend with IOSurface for macOS/iOS
- Full synchronization primitives (semaphores, fences, events)
- 21 texture formats supported
- 18 unit tests, all passing
- Comprehensive documentation (~1,500 lines)
- Cross-platform support: Windows, Linux, macOS, iOS

Phase 1 complete with all 5 development steps finished.

Author: vdmokstati

.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  check:
+    name: Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: dtolnay/rust-toolchain@stable
+      - run: cargo check --all-features
+
+  test:
+    name: Test Suite
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: dtolnay/rust-toolchain@stable
+      - run: cargo test --all-features
+
+  fmt:
+    name: Rustfmt
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt
+      - run: cargo fmt --all -- --check
+
+  clippy:
+    name: Clippy
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy
+      - run: cargo clippy --all-features -- -D warnings

.gitignore

@@ -0,0 +1,23 @@
+# Rust build artifacts
+/target/
+**/*.rs.bk
+*.pdb
+
+# Cargo lock for libraries (optional, keep for applications)
+# Cargo.lock
+
+# IDE / Editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# OS files
+Thumbs.db
+ehthumbs.db
+
+# Test output
+*.profraw
+*.profdata

CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contributing to Geyser
+
+Thank you for your interest in contributing to Geyser! We welcome contributions from the community.
+
+## Getting Started
+
+1. Fork the repository
+2. Clone your fork: `git clone https://github.com/yourusername/geyser.git`
+3. Create a new branch: `git checkout -b feature/your-feature-name`
+4. Make your changes
+5. Run tests: `cargo test`
+6. Run formatting: `cargo fmt`
+7. Run clippy: `cargo clippy`
+8. Commit your changes: `git commit -m "Add your feature"`
+9. Push to your fork: `git push origin feature/your-feature-name`
+10. Create a Pull Request
+
+## Code Style
+
+- Follow Rust standard style guidelines
+- Run `cargo fmt` before committing
+- Ensure `cargo clippy` passes without warnings
+- Write clear commit messages
+
+## Testing
+
+- Add tests for new functionality
+- Ensure all existing tests pass
+- Test on multiple platforms when possible
+
+## Documentation
+
+- Document all public APIs with doc comments
+- Update README.md if adding new features
+- Add examples for significant new functionality
+
+## Questions?
+
+Feel free to open an issue for questions or discussions about contributions.