bump version to 0.19.4 (#2262)

bump version

Signed-off-by: Jess Frazelle <github@jessfraz.com>

.codespellrc

@@ -1,3 +1,3 @@
 [codespell]
-ignore-words-list: crate,everytime
+ignore-words-list: crate,everytime,inout,co-ordinate,ot,nwo,absolutey,atleast
-skip: **/target,node_modules,build
+skip: **/target,node_modules,build,**/Cargo.lock,./docs/kcl/*.md,./src-tauri/gen/schemas

.env.development

@@ -1,6 +1,5 @@
-VITE_KC_API_WS_MODELING_URL=wss://api.dev.kittycad.io/ws/modeling/commands
+VITE_KC_API_WS_MODELING_URL=wss://api.dev.zoo.dev/ws/modeling/commands
-VITE_KC_API_BASE_URL=https://api.dev.kittycad.io
+VITE_KC_API_BASE_URL=https://api.dev.zoo.dev
-VITE_KC_SITE_BASE_URL=https://dev.kittycad.io
+VITE_KC_SITE_BASE_URL=https://dev.zoo.dev
 VITE_KC_SKIP_AUTH=false
 VITE_KC_CONNECTION_TIMEOUT_MS=5000
-VITE_KC_SENTRY_DSN=

.env.production

@@ -1,6 +1,5 @@
-VITE_KC_API_WS_MODELING_URL=wss://api.kittycad.io/ws/modeling/commands
+VITE_KC_API_WS_MODELING_URL=wss://api.zoo.dev/ws/modeling/commands
-VITE_KC_API_BASE_URL=https://api.kittycad.io
+VITE_KC_API_BASE_URL=https://api.zoo.dev
-VITE_KC_SITE_BASE_URL=https://kittycad.io
+VITE_KC_SITE_BASE_URL=https://zoo.dev
 VITE_KC_SKIP_AUTH=false
 VITE_KC_CONNECTION_TIMEOUT_MS=15000
-VITE_KC_SENTRY_DSN=https://a814f2f66734989a90367f48feee28ca@o1042111.ingest.sentry.io/4505789425844224

.eslintignore

@@ -1 +1,2 @@
 src/wasm-lib/*
+*.typegen.ts

.eslintrc

@@ -17,12 +17,12 @@
         "never"
       ],
       "react-hooks/exhaustive-deps": "off",
-      "@typescript-eslint/no-floating-promises": "warn"
     },
     "overrides": [
       {
         "files": ["e2e/**/*.ts"], // Update the pattern based on your file structure
         "rules": {
+          "@typescript-eslint/no-floating-promises": "warn",
           "testing-library/prefer-screen-queries": "off"
         }
       }

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,85 @@
+name: Bug Report
+description: File a bug report for the Zoo Modeling App
+title: "[BUG]: "
+labels: ["bug"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: "Thank you for taking the time to report a bug. Please provide as much information as possible to help us resolve it."
+
+  - type: textarea
+    id: describe-bug
+    attributes:
+      label: Describe the bug
+      description: A clear and concise description of what the bug is.
+      placeholder: "Explain the bug..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce-bug
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior.
+      placeholder: |
+        1. Go to '...'
+        2. Click on '....'
+        3. Scroll down to '....'
+        4. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: Expected Behavior
+      description: Description of what you expected to happen.
+      placeholder: "I expected that..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: Screenshots and Recordings 
+      description: If applicable, add screenshots to help explain your problem. Maximum upload size is 10MB.
+      placeholder: "You can attach images or video recordings here."
+    validations:
+      required: false
+
+  - type: input
+    id: desktop-os
+    attributes:
+      label: Desktop OS
+      description: "Your operating system"
+      placeholder: "example: Windows 10, MacOS Big Sur"
+    validations:
+      required: true
+
+  - type: input
+    id: browser
+    attributes:
+      label: Browser
+      description: "If you are using the web version, please specify the browser you are using."
+      placeholder: "example: Chrome, Safari"
+    validations:
+      required: false
+
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: "The version of the Zoo Modeling App you're using."
+      placeholder: "example: v0.15.0. You can find this in the settings."
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: Additional Context
+      description: Add any other context about the problem here.
+      placeholder: "Anything else you want to add..."
+    validations:
+      required: false

.github/dependabot.yml

@@ -9,15 +9,27 @@ updates:
       directory: '/' # Location of package manifests
       schedule:
           interval: 'daily'
+      reviewers:
+          - franknoirot 
+          - irev-dev
     - package-ecosystem: 'github-actions' # See documentation for possible values
       directory: '/' # Location of package manifests
       schedule:
           interval: 'daily'
+      reviewers:
+          - adamchalmers
+          - jessfraz
     - package-ecosystem: 'cargo' # See documentation for possible values
       directory: '/src/wasm-lib/' # Location of package manifests
       schedule:
           interval: 'daily'
+      reviewers:
+          - adamchalmers
+          - jessfraz
     - package-ecosystem: 'cargo' # See documentation for possible values
       directory: '/src-tauri/' # Location of package manifests
       schedule:
           interval: 'daily'
+      reviewers:
+          - adamchalmers
+          - jessfraz

.github/workflows/build-and-store-wasm.yml

@@ -0,0 +1,33 @@
+name: Build and Store WASM
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build-and-upload:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'yarn'
+      - name: Install dependencies
+        run: yarn
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+      - name: Cache wasm
+        uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: './src/wasm-lib'
+      - name: build wasm
+        run: yarn build:wasm
+
+
+      # Upload the WASM bundle as an artifact
+      - uses: actions/upload-artifact@v3
+        with:
+          name: wasm-bundle
+          path: src/wasm-lib/pkg

.github/workflows/cargo-bench.yml

@@ -7,23 +7,23 @@ on:
       - '**/Cargo.toml'
       - '**/Cargo.lock'
       - '**/rust-toolchain.toml'
-      - .github/workflows/cargo-criterion.yml
+      - .github/workflows/cargo-bench.yml
   pull_request:
     paths:
       - '**.rs'
       - '**/Cargo.toml'
       - '**/Cargo.lock'
       - '**/rust-toolchain.toml'
-      - .github/workflows/cargo-criterion.yml
+      - .github/workflows/cargo-bench.yml
   workflow_dispatch:
 permissions: read-all
 concurrency:
   group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
   cancel-in-progress: true
-name: cargo criterion
+name: cargo bench
 jobs:
-  cargocriterion:
+  cargo-bench:
-    name: cargo criterion
+    name: Benchmark with iai
     runs-on: ubuntu-latest-8-cores
     steps:
       - uses: actions/checkout@v4
@@ -31,10 +31,12 @@ jobs:
       - name: Install dependencies
         run: |
           cargo install cargo-criterion
+          sudo apt update
+          sudo apt install -y valgrind
       - name: Rust Cache
         uses: Swatinem/rust-cache@v2.6.1
       - name: Benchmark kcl library
         shell: bash
         run: |-
-          cd src/wasm-lib/kcl; cargo criterion
+          cd src/wasm-lib/kcl; cargo bench -- iai
 

.github/workflows/cargo-clippy.yml

@@ -9,12 +9,6 @@ on:
       - '**.rs'
       - .github/workflows/cargo-clippy.yml
   pull_request:
-    paths:
-      - '**/Cargo.toml'
-      - '**/Cargo.lock'
-      - '**/rust-toolchain.toml'
-      - '**.rs'
-      - .github/workflows/cargo-build.yml
 concurrency:
   group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
   cancel-in-progress: true
@@ -25,7 +19,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        dir: ['src/wasm-lib']
+        dir: ['src/wasm-lib', 'src-tauri']
     steps:
       - uses: actions/checkout@v4
       - name: Install latest rust
@@ -37,23 +31,25 @@ jobs:
 
       - name: install dependencies
         if: matrix.dir ==  'src-tauri'
+        shell: bash
         run: |
           sudo apt-get update
-          sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev libappindicator3-dev librsvg2-dev patchelf
+          sudo apt-get install -y \
+            libgtk-3-dev \
+            libayatana-appindicator3-dev \
+            webkit2gtk-driver \
+            libsoup-3.0-dev \
+            libjavascriptcoregtk-4.1-dev \
+            libwebkit2gtk-4.1-dev \
+            at-spi2-core \
+            xvfb
+          yarn install
+          yarn build:wasm
+          yarn build:local
+
       - name: Rust Cache
         uses: Swatinem/rust-cache@v2.6.1
 
-      - name: Install ffmpeg
-        run: |
-          sudo apt update
-          sudo apt install \
-            ffmpeg \
-            libavformat-dev \
-            libavutil-dev \
-            libclang-dev \
-            libswscale-dev \
-            --no-install-recommends
-
       - name: Run clippy
         run: |
           cd "${{ matrix.dir }}"

.github/workflows/cargo-test-tauri.yml

@@ -3,48 +3,55 @@ on:
     branches:
       - main
     paths:
-      - '**.rs'
+      - 'src-tauri/**.rs'
       - '**/Cargo.toml'
       - '**/Cargo.lock'
       - '**/rust-toolchain.toml'
-      - .github/workflows/cargo-build.yml
+      - .github/workflows/cargo-test-tauri.yml
   pull_request:
     paths:
-      - '**.rs'
+      - 'src-tauri/**.rs'
       - '**/Cargo.toml'
       - '**/Cargo.lock'
       - '**/rust-toolchain.toml'
-      - .github/workflows/cargo-build.yml
+      - .github/workflows/cargo-test-tauri.yml
+  workflow_dispatch:
+permissions: read-all
 concurrency:
   group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
   cancel-in-progress: true
-name: cargo build
+name: cargo test of tauri
 jobs:
-  cargobuild:
+  cargotest:
-    name: cargo build
+    name: cargo test
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest-8-cores
     strategy:
       matrix:
-        dir: ['src/wasm-lib']
+        dir: ['src-tauri']
     steps:
       - uses: actions/checkout@v4
-
       - name: Install latest rust
         uses: actions-rs/toolchain@v1
         with:
           toolchain: stable
           override: true
-
       - name: install dependencies
         if: matrix.dir ==  'src-tauri'
         run: |
           sudo apt-get update
-          sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev libappindicator3-dev librsvg2-dev patchelf
+          sudo apt-get install -y \
+            libgtk-3-dev \
+            libayatana-appindicator3-dev \
+            webkit2gtk-driver \
+            libsoup-3.0-dev \
+            libjavascriptcoregtk-4.1-dev \
+            libwebkit2gtk-4.1-dev \
+            at-spi2-core \
+            xvfb
       - name: Rust Cache
         uses: Swatinem/rust-cache@v2.6.1
-
+      - name: cargo test
-      - name: Run cargo build
-        run: |
-          cd "${{ matrix.dir }}"
-          cargo build --all
         shell: bash
+        run: |-
+          cd "${{ matrix.dir }}"
+          cargo test --all

.github/workflows/cargo-test.yml

@@ -3,14 +3,15 @@ on:
     branches:
       - main
     paths:
-      - '**.rs'
+      - 'src/wasm-lib/**.rs'
       - '**/Cargo.toml'
       - '**/Cargo.lock'
       - '**/rust-toolchain.toml'
       - .github/workflows/cargo-test.yml
+
   pull_request:
     paths:
-      - '**.rs'
+      - 'src/wasm-lib/**.rs'
       - '**/Cargo.toml'
       - '**/Cargo.lock'
       - '**/rust-toolchain.toml'
@@ -20,7 +21,7 @@ permissions: read-all
 concurrency:
   group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
   cancel-in-progress: true
-name: cargo test
+name: cargo test of wasm-lib
 jobs:
   cargotest:
     name: cargo test
@@ -40,26 +41,38 @@ jobs:
         run: |
           sudo apt-get update
           sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev libappindicator3-dev librsvg2-dev patchelf
+      - name: Install vector
+        run: |
+          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: taiki-e/install-action@cargo-llvm-cov
       - uses: taiki-e/install-action@nextest
       - name: Rust Cache
         uses: Swatinem/rust-cache@v2.6.1
-      - name: Install ffmpeg
-        run: |
-          sudo apt update
-          sudo apt install \
-            ffmpeg \
-            libavformat-dev \
-            libavutil-dev \
-            libclang-dev \
-            libswscale-dev \
-            --no-install-recommends
       - name: cargo test
         shell: bash
         run: |-
           cd "${{ matrix.dir }}"
-          cargo nextest run --workspace --no-fail-fast -P ci
+          cargo llvm-cov nextest --all --lcov --output-path lcov.info --test-threads=1 --no-fail-fast -P ci 2>&1 | tee /tmp/github-actions.log
         env:
           KITTYCAD_API_TOKEN: ${{secrets.KITTYCAD_API_TOKEN}}
           RUST_MIN_STACK: 10485760000
+      - name: Upload to codecov.io
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{secrets.CODECOV_TOKEN}}
+          fail_ci_if_error: true
+          flags: wasm-lib
+          verbose: true
+          files: lcov.info
 

