Merge branch 'main' into theme-not-persist

.github/workflows/ci.yml

@@ -89,16 +89,20 @@ jobs:
       - run: yarn build:wasm
 
       - run: yarn simpleserver:ci
+        if: ${{ github.event_name != 'release' && github.event_name != 'schedule' }}
 
       - name: Install Chromium Browser
+        if: ${{ github.event_name != 'release' && github.event_name != 'schedule' }}
         run: yarn playwright install chromium --with-deps
 
       - name: run unit tests
+        if: ${{ github.event_name != 'release' && github.event_name != 'schedule' }}
         run: yarn test:nowatch
         env:
           VITE_KC_DEV_TOKEN: ${{ secrets.KITTYCAD_API_TOKEN_DEV }}
 
       - name: check for changes
+        if: ${{ github.event_name != 'release' && github.event_name != 'schedule' }}
         id: git-check
         run: |
             git add src/lang/std/artifactMapGraphs
@@ -107,7 +111,7 @@ jobs:
             else echo "modified=false" >> $GITHUB_OUTPUT
             fi
       - name: Commit changes, if any
-        if: steps.git-check.outputs.modified == 'true'
+        if: ${{ github.event_name != 'release' && github.event_name != 'schedule' && steps.git-check.outputs.modified == 'true' }}
         run: |
           git config --local user.email "github-actions[bot]@users.noreply.github.com"
           git config --local user.name "github-actions[bot]"
@@ -531,21 +535,21 @@ jobs:
           project_id: kittycadapi
 
       - name: Upload release files to public bucket
-        uses: google-github-actions/upload-cloud-storage@v2.1.0
+        uses: google-github-actions/upload-cloud-storage@v2.1.1
         with:
           path: artifact
           glob: '*/Zoo*'
           parent: false
           destination: ${{ env.BUCKET_DIR }}/${{ env.VERSION }}
 
       - name: Upload update endpoint to public bucket
-        uses: google-github-actions/upload-cloud-storage@v2.1.0
+        uses: google-github-actions/upload-cloud-storage@v2.1.1
         with:
           path: last_update.json
           destination: ${{ env.BUCKET_DIR }}
 
       - name: Upload download endpoint to public bucket
-        uses: google-github-actions/upload-cloud-storage@v2.1.0
+        uses: google-github-actions/upload-cloud-storage@v2.1.1
         with:
           path: last_download.json
           destination: ${{ env.BUCKET_DIR }}

README.md

@@ -110,6 +110,17 @@ Note that these became separate apps on Macos, so make sure you open the right o
 
 <img width="1232" alt="image (1)" src="https://user-images.githubusercontent.com/29681384/211947073-e76b4933-bef5-4636-bc4d-e930ac8e290f.png">
 
+## Checking out commits / Bisecting
+
+Which commands from setup are one off vs need to be run every time?
+
+The following will need to be run when checking out a new commit and guarantees the build is not stale:
+```bash
+yarn install
+yarn build:wasm-dev # or yarn build:wasm for slower but more production-like build
+yarn start # or yarn build:local && yarn serve for slower but more production-like build
+```
+
 ## Before submitting a PR
 
 Before you submit a contribution PR to this repo, please ensure that:

docs/kcl/abs.md

@@ -1,10 +1,10 @@
 ---
 title: "abs"
-excerpt: "Computes the absolute value of a number."
+excerpt: "Compute the absolute value of a number."
 layout: manual
 ---
 
-Computes the absolute value of a number.
+Compute the absolute value of a number.
 
 
 

docs/kcl/acos.md

@@ -1,10 +1,10 @@
 ---
 title: "acos"
-excerpt: "Computes the arccosine of a number (in radians)."
+excerpt: "Compute the arccosine of a number (in radians)."
 layout: manual
 ---
 
-Computes the arccosine of a number (in radians).
+Compute the arccosine of a number (in radians).
 
 
 

docs/kcl/angleToMatchLengthX.md

@@ -1,10 +1,10 @@
 ---
 title: "angleToMatchLengthX"
-excerpt: "Returns the angle to match the given length for x."
+excerpt: "Compute the angle (in degrees) in o"
 layout: manual
 ---
 
-Returns the angle to match the given length for x.
+Compute the angle (in degrees) in o
 
 
 

docs/kcl/angledLine.md

@@ -1,12 +1,12 @@
 ---
 title: "angledLine"
-excerpt: "Draw an angled line."
+excerpt: "Draw a line segment relative to the current origin using the polar"
 layout: manual
 ---
 
-Draw an angled line.
-
+Draw a line segment relative to the current origin using the polar
 
