Update rust/kcl-lib/src/execution/memory.rs

Co-authored-by: Jonathan Tran <jonnytran@gmail.com>
ascii art diagram
2025-03-28 21:01:24 -07:00 · 2025-03-28 14:30:45 -07:00 · 2025-03-28 21:14:29 +00:00 · 2025-03-28 21:07:53 +00:00 · 2025-03-28 14:48:47 -04:00 · 2025-03-28 13:50:54 -04:00
1384 changed files with 406329 additions and 793429 deletions
--- a/.env.development
+++ b/.env.development
@ -1,5 +1,6 @@
 NODE_ENV=development
 DEV=true
+
 VITE_KC_API_WS_MODELING_URL=wss://api.dev.zoo.dev/ws/modeling/commands
 VITE_KC_API_BASE_URL=https://api.dev.zoo.dev
 VITE_KC_SITE_BASE_URL=https://dev.zoo.dev
@ -8,3 +9,5 @@ VITE_KC_SKIP_AUTH=false
 VITE_KC_CONNECTION_TIMEOUT_MS=5000
 # ONLY add your token in .env.development.local if you want to skip auth, otherwise this token takes precedence!
 #VITE_KC_DEV_TOKEN="your token from dev.zoo.dev should go in .env.development.local"
+
+FAIL_ON_CONSOLE_ERRORS=true
--- a/.envrc
+++ b/.envrc
@ -1 +1,13 @@
+# Load optional shared environment variables
+source_up_if_exists
+
+# Load default development environment variables
+dotenv .env.development
+
+# Load optional environment variables overrides
+dotenv_if_exists .env.development.local
+
+# Load optional testing environment variables
+dotenv_if_exists e2e/playwright/playwright-secrets.env
+
 use flake .
--- a/.eslintrc
+++ b/.eslintrc
@ -20,8 +20,20 @@
      "plugin:react-hooks/recommended"
    ],
    "rules": {
+      "no-array-constructor": "off", // This is wrong; use the @typescript-eslint one instead.
+      "@typescript-eslint/no-array-constructor": "error",
+      "@typescript-eslint/no-array-delete": "error",
+      "@typescript-eslint/no-duplicate-enum-values": "error",
+      "@typescript-eslint/no-duplicate-type-constituents": "error",
+      "@typescript-eslint/no-empty-object-type": "error",
      "@typescript-eslint/no-floating-promises": "error",
+      "no-implied-eval": "off", // This is wrong; use the @typescript-eslint one instead.
+      "@typescript-eslint/no-implied-eval": "error",
      "@typescript-eslint/no-misused-promises": "error",
+      "@typescript-eslint/no-namespace": "error",
+      "@typescript-eslint/no-unnecessary-type-assertion": "error",
+      "@typescript-eslint/no-unnecessary-type-constraint": "error",
+      "no-unused-vars": "off", // This is wrong; use the @typescript-eslint one instead.
      "@typescript-eslint/no-unused-vars": ["error", {
        "varsIgnorePattern": "^_",
        "argsIgnorePattern": "^_",
@ -29,6 +41,7 @@
        "vars": "all",
        "args": "none"
      }],
+      "@typescript-eslint/prefer-as-const": "warn",
      "jsx-a11y/click-events-have-key-events": "off",
      "jsx-a11y/no-autofocus": "off",
      "jsx-a11y/no-noninteractive-element-interactions": "off",
--- a/.github/actions/github-release/package.json
+++ b/.github/actions/github-release/package.json
@ -4,7 +4,7 @@
  "main": "main.js",
  "dependencies": {
    "@actions/core": "^1.6",
-    "@actions/github": "^5.0",
-    "glob": "^7.1.5"
+    "@actions/github": "^6.0",
+    "glob": "^11.0.1"
  }
 }
--- a/.github/ci-cd-scripts/playwright-electron.sh
+++ b/.github/ci-cd-scripts/playwright-electron.sh
@ -4,27 +4,27 @@
 set -euo pipefail

 if [[ ! -f "test-results/.last-run.json" ]]; then
-    # if no last run artifact, than run plawright normally
+    # 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" -- yarn test:playwright:electron:ubuntu -- --shard=$1/$2 || true
-        elif [[ "$3" == *windows* ]]; then
-            yarn test:playwright:electron:windows -- --shard=$1/$2 || true
-        elif [[ "$3" == *macos* ]]; then
-            yarn test:playwright:electron:macos  -- --shard=$1/$2 || true
-        else
-            echo "Do not run playwright. Unable to detect os runtime."
-            exit 1
-        fi
-        # # send to axiom
-        node playwrightProcess.mjs | tee /tmp/github-actions.log > /dev/null 2>&1
+    if [[ "$3" == *ubuntu* ]]; then
+        xvfb-run --auto-servernum --server-args="-screen 0 1280x960x24" -- yarn test:playwright:electron:ubuntu -- --shard=$1/$2 || true
+    elif [[ "$3" == *windows* ]]; then
+        yarn test:playwright:electron:windows -- --shard=$1/$2 || true
+    elif [[ "$3" == *macos* ]]; then
+        yarn test:playwright:electron:macos  -- --shard=$1/$2 || true
+    else
+        echo "Do not run Playwright. Unable to detect os runtime."
+        exit 1
+    fi
+    # Log failures for Axiom to pick up
+    node playwrightProcess.mjs > /tmp/github-actions.log
 fi

 retry=1
-max_retrys=1
+max_retries=1

-# retry failed tests, doing our own retries because using inbuilt playwright retries causes connection issues
-while [[ $retry -le $max_retrys ]]; do
+# 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
@ -40,8 +40,8 @@ while [[ $retry -le $max_retrys ]]; do
                echo "Do not run playwright. Unable to detect os runtime."
                exit 1
            fi
-            # send to axiom
-            node playwrightProcess.mjs | tee /tmp/github-actions.log > /dev/null 2>&1
+            # Log failures for Axiom to pick up
+            node playwrightProcess.mjs > /tmp/github-actions.log
            retry=$((retry + 1))
        else
            echo "retried=false" >>$GITHUB_OUTPUT
@ -58,7 +58,7 @@ 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 retrys, then fail the job
+        # If it still fails after 3 retries, then fail the job
        exit 1
    fi
 fi
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@ -230,39 +230,6 @@ updates:
      update-types:
      - minor
      - patch
- package-ecosystem: pip
-  directory: /public/kcl-samples
-  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:
-      - major
-      - minor
-      - patch
-    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: pip
  directory: /rust/kcl-python-bindings
  schedule:
--- a/.github/workflows/build-and-store-wasm.yml
+++ b/.github/workflows/build-and-store-wasm.yml
@ -24,7 +24,7 @@ jobs:
        uses: actions-rust-lang/setup-rust-toolchain@v1
        with:
          cache: false # Configured below.
-      - uses: taiki-e/install-action@955a6ff1416eae278c9f833008a9beb4b7f9afe3
+      - uses: taiki-e/install-action@37bdc826eaedac215f638a96472df572feab0f9b
        with:
          tool: wasm-pack
      - name: Rust Cache
--- a/.github/workflows/build-apps.yml
+++ b/.github/workflows/build-apps.yml
@ -77,7 +77,7 @@ jobs:
        with:
          cache: false # Configured below.

-      - uses: taiki-e/install-action@955a6ff1416eae278c9f833008a9beb4b7f9afe3
+      - uses: taiki-e/install-action@37bdc826eaedac215f638a96472df572feab0f9b
        if: ${{ steps.wasm.outputs.should-build-wasm == 'true' }}
        with:
          tool: wasm-pack
--- a/.github/workflows/cargo-test.yml
+++ b/.github/workflows/cargo-test.yml
@ -100,9 +100,14 @@ jobs:
        shell: bash
        run: |
          set -euo pipefail
-          cd rust
+          pushd rust
          just overwrite-sim-test kcl_samples
-          git add kcl-lib/tests
+          popd
+          git add \
+            rust/kcl-lib/tests \
+            public/kcl-samples/manifest.json \
+            public/kcl-samples/README.md \
+            public/kcl-samples/screenshots
          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
--- a/.github/workflows/e2e-tests.yml
+++ b/.github/workflows/e2e-tests.yml
@ -1,7 +1,9 @@
 name: E2E Tests
 on:
  push:
-    branches: [ main ]
+    branches:
+      - main
+      - all-e2e # this bypasses `fixme()` using `orRunWhenFullSuiteEnabled()`
  pull_request:
  schedule:
    - cron: 0 * * * *  # hourly
@ -15,7 +17,6 @@ permissions:
  pull-requests: write
  actions: read

-
 jobs:

  conditions:
@ -67,14 +68,16 @@ jobs:
      - name: Display conditions
        shell: bash
        run: |
-          # For debugging purposes.
+          # For debugging purposes
          set -euo pipefail
+          echo "GITHUB_REF: $GITHUB_REF"
+          echo "GITHUB_HEAD_REF: $GITHUB_HEAD_REF"
+          echo "GITHUB_BASE_REF: $GITHUB_BASE_REF"
          echo "significant: ${{ steps.path-changes.outputs.significant }}"
          echo "should-run: ${{ steps.should-run.outputs.should-run }}"

-
  prepare-wasm:
-    # seperate job on Ubuntu to build or fetch the wasm blob once on the fastest runner
+    # separate job on Ubuntu to build or fetch the wasm blob once on the fastest runner
    runs-on: runs-on=${{ github.run_id }}/family=i7ie.2xlarge/image=ubuntu22-full-x64
    needs: conditions
    steps:
@ -137,7 +140,7 @@ jobs:
        with:
          cache: false # Configured below.

