compas-nest 0.1.0__tar.gz

compas_nest-0.1.0/.github/workflows/build.yml

@@ -0,0 +1,80 @@
+name: build
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build_wheels:
+    name: Build wheels on ${{ matrix.platform }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            platform: manylinux
+          - os: macos-latest
+            platform: mac
+          - os: windows-latest
+            platform: windows
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          submodules: recursive
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v2.23.1
+        with:
+          output-dir: wheelhouse
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.platform }}
+          path: wheelhouse/*.whl
+
+  build_sdist:
+    name: Build source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          submodules: recursive
+
+      - name: Build SDist
+        run: pipx run build --sdist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  # Publish to PyPI on every push to main. `skip-existing` makes this a no-op when the version in
+  # src/compas_nest/__init__.py is unchanged, so bump it to release a new version.
+  publish:
+    name: Publish to PyPI
+    needs: [build_wheels, build_sdist]
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/compas_nest
+    permissions:
+      id-token: write   # OIDC trusted publishing (no API token needed)
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          path: dist
+          merge-multiple: true
+      - uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

compas_nest-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,31 @@
+name: docs
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          submodules: recursive
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      # mkdocstrings imports compas_nest, so the C++ extension must be built/installed first.
+      - name: Build and install compas_nest
+        run: pip install .
+
+      - name: Install docs dependencies
+        run: pip install -r requirements-docs.txt
+
+      - name: Build and deploy to gh-pages
+        run: mkdocs gh-deploy --force

compas_nest-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+# Build / packaging
+build/
+dist/
+wheelhouse/
+*.egg-info/
+_skbuild/
+*.pyd
+*.so
+*.dll
+*.lib
+*.exp
+*.obj
+
+# Python
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.venv/
+temp/
+
+# Generated example outputs
+data/output/*.json
+
+# Docs
+site/
+
+# OS / editor
+.DS_Store
+.vscode/
+.idea/

compas_nest-0.1.0/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "external/nest"]
+	path = external/nest
+	url = https://github.com/petrasvestartas/nest.git

compas_nest-0.1.0/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## Unreleased
+
+### Added
+
+* `nest_geo` and `nest_sheets` COMPAS `Data` containers (replicating the OpenNest C# `nest_geo` / `nest_sheets`).
+* `opennest_collision` wrapper around the physics / overlap-relaxation engine (`np_nest`), with a non-blocking `start()` + `collision_solve` handle for live animation.
+* `opennest` wrapper around the NFP + genetic-algorithm engine (`nfp_nest`).
+* `nest_result` with world-placed geometry grouped per sheet and `to_json()` (placed polylines + transformations) serialization.
+* nanobind C++ bindings `_nest_physics` and `_nfp_nest`.
+* compas_viewer examples (top view, grouped scene, live animation, real 48-element dataset) and pytest smoke tests.
+
+### Changed
+
+### Removed

compas_nest-0.1.0/CMakeLists.txt

@@ -0,0 +1,107 @@
+cmake_minimum_required(VERSION 3.15...3.27)
+
+project(nest_wrapper LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+if(NOT CMAKE_BUILD_TYPE)
+    set(CMAKE_BUILD_TYPE Release)
+endif()
+
+# Static-link the MSVC runtime so the wheels carry no VC++ redistributable dependency.
+if(POLICY CMP0091)
+    cmake_policy(SET CMP0091 NEW)
+endif()
+if(MSVC)
+    set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
+    add_compile_options(/Zm1000)
+endif()
+
+# ---------------------------------------------------------------------------
+# Vendored OpenNest C++ engine sources (git submodule -> external/nest).
+# No CGAL / Boost / Eigen download: both engines are self-contained.
+# ---------------------------------------------------------------------------
+set(NEST_DIR "${CMAKE_CURRENT_SOURCE_DIR}/external/nest")
+set(PHYSICS_DIR "${NEST_DIR}/nest_physics_cpp")
+set(NFP_DIR "${NEST_DIR}/opennest_cpp")
+
+if(NOT EXISTS "${PHYSICS_DIR}/nest_physics_capi.cpp")
+    message(FATAL_ERROR
+        "OpenNest C++ sources not found at ${NEST_DIR}. "
+        "Initialise the submodule: git submodule update --init --recursive")
+endif()
+
+# ---------------------------------------------------------------------------
+# Python + nanobind
+# ---------------------------------------------------------------------------
+if(NOT SKBUILD)
+    message(WARNING "This CMake file is meant to be driven by scikit-build-core "
+                    "(pip install). Running it directly is unlikely to work.")
+endif()
+
+find_package(Python 3.9
+    REQUIRED COMPONENTS Interpreter Development.Module
+    OPTIONAL_COMPONENTS Development.SABIModule)
+
+find_package(nanobind CONFIG REQUIRED)
+
+# ===========================================================================
+# Module 1: _nest_physics  (collision / overlap-relaxation engine)
+#   Header-only solver; the C-API translation unit pulls it all in.
+# ===========================================================================
+nanobind_add_module(_nest_physics STABLE_ABI NB_STATIC
+    src/_nest_physics.cpp
+    "${PHYSICS_DIR}/nest_physics_capi.cpp")
+target_include_directories(_nest_physics PRIVATE "${PHYSICS_DIR}")
+if(NOT MSVC)
+    target_compile_options(_nest_physics PRIVATE -O3)
+endif()
+install(TARGETS _nest_physics LIBRARY DESTINATION compas_nest)
+
+# ===========================================================================
+# Module 2: _nfp_nest  (NFP + genetic-algorithm engine)
+#   Needs the vendored Clipper2 + nest_lib sources + the minimal Boost subset.
+# ===========================================================================
+set(NFP_SOURCES
+    src/_nfp_nest.cpp
+    "${NFP_DIR}/src/capi/nfp_nest_capi.cpp"
+    "${NFP_DIR}/src/GeometryUtil.cpp"
+    "${NFP_DIR}/src/MinkowskiConvolution.cpp"
+    "${NFP_DIR}/src/NfpWorker.cpp"
+    "${NFP_DIR}/src/GeneticAlgorithm.cpp"
+    "${NFP_DIR}/src/NestingEngine.cpp"
+    "${NFP_DIR}/src/NestingContext.cpp"
+    "${NFP_DIR}/src/clipper2/clipper.engine.cpp"
+    "${NFP_DIR}/src/clipper2/clipper.offset.cpp"
+    "${NFP_DIR}/src/clipper2/clipper.rectclip.cpp")
+
+nanobind_add_module(_nfp_nest STABLE_ABI NB_STATIC ${NFP_SOURCES})
+target_include_directories(_nfp_nest PRIVATE
+    "${NFP_DIR}/src"
+    "${NFP_DIR}/third_party/boost_min")
+if(MSVC)
+    target_compile_definitions(_nfp_nest PRIVATE _USE_MATH_DEFINES)
+    target_compile_options(_nfp_nest PRIVATE /wd4244 /wd4267 /wd4305)
+else()
+    target_compile_options(_nfp_nest PRIVATE -O3 -Wno-unused-parameter)
+endif()
+install(TARGETS _nfp_nest LIBRARY DESTINATION compas_nest)
+
+# ===========================================================================
+# Module 3: _clipper  (Clipper2 polygon offsetting for clearance)
+#   Reuses the Clipper2 sources vendored with the NFP engine.
+# ===========================================================================
+nanobind_add_module(_clipper STABLE_ABI NB_STATIC
+    src/_clipper.cpp
+    "${NFP_DIR}/src/clipper2/clipper.engine.cpp"
+    "${NFP_DIR}/src/clipper2/clipper.offset.cpp"
+    "${NFP_DIR}/src/clipper2/clipper.rectclip.cpp")
+target_include_directories(_clipper PRIVATE "${NFP_DIR}/src")
+if(MSVC)
+    target_compile_definitions(_clipper PRIVATE _USE_MATH_DEFINES)
+    target_compile_options(_clipper PRIVATE /wd4244 /wd4267 /wd4305)
+else()
+    target_compile_options(_clipper PRIVATE -O3 -Wno-unused-parameter)
+endif()
+install(TARGETS _clipper LIBRARY DESTINATION compas_nest)

compas_nest-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Petras Vestartas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

compas_nest-0.1.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.1
+Name: compas_nest
+Version: 0.1.0
+Summary: 2D irregular nesting (OpenNest) for COMPAS.
+Author-Email: Petras Vestartas <petrasvestartas@gmail.com>
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering
+Project-URL: Homepage, https://github.com/petrasvestartas/compas_nest
+Project-URL: Repository, https://github.com/petrasvestartas/compas_nest
+Requires-Python: >=3.9
+Requires-Dist: numpy>=1.24
+Requires-Dist: compas<3,>=2.15
+Description-Content-Type: text/markdown
+
+# compas_nest
+
+2D irregular nesting for the [COMPAS](https://compas.dev) framework — Python bindings for the
+[OpenNest](https://github.com/petrasvestartas/OpenNest) C++ engines, built with
+[nanobind](https://github.com/wjakob/nanobind) (the same toolchain as
+[compas_cgal](https://github.com/compas-dev/compas_cgal)).
+
+Nest polylines **with holes** into sheets **with holes**, with live terminal progress and
+[compas_viewer](https://github.com/compas-dev/compas_viewer) visualization.
+
+![compas_nest](docs/images/04_collision_dataset.gif)
+
+## Two engines
+
+| Class | Engine | Notes |
+|---|---|---|
+| `opennest_collision` | physics / overlap-relaxation (`np_nest`) | dependency-free; iteration-budget driven; nests parts into holes |
+| `opennest` | NFP + genetic algorithm (`nfp_nest`) | bundled Clipper2; generation/fitness driven; carries part *attributes* through placement |
+
+## Install
+
+```bash
+pip install compas_nest
+```
+
+### From source (editable)
+
+**One-step (uv, macOS + Windows Git Bash + Linux):** creates a local `.venv`, installs every
+dependency, and builds the package:
+
+```bash
+git clone --recurse-submodules https://github.com/petrasvestartas/compas_nest.git
+cd compas_nest
+bash bash/install.sh
+```
+
+After editing C++ sources, rebuild without recreating the env: `bash bash/build.sh --test`.
+
+**conda:**
+
+```bash
+conda env create -f environment.yml
+conda activate compas_nest
+pip install --no-build-isolation -ve .
+```
+
+**plain pip:**
+
+```bash
+pip install nanobind "scikit-build-core[pyproject]"
+pip install --no-build-isolation -ve .
+```
+
+The C++ engine sources live under `external/nest/` (`nest_physics_cpp/` + `opennest_cpp/`, the latter
+bundling Clipper2 and a minimal Boost subset). They are self-contained — no CGAL/Boost/Eigen download
+is needed.
+
+## Quick start
+
+```python
+from compas.geometry import Polyline
+from compas_nest import nest_geo, nest_sheets, opennest_collision
+
+def rect(x0, y0, w, h):
+    return Polyline([[x0, y0, 0], [x0+w, y0, 0], [x0+w, y0+h, 0], [x0, y0+h, 0], [x0, y0, 0]])
+
+geo = nest_geo()
+geo.add_part(rect(0, 0, 20, 10), copies=3)
+geo.add_part(rect(0, 0, 15, 15), holes=[rect(5, 5, 5, 5)], copies=2)
+
+sheets = nest_sheets()
+sheets.add_sheet(rect(0, 0, 100, 100), holes=[rect(40, 40, 10, 10)])
+
+result = opennest_collision(iterations=2000, num_rotations=64).solve(geo, sheets)
+
+for group in result.placed_polylines():
+    print("sheet", group["sheet_id"], "->", len(group["parts"]), "parts")
+
+# serialize placed polylines (with holes) + transformations to COMPAS JSON
+result.to_json("data/output/quickstart.json")
+```
+
+See the `examples/` folder for the viewer workflows, and the
+[documentation](https://petrasvestartas.github.io/compas_nest/) for examples, API reference and credits.
+
+## Credits
+
+`compas_nest` is the COMPAS / Python binding of the [OpenNest](https://github.com/petrasvestartas/OpenNest)
+C++ engines by **Petras Vestartas**, which build on SVGnest/Deepnest (NFP+GA), jagua-rs/sparrow (physics
+strip-packing), Clipper2 and Boost.Polygon. Full attributions: [docs/credits.md](docs/credits.md).
+
+## License
+
+MIT

compas_nest-0.1.0/README.md

@@ -0,0 +1,94 @@
+# compas_nest
+
+2D irregular nesting for the [COMPAS](https://compas.dev) framework — Python bindings for the
+[OpenNest](https://github.com/petrasvestartas/OpenNest) C++ engines, built with
+[nanobind](https://github.com/wjakob/nanobind) (the same toolchain as
+[compas_cgal](https://github.com/compas-dev/compas_cgal)).
+
+Nest polylines **with holes** into sheets **with holes**, with live terminal progress and
+[compas_viewer](https://github.com/compas-dev/compas_viewer) visualization.
+
+![compas_nest](docs/images/04_collision_dataset.gif)
+
+## Two engines
+
+| Class | Engine | Notes |
+|---|---|---|
+| `opennest_collision` | physics / overlap-relaxation (`np_nest`) | dependency-free; iteration-budget driven; nests parts into holes |
+| `opennest` | NFP + genetic algorithm (`nfp_nest`) | bundled Clipper2; generation/fitness driven; carries part *attributes* through placement |
+
+## Install
+
+```bash
+pip install compas_nest
+```
+
+### From source (editable)
+
+**One-step (uv, macOS + Windows Git Bash + Linux):** creates a local `.venv`, installs every
+dependency, and builds the package:
+
+```bash
+git clone --recurse-submodules https://github.com/petrasvestartas/compas_nest.git
+cd compas_nest
+bash bash/install.sh
+```
+
+After editing C++ sources, rebuild without recreating the env: `bash bash/build.sh --test`.
+
+**conda:**
+
+```bash
+conda env create -f environment.yml
+conda activate compas_nest
+pip install --no-build-isolation -ve .
+```
+
+**plain pip:**
+
+```bash
+pip install nanobind "scikit-build-core[pyproject]"
+pip install --no-build-isolation -ve .
+```
+
+The C++ engine sources live under `external/nest/` (`nest_physics_cpp/` + `opennest_cpp/`, the latter
+bundling Clipper2 and a minimal Boost subset). They are self-contained — no CGAL/Boost/Eigen download
+is needed.
+
+## Quick start
+
+```python
+from compas.geometry import Polyline
+from compas_nest import nest_geo, nest_sheets, opennest_collision
+
+def rect(x0, y0, w, h):
+    return Polyline([[x0, y0, 0], [x0+w, y0, 0], [x0+w, y0+h, 0], [x0, y0+h, 0], [x0, y0, 0]])
+
+geo = nest_geo()
+geo.add_part(rect(0, 0, 20, 10), copies=3)
+geo.add_part(rect(0, 0, 15, 15), holes=[rect(5, 5, 5, 5)], copies=2)
+
+sheets = nest_sheets()
+sheets.add_sheet(rect(0, 0, 100, 100), holes=[rect(40, 40, 10, 10)])
+
+result = opennest_collision(iterations=2000, num_rotations=64).solve(geo, sheets)
+
+for group in result.placed_polylines():
+    print("sheet", group["sheet_id"], "->", len(group["parts"]), "parts")
+
+# serialize placed polylines (with holes) + transformations to COMPAS JSON
+result.to_json("data/output/quickstart.json")
+```
+
+See the `examples/` folder for the viewer workflows, and the
+[documentation](https://petrasvestartas.github.io/compas_nest/) for examples, API reference and credits.
+
+## Credits
+
+`compas_nest` is the COMPAS / Python binding of the [OpenNest](https://github.com/petrasvestartas/OpenNest)
+C++ engines by **Petras Vestartas**, which build on SVGnest/Deepnest (NFP+GA), jagua-rs/sparrow (physics
+strip-packing), Clipper2 and Boost.Polygon. Full attributions: [docs/credits.md](docs/credits.md).
+
+## License
+
+MIT

compas_nest-0.1.0/bash/build.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+#
+# Rebuild compas_nest in the existing .venv after editing C++ sources, without
+# recreating the environment. Works on macOS and Windows (Git Bash).
+#
+#   bash bash/build.sh            # rebuild only
+#   bash bash/build.sh --test     # rebuild, then run pytest
+#
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$ROOT"
+
+case "$(uname -s)" in
+    MINGW*|MSYS*|CYGWIN*) OS=windows ;;
+    *) OS=other ;;
+esac
+
+if [ "$OS" = "windows" ]; then
+    VENV_PY="$ROOT/.venv/Scripts/python.exe"
+else
+    VENV_PY="$ROOT/.venv/bin/python"
+fi
+
+if [ ! -x "$VENV_PY" ] && [ ! -f "$VENV_PY" ]; then
+    echo "ERROR: .venv not found. Run 'bash bash/install.sh' first."
+    exit 1
+fi
+
+echo ">> Rebuilding compas_nest (editable) ..."
+if [ "$OS" = "windows" ]; then
+    VSW="C:/Program Files (x86)/Microsoft Visual Studio/Installer/vswhere.exe"
+    if [ -f "$VSW" ]; then
+        VSMAJOR="$("$VSW" -latest -property installationVersion 2>/dev/null | cut -d. -f1)"
+        case "$VSMAJOR" in
+            17) export CMAKE_GENERATOR="Visual Studio 17 2022" ;;
+            16) export CMAKE_GENERATOR="Visual Studio 16 2019" ;;
+            15) export CMAKE_GENERATOR="Visual Studio 15 2017" ;;
+        esac
+        export CMAKE_GENERATOR_PLATFORM=x64
+    fi
+fi
+uv pip install --python "$VENV_PY" --no-build-isolation -ve .
+
+if [ "${1:-}" = "--test" ]; then
+    echo ">> Running tests ..."
+    "$VENV_PY" -m pytest tests/ -q
+fi
+
+echo ">> Done."

compas_nest-0.1.0/bash/install.sh

@@ -0,0 +1,105 @@
+#!/usr/bin/env bash
+#
+# Create a local uv virtual environment (.venv), install all dependencies, and
+# build compas_nest in editable mode. Works on macOS and on Windows (run from
+# Git Bash). Linux works too.
+#
+#   bash bash/install.sh
+#
+# Options (environment variables):
+#   PYTHON_VERSION   Python to use for the venv (default: 3.12)
+#
+set -euo pipefail
+
+# --- locate the repo root (parent of this bash/ folder) ---------------------
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+cd "$ROOT"
+
+PYTHON_VERSION="${PYTHON_VERSION:-3.12}"
+
+# --- detect OS --------------------------------------------------------------
+case "$(uname -s)" in
+    Darwin*) OS=mac ;;
+    Linux*)  OS=linux ;;
+    MINGW*|MSYS*|CYGWIN*) OS=windows ;;
+    *) OS=unknown ;;
+esac
+echo ">> Platform: $OS   Python: $PYTHON_VERSION"
+
+# --- require uv -------------------------------------------------------------
+if ! command -v uv >/dev/null 2>&1; then
+    echo "ERROR: 'uv' is not installed or not on PATH."
+    if [ "$OS" = "windows" ]; then
+        echo "  Install it with:  powershell -c \"irm https://astral.sh/uv/install.ps1 | iex\""
+    else
+        echo "  Install it with:  curl -LsSf https://astral.sh/uv/install.sh | sh"
+    fi
+    exit 1
+fi
+
+# --- make sure the C++ engine submodule is present --------------------------
+if [ -f .gitmodules ]; then
+    echo ">> Initialising git submodules (external/nest) ..."
+    git submodule update --init --recursive
+fi
+if [ ! -f external/nest/nest_physics_cpp/nest_physics_capi.cpp ]; then
+    echo "ERROR: C++ engine sources missing at external/nest. Submodule init failed?"
+    exit 1
+fi
+
+# --- create the virtual environment -----------------------------------------
+echo ">> Creating uv virtual environment in .venv ..."
+uv venv --python "$PYTHON_VERSION" .venv
+
+if [ "$OS" = "windows" ]; then
+    VENV_PY="$ROOT/.venv/Scripts/python.exe"
+else
+    VENV_PY="$ROOT/.venv/bin/python"
+fi
+
+# --- install dependencies (build + runtime + viewer + tests) ----------------
+echo ">> Installing dependencies into .venv ..."
+uv pip install --python "$VENV_PY" \
+    nanobind>=2.12 \
+    "scikit-build-core[pyproject]>=0.10" \
+    cmake>=3.15 \
+    ninja \
+    "numpy>=1.24" \
+    "compas>=2.15,<3" \
+    compas_viewer \
+    pytest \
+    ruff
+
+# --- build + install compas_nest (editable) ---------------------------------
+echo ">> Building compas_nest (editable) ..."
+if [ "$OS" = "windows" ]; then
+    # Use the Visual Studio CMake generator: MSBuild locates the MSVC toolchain
+    # itself, so no vcvars / 'cmd' wrapper is needed (which is fragile from Git Bash).
+    VSW="C:/Program Files (x86)/Microsoft Visual Studio/Installer/vswhere.exe"
+    if [ -f "$VSW" ]; then
+        VSMAJOR="$("$VSW" -latest -property installationVersion 2>/dev/null | cut -d. -f1)"
+        case "$VSMAJOR" in
+            17) export CMAKE_GENERATOR="Visual Studio 17 2022" ;;
+            16) export CMAKE_GENERATOR="Visual Studio 16 2019" ;;
+            15) export CMAKE_GENERATOR="Visual Studio 15 2017" ;;
+        esac
+        export CMAKE_GENERATOR_PLATFORM=x64
+        echo ">> Using CMake generator: ${CMAKE_GENERATOR:-default}"
+    fi
+fi
+uv pip install --python "$VENV_PY" --no-build-isolation -ve .
+
+# --- verify -----------------------------------------------------------------
+echo ">> Verifying import ..."
+"$VENV_PY" -c "import compas_nest; from compas_nest import OpenNestCollision, OpenNest2; print('compas_nest', compas_nest.__version__, 'OK')"
+
+echo ""
+echo "Done. Activate the environment with:"
+if [ "$OS" = "windows" ]; then
+    echo "    source .venv/Scripts/activate      # Git Bash"
+    echo "    .venv\\Scripts\\activate            # PowerShell/cmd"
+else
+    echo "    source .venv/bin/activate"
+fi
+echo "Run the tests with:   bash bash/build.sh --test   (or 'pytest tests/' once activated)"