Migrate Replicad to OCCT v8 bindings by rifont · Pull Request #263 · sgenoud/replicad

rifont · 2026-06-14T09:44:54Z

Summary

Migrates Replicad's OpenCascade.js bindings and TypeScript wrapper usage to the OCCT v8 API surface.
Adds generated single-threaded and multi-threaded WASM builds under packages/replicad-opencascadejs/dist, with package exports for the default single build and the ./multi subpath.
Updates Replicad shape, curve, projection, mesh extraction, STEP export, tests, studio, CLI, evaluator, and app-example consumers for the new package exports and OCCT constructor/method names.
Adds a small app-example Vite worker config fix so the ESM OCJS worker build can code-split successfully.

Reviewer notes

Opened as a draft from the existing taucad:main branch as requested, preserving the current commit stack rather than squashing or creating a new PR branch.
The package metadata currently uses the Tau fork package names (@taucad/replicad, @taucad/replicad-opencascadejs) and Tau repository URLs. This likely needs maintainer discussion before the PR is marked ready for upstream.
docs/occt-v8-migration.md still says the multi-threaded build was removed/deferred, but this branch adds replicad_multi.* artifacts and ./multi exports. That doc should be reconciled before final review.
The generated WASM/type/symbol artifacts dominate the diff; source review should focus first on packages/replicad/src, packages/replicad-opencascadejs/build-source, and the package export/import changes.

Test plan

Risks

High review surface area: this is a large generated-artifact and API migration PR rather than a small feature patch.
Package identity and publication semantics need upstream maintainer confirmation because the current branch is configured for Tau-scoped beta packages.
Browser builds pass, but studio/app-example still emit warnings for dependency externals, duplicate WASM emission, large chunks, and old Browserslist data.
Docker rebuild of the OCJS WASM artifacts was not rerun during this PR prep; validation used the committed generated artifacts.

AI Disclosure

AI assistance used: yes
Model: GPT-5 Codex
Scope of AI assistance: diff review, validation, one app-example build fix, and PR drafting
Human verification: draft PR opened for human maintainer review; local validation commands above were run before submission

Rebuilt both WASM variants against OCCT V8 with -O3 optimization: - replicad_single: compact build without exception support (18.96 MB) - replicad_with_exceptions: full build with native WASM exceptions (22.22 MB) Also includes replicad source updates for OCCT V8 API compatibility. Made-with: Cursor

…opt optimization

…ollection equivalents

…generation

…ngle YAML

…egment2d

…xtractors

orts and add multi-threaded build