-      - uses: taiki-e/install-action@955a6ff1416eae278c9f833008a9beb4b7f9afe3
+      - uses: taiki-e/install-action@37bdc826eaedac215f638a96472df572feab0f9b
        if: ${{ needs.conditions.outputs.should-run == 'true' && steps.wasm.outputs.should-build-wasm == 'true' }}
        with:
          tool: wasm-pack
@ -159,7 +162,6 @@ jobs:
          name: prepared-wasm
          path: |
            rust/kcl-wasm-lib/pkg/kcl_wasm_lib*
-  

  snapshots:
    name: playwright:snapshots:ubuntu
@ -243,7 +245,7 @@ jobs:
          retention-days: 30
          overwrite: true

-      - name: check for changes
+      - name: Check for changes
        if: ${{ needs.conditions.outputs.should-run == 'true' && github.ref != 'refs/heads/main' }}
        shell: bash
        id: git-check
@ -255,7 +257,8 @@ jobs:
            fi

      - name: Commit changes, if any
-        if: ${{ needs.conditions.outputs.should-run == 'true' && steps.git-check.outputs.modified == 'true' }}
+        # TODO: find a more reliable way to detect visual changes
+        if: ${{ false && needs.conditions.outputs.should-run == 'true' && steps.git-check.outputs.modified == 'true' }}
        shell: bash
        run: |
          git add e2e/playwright/snapshot-tests.spec.ts-snapshots e2e/playwright/snapshots
@ -325,6 +328,7 @@ jobs:
        run: yarn

      - name: Cache Playwright Browsers
+        if: needs.conditions.outputs.should-run == 'true'
        uses: actions/cache@v4
        with:
          path: |
@ -332,20 +336,29 @@ jobs:
          key: ${{ runner.os }}-playwright-${{ hashFiles('yarn.lock') }}

      - name: Install Playwright Browsers
+        if: needs.conditions.outputs.should-run == 'true'
        run: yarn playwright install --with-deps

      - name: Build web
        if: needs.conditions.outputs.should-run == 'true'
        run: yarn tronb:vite:dev

-      - name: Install good sed
-        if: startsWith(matrix.os, 'macos')
+      - name: Install vector
+        if: ${{ needs.conditions.outputs.should-run == 'true' && contains(matrix.os, 'ubuntu') }}
        shell: bash
        run: |
-          brew install gnu-sed
-          echo "/opt/homebrew/opt/gnu-sed/libexec/gnubin" >> $GITHUB_PATH
-
-        # TODO: Add back axiom logs
+          curl --proto '=https' --tlsv1.2 -sSfL https://sh.vector.dev > /tmp/vector.sh
+          chmod +x /tmp/vector.sh
+          /tmp/vector.sh -y -no-modify-path
+          mkdir -p /tmp/vector
+          cp .github/workflows/vector.toml /tmp/vector.toml
+          sed -i "s#GITHUB_WORKFLOW#${GITHUB_WORKFLOW}#g" /tmp/vector.toml
+          sed -i "s#GITHUB_REPOSITORY#${GITHUB_REPOSITORY}#g" /tmp/vector.toml
+          sed -i "s#GITHUB_SHA#${GITHUB_SHA}#g" /tmp/vector.toml
+          sed -i "s#GITHUB_REF_NAME#${GITHUB_REF_NAME}#g" /tmp/vector.toml
+          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 &

      - uses: actions/download-artifact@v4
        if: ${{ needs.conditions.outputs.should-run == 'true' && !cancelled() && (success() || failure()) }}
--- a/.github/workflows/kcl-language-server.yml
+++ b/.github/workflows/kcl-language-server.yml
@ -376,7 +376,7 @@ jobs:
        with:
          credentials_json: "${{ secrets.GOOGLE_CLOUD_DL_SA }}"
      - name: Set up Cloud SDK
-        uses: google-github-actions/setup-gcloud@v2.1.2
+        uses: google-github-actions/setup-gcloud@v2.1.4
        with:
          project_id: kittycadapi
      - name: "upload files to gcp"
--- a/.github/workflows/static-analysis.yml
+++ b/.github/workflows/static-analysis.yml
@ -28,43 +28,57 @@ jobs:
      - run: yarn fmt-check

  yarn-build-wasm:
-    runs-on: ubuntu-22.04
-
+    # Build the wasm blob once on the fastest runner.
+    runs-on: runs-on=${{ github.run_id }}/family=i7ie.2xlarge/image=ubuntu22-full-x64
    steps:
      - uses: actions/checkout@v4
+
      - uses: actions/setup-node@v4
        with:
          node-version-file: '.nvmrc'
          cache: 'yarn'
-      - run: yarn install
-      - uses: taiki-e/install-action@955a6ff1416eae278c9f833008a9beb4b7f9afe3
+
+      - name: Install dependencies
+        run: yarn install
+
+      - 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.
+
+      - uses: taiki-e/install-action@37bdc826eaedac215f638a96472df572feab0f9b
        with:
          tool: wasm-pack
-      - run: yarn build:wasm

-  yarn-tsc:
-    runs-on: ubuntu-22.04
-
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version-file: '.nvmrc'
-          cache: 'yarn'
-      - run: yarn install
-      - run: yarn --cwd ./rust/kcl-language-server --modules-folder node_modules install
-      - uses: Swatinem/rust-cache@v2
+      - name: Rust Cache
+        uses: Swatinem/rust-cache@v2
        with:
          workspaces: './rust'

-      - uses: taiki-e/install-action@955a6ff1416eae278c9f833008a9beb4b7f9afe3
-        with:
-          tool: wasm-pack
-      - run: yarn build:wasm
-      - run: yarn tsc
+      - name: Build Wasm
+        shell: bash
+        run: yarn build:wasm

