Dev

.devcontainer/DOCKER_README.md

@@ -0,0 +1,52 @@
+# Dev Container Setup
+
+This directory contains the configuration for a Docker-based development environment for Tessellator.
+
+## Quick Start
+
+### Prerequisites
+- Docker installed and running
+- VS Code with the "Dev Containers" extension
+
+### Opening the Project in Dev Container
+
+1. Open this repository in VS Code
+2. Click the green icon in the bottom-left corner and select **"Reopen in Container"**
+3. VS Code will build the Docker image and start the container automatically
+
+The entire workspace will be mounted at `/workspace` inside the container.
+
+## What's Included
+
+The dev container provides:
+- Pre-configured C++ development environment
+- CMake and Ninja build tools
+- All project dependencies (VTK, Boost, CGAL via vcpkg)
+- VS Code extensions:
+  - **C/C++ Tools** – Code navigation, IntelliSense, debugging
+  - **CMake Tools** – CMake project management
+  - **LLDB** – Debugger for C++
+
+## Building and Testing
+
+Once inside the container:
+
+```bash
+# Configure the project
+cmake --preset docker -S . -B build
+
+# Build
+cmake --build build -j
+
+# Run tests
+build/bin/tessellator_tests
+
+# Run the application
+build/bin/tessellator -i <input.tessellator.json>
+```
+
+## Notes
+
+- The container runs as root user
+- CMake is pre-configured to skip auto-configure on file open for better performance
+- Debugging with LLDB is enabled with appropriate capabilities

.devcontainer/Dockerfile.base

@@ -0,0 +1,34 @@
+FROM ubuntu:26.04
+
+RUN apt-get update && apt-get install -y \
+    build-essential \
+    cmake \
+    ninja-build \
+    git \
+    pkg-config \
+    curl \
+    wget \
+    zip \
+    unzip
+
+RUN apt-get install -y \
+    libboost-graph-dev \
+    libboost-program-options-dev \
+    libvtk9-dev \
+    nlohmann-json3-dev \
+    libgtest-dev \
+    libgmock-dev \
+    libgmp-dev \
+    libmpfr-dev
+
+RUN apt-get install -y \
+    libeigen3-dev \
+    libcgal-dev
+
+RUN apt-get install -y \
+    clangd
+
+RUN chown -R ubuntu:ubuntu /home/ubuntu
+
+USER ubuntu
+WORKDIR /home/ubuntu/dev

.devcontainer/devcontainer.json

@@ -0,0 +1,28 @@
+{
+  "name": "Tessellator",
+  "dockerFile": "Dockerfile.base",
+  "context": "..",
+  "remoteUser": "ubuntu",
+  "workspaceFolder": "/home/ubuntu/dev",
+  "mounts": [
+    "source=${localWorkspaceFolder},target=/home/ubuntu/dev,type=bind"
+  ],
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-vscode.cpptools",
+        "ms-vscode.cmake-tools",
+        "vadimcn.vscode-lldb",
+        "matepek.vscode-catch2-test-adapter",
+        "llvm-vs-code-extensions.vscode-clangd"
+      ],
+      "settings": {
+        "cmake.configureOnOpen": false,
+        "cmake.configureOnEdit": false,
+        "cmake.autoSelectActiveFolder": false,
+        "cmake.generator": "Ninja"
+      }
+    }
+  },
+  "runArgs": ["--cap-add=SYS_PTRACE", "--security-opt", "seccomp=unconfined"]
+}

.github/workflows/build-and-release.yml

@@ -5,7 +5,8 @@ on:
     branches:
       - main
 
-env:
+env: 
+  VCPKG_BINARY_SOURCES: "clear;x-gha,readwrite"
   WINDOWS_FILENAME: opensemba-tessellator-windows-x64.tar.gz
   LINUX_FILENAME: opensemba-tessellator-linux.tar.gz
 
@@ -27,7 +28,7 @@ jobs:
     strategy:
       matrix:
         preset: [
-          {"os": windows-latest, "name": "msbuild", "filename": "windows-x64"},
+          {"os": windows-2022, "name": "msbuild", "filename": "windows-x64"},
           {"os": ubuntu-latest, "name": "gnu", "filename": "linux"}
         ]
         build-type: ["Release"]