+measure of some angle and distance.
 
 ```js
 angledLine(data: AngledLineData, sketch_group: SketchGroup, tag?: TagDeclarator) -> SketchGroup

docs/kcl/angledLineOfXLength.md

@@ -1,12 +1,12 @@
 ---
 title: "angledLineOfXLength"
-excerpt: "Draw an angled line of a given x length."
+excerpt: "Create a line segment from the current 2-dimensional sketch origin"
 layout: manual
 ---
 
-Draw an angled line of a given x length.
-
+Create a line segment from the current 2-dimensional sketch origin
 
+along some angle (in degrees) for some relative length in the 'x' dimension.
 
 ```js
 angledLineOfXLength(data: AngledLineData, sketch_group: SketchGroup, tag?: TagDeclarator) -> SketchGroup

docs/kcl/angledLineOfYLength.md

@@ -1,12 +1,12 @@
 ---
 title: "angledLineOfYLength"
-excerpt: "Draw an angled line of a given y length."
+excerpt: "Create a line segment from the current 2-dimensional sketch origin"
 layout: manual
 ---
 
-Draw an angled line of a given y length.
-
+Create a line segment from the current 2-dimensional sketch origin
 
+along some angle (in degrees) for some relative length in the 'y' dimension.
 
 ```js
 angledLineOfYLength(data: AngledLineData, sketch_group: SketchGroup, tag?: TagDeclarator) -> SketchGroup

docs/kcl/angledLineThatIntersects.md

@@ -1,12 +1,12 @@
 ---
 title: "angledLineThatIntersects"
-excerpt: "Draw an angled line that intersects with a given line."
+excerpt: "Draw an angled line from the current origin, constructing a line segment"
 layout: manual
 ---
 
-Draw an angled line that intersects with a given line.
-
+Draw an angled line from the current origin, constructing a line segment
 
+such that the newly created line intersects the desired target line segment.
 
 ```js
 angledLineThatIntersects(data: AngledLineThatIntersectsData, sketch_group: SketchGroup, tag?: TagDeclarator) -> SketchGroup

docs/kcl/angledLineToX.md

@@ -1,12 +1,12 @@
 ---
 title: "angledLineToX"
-excerpt: "Draw an angled line to a given x coordinate."
+excerpt: "Create a line segment from the current 2-dimensional sketch origin"
 layout: manual
 ---
 
-Draw an angled line to a given x coordinate.
-
+Create a line segment from the current 2-dimensional sketch origin
 
+along some angle (in degrees) for some length, ending at the provided value in the 'x' dimension.
 
 ```js
 angledLineToX(data: AngledLineToData, sketch_group: SketchGroup, tag?: TagDeclarator) -> SketchGroup

docs/kcl/angledLineToY.md

@@ -1,12 +1,12 @@
 ---
 title: "angledLineToY"
-excerpt: "Draw an angled line to a given y coordinate."
+excerpt: "Create a line segment from the current 2-dimensional sketch origin"
 layout: manual
 ---
 
-Draw an angled line to a given y coordinate.
-
+Create a line segment from the current 2-dimensional sketch origin
 
+along some angle (in degrees) for some length, ending at the provided value in the 'y' dimension.
 
 ```js
 angledLineToY(data: AngledLineToData, sketch_group: SketchGroup, tag?: TagDeclarator) -> SketchGroup

docs/kcl/arc.md

@@ -1,12 +1,14 @@
 ---
 title: "arc"
-excerpt: "Draw an arc."
+excerpt: "Starting at the current sketch's origin, draw a curved line segment along"
 layout: manual
 ---
 
-Draw an arc.
-
+Starting at the current sketch's origin, draw a curved line segment along
 
+an imaginary circle of the specified radius.
+The arc is constructed such that the current position of the sketch is placed along an imaginary circle of the specified radius, at angleStart degrees. The resulting arc is the segment of the imaginary circle from that origin point to angleEnd, radius away from the center of the imaginary circle.
+Unless this makes a lot of sense and feels like what you're looking for to construct your shape, you're likely looking for tangentialArc.
 
 ```js
 arc(data: ArcData, sketch_group: SketchGroup, tag?: TagDeclarator) -> SketchGroup

docs/kcl/asin.md

@@ -1,10 +1,10 @@
 ---
 title: "asin"
-excerpt: "Computes the arcsine of a number (in radians)."
+excerpt: "Compute the arcsine of a number (in radians)."
 layout: manual
 ---
 
-Computes the arcsine of a number (in radians).
+Compute the arcsine of a number (in radians).
 
 
 

docs/kcl/atan.md

@@ -1,10 +1,10 @@
 ---
 title: "atan"
-excerpt: "Computes the arctangent of a number (in radians)."
+excerpt: "Compute the arctangent of a number (in radians)."
 layout: manual
 ---
 
-Computes the arctangent of a number (in radians).
+Compute the arctangent of a number (in radians).
 
 
 

docs/kcl/bezierCurve.md

@@ -1,12 +1,12 @@
 ---
 title: "bezierCurve"
-excerpt: "Draw a bezier curve."
+excerpt: "Draw a smooth, continuous, curved line segment from the current origin to"
 layout: manual
 ---
 
-Draw a bezier curve.
-
+Draw a smooth, continuous, curved line segment from the current origin to
 
+the desired (x, y), using a number of control points to shape the curve's shape.
 
 ```js
 bezierCurve(data: BezierData, sketch_group: SketchGroup, tag?: TagDeclarator) -> SketchGroup

