v3.4.0

This is a major release with many bug fixes, performance improvements, updates to the TypeScript API, and ManifoldCAD. Notable changes:

• Added MinkowskiSum and MinkowskiDifference, but note that the current implementation performs many union operations. It may be slow and memory-intensive for complex meshes.
• MeshIO is removed from our public API. Users should use libraries such as Trimesh for Python and assimp for C++. The MeshIO code is still available as an example for interfacing with assimp.
• ManifoldCAD can now import and operate on glTF models! It can also display 2D CrossSections and non-manifold imports. The documentation is also vastly improved, for both ManifoldCAD scripts, and the underlying TS API for those wanting to build their own tool.

New Features

• Add MinkowskiSum and MinkowskiDifference, by @zalo in #666.

API Updates

• manifoldc minor API fixes, by @geoffder in #1455.
• Deprecate Manifold.compose() in WASM bindings, by @tonious in #1487.
• Deprecate compose, by @pca006132 in #1489.
• Add C-binding functions to access the normalIdx parameter of GetMeshGL/GetMeshGL64, by @WNP78 in #1494.
• Make MeshIO private, by @pca006132 in #1529.

Algorithm Improvements and Fixes

• Cleanup of Boolean3, by @elalish in #1443.
• Fix determinism, by @pca006132 in #1452.
• New symbolic perturbation, by @elalish in #1445.
• Fix SplitPinchedVerts parallelization, by @pca006132 in #1456.
• Boolean3 performance optimization, by @pca006132 in #1457.
• Fix create halfedges, by @pca006132 in #1472.
• Lazy collider, by @pca006132 in #1473.
• Fix face normals, by @elalish in #1475.
• Share halfedge, by @pca006132 in #1478.
• Minor optimizations, by @pca006132 in #1480.
• Avoid copies and add more tracing, by @pca006132 in #1481.
• Fix excessive memory usage in batch union operations, by @zalo in #1495.
• Fix negative offset circular segment calculation, by @pca006132 in #1511.
• Fix degenerate hulls, by @pca006132 in #1512.
• Make keyholing more robust in triangulator, by @elalish in #1528.
• Fix lazy collider, by @Trzeth in #1540.
• Fix Cylinder(h, 0, r) to support cone with apex at bottom, by @AnshulPatil2005 in #1541.

Build System

• Added MANIFOLD_STRICT flag, by @pca006132 in #1438.
• -ffp-contract=off for clang too, by @pca006132 in #1476.

ManifoldCAD.org / JS / TS / WASM

• Removed gl-matrix and updated examples, by @elalish in #1429.
• Ensure that Manifold timing message includes deferred operations, by @tonious in #1439.
• Export internal type modules for TypeScript portability, by @Loosetooth in #1446.
• Import glTF models into manifoldCAD, by @tonious in #1434, #1461, #1505, #1514.
• Compatibility fixes, by @tonious in #1449, #1451, #1453, #1454.
• TypeScript Documentation Overhaul, by @tonious in #1484, #1488, #1492, #1497.
• Use worker bundled via esbuild, by @tonious in #1486.
• Update NPM dependencies, by @tonious in #1436, #1499.
• Fix Minkowski JS Bindings and TypeScript 5.9 compatibility in gltf-io.ts, by @zalo in #1501.
• Update esbuild.mjs to work with emscripten v5, by @neilpa in #1508.
• Make CrossSections visible, by @tonious in #1507.
• Separate Editor and Examples for clarity, by @tonious in #1536, #1535, #1533.
• Fix js bindings for manifold.simplify() with default parameters, by @dsafa in #1543.

Tests and CI

• Stop using deprecated macos-13 images in CI, by @coryrc in #1442.
• Add test with props, by @stephomi and @elalish in #1465.
• Add perturbation test, by @elalish in #1467.
• Add reproducer for issue 1498, by @pca006132 in #1469.
• Disable flakey esm.sh test, by @tonious in #1513.
• Properly integrate manifold_test into ctest, by @coryrc in #1520.
• Fix tests, by @elalish in #1532.

Miscellaneous

• Add SKAPA to Users in README, by @nmattia in #1431.
• Remove CLA requirement from CONTRIBUTING.md, by @coryrc in #1441.
• Add Otterplans to users in README, by @mathieucivel in #1483.
• Nits: Put the links in the body and header in README, by @coryrc in #1517.
• Add Bracket Engineer to users, by @wesbos in #1519.
• Create a template for launching f3d from c++, by @coryrc in #1523.