@@ -59,8 +60,17 @@ jobs:
         sudo apt-get update
         sudo apt-get install -y libvtk9-dev
 
+    - name: Export GitHub Actions cache environment variables
+      uses: actions/github-script@v7
+      with:
+        script: |
+          core.exportVariable('ACTIONS_CACHE_URL', process.env.ACTIONS_CACHE_URL || '');
+          core.exportVariable('ACTIONS_RUNTIME_TOKEN', process.env.ACTIONS_RUNTIME_TOKEN || '');
+
     - name: Setup vcpkg
       uses: lukka/run-vcpkg@v11
+      with:
+        vcpkgGitCommitId: eed289f6e06a5e7a5c9e6a729671b0a56af7dd69
 
     - name: Windows configure and build
       if: matrix.preset.name=='msbuild'

.github/workflows/build-and-test.yml

@@ -5,25 +5,31 @@ on:
     branches:
       - main
       - dev
-    
+
 concurrency:
   group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
   cancel-in-progress: true
+
+env: 
+  VCPKG_BINARY_SOURCES: "clear;x-gha,readwrite"
 
 jobs:
   builds-and-tests:
     strategy:
       matrix:
         preset: [
-          {"os": windows-latest, "name": "msbuild"},
-          {"os": ubuntu-latest, "name": "gnu"}
+          {"os": windows-2022, "name": "msbuild"},
+          {"os": ubuntu-latest, "name": "gnu"},
+          {"os": ubuntu-latest, "name": "gnu-cgal"}
         ]
-        build-type: ["Debug", "Release"]
+        build-type: ["Release"]
 
       fail-fast: false
 
     name: ${{ matrix.preset.os }} / ${{matrix.preset.name}} / ${{matrix.build-type}}
     runs-on: ${{ matrix.preset.os }}
+    env:
+      VCPKG_BINARY_SOURCES: clear
 
     steps:
     - name: checkout repository
@@ -45,28 +51,54 @@ jobs:
         sudo apt-get update
         sudo apt-get install -y libvtk9-dev
 
+    - name: Export GitHub Actions cache environment variables
+      uses: actions/github-script@v7
+      with:
+        script: |
+          core.exportVariable('ACTIONS_CACHE_URL', process.env.ACTIONS_CACHE_URL || '');
+          core.exportVariable('ACTIONS_RUNTIME_TOKEN', process.env.ACTIONS_RUNTIME_TOKEN || '');
+
     - name: Setup vcpkg 
       uses: lukka/run-vcpkg@v11
+      with:
+        vcpkgGitCommitId: eed289f6e06a5e7a5c9e6a729671b0a56af7dd69
 
     - name: Windows configure and build
       if: matrix.preset.name=='msbuild'
       run: |
-        cmake --preset ${{matrix.preset.name}} -S . -B build
+        $configured = $false
+        for ($attempt = 1; $attempt -le 3; $attempt++) {
+          cmake --preset ${{matrix.preset.name}} -S . -B build
+          if ($LASTEXITCODE -eq 0) {
+            $configured = $true
+            break
+          }
+          if ($attempt -lt 3) {
+            Write-Host "Configure failed (attempt $attempt/3). Retrying in 20 seconds..."
+            Start-Sleep -Seconds 20
+          }
+        }
+        if (-not $configured) { exit 1 }
         cmake --build build --config ${{matrix.build-type}} -j
 
     - name: Windows Run tests
       if: matrix.preset.name=='msbuild'
       run: build/bin/${{matrix.build-type}}/tessellator_tests.exe
 
     - name: Ubuntu configure and build
-      if: matrix.preset.name=='gnu'
+      if: matrix.preset.os=='ubuntu-latest'
       run: |
-        cmake --preset ${{matrix.preset.name}} -S . -B build
+        configured=0
+        for attempt in 1 2 3; do
+          cmake --preset ${{matrix.preset.name}} -S . -B build && configured=1 && break
+          if [ "$attempt" -lt 3 ]; then
+            echo "Configure failed (attempt $attempt/3). Retrying in 20 seconds..."
+            sleep 20
+          fi
+        done
+        [ "$configured" -eq 1 ] || exit 1
         cmake --build build -j
 
     - name: Ubuntu Run tests