Reconciles upstream v0.21.1..v0.23.3 (mesh shape import/export, replicad evaluator + node CLI, sketch.revolve angle param, draft angle, projection approximation fixes, isShape3D chaining) with taucad fork customizations (OCCT V8 dual-WASM binding, suffix-free OCJS symbols, ESM sub-path exports, PBR/material density export, native C++ mesh extractors). Conflict resolutions: - packages/replicad/package.json: keep @taucad/replicad name + version 0.23.3-beta.0; replicad-opencascadejs stays a workspace dependency (not the upstream ^0.23.0 devDep). - packages/replicad-opencascadejs/*: keep fork dist/-based packaging, single+multi build configs; honor fork deletion of src/*.wasm/*.d.ts and custom_build_with_exceptions.yml. - src/lib2d/approximations.ts: adopt upstream bounded BSpline->Bezier conversion (handle, U1, U2, tol) via the fork's suffix-free Geom2dConvert_BSplineCurveToBezierCurve symbol. - src/shapes.ts: union of imports (asDir/makePln/makePlane/BRepAdaptor_Surface) in fork style. - src/sketches/CompoundSketch.ts: adopt upstream revolve() angle parameter. - peripheral packages (studio, replicad-app-example, pnpm-lock): keep fork. Co-authored-by: Cursor <cursoragent@cursor.com>

…rameters

sgenoud

This is great!

I know this is still just a draft, but I wanted to have a look to guide your next step!

Thanks for the work

sgenoud · 2026-06-19T06:43:47Z


 // We import our model as a simple function
-import { drawBox } from "./cad";
+import { drawBox } from './cad';


Make sure you run prettier (with default config) to keep the same quotes than before.

sgenoud · 2026-06-19T06:44:06Z

-    "replicad-opencascadejs": "^0.23.0",
-    "replicad-threejs-helper": "^0.23.0",
+    "replicad": "^0.21.0",
+    "replicad-opencascadejs": "workspace:@taucad/replicad-opencascadejs@^",


I think this needs to change

sgenoud · 2026-06-19T06:45:20Z

+//      same tolerance/angularTolerance budget as the face mesher.
+//
+// `seenEdges` deduplicates edges shared between adjacent faces so a single
+// shared edge contributes exactly one polyline.


Is there a way this could be maintained in another repo?

sgenoud · 2026-06-19T06:47:02Z

+  bindings: #@ data.values.bindings
+  emccFlags: #@ data.values.buildFlags
+
+additionalCppFiles:


I really like that this is in files instead of inline. This could help making it more maintainable as well!

sgenoud · 2026-06-19T06:47:44Z

+    - -msimd128
    - -O3

+  # Legacy inline C++ kept for reference; wrapper .cpp files in build-config/wrappers/ are used instead.


The git history is here for reference, we can remove this entirely.

sgenoud · 2026-06-19T06:51:57Z

+
+  return handle as T;
+};
+


Is there a reason to build this helper?

sgenoud · 2026-06-19T06:55:36Z


    if (curveType === "BEZIER_CURVE") {
-      const b = adaptor.Bezier().get();
+      const b = adaptor.Bezier();


Can you explain me how the dynamic pointers have changed with v8? We might need to do some additional memory management (with the previous way when a resource was using one of these it would be freed automatically I think).

sgenoud · 2026-06-19T07:00:56Z

@@ -477,110 +433,34 @@ export class Shape<Type extends TopoDS_Shape> extends WrappingObj<Type> {
    lines: number[];
    edgeGroups: { start: number; count: number; edgeId: number }[];
  } {


could we keep the js implementation as a fallback (in case we run in with a wasm that does not have the cpp implementation?)

sgenoud · 2026-06-19T07:02:41Z

-  "version": "0.23.1",
-  "description": "The library to build browser based 3D models with code",
+  "name": "@taucad/replicad",
+  "version": "0.23.3-beta.1",


This is a leftover

sgenoud · 2026-06-19T07:04:06Z

-  if (manifold?.Manifold) {
-    manifold.setup();
-    replicad.setManifold(manifold);
+export function runInContextAsOC(code, context = {}) {


There seem to be some rebase issue here, I have modified how this works in the mean time.

rifont added 30 commits March 7, 2026 11:24

wip: replicad-ocjs-v8

7fd46ee

wip-suffix-overload-removal

12bd9cf

feat: return by value and wasm-opt-O4

36b3cca

chore: format

c7daa97

chore: add latest opencascadejs bindings

8fe0c9a

fix: specify O3 instead of invalid O4 wasm-opt flag

36bbf25

build(replicad-opencascadejs): add --traps-never-happen flag to wasm-…

eb0ad95

…opt optimization

chore: add latest simd max-perf builds

9ddaf4c

refactor(shapeHelpers): replace deprecated TColgp array types with NC…

e38aa56

…ollection equivalents

fix(shapes): remove redundant normal consistency enforcement in mesh …

598cc0b

…generation

fix(export): fix STEP export by calling correct Transfer method

4c9541c

refactor(build-config): consolidate OpenCascade build configs into si…

959b405

…ngle YAML

chore: regenerate wasm bindings

a1e6a94

chore: bump replicad-opencascadejs version

8bcd48e

chore: bump replicad version

6d22951

fix(shapes): clear mesh cache before remeshing with coarser tolerance

db21c69

chore(replicad): clean up obsolete tarball build artifacts

7157137

refactor(lib2d): update OpenCascade 2D curve API to v8 naming

08a3937

feat(export): add material density and PBR support to assembly exporter

37ca844

fix(shapeHelpers): replace deprecated GCE2d_MakeSegment with GC_MakeS…

775b02c

…egment2d

refactor(shapes): replace face iteration mesh logic with native C++ e…

f5dc773

…xtractors

chore: bump package versions

37e457e

chore: rebuild replicad-opencascadejs

fb01a8b

fix: drop relaxed-simd for safari support

b8359b2

refactor(export): rename metallic to metalness in ShapeConfig type

651594c

chore(packages): add npm publish configuration and update descriptions

f7b86c7

docs: clarify origin-relative positioning in solid creation APIs

79c52f0

feat(ui): migrate to ESM sub-path exp

d868d4c

orts and add multi-threaded build

chore: rebuild latest ocjs builds

1e065b7

rifont and others added 7 commits May 31, 2026 16:51

chore: regenerate wasm builds with gp_Pln included

8839e02

refactor(api): simplify OpenCASCADE constructor calls with default pa…

6ba609c

…rameters

build(replicad): change moduleResolution from node to bundler

38fa556

chore: bump package verisons to beta

37f8368

fix: reconcile tau fork with replicad v0.23.3

55535cd

fix(example): build worker as ES module

fe7a5b6

sgenoud reviewed Jun 19, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Migrate Replicad to OCCT v8 bindings#263

Migrate Replicad to OCCT v8 bindings#263
rifont wants to merge 37 commits into
sgenoud:mainfrom
taucad:main

rifont commented Jun 14, 2026

Uh oh!

sgenoud left a comment

Uh oh!

sgenoud Jun 19, 2026

Uh oh!

sgenoud Jun 19, 2026

Uh oh!

sgenoud Jun 19, 2026

Uh oh!

sgenoud Jun 19, 2026

Uh oh!

sgenoud Jun 19, 2026

Uh oh!

sgenoud Jun 19, 2026

Uh oh!

sgenoud Jun 19, 2026

Uh oh!

sgenoud Jun 19, 2026

Uh oh!

sgenoud Jun 19, 2026

Uh oh!

sgenoud Jun 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

rifont commented Jun 14, 2026

Summary

Reviewer notes

Test plan

Risks

AI Disclosure

Uh oh!

sgenoud left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants