WIP: Start synchronizing the enableSketchMode call

* Show visible error when updater call fails due to permissions issue
Fixes #3696

* Update comment for consistency

.env.production

@@ -1,5 +1,4 @@
 NODE_ENV=production
-DEV=false
 VITE_KC_API_WS_MODELING_URL=wss://api.zoo.dev/ws/modeling/commands
 VITE_KC_API_BASE_URL=https://api.zoo.dev
 VITE_KC_SITE_BASE_URL=https://zoo.dev

.gitattributes

@@ -0,0 +1,13 @@
+# Set default behavior to automatically normalize line endings.
+* text=auto
+
+# Force batch scripts to always use CRLF line endings so that if a repo is accessed
+# in Windows via a file share from Linux, the scripts will work.
+*.{cmd,[cC][mM][dD]} text working-tree-encoding=UTF-16LE eol=CRLF
+*.{bat,[bB][aA][tT]} text working-tree-encoding=UTF-16LE eol=CRLF
+*.{ics,[iI][cC][sS]} text working-tree-encoding=UTF-16LE eol=CRLF
+*.{ps1,[iP][sS][1]} text working-tree-encoding=UTF-16LE eol=CRLF
+
+# Force bash scripts to always use LF line endings so that if a repo is accessed
+# in Unix via a file share from Windows, the scripts will work.
+*.sh text eol=lfol=lf

.github/workflows/e2e-snapshot-tests.yml

@@ -1,145 +0,0 @@
-name: E2E Snapshot Tests
-on:
-  push:
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
-  cancel-in-progress: true
-
-permissions:
-  contents: write
-  pull-requests: write
-  actions: read
-
-
-jobs:
-
-  check-rust-changes:
-    runs-on: ubuntu-latest
-    outputs:
-      rust-changed: ${{ steps.filter.outputs.rust }}
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - id: filter
-        name: Check for Rust changes
-        uses: dorny/paths-filter@v3
-        with:
-          filters: |
-            rust:
-              - 'src/wasm-lib/**'
-
-  snapshot-tests:
-    runs-on: ubuntu-22.04
-    needs: check-rust-changes
-    steps:
-    - uses: actions/checkout@v4
-
-    - uses: actions/setup-node@v4
-      with:
-        node-version-file: '.nvmrc'
-        cache: 'yarn'
-
-    - name: Install dependencies
-      run: yarn
-
-    - name: Cache Playwright Browsers
-      uses: actions/cache@v4
-      with:
-        path: |
-          ~/.cache/ms-playwright/
-        key: ${{ runner.os }}-playwright-${{ hashFiles('yarn.lock') }}
-
-    - name: Install Playwright Browsers
-      run: yarn playwright install --with-deps
-
-    - name: Download Wasm Cache
-      id: download-wasm
-      if: needs.check-rust-changes.outputs.rust-changed == 'false'
-      uses: dawidd6/action-download-artifact@v7
-      continue-on-error: true
-      with:
-        github_token: ${{secrets.GITHUB_TOKEN}}
-        name: wasm-bundle
-        workflow: build-and-store-wasm.yml
-        branch: main
-        path: src/wasm-lib/pkg
-
-    - name: copy wasm blob
-      if: needs.check-rust-changes.outputs.rust-changed == 'false'
-      run: cp src/wasm-lib/pkg/wasm_lib_bg.wasm public
-      continue-on-error: true
-
-    - name: Setup Rust
-      if: needs.check-rust-changes.outputs.rust-changed == 'true'
-      uses: dtolnay/rust-toolchain@stable
-
-    - name: Cache Wasm (because rust diff)
-      if: needs.check-rust-changes.outputs.rust-changed == 'true'
-      uses: Swatinem/rust-cache@v2
-      with:
-        workspaces: './src/wasm-lib'
-
-    - name: OR Cache Wasm (because wasm cache failed)
-      if: steps.download-wasm.outcome == 'failure'
-      uses: Swatinem/rust-cache@v2
-      with:
-        workspaces: './src/wasm-lib'
-
-    - name: Build Wasm (because rust diff)
-      if: needs.check-rust-changes.outputs.rust-changed == 'true'
-      run: yarn build:wasm
-
-    - name: OR Build Wasm (because wasm cache failed)
-      if: steps.download-wasm.outcome == 'failure'
-      run: yarn build:wasm
-
-    - name: build web
-      run: yarn tronb:vite:dev
-
-    - name: Run chrome snapshots
-      run: |
-        PLATFORM=web yarn playwright test --config=playwright.config.ts --retries="3" --update-snapshots --grep=@snapshot
-      env:
-        CI: true
-        NODE_ENV: development
-        VITE_KC_DEV_TOKEN: ${{ secrets.KITTYCAD_API_TOKEN_DEV }}
-        VITE_KC_SKIP_AUTH: true
-        token: ${{ secrets.KITTYCAD_API_TOKEN_DEV }}
-        snapshottoken: ${{ secrets.KITTYCAD_API_TOKEN }}
-
-    - name: check for changes
-      id: git-check
-      run: |
-        {
-          echo 'changes<<EOF'
-          git diff --name-only e2e/playwright/snapshot-tests.spec.ts-snapshots
-          echo EOF
-        } >> "$GITHUB_OUTPUT"
-
-    # only upload artifacts if there's actually changes
-    - name: Upload changes, if any
-      if: steps.git-check.outputs.changes != ''
-      uses: actions/upload-artifact@v4
-      with:
-        name: playwright-snapshots-${{ runner.os }}-${{ github.sha }}
-        path: ${{ steps.git-check.outputs.changes }}
-
-    - name: Upload report, if any
-      uses: actions/upload-artifact@v4
-      if: steps.git-check.outputs.changes != ''
-      with:
-        name: playwright-report-${{ runner.os }}-${{ github.sha }}
-        path: playwright-report/
-        include-hidden-files: true
-        retention-days: 30
-
-    - name: Fail the run if we have snapshot updates
-      if: steps.git-check.outputs.changes != ''
-      run: exit 1
-
-    # TODO: check if we could comment on the PR as well

.github/workflows/e2e-tests.yml

@@ -1,9 +1,8 @@
-name: E2E Flow Tests
+name: E2E Tests
 on:
   push:
     branches: [ main ]
   pull_request:
-    branches: [ main ]
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
@@ -33,7 +32,7 @@ jobs:
             rust:
               - 'src/wasm-lib/**'
 
-  flow-tests:
+  electron:
     timeout-minutes: 60
     name: playwright:electron:${{ matrix.os }} ${{ matrix.shardIndex }} ${{ matrix.shardTotal }}
     strategy:
@@ -46,30 +45,32 @@ jobs:
     runs-on: ${{ matrix.os }}
     needs: check-rust-changes
     steps:
+    - uses: actions/create-github-app-token@v1
+      id: app-token
+      with:
+        app-id: ${{ secrets.MODELING_APP_GH_APP_ID }}
+        private-key: ${{ secrets.MODELING_APP_GH_APP_PRIVATE_KEY }}
+        owner: ${{ github.repository_owner }}
     - uses: actions/checkout@v4
-
+      with:
+        token: ${{ steps.app-token.outputs.token }}
     - uses: actions/setup-node@v4
       with:
         node-version-file: '.nvmrc'
         cache: 'yarn'
-
     - uses: KittyCAD/action-install-cli@main
-
     - name: Install dependencies
       shell: bash
       run: yarn
-
     - name: Cache Playwright Browsers
       uses: actions/cache@v4
       with:
         path: |
           ~/.cache/ms-playwright/
         key: ${{ runner.os }}-playwright-${{ hashFiles('yarn.lock') }}
-
     - name: Install Playwright Browsers
       shell: bash
       run: yarn playwright install --with-deps
-
     - name: Download Wasm Cache
       id: download-wasm
       if: needs.check-rust-changes.outputs.rust-changed == 'false'
@@ -81,35 +82,29 @@ jobs:
         workflow: build-and-store-wasm.yml
         branch: main
         path: src/wasm-lib/pkg
-
     - name: copy wasm blob
       if: needs.check-rust-changes.outputs.rust-changed == 'false'
       shell: bash
       run: cp src/wasm-lib/pkg/wasm_lib_bg.wasm public
       continue-on-error: true
-
     - name: Setup Rust
       uses: dtolnay/rust-toolchain@stable
-
     - name: Cache Wasm (because rust diff)
       if: needs.check-rust-changes.outputs.rust-changed == 'true'
       uses: Swatinem/rust-cache@v2
       with:
         workspaces: './src/wasm-lib'
-
     - name: OR Cache Wasm (because wasm cache failed)
       if: steps.download-wasm.outcome == 'failure'
       uses: Swatinem/rust-cache@v2
       with:
         workspaces: './src/wasm-lib'
