ci(): add e2e playwright test

.github/workflows/playwright.yml

@@ -0,0 +1,41 @@
+name: Playwright Tests
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+jobs:
+  test:
+    strategy:
+      matrix:
+        os: [ubuntu-latest]
+    timeout-minutes: 5
+    runs-on: ${{ matrix.os }}
+    steps:
+      - name: boost
+        if: startsWith(matrix.os, 'ubuntu')
+        run: sudo apt-get update && sudo apt-get install -yq libboost-dev
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+      - name: Install dependencies
+        run: |
+          npm ci
+      - name: Fix Ubuntu 24.04 issue https://github.com/electron/electron/issues/17972
+        run: |
+          file=node_modules/electron/dist/chrome-sandbox
+          sudo chown root $file
+          sudo chmod 4755 $file
+      - name: Build
+        run: npm run build
+      - name: Install Playwright Browsers
+        run: npx playwright install --with-deps chromium
+      - name: Run Playwright tests
+        run: xvfb-run npm test
+        env:
+          DEBUG: pw:browser*
+      - uses: actions/upload-artifact@v4
+        if: ${{ !cancelled() }}
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 7

.gitignore

@@ -8,8 +8,12 @@
 /bin
 /minkowski
 /deepnest-*win32-x64
-package-lock.json
 git_token.rtf
 .idea
 *.zip
 .python-version
+node_modules/
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/

.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["ms-playwright.playwright"]
+}

index.d.ts

@@ -0,0 +1,44 @@
+export type DeepNestConfig = {
+  units: "mm" | "inch";
+  scale: number;
+  spacing: number;
+  curveTolerance: number;
+  clipperScale: number;
+  rotations: number;
+  threads: number;
+  populationSize: number;
+  mutationRate: number;
+  placementType: "gravity" | "box" | "convexhull";
+  mergeLines: boolean;
+  /**
+   * ratio of material reduction to laser time. 0 = optimize material only, 1 = optimize laser time only
+   */
+  timeRatio: number;
+  simplify: boolean;
+  dxfImportScale: number;
+  dxfExportScale: number;
+  endpointTolerance: number;
+  conversionServer: string;
+};
+
+export type SheetPlacement = {
+  filename: string;
+  id: number;
+  rotation: number;
+  source: number;
+  x: number;
+  y: number;
+};
+
+export type NestingResult = {
+  area: number;
+  fitness: number;
+  index: number;
+  mergedLength: number;
+  selected: boolean;
+  placements: {
+    sheet: number;
+    sheetid: number;
+    sheetplacements: SheetPlacement[];
+  }[];
+};