New Contributors

• @coryrc made their first contribution in #1441.
• @mathieucivel made their first contribution in #1483.
• @WNP78 made their first contribution in #1494.
• @wesbos made their first contribution in #1519.
• @AnshulPatil2005 made their first contribution in #1541.

v3.3.2

Just fixing npm and PyPI publishing.

v3.3.1

Bug Fixes - all for npm

• Loading types should not create new scripts. by @tonious in #1420
• Run npm install before npm publish by @tonious in #1421
• fix gear examples by @elalish in #1423
• Correct CLI and add tests. by @tonious in #1425

v3.3.0

The big theme of this release is a major expansion of our npm module to now expose the script-runner of ManifoldCAD.org to any Node project or website that wants to use it. It even comes in a CLI flavor now that you can use like npx manifold-cad. There have been a number of breaking changes to ManifoldCAD.org scripts, primarily that the classes now need to be explicitly imported and the results explicitly exported. However, now we can import libraries universally, from node installs, from CDNs, and even from local scripts you write on ManifoldCAD.org! A huge thank you to @tonious for making all this happen.

ManifoldCAD / JS / TS / WASM

• Repackage WASM dynamic evaluation and mesh export by @tonious in #1329
• Refactor WASM state and export. by @tonious in #1351
• Make evaluator asynchronous, and other small TS tweaks. by @tonious in #1360
• Remediate top level async calls. by @tonious in #1375
• Refactor worker.ts by @tonious in #1380
• Set extension on worker.ts imports. by @tonious in #1384
• Fall back to packaged type files if not built. by @tonious in #1389
• Transform static imports to dynamic by @tonious in #1387
• Isomorphic Javascript Libraries by @tonious in #1392
• Add specific error messages in wasm bindings. by @tonious in #1396
• Automagically bundle manifoldCAD.d.ts by @tonious in #1397
• Add missing declarations. by @tonious in #1398
• Fetch remote types. by @tonious in #1399
• Small bundler improvements. by @tonious in #1400
• Require explicit imports in/of manifoldCAD by @tonious in #1401
• Refactor stack trace handling. by @tonious in #1403
• Remove GlobalDefaults object. by @tonious in #1408
• Assume virtual files are typescript by @tonious in #1410
• updated involute gear library and exmaple by @elalish in #1416
• Update tests. by @tonious in #1417

Bug Fixes

• fix csg tree bug by @pca006132 in #1383

Build/CI Updates

• Use Python_EXECUTABLE from FindPython instead of hardcoding the command by @darix in #1328
• Add missing header to build on mac osx with clang by @EstebanDugueperoux2 in #1332
• fix Build error on Debian 11 by @Trzeth in #1336
• Fix install with static link and using builtin dependencies by @pca006132 in #1341
• added test from #1309 by @elalish in #1345
• fix single point import by @Trzeth in #1349
• make MANIFOLD_USE_BUILTIN_TBB opt-in by @pca006132 in #1379
• using static_cast in ImportMesh to support assimp with double-precision by @surrim in #1391

New Contributors

• @darix made their first contribution in #1328
• @EstebanDugueperoux2 made their first contribution in #1332
• @tonious made their first contribution in #1329
• @mmiscool made their first contribution in #1357
• @surrim made their first contribution in #1391

v3.2.1

Patch update with a few (important) bug fixes.

Bug Fixes

• Fix downstream builds by @pca006132 in #1302
• Add MANIFOLD_FOUND cmake variable by @Trzeth in #1307
• Fix Manifold.Simplify test on intel macos by @Trzeth and @pca006132 in #1311 and #1322 (the real fix is probably the one below)
• Fix broken halfedge pairing by @pca006132 in #1319
• Make batch boolean deterministic by @pca006132 in #1321
• Fix odr violation by @pca006132 in #1323

Misc

• Add old version gcc to CI by @Trzeth in #1308
• Add Cadova to users by @tomasf in #1312
• Fix faceID documentation in wasm bindings by @jirihon in #1317
• Disable async free when asan is enabled by @pca006132 in #1325

v3.2.0

Bug Fixes