-      if: matrix.preset.name=='gnu'
+      if: matrix.preset.os=='ubuntu-latest'
       run: build/bin/tessellator_tests
-
-
-

.gitignore

@@ -8,11 +8,15 @@ build/
 .settings
 .project
 .cproject
+.cache
 
 src/*.json
 
 .vs/
-.vscode/
+.vscode/settings.json
+.vscode/settings.dev.json
+.vscode/launch.json
+.vscode/tasks.json
 
 testData/*_out.stl
 *_out.stl
@@ -25,4 +29,5 @@ CMakeUserPresets.json
 sliced.vtk
 contour.vtk
 
-testData/
+testData/
+build

.vscode/launch.json

@@ -0,0 +1,105 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Debug Tessellator (Docker)",
+            "type": "lldb",
+            "request": "launch",
+            "program": "${workspaceFolder}/build-dbg/bin/tessellator",
+            "args": ["-i", "${workspaceFolder}/testData/cases/cone/cone.tessellator.json"],
+            "stopOnEntry": false,
+            "cwd": "${workspaceFolder}",
+            "env": {}
+        },
+        {
+            "name": "Debug Tests (Docker)",
+            "type": "lldb",
+            "request": "launch",
+            "program": "${workspaceFolder}/build-dbg/bin/tessellator_tests",
+            "args": ["--gtest_filter=*"],
+            "stopOnEntry": false,
+            "cwd": "${workspaceFolder}",
+            "env": {},
+            "sourceMap": {}
+        },
+        {
+            "name": "Debug Tests (Docker) - Specific Suite",
+            "type": "lldb",
+            "request": "launch",
+            "program": "${workspaceFolder}/build-dbg/bin/tessellator_tests",
+            "args": ["--gtest_filter=${input:testSuite}"],
+            "stopOnEntry": false,
+            "cwd": "${workspaceFolder}",
+            "env": {},
+            "sourceMap": {},
+        },
+        {
+            "name": "tessellator (gdb)",
+            "type": "cppdbg",
+            "request": "launch",
+            "program": "${workspaceFolder}/build-dbg/bin/tessellator",
+            "args": ["-i", "testData/cases/alhambra/alhambra.tessellator.json"],
+            "stopAtEntry": false,
+            "cwd": "${workspaceFolder}",
+            "environment": [],
+            "externalConsole": false,
+            "MIMode": "gdb",
+            "visualizerFile": [
+                "${workspaceFolder}/resources/Eigen.natvis",
+                "${workspaceFolder}/resources/nlohmann_json.natvis"
+            ],
+            "additionalSOLibSearchPath": "",
+            "showDisplayString": true,
+            "setupCommands": [
+                {
+                    "description": "Enable pretty-printing for gdb",
+                    "text": "-enable-pretty-printing",
+                    "ignoreFailures": true
+                },
+                {
+                    "description": "Set Disassembly Flavor to Intel",
+                    "text": "-gdb-set disassembly-flavor intel",
+                    "ignoreFailures": true
+                }
+            ]
+        },
+        {
+            "name": "tessellator_tests (gdb)",
+            "type": "cppdbg",
+            "request": "launch",
+            "program": "${workspaceFolder}/build-dbg/bin/tessellator_tests",
+            "args": [],
+            "stopAtEntry": false,
+            "cwd": "${workspaceFolder}",
+            "environment": [],
+            "externalConsole": false,
+            "MIMode": "gdb",
+            "visualizerFile": [
+                "${workspaceFolder}/resources/Eigen.natvis",
+                "${workspaceFolder}/resources/nlohmann_json.natvis"
+            ],
+            "additionalSOLibSearchPath": "",
+            "showDisplayString": true,
+            "setupCommands": [
+                {
+                    "description": "Enable pretty-printing for gdb",
+                    "text": "-enable-pretty-printing",
+                    "ignoreFailures": true
+                },
+                {
+                    "description": "Set Disassembly Flavor to Intel",
+                    "text": "-gdb-set disassembly-flavor intel",
+                    "ignoreFailures": true
+                }
+            ]
+        }
+    ],
+    "inputs": [
+        {
+            "id": "testSuite",
+            "type": "promptString",
+            "description": "Enter test filter (e.g., StaircaseMesherTest.* or StaircaseMesherTest.TestName)",
+            "default": "*"
+        }
+    ]
+}