flush

* fix: trying to figure out this pathing issue

* fix: found the bug

* fix: adding linter rule

* fix: rule for join('/') as well

* fix: removing useless string template

* fix: removing useless string template

* fix: ???? What ????

* fix: remove unused import

* fix: circular dep was added when I cleaned up the path logic, fixed the circular dep by passing args from the parent function

.codespellrc

@@ -1,3 +1,4 @@
 [codespell]
 ignore-words-list: crate,everytime,inout,co-ordinate,ot,nwo,atleast,ue,afterall,ser,fromM,FromM
-skip: **/target,node_modules,build,dist,./out,**/Cargo.lock,./docs/kcl/*.md,./e2e/playwright/lib/console-error-whitelist.ts,.package-lock.json,**/package-lock.json,./openapi/*.json,./packages/codemirror-lang-kcl/test/all.test.ts,./public/kcl-samples,./rust/kcl-lib/tests/kcl_samples,tsconfig.tsbuildinfo,./src/lib/machine-api.d.ts
+skip: **/target,node_modules,build,dist,./out,**/Cargo.lock,./docs/**/*.md,./e2e/playwright/lib/console-error-whitelist.ts,.package-lock.json,**/package-lock.json,./openapi/*.json,./packages/codemirror-lang-kcl/test/all.test.ts,./public/kcl-samples,./rust/kcl-lib/tests/kcl_samples,tsconfig.tsbuildinfo,./src/lib/machine-api.d.ts,./test-results,./playwright-report,./kcl-book/book
+

.eslintrc.json

@@ -19,6 +19,11 @@
     "plugin:jsx-a11y/recommended",
     "plugin:react-hooks/recommended"
   ],
+  "settings": {
+    "react": {
+      "version": "detect"
+    }
+  },
   "rules": {
     "no-array-constructor": "off", // This is wrong; use the @typescript-eslint one instead.
     "@typescript-eslint/no-array-constructor": "error",
@@ -61,6 +66,7 @@
     "jsx-a11y/click-events-have-key-events": "off",
     "jsx-a11y/no-autofocus": "off",
     "jsx-a11y/no-noninteractive-element-interactions": "off",
+    "react/no-unknown-property": "error",
     "no-restricted-globals": [
       "error",
       {
@@ -81,6 +87,14 @@
       {
         "selector": "CallExpression[callee.object.name='TOML'][callee.property.name='parse']",
         "message": "Do not use TOML.parse directly. Use the wrappers in test-utils instead like tomlToSettings."
+      },
+      {
+        "selector": "CallExpression[callee.property.name='split'] > Literal[value='/']",
+        "message": "Avoid using split with '/'."
+      },
+      {
+        "selector": "CallExpression[callee.property.name='join'] > Literal[value='/']",
+        "message": "Avoid using join with '/'."
       }
     ],
     "no-restricted-imports": [

.github/ci-cd-scripts/playwright-electron.sh

@@ -7,11 +7,11 @@ if [[ ! -f "test-results/.last-run.json" ]]; then
     # If no last run artifact, than run Playwright normally
     echo "run playwright normally"
     if [[ "$3" == *ubuntu* ]]; then
-        xvfb-run --auto-servernum --server-args="-screen 0 1280x960x24" -- npm run test:playwright:electron:ubuntu -- --shard=$1/$2 || true
+        xvfb-run --auto-servernum --server-args="-screen 0 1280x960x24" -- npm run test:playwright:electron -- --shard=$1/$2 || true
     elif [[ "$3" == *windows* ]]; then
-        npm run test:playwright:electron:windows -- --shard=$1/$2 || true
+        npm run test:playwright:electron -- --grep=@windows --shard=$1/$2 || true
     elif [[ "$3" == *macos* ]]; then
-        npm run test:playwright:electron:macos  -- --shard=$1/$2 || true
+        npm run test:playwright:electron -- --grep=@macos --shard=$1/$2 || true
     else
         echo "Do not run Playwright. Unable to detect os runtime."
         exit 1
@@ -26,16 +26,16 @@ max_retries=1
 # Retry failed tests, doing our own retries because using inbuilt Playwright retries causes connection issues
 while [[ $retry -le $max_retries ]]; do
     if [[ -f "test-results/.last-run.json" ]]; then
-        failed_tests=$(jq '.failedTests | length' test-results/.last-run.json)
-        if [[ $failed_tests -gt 0 ]]; then
+        status=$(jq -r '.status' test-results/.last-run.json)
+        if [[ "$status" == "failed" ]]; then
             echo "retried=true" >>$GITHUB_OUTPUT
             echo "run playwright with last failed tests and retry $retry"
             if [[ "$3" == *ubuntu* ]]; then
-                xvfb-run --auto-servernum --server-args="-screen 0 1280x960x24" -- npm run test:playwright:electron:ubuntu -- --last-failed || true
+                xvfb-run --auto-servernum --server-args="-screen 0 1280x960x24" -- npm run test:playwright:electron -- --last-failed || true
             elif [[ "$3" == *windows* ]]; then
-                npm run test:playwright:electron:windows -- --last-failed || true
+                npm run test:playwright:electron -- --grep=@windows --last-failed || true
             elif [[ "$3" == *macos* ]]; then
-                npm run test:playwright:electron:macos -- --last-failed || true
+                npm run test:playwright:electron -- --grep=@macos --last-failed || true
             else
                 echo "Do not run playwright. Unable to detect os runtime."
                 exit 1
@@ -56,10 +56,11 @@ done
 echo "retried=false" >>$GITHUB_OUTPUT
 
 if [[ -f "test-results/.last-run.json" ]]; then
-    failed_tests=$(jq '.failedTests | length' test-results/.last-run.json)
-    if [[ $failed_tests -gt 0 ]]; then
-        # If it still fails after 3 retries, then fail the job
+    status=$(jq -r '.status' test-results/.last-run.json)
+    if [[ "$status" == "failed" ]]; then
+        # If it still fails after retries, then fail the job
         exit 1
     fi
 fi
+
 exit 0

.github/dependabot.yml

@@ -16,9 +16,12 @@ updates:
     security:
       applies-to: security-updates
       update-types:
-      - major
       - minor
       - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
     patch:
       applies-to: version-updates
       update-types:
@@ -49,9 +52,408 @@ updates:
     security:
       applies-to: security-updates
       update-types:
-      - major
       - minor
       - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
+    patch:
+      applies-to: version-updates
+      update-types:
+      - patch
+    major:
+      applies-to: version-updates
+      update-types:
+      - major
+    minor:
+      applies-to: version-updates
+      update-types:
+      - minor
+      - patch
+- package-ecosystem: cargo
+  directory: /rust/kcl-python-bindings
+  schedule:
+    interval: weekly
+    day: monday
+    time: '03:00'
+    timezone: America/Los_Angeles
+  open-pull-requests-limit: 5
+  reviewers:
+  - adamchalmers
+  - franknoirot
+  - irev-dev
+  - jessfraz
+  groups:
+    security:
+      applies-to: security-updates
+      update-types:
+      - minor
+      - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
+    patch:
+      applies-to: version-updates
+      update-types:
+      - patch
+    major:
+      applies-to: version-updates
+      update-types:
+      - major
+    minor:
+      applies-to: version-updates
+      update-types:
+      - minor
+      - patch
+- package-ecosystem: cargo
+  directory: /rust/kcl-to-core
+  schedule:
+    interval: weekly
+    day: monday
+    time: '03:00'
+    timezone: America/Los_Angeles
+  open-pull-requests-limit: 5
+  reviewers:
+  - adamchalmers
+  - franknoirot
+  - irev-dev
+  - jessfraz
+  groups:
+    security:
+      applies-to: security-updates
+      update-types:
+      - minor
+      - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
+    patch:
+      applies-to: version-updates
+      update-types:
+      - patch
+    major:
+      applies-to: version-updates
+      update-types:
+      - major
+    minor:
+      applies-to: version-updates
+      update-types:
+      - minor
+      - patch
+- package-ecosystem: cargo
+  directory: /rust/kcl-language-server-release
+  schedule:
+    interval: weekly
+    day: monday
+    time: '03:00'
+    timezone: America/Los_Angeles
+  open-pull-requests-limit: 5
+  reviewers:
+  - adamchalmers
+  - franknoirot
+  - irev-dev
+  - jessfraz
+  groups:
+    security:
+      applies-to: security-updates
+      update-types:
+      - minor
+      - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
+    patch:
+      applies-to: version-updates
+      update-types:
+      - patch
+    major:
+      applies-to: version-updates
+      update-types:
+      - major
+    minor:
+      applies-to: version-updates
+      update-types:
+      - minor
+      - patch
+- package-ecosystem: cargo
+  directory: /rust/kcl-wasm-lib
+  schedule:
+    interval: weekly
+    day: monday
+    time: '03:00'
+    timezone: America/Los_Angeles
+  open-pull-requests-limit: 5
+  reviewers:
+  - adamchalmers
+  - franknoirot
+  - irev-dev
+  - jessfraz
+  groups:
+    security:
+      applies-to: security-updates
+      update-types:
+      - minor
+      - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
+    patch:
+      applies-to: version-updates
+      update-types:
+      - patch
+    major:
+      applies-to: version-updates
+      update-types:
+      - major
+    minor:
+      applies-to: version-updates
+      update-types:
+      - minor
+      - patch
+- package-ecosystem: cargo
+  directory: /rust/kcl-derive-docs
+  schedule:
+    interval: weekly
+    day: monday
+    time: '03:00'
+    timezone: America/Los_Angeles
+  open-pull-requests-limit: 5
+  reviewers:
+  - adamchalmers
+  - franknoirot
+  - irev-dev
+  - jessfraz
+  groups:
+    security:
+      applies-to: security-updates
+      update-types:
+      - minor
+      - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
+    patch:
+      applies-to: version-updates
+      update-types:
+      - patch
+    major:
+      applies-to: version-updates
+      update-types:
+      - major
+    minor:
+      applies-to: version-updates
+      update-types:
+      - minor
+      - patch
+- package-ecosystem: cargo
+  directory: /rust/kcl-bumper
+  schedule:
+    interval: weekly
+    day: monday
+    time: '03:00'
+    timezone: America/Los_Angeles
+  open-pull-requests-limit: 5
+  reviewers:
+  - adamchalmers
+  - franknoirot
+  - irev-dev
+  - jessfraz
+  groups:
+    security:
+      applies-to: security-updates
+      update-types:
+      - minor
+      - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
+    patch:
+      applies-to: version-updates
+      update-types:
+      - patch
+    major:
+      applies-to: version-updates
+      update-types:
+      - major
+    minor:
+      applies-to: version-updates
+      update-types:
+      - minor
+      - patch
+- package-ecosystem: cargo
+  directory: /rust/kcl-language-server
+  schedule:
+    interval: weekly
+    day: monday
+    time: '03:00'
+    timezone: America/Los_Angeles
+  open-pull-requests-limit: 5
+  reviewers:
+  - adamchalmers
+  - franknoirot
+  - irev-dev
+  - jessfraz
+  groups:
+    security:
+      applies-to: security-updates
+      update-types:
+      - minor
+      - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
+    patch:
+      applies-to: version-updates
+      update-types:
+      - patch
+    major:
+      applies-to: version-updates
+      update-types:
+      - major
+    minor:
+      applies-to: version-updates
+      update-types:
+      - minor
+      - patch
+- package-ecosystem: cargo
+  directory: /rust/kcl-lib
+  schedule:
+    interval: weekly
+    day: monday
+    time: '03:00'
+    timezone: America/Los_Angeles
+  open-pull-requests-limit: 5
+  reviewers:
+  - adamchalmers
+  - franknoirot
+  - irev-dev
+  - jessfraz
+  groups:
+    security:
+      applies-to: security-updates
+      update-types:
+      - minor
+      - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
+    patch:
+      applies-to: version-updates
+      update-types:
+      - patch
+    major:
+      applies-to: version-updates
+      update-types:
+      - major
+    minor:
+      applies-to: version-updates
+      update-types:
+      - minor
+      - patch
+- package-ecosystem: cargo
+  directory: /rust/kcl-lib/fuzz
+  schedule:
+    interval: weekly
+    day: monday
+    time: '03:00'
+    timezone: America/Los_Angeles
+  open-pull-requests-limit: 5
+  reviewers:
+  - adamchalmers
+  - franknoirot
+  - irev-dev
+  - jessfraz
+  groups:
+    security:
+      applies-to: security-updates
+      update-types:
+      - minor
+      - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
+    patch:
+      applies-to: version-updates
+      update-types:
+      - patch
+    major:
+      applies-to: version-updates
+      update-types:
+      - major
+    minor:
+      applies-to: version-updates
+      update-types:
+      - minor
+      - patch
+- package-ecosystem: cargo
+  directory: /rust/kcl-test-server
+  schedule:
+    interval: weekly
+    day: monday
+    time: '03:00'
+    timezone: America/Los_Angeles
+  open-pull-requests-limit: 5
+  reviewers:
+  - adamchalmers
+  - franknoirot
+  - irev-dev
+  - jessfraz
+  groups:
+    security:
+      applies-to: security-updates
+      update-types:
+      - minor
+      - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
+    patch:
+      applies-to: version-updates
+      update-types:
+      - patch
+    major:
+      applies-to: version-updates
+      update-types:
+      - major
+    minor:
+      applies-to: version-updates
+      update-types:
+      - minor
+      - patch
+- package-ecosystem: cargo
+  directory: /rust/kcl-directory-test-macro
+  schedule:
+    interval: weekly
+    day: monday
+    time: '03:00'
+    timezone: America/Los_Angeles
+  open-pull-requests-limit: 5
+  reviewers:
+  - adamchalmers
+  - franknoirot
+  - irev-dev
+  - jessfraz
+  groups:
+    security:
+      applies-to: security-updates
+      update-types:
+      - minor
+      - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
     patch:
       applies-to: version-updates
       update-types:
@@ -82,9 +484,12 @@ updates:
     security:
       applies-to: security-updates
       update-types:
-      - major
       - minor
       - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
     patch:
       applies-to: version-updates
       update-types:
@@ -115,9 +520,12 @@ updates:
     security:
       applies-to: security-updates
       update-types:
-      - major
       - minor
       - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
     patch:
       applies-to: version-updates
       update-types:
@@ -148,9 +556,12 @@ updates:
     security:
       applies-to: security-updates
       update-types:
-      - major
       - minor
       - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
     patch:
       applies-to: version-updates
       update-types:
@@ -181,9 +592,12 @@ updates:
     security:
       applies-to: security-updates
       update-types:
-      - major
       - minor
       - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
     patch:
       applies-to: version-updates
       update-types:
@@ -214,9 +628,12 @@ updates:
     security:
       applies-to: security-updates
       update-types:
-      - major
       - minor
       - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
     patch:
       applies-to: version-updates
       update-types:
@@ -247,9 +664,12 @@ updates:
     security:
       applies-to: security-updates
       update-types:
-      - major
       - minor
       - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
     patch:
       applies-to: version-updates
       update-types:
@@ -280,9 +700,12 @@ updates:
     security:
       applies-to: security-updates
       update-types:
-      - major
       - minor
       - patch
+    security-major:
+      applies-to: security-updates
+      update-types:
+      - major
     patch:
       applies-to: version-updates
       update-types:

.github/workflows/cargo-bench.yml

@@ -26,12 +26,8 @@ name: cargo bench
 jobs:
   cargo-bench:
     name: cargo bench
-    runs-on:
-      - runs-on=${{ github.run_id }}
-      - runner=32cpu-linux-x64
-      - extras=s3-cache
+    runs-on: ubuntu-latest
     steps:
-      - uses: runs-on/action@v1
       - uses: actions/checkout@v4
       - name: Use correct Rust toolchain
         shell: bash

.github/workflows/cargo-test.yml

@@ -13,10 +13,14 @@ concurrency:
   cancel-in-progress: true
 name: cargo test
 jobs:
-  cargotest:
-    name: cargo test
-    runs-on: ubuntu-latest-8-cores
+  build-test-artifacts:
+    name: Build test artifacts
+    runs-on:
+      - runs-on=${{ github.run_id }}
+      - runner=8cpu-linux-x64
+      - extras=s3-cache
     steps:
+      - uses: runs-on/action@v1
       - uses: actions/create-github-app-token@v1
         id: app-token
         with:
@@ -39,7 +43,6 @@ jobs:
         env:
           GH_ACTIONS_AXIOM_TOKEN: ${{ secrets.GH_ACTIONS_AXIOM_TOKEN }}
           OS_NAME: ${{ env.OS_NAME }}
-      - uses: taiki-e/install-action@cargo-llvm-cov
       - uses: taiki-e/install-action@nextest
       - name: Install just
         uses: taiki-e/install-action@just
@@ -81,11 +84,11 @@ jobs:
         run: |
           set -euo pipefail
           cd rust
-          cargo nextest run --workspace --retries=2 --no-fail-fast --profile ci simulation_tests::kcl_samples 2>&1 | tee /tmp/github-actions.log
+          cargo nextest run --workspace --features artifact-graph --retries=10 --no-fail-fast --profile ci simulation_tests::kcl_samples 2>&1 | tee /tmp/github-actions.log
         env:
-          KITTYCAD_API_TOKEN: ${{secrets.KITTYCAD_API_TOKEN}}
+          KITTYCAD_API_TOKEN: ${{secrets.KITTYCAD_API_TOKEN_DEV}}
+          ZOO_HOST: https://api.dev.zoo.dev
           RUST_BACKTRACE: full
-          RUST_MIN_STACK: 10485760000
       - name: Commit differences
         if: steps.path-changes.outputs.outside-kcl-samples == 'false' && steps.cargo-test-kcl-samples.outcome == 'failure'
         shell: bash
@@ -114,27 +117,73 @@ jobs:
         env:
           # The default is auto, and insta behaves differently in CI vs. not.
           INSTA_UPDATE: always
-          KITTYCAD_API_TOKEN: ${{secrets.KITTYCAD_API_TOKEN}}
+          KITTYCAD_API_TOKEN: ${{secrets.KITTYCAD_API_TOKEN_DEV}}
+          ZOO_HOST: https://api.dev.zoo.dev
           # Configure nextest when it's run by insta (via just).
           NEXTEST_PROFILE: ci
           RUST_BACKTRACE: full
-          RUST_MIN_STACK: 10485760000
-      - name: cargo test
-        if: steps.path-changes.outputs.outside-kcl-samples == 'true'
+      - name: Build and archive tests
+        run: |
+          cd rust
+          cargo nextest archive --workspace --features artifact-graph --archive-file nextest-archive.tar.zst
+      - name: Upload archive to workflow
+        uses: actions/upload-artifact@v4
+        with:
+          name: nextest-archive
+          path: rust/nextest-archive.tar.zst
+
+  run-test-artifacts:
+    name: cargo test (shard ${{ matrix.partitionIndex}})
+    runs-on:
+      - runs-on=${{ github.run_id }}
+      - runner=32cpu-linux-x64
+      - extras=s3-cache
+    needs: build-test-artifacts
+    strategy:
+      fail-fast: false
+      matrix:
+        partitionIndex: [1, 2, 3, 4, 5, 6]
+        partitionTotal: [6]
+    steps:
+      - uses: runs-on/action@v1
+      - 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 }}
+      - name: Use correct Rust toolchain
+        shell: bash
+        run: |
+          [ -e rust-toolchain.toml ] || cp rust/rust-toolchain.toml ./
+      - name: Install rust
+        uses: actions-rust-lang/setup-rust-toolchain@v1
+        with:
+          cache: false # Configured below.
+      - name: Start Vector
+        run: .github/ci-cd-scripts/start-vector-ubuntu.sh
+        env:
+          GH_ACTIONS_AXIOM_TOKEN: ${{ secrets.GH_ACTIONS_AXIOM_TOKEN }}
+          OS_NAME: ${{ env.OS_NAME }}
+      - uses: taiki-e/install-action@nextest
+      - name: Download archive
+        uses: actions/download-artifact@v4
+        with:
+          name: nextest-archive
+      - name: Run tests
         shell: bash
         run: |-
+          cp nextest-archive.tar.zst rust/nextest-archive.tar.zst
+          ls -lah
           cd rust
-          cargo llvm-cov nextest --workspace --lcov --output-path lcov.info --retries=2 --no-fail-fast -P ci 2>&1 | tee /tmp/github-actions.log
+          cargo nextest run\
+           --retries=10 --no-fail-fast --profile ci --archive-file nextest-archive.tar.zst \
+           --partition count:${{ matrix.partitionIndex}}/${{ matrix.partitionTotal }} \
+           2>&1 | tee /tmp/github-actions.log
         env:
-          KITTYCAD_API_TOKEN: ${{secrets.KITTYCAD_API_TOKEN}}
-          RUST_MIN_STACK: 10485760000
-      - name: Upload to codecov.io
-        if: steps.path-changes.outputs.outside-kcl-samples == 'true'
-        uses: codecov/codecov-action@v5
-        with:
-          token: ${{secrets.CODECOV_TOKEN}}
-          fail_ci_if_error: true
-          flags: rust
-          verbose: true
-          files: lcov.info
+          KITTYCAD_API_TOKEN: ${{secrets.KITTYCAD_API_TOKEN_DEV}}
+          ZOO_HOST: https://api.dev.zoo.dev
 

.github/workflows/e2e-tests.yml

@@ -3,7 +3,6 @@ on:
   push:
     branches:
       - main
-      - all-e2e # this bypasses `fixme()` using `orRunWhenFullSuiteEnabled()`
   pull_request:
   schedule:
     - cron: 0 * * * *  # hourly
@@ -278,28 +277,42 @@ jobs:
     timeout-minutes: 60
     env:
       OS_NAME: ${{ contains(matrix.os, 'ubuntu') && 'ubuntu' || (contains(matrix.os, 'windows') && 'windows' || 'macos') }}
-    name: playwright:electron:${{ contains(matrix.os, 'ubuntu') && 'ubuntu' || (contains(matrix.os, 'windows') && 'windows' || 'macos') }}:${{ matrix.shardIndex }}:${{ matrix.shardTotal }}
+    name: playwright:electron:${{ contains(matrix.os, 'ubuntu') && 'ubuntu' || (contains(matrix.os, 'windows') && 'windows' || 'macos') }} (shard ${{ matrix.shardIndex }})
     strategy:
       fail-fast: false
       matrix:
         # TODO: enable namespace-profile-windows-latest once available
-        os:
-          - "runs-on=${{ github.run_id }}/family=i7ie.2xlarge/image=ubuntu22-full-x64"
-          - namespace-profile-macos-6-cores
-          - windows-latest-8-cores
-        shardIndex: [1, 2, 3, 4]
-        shardTotal: [4]
-        # Disable macos and windows tests on hourly e2e tests since we only care
-        # about server side changes.
-        # Technique from https://github.com/joaomcteixeira/python-project-skeleton/pull/31/files
-        isScheduled:
-          - ${{ github.event_name == 'schedule' }}
-        exclude:
-          - os: namespace-profile-macos-6-cores
-            isScheduled: true
+        include:
+          - os: "runs-on=${{ github.run_id }}/family=i7ie.2xlarge/image=ubuntu22-full-x64"
+            shardIndex: 1
+            shardTotal: 8
+          - os: "runs-on=${{ github.run_id }}/family=i7ie.2xlarge/image=ubuntu22-full-x64"
+            shardIndex: 2
+            shardTotal: 8
+          - os: "runs-on=${{ github.run_id }}/family=i7ie.2xlarge/image=ubuntu22-full-x64"
+            shardIndex: 3
+            shardTotal: 8
+          - os: "runs-on=${{ github.run_id }}/family=i7ie.2xlarge/image=ubuntu22-full-x64"
+            shardIndex: 4
+            shardTotal: 8
+          - os: "runs-on=${{ github.run_id }}/family=i7ie.2xlarge/image=ubuntu22-full-x64"
+            shardIndex: 5
+            shardTotal: 8
+          - os: "runs-on=${{ github.run_id }}/family=i7ie.2xlarge/image=ubuntu22-full-x64"
+            shardIndex: 6
+            shardTotal: 8
+          - os: "runs-on=${{ github.run_id }}/family=i7ie.2xlarge/image=ubuntu22-full-x64"
+            shardIndex: 7
+            shardTotal: 8
+          - os: "runs-on=${{ github.run_id }}/family=i7ie.2xlarge/image=ubuntu22-full-x64"
+            shardIndex: 8
+            shardTotal: 8
+          - os: namespace-profile-macos-8-cores
+            shardIndex: 1
+            shardTotal: 1
           - os: windows-latest-8-cores
-            isScheduled: true
-        # TODO: add ref here for main and latest release tag
+            shardIndex: 1
+            shardTotal: 1
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@v4

.github/workflows/generate-website-docs.yml

@@ -38,15 +38,13 @@ jobs:
         run: |
           mkdir -p documentation/content/pages/docs/kcl/
           # cleanup old
-          rm -rf documentation/content/pages/docs/kcl/*.md
-          rm -rf documentation/content/pages/docs/kcl/types
-          rm -rf documentation/content/pages/docs/kcl/settings
-          rm -rf documentation/content/pages/docs/kcl/consts
+          rm -rf documentation/content/pages/docs/kcl-std
+          rm -rf documentation/content/pages/docs/kcl-lang
           # move new
-          mv -f docs/kcl/*.md documentation/content/pages/docs/kcl/
-          mv -f docs/kcl/types documentation/content/pages/docs/kcl/
-          mv -f docs/kcl/settings documentation/content/pages/docs/kcl/
-          mv -f docs/kcl/consts documentation/content/pages/docs/kcl/
+          mv -f docs/kcl-std documentation/content/pages/docs
+          mv -f docs/kcl-lang documentation/content/pages/docs
+          # We don't need the README
+          rm documentation/content/pages/docs/kcl-std/README.md
       - name: move kcl-samples
         shell: bash
         run: |

.github/workflows/kcl-python-bindings.yml

@@ -125,7 +125,8 @@ jobs:
           just setup-uv
           just test
         env:
-          KITTYCAD_API_TOKEN: ${{ secrets.KITTYCAD_API_TOKEN }}
+          KITTYCAD_API_TOKEN: ${{ secrets.KITTYCAD_API_TOKEN_DEV }}
+          ZOO_HOST: https://api.dev.zoo.dev
 
   sdist:
     runs-on: ubuntu-latest

.github/workflows/update-e2e-branch.yml

@@ -1,45 +0,0 @@
-name: update-e2e-branch
-
-# This is used to sync the `all-e2e` branch with the `main` branch for the
-# logic in the test utility `orRunWhenFullSuiteEnabled()` that allows all e2e
-# tests to run on a particular branch to analyze failures metrics in Axiom.
-
-on:
-  schedule:
-    - cron: '0 * * * *' # runs every hour
-
-permissions:
-  contents: write
-
-jobs:
-  update-branch:
-    runs-on: ubuntu-latest
-    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 }}
-
-      - name: Sync with main
-        run: |
-          # Create the branch
-          git checkout all-e2e || git checkout -b all-e2e
-
-          # Reset to main
-          git fetch origin
-          git reset --hard origin/main
-
-          # Get a new SHA to prevent overwriting the commit status on main
-          git config --local user.email "github-actions[bot]@users.noreply.github.com"
-          git config --local user.name "github-actions[bot]"
-          git commit --allow-empty --message="[all-e2e] $(git log --max-count=1 --pretty=%B)"
-
-          # Overwrite the branch
-          git remote set-url origin https://x-access-token:${{ steps.app-token.outputs.token }}@github.com/${{ github.repository }}.git
-          git push --force origin all-e2e

.gitignore

@@ -85,3 +85,4 @@ venv
 
 .vscode-test
 .biome/
+.million

.helix/languages.toml

@@ -5,6 +5,6 @@ command = "vscode-eslint-language-server"
 [[language]]
 name = "typescript"
 auto-format = true
-formatter = { command = "node_modules/.bin/prettier", args = ["--parser", "typescript"] }
-language-servers = [ { name = "eslint", only-features = [ "diagnostics" ] }, "typescript-language-server" ]
+formatter = { command = "./node_modules/@biomejs/biome/bin/biome", args = ["format", "--write", "--stdin-file-path=foo.ts"] }
+# language-servers = [ { name = "eslint", only-features = [ "diagnostics" ] }, "typescript-language-server" ]
 

.husky/pre-commit

@@ -0,0 +1 @@
+npm run fmt

.husky/pre-push

@@ -1,4 +0,0 @@
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
-npm run fmt-check

CONTRIBUTING.md

@@ -97,7 +97,7 @@ The following will need to be run when checking out a new commit and guarantees
 ```bash
 npm install
 npm run build:wasm
-npm start # or npm run build:local && npm run serve for slower but more production-like build
+npm start
 ```
 
 ## Before submitting a PR

Makefile

@@ -49,14 +49,9 @@ REACT_SOURCES := $(wildcard src/*.tsx) $(wildcard src/**/*.tsx)
 TYPESCRIPT_SOURCES := tsconfig.* $(wildcard src/*.ts) $(wildcard src/**/*.ts)
 VITE_SOURCES := $(wildcard vite.*) $(wildcard vite/**/*.tsx)
 
+
 .PHONY: build
-build: build-web build-desktop
-
-.PHONY: build-web
-build-web: install public/kcl_wasm_lib_bg.wasm build/index.html
-
-.PHONY: build-desktop
-build-desktop: install public/kcl_wasm_lib_bg.wasm .vite/build/main.js
+build: install public/kcl_wasm_lib_bg.wasm .vite/build/main.js
 
 public/kcl_wasm_lib_bg.wasm: $(CARGO_SOURCES) $(RUST_SOURCES)
 ifdef WINDOWS
@@ -65,9 +60,6 @@ else
 	npm run build:wasm:dev
 endif
 
-build/index.html: $(REACT_SOURCES) $(TYPESCRIPT_SOURCES) $(VITE_SOURCES)
-	npm run build:local
-
 .vite/build/main.js: $(REACT_SOURCES) $(TYPESCRIPT_SOURCES) $(VITE_SOURCES)
 	npm run tronb:vite:dev
 
@@ -95,11 +87,11 @@ TARGET ?= desktop
 run: run-$(TARGET)
 
 .PHONY: run-web
-run-web: install build-web ## Start the web app
+run-web: install build ## Start the web app
 	npm run start
 
 .PHONY: run-desktop
-run-desktop: install build-desktop ## Start the desktop app
+run-desktop: install build ## Start the desktop app
 	npm run tron:start
 
 ###############################################################################
@@ -121,7 +113,7 @@ test-unit: install ## Run the unit tests
 test-e2e: test-e2e-$(TARGET)
 
 .PHONY: test-e2e-web
-test-e2e-web: install build-web ## Run the web e2e tests
+test-e2e-web: install build ## Run the web e2e tests
 	@ curl -fs localhost:3000 >/dev/null || ( echo "Error: localhost:3000 not available, 'make run-web' first" && exit 1 )
 ifdef E2E_GREP
 	npm run chrome:test -- --headed --grep="$(E2E_GREP)" --max-failures=$(E2E_FAILURES)
@@ -130,7 +122,7 @@ else
 endif
 
 .PHONY: test-e2e-desktop
-test-e2e-desktop: install build-desktop ## Run the desktop e2e tests
+test-e2e-desktop: install build ## Run the desktop e2e tests
 ifdef E2E_GREP
 	npm run test:playwright:electron -- --grep="$(E2E_GREP)" --max-failures=$(E2E_FAILURES)
 else

docs/kcl-lang/index.md

@@ -0,0 +1,12 @@
+---
+title: "KCL Language Guide"
+excerpt: "Documentation of the KCL language for the Zoo Design Studio."
+layout: manual
+---
+
+## Topics
+
+* [`Types`](/docs/kcl-lang/types)
+* [`Modules`](/docs/kcl-lang/modules)
+* [`Settings`](/docs/kcl-lang/settings)
+* [`Known Issues`](/docs/kcl-lang/known-issues)

docs/kcl-lang/known-issues.md

@@ -21,4 +21,6 @@ once fixed in engine will just start working here with no language changes.
 - **Chamfers**: Chamfers cannot intersect, you will get an error. Only simple
     chamfer cases work currently.
 
-- **Appearance**: Changing the appearance on a loft does not work.
+- **Appearance**: Changing the appearance on a loft does not work. 
+
+- **CSG Booleans**: Coplanar (bodies that share a plane) unions, subtractions, and intersections are not currently supported.

docs/kcl-lang/modules.md

@@ -0,0 +1,365 @@
+---
+title: "KCL Modules"
+excerpt: "Documentation of modules for the KCL language for the Zoo Design Studio."
+layout: manual
+---
+
+`KCL` allows splitting code up into multiple files.  Each file is somewhat
+isolated from other files as a separate module.
+
+When you define a function, you can use `export` before it to make it available
+to other modules.
+
+```kcl
+// util.kcl
+export fn increment(@x) {
+  return x + 1
+}
+```
+
+Other files in the project can now import functions that have been exported.
+This makes them available to use in another file.
+
+```norun
+// main.kcl
+import increment from "util.kcl"
+
+answer = increment(41)
+```
+
+Imported files _must_ be in the same project so that units are uniform across
+modules. This means that it must be in the same directory.
+
+Import statements must be at the top-level of a file. It is not allowed to have
+an `import` statement inside a function or in the body of an if‑else.
+
+Multiple functions can be exported in a file.
+
+```kcl
+// util.kcl
+export fn increment(@x) {
+  return x + 1
+}
+
+export fn decrement(@x) {
+  return x - 1
+}
+```
+
+When importing, you can import multiple functions at once.
+
+```norun
+import increment, decrement from "util.kcl"
+```
+
+Imported symbols can be renamed for convenience or to avoid name collisions.
+
+```norun
+import increment as inc, decrement as dec from "util.kcl"
+```
+
+---
+
+## Functions vs `clone`
+
+There are two common patterns for re‑using geometry:
+
+1. **Wrap the construction in a function** – flexible and fully parametric.
+2. **Duplicate an existing object with `clone`** – lightning‑fast, but an exact
+   duplicate.
+
+### Parametric function example
+
+```kcl
+fn cube(center) {
+  return startSketchOn(XY)
+    |> startProfile(at = [center[0] - 10, center[1] - 10])
+    |> line(endAbsolute = [center[0] + 10, center[1] - 10])
+    |> line(endAbsolute = [center[0] + 10, center[1] + 10])
+    |> line(endAbsolute = [center[0] - 10, center[1] + 10])
+    |> close()
+    |> extrude(length = 10)
+}
+
+myCube = cube(center = [0, 0])
+```
+
+*Pros*
+- Any argument can be a parameter – size, position, appearance, etc.
+- Works great inside loops, arrays, or optimisation sweeps.
+
+*Cons*
+- Every invocation rebuilds the entire feature tree.
+- **Slower** than a straight duplicate – each call is its own render job.
+
+### `clone` example
+
+```kcl
+sketch001 = startSketchOn(-XZ)
+  |> circle(center = [0, 0], radius = 10)
+  |> extrude(length = 5) 
+  |> appearance(color = "#ff0000", metalness = 90, roughness = 90)
+
+sketch002 = clone(sketch001)  // ✓ instant copy
+```
+
+*Pros*
+- Roughly an O(1) operation – we just duplicate the underlying engine handle.
+- Perfect when you need ten identical bolts or two copies of the same imported STEP file.
+
+*Cons*
+- **Not parametric** – the clone is exactly the same shape as the source.
+- If you need to tweak dimensions per‑instance, you’re back to a function.
+
+> **Rule of thumb** – Reach for `clone` when the geometry is already what you want. Reach for a function when you need customisation.
+
+---
+
+## Module‑level parallelism
+
+Under the hood, the Design Studio runs **every module in parallel** where it can. This means:
+
+- The top‑level code of `foo.kcl`, `bar.kcl`, and `baz.kcl` all start executing immediately and concurrently.
+- Imports that read foreign files (STEP/OBJ/…) overlap their I/O and background render.
+- CPU‑bound calculations in separate modules get their own worker threads.
+
+### Why modules beat one‑big‑file
+
+If you shoe‑horn everything into `main.kcl`, each statement runs sequentially:
+
+```norun
+import "big.step" as gizmo  // blocks main while reading
+
+gizmo |> translate(x=50)    // blocks again while waiting for render
+```
+
+Split `gizmo` into its own file and the read/render can overlap whatever else `main.kcl` is doing.
+
+```norun
+// gizmo.kcl                   (worker A)
+import "big.step"
+
+// main.kcl                    (worker B)
+import "gizmo.kcl" as gizmo   // non‑blocking
+
+// ... other setup ...
+
+gizmo |> translate(x=50)      // only blocks here
+```
+
+### Gotcha: defining but **not** calling functions
+
+Defining a function inside a module is instantaneous – we just record the byte‑code. The heavy lifting happens when the function is **called**. So:
+
+```norun
+// util.kcl
+export fn makeBolt(size) { /* … expensive CAD … */ }
+```
+
+If `main.kcl` waits until the very end to call `makeBolt`, *none* of that work was parallelised – you’ve pushed the cost back onto the serial tail of your script.
+
+**Better:** call it early or move the invocation into another module.
+
+```norun
+// bolt_instance.kcl
+import makeBolt from "util.kcl"
+bolt = makeBolt(5)  // executed in parallel
+bolt
+```
+
+Now `main.kcl` can `import "bolt_instance.kcl" as bolt` and get the result that was rendered while it was busy doing other things.
+
+---
+
+## Whole module import
+
+You can also import the whole module. This is useful if you want to use the
+result of a module as a variable, like a part.
+
+```norun
+import "tests/inputs/cube.kcl" as cube
+cube
+  |> translate(x=10)
+```
+
+This imports the whole module and makes it available as `cube`. You can then
+use it like any other object. The `cube` variable is now a reference to the
+result of the module. This means that if you change the module, the `cube`
+variable will change as well.
+
+In `cube.kcl`, you cannot have multiple objects. It has to be a single part. If
+you have multiple objects, you will get an error. This is because the module is
+expected to return a single object that can be used as a variable.
+
+The last expression or variable definition becomes the module's return value.
+The module is expected to return a single object that can be used as a variable
+by whatever imports it.
+
+So for example, this is allowed:
+
+```norun
+... a bunch of code to create cube and cube2 ...
+
+myUnion = union([cube, cube2])
+```
+
+You can also do this:
+
+```norun
+... a bunch of code to create cube and cube2 ...
+
+union([cube, cube2])
+```
+
+Either way, the last line will return the union of the two objects.
+
+Or what you could do instead is:
+
+```norun
+... a bunch of code to create cube and cube2 ...
+
+myUnion = union([cube, cube2])
+myUnion
+```
+
+This will assign the union of the two objects to a variable, and then return it
+on the last statement. It's simply another way of doing the same thing.
+
+The final statement is what's important because it's the return value of the
+entire module. The module is expected to return a single object that can be used
+as a variable by the file that imports it.
+
+---
+
+## Multiple instances of the same import
+
+Whether you are importing a file from another CAD system or a KCL file, that
+file represents object(s) in memory. If you import the same file multiple times,
+it will only be rendered once.
+
+If you want to have multiple instances of the same object, you can use the
+[`clone`](/docs/kcl/clone) function. This will render a new instance of the object in memory.
+
+```norun
+import cube from "tests/inputs/cube.kcl"
+
+cube  
+  |> translate(x=10)
+clone(cube)
+  |> translate(x=20)
+```
+
+In the sample above, the `cube` object is imported from a KCL file. The first
+instance is translated 10 units in the x direction. The second instance is
+cloned and translated 20 units in the x direction. The two instances are now
+separate objects in memory, and can be manipulated independently.
+
+Here is an example with a file from another CAD system:
+
+```kcl
+import "tests/inputs/cube.step" as cube
+
+cube
+  |> translate(x=10)
+clone(cube)
+  |> translate(x=20)
+```
+
+---
+
+## 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.,
+
+```norun
+import "tests/inputs/cube.obj"
+
+// Use `cube` just like a KCL object.
+```
+
+```kcl
+import "tests/inputs/cube.sldprt" as cube
+
+// Use `cube` just like a KCL object.
+```
+
+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 attribute. Likewise, you can also specify a coordinate system. E.g.,
+
+```kcl
+@(lengthUnit = 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 Design Studio, 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
+
+---
+
+## Performance deep‑dive for foreign‑file imports
+
+Parallelized foreign‑file imports now let you overlap file reads, initialization,
+and rendering. To maximize throughput, you need to understand the three distinct
+stages—reading, initializing (background render start), and invocation (blocking)
+—and structure your code to defer blocking operations until the end.
+
+### Foreign import execution stages
+
+1. **Import (Read / Initialization) Stage**
+   ```kcl
+   import "tests/inputs/cube.step" as cube
+   ```
+   - Reads the file from disk and makes its API available.
+   - Starts engine rendering but **does not block** your script.
+   - This kick‑starts the render pipeline while you keep executing other code.
+
+2. **Invocation (Blocking) Stage**
+   ```kcl
+   import "tests/inputs/cube.step" as cube
+
+   cube
+     |> translate(z=10) // ← blocks here only
+   ```
+   - Any method call (e.g., `translate`, `scale`, `rotate`) waits for the background render to finish before applying transformations.
+
+### Best practices
+
+#### 1. Defer blocking calls
+
+```kcl
+import "tests/inputs/cube.step" as cube     // 1) Read / Background render starts
+
+
+// --- perform other operations and calculations here ---
+
+
+cube
+  |> translate(z=10)                        // 2) Blocks only here
+```
+
+#### 2. Split heavy work into separate modules
+
+Place computationally expensive or IO‑heavy work into its own module so it can render in parallel while `main.kcl` continues.
+
+#### Future improvements
+
+Upcoming releases will auto‑analyse dependencies and only block when truly necessary. Until then, explicit deferral will give you the best performance.
+
+

docs/kcl-lang/settings-project.md

@@ -55,20 +55,6 @@ This setting has further nested options. See the schema for full details.
 The onboarding status of the app.
 
 
-**Default:** None
-
-##### theme_color
-
-The hue of the primary theme color for the app.
-
-
-**Default:** None
-
-##### enable_ssao
-
-Whether or not Screen Space Ambient Occlusion (SSAO) is enabled.
-
-
 **Default:** None
 
 ##### dismiss_web_banner
@@ -128,13 +114,6 @@ The default unit to use in modeling dimensions.
 Highlight edges of 3D objects?
 
 
-**Default:** None
-
-##### show_debug_panel
-
-Whether to show the debug panel, which lets you see various states of the app to aid in development. Remove this when we remove backwards compatibility with the old settings file.
-
-
 **Default:** None
 
 ##### enable_ssao

docs/kcl-lang/settings-user.md

@@ -57,34 +57,6 @@ This setting has further nested options. See the schema for full details.
 The onboarding status of the app.
 
 
-**Default:** None
-
-##### project_directory
-
-Backwards compatible project directory setting.
-
-
-**Default:** None
-
-##### theme
-
-Backwards compatible theme setting.
-
-
-**Default:** None
-
-##### theme_color
-
-The hue of the primary theme color for the app.
-
-
-**Default:** None
-
-##### enable_ssao
-
-Whether or not Screen Space Ambient Occlusion (SSAO) is enabled.
-
-
 **Default:** None
 
 ##### dismiss_web_banner
@@ -103,7 +75,7 @@ When the user is idle, teardown the stream after some time.
 
 ##### allow_orbit_in_sketch_mode
 
-When the user is idle, and this is true, the stream will be torn down.
+Allow orbiting in sketch mode.
 
 
 **Default:** None
@@ -159,13 +131,6 @@ The controls for how to navigate the 3D view.
 Highlight edges of 3D objects?
 
 
-**Default:** None
-
-##### show_debug_panel
-
-Whether to show the debug panel, which lets you see various states of the app to aid in development. Remove this when we remove backwards compatibility with the old settings file.
-
-
 **Default:** None
 
 ##### enable_ssao

docs/kcl-lang/settings.md

@@ -8,16 +8,16 @@ layout: manual
 
 There are three levels of settings available in Zoo Design Studio:
 
-1. [User Settings](/docs/kcl/settings/user): Global settings that apply to all projects, stored in `user.toml`
-2. [Project Settings](/docs/kcl/settings/project): Settings specific to a project, stored in `project.toml`
+1. [User Settings](/docs/kcl/settings-user): Global settings that apply to all projects, stored in `user.toml`
+2. [Project Settings](/docs/kcl/settings-project): Settings specific to a project, stored in `project.toml`
 3. Per-file Settings: Settings that apply to a single KCL file, specified using the `@settings` attribute
 
 ## Configuration Files
 
 Zoo Design Studio uses TOML files for configuration:
 
-* **User Settings**: `user.toml` - See [complete documentation](/docs/kcl/settings/user)
-* **Project Settings**: `project.toml` - See [complete documentation](/docs/kcl/settings/project)
+* **User Settings**: `user.toml` - See [complete documentation](/docs/kcl/settings-user)
+* **Project Settings**: `project.toml` - See [complete documentation](/docs/kcl/settings-project)
 
 ## Per-file settings
 
@@ -25,7 +25,7 @@ Settings which affect a single file are configured using the settings attribute.
 This must be at the top of the KCL file (comments before the attribute are permitted).
 For example:
 
-```js
+```kcl
 // The settings attribute.
 @settings(defaultLengthUnit = in)
 

docs/kcl-lang/types.md

@@ -9,10 +9,6 @@ layout: manual
 All these types can be nested in various forms where nesting applies. Like
 arrays can hold objects and vice versa.
 
-## Boolean
-
-`true` or `false` work when defining values.
-
 ## Constant declaration
 
 Constants are defined with a name and a value, like so:
@@ -23,7 +19,7 @@ myBool = false
 
 Currently you cannot redeclare a constant.
 
-## Array
+## Arrays
 
 An array is defined with `[]` braces. What is inside the brackets can
 be of any type. For example, the following is completely valid:
@@ -36,7 +32,7 @@ If you want to get a value from an array you can use the index like so:
 `myArray[0]`.
 
 
-## Object
+## Objects
 
 An object is defined with `{}` braces. Here is an example object:
 
@@ -47,6 +43,15 @@ myObj = { a = 0, b = "thing" }
 We support two different ways of getting properties from objects, you can call
 `myObj.a` or `myObj["a"]` both work.
 
+## `ImportedGeometry`
+
+Using `import` you can import geometry defined using other CAD software. In KCL,
+these objects have type `ImportedGeometry` and can mostly be treated like any
+other solid (they can be rotated, scaled, etc.), although there is no access to
+their internal components. See the [modules and imports docs](modules) for more
+detail on importing geometry.
+
+
 ## Binary expressions
 
 You can also do math! Let's show an example below:
@@ -169,21 +174,21 @@ startSketchOn(XZ)
 
 Note that we are still in the process of migrating KCL's standard library to use keyword arguments. So some
 functions are still unfortunately using positional arguments. We're moving them over, so keep checking back.
-Some functions like `angledLine`, `startProfileAt` etc are still using the old positional argument syntax.
+Some functions are still using the old positional argument syntax.
 Check the docs page for each function and look at its examples to see.
 
 ## Tags
 
 Tags are used to give a name (tag) to a specific path.
 
-### Tag Declaration
+### `TagDeclarator`
 
 The syntax for declaring a tag is `$myTag` you would use it in the following
 way:
 
 ```norun
 startSketchOn(XZ)