-  yarn-lint:
-    runs-on: ubuntu-22.04
+      - uses: actions/upload-artifact@v4
+        with:
+          name: prepared-wasm
+          path: |
+            rust/kcl-wasm-lib/pkg/kcl_wasm_lib*
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: prepared-ts-rs-bindings
+          path: |
+            rust/kcl-lib/bindings/*
+
+  yarn-tsc:
+    runs-on: ubuntu-latest
+    needs: yarn-build-wasm

    steps:
      - uses: actions/checkout@v4
@ -73,7 +87,53 @@ jobs:
          node-version-file: '.nvmrc'
          cache: 'yarn'
      - run: yarn install
-      - run: yarn --cwd ./rust/kcl-language-server --modules-folder node_modules install
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+
+      - name: Copy prepared wasm
+        run: |
+          ls -R prepared-wasm
+          cp prepared-wasm/kcl_wasm_lib_bg.wasm public
+          mkdir rust/kcl-wasm-lib/pkg
+          cp prepared-wasm/kcl_wasm_lib* rust/kcl-wasm-lib/pkg
+
+      - name: Copy prepared ts-rs bindings
+        run: |
+          ls -R prepared-ts-rs-bindings
+          mkdir rust/kcl-lib/bindings
+          cp -r prepared-ts-rs-bindings/* rust/kcl-lib/bindings/
+
+      - run: yarn tsc
+
+  yarn-lint:
+    runs-on: ubuntu-latest
+    needs: yarn-build-wasm
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'yarn'
+      - run: yarn install
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+
+      - name: Copy prepared wasm
+        run: |
+          ls -R prepared-wasm
+          cp prepared-wasm/kcl_wasm_lib_bg.wasm public
+          mkdir rust/kcl-wasm-lib/pkg
+          cp prepared-wasm/kcl_wasm_lib* rust/kcl-wasm-lib/pkg
+
+      - name: Copy prepared ts-rs bindings
+        run: |
+          ls -R prepared-ts-rs-bindings
+          mkdir rust/kcl-lib/bindings
+          cp -r prepared-ts-rs-bindings/* rust/kcl-lib/bindings/
+
      - run: yarn lint

  python-codespell:
@ -91,6 +151,7 @@ jobs:

  yarn-unit-test-kcl-samples:
    runs-on: ubuntu-latest
+    needs: yarn-build-wasm
    steps:
      - uses: actions/checkout@v4

@ -100,10 +161,25 @@ jobs:
          cache: 'yarn'

      - run: yarn install
-      - uses: taiki-e/install-action@955a6ff1416eae278c9f833008a9beb4b7f9afe3
+      - uses: taiki-e/install-action@37bdc826eaedac215f638a96472df572feab0f9b
        with:
          tool: wasm-pack
-      - run: yarn build:wasm
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+
+      - name: Copy prepared wasm
+        run: |
+          ls -R prepared-wasm
+          cp prepared-wasm/kcl_wasm_lib_bg.wasm public
+          mkdir rust/kcl-wasm-lib/pkg
+          cp prepared-wasm/kcl_wasm_lib* rust/kcl-wasm-lib/pkg
+
+      - name: Copy prepared ts-rs bindings
+        run: |
+          ls -R prepared-ts-rs-bindings
+          mkdir rust/kcl-lib/bindings
+          cp -r prepared-ts-rs-bindings/* rust/kcl-lib/bindings/

      - run: yarn simpleserver:bg
        if: ${{ github.event_name != 'release' && github.event_name != 'schedule' }}
@ -120,6 +196,7 @@ jobs:

  yarn-unit-test:
    runs-on: ubuntu-latest
+    needs: yarn-build-wasm
    steps:
      - uses: actions/checkout@v4

@ -129,10 +206,25 @@ jobs:
          cache: 'yarn'

      - run: yarn install
-      - uses: taiki-e/install-action@955a6ff1416eae278c9f833008a9beb4b7f9afe3
+      - uses: taiki-e/install-action@37bdc826eaedac215f638a96472df572feab0f9b
        with:
          tool: wasm-pack
-      - run: yarn build:wasm
+
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+
+      - name: Copy prepared wasm
+        run: |
+          ls -R prepared-wasm
+          cp prepared-wasm/kcl_wasm_lib_bg.wasm public
+          mkdir rust/kcl-wasm-lib/pkg
+          cp prepared-wasm/kcl_wasm_lib* rust/kcl-wasm-lib/pkg
+
+      - name: Copy prepared ts-rs bindings
+        run: |
+          ls -R prepared-ts-rs-bindings
+          mkdir rust/kcl-lib/bindings
+          cp -r prepared-ts-rs-bindings/* rust/kcl-lib/bindings/

      - run: yarn simpleserver:bg
        if: ${{ github.event_name != 'release' && github.event_name != 'schedule' }}
@ -141,13 +233,13 @@ jobs:
        if: ${{ github.event_name != 'release' && github.event_name != 'schedule' }}
        run: yarn playwright install chromium --with-deps

-      - name: run unit tests
+      - name: Run unit tests
        if: ${{ github.event_name != 'release' && github.event_name != 'schedule' }}
        run: xvfb-run -a yarn test:unit
        env:
          VITE_KC_DEV_TOKEN: ${{ secrets.KITTYCAD_API_TOKEN_DEV }}

-      - name: check for changes
+      - name: Check for changes
        if: ${{ github.event_name != 'release' && github.event_name != 'schedule' }}
        id: git-check
        run: |
--- a/.github/workflows/update-dev-branch.yml
+++ b/.github/workflows/update-dev-branch.yml
@ -1,5 +1,8 @@
 name: update-dev-branch

+# This is used to sync the `dev` branch with the `main` branch to continuously
+# deploy a second instance of the app to Vercel: https://app.dev.zoo.dev
+
 on:
  push:
    branches:
@ -26,4 +29,4 @@ jobs:
          # reset to main
          git reset --hard origin/main
          # force push it
-          git push -f origin dev
+          git push --force origin dev
--- a/.github/workflows/update-e2e-branch.yml
+++ b/.github/workflows/update-e2e-branch.yml
@ -0,0 +1,45 @@
+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
--- a/.gitignore
+++ b/.gitignore
@ -50,6 +50,7 @@ e2e/playwright/**/*.png
 e2e/playwright/export-snapshots/*
 !e2e/playwright/export-snapshots/*.png
 !e2e/playwright/snapshot-tests.spec.ts-snapshots/*.png
+trace.zip

 /public/kcl-samples.zip
 /public/kcl-samples/.github
--- a/132
+++ b/132
@ -1,12 +1,125 @@
-.PHONY: dev
+.PHONY: all
+all: install build check

-KCL_WASM_LIB_FILES := $(wildcard rust/**/*.rs)
-TS_SRC := $(wildcard src/**/*.tsx) $(wildcard src/**/*.ts)
-XSTATE_TYPEGENS := $(wildcard src/machines/*.typegen.ts)
+###############################################################################
+# INSTALL

-dev: node_modules public/kcl_wasm_lib_bg.wasm $(XSTATE_TYPEGENS)
+WASM_PACK ?= ~/.cargo/bin/wasm-pack
+
+.PHONY: install
+install: node_modules/.yarn-integrity $(WASM_PACK) ## Install dependencies
+
+node_modules/.yarn-integrity: package.json yarn.lock
+	yarn install
+	@ touch $@
+
+$(WASM_PACK):
+	yarn install:rust
+	yarn install:wasm-pack:sh
+
+###############################################################################
+# BUILD
+
+CARGO_SOURCES := rust/.cargo/config.toml $(wildcard rust/Cargo.*) $(wildcard rust/**/Cargo.*)
+RUST_SOURCES := $(wildcard rust/**/*.rs)
+
+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: public/kcl_wasm_lib_bg.wasm build/index.html
+
+.PHONY: build-desktop
+build-desktop: public/kcl_wasm_lib_bg.wasm .vite/build/main.js
+
+public/kcl_wasm_lib_bg.wasm: $(CARGO_SOURCES)$(RUST_SOURCES)
+	yarn build:wasm:dev
+
+build/index.html: $(REACT_SOURCES) $(TYPESCRIPT_SOURCES) $(VITE_SOURCES)
+	yarn build:local
+
+.vite/build/main.js: $(REACT_SOURCES) $(TYPESCRIPT_SOURCES) $(VITE_SOURCES)
+	yarn tronb:vite:dev
+
+###############################################################################
+# CHECK
+
+.PHONY: check
+check: format lint
+
+.PHONY: format
+format: install ## Format the code
+	yarn fmt
+
+.PHONY: lint
+lint: install ## Lint the code
+	yarn tsc
+	yarn lint
+
+###############################################################################
+# RUN
+
+.PHONY: run
+run: run-web
+
+.PHONY: run-web
+run-web: install build-web ## Start the web app
 	yarn start

+.PHONY: run-desktop
+run-desktop: install build-desktop ## Start the desktop app
+	yarn tron:start
+
+###############################################################################
+# TEST
+
+E2E_WORKERS ?= 1
+E2E_FAILURES ?= 1
+E2E_GREP ?= ""
+
+.PHONY: test
+test: test-unit test-e2e
+
+.PHONY: test-unit
+test-unit: install ## Run the unit tests
+	@ curl -fs localhost:3000 >/dev/null || ( echo "Error: localhost:3000 not available, 'make run-web' first" && exit 1 )
+	yarn test:unit
+
+.PHONY: test-e2e
+test-e2e: test-e2e-desktop
+
+.PHONY: test-e2e-web
+test-e2e-web: install build-web ## Run the web e2e tests
+	@ curl -fs localhost:3000 >/dev/null || ( echo "Error: localhost:3000 not available, 'make run-web' first" && exit 1 )
+	yarn chrome:test --headed --workers=$(E2E_WORKERS) --max-failures=$(E2E_FAILURES) --grep=$(E2E_GREP)
+
+.PHONY: test-e2e-desktop
+test-e2e-desktop: install build-desktop ## Run the desktop e2e tests
+	yarn test:playwright:electron --workers=$(E2E_WORKERS) --max-failures=$(E2E_FAILURES) --grep="$(E2E_GREP)"
+
+###############################################################################
+# CLEAN
+
+.PHONY: clean
+clean: ## Delete all artifacts
+	rm -rf .vite/ build/
+	rm -rf trace.zip playwright-report/ test-results/
+	rm -rf public/kcl_wasm_lib_bg.wasm
+	rm -rf rust/*/bindings/ rust/*/pkg/ rust/target/
+	rm -rf node_modules/ rust/*/node_modules/
+
+.PHONY: help
+help: install
+	@ grep -E '^[^[:space:]]+:.*## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'
+
+.DEFAULT_GOAL := help
+
+###############################################################################
+
 # I'm sorry this is so specific to my setup you may as well ignore this.
 # This is so you don't have to deal with electron windows popping up constantly.
 # It should work for you other Linux users.
@ -14,12 +127,3 @@ lee-electron-test:
 	Xephyr -br -ac -noreset -screen 1200x500 :2 &
 	DISPLAY=:2 NODE_ENV=development PW_TEST_CONNECT_WS_ENDPOINT=ws://127.0.0.1:4444/ yarn tron:test -g "when using the file tree"
 	killall Xephyr
-
-$(XSTATE_TYPEGENS): $(TS_SRC)
-	yarn xstate typegen 'src/**/*.ts?(x)'
-
-public/kcl_wasm_lib_bg.wasm: $(KCL_WASM_LIB_FILES)
-	yarn build:wasm
-
-node_modules: package.json yarn.lock
-	yarn install
--- a/docs/kcl/abs.md
+++ b/docs/kcl/abs.md
@ -33,7 +33,7 @@ abs(num: number): number
 ```js
 myAngle = -120

-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [8, 0])
  |> angledLine({ angle = abs(myAngle), length = 5 }, %)
--- a/docs/kcl/acos.md
+++ b/docs/kcl/acos.md
@ -31,7 +31,7 @@ acos(num: number): number
 ### Examples

 ```js