.github/workflows/check-exampleKcl.yml

@@ -0,0 +1,36 @@
+name: Check Onboarding KCL
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    paths:
+      - 'src/lib/exampleKcl.ts'
+
+permissions:
+  contents: read
+  issues: write
+  pull-requests: write
+
+jobs:
+  comment:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Comment on PR
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const message = '`src/lib/exampleKcl.ts` has been updated in this PR, please review and update the `src/routes/onboarding`, if needed.';
+            const issue_number = context.payload.pull_request.number;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+
+            // Post a comment on the PR
+            await github.rest.issues.createComment({
+              owner,
+              repo,
+              issue_number,
+              body: message,
+            });

.github/workflows/ci.yml

@@ -46,6 +46,7 @@ jobs:
           workspaces: './src/wasm-lib'
 
       - run: yarn build:wasm
+      - run: yarn xstate:typegen
       - run: yarn tsc
 
 
@@ -55,7 +56,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
       - name: Install codespell
         run: |
             python -m pip install codespell
@@ -85,8 +86,6 @@ jobs:
 
       - run: yarn test:nowatch
 
-      - run: yarn test:cov
-
 
   prepare-json-files:
     runs-on: ubuntu-latest  # seperate job on Ubuntu for easy string manipulations (compared to Windows)
@@ -104,8 +103,12 @@ jobs:
         if: github.event_name == 'schedule'
         run: |
           VERSION=$(date +'%-y.%-m.%-d') yarn bump-jsons
-          echo "$(jq --arg url 'https://dl.kittycad.io/releases/modeling-app/nightly/last_update.json' \
+          echo "$(jq --arg url 'https://dl.zoo.dev/releases/modeling-app/nightly/last_update.json' \
-            '.tauri.updater.endpoints[]=$url' src-tauri/tauri.release.conf.json --indent 2)" > src-tauri/tauri.release.conf.json
+            '.plugins.updater.endpoints[]=$url' src-tauri/tauri.release.conf.json --indent 2)" > src-tauri/tauri.release.conf.json
+          echo "$(jq --arg id 'dev.zoo.modeling-app-nightly' \
+            '.identifier=$id' src-tauri/tauri.release.conf.json --indent 2)" > src-tauri/tauri.release.conf.json
+          echo "$(jq --arg name 'Zoo Modeling App (Nightly)' \
+            '.productName=$name' src-tauri/tauri.release.conf.json --indent 2)" > src-tauri/tauri.release.conf.json
 
       - uses: actions/upload-artifact@v3
         if: github.event_name == 'schedule'