docs/kcl/ceil.md

@@ -1,10 +1,10 @@
 ---
 title: "ceil"
-excerpt: "Computes the smallest integer greater than or equal to a number."
+excerpt: "Compute the smallest integer greater than or equal to a number."
 layout: manual
 ---
 
-Computes the smallest integer greater than or equal to a number.
+Compute the smallest integer greater than or equal to a number.
 
 
 

docs/kcl/chamfer.md

@@ -1,12 +1,12 @@
 ---
 title: "chamfer"
-excerpt: "Create chamfers on tagged paths."
+excerpt: "Cut a straight transitional edge along a tagged path."
 layout: manual
 ---
 
-Create chamfers on tagged paths.
-
+Cut a straight transitional edge along a tagged path.
 
+Chamfer is similar in function and use to a fillet, except a fillet will blend the transition along an edge, rather than cut a sharp, straight transitional edge.
 
 ```js
 chamfer(data: ChamferData, extrude_group: ExtrudeGroup, tag?: TagDeclarator) -> ExtrudeGroup

docs/kcl/circle.md

@@ -1,12 +1,12 @@
 ---
 title: "circle"
-excerpt: "Sketch a circle."
+excerpt: "Construct a 2-dimensional circle, of the specified radius, centered at"
 layout: manual
 ---
 
-Sketch a circle.
-
+Construct a 2-dimensional circle, of the specified radius, centered at
 
+the provided (x, y) origin point.
 
 ```js
 circle(center: [number], radius: number, sketch_surface_or_group: SketchSurfaceOrGroup, tag?: TagDeclarator) -> SketchGroup

docs/kcl/close.md

@@ -1,12 +1,12 @@
 ---
 title: "close"
-excerpt: "Close the current sketch."
+excerpt: "Construct a line segment from the current origin back to the profile's"
 layout: manual
 ---
 
-Close the current sketch.
-
+Construct a line segment from the current origin back to the profile's
 
+origin, ensuring the resulting 2-dimensional sketch is not open-ended.
 
 ```js
 close(sketch_group: SketchGroup, tag?: TagDeclarator) -> SketchGroup

docs/kcl/cos.md

@@ -1,10 +1,10 @@
 ---
 title: "cos"
-excerpt: "Computes the cosine of a number (in radians)."
+excerpt: "Compute the cosine of a number (in radians)."
 layout: manual
 ---
 
-Computes the cosine of a number (in radians).
+Compute the cosine of a number (in radians).
 
 
 

docs/kcl/extrude.md

@@ -1,12 +1,12 @@
 ---
 title: "extrude"
-excerpt: "Extrudes by a given amount."
+excerpt: "Extend a 2-dimensional sketch through a third dimension in order to"
 layout: manual
 ---
 
-Extrudes by a given amount.
-
+Extend a 2-dimensional sketch through a third dimension in order to
 
+create new 3-dimensional volume, or if extruded into an existing volume, cut into an existing solid.
 
 ```js
 extrude(length: number, sketch_group_set: SketchGroupSet) -> ExtrudeGroupSet

docs/kcl/fillet.md

@@ -1,12 +1,12 @@
 ---
 title: "fillet"
-excerpt: "Create fillets on tagged paths."
+excerpt: "Blend a transitional edge along a tagged path, smoothing the sharp edge."
 layout: manual
 ---
 
-Create fillets on tagged paths.
-
+Blend a transitional edge along a tagged path, smoothing the sharp edge.
 
+Fillet is similar in function and use to a chamfer, except a chamfer will cut a sharp transition along an edge while fillet will smoothly blend the transition.
 
 ```js
 fillet(data: FilletData, extrude_group: ExtrudeGroup, tag?: TagDeclarator) -> ExtrudeGroup

docs/kcl/floor.md

@@ -1,10 +1,10 @@
 ---
 title: "floor"
-excerpt: "Computes the largest integer less than or equal to a number."
+excerpt: "Compute the largest integer less than or equal to a number."
 layout: manual
 ---
 
-Computes the largest integer less than or equal to a number.
+Compute the largest integer less than or equal to a number.
 
 
 

docs/kcl/hole.md

@@ -1,10 +1,10 @@
 ---
 title: "hole"
-excerpt: "Use a sketch to cut a hole in another sketch."
+excerpt: "Use a 2-dimensional sketch to cut a hole in another 2-dimensional sketch."
 layout: manual
 ---
 
-Use a sketch to cut a hole in another sketch.
+Use a 2-dimensional sketch to cut a hole in another 2-dimensional sketch.