-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({
       angle = toDegrees(acos(0.5)),
--- a/docs/kcl/angleToMatchLengthX.md
+++ b/docs/kcl/angleToMatchLengthX.md
@ -33,7 +33,7 @@ angleToMatchLengthX(
 ### Examples

 ```js
-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [2, 5], tag = $seg01)
  |> angledLineToX([-angleToMatchLengthX(seg01, 7, %), 10], %)
--- a/docs/kcl/angleToMatchLengthY.md
+++ b/docs/kcl/angleToMatchLengthY.md
@ -33,7 +33,7 @@ angleToMatchLengthY(
 ### Examples

 ```js
-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [1, 2], tag = $seg01)
  |> angledLine({
--- a/docs/kcl/appearance.md
+++ b/docs/kcl/appearance.md
@ -36,7 +36,7 @@ appearance(

 ```js
 // Add color to an extruded solid.
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(endAbsolute = [10, 0])
  |> line(endAbsolute = [0, 10])
@ -52,7 +52,7 @@ example = extrude(exampleSketch, length = 5)

 ```js
 // Add color to a revolved solid.
-sketch001 = startSketchOn('XY')
+sketch001 = startSketchOn(XY)
  |> circle(center = [15, 0], radius = 5)
  |> revolve(angle = 360, axis = 'y')
  |> appearance(color = '#ff0000', metalness = 90, roughness = 90)
@ -63,7 +63,7 @@ sketch001 = startSketchOn('XY')
 ```js
 // Add color to different solids.
 fn cube(center) {
-  return startSketchOn('XY')
+  return startSketchOn(XY)
    |> startProfileAt([center[0] - 10, center[1] - 10], %)
    |> line(endAbsolute = [center[0] + 10, center[1] - 10])
    |> line(endAbsolute = [center[0] + 10, center[1] + 10])
@ -95,7 +95,7 @@ appearance(
 ```js
 // You can set the appearance before or after you shell it will yield the same result.
 // This example shows setting the appearance _after_ the shell.
-firstSketch = startSketchOn('XY')
+firstSketch = startSketchOn(XY)
  |> startProfileAt([-12, 12], %)
  |> line(end = [24, 0])
  |> line(end = [0, -24])
@ -112,7 +112,7 @@ shell(firstSketch, faces = ['end'], thickness = 0.25)
 ```js
 // You can set the appearance before or after you shell it will yield the same result.
 // This example shows setting the appearance _before_ the shell.
-firstSketch = startSketchOn('XY')
+firstSketch = startSketchOn(XY)
  |> startProfileAt([-12, 12], %)
  |> line(end = [24, 0])
  |> line(end = [0, -24])
@ -129,7 +129,7 @@ shell(firstSketch, faces = ['end'], thickness = 0.25)
 ```js
 // Setting the appearance of a 3D pattern can be done _before_ or _after_ the pattern.
 // This example shows _before_ the pattern.
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [0, 2])
  |> line(end = [3, 1])
@ -146,7 +146,7 @@ example = extrude(exampleSketch, length = 1)
 ```js
 // Setting the appearance of a 3D pattern can be done _before_ or _after_ the pattern.
 // This example shows _after_ the pattern.
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [0, 2])
  |> line(end = [3, 1])
@ -162,7 +162,7 @@ example = extrude(exampleSketch, length = 1)

 ```js
 // Color the result of a 2D pattern that was extruded.
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([.5, 25], %)
  |> line(end = [0, 5])
  |> line(end = [-1, 0])
@ -184,9 +184,8 @@ example = extrude(exampleSketch, length = 1)
 ```js
 // Color the result of a sweep.

-
 // Create a path for the sweep.
-sweepPath = startSketchOn('XZ')
+sweepPath = startSketchOn(XZ)
  |> startProfileAt([0.05, 0.05], %)
  |> line(end = [0, 7])
  |> tangentialArc({ offset = 90, radius = 5 }, %)
@ -194,10 +193,10 @@ sweepPath = startSketchOn('XZ')
  |> tangentialArc({ offset = -90, radius = 5 }, %)
  |> line(end = [0, 7])

-pipeHole = startSketchOn('XY')
+pipeHole = startSketchOn(XY)
  |> circle(center = [0, 0], radius = 1.5)

-sweepSketch = startSketchOn('XY')
+sweepSketch = startSketchOn(XY)
  |> circle(center = [0, 0], radius = 2)
  |> hole(pipeHole, %)
  |> sweep(path = sweepPath)
--- a/docs/kcl/asin.md
+++ b/docs/kcl/asin.md
@ -31,7 +31,7 @@ asin(num: number): number
 ### Examples

 ```js
-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({
       angle = toDegrees(asin(0.5)),
--- a/docs/kcl/atan.md
+++ b/docs/kcl/atan.md
@ -31,7 +31,7 @@ atan(num: number): number
 ### Examples

 ```js
-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({
       angle = toDegrees(atan(1.25)),
--- a/docs/kcl/atan2.md
+++ b/docs/kcl/atan2.md
@ -35,7 +35,7 @@ atan2(
 ### Examples

 ```js
-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({
       angle = toDegrees(atan2(1.25, 2)),
--- a/docs/kcl/ceil.md
+++ b/docs/kcl/ceil.md
@ -31,7 +31,7 @@ ceil(num: number): number
 ### Examples

 ```js
-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(endAbsolute = [12, 10])
  |> line(end = [ceil(7.02986), 0])
--- a/docs/kcl/chamfer.md
+++ b/docs/kcl/chamfer.md
@ -41,7 +41,7 @@ length = 10
 thickness = 1
 chamferLength = 2

-mountingPlateSketch = startSketchOn("XY")
+mountingPlateSketch = startSketchOn(XY)
  |> startProfileAt([-width / 2, -length / 2], %)
  |> line(endAbsolute = [width / 2, -length / 2], tag = $edge1)
  |> line(endAbsolute = [width / 2, length / 2], tag = $edge2)
@ -65,7 +65,7 @@ mountingPlate = extrude(mountingPlateSketch, length = thickness)
 ```js
 // Sketch on the face of a chamfer.
 fn cube(pos, scale) {
-  sg = startSketchOn('XY')
+  sg = startSketchOn(XY)
    |> startProfileAt(pos, %)
    |> line(end = [0, scale])
    |> line(end = [scale, 0])
--- a/docs/kcl/circle.md
+++ b/docs/kcl/circle.md
--- a/docs/kcl/circleThreePoint.md
+++ b/docs/kcl/circleThreePoint.md
@ -10,10 +10,10 @@ Construct a circle derived from 3 points.

 ```js
 circleThreePoint(
+  sketchSurfaceOrGroup: SketchOrSurface,
  p1: [number],
  p2: [number],
  p3: [number],
-  sketchSurfaceOrGroup: SketchOrSurface,
  tag?: TagDeclarator,
 ): Sketch
 ```
@ -23,10 +23,10 @@ circleThreePoint(

 | Name | Type | Description | Required |
 |----------|------|-------------|----------|
+| `sketchSurfaceOrGroup` | [`SketchOrSurface`](/docs/kcl/types/SketchOrSurface) | Plane or surface to sketch on. | Yes |
 | `p1` | [`[number]`](/docs/kcl/types/number) | 1st point to derive the circle. | Yes |
 | `p2` | [`[number]`](/docs/kcl/types/number) | 2nd point to derive the circle. | Yes |
 | `p3` | [`[number]`](/docs/kcl/types/number) | 3rd point to derive the circle. | Yes |
-| `sketchSurfaceOrGroup` | [`SketchOrSurface`](/docs/kcl/types/SketchOrSurface) | Plane or surface to sketch on. | Yes |
 | [`tag`](/docs/kcl/types/tag) | [`TagDeclarator`](/docs/kcl/types#tag-declaration) | Identifier for the circle to reference elsewhere. | No |

 ### Returns
@ -37,7 +37,7 @@ circleThreePoint(
 ### Examples

 ```js
-exampleSketch = startSketchOn("XY")
+exampleSketch = startSketchOn(XY)
  |> circleThreePoint(p1 = [10, 10], p2 = [20, 8], p3 = [15, 5])
  |> extrude(length = 5)
 ```
--- a/docs/kcl/consts/std-math-E.md
+++ b/docs/kcl/consts/std-math-E.md
@ -15,7 +15,7 @@ std::math::E: number = 2.71828182845904523536028747135266250_
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({
    angle = 30,
--- a/docs/kcl/consts/std-math-PI.md
+++ b/docs/kcl/consts/std-math-PI.md
@ -17,7 +17,7 @@ std::math::PI: number = 3.14159265358979323846264338327950288_
 ```js
 circumference = 70

-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
 |> circle(center = [0, 0], radius = circumference/ (2 * PI))

 example = extrude(exampleSketch, length = 5)
--- a/docs/kcl/consts/std-math-TAU.md
+++ b/docs/kcl/consts/std-math-TAU.md
@ -15,7 +15,7 @@ std::math::TAU: number = 6.28318530717958647692528676655900577_
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({
    angle = 50,
--- a/docs/kcl/e.md
+++ b/docs/kcl/e.md
@ -28,7 +28,7 @@ e(): number
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({ angle = 30, length = 2 * e() ^ 2 }, %)
  |> yLine(endAbsolute = 0)
--- a/docs/kcl/extrude.md
+++ b/docs/kcl/extrude.md
--- a/docs/kcl/fillet.md
+++ b/docs/kcl/fillet.md
@ -42,7 +42,7 @@ length = 10
 thickness = 1
 filletRadius = 2

-mountingPlateSketch = startSketchOn("XY")
+mountingPlateSketch = startSketchOn(XY)
  |> startProfileAt([-width / 2, -length / 2], %)
  |> line(endAbsolute = [width / 2, -length / 2], tag = $edge1)
  |> line(endAbsolute = [width / 2, length / 2], tag = $edge2)
@ -69,7 +69,7 @@ length = 10
 thickness = 1
 filletRadius = 1

-mountingPlateSketch = startSketchOn("XY")
+mountingPlateSketch = startSketchOn(XY)
  |> startProfileAt([-width / 2, -length / 2], %)
  |> line(endAbsolute = [width / 2, -length / 2], tag = $edge1)
  |> line(endAbsolute = [width / 2, length / 2], tag = $edge2)
--- a/docs/kcl/floor.md
+++ b/docs/kcl/floor.md
@ -31,7 +31,7 @@ floor(num: number): number
 ### Examples

 ```js
-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(endAbsolute = [12, 10])
  |> line(end = [floor(7.02986), 0])
--- a/docs/kcl/getCommonEdge.md
+++ b/docs/kcl/getCommonEdge.md
--- a/docs/kcl/getNextAdjacentEdge.md
+++ b/docs/kcl/getNextAdjacentEdge.md
@ -27,7 +27,7 @@ getNextAdjacentEdge(tag: TagIdentifier): Uuid
 ### Examples

 ```js
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [10, 0])
  |> angledLine({ angle = 60, length = 10 }, %)
--- a/docs/kcl/getOppositeEdge.md
+++ b/docs/kcl/getOppositeEdge.md
@ -27,7 +27,7 @@ getOppositeEdge(tag: TagIdentifier): Uuid
 ### Examples

 ```js
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [10, 0])
  |> angledLine({ angle = 60, length = 10 }, %)
--- a/docs/kcl/getPreviousAdjacentEdge.md
+++ b/docs/kcl/getPreviousAdjacentEdge.md
@ -27,7 +27,7 @@ getPreviousAdjacentEdge(tag: TagIdentifier): Uuid
 ### Examples

 ```js
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [10, 0])
  |> angledLine({ angle = 60, length = 10 }, %)
--- a/docs/kcl/helix.md
+++ b/docs/kcl/helix.md
--- a/docs/kcl/helixRevolutions.md
+++ b/docs/kcl/helixRevolutions.md
--- a/docs/kcl/hollow.md
+++ b/docs/kcl/hollow.md
@ -32,7 +32,7 @@ hollow(

 ```js
 // Hollow a basic sketch.
-firstSketch = startSketchOn('XY')
+firstSketch = startSketchOn(XY)
  |> startProfileAt([-12, 12], %)
  |> line(end = [24, 0])
  |> line(end = [0, -24])
@ -46,7 +46,7 @@ firstSketch = startSketchOn('XY')

 ```js
 // Hollow a basic sketch.
-firstSketch = startSketchOn('-XZ')
+firstSketch = startSketchOn(-XZ)
  |> startProfileAt([-12, 12], %)
  |> line(end = [24, 0])
  |> line(end = [0, -24])
@ -61,7 +61,7 @@ firstSketch = startSketchOn('-XZ')
 ```js
 // Hollow a sketch on face object.
 size = 100
-case = startSketchOn('-XZ')
+case = startSketchOn(-XZ)
  |> startProfileAt([-size, -size], %)
  |> line(end = [2 * size, 0])
  |> line(end = [0, 2 * size])
--- a/docs/kcl/import.md
+++ b/docs/kcl/import.md
@ -69,7 +69,7 @@ model = import("tests/inputs/cube.step")
 ```js
 import height, buildSketch from "common.kcl"

-plane = 'XZ'
+plane = XZ
 margin = 2
 s1 = buildSketch(plane, [0, 0])
 s2 = buildSketch(plane, [0, height() + margin])
--- a/docs/kcl/index.md
+++ b/docs/kcl/index.md
@ -22,8 +22,12 @@ layout: manual
  * [`string`](kcl/types/string)
  * [`tag`](kcl/types/tag)
 * **std**
+  * [`Face`](kcl/types/Face)
  * [`HALF_TURN`](kcl/consts/std-HALF_TURN)
+  * [`Helix`](kcl/types/Helix)
  * [`Plane`](kcl/types/Plane)
+  * [`Point2d`](kcl/types/Point2d)
+  * [`Point3d`](kcl/types/Point3d)
  * [`QUARTER_TURN`](kcl/consts/std-QUARTER_TURN)
  * [`Sketch`](kcl/types/Sketch)
  * [`Solid`](kcl/types/Solid)
@ -57,7 +61,6 @@ layout: manual
  * [`bezierCurve`](kcl/bezierCurve)
  * [`ceil`](kcl/ceil)
  * [`chamfer`](kcl/chamfer)
-  * [`circle`](kcl/circle)
  * [`circleThreePoint`](kcl/circleThreePoint)
  * [`close`](kcl/close)
  * [`cm`](kcl/cm)
@ -65,11 +68,11 @@ layout: manual
  * [`fillet`](kcl/fillet)
  * [`floor`](kcl/floor)
  * [`ft`](kcl/ft)
+  * [`getCommonEdge`](kcl/getCommonEdge)
  * [`getNextAdjacentEdge`](kcl/getNextAdjacentEdge)
  * [`getOppositeEdge`](kcl/getOppositeEdge)
  * [`getPreviousAdjacentEdge`](kcl/getPreviousAdjacentEdge)
  * [`helix`](kcl/helix)
-  * [`helixRevolutions`](kcl/helixRevolutions)
  * [`hole`](kcl/hole)
  * [`hollow`](kcl/hollow)
  * [`inch`](kcl/inch)
@ -141,3 +144,5 @@ layout: manual
  * [`cos`](kcl/std-math-cos)
  * [`sin`](kcl/std-math-sin)
  * [`tan`](kcl/std-math-tan)
+* **std::sketch**
+  * [`circle`](kcl/std-sketch-circle)
--- a/docs/kcl/int.md
+++ b/docs/kcl/int.md
@ -36,7 +36,7 @@ int(num: number): number
 n = int(ceil(5 / 2))
 assertEqual(n, 3, 0.0001, "5/2 = 2.5, rounded up makes 3")
 // Draw n cylinders.
-startSketchOn('XZ')
+startSketchOn(XZ)
  |> circle(center = [0, 0], radius = 2)
  |> extrude(length = 5)
  |> patternTransform(
--- a/docs/kcl/intersect.md
+++ b/docs/kcl/intersect.md
--- a/docs/kcl/lastSegX.md
+++ b/docs/kcl/lastSegX.md
@ -27,7 +27,7 @@ lastSegX(sketch: Sketch): number
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [5, 0])
  |> line(end = [20, 5])
--- a/docs/kcl/lastSegY.md
+++ b/docs/kcl/lastSegY.md
@ -27,7 +27,7 @@ lastSegY(sketch: Sketch): number
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [5, 0])
  |> line(end = [20, 5])
--- a/docs/kcl/ln.md
+++ b/docs/kcl/ln.md
@ -31,7 +31,7 @@ ln(num: number): number
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [ln(100), 15])
  |> line(end = [5, -6])
--- a/docs/kcl/loft.md
+++ b/docs/kcl/loft.md
@ -42,7 +42,7 @@ loft(

 ```js
 // Loft a square and a triangle.
-squareSketch = startSketchOn('XY')
+squareSketch = startSketchOn(XY)
  |> startProfileAt([-100, 200], %)
  |> line(end = [200, 0])
  |> line(end = [0, -200])
@ -50,7 +50,7 @@ squareSketch = startSketchOn('XY')
  |> line(endAbsolute = [profileStartX(%), profileStartY(%)])
  |> close()

-triangleSketch = startSketchOn(offsetPlane('XY', offset = 75))
+triangleSketch = startSketchOn(offsetPlane(XY, offset = 75))
  |> startProfileAt([0, 125], %)
  |> line(end = [-15, -30])
  |> line(end = [30, 0])
@ -64,7 +64,7 @@ loft([squareSketch, triangleSketch])

 ```js
 // Loft a square, a circle, and another circle.
-squareSketch = startSketchOn('XY')
+squareSketch = startSketchOn(XY)
  |> startProfileAt([-100, 200], %)
  |> line(end = [200, 0])
  |> line(end = [0, -200])
@ -72,10 +72,10 @@ squareSketch = startSketchOn('XY')
  |> line(endAbsolute = [profileStartX(%), profileStartY(%)])
  |> close()

-circleSketch0 = startSketchOn(offsetPlane('XY', offset = 75))
+circleSketch0 = startSketchOn(offsetPlane(XY, offset = 75))
  |> circle(center = [0, 100], radius = 50)

-circleSketch1 = startSketchOn(offsetPlane('XY', offset = 150))
+circleSketch1 = startSketchOn(offsetPlane(XY, offset = 150))
  |> circle(center = [0, 100], radius = 20)

 loft([
@ -89,7 +89,7 @@ loft([

 ```js
 // Loft a square, a circle, and another circle with options.
-squareSketch = startSketchOn('XY')
+squareSketch = startSketchOn(XY)
  |> startProfileAt([-100, 200], %)
  |> line(end = [200, 0])
  |> line(end = [0, -200])
@ -97,10 +97,10 @@ squareSketch = startSketchOn('XY')
  |> line(endAbsolute = [profileStartX(%), profileStartY(%)])
  |> close()

-circleSketch0 = startSketchOn(offsetPlane('XY', offset = 75))
+circleSketch0 = startSketchOn(offsetPlane(XY, offset = 75))
  |> circle(center = [0, 100], radius = 50)

-circleSketch1 = startSketchOn(offsetPlane('XY', offset = 150))
+circleSketch1 = startSketchOn(offsetPlane(XY, offset = 150))
  |> circle(center = [0, 100], radius = 20)

 loft(
--- a/docs/kcl/log.md
+++ b/docs/kcl/log.md
@ -35,7 +35,7 @@ log(
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [log(100, 5), 0])
  |> line(end = [5, 8])
--- a/docs/kcl/log10.md
+++ b/docs/kcl/log10.md
@ -31,7 +31,7 @@ log10(num: number): number
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [log10(100), 0])
  |> line(end = [5, 8])
--- a/docs/kcl/log2.md
+++ b/docs/kcl/log2.md
@ -31,7 +31,7 @@ log2(num: number): number
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [log2(100), 0])
  |> line(end = [5, 8])
--- a/docs/kcl/map.md
+++ b/docs/kcl/map.md
@ -33,7 +33,7 @@ map(
 ```js
 r = 10 // radius
 fn drawCircle(id) {
-  return startSketchOn("XY")
+  return startSketchOn(XY)
    |> circle(center = [id * 2 * r, 0], radius = r)
 }

@ -49,7 +49,7 @@ circles = map([1..3], drawCircle)
 r = 10 // radius
 // Call `map`, using an anonymous function instead of a named one.
 circles = map([1..3], fn(id) {
-  return startSketchOn("XY")
+  return startSketchOn(XY)
    |> circle(center = [id * 2 * r, 0], radius = r)
 })
 ```
--- a/docs/kcl/max.md
+++ b/docs/kcl/max.md
@ -31,7 +31,7 @@ max(args: [number]): number
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({
       angle = 70,
--- a/docs/kcl/min.md
+++ b/docs/kcl/min.md
@ -31,7 +31,7 @@ min(args: [number]): number
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({
       angle = 70,
--- a/docs/kcl/mirror2d.md
+++ b/docs/kcl/mirror2d.md
@ -34,7 +34,7 @@ mirror2d(

 ```js
 // Mirror an un-closed sketch across the Y axis.
-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> startProfileAt([0, 10], %)
  |> line(end = [15, 0])
  |> line(end = [-7, -3])
@ -53,7 +53,7 @@ example = extrude(sketch001, length = 10)

 ```js
 // Mirror a un-closed sketch across the Y axis.
-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> startProfileAt([0, 8.5], %)
  |> line(end = [20, -8.5])
  |> line(end = [-20, -8.5])
@ -66,11 +66,11 @@ example = extrude(sketch001, length = 10)

 ```js
 // Mirror a un-closed sketch across an edge.
-helper001 = startSketchOn('XZ')
+helper001 = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [0, 10], tag = $edge001)

-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> startProfileAt([0, 8.5], %)
  |> line(end = [20, -8.5])
  |> line(end = [-20, -8.5])
@ -83,7 +83,7 @@ sketch001 = startSketchOn('XZ')

 ```js
 // Mirror an un-closed sketch across a custom axis.
-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> startProfileAt([0, 8.5], %)
  |> line(end = [20, -8.5])
  |> line(end = [-20, -8.5])
--- a/docs/kcl/offsetPlane.md
+++ b/docs/kcl/offsetPlane.md
@ -32,7 +32,7 @@ offsetPlane(

 ```js
 // Loft a square and a circle on the `XY` plane using offset.
-squareSketch = startSketchOn('XY')
+squareSketch = startSketchOn(XY)
  |> startProfileAt([-100, 200], %)
  |> line(end = [200, 0])
  |> line(end = [0, -200])
@ -40,7 +40,7 @@ squareSketch = startSketchOn('XY')
  |> line(endAbsolute = [profileStartX(%), profileStartY(%)])
  |> close()

-circleSketch = startSketchOn(offsetPlane('XY', offset = 150))
+circleSketch = startSketchOn(offsetPlane(XY, offset = 150))
  |> circle(center = [0, 100], radius = 50)

 loft([squareSketch, circleSketch])
@ -50,7 +50,7 @@ loft([squareSketch, circleSketch])

 ```js
 // Loft a square and a circle on the `XZ` plane using offset.
-squareSketch = startSketchOn('XZ')
+squareSketch = startSketchOn(XZ)
  |> startProfileAt([-100, 200], %)
  |> line(end = [200, 0])
  |> line(end = [0, -200])
@ -58,7 +58,7 @@ squareSketch = startSketchOn('XZ')
  |> line(endAbsolute = [profileStartX(%), profileStartY(%)])
  |> close()

-circleSketch = startSketchOn(offsetPlane('XZ', offset = 150))
+circleSketch = startSketchOn(offsetPlane(XZ, offset = 150))
  |> circle(center = [0, 100], radius = 50)

 loft([squareSketch, circleSketch])
@ -68,7 +68,7 @@ loft([squareSketch, circleSketch])

 ```js
 // Loft a square and a circle on the `YZ` plane using offset.
-squareSketch = startSketchOn('YZ')
+squareSketch = startSketchOn(YZ)
  |> startProfileAt([-100, 200], %)
  |> line(end = [200, 0])
  |> line(end = [0, -200])
@ -76,7 +76,7 @@ squareSketch = startSketchOn('YZ')
  |> line(endAbsolute = [profileStartX(%), profileStartY(%)])
  |> close()

-circleSketch = startSketchOn(offsetPlane('YZ', offset = 150))
+circleSketch = startSketchOn(offsetPlane(YZ, offset = 150))
  |> circle(center = [0, 100], radius = 50)

 loft([squareSketch, circleSketch])
@ -86,7 +86,7 @@ loft([squareSketch, circleSketch])

 ```js
 // Loft a square and a circle on the `-XZ` plane using offset.
-squareSketch = startSketchOn('-XZ')
+squareSketch = startSketchOn(-XZ)
  |> startProfileAt([-100, 200], %)
  |> line(end = [200, 0])
  |> line(end = [0, -200])
@ -94,7 +94,7 @@ squareSketch = startSketchOn('-XZ')
  |> line(endAbsolute = [profileStartX(%), profileStartY(%)])
  |> close()

-circleSketch = startSketchOn(offsetPlane('-XZ', offset = -150))
+circleSketch = startSketchOn(offsetPlane(-XZ, offset = -150))
  |> circle(center = [0, 100], radius = 50)

 loft([squareSketch, circleSketch])
@ -104,12 +104,12 @@ loft([squareSketch, circleSketch])

 ```js
 // A circle on the XY plane
-startSketchOn("XY")
+startSketchOn(XY)
  |> startProfileAt([0, 0], %)
  |> circle(radius = 10, center = [0, 0])

 // Triangle on the plane 4 units above
-startSketchOn(offsetPlane("XY", offset = 4))
+startSketchOn(offsetPlane(XY, offset = 4))
  |> startProfileAt([0, 0], %)
  |> line(end = [10, 0])
  |> line(end = [0, 10])
--- a/docs/kcl/patternCircular2d.md
+++ b/docs/kcl/patternCircular2d.md
@ -39,7 +39,7 @@ patternCircular2d(
 ### Examples

 ```js
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([.5, 25], %)
  |> line(end = [0, 5])
  |> line(end = [-1, 0])
--- a/docs/kcl/patternCircular3d.md
+++ b/docs/kcl/patternCircular3d.md
@ -41,7 +41,7 @@ patternCircular3d(
 ### Examples

 ```js
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> circle(center = [0, 0], radius = 1)

 example = extrude(exampleSketch, length = -5)
--- a/docs/kcl/patternLinear2d.md
+++ b/docs/kcl/patternLinear2d.md
@ -37,7 +37,7 @@ patternLinear2d(
 ### Examples

 ```js
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> circle(center = [0, 0], radius = 1)
  |> patternLinear2d(axis = [1, 0], instances = 7, distance = 4)

--- a/docs/kcl/patternLinear3d.md
+++ b/docs/kcl/patternLinear3d.md
@ -37,7 +37,7 @@ patternLinear3d(
 ### Examples

 ```js
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [0, 2])
  |> line(end = [3, 1])
@ -53,7 +53,7 @@ example = extrude(exampleSketch, length = 1)
 ```js
 // Pattern a whole sketch on face.
 size = 100
-case = startSketchOn('XY')
+case = startSketchOn(XY)
  |> startProfileAt([-size, -size], %)
  |> line(end = [2 * size, 0])
  |> line(end = [0, 2 * size])
@ -84,7 +84,7 @@ patternLinear3d(
 ```js
 // Pattern an object on a face.
 size = 100
-case = startSketchOn('XY')
+case = startSketchOn(XY)
  |> startProfileAt([-size, -size], %)
  |> line(end = [2 * size, 0])
  |> line(end = [0, 2 * size])
--- a/docs/kcl/patternTransform.md
+++ b/docs/kcl/patternTransform.md
@ -67,7 +67,7 @@ fn transform(id) {
 }

 // Sketch 4 cylinders.
-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> circle(center = [0, 0], radius = 2)
  |> extrude(length = 5)
  |> patternTransform(instances = 4, transform = transform)
@ -83,7 +83,7 @@ fn transform(id) {
  return { translate = [4 * (1 + id), 0, 0] }
 }

-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> circle(center = [0, 0], radius = 2)
  |> extrude(length = 5)
  |> patternTransform(instances = 4, transform = transform)
@ -101,7 +101,7 @@ fn cube(length, center) {
  p2 = [l + x, l + y]
  p3 = [l + x, -l + y]

-  return startSketchOn('XY')
+  return startSketchOn(XY)
    |> startProfileAt(p0, %)
    |> line(endAbsolute = p1)
    |> line(endAbsolute = p2)
@ -139,7 +139,7 @@ fn cube(length, center) {
  p2 = [l + x, l + y]
  p3 = [l + x, -l + y]

-  return startSketchOn('XY')
+  return startSketchOn(XY)
    |> startProfileAt(p0, %)
    |> line(endAbsolute = p1)
    |> line(endAbsolute = p2)
@ -182,7 +182,7 @@ fn transform(replicaId) {
 }
 // Each layer is just a pretty thin cylinder.
 fn layer() {
-  return startSketchOn("XY")
+  return startSketchOn(XY)
    // or some other plane idk
    |> circle(center = [0, 0], radius = 1, tag = $tag1)
    |> extrude(length = h)
@ -203,7 +203,7 @@ fn transform(i) {
    { rotation = { angle = 45 * i } }
  ]
 }
-startSketchOn('XY')
+startSketchOn(XY)
  |> startProfileAt([0, 0], %)
  |> polygon({
       radius = 10,
--- a/docs/kcl/patternTransform2d.md
+++ b/docs/kcl/patternTransform2d.md
@ -41,7 +41,7 @@ fn transform(id) {
 }

 // Sketch 4 circles.
-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> circle(center = [0, 0], radius = 2)
  |> patternTransform2d(instances = 4, transform = transform)
 ```
--- a/docs/kcl/pi.md
+++ b/docs/kcl/pi.md
@ -30,7 +30,7 @@ pi(): number
 ```js
 circumference = 70

-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> circle(center = [0, 0], radius = circumference / (2 * pi()))

 example = extrude(exampleSketch, length = 5)
--- a/docs/kcl/polar.md
+++ b/docs/kcl/polar.md
@ -27,7 +27,7 @@ polar(data: PolarCoordsData): [number]
 ### Examples

 ```js
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = polar({ angle = 30, length = 5 }), tag = $thing)
  |> line(end = [0, 5])
--- a/docs/kcl/polygon.md
+++ b/docs/kcl/polygon.md
@ -34,7 +34,7 @@ polygon(

 ```js
 // Create a regular hexagon inscribed in a circle of radius 10
-hex = startSketchOn('XY')
+hex = startSketchOn(XY)
  |> polygon({
       radius = 10,
       numSides = 6,
@ -49,7 +49,7 @@ example = extrude(hex, length = 5)

 ```js
 // Create a square circumscribed around a circle of radius 5
-square = startSketchOn('XY')
+square = startSketchOn(XY)
  |> polygon({
       radius = 5.0,
       numSides = 4,
--- a/docs/kcl/pow.md
+++ b/docs/kcl/pow.md
@ -35,7 +35,7 @@ pow(
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({ angle = 50, length = pow(5, 2) }, %)
  |> yLine(endAbsolute = 0)
--- a/docs/kcl/reduce.md
+++ b/docs/kcl/reduce.md
@ -52,7 +52,6 @@ fn sum(arr):
        sumSoFar = add(sumSoFar, i)
    return sumSoFar */

-
 // We use `assertEqual` to check that our `sum` function gives the
 // expected result. It's good to check your work!
 assertEqual(sum([1, 2, 3]), 6, 0.00001, "1 + 2 + 3 summed is 6")
@ -83,7 +82,7 @@ fn decagon(radius) {
  stepAngle = 1 / 10 * TAU

  // Start the decagon sketch at this point.
-  startOfDecagonSketch = startSketchOn('XY')
+  startOfDecagonSketch = startSketchOn(XY)
    |> startProfileAt([cos(0) * radius, sin(0) * radius], %)

    // Use a `reduce` to draw the remaining decagon sides.
@ -114,7 +113,6 @@ fn decagon(radius):
    fullDecagon = partialDecagon // it's now full
    return fullDecagon */

-
 // Use the `decagon` function declared above, to sketch a decagon with radius 5.
 decagon(5.0)
  |> close()
--- a/docs/kcl/revolve.md
+++ b/docs/kcl/revolve.md
--- a/docs/kcl/rotate.md
+++ b/docs/kcl/rotate.md
@ -6,6 +6,10 @@ layout: manual

 Rotate a solid or a sketch.

+This is really useful for assembling parts together. You can create a part and then rotate it to the correct orientation.
+
+For sketches, you can use this to rotate a sketch and then loft it with another sketch.
+
 ### Using Roll, Pitch, and Yaw

 When rotating a part in 3D space, "roll," "pitch," and "yaw" refer to the three rotational axes used to describe its orientation: roll is rotation around the longitudinal axis (front-to-back), pitch is rotation around the lateral axis (wing-to-wing), and yaw is rotation around the vertical axis (up-down); essentially, it's like tilting the part on its side (roll), tipping the nose up or down (pitch), and turning it left or right (yaw).
@ -57,9 +61,8 @@ rotate(
 ```js
 // Rotate a pipe with roll, pitch, and yaw.

-
 // Create a path for the sweep.
-sweepPath = startSketchOn('XZ')
+sweepPath = startSketchOn(XZ)
  |> startProfileAt([0.05, 0.05], %)
  |> line(end = [0, 7])
  |> tangentialArc({ offset = 90, radius = 5 }, %)
@ -68,10 +71,10 @@ sweepPath = startSketchOn('XZ')
  |> line(end = [0, 7])

 // Create a hole for the pipe.
-pipeHole = startSketchOn('XY')
+pipeHole = startSketchOn(XY)
  |> circle(center = [0, 0], radius = 1.5)

-sweepSketch = startSketchOn('XY')
+sweepSketch = startSketchOn(XY)
  |> circle(center = [0, 0], radius = 2)
  |> hole(pipeHole, %)
  |> sweep(path = sweepPath)
@ -83,9 +86,8 @@ sweepSketch = startSketchOn('XY')
 ```js
 // Rotate a pipe about an axis with an angle.

-
 // Create a path for the sweep.
-sweepPath = startSketchOn('XZ')
+sweepPath = startSketchOn(XZ)
  |> startProfileAt([0.05, 0.05], %)
  |> line(end = [0, 7])
  |> tangentialArc({ offset = 90, radius = 5 }, %)
@ -94,10 +96,10 @@ sweepPath = startSketchOn('XZ')
  |> line(end = [0, 7])

 // Create a hole for the pipe.
-pipeHole = startSketchOn('XY')
+pipeHole = startSketchOn(XY)
  |> circle(center = [0, 0], radius = 1.5)

-sweepSketch = startSketchOn('XY')
+sweepSketch = startSketchOn(XY)
  |> circle(center = [0, 0], radius = 2)
  |> hole(pipeHole, %)
  |> sweep(path = sweepPath)
@ -122,7 +124,7 @@ cube
 // Sweep two sketches along the same path.


-sketch001 = startSketchOn('XY')
+sketch001 = startSketchOn(XY)
 rectangleSketch = startProfileAt([-200, 23.86], sketch001)
  |> angledLine([0, 73.47], %, $rectangleSegmentA001)
  |> angledLine([
@ -138,7 +140,7 @@ rectangleSketch = startProfileAt([-200, 23.86], sketch001)

 circleSketch = circle(sketch001, center = [200, -30.29], radius = 32.63)

-sketch002 = startSketchOn('YZ')
+sketch002 = startSketchOn(YZ)
 sweepPath = startProfileAt([0, 0], sketch002)
  |> yLine(length = 231.81)
  |> tangentialArc({ radius = 80, offset = -90 }, %)
@ -154,7 +156,7 @@ rotate(parts, axis = [0, 0, 1.0], angle = 90)

 ```js
 // Translate and rotate a sketch to create a loft.
-sketch001 = startSketchOn('XY')
+sketch001 = startSketchOn(XY)

 fn square() {
  return startProfileAt([-10, 10], sketch001)
@ -168,7 +170,7 @@ fn square() {
 profile001 = square()

 profile002 = square()
-  |> translate(translate = [0, 0, 20])
+  |> translate(x = 0, y = 0, z = 20)
  |> rotate(axis = [0, 0, 1.0], angle = 45)

 loft([profile001, profile002])
--- a/docs/kcl/round.md
+++ b/docs/kcl/round.md
@ -31,7 +31,7 @@ round(num: number): number
 ### Examples

 ```js
-sketch001 = startSketchOn('XZ')
+sketch001 = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(endAbsolute = [12, 10])
  |> line(end = [round(7.02986), 0])
--- a/docs/kcl/scale.md
+++ b/docs/kcl/scale.md
--- a/docs/kcl/segAng.md
+++ b/docs/kcl/segAng.md
@ -27,7 +27,7 @@ segAng(tag: TagIdentifier): number
 ### Examples

 ```js
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [10, 0])
  |> line(end = [5, 10], tag = $seg01)
--- a/docs/kcl/segEnd.md
+++ b/docs/kcl/segEnd.md
@ -28,7 +28,7 @@ segEnd(tag: TagIdentifier): [number]

 ```js
 w = 15
-cube = startSketchOn('XY')
+cube = startSketchOn(XY)
  |> startProfileAt([0, 0], %)
  |> line(end = [w, 0], tag = $line1)
  |> line(end = [0, w], tag = $line2)
@ -38,7 +38,7 @@ cube = startSketchOn('XY')
  |> extrude(length = 5)

 fn cylinder(radius, tag) {
-  return startSketchOn('XY')
+  return startSketchOn(XY)
    |> startProfileAt([0, 0], %)
    |> circle(radius = radius, center = segEnd(tag))
    |> extrude(length = radius)
--- a/docs/kcl/segEndX.md
+++ b/docs/kcl/segEndX.md
@ -27,7 +27,7 @@ segEndX(tag: TagIdentifier): number
 ### Examples

 ```js
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [20, 0], tag = $thing)
  |> line(end = [0, 5])
--- a/docs/kcl/segEndY.md
+++ b/docs/kcl/segEndY.md
@ -27,7 +27,7 @@ segEndY(tag: TagIdentifier): number
 ### Examples

 ```js
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [20, 0])
  |> line(end = [0, 3], tag = $thing)
--- a/docs/kcl/segLen.md
+++ b/docs/kcl/segLen.md
@ -27,7 +27,7 @@ segLen(tag: TagIdentifier): number
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({ angle = 60, length = 10 }, %, $thing)
  |> tangentialArc({ offset = -120, radius = 5 }, %)
--- a/docs/kcl/segStart.md
+++ b/docs/kcl/segStart.md
@ -28,7 +28,7 @@ segStart(tag: TagIdentifier): [number]

 ```js
 w = 15
-cube = startSketchOn('XY')
+cube = startSketchOn(XY)
  |> startProfileAt([0, 0], %)
  |> line(end = [w, 0], tag = $line1)
  |> line(end = [0, w], tag = $line2)
@ -38,7 +38,7 @@ cube = startSketchOn('XY')
  |> extrude(length = 5)

 fn cylinder(radius, tag) {
-  return startSketchOn('XY')
+  return startSketchOn(XY)
    |> startProfileAt([0, 0], %)
    |> circle(radius = radius, center = segStart(tag))
    |> extrude(length = radius)
--- a/docs/kcl/segStartX.md
+++ b/docs/kcl/segStartX.md
@ -27,7 +27,7 @@ segStartX(tag: TagIdentifier): number
 ### Examples

 ```js
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [20, 0], tag = $thing)
  |> line(end = [0, 5])
--- a/docs/kcl/segStartY.md
+++ b/docs/kcl/segStartY.md
@ -27,7 +27,7 @@ segStartY(tag: TagIdentifier): number
 ### Examples

 ```js
-exampleSketch = startSketchOn('XZ')
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> line(end = [20, 0])
  |> line(end = [0, 3], tag = $thing)
--- a/docs/kcl/shell.md
+++ b/docs/kcl/shell.md
@ -34,7 +34,7 @@ shell(

 ```js
 // Remove the end face for the extrusion.
-firstSketch = startSketchOn('XY')
+firstSketch = startSketchOn(XY)
  |> startProfileAt([-12, 12], %)
  |> line(end = [24, 0])
  |> line(end = [0, -24])
@ -50,7 +50,7 @@ shell(firstSketch, faces = ['end'], thickness = 0.25)

 ```js
 // Remove the start face for the extrusion.
-firstSketch = startSketchOn('-XZ')
+firstSketch = startSketchOn(-XZ)
  |> startProfileAt([-12, 12], %)
  |> line(end = [24, 0])
  |> line(end = [0, -24])
@ -66,7 +66,7 @@ shell(firstSketch, faces = ['start'], thickness = 0.25)

 ```js
 // Remove a tagged face and the end face for the extrusion.
-firstSketch = startSketchOn('XY')
+firstSketch = startSketchOn(XY)
  |> startProfileAt([-12, 12], %)
  |> line(end = [24, 0])
  |> line(end = [0, -24])
@ -82,7 +82,7 @@ shell(firstSketch, faces = [myTag], thickness = 0.25)

 ```js
 // Remove multiple faces at once.
-firstSketch = startSketchOn('XY')
+firstSketch = startSketchOn(XY)
  |> startProfileAt([-12, 12], %)
  |> line(end = [24, 0])
  |> line(end = [0, -24])
@ -99,7 +99,7 @@ shell(firstSketch, faces = [myTag, 'end'], thickness = 0.25)
 ```js
 // Shell a sketch on face.
 size = 100
-case = startSketchOn('-XZ')
+case = startSketchOn(-XZ)
  |> startProfileAt([-size, -size], %)
  |> line(end = [2 * size, 0])
  |> line(end = [0, 2 * size])
@ -124,7 +124,7 @@ shell(case, faces = ['start'], thickness = 5)
 ```js
 // Shell a sketch on face object on the end face.
 size = 100
-case = startSketchOn('XY')
+case = startSketchOn(XY)
  |> startProfileAt([-size, -size], %)
  |> line(end = [2 * size, 0])
  |> line(end = [0, 2 * size])
@ -152,7 +152,7 @@ shell(thing1, faces = ['end'], thickness = 5)


 size = 100
-case = startSketchOn('XY')
+case = startSketchOn(XY)
  |> startProfileAt([-size, -size], %)
  |> line(end = [2 * size, 0])
  |> line(end = [0, 2 * size])
--- a/docs/kcl/sqrt.md
+++ b/docs/kcl/sqrt.md
@ -31,7 +31,7 @@ sqrt(num: number): number
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({ angle = 50, length = sqrt(2500) }, %)
  |> yLine(endAbsolute = 0)
--- a/docs/kcl/std-math-cos.md
+++ b/docs/kcl/std-math-cos.md
@ -9,7 +9,7 @@ Compute the cosine of a number (in radians).


 ```js
-cos(num: number(rad)): number(_)
+cos(@num: number(rad)): number(_)
 ```


@ -27,7 +27,7 @@ cos(num: number(rad)): number(_)
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({
    angle = 30,
--- a/docs/kcl/std-math-sin.md
+++ b/docs/kcl/std-math-sin.md
@ -9,7 +9,7 @@ Compute the sine of a number (in radians).


 ```js
-sin(num: number(rad)): number(_)
+sin(@num: number(rad)): number(_)
 ```


@ -27,7 +27,7 @@ sin(num: number(rad)): number(_)
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({
    angle = 50,
--- a/docs/kcl/std-math-tan.md
+++ b/docs/kcl/std-math-tan.md
@ -9,7 +9,7 @@ Compute the tangent of a number (in radians).


 ```js
-tan(num: number(rad)): number(_)
+tan(@num: number(rad)): number(_)
 ```


@ -27,7 +27,7 @@ tan(num: number(rad)): number(_)
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({
    angle = 50,
--- a/docs/kcl/std-sketch-circle.md
+++ b/docs/kcl/std-sketch-circle.md
--- a/docs/kcl/std.json
+++ b/docs/kcl/std.json
--- a/docs/kcl/subtract.md
+++ b/docs/kcl/subtract.md
--- a/docs/kcl/sweep.md
+++ b/docs/kcl/sweep.md
--- a/docs/kcl/tangentToEnd.md
+++ b/docs/kcl/tangentToEnd.md
--- a/docs/kcl/tau.md
+++ b/docs/kcl/tau.md
@ -28,7 +28,7 @@ tau(): number
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({ angle = 50, length = 10 * tau() }, %)
  |> yLine(endAbsolute = 0)
--- a/docs/kcl/toDegrees.md
+++ b/docs/kcl/toDegrees.md
@ -31,7 +31,7 @@ toDegrees(num: number): number
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({
       angle = 50,
--- a/docs/kcl/toRadians.md
+++ b/docs/kcl/toRadians.md
@ -31,7 +31,7 @@ toRadians(num: number): number
 ### Examples

 ```js
-exampleSketch = startSketchOn("XZ")
+exampleSketch = startSketchOn(XZ)
  |> startProfileAt([0, 0], %)
  |> angledLine({
       angle = 50,
--- a/docs/kcl/translate.md
+++ b/docs/kcl/translate.md
--- a/docs/kcl/types/Face.md
+++ b/docs/kcl/types/Face.md
@ -1,28 +1,12 @@
 ---
-title: "Face"
+title: "std::Face"
 excerpt: "A face."
 layout: manual
 ---

 A face.

-**Type:** `object`




-
-## Properties
-
-| Property | Type | Description | Required |
-|----------|------|-------------|----------|
-| `id` |[`string`](/docs/kcl/types/string)| The id of the face. | No |
-| `artifactId` |[`ArtifactId`](/docs/kcl/types/ArtifactId)| The artifact ID. | No |
-| `value` |[`string`](/docs/kcl/types/string)| The tag of the face. | No |
-| `xAxis` |[`Point3d`](/docs/kcl/types/Point3d)| What should the face's X axis be? | No |
-| `yAxis` |[`Point3d`](/docs/kcl/types/Point3d)| What should the face's Y axis be? | No |
-| `zAxis` |[`Point3d`](/docs/kcl/types/Point3d)| The z-axis (normal). | No |
-| `solid` |[`Solid`](/docs/kcl/types/Solid)| The solid the face is on. | No |
-| `units` |[`UnitLen`](/docs/kcl/types/UnitLen)| A unit of length. | No |
-
-
--- a/docs/kcl/types/Helix.md
+++ b/docs/kcl/types/Helix.md
@ -1,26 +1,12 @@
 ---
-title: "Helix"
+title: "std::Helix"
 excerpt: "A helix."
 layout: manual
 ---

 A helix.

-**Type:** `object`




-
-## Properties
-
-| Property | Type | Description | Required |
-|----------|------|-------------|----------|
-| `value` |[`string`](/docs/kcl/types/string)| The id of the helix. | No |
-| `artifactId` |[`ArtifactId`](/docs/kcl/types/ArtifactId)| The artifact ID. | No |
-| `revolutions` |[`number`](/docs/kcl/types/number)| Number of revolutions. | No |
-| `angleStart` |[`number`](/docs/kcl/types/number)| Start angle (in degrees). | No |
-| `ccw` |`boolean`| Is the helix rotation counter clockwise? | No |
-| `units` |[`UnitLen`](/docs/kcl/types/UnitLen)| A unit of length. | No |
-
-
--- a/docs/kcl/types/HelixValue.md
+++ b/docs/kcl/types/HelixValue.md
@ -21,6 +21,7 @@ A helix.
 | `revolutions` |[`number`](/docs/kcl/types/number)| Number of revolutions. | No |
 | `angleStart` |[`number`](/docs/kcl/types/number)| Start angle (in degrees). | No |
 | `ccw` |`boolean`| Is the helix rotation counter clockwise? | No |
+| `cylinderId` |[`string`](/docs/kcl/types/string)| The cylinder the helix was created on. | No |
 | `units` |[`UnitLen`](/docs/kcl/types/UnitLen)| A unit of length. | No |


--- a/docs/kcl/types/KclValue.md
+++ b/docs/kcl/types/KclValue.md
@ -188,7 +188,7 @@ Any KCL value.
 | Property | Type | Description | Required |
 |----------|------|-------------|----------|
 | `type` |enum: [`Face`](/docs/kcl/types/Face)|  | No |
-| `value` |[`Face`](/docs/kcl/types/Face)| A face. | No |
+| `value` |[`Face`](/docs/kcl/types/Face)|  | No |


 ----
@ -236,7 +236,7 @@ Any KCL value.
 | Property | Type | Description | Required |
 |----------|------|-------------|----------|
 | `type` |enum: [`Helix`](/docs/kcl/types/Helix)|  | No |
-| `value` |[`Helix`](/docs/kcl/types/Helix)| A helix. | No |
+| `value` |[`Helix`](/docs/kcl/types/Helix)|  | No |


 ----
--- a/docs/kcl/types/Point2d.md
+++ b/docs/kcl/types/Point2d.md
@ -0,0 +1,17 @@
+---
+title: "std::Point2d"
+excerpt: "A point in two dimensional space."
+layout: manual
+---
+
+A point in two dimensional space.
+
+```kcl
+type Point2d = [number; 2]
+```
+
+[`Point2d`](/docs/kcl/types/Point2d) is an alias for a two-element array of [number](/docs/kcl/types/number)s. To write a value
+with type [`Point2d`](/docs/kcl/types/Point2d), use an array, e.g., `[0, 0]` or `[5.0, 3.14]`.
+
+
+
--- a/Show More
+++ b/Show More