-
     - name: install good sed
       if:  ${{ startsWith(matrix.os, 'macos') }}
       shell: bash
       run: |
         brew install gnu-sed
         echo "/opt/homebrew/opt/gnu-sed/libexec/gnubin" >> $GITHUB_PATH
-
     - name: Install vector
       shell: bash
       # TODO: figure out what to do with this, it's failing
@@ -127,33 +122,81 @@ jobs:
         sed -i "s#GH_ACTIONS_AXIOM_TOKEN#${{secrets.GH_ACTIONS_AXIOM_TOKEN}}#g" /tmp/vector.toml
         cat /tmp/vector.toml
         ${HOME}/.vector/bin/vector --config /tmp/vector.toml &
-
     - name: Build Wasm (because rust diff)
       if: needs.check-rust-changes.outputs.rust-changed == 'true'
       shell: bash
       run: yarn build:wasm
-
     - name: OR Build Wasm (because wasm cache failed)
       if: steps.download-wasm.outcome == 'failure'
       shell: bash
       run: yarn build:wasm
-
     - name: build web
       shell: bash
       run: yarn tronb:vite:dev
-
+    - name: Run ubuntu/chrome snapshots
+      if: ${{ matrix.os == 'namespace-profile-ubuntu-8-cores' && matrix.shardIndex == 1 }}
+      shell: bash
+      # TODO: break this in its own job, for now it's not slowing down the overall execution as ubuntu is the quickest,
+      # but we could do better. This forces a large 1/1 shard of all 20 snapshot tests that runs in about 3 minutes.
+      run: |
+        PLATFORM=web yarn playwright test --config=playwright.config.ts --retries="3" --update-snapshots --grep=@snapshot  --shard=1/1
+      env:
+        CI: true
+        NODE_ENV: development
+        VITE_KC_DEV_TOKEN: ${{ secrets.KITTYCAD_API_TOKEN_DEV }}
+        VITE_KC_SKIP_AUTH: true
+        token: ${{ secrets.KITTYCAD_API_TOKEN_DEV }}
+        snapshottoken: ${{ secrets.KITTYCAD_API_TOKEN }}
+    - uses: actions/upload-artifact@v4
+      if: ${{ !cancelled() && (success() || failure()) }}
+      with:
+        name: playwright-report-${{ matrix.os }}-snapshot-${{ matrix.shardIndex }}-${{ github.sha }}
+        path: playwright-report/
+        include-hidden-files: true
+        retention-days: 30
+        overwrite: true
     - name: Clean up test-results
       if: ${{ !cancelled() && (success() || failure()) }}
       continue-on-error: true
       run: rm -r test-results
-
+    - name: check for changes
+      if: ${{ matrix.os == 'namespace-profile-ubuntu-8-cores' && matrix.shardIndex == 1 && github.ref != 'refs/heads/main' }}
+      shell: bash
+      id: git-check
+      run: |
+          git add e2e/playwright/snapshot-tests.spec.ts-snapshots
+          if git status | grep -q "Changes to be committed"
+          then echo "modified=true" >> $GITHUB_OUTPUT
+          else echo "modified=false" >> $GITHUB_OUTPUT
+          fi
+    - name: Commit changes, if any
+      if: steps.git-check.outputs.modified == 'true'
+      shell: bash
+      run: |
+        git add e2e/playwright/snapshot-tests.spec.ts-snapshots
+        git config --local user.email "github-actions[bot]@users.noreply.github.com"
+        git config --local user.name "github-actions[bot]"
+        git remote set-url origin https://${{ github.actor }}:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git
+        git fetch origin
+        echo ${{ github.head_ref }}
+        git checkout ${{ github.head_ref }}
+        git commit -m "A snapshot a day keeps the bugs away! 📷🐛 (OS: ${{matrix.os}})" || true
+        git push
+        git push origin ${{ github.head_ref }}
+    # only upload artifacts if there's actually changes
+    - uses: actions/upload-artifact@v4
+      if: steps.git-check.outputs.modified == 'true'
+      with:
+        name: playwright-report-${{ matrix.os }}-${{ matrix.shardIndex }}-${{ github.sha }}
+        path: playwright-report/
+        include-hidden-files: true
+        retention-days: 30
     - uses: actions/download-artifact@v4
       if: ${{ !cancelled() && (success() || failure()) }}
       continue-on-error: true
       with:
         name: test-results-${{ matrix.os }}-${{ matrix.shardIndex }}-${{ github.sha }}
         path: test-results/