@@ -123,8 +126,12 @@ jobs:
     needs: [prepare-json-files]
     runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
-        os: [macos-latest, ubuntu-latest, windows-latest]
+        os: [macos-14, ubuntu-latest, windows-latest]
+    env:
+      TAURI_ARGS_MACOS: ${{ matrix.os == 'macos-14' && '--target universal-apple-darwin' || '' }}
+      TAURI_ARGS_UBUNTU: ${{ matrix.os == 'ubuntu-latest' && '--bundles' || '' }}
     steps:
       - uses: actions/checkout@v4
 
@@ -140,14 +147,16 @@ jobs:
 
       - name: Install ubuntu system dependencies
         if: matrix.os == 'ubuntu-latest'
-        run: >
+        run: |
-          sudo apt-get update &&
+          sudo apt-get update
-          sudo apt-get install -y
+          sudo apt-get install -y \
-          libgtk-3-dev
+            libgtk-3-dev \
-          libgtksourceview-3.0-dev
+            libayatana-appindicator3-dev \
-          webkit2gtk-4.0
+            webkit2gtk-driver \
-          libappindicator3-dev
+            libsoup-3.0-dev \
-          webkit2gtk-driver
+            libjavascriptcoregtk-4.1-dev \
+            libwebkit2gtk-4.1-dev \
+            at-spi2-core \
             xvfb
 
       - name: Sync node version and setup cache
@@ -161,7 +170,9 @@ jobs:
       - name: Setup Rust
         uses: dtolnay/rust-toolchain@stable
 
+      # TODO: re-enable for Windows builds, see https://github.com/tauri-apps/tauri/issues/9045
       - name: Setup Rust cache
+        if: matrix.os != 'windows-latest'
         uses: swatinem/rust-cache@v2
         with:
           workspaces: './src-tauri -> target'
@@ -181,13 +192,16 @@ jobs:
           cd ../../
           cp src/wasm-lib/pkg/wasm_lib_bg.wasm public
 
+      - name: Run vite build (build:both)
+        run: yarn vite build --mode ${{ env.BUILD_RELEASE == 'true' && 'production' || 'development' }}
+
       - name: Fix format
         run: yarn fmt
 
-      - name: Install Universal target (MacOS only)
+      - name: Install x86 target for Universal builds (MacOS only)
-        if: matrix.os == 'macos-latest'
+        if: matrix.os == 'macos-14'
         run: |
-          rustup target add aarch64-apple-darwin
+          rustup target add x86_64-apple-darwin
 
       - name: Prepare certificate and variables (Windows only)
         if: ${{ matrix.os == 'windows-latest' && env.BUILD_RELEASE == 'true' }}
@@ -221,14 +235,14 @@ jobs:
         with:
           includeRelease: false
           includeDebug: true
-          args: ${{ matrix.os == 'macos-latest' && '--target universal-apple-darwin' || '' }}
+          args: "${{ env.TAURI_ARGS_MACOS }} ${{ env.TAURI_ARGS_UBUNTU }}"
 
       - name: Build the app (release) and sign
         uses: tauri-apps/tauri-action@v0
         if: ${{ env.BUILD_RELEASE == 'true' }}
         env:
-          TAURI_PRIVATE_KEY: ${{ secrets.TAURI_PRIVATE_KEY }}
+          TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
-          TAURI_KEY_PASSWORD: ${{ secrets.TAURI_KEY_PASSWORD }}
+          TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
           APPLE_CERTIFICATE: ${{ secrets.APPLE_CERTIFICATE }}
           APPLE_CERTIFICATE_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
           APPLE_SIGNING_IDENTITY: ${{ secrets.APPLE_SIGNING_IDENTITY }}
@@ -237,23 +251,27 @@ jobs:
           APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
           TAURI_CONF_ARGS: "--config ${{ matrix.os == 'windows-latest' && 'src-tauri\\tauri.release.conf.json' || 'src-tauri/tauri.release.conf.json' }}"
         with:
-          args: "${{ matrix.os == 'macos-latest' && '--target universal-apple-darwin' || '' }} ${{ env.TAURI_CONF_ARGS }}"
+          args: "${{ env.TAURI_CONF_ARGS }} ${{ env.TAURI_ARGS_MACOS }} ${{ env.TAURI_ARGS_UBUNTU }}"
 
       - uses: actions/upload-artifact@v3
+        if: matrix.os != 'ubuntu-latest'
         env:
-          PREFIX: ${{ matrix.os == 'macos-latest' && 'src-tauri/target/universal-apple-darwin' || 'src-tauri/target' }}
+          PREFIX: ${{ matrix.os == 'macos-14' && 'src-tauri/target/universal-apple-darwin' || 'src-tauri/target' }}
           MODE: ${{ env.BUILD_RELEASE == 'true' && 'release' || 'debug' }}
         with:
           path: "${{ env.PREFIX }}/${{ env.MODE }}/bundle/*/*"
 
+      # TODO: re-enable linux e2e tests when possible
       - name: Run e2e tests (linux only)
-        if: matrix.os == 'ubuntu-latest'
+        if: false
         run: |
           cargo install tauri-driver
+          source .env.${{ env.BUILD_RELEASE == 'true' && 'production' || 'development' }}
+          export VITE_KC_API_BASE_URL
           xvfb-run yarn test:e2e:tauri
         env:
-          E2E_APPLICATION: "./src-tauri/target/${{ env.BUILD_RELEASE == 'true' && 'release' || 'debug' }}/kittycad-modeling"
+          E2E_APPLICATION: "./src-tauri/target/${{ env.BUILD_RELEASE == 'true' && 'release' || 'debug' }}/zoo-modeling-app"
-          KITTYCAD_API_TOKEN: ${{ secrets.KITTYCAD_API_TOKEN }}
+          KITTYCAD_API_TOKEN: ${{ env.BUILD_RELEASE == 'true' && secrets.KITTYCAD_API_TOKEN || secrets.KITTYCAD_API_TOKEN_DEV }}
 
 
   publish-apps-release:
@@ -266,26 +284,25 @@ jobs:
       PUB_DATE: ${{ github.event_name == 'release' && github.event.release.created_at || github.event.repository.updated_at }}
       NOTES: ${{ github.event_name == 'release' && github.event.release.body || format('Nightly build, commit {0}', github.sha) }}
       BUCKET_DIR: ${{ github.event_name == 'release' && 'dl.kittycad.io/releases/modeling-app' || 'dl.kittycad.io/releases/modeling-app/nightly' }}
+      WEBSITE_DIR: ${{ github.event_name == 'release' && 'dl.zoo.dev/releases/modeling-app' || 'dl.zoo.dev/releases/modeling-app/nightly' }}
+      URL_CODED_NAME: ${{ github.event_name == 'schedule' && 'Zoo%20Modeling%20App%20%28Nightly%29' || 'Zoo%20Modeling%20App' }}
     steps:
       - uses: actions/download-artifact@v3
 
       - name: Generate the update static endpoint
         run: |