• Make GCC floating-point operations standard conforming by @pca006132 in #1273
• Add missing Manifold.simplify() method to Python API by @jonathanhogg in #1282
• Fixed meshID regression by @elalish in #1287
• Fix pyi vert_properties type by @Trzeth in #1291
• Update Clipper2 to 1.5.4 and fix CrossSection::Offset by @Trzeth in #1292
• Skip halfedges that are removed by @pca006132 in #1296
• Fix stubgen path by @Trzeth in #1301
• Add cmake check for fp related options by @pca006132 in #1300

Performance Improvements

• Misc performance improvements by @pca006132 in #1269
• Use union-find for winding number by @pca006132 in #1271
• Faster halfedge pairing for large meshes by @pca006132 in #1279

Misc

• Use cmake4 in the CI by @pca006132 in #1274
• Add Arcol to README.md by @prideout in #1286
• Add Bento3D to README.md by @sorashin in #1288
• Add fuzzing instructions by @pca006132 #1214
• Add JoinType.Bevel by @elektrohenk in #1299

New Contributors

• @prideout made their first contribution in #1286
• @sorashin made their first contribution in #1288
• @elektrohenk made their first contribution in #1299

v3.1.1

Bug fix

• Fix crashing on an empty MeshGL with one runIndex element by @gongpha in #1261

New Contributors

• @gongpha made their first contribution in #1261

v3.1.0

Thanks @howardt for all the reports and API discussions - the improvements made to unblock Blender's adoption will definitely benefit our whole user community. And thank you to all our contributors, both new and old! There are lots of fixes here, especially around handling properties, faces, and decimation, as well as significant performance improvements. Take a close look at the New Features section, as a few of them might be considered minor breaking changes, or at least behavior to be aware of.

New Features

• Added Simplify() for decimation by @elalish in #1147, #1246
• unified ManifoldParams and PolygonParams by @pca006132 in #1167
• make boolean deterministic by @pca006132 in #1187
• simple 64-bit OBJ debug dump by @pca006132 in #1190
• Make API for high precision OBJ I/O method by @starseeker in #1219, #1226
• Don't simplify unless requested by @elalish in #1185
• use input faceID by @elalish in #1241, #1232
• default offset to round by @elalish in #1257

Bindings

• Add const keyword to CrossSection::Compose parameter by @tomasf in #1129
• Add Manifold-Swift to Bindings & Packages in README by @tomasf in #1133
• fix default JS parameter binding for simplify by @elalish in #1146
• ARM Wheels by @johnnynunez in #1180
• Changed the delete memory operation to a destructure in the Merge C binding by @strich in #1196
• Fix triangulate js bindings by @jirihon in #1216
• Update ts definitions by @Kaladum in #1236
• wasm: use string status by @pca006132 in #1256

Bug Fixes

• Better faces by @elalish in #1040
• Early return when result size too large by @pca006132 in #1166
• Fix face removal (#1191) by @pca006132 in #1192
• Fix empty slice by @pca006132 in #1199
• Fix Revolve clipping by @elalish in #1200
• use more precise acos function by @pca006132 in #1201
• Fix Cross Section Mirror and add Test by @michael-j-faulkner in #1206
• Fix triangulator handling of splinters by @elalish in #1205
• Fix determinism by @Trzeth in #1234
• Fix intersection behavior in CrossSection::BatchBoolean by @tomasf in #1247
• fixed coplanar property collapse by @elalish in #1255

Performance Improvements

• Faster import by @pca006132 in #1139
• edge_op: quit CollapseEdge early if possible by @pca006132 in #1152
• parallelize mesh fixup by @pca006132 in #1148
• kdtree (2D) for collider by @pca006132 in #1160
• avoid sparse indices by @pca006132 in #1186
• parallel CreateHalfedges by @pca006132 in #1188

Build/CI Updates

• python: add ninja build dependency by @pca006132 in #1128
• Fix misc by @pca006132 in #1143
• fix linalg.h by @pca006132 in #1155
• Misc changes by @pca006132 in #1162
• fix a bunch of warnings by @pca006132 in #1194
• set cmake version in macos action by @pca006132 in #1207
• Suppress quickhull.cpp warnings with g++ compiler by @starseeker in #1218
• Remove per-error hacks in favor of a "disable Werror" option by @starseeker in #1223
• added MANIFOLD_ASSERT by @elalish in #1225
• bump CI ubuntu version by @elalish in #1230
• Add include for cstdint by @BenLubar in #1253

Tests

• Ember tests by @howardt in #1184
• In-loop Status calls were a work-around - see if #1205 solved it. by @starseeker in #1212
• Add test target to CMake by @diizzyy in #1244
• Add test for CrossSection::BatchBoolean by @Trzeth in #1249

Documentation

• improved MeshGL docs by @elalish in #1178
• updated status doc by @elalish in #1210
• Add PythonOpenSCAD and AnchorSCAD as 'users'. by @owebeeone in #1231
• Update README.md by @james-bern in #1228
• Update README.md by @elalish in #1237
• Update README.md by @diizzyy in #1245
• Clarify WASM objects to delete by @nmattia in #1254

New Contributors

• @tomasf made their first contribution in #1129
• @howardt made their first contribution in #1184
• @johnnynunez made their first contribution in #1180
• @strich made their first contribution in #1196
• @michael-j-faulkner made their first contribution in #1206
• @owebeeone made their first contribution in #1231
• @Trzeth made their first contribution in #1234
• @Kaladum made their first contribution in #1236
• @diizzyy made their first contribution in #1244
• @BenLubar made their first contribution in #1253
• @nmattia made their first contribution in #1254

v3.0.1

Bindings

• fix bug JS binding for project() by @elalish in #1071
• feat: add C binding for Manifold::NumProp() by @NickUfer in #1078
• fix: change manifold_calculate_normals min_sharp_angle type to double by @NickUfer in #1085

Bug Fixes

• casting issue in debug mode by @JeffreyWardman in #1077
• Fix DedupePropVerts by @elalish in #1092
• fix meshIO alpha type by @elalish in #1101
• Fixed unreferenced vert seg fault by @elalish in #1110

Performance Improvements

• avoid recursion in csg tree by @pca006132 in #1086, #1103, #1127
• finer timing in ManifoldCAD.org by @elalish in #1099

Build/CI Updates

• Fix publishing by @elalish in #1056
• Fix action by @pca006132 in #1059
• parallel.h is private again, so we can make iters.h private as well. by @starseeker in #1061
• fix download-artifact by @elalish in #1062
• update cibuildwheels version by @pca006132 in #1063
• fix codecov by @elalish in #1032, #1068, #1069
• cancel in-progress runs upon new push by @pca006132 in #1065
• Enable emscripten build with parallelization by @pca006132 in #1045, #1079
• make format run in parallel by @pca006132 in #1080
• run tests for nix by @pca006132 in #1094
• refactor(1089): update index types from int to size_t by @NickUfer in #1090, #1106
• Allow Clipper2 to be supplied externally when using Manifold as a submodule by @kintel in #1115
• python: update nanobind version requirement by @pca006132 in #1120
• setup dependabot by @pca006132 in #1121
• wasm: update package-lock by @pca006132 in #1124
• CI updates by @pca006132 in #1123

Tests

• boolean debugging by @pca006132 in #1104
• update fuzztest by @pca006132 in #1112

Documentation

• Update README.md by @elalish in #1060
• Added Valence 3D to Users in README.md by @rezaali in #1074
• add user bitbybit by @elalish in #1098
• add vcpkg to readme by @JeffreyWardman in #1108

New Contributors

• @rezaali made their first contribution in #1074
• @JeffreyWardman made their first contribution in #1077

v3.0.0

This is a huge release! We've packed in all the requested breaking changes to put us on a solid path of API stability going forward. We have removed all of our required dependencies (no more Thrust or GLM!) and dramatically simplified our directory structure and CMake. We have upgraded internally to double precision and added MeshGL64 for those who need to access it. And we have simplified and improved the API in many ways and added a few powerful new features. Please check out our new and improved C++ and TypeScript docs pages!

Breaking Changes

• Use size_t instead of int across our API, @pca006132 in #833
• Made CrossSection (and Clipper2 dependency) optional, @elalish in #850
• Removed Thrust dependency, use optional TBB instead, @elalish, @pca006132 in #852, #856, #857
• Moved LevelSet() in as a static member of Manifold, @elalish in #876, #894
• Upgraded from single to double precision, @pca006132 in #895
• Simplify directory structure, @pca006132, @starseeker in #918, #961
• Remove property tolerance, @elalish in #935
• Remove Mesh, @elalish in #950
• Overhaul our CMake, @starseeker in #961, #965, #967, #980, #990, #1005
• Replace GLM with linalg - down another dependency, @elalish in #984
• Separate coplanarity from faceID, @elalish in #991
• Split Precision into Epsilon and Tolerance, @pca006132, @elalish in #997, #1008, #1007
• Switched property indexing from vector to scalar, @elalish in #1016
• Replace GetProperties() with Volume() and SurfaceArea(), @elalish in #1022
• SDF boundary cleanup, @elalish in #1037
• Disable exceptions by default, @elalish in #1044

New Features

• SDF interpolation, @elalish in #866
• Add MeshGL64, @pca006132 in #927, #1038
• Add RefineToTolerance(), @elalish in #938
• Add SetTolerance(), @pca006132 in #997

Bindings

• Fix missing 'this' for property access in wasm bindings, @dsafa in #914
• wasm: fix CrossSection slice and project bindings, @neilpa in #930
• Expose Quality::ResetToDefaults() via C bindings, @NickUfer in #964
• Wasm: update CrossSection.toPolygons() return value to match type, @dsafa in #963
• Expose allocation functions via C bindings, @NickUfer in #968
• Fix python binding, @pca006132 in #987
• Fixed memory leak in C bindings, @pca006132 in #1018
• Added some missing C and JS bindings, @elalish in #1023
• Added C bindings for Triangulate(), @james-bern in #1034

Bug Fixes

• Triangulation fix, @elalish in #850
• Propagate errors, @pca006132 in #940
• Removed RotateUp and uint, @elalish in #1000
• Fix data races, @pca006132 in #1019
• Fix properties regression, @elalish in #1051

Performance Improvements

• Normal calculation optimization, @pca006132 in #934
• Removed face from halfedge, @pca006132 in #939
• Collider optimization, @pca006132 in #978
• Removed deterministic param, @elalish in #1033
• Free temporary vectors earlier, @pca006132 in #1047

Build/CI Updates

• Avoid Wundef trigger, @starseeker in #861
• Update to emscripten 3.1.61, @elalish in #860
• Fix debug mode msvc build error, @pca006132 in #863
• Fix shadowing warning, @elalish in #867
• Rename operator""_z to _uz, @BenFrantzDale in #869
• Make collider header-only, @pca006132 in #871
• Improve our CMake, @cjmayo in #880, #888, #899, #946, #948, #1002, #1029
• C bindings are required to build Python package, @jonathanhogg in #883
• Remove QuickHull dependency, @Kushal-Shah-03 (through GSoC) in #881, #875, #893, #904, #908
• Add *.pc file for easier use in non-cmake environments, @hzeller in #901
• Enable MeshIO/MANIFOLD_EXPORT in flake, @reinux in #912
• Make cross_section an installable library, @hzeller in #915
• Fix test-{cmake,pkgconfig}.sh to create, not append, to test files, @hzeller in #919
• Use mxe to cross compile to windows, @pca006132 in #924
• Fix deployment, @elalish in #937
• Cleanup, @wtholliday in #954, #955, #956, #985
• Use nanobind builtin stubgen, @pca006132 in #949
• Format cmake files, @pca006132 in #975
• Remove CGAL comparisons, @elalish in #1009
• Fix atomic exchange template deduction, @pca006132 in #1035
• Remove OneDPL, @pca006132 in #1042
• Manifold CMake alias, @pca006132 in #1049
• Provide a numeric version number to compare against, @hzeller, @pca006132 in #1054, #1055

Tests

• Fixed test flake, @cjmayo in #848
• Fix hull_test isMeshConvex() vertices check, @cjmayo in #898
• Use custom file format for polygon tests, @pca006132 in #913
• Define a test for simple offset booleans, @starseeker in #998

Documentation

• Update README, @cjmayo, @elalish in #892, #920, #1015, #1025
• Implemented typedoc documentation for WASM bindings, @msantic in #907
• Doxygen updates, @elalish in #1014, #1020, #1043

New Contributors

• @BenFrantzDale made their first contribution in #869
• @jonathanhogg made their first contribution in #883
• @Kushal-Shah-03 made their first contribution in #875
• @hzeller made their first contribution in #901
• @reinux made their first contribution in #912
• @dsafa made their first contribution in #914
• @msantic made their first contribution in #907
• @neilpa made their first contribution in #930
• @wtholliday made their first contribution in #954
• @NickUfer made their first contribution in #964
• @james-bern made their first contribution in #1034

Full Changelog: v2.5.1...v3.0.0