-  |> startProfileAt(origin, %)
+  |> startProfile(at = origin)
   |> angledLine(angle = 0, length = 191.26, tag = $rectangleSegmentA001)
   |> angledLine(
        angle = segAng(rectangleSegmentA001) - 90,
@@ -199,14 +204,24 @@ startSketchOn(XZ)
   |> close()
 ```
 
-### Tag Identifier
+### `TagIdentifier`
 
 As per the example above you can use the tag identifier to get a reference to the 
 tagged object. The syntax for this is `myTag`.
 
 In the example above we use the tag identifier to get the angle of the segment
-`segAng(rectangleSegmentA001, %)`.
+`segAng(rectangleSegmentA001)`.
 
+### `Start`
+
+There is a special tag, `START` (with type `Start`, although under the cover, it's a string)
+for identifying the face of a solid which was the start of an extrusion (i.e., the surface which
+is extruded).
+
+### `End`
+
+There is a special tag, `END` (with type `End`, although under the cover, it's a string)
+for identifying the face of a solid which was finishes an extrusion.
 
 ### Tag Scope
 
@@ -218,7 +233,7 @@ However if the code was written like this:
 ```norun
 fn rect(origin) {
   return startSketchOn(XZ)
-    |> startProfileAt(origin, %)
+    |> startProfile(at = origin)
     |> angledLine(angle = 0, length = 191.26, tag = $rectangleSegmentA001)
     |> angledLine(
          angle = segAng(rectangleSegmentA001) - 90,
@@ -234,8 +249,8 @@ fn rect(origin) {
     |> close()
 }
 
-rect([0, 0])
-rect([20, 0])
+rect(origin = [0, 0])
+rect(origin = [20, 0])
 ``` 
 
 Those tags would only be available in the `rect` function and not globally.
@@ -248,7 +263,7 @@ For example the following code works.
 ```norun
 fn rect(origin) {
   return startSketchOn(XZ)
-    |> startProfileAt(origin, %)
+    |> startProfile(at = origin)
     |> angledLine(angle = 0, length = 191.26, tag = $rectangleSegmentA001)
     |> angledLine(
          angle = segAng(rectangleSegmentA001) - 90,
@@ -264,8 +279,8 @@ fn rect(origin) {
     |> close()
 }
 
-rect([0, 0])
-myRect = rect([20, 0])
+rect(origin = [0, 0])
+myRect = rect(origin = [20, 0])
 
 myRect
   |> extrude(length = 10)

docs/kcl-std/README.md

@@ -0,0 +1,5 @@
+# Autogenerated docs
+
+Everything in this directory and its subdirectories (except this file) is automatically generated. Do not edit anything in this directory directly, your changes will be lost.
+
+The directory contents are generated by running the `test_generate_stdlib_markdown_docs` test in `/rust/kcl-lib/src/docs/gen_std_tests.rs`. Files are generated from the standard library declared in KCL (`/rust/kcl-lib/std`) and in Rust (`/rust/kcl-lib/src/std`), and by copying files from `../kcl-src`.

docs/kcl-std/consts/std-END.md

@@ -8,7 +8,7 @@ Identifies the ending face of an extrusion. I.e., the new face created by an ext
 
 
 
-```js
+```kcl
 std::END: string = 'end'
 ```
 

docs/kcl-std/consts/std-START.md

@@ -8,7 +8,7 @@ Identifies the starting face of an extrusion. I.e., the face which is extruded.
 
 
 
-```js
+```kcl
 std::START: string = 'start'
 ```
 

docs/kcl-std/consts/std-X.md

@@ -8,7 +8,7 @@ layout: manual
 
 
 
-```js
+```kcl
 std::X
 ```
 

docs/kcl-std/consts/std-XY.md

@@ -8,7 +8,7 @@ layout: manual
 
 
 
-```js
+```kcl
 std::XY
 ```
 

docs/kcl-std/consts/std-XZ.md

@@ -8,7 +8,7 @@ layout: manual
 
 
 
-```js
+```kcl
 std::XZ
 ```
 

docs/kcl-std/consts/std-Y.md

@@ -8,7 +8,7 @@ layout: manual
 
 
 
-```js
+```kcl
 std::Y
 ```
 

docs/kcl-std/consts/std-YZ.md

@@ -8,7 +8,7 @@ layout: manual
 
 
 
-```js
+```kcl
 std::YZ
 ```
 

docs/kcl-std/consts/std-Z.md

@@ -8,7 +8,7 @@ layout: manual
 
 
 
-```js
+```kcl
 std::Z
 ```
 

docs/kcl-std/consts/std-math-E.md

@@ -8,15 +8,15 @@ The value of Euler’s number `e`.
 
 
 
-```js
+```kcl
 std::math::E: number = 2.71828182845904523536028747135266250_
 ```
 
 ### Examples
 
-```js
+```kcl
 exampleSketch = startSketchOn(XZ)
-  |> startProfileAt([0, 0], %)
+  |> startProfile(at = [0, 0])
   |> angledLine(
     angle = 30,
     length = 2 * E ^ 2,

docs/kcl-std/consts/std-math-PI.md

@@ -8,17 +8,17 @@ The value of `pi`, Archimedes’ constant (π).
 
 
 
-```js
-std::math::PI: number = 3.14159265358979323846264338327950288_
+```kcl
+std::math::PI: number(_?) = 3.14159265358979323846264338327950288_?
 ```
 
 ### Examples
 
-```js
+```kcl
 circumference = 70
 
 exampleSketch = startSketchOn(XZ)
- |> circle(center = [0, 0], radius = circumference / (2 * PI))
+ |> circle(center = [0, 0], radius = (circumference / (2 * PI)): number(mm))
 
 example = extrude(exampleSketch, length = 5)
 ```

docs/kcl-std/consts/std-math-TAU.md

@@ -8,15 +8,15 @@ The value of `tau`, the full circle constant (τ). Equal to 2π.
 
 
 
-```js
+```kcl
 std::math::TAU: number = 6.28318530717958647692528676655900577_
 ```
 
 ### Examples
 
-```js
+```kcl
 exampleSketch = startSketchOn(XZ)
-  |> startProfileAt([0, 0], %)
+  |> startProfile(at = [0, 0])
   |> angledLine(
     angle = 50,
     length = 10 * TAU,

docs/kcl-std/consts/std-turns-HALF_TURN.md

@@ -8,7 +8,7 @@ layout: manual
 
 
 
-```js
+```kcl
 std::turns::HALF_TURN: number(deg) = 180deg
 ```
 

docs/kcl-std/consts/std-turns-QUARTER_TURN.md

@@ -8,7 +8,7 @@ layout: manual
 
 
 
-```js
+```kcl
 std::turns::QUARTER_TURN: number(deg) = 90deg
 ```
 

docs/kcl-std/consts/std-turns-THREE_QUARTER_TURN.md

@@ -8,7 +8,7 @@ layout: manual
 
 
 
-```js
+```kcl
 std::turns::THREE_QUARTER_TURN: number(deg) = 270deg
 ```
 

docs/kcl-std/consts/std-turns-ZERO.md

@@ -8,7 +8,7 @@ layout: manual
 
 
 
-```js
+```kcl
 std::turns::ZERO: number = 0
 ```
 

docs/kcl-std/functions/std-math-atan.md

@@ -0,0 +1,42 @@
+---
+title: "std::math::atan"
+excerpt: "Compute the arctangent of a number."
+layout: manual
+---
+
+Compute the arctangent of a number.
+
+Consider using `atan2()` instead for the true inverse of tangent.
+
+```kcl
+atan(@num: number(_)): number(rad)
+```
+
+### Arguments
+
+| Name | Type | Description | Required |
+|----------|------|-------------|----------|
+| `num` | `number(_)` |  | Yes |
+
+### Returns
+
+`number(rad)`
+
+
+### Examples
+
+```kcl
+sketch001 = startSketchOn(XZ)
+  |> startProfile(at = [0, 0])
+  |> angledLine(
+    angle = atan(1.25),
+    length = 20,
+  )
+  |> yLine(endAbsolute = 0)
+  |> close()
+
+extrude001 = extrude(sketch001, length = 5)
+```
+
+
+

docs/kcl-std/functions/std-math-cos.md

@@ -1,18 +1,17 @@
 ---
 title: "std::math::cos"
-excerpt: "Compute the cosine of a number (in radians)."
+excerpt: "Compute the cosine of a number."
 layout: manual
 ---
 
-Compute the cosine of a number (in radians).
+Compute the cosine of a number.
 
 
 
-```js
+```kcl
 cos(@num: number(Angle)): number(_)
 ```
 
-
 ### Arguments
 
 | Name | Type | Description | Required |
@@ -26,12 +25,12 @@ cos(@num: number(Angle)): number(_)
 
 ### Examples
 
-```js
+```kcl
 exampleSketch = startSketchOn(XZ)
-  |> startProfileAt([0, 0], %)
+  |> startProfile(at = [0, 0])
   |> angledLine(
     angle = 30,
-    length = 3 / cos(toRadians(30)),
+    length = 3 / cos(30deg),
   )
   |> yLine(endAbsolute = 0)
   |> close()

docs/kcl-std/functions/std-math-polar.md

@@ -9,31 +9,30 @@ layout: manual
 Convert polar/sphere (azimuth, elevation, distance) coordinates to
 cartesian (x/y/z grid) coordinates.
 
-```js
+```kcl
 polar(
-  angle: number(Angle),
+  angle: number(rad),
   length: number(Length),
 ): Point2d
 ```
 
-
 ### Arguments
 
 | Name | Type | Description | Required |
 |----------|------|-------------|----------|
-| `angle` | `number(Angle)` |  | Yes |
+| `angle` | `number(rad)` |  | Yes |
 | `length` | `number(Length)` |  | Yes |
 
 ### Returns
 
-[`Point2d`](/docs/kcl/types/Point2d)
+[`Point2d`](/docs/kcl-std/types/std-types-Point2d) - A point in two dimensional space.
 
 
 ### Examples
 
-```js
+```kcl
 exampleSketch = startSketchOn(XZ)
-  |> startProfileAt([0, 0], %)
+  |> startProfile(at = [0, 0])
   |> line(end = polar(angle = 30, length = 5), tag = $thing)
   |> line(end = [0, 5])
   |> line(end = [segEndX(thing), 0])

docs/kcl-std/functions/std-math-sin.md

@@ -1,18 +1,17 @@
 ---
 title: "std::math::sin"
-excerpt: "Compute the sine of a number (in radians)."
+excerpt: "Compute the sine of a number."
 layout: manual
 ---
 
-Compute the sine of a number (in radians).
+Compute the sine of a number.
 
 
 
-```js
+```kcl
 sin(@num: number(Angle)): number(_)
 ```
 
-
 ### Arguments
 
 | Name | Type | Description | Required |
@@ -26,12 +25,12 @@ sin(@num: number(Angle)): number(_)
 
 ### Examples
 
-```js
+```kcl
 exampleSketch = startSketchOn(XZ)
-  |> startProfileAt([0, 0], %)
+  |> startProfile(at = [0, 0])
   |> angledLine(
     angle = 50,
-    length = 15 / sin(toRadians(135)),
+    length = 15 / sin(135deg),
   )
   |> yLine(endAbsolute = 0)
   |> close()

docs/kcl-std/functions/std-math-tan.md

@@ -1,18 +1,17 @@
 ---
 title: "std::math::tan"
-excerpt: "Compute the tangent of a number (in radians)."
+excerpt: "Compute the tangent of a number."
 layout: manual
 ---
 
-Compute the tangent of a number (in radians).
+Compute the tangent of a number.
 
 
 
-```js
+```kcl
 tan(@num: number(Angle)): number(_)
 ```
 
-
 ### Arguments
 
 | Name | Type | Description | Required |
@@ -26,12 +25,12 @@ tan(@num: number(Angle)): number(_)
 
 ### Examples
 
-```js
+```kcl
 exampleSketch = startSketchOn(XZ)
-  |> startProfileAt([0, 0], %)
+  |> startProfile(at = [0, 0])
   |> angledLine(
     angle = 50,
-    length = 50 * tan(1/2),
+    length = 50 * tan((1/2): number(rad)),
   )
   |> yLine(endAbsolute = 0)
   |> close()

docs/kcl-std/functions/std-units-toCentimeters.md

@@ -0,0 +1,26 @@
+---
+title: "std::units::toCentimeters"
+excerpt: "Convert a number to centimeters from its current units."
+layout: manual
+---
+
+Convert a number to centimeters from its current units.
+
+
+
+```kcl
+units::toCentimeters(@num: number(cm)): number(cm)
+```
+
+### Arguments
+
+| Name | Type | Description | Required |
+|----------|------|-------------|----------|
+| `num` | `number(cm)` |  | Yes |
+
+### Returns
+
+`number(cm)`
+
+
+

docs/kcl-std/functions/std-units-toFeet.md

@@ -0,0 +1,26 @@
+---
+title: "std::units::toFeet"
+excerpt: "Convert a number to feet from its current units."
+layout: manual
+---
+
+Convert a number to feet from its current units.
+
+
+
+```kcl
+units::toFeet(@num: number(ft)): number(ft)
+```
+
+### Arguments
+
+| Name | Type | Description | Required |
+|----------|------|-------------|----------|
+| `num` | `number(ft)` |  | Yes |
+
+### Returns
+
+`number(ft)`
+
+
+

docs/kcl-std/functions/std-units-toInches.md

@@ -0,0 +1,26 @@
+---
+title: "std::units::toInches"
+excerpt: "Convert a number to inches from its current units."
+layout: manual
+---
+
+Convert a number to inches from its current units.
+
+
+
+```kcl
+units::toInches(@num: number(in)): number(in)
+```
+
+### Arguments
+
+| Name | Type | Description | Required |
+|----------|------|-------------|----------|
+| `num` | `number(in)` |  | Yes |
+
+### Returns
+
+`number(in)`
+
+
+

docs/kcl-std/functions/std-units-toMeters.md

@@ -0,0 +1,26 @@
+---
+title: "std::units::toMeters"
+excerpt: "Convert a number to meters from its current units."
+layout: manual
+---
+
+Convert a number to meters from its current units.
+
+
+
+```kcl
+units::toMeters(@num: number(m)): number(m)
+```
+
+### Arguments
+
+| Name | Type | Description | Required |
+|----------|------|-------------|----------|
+| `num` | `number(m)` |  | Yes |
+
+### Returns
+
+`number(m)`
+
+
+

docs/kcl-std/functions/std-units-toMillimeters.md

@@ -0,0 +1,26 @@
+---
+title: "std::units::toMillimeters"
+excerpt: "Convert a number to millimeters from its current units."
+layout: manual
+---
+
+Convert a number to millimeters from its current units.
+
+
+
+```kcl
+units::toMillimeters(@num: number(mm)): number(mm)
+```
+
+### Arguments
+
+| Name | Type | Description | Required |
+|----------|------|-------------|----------|
+| `num` | `number(mm)` |  | Yes |
+
+### Returns
+
+`number(mm)`
+
+
+

docs/kcl-std/functions/std-units-toYards.md

@@ -0,0 +1,26 @@
+---
+title: "std::units::toYards"
+excerpt: "Converts a number to yards from its current units."
+layout: manual
+---
+
+Converts a number to yards from its current units.
+
+
+
+```kcl
+units::toYards(@num: number(yd)): number(yd)
+```
+
+### Arguments
+
+| Name | Type | Description | Required |
+|----------|------|-------------|----------|
+| `num` | `number(yd)` |  | Yes |
+
+### Returns
+
+`number(yd)`
+
+
+

docs/kcl-std/index.md

@@ -0,0 +1,162 @@
+---
+title: "KCL Standard Library"
+excerpt: "Documentation for the KCL standard library for the Zoo Design Studio."
+layout: manual
+---
+
+## Table of Contents
+
+### Functions
+
+* [**std**](/docs/kcl-std/modules/std)
+  * [`appearance`](/docs/kcl-std/appearance)
+  * [`assert`](/docs/kcl-std/assert)
+  * [`assertIs`](/docs/kcl-std/assertIs)
+  * [`clone`](/docs/kcl-std/clone)
+  * [`helix`](/docs/kcl-std/functions/std-helix)
+  * [`offsetPlane`](/docs/kcl-std/functions/std-offsetPlane)
+  * [`patternLinear2d`](/docs/kcl-std/patternLinear2d)
+* [**std::array**](/docs/kcl-std/modules/std-array)
+  * [`map`](/docs/kcl-std/map)
+  * [`pop`](/docs/kcl-std/pop)
+  * [`push`](/docs/kcl-std/push)
+  * [`reduce`](/docs/kcl-std/reduce)
+* [**std::math**](/docs/kcl-std/modules/std-math)
+  * [`abs`](/docs/kcl-std/functions/std-math-abs)
+  * [`acos`](/docs/kcl-std/functions/std-math-acos)
+  * [`asin`](/docs/kcl-std/functions/std-math-asin)
+  * [`atan`](/docs/kcl-std/functions/std-math-atan)
+  * [`atan2`](/docs/kcl-std/functions/std-math-atan2)
+  * [`ceil`](/docs/kcl-std/functions/std-math-ceil)
+  * [`cos`](/docs/kcl-std/functions/std-math-cos)
+  * [`floor`](/docs/kcl-std/functions/std-math-floor)
+  * [`legAngX`](/docs/kcl-std/legAngX)
+  * [`legAngY`](/docs/kcl-std/legAngY)
+  * [`legLen`](/docs/kcl-std/legLen)
+  * [`ln`](/docs/kcl-std/functions/std-math-ln)
+  * [`log`](/docs/kcl-std/functions/std-math-log)
+  * [`log10`](/docs/kcl-std/functions/std-math-log10)
+  * [`log2`](/docs/kcl-std/functions/std-math-log2)
+  * [`max`](/docs/kcl-std/functions/std-math-max)
+  * [`min`](/docs/kcl-std/functions/std-math-min)
+  * [`polar`](/docs/kcl-std/functions/std-math-polar)
+  * [`pow`](/docs/kcl-std/functions/std-math-pow)
+  * [`rem`](/docs/kcl-std/functions/std-math-rem)
+  * [`round`](/docs/kcl-std/functions/std-math-round)
+  * [`sin`](/docs/kcl-std/functions/std-math-sin)
+  * [`sqrt`](/docs/kcl-std/functions/std-math-sqrt)
+  * [`tan`](/docs/kcl-std/functions/std-math-tan)
+* [**std::sketch**](/docs/kcl-std/modules/std-sketch)
+  * [`angledLine`](/docs/kcl-std/angledLine)
+  * [`angledLineThatIntersects`](/docs/kcl-std/angledLineThatIntersects)
+  * [`arc`](/docs/kcl-std/arc)
+  * [`bezierCurve`](/docs/kcl-std/bezierCurve)
+  * [`circle`](/docs/kcl-std/functions/std-sketch-circle)
+  * [`circleThreePoint`](/docs/kcl-std/circleThreePoint)
+  * [`close`](/docs/kcl-std/close)
+  * [`extrude`](/docs/kcl-std/extrude)
+  * [`getCommonEdge`](/docs/kcl-std/getCommonEdge)
+  * [`getNextAdjacentEdge`](/docs/kcl-std/getNextAdjacentEdge)
+  * [`getOppositeEdge`](/docs/kcl-std/getOppositeEdge)
+  * [`getPreviousAdjacentEdge`](/docs/kcl-std/getPreviousAdjacentEdge)
+  * [`involuteCircular`](/docs/kcl-std/involuteCircular)
+  * [`lastSegX`](/docs/kcl-std/lastSegX)
+  * [`lastSegY`](/docs/kcl-std/lastSegY)
+  * [`line`](/docs/kcl-std/line)
+  * [`loft`](/docs/kcl-std/loft)
+  * [`patternCircular2d`](/docs/kcl-std/patternCircular2d)
+  * [`patternTransform2d`](/docs/kcl-std/patternTransform2d)
+  * [`polygon`](/docs/kcl-std/polygon)
+  * [`profileStart`](/docs/kcl-std/profileStart)
+  * [`profileStartX`](/docs/kcl-std/profileStartX)
+  * [`profileStartY`](/docs/kcl-std/profileStartY)
+  * [`revolve`](/docs/kcl-std/functions/std-sketch-revolve)
+  * [`segAng`](/docs/kcl-std/segAng)
+  * [`segEnd`](/docs/kcl-std/segEnd)
+  * [`segEndX`](/docs/kcl-std/segEndX)
+  * [`segEndY`](/docs/kcl-std/segEndY)
+  * [`segLen`](/docs/kcl-std/segLen)
+  * [`segStart`](/docs/kcl-std/segStart)
+  * [`segStartX`](/docs/kcl-std/segStartX)
+  * [`segStartY`](/docs/kcl-std/segStartY)
+  * [`startProfile`](/docs/kcl-std/startProfile)
+  * [`startSketchOn`](/docs/kcl-std/startSketchOn)
+  * [`subtract2d`](/docs/kcl-std/subtract2d)
+  * [`sweep`](/docs/kcl-std/sweep)
+  * [`tangentToEnd`](/docs/kcl-std/tangentToEnd)
+  * [`tangentialArc`](/docs/kcl-std/tangentialArc)
+  * [`xLine`](/docs/kcl-std/xLine)
+  * [`yLine`](/docs/kcl-std/yLine)
+* [**std::solid**](/docs/kcl-std/modules/std-solid)
+  * [`chamfer`](/docs/kcl-std/functions/std-solid-chamfer)
+  * [`fillet`](/docs/kcl-std/functions/std-solid-fillet)
+  * [`hollow`](/docs/kcl-std/functions/std-solid-hollow)
+  * [`intersect`](/docs/kcl-std/intersect)
+  * [`patternCircular3d`](/docs/kcl-std/patternCircular3d)
+  * [`patternLinear3d`](/docs/kcl-std/patternLinear3d)
+  * [`patternTransform`](/docs/kcl-std/patternTransform)
+  * [`shell`](/docs/kcl-std/functions/std-solid-shell)
+  * [`subtract`](/docs/kcl-std/subtract)
+  * [`union`](/docs/kcl-std/union)
+* [**std::transform**](/docs/kcl-std/modules/std-transform)
+  * [`mirror2d`](/docs/kcl-std/functions/std-transform-mirror2d)
+  * [`rotate`](/docs/kcl-std/rotate)
+  * [`scale`](/docs/kcl-std/scale)
+  * [`translate`](/docs/kcl-std/translate)
+* [**std::units**](/docs/kcl-std/modules/std-units)
+  * [`units::toCentimeters`](/docs/kcl-std/functions/std-units-toCentimeters)
+  * [`units::toDegrees`](/docs/kcl-std/functions/std-units-toDegrees)
+  * [`units::toFeet`](/docs/kcl-std/functions/std-units-toFeet)
+  * [`units::toInches`](/docs/kcl-std/functions/std-units-toInches)
+  * [`units::toMeters`](/docs/kcl-std/functions/std-units-toMeters)
+  * [`units::toMillimeters`](/docs/kcl-std/functions/std-units-toMillimeters)
+  * [`units::toRadians`](/docs/kcl-std/functions/std-units-toRadians)
+  * [`units::toYards`](/docs/kcl-std/functions/std-units-toYards)
+
+### Constants
+
+* [**std**](/docs/kcl-std/modules/std)
+  * [`END`](/docs/kcl-std/consts/std-END)
+  * [`START`](/docs/kcl-std/consts/std-START)
+  * [`X`](/docs/kcl-std/consts/std-X)
+  * [`XY`](/docs/kcl-std/consts/std-XY)
+  * [`XZ`](/docs/kcl-std/consts/std-XZ)
+  * [`Y`](/docs/kcl-std/consts/std-Y)
+  * [`YZ`](/docs/kcl-std/consts/std-YZ)
+  * [`Z`](/docs/kcl-std/consts/std-Z)
+* [**std::math**](/docs/kcl-std/modules/std-math)
+  * [`E`](/docs/kcl-std/consts/std-math-E)
+  * [`PI`](/docs/kcl-std/consts/std-math-PI)
+  * [`TAU`](/docs/kcl-std/consts/std-math-TAU)
+* [**std::turns**](/docs/kcl-std/modules/std-turns)
+  * [`turns::HALF_TURN`](/docs/kcl-std/consts/std-turns-HALF_TURN)
+  * [`turns::QUARTER_TURN`](/docs/kcl-std/consts/std-turns-QUARTER_TURN)
+  * [`turns::THREE_QUARTER_TURN`](/docs/kcl-std/consts/std-turns-THREE_QUARTER_TURN)
+  * [`turns::ZERO`](/docs/kcl-std/consts/std-turns-ZERO)
+
+### Types
+
+See also the [types overview](/docs/kcl-lang/types)
+
+* [**Primitive types**](/docs/kcl-std/modules/Primitive types)
+  * [`End`](/docs/kcl-std/types#End)
+  * [`ImportedGeometry`](/docs/kcl-std/types#ImportedGeometry)
+  * [`Start`](/docs/kcl-std/types#Start)
+  * [`TagDeclarator`](/docs/kcl-std/types#TagDeclarator)
+  * [`TagIdentifier`](/docs/kcl-std/types#TagIdentifier)
+  * [`any`](/docs/kcl-std/types/std-types-any)
+  * [`bool`](/docs/kcl-std/types/std-types-bool)
+  * [`number`](/docs/kcl-std/types/std-types-number)
+  * [`string`](/docs/kcl-std/types/std-types-string)
+  * [`tag`](/docs/kcl-std/types/std-types-tag)
+* [**std::types**](/docs/kcl-std/modules/std-types)
+  * [`Axis2d`](/docs/kcl-std/types/std-types-Axis2d)
+  * [`Axis3d`](/docs/kcl-std/types/std-types-Axis3d)
+  * [`Edge`](/docs/kcl-std/types/std-types-Edge)
+  * [`Face`](/docs/kcl-std/types/std-types-Face)
+  * [`Helix`](/docs/kcl-std/types/std-types-Helix)
+  * [`Plane`](/docs/kcl-std/types/std-types-Plane)
+  * [`Point2d`](/docs/kcl-std/types/std-types-Point2d)
+  * [`Point3d`](/docs/kcl-std/types/std-types-Point3d)
+  * [`Sketch`](/docs/kcl-std/types/std-types-Sketch)
+  * [`Solid`](/docs/kcl-std/types/std-types-Solid)

docs/kcl-std/legAngX.md

@@ -0,0 +1,37 @@
+---
+title: "std::math::legAngX"
+excerpt: "Compute the angle of the given leg for x."
+layout: manual
+---
+
+Compute the angle of the given leg for x.
+
+
+
+```kcl
+legAngX(
+  hypotenuse: number,
+  leg: number,
+): number
+```
+
+### Arguments
+
+| Name | Type | Description | Required |
+|----------|------|-------------|----------|
+| `hypotenuse` | [`number`](/docs/kcl-std/types/std-types-number) | The length of the triangle's hypotenuse | Yes |
+| `leg` | [`number`](/docs/kcl-std/types/std-types-number) | The length of one of the triangle's legs (i.e. non-hypotenuse side) | Yes |
+
+### Returns
+
+[`number`](/docs/kcl-std/types/std-types-number) - A number
+
+
+### Examples
+
+```kcl
+legAngX(hypotenuse = 5, leg = 3)
+```
+
+
+

docs/kcl-std/legAngY.md

@@ -0,0 +1,37 @@
+---
+title: "std::math::legAngY"
+excerpt: "Compute the angle of the given leg for y."
+layout: manual
+---
+
+Compute the angle of the given leg for y.
+
+
+
+```kcl
+legAngY(
+  hypotenuse: number,
+  leg: number,
+): number
+```
+
+### Arguments
+
+| Name | Type | Description | Required |
+|----------|------|-------------|----------|
+| `hypotenuse` | [`number`](/docs/kcl-std/types/std-types-number) | The length of the triangle's hypotenuse | Yes |
+| `leg` | [`number`](/docs/kcl-std/types/std-types-number) | The length of one of the triangle's legs (i.e. non-hypotenuse side) | Yes |
+
+### Returns
+
+[`number`](/docs/kcl-std/types/std-types-number) - A number
+
+
+### Examples
+
+```kcl
+legAngY(hypotenuse = 5, leg = 3)
+```
+
+
+