cyclecad 3.2.0 → 3.4.0

package/app/tests/FUSION_TEST_SUITE.md

@@ -0,0 +1,266 @@
+# cycleCAD Fusion Test Suite
+
+Comprehensive visual test pages for all cycleCAD features. Each test page loads the app in an iframe and runs automated tests against it, with live visualization and detailed logging.
+
+## Test Files
+
+### 1. **fusion-sketch-tests.html** (15 KB)
+Tests for all 2D sketch features:
+- **Basic Shapes**: Line, Rectangle, Circle, Ellipse, Arc, Spline, Slot, Polygon
+- **Advanced Tools**: Mirror, Pattern, Offset, Trim, Extend, Fillet 2D, Chamfer 2D
+- **Constraints**: All 12 constraint types (Coincident, Horizontal, Vertical, Parallel, Perpendicular, Tangent, Equal, Fixed, Concentric, Symmetric, Distance, Angle)
+
+**Test Categories**:
+- Basic Shapes (8 tests)
+- Advanced Operations (8 tests)
+- Constraint System (12 tests)
+- Export Formats (2 tests)
+
+### 2. **fusion-solid-tests.html** (13 KB)
+Tests for all 3D solid modeling operations:
+- **Basic Operations**: Extrude, Revolve, Hole, Pocket, Pad
+- **Advanced Operations**: Sweep, Loft, Boolean Union/Cut/Intersect, Shell, Draft
+- **Features**: Fillet, Chamfer, Thread, Rib, Web, Scale
+- **Patterns**: Rectangular Pattern, Circular Pattern, Mirror Body, Copy Body
+
+**Test Categories**:
+- Basic Operations (5 tests)
+- Advanced Operations (7 tests)
+- Feature Tools (6 tests)
+- Pattern Operations (4 tests)
+
+### 3. **fusion-assembly-tests.html** (12 KB)
+Tests for assembly and multi-body workflows:
+- **Joint Types**: Fixed, Revolute, Slider, Ball, Screw, Cylindrical, Planar
+- **Component Management**: Insert, Ground, Suppress, Hide, Show
+- **Analysis**: Interference Detection, Assembly Explode/Collapse, Motion Study, Drive Joint
+
+**Test Categories**:
+- Joint Creation (7 tests)
+- Component Workflows (5 tests)
+- Assembly Analysis (5 tests)
+
+### 4. **fusion-cam-tests.html** (10 KB)
+Tests for CAM and toolpath generation:
+- **Setup**: Create Setup, Stock Setup, Coordinate System, Post Configuration
+- **Operations**: Facing, Pocket, Contour, Drilling, 2D Adaptive, 3D Adaptive, Turning
+- **Toolpath**: Tool Library, Tool Selection, Feed & Speed Calculator, Toolpath Simulation, G-code Generation, Setup Sheets
+
+**Test Categories**:
+- Setup Operations (4 tests)
+- Machining Operations (7 tests)
+- Toolpath & G-code (6 tests)
+
+### 5. **fusion-simulation-tests.html** (10 KB)
+Tests for structural and thermal analysis:
+- **Stress Analysis**: Create Study, Apply Load, Apply Constraint, Mesh, Solve, Stress Results, Strain Results
+- **Thermal Analysis**: Thermal Study, Initial Temperature, Thermal Load, Thermal Constraint, Thermal Mesh, Thermal Results
+- **Other**: Modal Frequency, Buckling Analysis, Shape Optimization, Fatigue Analysis
+
+**Test Categories**:
+- Static Stress Analysis (7 tests)
+- Thermal Analysis (6 tests)
+- Advanced Analysis (4 tests)
+
+### 6. **fusion-all-tests.html** (18 KB) — Master Test Runner
+Master test orchestration page that:
+- Loads all 5 test suites in sequence
+- Aggregates results across all suites
+- Displays overall progress and statistics
+- Exports combined results as JSON or HTML report
+- Tracks elapsed time
+- Shows pass/fail/skip counts per suite
+
+**Features**:
+- Run All Tests button
+- Individual suite result cards
+- Overall progress bar (linear gradient)
+- Stat cards showing total Pass/Fail/Skip
+- Export to JSON or HTML
+- Real-time progress updates
+- Category breakdown per suite
+
+## Usage
+
+### Running Individual Test Suites
+
+Open any individual test HTML file in a browser:
+```
+cyclecad.com/app/tests/fusion-sketch-tests.html
+cyclecad.com/app/tests/fusion-solid-tests.html
+cyclecad.com/app/tests/fusion-assembly-tests.html
+cyclecad.com/app/tests/fusion-cam-tests.html
+cyclecad.com/app/tests/fusion-simulation-tests.html
+```
+
+Each test page:
+1. Loads the cycleCAD app in an iframe (left side, 70%)
+2. Shows test log and controls on the right (30%)
+3. Displays Pass/Fail/Skip counters
+4. Shows progress bar
+5. Allows running all tests or individual categories
+
+### Running Master Test Suite
+
+Open the master runner:
+```
+cyclecad.com/app/tests/fusion-all-tests.html
+```
+
+This will:
+1. Load all 5 test suites sequentially
+2. Capture results from each suite
+3. Display overall statistics
+4. Allow exporting combined report as JSON or HTML
+
+## Test Architecture
+
+### Split-Screen Layout
+```
+┌─────────────────────────────────────────────────┐
+│  cycleCAD App (70%)      │  Test Log (30%)       │
+│  (loads in iframe)       │  - Pass/Fail counts   │
+│                          │  - Category buttons   │
+│                          │  - Test entries       │
+│                          │  - Progress bar       │
+└─────────────────────────────────────────────────┘
+```
+
+### Test Execution Flow
+1. Iframe loads the app at `../index.html`
+2. Wait for onload event
+3. Access app via `iframe.contentWindow`
+4. Call test functions sequentially
+5. Each test returns `{ pass: boolean, error?: string, skip?: boolean }`
+6. Results logged in real-time with color coding
+7. Stats updated after each test
+
+### Color Coding
+- **Green**: Pass (✓)
+- **Red**: Fail (✗)
+- **Yellow**: Skip (○)
+- **Blue**: Info
+
+## Test Categories (All Suites)
+
+### Sketch Tests
+- **Basic Shapes** (8 tests): Line, Rect, Circle, Ellipse, Arc, Spline, Slot, Polygon
+- **Advanced** (8 tests): Mirror, Pattern, Offset, Trim, Extend, Fillet 2D, Chamfer 2D, Project
+- **Constraints** (12 tests): All 12 constraint types
+- **Export** (2 tests): DXF, SVG
+
+### Solid Tests
+- **Basic Ops** (5 tests): Extrude, Revolve, Hole, Pocket, Pad
+- **Advanced** (7 tests): Sweep, Loft, Boolean Union/Cut/Intersect, Shell, Draft
+- **Features** (6 tests): Fillet, Chamfer, Thread, Rib, Web, Scale
+- **Patterns** (4 tests): Rectangular, Circular, Mirror, Copy
+
+### Assembly Tests
+- **Joints** (7 tests): Fixed, Revolute, Slider, Ball, Screw, Cylindrical, Planar
+- **Components** (5 tests): Insert, Ground, Suppress, Hide, Show
+- **Analysis** (5 tests): Interference, Explode, Collapse, Motion, Drive
+
+### CAM Tests
+- **Setup** (4 tests): Create, Stock, Coordinate, Post
+- **Operations** (7 tests): Facing, Pocket, Contour, Drilling, 2D Adaptive, 3D Adaptive, Turning
+- **Toolpath** (6 tests): Tool Library, Tool Selection, Feed/Speed, Simulation, G-code, Setup Sheet
+
+### Simulation Tests
+- **Stress** (7 tests): Study, Load, Constraint, Mesh, Solve, Stress/Strain Results
+- **Thermal** (6 tests): Study, Temperature, Load, Constraint, Mesh, Results
+- **Other** (4 tests): Modal, Buckling, Shape Optimization, Fatigue
+
+## Statistics
+
+| Suite | Total Tests | Categories | Status |
+|-------|------------|-----------|--------|
+| Sketch | 30 | 4 | Ready |
+| Solid | 22 | 4 | Ready |
+| Assembly | 17 | 3 | Ready |
+| CAM | 17 | 3 | Ready |
+| Simulation | 17 | 3 | Ready |
+| **Total** | **103** | **17** | **Ready** |
+
+## Features
+
+### Per-Suite Test Page
+- ✓ Split-screen layout (app + log)
+- ✓ Pass/Fail/Skip counters
+- ✓ Progress bar with color gradient
+- ✓ Run All Tests button
+- ✓ Run Category buttons
+- ✓ Real-time test logging
+- ✓ Color-coded results
+- ✓ Elapsed time tracking
+
+### Master Test Runner
+- ✓ Load all 5 suites sequentially
+- ✓ Aggregate results across all suites
+- ✓ Overall progress bar
+- ✓ Per-suite stat cards
+- ✓ Export to JSON format
+- ✓ Export to HTML report
+- ✓ Elapsed time tracking
+- ✓ Visual status badges (running/completed/failed)
+
+## Development Patterns
+
+### Test Function Signature
+```javascript
+async function testFeatureName() {
+  try {
+    const module = appWindow.cycleCAD?.moduleNamespace;
+    if (!module) return { skip: true };
+
+    const result = await module.featureCall();
+    return { pass: result !== null };
+  } catch (e) {
+    return { pass: false, error: e.message };
+  }
+}
+```
+
+### Adding New Tests
+1. Create test function with same signature
+2. Add to appropriate `tests` object category
+3. Return `{ pass, error?, skip? }`
+4. Tests run sequentially with 300ms delay between each
+
+### Dark Theme
+All test pages use consistent dark theme:
+- Background: `#0f172a`
+- Cards: `#1a202c`
+- Text: `#e2e8f0`
+- Accent (blue): `#38bdf8`
+- Success (green): `#10b981`
+- Error (red): `#ef4444`
+- Warning (amber): `#f59e0b`
+
+## File Sizes
+
+```
+fusion-sketch-tests.html      15 KB
+fusion-solid-tests.html       13 KB
+fusion-assembly-tests.html    12 KB
+fusion-cam-tests.html         10 KB
+fusion-simulation-tests.html  10 KB
+fusion-all-tests.html         18 KB
+────────────────────────────────
+Total                         78 KB
+```
+
+## Browser Compatibility
+
+- Chrome/Edge 90+
+- Firefox 88+
+- Safari 14+
+- All modern browsers with ES6+ support
+
+## Notes
+
+- Tests access app via `iframe.contentWindow`
+- Each test isolated in try-catch for reliability
+- Skip tests that require external dependencies
+- Detailed error messages logged for failed tests
+- Results export available in JSON and HTML formats
+- Master runner sequences suites to avoid parallel load issues