-
     - name: Run playwright/electron flow (with retries)
       id: retry
       if: ${{ !cancelled() && (success() || failure()) }}
@@ -167,7 +210,6 @@ jobs:
         VITE_KC_DEV_TOKEN: ${{ secrets.KITTYCAD_API_TOKEN_DEV }}
         VITE_KC_SKIP_AUTH: true
         token: ${{ secrets.KITTYCAD_API_TOKEN_DEV }}
-
     - uses: actions/upload-artifact@v4
       if: always()
       with:
@@ -176,7 +218,6 @@ jobs:
         include-hidden-files: true
         retention-days: 30
         overwrite: true
-
     - uses: actions/upload-artifact@v4
       if: always()
       with:
@@ -185,3 +226,4 @@ jobs:
         include-hidden-files: true
         retention-days: 30
         overwrite: true
+

.gitignore

@@ -41,9 +41,12 @@ e2e/playwright/playwright-secrets.env
 e2e/playwright/temp1.png
 e2e/playwright/temp2.png
 e2e/playwright/temp3.png
+# this will be overridden for specific directories
+e2e/playwright/**/*.png
 # exports from snapshot-tests.spec.ts "exports of each format should work"
 e2e/playwright/export-snapshots/*
 !e2e/playwright/export-snapshots/*.png
+!e2e/playwright/snapshot-tests.spec.ts-snapshots/*.png
 
 /kcl-samples
 /test-results/

docs/kcl/HALF_TURN.md

@@ -0,0 +1,15 @@
+---
+title: "HALF_TURN"
+excerpt: ""
+layout: manual
+---
+
+
+
+
+
+```js
+HALF_TURN: number(deg) = 180deg
+```
+
+

docs/kcl/QUARTER_TURN.md

@@ -0,0 +1,15 @@
+---
+title: "QUARTER_TURN"
+excerpt: ""
+layout: manual
+---
+
+
+
+
+
+```js
+QUARTER_TURN: number(deg) = 90deg
+```
+
+

docs/kcl/THREE_QUARTER_TURN.md

@@ -0,0 +1,15 @@
+---
+title: "THREE_QUARTER_TURN"
+excerpt: ""
+layout: manual
+---
+
+
+
+
+
+```js
+THREE_QUARTER_TURN: number(deg) = 270deg
+```
+
+

docs/kcl/ZERO.md

@@ -0,0 +1,15 @@
+---
+title: "ZERO"
+excerpt: ""
+layout: manual
+---
+
+
+
+
+
+```js
+ZERO: number = 0
+```
+
+

docs/kcl/assert.md

@@ -22,7 +22,7 @@ assert(data: bool, message: string) -> ()
 
 ### Returns
 
-`()` 
+`()`
 
 
 ### Examples

docs/kcl/assertEqual.md

@@ -24,7 +24,7 @@ assertEqual(left: number, right: number, epsilon: number, message: string) -> ()
 
 ### Returns
 
-`()` 
+`()`
 
 
 ### Examples

docs/kcl/assertGreaterThan.md

@@ -23,7 +23,7 @@ assertGreaterThan(left: number, right: number, message: string) -> ()
 
 ### Returns
 
-`()` 
+`()`
 
 
 ### Examples

docs/kcl/assertGreaterThanOrEq.md

@@ -23,7 +23,7 @@ assertGreaterThanOrEq(left: number, right: number, message: string) -> ()
 
 ### Returns
 
-`()` 
+`()`
 
 
 ### Examples

docs/kcl/assertLessThan.md

@@ -23,7 +23,7 @@ assertLessThan(left: number, right: number, message: string) -> ()
 
 ### Returns
 
-`()` 
+`()`
 
 
 ### Examples

docs/kcl/assertLessThanOrEq.md

@@ -23,7 +23,7 @@ assertLessThanOrEq(left: number, right: number, message: string) -> ()
 
 ### Returns
 
-`()` 
+`()`
 
 
 ### Examples

docs/kcl/cm.md

@@ -26,7 +26,7 @@ cm() -> number
 
 ### Returns
 
-`number` 
+`number`
 
 
 ### Examples

docs/kcl/const_HALF_TURN.md

@@ -0,0 +1,15 @@
+---
+title: "HALF_TURN"
+excerpt: ""
+layout: manual
+---
+
+
+
+
+
+```js
+HALF_TURN: number(deg) = 180deg
+```
+
+

docs/kcl/const_QUARTER_TURN.md

@@ -0,0 +1,15 @@
+---
+title: "QUARTER_TURN"
+excerpt: ""
+layout: manual
+---
+
+
+
+
+
+```js
+QUARTER_TURN: number(deg) = 90deg
+```
+
+

docs/kcl/const_THREE_QUARTER_TURN.md

@@ -0,0 +1,15 @@
+---
+title: "THREE_QUARTER_TURN"
+excerpt: ""
+layout: manual
+---
+
+
+
+
+
+```js
+THREE_QUARTER_TURN: number(deg) = 270deg
+```
+
+

docs/kcl/const_ZERO.md

@@ -0,0 +1,15 @@
+---
+title: "ZERO"
+excerpt: ""
+layout: manual
+---
+
+
+
+
+
+```js
+ZERO: number = 0
+```
+
+

docs/kcl/const_const_std-prelude-HALF_TURN.md

@@ -0,0 +1,15 @@
+---
+title: "std::prelude::HALF_TURN"
+excerpt: ""
+layout: manual
+---
+
+
+
+
+
+```js
+std::prelude::HALF_TURN: number(deg) = 180deg
+```
+
+

docs/kcl/const_const_std-prelude-QUARTER_TURN.md

@@ -0,0 +1,15 @@
+---
+title: "std::prelude::QUARTER_TURN"
+excerpt: ""
+layout: manual
+---
+
+
+
+
+
+```js
+std::prelude::QUARTER_TURN: number(deg) = 90deg
+```
+
+

docs/kcl/const_const_std-prelude-THREE_QUARTER_TURN.md

@@ -0,0 +1,15 @@
+---
+title: "std::prelude::THREE_QUARTER_TURN"
+excerpt: ""
+layout: manual
+---
+
+
+
+
+
+```js
+std::prelude::THREE_QUARTER_TURN: number(deg) = 270deg
+```
+
+

docs/kcl/const_const_std-prelude-ZERO.md

@@ -0,0 +1,15 @@
+---
+title: "std::prelude::ZERO"
+excerpt: ""
+layout: manual
+---
+
+
+
+
+
+```js
+std::prelude::ZERO: number = 0
+```
+
+

docs/kcl/ft.md

@@ -26,7 +26,7 @@ ft() -> number
 
 ### Returns
 
-`number` 
+`number`
 
 
 ### Examples

docs/kcl/inch.md

@@ -26,7 +26,7 @@ inch() -> number
 
 ### Returns
 
-`number` 
+`number`
 
 
 ### Examples

docs/kcl/index.md

@@ -9,110 +9,117 @@ layout: manual
 * [Types](kcl/types)
 * [Modules](kcl/modules)
 * [Known Issues](kcl/KNOWN-ISSUES)
-* [`abs`](kcl/abs)
-* [`acos`](kcl/acos)
-* [`angleToMatchLengthX`](kcl/angleToMatchLengthX)
-* [`angleToMatchLengthY`](kcl/angleToMatchLengthY)
-* [`angledLine`](kcl/angledLine)
-* [`angledLineOfXLength`](kcl/angledLineOfXLength)
-* [`angledLineOfYLength`](kcl/angledLineOfYLength)
-* [`angledLineThatIntersects`](kcl/angledLineThatIntersects)
-* [`angledLineToX`](kcl/angledLineToX)
-* [`angledLineToY`](kcl/angledLineToY)
-* [`appearance`](kcl/appearance)
-* [`arc`](kcl/arc)
-* [`arcTo`](kcl/arcTo)
-* [`asin`](kcl/asin)
-* [`assert`](kcl/assert)
-* [`assertEqual`](kcl/assertEqual)
-* [`assertGreaterThan`](kcl/assertGreaterThan)
-* [`assertGreaterThanOrEq`](kcl/assertGreaterThanOrEq)
-* [`assertLessThan`](kcl/assertLessThan)
-* [`assertLessThanOrEq`](kcl/assertLessThanOrEq)
-* [`atan`](kcl/atan)
-* [`atan2`](kcl/atan2)
-* [`bezierCurve`](kcl/bezierCurve)
-* [`ceil`](kcl/ceil)
-* [`chamfer`](kcl/chamfer)
-* [`circle`](kcl/circle)
-* [`circleThreePoint`](kcl/circleThreePoint)
-* [`close`](kcl/close)
-* [`cm`](kcl/cm)
-* [`cos`](kcl/cos)
-* [`e`](kcl/e)
-* [`extrude`](kcl/extrude)
-* [`fillet`](kcl/fillet)
-* [`floor`](kcl/floor)
-* [`ft`](kcl/ft)
-* [`getNextAdjacentEdge`](kcl/getNextAdjacentEdge)
-* [`getOppositeEdge`](kcl/getOppositeEdge)
-* [`getPreviousAdjacentEdge`](kcl/getPreviousAdjacentEdge)
-* [`helix`](kcl/helix)
-* [`helixRevolutions`](kcl/helixRevolutions)
-* [`hole`](kcl/hole)
-* [`hollow`](kcl/hollow)
-* [`inch`](kcl/inch)
-* [`lastSegX`](kcl/lastSegX)
-* [`lastSegY`](kcl/lastSegY)
-* [`legAngX`](kcl/legAngX)
-* [`legAngY`](kcl/legAngY)
-* [`legLen`](kcl/legLen)
-* [`line`](kcl/line)
-* [`ln`](kcl/ln)
-* [`loft`](kcl/loft)
-* [`log`](kcl/log)
-* [`log10`](kcl/log10)
-* [`log2`](kcl/log2)
-* [`m`](kcl/m)
-* [`map`](kcl/map)
-* [`max`](kcl/max)
-* [`min`](kcl/min)
-* [`mirror2d`](kcl/mirror2d)
-* [`mm`](kcl/mm)
-* [`offsetPlane`](kcl/offsetPlane)
-* [`patternCircular2d`](kcl/patternCircular2d)
-* [`patternCircular3d`](kcl/patternCircular3d)
-* [`patternLinear2d`](kcl/patternLinear2d)
-* [`patternLinear3d`](kcl/patternLinear3d)
-* [`patternTransform`](kcl/patternTransform)
-* [`patternTransform2d`](kcl/patternTransform2d)
-* [`pi`](kcl/pi)
-* [`polar`](kcl/polar)
-* [`polygon`](kcl/polygon)
-* [`pop`](kcl/pop)
-* [`pow`](kcl/pow)
-* [`profileStart`](kcl/profileStart)
-* [`profileStartX`](kcl/profileStartX)
-* [`profileStartY`](kcl/profileStartY)
-* [`push`](kcl/push)
-* [`reduce`](kcl/reduce)
-* [`rem`](kcl/rem)
-* [`revolve`](kcl/revolve)
-* [`round`](kcl/round)
-* [`segAng`](kcl/segAng)
-* [`segEnd`](kcl/segEnd)
-* [`segEndX`](kcl/segEndX)
-* [`segEndY`](kcl/segEndY)
-* [`segLen`](kcl/segLen)
-* [`segStart`](kcl/segStart)
-* [`segStartX`](kcl/segStartX)
-* [`segStartY`](kcl/segStartY)
-* [`shell`](kcl/shell)
-* [`sin`](kcl/sin)
-* [`sqrt`](kcl/sqrt)
-* [`startProfileAt`](kcl/startProfileAt)
-* [`startSketchOn`](kcl/startSketchOn)
-* [`sweep`](kcl/sweep)
-* [`tan`](kcl/tan)
-* [`tangentToEnd`](kcl/tangentToEnd)
-* [`tangentialArc`](kcl/tangentialArc)
-* [`tangentialArcTo`](kcl/tangentialArcTo)
-* [`tangentialArcToRelative`](kcl/tangentialArcToRelative)
-* [`tau`](kcl/tau)
-* [`toDegrees`](kcl/toDegrees)
-* [`toRadians`](kcl/toRadians)
-* [`xLine`](kcl/xLine)
-* [`xLineTo`](kcl/xLineTo)
-* [`yLine`](kcl/yLine)
-* [`yLineTo`](kcl/yLineTo)
-* [`yd`](kcl/yd)
+* **`std`**
+  * [`abs`](kcl/abs)
+  * [`acos`](kcl/acos)
+  * [`angleToMatchLengthX`](kcl/angleToMatchLengthX)
+  * [`angleToMatchLengthY`](kcl/angleToMatchLengthY)
+  * [`angledLine`](kcl/angledLine)
+  * [`angledLineOfXLength`](kcl/angledLineOfXLength)
+  * [`angledLineOfYLength`](kcl/angledLineOfYLength)
+  * [`angledLineThatIntersects`](kcl/angledLineThatIntersects)
+  * [`angledLineToX`](kcl/angledLineToX)
+  * [`angledLineToY`](kcl/angledLineToY)
+  * [`appearance`](kcl/appearance)
+  * [`arc`](kcl/arc)
+  * [`arcTo`](kcl/arcTo)
+  * [`asin`](kcl/asin)
+  * [`assert`](kcl/assert)
+  * [`assertEqual`](kcl/assertEqual)
+  * [`assertGreaterThan`](kcl/assertGreaterThan)
+  * [`assertGreaterThanOrEq`](kcl/assertGreaterThanOrEq)
+  * [`assertLessThan`](kcl/assertLessThan)
+  * [`assertLessThanOrEq`](kcl/assertLessThanOrEq)
+  * [`atan`](kcl/atan)
+  * [`atan2`](kcl/atan2)
+  * [`bezierCurve`](kcl/bezierCurve)
+  * [`ceil`](kcl/ceil)
+  * [`chamfer`](kcl/chamfer)
+  * [`circle`](kcl/circle)
+  * [`circleThreePoint`](kcl/circleThreePoint)
+  * [`close`](kcl/close)
+  * [`cm`](kcl/cm)
+  * [`extrude`](kcl/extrude)
+  * [`fillet`](kcl/fillet)
+  * [`floor`](kcl/floor)
+  * [`ft`](kcl/ft)
+  * [`getNextAdjacentEdge`](kcl/getNextAdjacentEdge)
+  * [`getOppositeEdge`](kcl/getOppositeEdge)
+  * [`getPreviousAdjacentEdge`](kcl/getPreviousAdjacentEdge)
+  * [`helix`](kcl/helix)
+  * [`helixRevolutions`](kcl/helixRevolutions)
+  * [`hole`](kcl/hole)
+  * [`hollow`](kcl/hollow)
+  * [`inch`](kcl/inch)
+  * [`lastSegX`](kcl/lastSegX)
+  * [`lastSegY`](kcl/lastSegY)
+  * [`legAngX`](kcl/legAngX)
+  * [`legAngY`](kcl/legAngY)
+  * [`legLen`](kcl/legLen)
+  * [`line`](kcl/line)
+  * [`ln`](kcl/ln)
+  * [`loft`](kcl/loft)
+  * [`log`](kcl/log)
+  * [`log10`](kcl/log10)
+  * [`log2`](kcl/log2)
+  * [`m`](kcl/m)
+  * [`map`](kcl/map)
+  * [`max`](kcl/max)
+  * [`min`](kcl/min)
+  * [`mirror2d`](kcl/mirror2d)
+  * [`mm`](kcl/mm)
+  * [`offsetPlane`](kcl/offsetPlane)
+  * [`patternCircular2d`](kcl/patternCircular2d)
+  * [`patternCircular3d`](kcl/patternCircular3d)
+  * [`patternLinear2d`](kcl/patternLinear2d)
+  * [`patternLinear3d`](kcl/patternLinear3d)
+  * [`patternTransform`](kcl/patternTransform)
+  * [`patternTransform2d`](kcl/patternTransform2d)
+  * [`polar`](kcl/polar)
+  * [`polygon`](kcl/polygon)
+  * [`pop`](kcl/pop)
+  * [`pow`](kcl/pow)
+  * [`profileStart`](kcl/profileStart)
+  * [`profileStartX`](kcl/profileStartX)
+  * [`profileStartY`](kcl/profileStartY)
+  * [`push`](kcl/push)
+  * [`reduce`](kcl/reduce)
+  * [`rem`](kcl/rem)
+  * [`revolve`](kcl/revolve)
+  * [`round`](kcl/round)
+  * [`segAng`](kcl/segAng)
+  * [`segEnd`](kcl/segEnd)
+  * [`segEndX`](kcl/segEndX)
+  * [`segEndY`](kcl/segEndY)
+  * [`segLen`](kcl/segLen)
+  * [`segStart`](kcl/segStart)
+  * [`segStartX`](kcl/segStartX)
+  * [`segStartY`](kcl/segStartY)
+  * [`shell`](kcl/shell)
+  * [`sqrt`](kcl/sqrt)
+  * [`startProfileAt`](kcl/startProfileAt)
+  * [`startSketchOn`](kcl/startSketchOn)
+  * [`sweep`](kcl/sweep)
+  * [`tangentToEnd`](kcl/tangentToEnd)
+  * [`tangentialArc`](kcl/tangentialArc)
+  * [`tangentialArcTo`](kcl/tangentialArcTo)
+  * [`tangentialArcToRelative`](kcl/tangentialArcToRelative)
+  * [`toDegrees`](kcl/toDegrees)
+  * [`toRadians`](kcl/toRadians)
+  * [`xLine`](kcl/xLine)
+  * [`xLineTo`](kcl/xLineTo)
+  * [`yLine`](kcl/yLine)
+  * [`yLineTo`](kcl/yLineTo)
+  * [`yd`](kcl/yd)
+* **`std::math`**
+  * [`E`](kcl/const_std-math-E)
+  * [`PI`](kcl/const_std-math-PI)
+  * [`TAU`](kcl/const_std-math-TAU)
+  * [`cos`](kcl/std-math-cos)
+  * [`sin`](kcl/std-math-sin)
+  * [`tan`](kcl/std-math-tan)
+* **`std::prelude`**
+  * [`HALF_TURN`](kcl/const_std-prelude-HALF_TURN)
+  * [`QUARTER_TURN`](kcl/const_std-prelude-QUARTER_TURN)
+  * [`THREE_QUARTER_TURN`](kcl/const_std-prelude-THREE_QUARTER_TURN)
+  * [`ZERO`](kcl/const_std-prelude-ZERO)

docs/kcl/legAngX.md

@@ -26,7 +26,7 @@ legAngX(hypotenuse: number, leg: number) -> number
 
 ### Returns
 
-`number` 
+`number`
 
 
 ### Examples

docs/kcl/legAngY.md

@@ -26,7 +26,7 @@ legAngY(hypotenuse: number, leg: number) -> number
 
 ### Returns
 
-`number` 
+`number`
 
 
 ### Examples

docs/kcl/legLen.md

@@ -26,7 +26,7 @@ legLen(hypotenuse: number, leg: number) -> number
 
 ### Returns
 
-`number` 
+`number`
 
 
 ### Examples

docs/kcl/m.md

@@ -26,7 +26,7 @@ m() -> number
 
 ### Returns
 
-`number` 
+`number`
 
 
 ### Examples

docs/kcl/map.md

@@ -22,7 +22,7 @@ map(array: [KclValue], map_fn: FunctionParam) -> [KclValue]
 
 ### Returns
 
-[`[KclValue]`](/docs/kcl/types/KclValue) 
+[`[KclValue]`](/docs/kcl/types/KclValue)
 
 
 ### Examples

docs/kcl/mm.md

@@ -26,7 +26,7 @@ mm() -> number
 
 ### Returns
 
-`number` 
+`number`
 
 
 ### Examples

docs/kcl/modules.md

@@ -57,3 +57,55 @@ Imported symbols can be renamed for convenience or to avoid name collisions.
 ```
 import increment as inc, decrement as dec from "util.kcl"
 ```
+
+## Importing files from other CAD systems
+
+`import` can also be used to import files from other CAD systems. The format of the statement is the
+same as for KCL files. You can only import the whole file, not items from it. E.g.,
+
+```
+import "tests/inputs/cube.obj"
+
+// Use `cube` just like a KCL object.
+```
+
+```
+import "tests/inputs/cube-2.sldprt" as cube
+
+// Use `cube` just like a KCL object.
+```
+
+You can make the file format explicit using a format attribute (useful if using a different
+extension), e.g.,
+
+```
+@(format = obj)
+import "tests/inputs/cube"
+```
+
+For formats lacking unit data (such as STL, OBJ, or PLY files), the default
+unit of measurement is millimeters. Alternatively you may specify the unit
+by using an attirbute. Likewise, you can also specify a coordinate system. E.g.,
+
+```
+@(unitLength = ft, coords = opengl)
+import "tests/inputs/cube.obj"
+```
+
+When importing a GLTF file, the bin file will be imported as well.
+
+Import paths are relative to the current project directory. Imports currently only work when
+using the native Modeling App, not in the browser.
+
+### Supported values
+
+File formats: `fbx`, `gltf`/`glb`, `obj`+, `ply`+, `sldprt`, `step`/`stp`, `stl`+. (Those marked with a
+'+' support customising the length unit and coordinate system).
+
+Length units: `mm` (the default), `cm`, `m`, `inch`, `ft`, `yd`.
+
+Coordinate systems:
+
+- `zoo` (the default), forward: -Y, up: +Z, handedness: right
+- `opengl`, forward: +Z, up: +Y, handedness: right
+- `vulkan`, forward: +Z, up: -Y, handedness: left