-          ls -l artifact/*/*itty*
+          ls -l artifact/*/*oo*
           DARWIN_SIG=`cat artifact/macos/*.app.tar.gz.sig`
-          LINUX_SIG=`cat artifact/appimage/*.AppImage.tar.gz.sig`
           WINDOWS_SIG=`cat artifact/msi/*.msi.zip.sig`
-          RELEASE_DIR=https://${BUCKET_DIR}/${VERSION}
+          RELEASE_DIR=https://${WEBSITE_DIR}/${VERSION}
           jq --null-input \
             --arg version "${VERSION}" \
             --arg pub_date "${PUB_DATE}" \
             --arg notes "${NOTES}" \
             --arg darwin_sig "$DARWIN_SIG" \
-            --arg darwin_url "$RELEASE_DIR/macos/KittyCAD%20Modeling.app.tar.gz" \
+            --arg darwin_url "$RELEASE_DIR/macos/${{ env.URL_CODED_NAME }}.app.tar.gz" \
-            --arg linux_sig "$LINUX_SIG" \
-            --arg linux_url "$RELEASE_DIR/appimage/kittycad-modeling_${VERSION_NO_V}_amd64.AppImage.tar.gz" \
             --arg windows_sig "$WINDOWS_SIG" \
-            --arg windows_url "$RELEASE_DIR/msi/KittyCAD%20Modeling_${VERSION_NO_V}_x64_en-US.msi.zip" \
+            --arg windows_url "$RELEASE_DIR/msi/${{ env.URL_CODED_NAME }}_${VERSION_NO_V}_x64_en-US.msi.zip" \
             '{
               "version": $version,
               "pub_date": $pub_date,
@@ -299,10 +316,6 @@ jobs:
                   "signature": $darwin_sig,
                   "url": $darwin_url
                 },