package/app/tests/README.md

@@ -0,0 +1,77 @@
+# B-Rep Live Test Suite
+
+**Quick start:** Open `brep-live-test.html` in a web browser.
+
+## What is This?
+
+A standalone interactive test page that downloads OpenCascade.js WASM (a full 3D CAD geometry kernel compiled to WebAssembly) and demonstrates real B-Rep (Boundary Representation) geometry operations with live 3D visualization in Three.js.
+
+## Files
+
+| File | Purpose |
+|------|---------|
+| `brep-live-test.html` | Main test page (all-in-one, no build needed) |
+| `BREP-LIVE-TEST-GUIDE.md` | Complete documentation + API reference |
+| `TESTING-CHECKLIST.md` | Pre-deployment validation steps |
+| `README.md` | This file |
+
+## Run Locally
+
+```bash
+cd ~/cyclecad
+python -m http.server 8000
+# Then open: http://localhost:8000/app/tests/brep-live-test.html
+```
+
+## What It Tests
+
+**14 tests across 3 categories:**
+
+- **Primitives (5):** Box, Cylinder, Sphere, Cone, Torus
+- **Operations (6):** Fillet, Chamfer, Boolean Union/Cut/Intersect, Extrude
+- **Analysis (3):** Mass Properties, Edge Count, Face Count
+
+## How It Works
+
+1. **Downloads OpenCascade.js WASM** — ~50MB binary (1-3 min on first load)
+2. **Initializes Three.js scene** — Camera, lights, grid, OrbitControls
+3. **Creates B-Rep geometry** — Using real OCP APIs (`BRepPrimAPI_MakeBox`, `BRepAlgoAPI_Fuse`, etc.)
+4. **Tessellates to triangles** — `BRepMesh_IncrementalMesh` → extract faces → build THREE.BufferGeometry
+5. **Renders in real-time** — 3D viewport with shadows, lighting, interaction
+
+## Key Features
+
+- Real B-Rep geometry (not mesh approximations)
+- Interactive 3D camera (rotate, pan, zoom)
+- Live FPS, triangle count, vertex count display
+- Timestamped logging of all operations
+- Dark VS Code-style UI
+- Click individual tests or "Run All Tests"
+- Status indicators (pending/running/passed/failed)
+- Error handling with helpful messages
+
+## Why This Matters
+
+Validates that:
+- OpenCascade.js WASM works in modern browsers
+- Complex geometry operations execute in-browser
+- Tessellation pipeline produces valid meshes
+- Three.js can render large triangle counts (5k-10k per shape)
+- B-Rep APIs are accessible and reliable
+
+## Next Steps
+
+1. Test locally and verify all 14 tests pass
+2. Review `BREP-LIVE-TEST-GUIDE.md` for detailed API reference
+3. Add new tests by following the pattern in `brep-live-test.html`
+4. Deploy to GitHub Pages (automatic once pushed to main)
+5. Integrate real B-Rep operations into cycleCAD `operations.js`
+
+## Troubleshooting
+
+See `BREP-LIVE-TEST-GUIDE.md` for common issues and solutions.
+
+---
+
+**Status:** Ready for testing
+**Created:** 2026-03-31

package/app/tests/TESTING-CHECKLIST.md

@@ -0,0 +1,177 @@
+# B-Rep Live Test — Pre-Deployment Checklist
+
+## Files Created
+- [x] `/app/tests/brep-live-test.html` — Main test page (848 lines, 31KB)
+- [x] `/docs/BREP-LIVE-TEST-GUIDE.md` — Complete guide (453 lines, 16KB)
+- [x] `/app/tests/TESTING-CHECKLIST.md` — This file
+
+## Test Page Validation Checklist
+
+### WASM Loading
+- [ ] CDN URL resolves: `https://cdn.jsdelivr.net/npm/opencascade.js@2.0.0-beta.b5ff984/dist/`
+- [ ] Progress bar shows 0-100% during download
+- [ ] "Ready" message appears when complete
+- [ ] "Run All Tests" button enables
+
+### Three.js Setup
+- [ ] Canvas renders in viewport
+- [ ] Grid floor visible
+- [ ] Lights casting shadows
+- [ ] OrbitControls respond to mouse (rotate, pan, zoom)
+
+### Test Execution
+
+#### Primitives (5 tests)
+- [ ] Box: Renders cube, 12 edges shown in log
+- [ ] Cylinder: Renders cylinder, circular face visible
+- [ ] Sphere: Renders sphere, smooth surface
+- [ ] Cone: Renders cone, tapered shape visible
+- [ ] Torus: Renders doughnut shape
+
+#### Operations (6 tests)
+- [ ] Fillet: Box edges are rounded/smooth
+- [ ] Chamfer: Box edges are beveled
+- [ ] Union: Box and cylinder merged together
+- [ ] Cut: Cylindrical hole visible in box
+- [ ] Intersect: Overlapping region only visible
+- [ ] Extrude: 2D face becomes 3D solid
+
+#### Analysis (3 tests)
+- [ ] Mass: Displays volume and area in log
+- [ ] Edges: Displays edge count (box = 12)
+- [ ] Faces: Displays face count (box = 6)
+
+### UI Behavior
+- [ ] Individual test click runs that test
+- [ ] "Run All Tests" runs 14 tests in sequence
+- [ ] Status indicators update: pending → running → passed/failed
+- [ ] Timing displays in milliseconds
+- [ ] Log panel auto-scrolls to latest message
+- [ ] Stats overlay updates (FPS, triangles, vertices)
+- [ ] Test list groups by category (Primitives/Operations/Analysis)
+
+### Error Handling
+- [ ] Network error shows clear message
+- [ ] WASM init failure displays suggestion
+- [ ] Tessellation failure logged without crashing app
+- [ ] Missing OCP API falls back gracefully
+
+### Performance
+- [ ] FPS ≥ 30 during rotation
+- [ ] Primitives render in <100ms each
+- [ ] Boolean ops render in <200ms each
+- [ ] No memory leaks over multiple test runs
+
+## Deployment Steps
+
+### Local Testing
+```bash
+# Ensure directory exists
+mkdir -p ~/cyclecad/app/tests
+
+# Files should already exist:
+ls -l ~/cyclecad/app/tests/brep-live-test.html
+ls -l ~/cyclecad/docs/BREP-LIVE-TEST-GUIDE.md
+
+# Start local server
+cd ~/cyclecad
+python -m http.server 8000
+
+# Open in browser (may need HTTPS for some features):
+http://localhost:8000/app/tests/brep-live-test.html
+```
+
+### Git Commit
+```bash
+cd ~/cyclecad
+rm -f .git/HEAD.lock .git/index.lock
+
+git add app/tests/brep-live-test.html
+git add docs/BREP-LIVE-TEST-GUIDE.md
+git add app/tests/TESTING-CHECKLIST.md
+
+git commit -m "Add B-Rep live test page with OpenCascade.js WASM + Three.js visualization
+
+- brep-live-test.html: Interactive test harness for 14 B-Rep operations
+- BREP-LIVE-TEST-GUIDE.md: Complete documentation with API reference
+- WASM download progress tracking (50MB OpenCascade.js binary)
+- Real tessellation pipeline: BRepMesh -> TopExp_Explorer -> THREE.BufferGeometry
+- 5 primitives + 6 operations + 3 analysis tests
+- Dark VS Code-style UI with sidebar, viewport, stats, logging
+"
+
+git push origin main
+```
+
+### GitHub Pages Deployment
+Once pushed to main, test page is automatically available at:
+```
+https://vvlars-cmd.github.io/cyclecad/app/tests/brep-live-test.html
+```
+
+## Known Issues & Workarounds
+
+### Issue: WASM Download Hangs
+**Symptom:** Progress bar stuck at 0% or freezes browser
+**Workaround:**
+1. Wait 2-3 minutes (first load takes time)
+2. Check DevTools Network tab (F12)
+3. Refresh page and try again
+
+### Issue: "BRepFilletAPI_MakeFillet is not a function"
+**Symptom:** Test fails with API not found error
+**Workaround:**
+1. Check OpenCascade.js version in CDN_BASE
+2. Try alternative API or simpler operation
+3. Verify WASM loaded successfully
+
+### Issue: Black Screen (No Geometry Visible)
+**Symptom:** Canvas renders but no shape appears
+**Workaround:**
+1. Check console (F12 → Console) for tessellation errors
+2. Try smaller deflection value (0.05 instead of 0.1)
+3. Verify shape was created before tessellation
+
+### Issue: Tests Run Very Slowly
+**Symptom:** Each test takes >1 second
+**Workaround:**
+1. Close other browser tabs
+2. Restart browser
+3. Check if WASM is still downloading (Network tab)
+
+## Extending the Test Suite
+
+### Add New Test
+1. Add entry to `tests` array (line ~270)
+2. Add implementation in `runTest()` function (line ~550)
+3. Follow pattern: create shape → tessellate → render
+
+### Example: Add a Wedge Test
+```javascript
+// In tests array:
+{ id: 'wedge', name: 'Wedge (inclined plane)', category: 'Primitives' },
+
+// In runTest():
+else if (testId === 'wedge') {
+    const shape = new oc.BRepPrimAPI_MakeWedge_3(100, 50, 30, 20).Shape();
+    const tessData = tessellateShape(shape);
+    if (!tessData) throw new Error('Tessellation failed');
+    const { triangleCount } = renderGeometry(tessData.vertices, tessData.indices);
+    log(`Wedge: ${elapsed.toFixed(1)}ms, ${triangleCount} triangles`, 'success');
+    updateTestStatus(testId, 'passed', elapsed);
+}
+```
+
+## Success Criteria
+
+✅ All 14 tests pass without errors
+✅ WASM loads in <3 minutes
+✅ Geometry renders correctly in 3D viewport
+✅ Stats overlay shows FPS ≥30
+✅ Log panel shows all operations with timing
+✅ UI is responsive and visually correct
+
+---
+
+**Status:** Ready for testing
+**Last checked:** 2026-03-31