updates to readme and CMakeLists.txt

[shapiromatron]

This PR refactors the project structure to improve documentation, build configuration, and development setup. The changes focus on making the project more accessible to new users and organizing dependencies more effectively.

• Comprehensive README rewrite with detailed installation instructions for macOS, Linux, and Windows
• Reorganization of Python dependencies into optional dev dependencies
• Addition of Python type stubs file for the C++ extension module

[Copilot]

Pull Request Overview

This PR refactors the project structure to improve documentation, build configuration, and development setup. The changes focus on making the project more accessible to new users and organizing dependencies more effectively.

• Comprehensive README rewrite with detailed installation instructions for macOS, Linux, and Windows
• Reorganization of Python dependencies into optional dev dependencies
• Addition of Python type stubs file for the C++ extension module

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
README.md	Complete rewrite with detailed quickstart guides for all platforms and project overview
pyproject.toml	Moved pytest and mypy to optional dev dependencies, updated pybind11 version constraint
src/demo/cppcore.pyi	Added Python type stubs for C++ extension functions
CMakeLists.txt	Refactored include directories and library linking for better organization
.github/workflows/wheels.yml	Added cibuildwheel test configuration
.github/workflows/test.yml	Updated to install dev dependencies

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}