-                "linux-x86_64": {
-                  "signature": $linux_sig,
-                  "url": $linux_url
-                },
                 "windows-x86_64": {
                   "signature": $windows_sig,
                   "url": $windows_url
@@ -313,14 +326,13 @@ jobs:
 
       - name: Generate the download static endpoint
         run: |
-          RELEASE_DIR=https://${BUCKET_DIR}/${VERSION}
+          RELEASE_DIR=https://${WEBSITE_DIR}/${VERSION}
           jq --null-input \
             --arg version "${VERSION}" \
             --arg pub_date "${PUB_DATE}" \
             --arg notes "${NOTES}" \
-            --arg darwin_url "$RELEASE_DIR/dmg/KittyCAD%20Modeling_${VERSION_NO_V}_universal.dmg" \
+            --arg darwin_url "$RELEASE_DIR/dmg/${{ env.URL_CODED_NAME }}_${VERSION_NO_V}_universal.dmg" \
-            --arg linux_url "$RELEASE_DIR/appimage/kittycad-modeling_${VERSION_NO_V}_amd64.AppImage" \
+            --arg windows_url "$RELEASE_DIR/msi/${{ env.URL_CODED_NAME }}_${VERSION_NO_V}_x64_en-US.msi" \
-            --arg windows_url "$RELEASE_DIR/msi/KittyCAD%20Modeling_${VERSION_NO_V}_x64_en-US.msi" \
             '{
               "version": $version,
               "pub_date": $pub_date,
@@ -329,9 +341,6 @@ jobs:
                 "dmg-universal": {
                   "url": $darwin_url
                 },
-                "appimage-x86_64": {
-                  "url": $linux_url
-                },
                 "msi-x86_64": {
                   "url": $windows_url
                 }
@@ -340,37 +349,62 @@ jobs:
             cat last_download.json
 
       - name: Authenticate to Google Cloud
-        uses: 'google-github-actions/auth@v2.0.0'
+        uses: 'google-github-actions/auth@v2.1.2'
         with:
           credentials_json: '${{ secrets.GOOGLE_CLOUD_DL_SA }}'
 
       - name: Set up Google Cloud SDK
-        uses: google-github-actions/setup-gcloud@v1.1.1
+        uses: google-github-actions/setup-gcloud@v2.1.0
         with:
           project_id: kittycadapi
 
       - name: Upload release files to public bucket
-        uses: google-github-actions/upload-cloud-storage@v1.0.3
+        uses: google-github-actions/upload-cloud-storage@v2.1.0
         with:
           path: artifact
-          glob: '*/*itty*'
+          glob: '*/Zoo*'
           parent: false
           destination: ${{ env.BUCKET_DIR }}/${{ env.VERSION }}
 
       - name: Upload update endpoint to public bucket
-        uses: google-github-actions/upload-cloud-storage@v1.0.3
+        uses: google-github-actions/upload-cloud-storage@v2.1.0
         with:
           path: last_update.json
           destination: ${{ env.BUCKET_DIR }}
 
       - name: Upload download endpoint to public bucket
-        uses: google-github-actions/upload-cloud-storage@v1.0.3
+        uses: google-github-actions/upload-cloud-storage@v2.1.0
         with:
           path: last_download.json
           destination: ${{ env.BUCKET_DIR }}
 
       - name: Upload release files to Github
         if: ${{ github.event_name == 'release' }}
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         with:
-          files: artifact/*/*itty*
+          files: 'artifact/*/Zoo*'
+
+  announce_release:
+    needs: [publish-apps-release]
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release'
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install requests
+
+      - name: Announce Release
+        env:
+          DISCORD_WEBHOOK_URL: ${{ secrets.DISCORD_WEBHOOK_URL }}
+          RELEASE_VERSION: ${{ github.event.release.tag_name }}
+          RELEASE_BODY: ${{ github.event.release.body}}
+        run: python public/announce_release.py

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

@@ -0,0 +1,65 @@
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - .github/workflows/generate-website-docs.yml
+      - 'docs/**'
+  pull_request:
+    paths:
+      - .github/workflows/generate-website-docs.yml
+  workflow_dispatch:
+name: generate-website-docs
+concurrency:
+  group: docs-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  generate-website-docs:
+    name: generate-website-docs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/create-github-app-token@v1
+        id: app-token
+        with:
+          # required
+          app-id: ${{ secrets.GH_ORG_APP_ID }}
+          private-key: ${{ secrets.GH_ORG_APP_PRIVATE_KEY }}
+          owner: ${{ github.repository_owner }}
+      # Checkout the docs repo since we will want to update the files there.
+      - uses: actions/checkout@v4
+        with:
+          repository: 'kittycad/documentation'
+          path: 'documentation'
+          token: ${{ steps.app-token.outputs.token }}
+      - name: move docs to docs
+        shell: bash
+        run: |
+          mkdir -p documentation/content/pages/docs/kcl/
+          # cleanup old
+          rm -rf documentation/content/pages/docs/kcl/*.md
+          # move new
+          mv -f docs/kcl/*.md documentation/content/pages/docs/kcl/
+      - name: commit the changes in the docs repo
+        shell: bash
+        run: |
+          cd documentation
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          git add .
+          git commit -am "YOYO NEW KCL DOCS!!" || exit 0
+          git fetch origin
+          git rebase origin/main || exit 0
+          export NEW_BRANCH="update-kcl-docs"
+          git checkout -b "$NEW_BRANCH"
+          git push -f origin "$NEW_BRANCH"
+          gh pr create --title "Update KCL docs" \
+              --body "Updating the generated kcl docs cc @jessfraz @franknoirot merge this" \
+              --head "$NEW_BRANCH" \
+              --reviewer jessfraz \
+              --reviewer irev-dev \
+              --reviewer franknoirot \
+              --base main || true
+        env:
+          GITHUB_TOKEN: ${{ steps.app-token.outputs.token }}
+

.github/workflows/playwright.yml

@@ -4,27 +4,82 @@ on:
     branches: [ main ]
   pull_request:
     branches: [ main ]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+  pull-requests: write
+  actions: read
+  
+
 jobs:
+
+  check-rust-changes:
+    runs-on: ubuntu-latest
+    outputs:
+      rust-changed: ${{ steps.filter.outputs.rust }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - id: filter
+        name: Check for Rust changes
+        uses: dorny/paths-filter@v3
+        with:
+          filters: |
+            rust:
+              - 'src/wasm-lib/**'
+
   playwright-ubuntu:
     timeout-minutes: 60
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest-8-cores
+    needs: check-rust-changes
     steps:
     - uses: actions/checkout@v4
     - uses: actions/setup-node@v4
       with:
         node-version-file: '.nvmrc'
         cache: 'yarn'
+    - uses: KittyCAD/action-install-cli@main
     - name: Install dependencies
       run: yarn
     - name: Install Playwright Browsers
       run: yarn playwright install --with-deps
+    - name: Download Wasm Cache
+      id: download-wasm
+      if: needs.check-rust-changes.outputs.rust-changed == 'false'
+      uses: dawidd6/action-download-artifact@v3
+      continue-on-error: true
+      with:
+        github_token: ${{secrets.GITHUB_TOKEN}}
+        name: wasm-bundle
+        workflow: build-and-store-wasm.yml
+        branch: main
+        path: src/wasm-lib/pkg
+    - name: copy wasm blob
+      if: needs.check-rust-changes.outputs.rust-changed == 'false'
+      run: cp src/wasm-lib/pkg/wasm_lib_bg.wasm public
+      continue-on-error: true
     - name: Setup Rust
       uses: dtolnay/rust-toolchain@stable
-    - name: Cache wasm
+    - name: Cache Wasm (because rust diff)
+      if: needs.check-rust-changes.outputs.rust-changed == 'true'
       uses: Swatinem/rust-cache@v2
       with:
         workspaces: './src/wasm-lib'
-    - name: build wasm
+    - name: OR Cache Wasm (because wasm cache failed)
+      if: steps.download-wasm.outcome == 'failure'
+      uses: Swatinem/rust-cache@v2
+      with:
+        workspaces: './src/wasm-lib'
+    - name: Build Wasm (because rust diff)
+      if: needs.check-rust-changes.outputs.rust-changed == 'true'
+      run: yarn build:wasm
+    - name: OR Build Wasm (because wasm cache failed)
+      if: steps.download-wasm.outcome == 'failure'
       run: yarn build:wasm
     - name: build web
       run: yarn build:local
@@ -33,6 +88,7 @@ jobs:
       env:
         CI: true
         token: ${{ secrets.KITTYCAD_API_TOKEN_DEV }}
+        snapshottoken: ${{ secrets.KITTYCAD_API_TOKEN }}
     - uses: actions/upload-artifact@v3
       if: always()
       with:
@@ -77,8 +133,8 @@ jobs:
 
   playwright-macos:
     timeout-minutes: 60
-    runs-on: macos-latest
+    runs-on: macos-14
-    needs: playwright-ubuntu
+    needs: check-rust-changes
     steps:
     - uses: actions/checkout@v4
     - uses: actions/setup-node@v4
@@ -89,13 +145,38 @@ jobs:
       run: yarn
     - name: Install Playwright Browsers
       run: yarn playwright install --with-deps
+    - name: Download Wasm Cache
+      id: download-wasm
+      if: needs.check-rust-changes.outputs.rust-changed == 'false'
+      uses: dawidd6/action-download-artifact@v3
+      continue-on-error: true
+      with:
+        github_token: ${{secrets.GITHUB_TOKEN}}
+        name: wasm-bundle
+        workflow: build-and-store-wasm.yml
+        branch: main
+        path: src/wasm-lib/pkg
+    - name: copy wasm blob
+      if: needs.check-rust-changes.outputs.rust-changed == 'false'
+      run: cp src/wasm-lib/pkg/wasm_lib_bg.wasm public
+      continue-on-error: true
     - name: Setup Rust
       uses: dtolnay/rust-toolchain@stable
-    - name: Cache wasm
+    - name: Cache Wasm (because rust diff)
+      if: needs.check-rust-changes.outputs.rust-changed == 'true'
       uses: Swatinem/rust-cache@v2
       with:
         workspaces: './src/wasm-lib'
-    - name: build wasm
+    - name: OR Cache Wasm (because wasm cache failed)
+      if: steps.download-wasm.outcome == 'failure'
+      uses: Swatinem/rust-cache@v2
+      with:
+        workspaces: './src/wasm-lib'
+    - name: Build Wasm (because rust diff)
+      if: needs.check-rust-changes.outputs.rust-changed == 'true'
+      run: yarn build:wasm
+    - name: OR Build Wasm (because wasm cache failed)
+      if: steps.download-wasm.outcome == 'failure'
       run: yarn build:wasm
     - name: build web
       run: yarn build:local

.github/workflows/vector.toml

@@ -0,0 +1,21 @@
+[sources.github-actions-file]
+type = "file"
+data_dir = "/tmp/vector"
+include = ["/tmp/github-actions.log"]
+
+# Modify the logs to include the action name.
+[transforms.add-action-name]
+type = "remap"
+inputs = [ "github-actions-file" ]
+source = '''
+.action = "GITHUB_WORKFLOW"
+.repo = "GITHUB_REPOSITORY"
+.sha = "GITHUB_SHA"
+.ref = "GITHUB_REF_NAME"
+'''
+
+[sinks.axiom]
+type = "axiom"
+inputs = ["add-action-name"]
+token = "GH_ACTIONS_AXIOM_TOKEN"
+dataset = "github-actions"

.gitignore

@@ -33,11 +33,24 @@ src/wasm-lib/bindings
 src/wasm-lib/kcl/bindings
 public/wasm_lib_bg.wasm
 src/wasm-lib/lcov.info
+src/wasm-lib/grackle/test_json_output
 
 e2e/playwright/playwright-secrets.env
 e2e/playwright/temp1.png
 e2e/playwright/temp2.png
+# exports from snapshot-tests.spec.ts "exports of each format should work"
+e2e/playwright/export-snapshots/*
+!e2e/playwright/export-snapshots/*.png
+
+
 /test-results/
 /playwright-report/
 /blob-report/
 /playwright/.cache/
+
+
+## generated files
+src/**/*.typegen.ts
+src-tauri/gen
+
+src/wasm-lib/grackle/stdlib_cube_partial.json

.nvmrc

@@ -1 +1 @@
-v20.5.0
+v21.7.1

.prettierignore

@@ -10,4 +10,4 @@ src/wasm-lib/kcl/bindings
 e2e/playwright/export-snapshots
 
 # XState generated files
-src/machines/modelingMachine.typegen.ts
+src/machines/**.typegen.ts

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2023 The KittyCAD Authors
+Copyright (c) 2023 The Zoo Authors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,17 +1,17 @@
-![KittyCAD Modeling App](/public/kcma-logomark.png)
+![Zoo Modeling App](/public/zma-logomark-outlined.png)
 
-## KittyCAD Modeling App
+## Zoo Modeling App
 
-live at [app.kittycad.io](https://app.kittycad.io/)
+live at [app.zoo.dev](https://app.zoo.dev/)
 
-A CAD application from the future, brought to you by the [KittyCAD team](https://kittycad.io).
+A CAD application from the future, brought to you by the [Zoo team](https://zoo.dev).
 
-The KittyCAD modeling app is our take on what a modern modelling experience can be. It is applying several lessons learned in the decades since most major CAD tools came into existence:
+Modeling App is our take on what a modern modelling experience can be. It is applying several lessons learned in the decades since most major CAD tools came into existence:
 
 - All artifacts—including parts and assemblies—should be represented as human-readable code. At the end of the day, your CAD project should be "plain text"
   - This makes version control—which is a solved problem in software engineering—trivial for CAD
 - All GUI (or point-and-click) interactions should be actions performed on this code representation under the hood
-  - This unlocks a hybrid approach to modeling. Whether you point-and-click as you always have or you write your own KCL code, you are performing the same action in KittyCAD Modeling App
+  - This unlocks a hybrid approach to modeling. Whether you point-and-click as you always have or you write your own KCL code, you are performing the same action in Modeling App
 - Everything graphics _has_ to be built for the GPU
   - Most CAD applications have had to retrofit support for GPUs, but our geometry engine is made for GPUs (primarily Nvidia's Vulkan), getting the order of magnitude rendering performance boost with it
 - Make the resource-intensive pieces of an application auto-scaling
@@ -19,9 +19,9 @@ The KittyCAD modeling app is our take on what a modern modelling experience can
 
 We are excited about what a small team of people could build in a short time with our API. We welcome you to try our API, build your own applications, or contribute to ours!
 
-KittyCAD Modeling App is a _hybrid_ user interface for CAD modeling. You can point-and-click to design parts (and soon assemblies), but everything you make is really just [`kcl` code](https://github.com/KittyCAD/kcl-experiments) under the hood. All of your CAD models can be checked into source control such as GitHub and responsibly versioned, rolled back, and more.
+Modeling App is a _hybrid_ user interface for CAD modeling. You can point-and-click to design parts (and soon assemblies), but everything you make is really just [`kcl` code](https://github.com/KittyCAD/kcl-experiments) under the hood. All of your CAD models can be checked into source control such as GitHub and responsibly versioned, rolled back, and more.
 
-The 3D view in KittyCAD Modeling App is just a video stream from our hosted geometry engine. The app sends new modeling commands to the engine via WebSockets, which returns back video frames of the view within the engine.
+The 3D view in Modeling App is just a video stream from our hosted geometry engine. The app sends new modeling commands to the engine via WebSockets, which returns back video frames of the view within the engine.
 
 ## Tools
 
@@ -59,6 +59,10 @@ followed by:
 ```
 yarn build:wasm-dev
 ```
+or if you have the gh cli installed
+```
+./get-latest-wasm-bundle.sh # this will download the latest main wasm bundle
+```
 
 That will build the WASM binary and put in the `public` dir (though gitignored)
 
@@ -94,7 +98,6 @@ For running the rust (not tauri rust though) only, you can
 cd src/wasm-lib
 cargo test
 ```
-but you will need to have install ffmpeg prior to.
 
 ## Tauri
 
@@ -137,7 +140,12 @@ Before you submit a contribution PR to this repo, please ensure that:
 VERSION=x.y.z yarn run bump-jsons
 ```
 
-The PR may serve as a place to discuss the human-readable changelog and extra QA. A quick way of getting PR's merged since the last bump is to [use this PR filter](https://github.com/KittyCAD/modeling-app/pulls?q=is%3Apr+sort%3Aupdated-desc+is%3Amerged+), open up the browser console and past in the following
+Alternatively you can try the experimental `make-release.sh` bash script that will create the branch with the updated json files for you.
+run `./make-release.sh` for a patch update
+run `./make-release.sh "minor"` for minor
+run `./make-release.sh "major"` for major
+
+The PR may serve as a place to discuss the human-readable changelog and extra QA. A quick way of getting PR's merged since the last bump is to [use this PR filter](https://github.com/KittyCAD/modeling-app/pulls?q=is%3Apr+sort%3Aupdated-desc+is%3Amerged+), open up the browser console and paste in the following
 
 ```typescript
 console.log(
@@ -183,9 +191,9 @@ For more information on fuzzing you can check out
 First time running plawright locally, you'll need to add the secrets file
 ```bash
 touch ./e2e/playwright/playwright-secrets.env
-echo 'token="your-token"' > ./e2e/playwright/playwright-secrets.env
+printf 'token="your-token"\nsnapshottoken="your-snapshot-token"' > ./e2e/playwright/playwright-secrets.env
 ```
-then replace "your-token" with a dev token from dev.kittycad.io/account/api-tokens
+then replace "your-token" with a dev token from dev.zoo.dev/account/api-tokens
 
 then:
 run playwright
@@ -277,7 +285,7 @@ https://github.com/KittyCAD/modeling-app/assets/29681384/6f5e8e85-1003-4fd9-be7f
 <details>
 
 <summary>
-Ps for the debug panel, the following JSON is useful for snapping the camera
+PS: for the debug panel, the following JSON is useful for snapping the camera
 </summary>
 
 ```JSON

babel.config.js

@@ -1,3 +1,3 @@
 module.exports = {
-  presets: ["@babel/preset-env"],
+  presets: ['@babel/preset-env'],
 }

docs/kcl/KNOWN-ISSUES.md

@@ -0,0 +1,20 @@
+---
+title: "KCL Known Issues"
+excerpt: "Known issues with the KCL standard library for the Zoo Modeling App."
+layout: manual
+---
+
+The following are bugs that are not in modeling-app or kcl itself. These bugs
+once fixed in engine will just start working here with no language changes.
+
+- **Sketch on Face**: If your sketch is outside the edges of the face (on which you
+    are sketching) you will get multiple models returned instead of one single
+    model for that sketch and its underlying 3D object.
+    If you see a red line around your model, it means this is happening.
+
+- **Import**: Right now you can import a file, even if that file has brep data
+    you cannot edit it, after v1, the engine will account for this. You also cannot
+    currently move or transform the imported objects at all, once we have assemblies
+    this will work.
+
+- **Fillets**: Fillets cannot intersect, you will get an error. Only simple fillet cases work currently.

docs/kcl/abs.md

@@ -0,0 +1,34 @@
+---
+title: "abs"
+excerpt: "Computes the absolute value of a number."
+layout: manual
+---
+
+Computes the absolute value of a number.
+
+
+
+```js
+abs(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = abs(-4)
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/acos.md

@@ -0,0 +1,34 @@
+---
+title: "acos"
+excerpt: "Computes the arccosine of a number (in radians)."
+layout: manual
+---
+
+Computes the arccosine of a number (in radians).
+
+
+
+```js
+acos(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = acos(0.5)
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/asin.md

@@ -0,0 +1,34 @@
+---
+title: "asin"
+excerpt: "Computes the arcsine of a number (in radians)."
+layout: manual
+---
+
+Computes the arcsine of a number (in radians).
+
+
+
+```js
+asin(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = asin(0.5)
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/atan.md

@@ -0,0 +1,34 @@
+---
+title: "atan"
+excerpt: "Computes the arctangent of a number (in radians)."
+layout: manual
+---
+
+Computes the arctangent of a number (in radians).
+
+
+
+```js
+atan(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = atan(1.0)
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/ceil.md

@@ -0,0 +1,34 @@
+---
+title: "ceil"
+excerpt: "Computes the smallest integer greater than or equal to a number."
+layout: manual
+---
+
+Computes the smallest integer greater than or equal to a number.
+
+
+
+```js
+ceil(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = ceil(4.5)
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/cos.md

@@ -0,0 +1,34 @@
+---
+title: "cos"
+excerpt: "Computes the cosine of a number (in radians)."
+layout: manual
+---
+
+Computes the cosine of a number (in radians).
+
+
+
+```js
+cos(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const anotherVar = cos(2 * pi())
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/e.md

@@ -0,0 +1,33 @@
+---
+title: "e"
+excerpt: "Return the value of Euler’s number `e`."
+layout: manual
+---
+
+Return the value of Euler’s number `e`.
+
+
+
+```js
+e() -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = e()
+```
+
+### Arguments
+
+
+### Returns
+
+`number`
+
+
+

docs/kcl/floor.md

@@ -0,0 +1,34 @@
+---
+title: "floor"
+excerpt: "Computes the largest integer less than or equal to a number."
+layout: manual
+---
+
+Computes the largest integer less than or equal to a number.
+
+
+
+```js
+floor(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = floor(4.5)
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/import.md

@@ -0,0 +1,136 @@
+---
+title: "import"
+excerpt: "Import a CAD file."
+layout: manual
+---
+
+Import a CAD file.
+
+For formats lacking unit data (STL, OBJ, PLY), the default import unit is millimeters. Otherwise you can specify the unit by passing in the options parameter. If you import a gltf file, we will try to find the bin file and import it as well.
+Import paths are relative to the current project directory. This only works in the desktop app not in browser.
+
+```js
+import(file_path: String, options?: ImportFormat) -> ImportedGeometry
+```
+
+### Examples
+
+```js
+const model = import("thing.obj")
+```
+
+```js
+const model = import("cube.obj", { type: "obj", units: "m" })
+```
+
+```js
+const model = import("my_model.gltf")
+```
+
+```js
+const model = import("my_model.sldprt")
+```
+
+```js
+const model = import("my_model.step")
+```
+
+### Arguments
+
+* `file_path`: `String` (REQUIRED)
+* `options`: `ImportFormat` - Import format specifier (OPTIONAL)
+```js
+{
+	type: "fbx",
+} |
+{
+	type: "gltf",
+} |
+{
+	// Co-ordinate system of input data. Defaults to the [KittyCAD co-ordinate system.
+	coords: {
+	// Axis the front face of a model looks along.
+	forward: {
+	// Axis specifier.
+	axis: "y" | "z",
+	// Specifies which direction the axis is pointing.
+	direction: "positive" | "negative",
+},
+	// Axis pointing up and away from a model.
+	up: {
+	// Axis specifier.
+	axis: "y" | "z",
+	// Specifies which direction the axis is pointing.
+	direction: "positive" | "negative",
+},
+},
+	type: "obj",
+	// The units of the input data. This is very important for correct scaling and when calculating physics properties like mass, etc. Defaults to millimeters.
+	units: "cm" | "ft" | "in" | "m" | "mm" | "yd",
+} |
+{
+	// Co-ordinate system of input data. Defaults to the [KittyCAD co-ordinate system.
+	coords: {
+	// Axis the front face of a model looks along.
+	forward: {
+	// Axis specifier.
+	axis: "y" | "z",
+	// Specifies which direction the axis is pointing.
+	direction: "positive" | "negative",
+},
+	// Axis pointing up and away from a model.
+	up: {
+	// Axis specifier.
+	axis: "y" | "z",
+	// Specifies which direction the axis is pointing.
+	direction: "positive" | "negative",
+},
+},
+	type: "ply",
+	// The units of the input data. This is very important for correct scaling and when calculating physics properties like mass, etc. Defaults to millimeters.
+	units: "cm" | "ft" | "in" | "m" | "mm" | "yd",
+} |
+{
+	type: "sldprt",
+} |
+{
+	type: "step",
+} |
+{
+	// Co-ordinate system of input data. Defaults to the [KittyCAD co-ordinate system.
+	coords: {
+	// Axis the front face of a model looks along.
+	forward: {
+	// Axis specifier.
+	axis: "y" | "z",
+	// Specifies which direction the axis is pointing.
+	direction: "positive" | "negative",
+},
+	// Axis pointing up and away from a model.
+	up: {
+	// Axis specifier.
+	axis: "y" | "z",
+	// Specifies which direction the axis is pointing.
+	direction: "positive" | "negative",
+},
+},
+	type: "stl",
+	// The units of the input data. This is very important for correct scaling and when calculating physics properties like mass, etc. Defaults to millimeters.
+	units: "cm" | "ft" | "in" | "m" | "mm" | "yd",
+}
+```
+
+### Returns
+
+`ImportedGeometry` - Data for an imported geometry.
+```js
+{
+	// The ID of the imported geometry.
+	id: uuid,
+	// The original file paths.
+	value: [string],
+}
+```
+
+
+

docs/kcl/index.md

@@ -0,0 +1,79 @@
+---
+title: "KCL Standard Library"
+excerpt: "Documentation for the KCL standard library for the Zoo Modeling App."
+layout: manual
+---
+
+## Table of Contents
+
+* [Types](kcl/types)
+* [Known Issues](kcl/KNOWN-ISSUES)
+* [`abs`](kcl/abs)
+* [`acos`](kcl/acos)
+* [`angleToMatchLengthX`](kcl/angleToMatchLengthX)
+* [`angleToMatchLengthY`](kcl/angleToMatchLengthY)
+* [`angledLine`](kcl/angledLine)
+* [`angledLineOfXLength`](kcl/angledLineOfXLength)
+* [`angledLineOfYLength`](kcl/angledLineOfYLength)
+* [`angledLineThatIntersects`](kcl/angledLineThatIntersects)
+* [`angledLineToX`](kcl/angledLineToX)
+* [`angledLineToY`](kcl/angledLineToY)
+* [`arc`](kcl/arc)
+* [`asin`](kcl/asin)
+* [`atan`](kcl/atan)
+* [`bezierCurve`](kcl/bezierCurve)
+* [`ceil`](kcl/ceil)
+* [`circle`](kcl/circle)
+* [`close`](kcl/close)
+* [`cos`](kcl/cos)
+* [`e`](kcl/e)
+* [`extrude`](kcl/extrude)
+* [`fillet`](kcl/fillet)
+* [`floor`](kcl/floor)
+* [`getEdge`](kcl/getEdge)
+* [`getExtrudeWallTransform`](kcl/getExtrudeWallTransform)
+* [`getNextAdjacentEdge`](kcl/getNextAdjacentEdge)
+* [`getOppositeEdge`](kcl/getOppositeEdge)
+* [`getPreviousAdjacentEdge`](kcl/getPreviousAdjacentEdge)
+* [`helix`](kcl/helix)
+* [`hole`](kcl/hole)
+* [`import`](kcl/import)
+* [`lastSegX`](kcl/lastSegX)
+* [`lastSegY`](kcl/lastSegY)
+* [`legAngX`](kcl/legAngX)
+* [`legAngY`](kcl/legAngY)
+* [`legLen`](kcl/legLen)
+* [`line`](kcl/line)
+* [`lineTo`](kcl/lineTo)
+* [`ln`](kcl/ln)
+* [`log`](kcl/log)
+* [`log10`](kcl/log10)
+* [`log2`](kcl/log2)
+* [`max`](kcl/max)
+* [`min`](kcl/min)
+* [`patternCircular2d`](kcl/patternCircular2d)
+* [`patternCircular3d`](kcl/patternCircular3d)
+* [`patternLinear2d`](kcl/patternLinear2d)
+* [`patternLinear3d`](kcl/patternLinear3d)
+* [`pi`](kcl/pi)
+* [`pow`](kcl/pow)
+* [`revolve`](kcl/revolve)
+* [`segAng`](kcl/segAng)
+* [`segEndX`](kcl/segEndX)
+* [`segEndY`](kcl/segEndY)
+* [`segLen`](kcl/segLen)
+* [`sin`](kcl/sin)
+* [`sqrt`](kcl/sqrt)
+* [`startProfileAt`](kcl/startProfileAt)
+* [`startSketchAt`](kcl/startSketchAt)
+* [`startSketchOn`](kcl/startSketchOn)
+* [`tan`](kcl/tan)
+* [`tangentialArc`](kcl/tangentialArc)
+* [`tangentialArcTo`](kcl/tangentialArcTo)
+* [`tau`](kcl/tau)
+* [`toDegrees`](kcl/toDegrees)
+* [`toRadians`](kcl/toRadians)
+* [`xLine`](kcl/xLine)
+* [`xLineTo`](kcl/xLineTo)
+* [`yLine`](kcl/yLine)
+* [`yLineTo`](kcl/yLineTo)

docs/kcl/legAngX.md

@@ -0,0 +1,35 @@
+---
+title: "legAngX"
+excerpt: "Returns the angle of the given leg for x."
+layout: manual
+---
+
+Returns the angle of the given leg for x.
+
+
+
+```js
+legAngX(hypotenuse: number, leg: number) -> number
+```
+
+### Tags
+
+* `utilities`
+
+### Examples
+
+```js
+legAngX(5, 3)
+```
+
+### Arguments
+
+* `hypotenuse`: `number` (REQUIRED)
+* `leg`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/legAngY.md

@@ -0,0 +1,35 @@
+---
+title: "legAngY"
+excerpt: "Returns the angle of the given leg for y."
+layout: manual
+---
+
+Returns the angle of the given leg for y.
+
+
+
+```js
+legAngY(hypotenuse: number, leg: number) -> number
+```
+
+### Tags
+
+* `utilities`
+
+### Examples
+
+```js
+legAngY(5, 3)
+```
+
+### Arguments
+
+* `hypotenuse`: `number` (REQUIRED)
+* `leg`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/legLen.md

@@ -0,0 +1,35 @@
+---
+title: "legLen"
+excerpt: "Returns the length of the given leg."
+layout: manual
+---
+
+Returns the length of the given leg.
+
+
+
+```js
+legLen(hypotenuse: number, leg: number) -> number
+```
+
+### Tags
+
+* `utilities`
+
+### Examples
+
+```js
+legLen(5, 3)
+```
+
+### Arguments
+
+* `hypotenuse`: `number` (REQUIRED)
+* `leg`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/ln.md

@@ -0,0 +1,34 @@
+---
+title: "ln"
+excerpt: "Computes the natural logarithm of the number."
+layout: manual
+---
+
+Computes the natural logarithm of the number.
+
+
+
+```js
+ln(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = ln(4)
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/log.md

@@ -0,0 +1,35 @@
+---
+title: "log"
+excerpt: "Computes the logarithm of the number with respect to an arbitrary base."
+layout: manual
+---
+
+Computes the logarithm of the number with respect to an arbitrary base.
+
+The result might not be correctly rounded owing to implementation details; `log2()` can produce more accurate results for base 2, and `log10()` can produce more accurate results for base 10.
+
+```js
+log(num: number, base: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = log(4, 2)
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+* `base`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/log10.md

@@ -0,0 +1,34 @@
+---
+title: "log10"
+excerpt: "Computes the base 10 logarithm of the number."
+layout: manual
+---
+
+Computes the base 10 logarithm of the number.
+
+
+
+```js
+log10(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = log10(4)
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/log2.md

@@ -0,0 +1,34 @@
+---
+title: "log2"
+excerpt: "Computes the base 2 logarithm of the number."
+layout: manual
+---
+
+Computes the base 2 logarithm of the number.
+
+
+
+```js
+log2(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = log2(4)
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/max.md

@@ -0,0 +1,34 @@
+---
+title: "max"
+excerpt: "Computes the maximum of the given arguments."
+layout: manual
+---
+
+Computes the maximum of the given arguments.
+
+
+
+```js
+max(args: [number]) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = max(4, 5, 6)
+```
+
+### Arguments
+
+* `args`: `[number]` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/min.md

@@ -0,0 +1,34 @@
+---
+title: "min"
+excerpt: "Computes the minimum of the given arguments."
+layout: manual
+---
+
+Computes the minimum of the given arguments.
+
+
+
+```js
+min(args: [number]) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = min(4, 5, 6)
+```
+
+### Arguments
+
+* `args`: `[number]` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/pi.md

@@ -0,0 +1,33 @@
+---
+title: "pi"
+excerpt: "Return the value of `pi`. Archimedes’ constant (π)."
+layout: manual
+---
+
+Return the value of `pi`. Archimedes’ constant (π).
+
+
+
+```js
+pi() -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = pi() * 3.0
+```
+
+### Arguments
+
+
+### Returns
+
+`number`
+
+
+

docs/kcl/pow.md

@@ -0,0 +1,35 @@
+---
+title: "pow"
+excerpt: "Computes the number to a power."
+layout: manual
+---
+
+Computes the number to a power.
+
+
+
+```js
+pow(num: number, pow: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = pow(4, 2)
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+* `pow`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/sin.md

@@ -0,0 +1,34 @@
+---
+title: "sin"
+excerpt: "Computes the sine of a number (in radians)."
+layout: manual
+---
+
+Computes the sine of a number (in radians).
+
+
+
+```js
+sin(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = sin(2 * pi())
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/sqrt.md

@@ -0,0 +1,34 @@
+---
+title: "sqrt"
+excerpt: "Computes the square root of a number."
+layout: manual
+---
+
+Computes the square root of a number.
+
+
+
+```js
+sqrt(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = sqrt(4)
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/tan.md

@@ -0,0 +1,34 @@
+---
+title: "tan"
+excerpt: "Computes the tangent of a number (in radians)."
+layout: manual
+---
+
+Computes the tangent of a number (in radians).
+
+
+
+```js
+tan(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = tan(2 * pi())
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/tau.md

@@ -0,0 +1,33 @@
+---
+title: "tau"
+excerpt: "Return the value of `tau`. The full circle constant (τ). Equal to 2π."
+layout: manual
+---
+
+Return the value of `tau`. The full circle constant (τ). Equal to 2π.
+
+
+
+```js
+tau() -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = tau()
+```
+
+### Arguments
+
+
+### Returns
+
+`number`
+
+
+

docs/kcl/toDegrees.md

@@ -0,0 +1,34 @@
+---
+title: "toDegrees"
+excerpt: "Converts a number from radians to degrees."
+layout: manual
+---
+
+Converts a number from radians to degrees.
+
+
+
+```js
+toDegrees(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = toDegrees(2 * pi())
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/toRadians.md

@@ -0,0 +1,34 @@
+---
+title: "toRadians"
+excerpt: "Converts a number from degrees to radians."
+layout: manual
+---
+
+Converts a number from degrees to radians.
+
+
+
+```js
+toRadians(num: number) -> number
+```
+
+### Tags
+
+* `math`
+
+### Examples
+
+```js
+const myVar = toRadians(180)
+```
+
+### Arguments
+
+* `num`: `number` (REQUIRED)
+
+### Returns
+
+`number`
+
+
+

docs/kcl/types.md

@@ -1,4 +1,8 @@
-# Types
+---
+title: "KCL Types"
+excerpt: "Documentation of types for the KCL standard library for the Zoo Modeling App."
+layout: manual
+---
 
 `KCL` defines the following types and keywords the language.