diff --git a/docs/kcl/index.md b/docs/kcl/index.md
index da2243646..75f3c19d4 100644
--- a/docs/kcl/index.md
+++ b/docs/kcl/index.md
@@ -74,10 +74,12 @@ layout: manual
* [`patternTransform`](kcl/patternTransform)
* [`pi`](kcl/pi)
* [`polar`](kcl/polar)
+* [`polygon`](kcl/polygon)
* [`pow`](kcl/pow)
* [`profileStart`](kcl/profileStart)
* [`profileStartX`](kcl/profileStartX)
* [`profileStartY`](kcl/profileStartY)
+* [`push`](kcl/push)
* [`reduce`](kcl/reduce)
* [`rem`](kcl/rem)
* [`revolve`](kcl/revolve)
diff --git a/docs/kcl/polygon.md b/docs/kcl/polygon.md
new file mode 100644
index 000000000..de75c3538
--- /dev/null
+++ b/docs/kcl/polygon.md
@@ -0,0 +1,60 @@
+---
+title: "polygon"
+excerpt: "Create a regular polygon with the specified number of sides that is either inscribed or circumscribed around a circle of the specified radius."
+layout: manual
+---
+
+Create a regular polygon with the specified number of sides that is either inscribed or circumscribed around a circle of the specified radius.
+
+
+
+```js
+polygon(data: PolygonData, sketch_surface_or_group: SketchOrSurface, tag?: TagDeclarator) -> Sketch
+```
+
+
+### Arguments
+
+| Name | Type | Description | Required |
+|----------|------|-------------|----------|
+| `data` | [`PolygonData`](/docs/kcl/types/PolygonData) | Data for drawing a polygon | Yes |
+| `sketch_surface_or_group` | [`SketchOrSurface`](/docs/kcl/types/SketchOrSurface) | A sketch surface or a sketch. | Yes |
+| `tag` | [`TagDeclarator`](/docs/kcl/types#tag-declaration) | | No |
+
+### Returns
+
+[`Sketch`](/docs/kcl/types/Sketch) - A sketch is a collection of paths.
+
+
+### Examples
+
+```js
+// Create a regular hexagon inscribed in a circle of radius 10
+hex = startSketchOn('XY')
+ |> polygon({
+ radius: 10,
+ numSides: 6,
+ center: [0, 0],
+ inscribed: true
+ }, %)
+
+example = extrude(5, hex)
+```
+
+
+
+```js
+// Create a square circumscribed around a circle of radius 5
+square = startSketchOn('XY')
+ |> polygon({
+ radius: 5.0,
+ numSides: 4,
+ center: [10, 10],
+ inscribed: false
+ }, %)
+example = extrude(5, square)
+```
+
+
+
+
diff --git a/docs/kcl/push.md b/docs/kcl/push.md
new file mode 100644
index 000000000..321786b07
--- /dev/null
+++ b/docs/kcl/push.md
@@ -0,0 +1,38 @@
+---
+title: "push"
+excerpt: "Append an element to the end of an array."
+layout: manual
+---
+
+Append an element to the end of an array.
+
+Returns a new array with the element appended.
+
+```js
+push(array: [KclValue], elem: KclValue) -> KclValue
+```
+
+
+### Arguments
+
+| Name | Type | Description | Required |
+|----------|------|-------------|----------|
+| `array` | [`[KclValue]`](/docs/kcl/types/KclValue) | | Yes |
+| `elem` | [`KclValue`](/docs/kcl/types/KclValue) | Any KCL value. | Yes |
+
+### Returns
+
+[`KclValue`](/docs/kcl/types/KclValue) - Any KCL value.
+
+
+### Examples
+
+```js
+arr = [1, 2, 3]
+new_arr = push(arr, 4)
+assertEqual(new_arr[3], 4, 0.00001, "4 was added to the end of the array")
+```
+
+
+
+
diff --git a/docs/kcl/std.json b/docs/kcl/std.json
index 6dcf0a703..058d12394 100644
--- a/docs/kcl/std.json
+++ b/docs/kcl/std.json
@@ -119614,6 +119614,4104 @@
"exampleSketch = startSketchOn('XZ')\n |> startProfileAt([0, 0], %)\n |> line(polar({ angle: 30, length: 5 }), %, $thing)\n |> line([0, 5], %)\n |> line([segEndX(thing), 0], %)\n |> line([-20, 10], %)\n |> close(%)\n\nexample = extrude(5, exampleSketch)"
]
},
+ {
+ "name": "polygon",
+ "summary": "Create a regular polygon with the specified number of sides that is either inscribed or circumscribed around a circle of the specified radius.",
+ "description": "",
+ "tags": [],
+ "args": [
+ {
+ "name": "data",
+ "type": "PolygonData",
+ "schema": {
+ "$schema": "https://spec.openapis.org/oas/3.0/schema/2019-04-02#/definitions/Schema",
+ "title": "PolygonData",
+ "description": "Data for drawing a polygon",
+ "type": "object",
+ "required": [
+ "center",
+ "numSides",
+ "radius"
+ ],
+ "properties": {
+ "radius": {
+ "description": "The radius of the polygon",
+ "type": "number",
+ "format": "double"
+ },
+ "numSides": {
+ "description": "The number of sides in the polygon",
+ "type": "integer",
+ "format": "uint64",
+ "minimum": 0.0
+ },
+ "center": {
+ "description": "The center point of the polygon",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "inscribed": {
+ "description": "Whether the polygon is inscribed (true) or circumscribed (false) about a circle with the specified radius",
+ "default": true,
+ "type": "boolean"
+ }
+ }
+ },
+ "required": true
+ },
+ {
+ "name": "sketch_surface_or_group",
+ "type": "SketchOrSurface",
+ "schema": {
+ "$schema": "https://spec.openapis.org/oas/3.0/schema/2019-04-02#/definitions/Schema",
+ "title": "SketchOrSurface",
+ "description": "A sketch surface or a sketch.",
+ "anyOf": [
+ {
+ "$ref": "#/components/schemas/SketchSurface"
+ },
+ {
+ "$ref": "#/components/schemas/Sketch"
+ }
+ ],
+ "definitions": {
+ "SketchSurface": {
+ "description": "A sketch type.",
+ "oneOf": [
+ {
+ "description": "A plane.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "origin",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "plane"
+ ]
+ },
+ "id": {
+ "description": "The id of the plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "$ref": "#/components/schemas/PlaneType"
+ },
+ "origin": {
+ "description": "Origin of the plane.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "xAxis": {
+ "description": "What should the plane’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the plane’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "A face.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "solid",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "face"
+ ]
+ },
+ "id": {
+ "description": "The id of the face.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The tag of the face.",
+ "type": "string"
+ },
+ "xAxis": {
+ "description": "What should the face’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the face’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "solid": {
+ "description": "The solid the face is on.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Solid"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ }
+ ]
+ },
+ "PlaneType": {
+ "description": "Type for a plane.",
+ "oneOf": [
+ {
+ "type": "string",
+ "enum": [
+ "XY",
+ "XZ",
+ "YZ"
+ ]
+ },
+ {
+ "description": "A custom plane.",
+ "type": "string",
+ "enum": [
+ "Custom"
+ ]
+ }
+ ]
+ },
+ "Point3d": {
+ "type": "object",
+ "required": [
+ "x",
+ "y",
+ "z"
+ ],
+ "properties": {
+ "x": {
+ "type": "number",
+ "format": "double"
+ },
+ "y": {
+ "type": "number",
+ "format": "double"
+ },
+ "z": {
+ "type": "number",
+ "format": "double"
+ }
+ }
+ },
+ "Metadata": {
+ "description": "Metadata.",
+ "type": "object",
+ "required": [
+ "sourceRange"
+ ],
+ "properties": {
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ "SourceRange": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "Solid": {
+ "description": "An solid is a collection of extrude surfaces.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "height",
+ "id",
+ "sketch",
+ "value"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the solid.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The extrude surfaces.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "sketch": {
+ "description": "The sketch.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Sketch"
+ }
+ ]
+ },
+ "height": {
+ "description": "The height of the solid.",
+ "type": "number",
+ "format": "double"
+ },
+ "startCapId": {
+ "description": "The id of the extrusion start cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "endCapId": {
+ "description": "The id of the extrusion end cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "edgeCuts": {
+ "description": "Chamfers or fillets on this solid.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/EdgeCut"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "ExtrudeSurface": {
+ "description": "An extrude surface.",
+ "oneOf": [
+ {
+ "description": "An extrude plane.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "extrudePlane"
+ ]
+ },
+ "faceId": {
+ "description": "The face id for the extrude plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "An extruded arc.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "extrudeArc"
+ ]
+ },
+ "faceId": {
+ "description": "The face id for the extrude plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "chamfer"
+ ]
+ },
+ "faceId": {
+ "description": "The id for the chamfer surface.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "fillet"
+ ]
+ },
+ "faceId": {
+ "description": "The id for the fillet surface.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "TagDeclarator": {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "value"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "Sketch": {
+ "description": "A sketch is a collection of paths.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "on",
+ "paths",
+ "start"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the sketch (this will change when the engine's reference to it changes).",
+ "type": "string",
+ "format": "uuid"
+ },
+ "paths": {
+ "description": "The paths in the sketch.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Path"
+ }
+ },
+ "on": {
+ "description": "What the sketch is on (can be a plane or a face).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SketchSurface"
+ }
+ ]
+ },
+ "start": {
+ "description": "The starting path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/BasePath"
+ }
+ ]
+ },
+ "tags": {
+ "description": "Tag identifiers that have been declared in this sketch.",
+ "type": "object",
+ "additionalProperties": {
+ "$ref": "#/components/schemas/TagIdentifier"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "Path": {
+ "description": "A path.",
+ "oneOf": [
+ {
+ "description": "A path that goes to a point.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ToPoint"
+ ]
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A arc that is tangential to the last path segment that goes to a point",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TangentialArcTo"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A arc that is tangential to the last path segment",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TangentialArc"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "a complete arc",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "radius",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Circle"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "radius": {
+ "description": "the arc's radius",
+ "type": "number",
+ "format": "double"
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A path that is horizontal.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type",
+ "x"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Horizontal"
+ ]
+ },
+ "x": {
+ "description": "The x coordinate.",
+ "type": "number",
+ "format": "double"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "An angled line to.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "AngledLineTo"
+ ]
+ },
+ "x": {
+ "description": "The x coordinate.",
+ "type": "number",
+ "format": "double",
+ "nullable": true
+ },
+ "y": {
+ "description": "The y coordinate.",
+ "type": "number",
+ "format": "double",
+ "nullable": true
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A base path.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Base"
+ ]
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A circular arc, not necessarily tangential to the current point.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "center",
+ "from",
+ "radius",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Arc"
+ ]
+ },
+ "center": {
+ "description": "Center of the circle that this arc is drawn on.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "radius": {
+ "description": "Radius of the circle that this arc is drawn on.",
+ "type": "number",
+ "format": "double"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "GeoMeta": {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "id",
+ "sourceRange"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ "BasePath": {
+ "description": "A base path.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to"
+ ],
+ "properties": {
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ "TagIdentifier": {
+ "type": "object",
+ "required": [
+ "__meta",
+ "value"
+ ],
+ "properties": {
+ "value": {
+ "type": "string"
+ },
+ "info": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagEngineInfo"
+ }
+ ],
+ "nullable": true
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "TagEngineInfo": {
+ "description": "Engine information for a tag.",
+ "type": "object",
+ "oneOf": [
+ {
+ "description": "The path the tag is on.",
+ "type": "object",
+ "required": [
+ "path"
+ ],
+ "properties": {
+ "path": {
+ "$ref": "#/components/schemas/Path"
+ }
+ },
+ "additionalProperties": false
+ },
+ {
+ "description": "The surface information for the tag.",
+ "type": "object",
+ "required": [
+ "surface"
+ ],
+ "properties": {
+ "surface": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "additionalProperties": false
+ }
+ ],
+ "required": [
+ "id",
+ "sketch"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the tagged object.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sketch": {
+ "description": "The sketch the tag is on.",
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ },
+ "EdgeCut": {
+ "description": "A fillet or a chamfer.",
+ "oneOf": [
+ {
+ "description": "A fillet.",
+ "type": "object",
+ "required": [
+ "edgeId",
+ "id",
+ "radius",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "fillet"
+ ]
+ },
+ "id": {
+ "description": "The id of the engine command that called this fillet.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "radius": {
+ "type": "number",
+ "format": "double"
+ },
+ "edgeId": {
+ "description": "The engine id of the edge to fillet.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ },
+ {
+ "description": "A chamfer.",
+ "type": "object",
+ "required": [
+ "edgeId",
+ "id",
+ "length",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "chamfer"
+ ]
+ },
+ "id": {
+ "description": "The id of the engine command that called this chamfer.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "length": {
+ "type": "number",
+ "format": "double"
+ },
+ "edgeId": {
+ "description": "The engine id of the edge to chamfer.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ }
+ ]
+ }
+ }
+ },
+ "required": true
+ },
+ {
+ "name": "tag",
+ "type": "TagDeclarator",
+ "schema": {
+ "$schema": "https://spec.openapis.org/oas/3.0/schema/2019-04-02#/definitions/Schema",
+ "title": "Nullable_TagDeclarator",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true,
+ "definitions": {
+ "SketchSurface": {
+ "description": "A sketch type.",
+ "oneOf": [
+ {
+ "description": "A plane.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "origin",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "plane"
+ ]
+ },
+ "id": {
+ "description": "The id of the plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "$ref": "#/components/schemas/PlaneType"
+ },
+ "origin": {
+ "description": "Origin of the plane.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "xAxis": {
+ "description": "What should the plane’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the plane’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "A face.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "solid",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "face"
+ ]
+ },
+ "id": {
+ "description": "The id of the face.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The tag of the face.",
+ "type": "string"
+ },
+ "xAxis": {
+ "description": "What should the face’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the face’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "solid": {
+ "description": "The solid the face is on.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Solid"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ }
+ ]
+ },
+ "PlaneType": {
+ "description": "Type for a plane.",
+ "oneOf": [
+ {
+ "type": "string",
+ "enum": [
+ "XY",
+ "XZ",
+ "YZ"
+ ]
+ },
+ {
+ "description": "A custom plane.",
+ "type": "string",
+ "enum": [
+ "Custom"
+ ]
+ }
+ ]
+ },
+ "Point3d": {
+ "type": "object",
+ "required": [
+ "x",
+ "y",
+ "z"
+ ],
+ "properties": {
+ "x": {
+ "type": "number",
+ "format": "double"
+ },
+ "y": {
+ "type": "number",
+ "format": "double"
+ },
+ "z": {
+ "type": "number",
+ "format": "double"
+ }
+ }
+ },
+ "Metadata": {
+ "description": "Metadata.",
+ "type": "object",
+ "required": [
+ "sourceRange"
+ ],
+ "properties": {
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ "SourceRange": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "Solid": {
+ "description": "An solid is a collection of extrude surfaces.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "height",
+ "id",
+ "sketch",
+ "value"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the solid.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The extrude surfaces.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "sketch": {
+ "description": "The sketch.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Sketch"
+ }
+ ]
+ },
+ "height": {
+ "description": "The height of the solid.",
+ "type": "number",
+ "format": "double"
+ },
+ "startCapId": {
+ "description": "The id of the extrusion start cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "endCapId": {
+ "description": "The id of the extrusion end cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "edgeCuts": {
+ "description": "Chamfers or fillets on this solid.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/EdgeCut"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "ExtrudeSurface": {
+ "description": "An extrude surface.",
+ "oneOf": [
+ {
+ "description": "An extrude plane.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "extrudePlane"
+ ]
+ },
+ "faceId": {
+ "description": "The face id for the extrude plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "An extruded arc.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "extrudeArc"
+ ]
+ },
+ "faceId": {
+ "description": "The face id for the extrude plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "chamfer"
+ ]
+ },
+ "faceId": {
+ "description": "The id for the chamfer surface.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "fillet"
+ ]
+ },
+ "faceId": {
+ "description": "The id for the fillet surface.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "TagDeclarator": {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "value"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "Sketch": {
+ "description": "A sketch is a collection of paths.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "on",
+ "paths",
+ "start"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the sketch (this will change when the engine's reference to it changes).",
+ "type": "string",
+ "format": "uuid"
+ },
+ "paths": {
+ "description": "The paths in the sketch.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Path"
+ }
+ },
+ "on": {
+ "description": "What the sketch is on (can be a plane or a face).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SketchSurface"
+ }
+ ]
+ },
+ "start": {
+ "description": "The starting path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/BasePath"
+ }
+ ]
+ },
+ "tags": {
+ "description": "Tag identifiers that have been declared in this sketch.",
+ "type": "object",
+ "additionalProperties": {
+ "$ref": "#/components/schemas/TagIdentifier"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "Path": {
+ "description": "A path.",
+ "oneOf": [
+ {
+ "description": "A path that goes to a point.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ToPoint"
+ ]
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A arc that is tangential to the last path segment that goes to a point",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TangentialArcTo"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A arc that is tangential to the last path segment",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TangentialArc"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "a complete arc",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "radius",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Circle"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "radius": {
+ "description": "the arc's radius",
+ "type": "number",
+ "format": "double"
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A path that is horizontal.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type",
+ "x"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Horizontal"
+ ]
+ },
+ "x": {
+ "description": "The x coordinate.",
+ "type": "number",
+ "format": "double"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "An angled line to.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "AngledLineTo"
+ ]
+ },
+ "x": {
+ "description": "The x coordinate.",
+ "type": "number",
+ "format": "double",
+ "nullable": true
+ },
+ "y": {
+ "description": "The y coordinate.",
+ "type": "number",
+ "format": "double",
+ "nullable": true
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A base path.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Base"
+ ]
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A circular arc, not necessarily tangential to the current point.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "center",
+ "from",
+ "radius",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Arc"
+ ]
+ },
+ "center": {
+ "description": "Center of the circle that this arc is drawn on.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "radius": {
+ "description": "Radius of the circle that this arc is drawn on.",
+ "type": "number",
+ "format": "double"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "GeoMeta": {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "id",
+ "sourceRange"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ "BasePath": {
+ "description": "A base path.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to"
+ ],
+ "properties": {
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ "TagIdentifier": {
+ "type": "object",
+ "required": [
+ "__meta",
+ "value"
+ ],
+ "properties": {
+ "value": {
+ "type": "string"
+ },
+ "info": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagEngineInfo"
+ }
+ ],
+ "nullable": true
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "TagEngineInfo": {
+ "description": "Engine information for a tag.",
+ "type": "object",
+ "oneOf": [
+ {
+ "description": "The path the tag is on.",
+ "type": "object",
+ "required": [
+ "path"
+ ],
+ "properties": {
+ "path": {
+ "$ref": "#/components/schemas/Path"
+ }
+ },
+ "additionalProperties": false
+ },
+ {
+ "description": "The surface information for the tag.",
+ "type": "object",
+ "required": [
+ "surface"
+ ],
+ "properties": {
+ "surface": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "additionalProperties": false
+ }
+ ],
+ "required": [
+ "id",
+ "sketch"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the tagged object.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sketch": {
+ "description": "The sketch the tag is on.",
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ },
+ "EdgeCut": {
+ "description": "A fillet or a chamfer.",
+ "oneOf": [
+ {
+ "description": "A fillet.",
+ "type": "object",
+ "required": [
+ "edgeId",
+ "id",
+ "radius",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "fillet"
+ ]
+ },
+ "id": {
+ "description": "The id of the engine command that called this fillet.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "radius": {
+ "type": "number",
+ "format": "double"
+ },
+ "edgeId": {
+ "description": "The engine id of the edge to fillet.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ },
+ {
+ "description": "A chamfer.",
+ "type": "object",
+ "required": [
+ "edgeId",
+ "id",
+ "length",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "chamfer"
+ ]
+ },
+ "id": {
+ "description": "The id of the engine command that called this chamfer.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "length": {
+ "type": "number",
+ "format": "double"
+ },
+ "edgeId": {
+ "description": "The engine id of the edge to chamfer.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ }
+ ]
+ }
+ }
+ },
+ "required": false
+ }
+ ],
+ "returnValue": {
+ "name": "",
+ "type": "Sketch",
+ "schema": {
+ "$schema": "https://spec.openapis.org/oas/3.0/schema/2019-04-02#/definitions/Schema",
+ "title": "Sketch",
+ "description": "A sketch is a collection of paths.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "on",
+ "paths",
+ "start"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the sketch (this will change when the engine's reference to it changes).",
+ "type": "string",
+ "format": "uuid"
+ },
+ "paths": {
+ "description": "The paths in the sketch.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Path"
+ }
+ },
+ "on": {
+ "description": "What the sketch is on (can be a plane or a face).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SketchSurface"
+ }
+ ]
+ },
+ "start": {
+ "description": "The starting path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/BasePath"
+ }
+ ]
+ },
+ "tags": {
+ "description": "Tag identifiers that have been declared in this sketch.",
+ "type": "object",
+ "additionalProperties": {
+ "$ref": "#/components/schemas/TagIdentifier"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ },
+ "definitions": {
+ "Path": {
+ "description": "A path.",
+ "oneOf": [
+ {
+ "description": "A path that goes to a point.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ToPoint"
+ ]
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A arc that is tangential to the last path segment that goes to a point",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TangentialArcTo"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A arc that is tangential to the last path segment",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TangentialArc"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "a complete arc",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "radius",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Circle"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "radius": {
+ "description": "the arc's radius",
+ "type": "number",
+ "format": "double"
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A path that is horizontal.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type",
+ "x"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Horizontal"
+ ]
+ },
+ "x": {
+ "description": "The x coordinate.",
+ "type": "number",
+ "format": "double"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "An angled line to.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "AngledLineTo"
+ ]
+ },
+ "x": {
+ "description": "The x coordinate.",
+ "type": "number",
+ "format": "double",
+ "nullable": true
+ },
+ "y": {
+ "description": "The y coordinate.",
+ "type": "number",
+ "format": "double",
+ "nullable": true
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A base path.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Base"
+ ]
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A circular arc, not necessarily tangential to the current point.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "center",
+ "from",
+ "radius",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Arc"
+ ]
+ },
+ "center": {
+ "description": "Center of the circle that this arc is drawn on.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "radius": {
+ "description": "Radius of the circle that this arc is drawn on.",
+ "type": "number",
+ "format": "double"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "TagDeclarator": {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "value"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "GeoMeta": {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "id",
+ "sourceRange"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ "SourceRange": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "SketchSurface": {
+ "description": "A sketch type.",
+ "oneOf": [
+ {
+ "description": "A plane.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "origin",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "plane"
+ ]
+ },
+ "id": {
+ "description": "The id of the plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "$ref": "#/components/schemas/PlaneType"
+ },
+ "origin": {
+ "description": "Origin of the plane.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "xAxis": {
+ "description": "What should the plane’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the plane’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "A face.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "solid",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "face"
+ ]
+ },
+ "id": {
+ "description": "The id of the face.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The tag of the face.",
+ "type": "string"
+ },
+ "xAxis": {
+ "description": "What should the face’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the face’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "solid": {
+ "description": "The solid the face is on.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Solid"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ }
+ ]
+ },
+ "PlaneType": {
+ "description": "Type for a plane.",
+ "oneOf": [
+ {
+ "type": "string",
+ "enum": [
+ "XY",
+ "XZ",
+ "YZ"
+ ]
+ },
+ {
+ "description": "A custom plane.",
+ "type": "string",
+ "enum": [
+ "Custom"
+ ]
+ }
+ ]
+ },
+ "Point3d": {
+ "type": "object",
+ "required": [
+ "x",
+ "y",
+ "z"
+ ],
+ "properties": {
+ "x": {
+ "type": "number",
+ "format": "double"
+ },
+ "y": {
+ "type": "number",
+ "format": "double"
+ },
+ "z": {
+ "type": "number",
+ "format": "double"
+ }
+ }
+ },
+ "Metadata": {
+ "description": "Metadata.",
+ "type": "object",
+ "required": [
+ "sourceRange"
+ ],
+ "properties": {
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ "Solid": {
+ "description": "An solid is a collection of extrude surfaces.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "height",
+ "id",
+ "sketch",
+ "value"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the solid.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The extrude surfaces.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "sketch": {
+ "description": "The sketch.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Sketch"
+ }
+ ]
+ },
+ "height": {
+ "description": "The height of the solid.",
+ "type": "number",
+ "format": "double"
+ },
+ "startCapId": {
+ "description": "The id of the extrusion start cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "endCapId": {
+ "description": "The id of the extrusion end cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "edgeCuts": {
+ "description": "Chamfers or fillets on this solid.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/EdgeCut"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "ExtrudeSurface": {
+ "description": "An extrude surface.",
+ "oneOf": [
+ {
+ "description": "An extrude plane.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "extrudePlane"
+ ]
+ },
+ "faceId": {
+ "description": "The face id for the extrude plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "An extruded arc.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "extrudeArc"
+ ]
+ },
+ "faceId": {
+ "description": "The face id for the extrude plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "chamfer"
+ ]
+ },
+ "faceId": {
+ "description": "The id for the chamfer surface.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "fillet"
+ ]
+ },
+ "faceId": {
+ "description": "The id for the fillet surface.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "Sketch": {
+ "description": "A sketch is a collection of paths.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "on",
+ "paths",
+ "start"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the sketch (this will change when the engine's reference to it changes).",
+ "type": "string",
+ "format": "uuid"
+ },
+ "paths": {
+ "description": "The paths in the sketch.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Path"
+ }
+ },
+ "on": {
+ "description": "What the sketch is on (can be a plane or a face).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SketchSurface"
+ }
+ ]
+ },
+ "start": {
+ "description": "The starting path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/BasePath"
+ }
+ ]
+ },
+ "tags": {
+ "description": "Tag identifiers that have been declared in this sketch.",
+ "type": "object",
+ "additionalProperties": {
+ "$ref": "#/components/schemas/TagIdentifier"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "BasePath": {
+ "description": "A base path.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to"
+ ],
+ "properties": {
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ "TagIdentifier": {
+ "type": "object",
+ "required": [
+ "__meta",
+ "value"
+ ],
+ "properties": {
+ "value": {
+ "type": "string"
+ },
+ "info": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagEngineInfo"
+ }
+ ],
+ "nullable": true
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "TagEngineInfo": {
+ "description": "Engine information for a tag.",
+ "type": "object",
+ "oneOf": [
+ {
+ "description": "The path the tag is on.",
+ "type": "object",
+ "required": [
+ "path"
+ ],
+ "properties": {
+ "path": {
+ "$ref": "#/components/schemas/Path"
+ }
+ },
+ "additionalProperties": false
+ },
+ {
+ "description": "The surface information for the tag.",
+ "type": "object",
+ "required": [
+ "surface"
+ ],
+ "properties": {
+ "surface": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "additionalProperties": false
+ }
+ ],
+ "required": [
+ "id",
+ "sketch"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the tagged object.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sketch": {
+ "description": "The sketch the tag is on.",
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ },
+ "EdgeCut": {
+ "description": "A fillet or a chamfer.",
+ "oneOf": [
+ {
+ "description": "A fillet.",
+ "type": "object",
+ "required": [
+ "edgeId",
+ "id",
+ "radius",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "fillet"
+ ]
+ },
+ "id": {
+ "description": "The id of the engine command that called this fillet.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "radius": {
+ "type": "number",
+ "format": "double"
+ },
+ "edgeId": {
+ "description": "The engine id of the edge to fillet.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ },
+ {
+ "description": "A chamfer.",
+ "type": "object",
+ "required": [
+ "edgeId",
+ "id",
+ "length",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "chamfer"
+ ]
+ },
+ "id": {
+ "description": "The id of the engine command that called this chamfer.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "length": {
+ "type": "number",
+ "format": "double"
+ },
+ "edgeId": {
+ "description": "The engine id of the edge to chamfer.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ }
+ ]
+ }
+ }
+ },
+ "required": true
+ },
+ "unpublished": false,
+ "deprecated": false,
+ "examples": [
+ "// Create a regular hexagon inscribed in a circle of radius 10\nhex = startSketchOn('XY')\n |> polygon({\n radius: 10,\n numSides: 6,\n center: [0, 0],\n inscribed: true\n }, %)\n\nexample = extrude(5, hex)",
+ "// Create a square circumscribed around a circle of radius 5\nsquare = startSketchOn('XY')\n |> polygon({\n radius: 5.0,\n numSides: 4,\n center: [10, 10],\n inscribed: false\n }, %)\nexample = extrude(5, square)"
+ ]
+ },
{
"name": "pow",
"summary": "Compute the number to a power.",
@@ -123840,6 +127938,12322 @@
"sketch001 = startSketchOn('XY')\n |> startProfileAt([5, 2], %)\n |> angledLine({ angle: -60, length: 14 }, %)\n |> angledLineToY({ angle: 30, to: profileStartY(%) }, %)"
]
},
+ {
+ "name": "push",
+ "summary": "Append an element to the end of an array.",
+ "description": "Returns a new array with the element appended.",
+ "tags": [],
+ "args": [
+ {
+ "name": "array",
+ "type": "[KclValue]",
+ "schema": {
+ "$schema": "https://spec.openapis.org/oas/3.0/schema/2019-04-02#/definitions/Schema",
+ "title": "Array_of_KclValue",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/KclValue"
+ },
+ "definitions": {
+ "KclValue": {
+ "description": "Any KCL value.",
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "UserVal"
+ ]
+ },
+ "value": {},
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TagIdentifier"
+ ]
+ },
+ "value": {
+ "type": "string"
+ },
+ "info": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagEngineInfo"
+ }
+ ],
+ "nullable": true
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TagDeclarator"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "description": "A plane.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "origin",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Plane"
+ ]
+ },
+ "id": {
+ "description": "The id of the plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "$ref": "#/components/schemas/PlaneType"
+ },
+ "origin": {
+ "description": "Origin of the plane.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "xAxis": {
+ "description": "What should the plane’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the plane’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "A face.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "solid",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Face"
+ ]
+ },
+ "id": {
+ "description": "The id of the face.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The tag of the face.",
+ "type": "string"
+ },
+ "xAxis": {
+ "description": "What should the face’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the face’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "solid": {
+ "description": "The solid the face is on.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Solid"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "An solid is a collection of extrude surfaces.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "height",
+ "id",
+ "sketch",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Solid"
+ ]
+ },
+ "id": {
+ "description": "The id of the solid.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The extrude surfaces.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "sketch": {
+ "description": "The sketch.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Sketch"
+ }
+ ]
+ },
+ "height": {
+ "description": "The height of the solid.",
+ "type": "number",
+ "format": "double"
+ },
+ "startCapId": {
+ "description": "The id of the extrusion start cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "endCapId": {
+ "description": "The id of the extrusion end cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "edgeCuts": {
+ "description": "Chamfers or fillets on this solid.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/EdgeCut"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Solids"
+ ]
+ },
+ "value": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Solid"
+ }
+ }
+ }
+ },
+ {
+ "description": "Data for an imported geometry.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ImportedGeometry"
+ ]
+ },
+ "id": {
+ "description": "The ID of the imported geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The original file paths.",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "expression",
+ "memory",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Function"
+ ]
+ },
+ "expression": {
+ "$ref": "#/components/schemas/FunctionExpression"
+ },
+ "memory": {
+ "$ref": "#/components/schemas/ProgramMemory"
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ }
+ ]
+ },
+ "Metadata": {
+ "description": "Metadata.",
+ "type": "object",
+ "required": [
+ "sourceRange"
+ ],
+ "properties": {
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ "SourceRange": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "TagEngineInfo": {
+ "description": "Engine information for a tag.",
+ "type": "object",
+ "oneOf": [
+ {
+ "description": "The path the tag is on.",
+ "type": "object",
+ "required": [
+ "path"
+ ],
+ "properties": {
+ "path": {
+ "$ref": "#/components/schemas/Path"
+ }
+ },
+ "additionalProperties": false
+ },
+ {
+ "description": "The surface information for the tag.",
+ "type": "object",
+ "required": [
+ "surface"
+ ],
+ "properties": {
+ "surface": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "additionalProperties": false
+ }
+ ],
+ "required": [
+ "id",
+ "sketch"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the tagged object.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sketch": {
+ "description": "The sketch the tag is on.",
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ },
+ "Path": {
+ "description": "A path.",
+ "oneOf": [
+ {
+ "description": "A path that goes to a point.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ToPoint"
+ ]
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A arc that is tangential to the last path segment that goes to a point",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TangentialArcTo"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A arc that is tangential to the last path segment",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TangentialArc"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "a complete arc",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "radius",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Circle"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "radius": {
+ "description": "the arc's radius",
+ "type": "number",
+ "format": "double"
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A path that is horizontal.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type",
+ "x"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Horizontal"
+ ]
+ },
+ "x": {
+ "description": "The x coordinate.",
+ "type": "number",
+ "format": "double"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "An angled line to.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "AngledLineTo"
+ ]
+ },
+ "x": {
+ "description": "The x coordinate.",
+ "type": "number",
+ "format": "double",
+ "nullable": true
+ },
+ "y": {
+ "description": "The y coordinate.",
+ "type": "number",
+ "format": "double",
+ "nullable": true
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A base path.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Base"
+ ]
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A circular arc, not necessarily tangential to the current point.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "center",
+ "from",
+ "radius",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Arc"
+ ]
+ },
+ "center": {
+ "description": "Center of the circle that this arc is drawn on.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "radius": {
+ "description": "Radius of the circle that this arc is drawn on.",
+ "type": "number",
+ "format": "double"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "TagDeclarator": {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "value"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "GeoMeta": {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "id",
+ "sourceRange"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ "ExtrudeSurface": {
+ "description": "An extrude surface.",
+ "oneOf": [
+ {
+ "description": "An extrude plane.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "extrudePlane"
+ ]
+ },
+ "faceId": {
+ "description": "The face id for the extrude plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "An extruded arc.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "extrudeArc"
+ ]
+ },
+ "faceId": {
+ "description": "The face id for the extrude plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "chamfer"
+ ]
+ },
+ "faceId": {
+ "description": "The id for the chamfer surface.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "fillet"
+ ]
+ },
+ "faceId": {
+ "description": "The id for the fillet surface.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "PlaneType": {
+ "description": "Type for a plane.",
+ "oneOf": [
+ {
+ "type": "string",
+ "enum": [
+ "XY",
+ "XZ",
+ "YZ"
+ ]
+ },
+ {
+ "description": "A custom plane.",
+ "type": "string",
+ "enum": [
+ "Custom"
+ ]
+ }
+ ]
+ },
+ "Point3d": {
+ "type": "object",
+ "required": [
+ "x",
+ "y",
+ "z"
+ ],
+ "properties": {
+ "x": {
+ "type": "number",
+ "format": "double"
+ },
+ "y": {
+ "type": "number",
+ "format": "double"
+ },
+ "z": {
+ "type": "number",
+ "format": "double"
+ }
+ }
+ },
+ "Solid": {
+ "description": "An solid is a collection of extrude surfaces.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "height",
+ "id",
+ "sketch",
+ "value"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the solid.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The extrude surfaces.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "sketch": {
+ "description": "The sketch.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Sketch"
+ }
+ ]
+ },
+ "height": {
+ "description": "The height of the solid.",
+ "type": "number",
+ "format": "double"
+ },
+ "startCapId": {
+ "description": "The id of the extrusion start cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "endCapId": {
+ "description": "The id of the extrusion end cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "edgeCuts": {
+ "description": "Chamfers or fillets on this solid.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/EdgeCut"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "Sketch": {
+ "description": "A sketch is a collection of paths.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "on",
+ "paths",
+ "start"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the sketch (this will change when the engine's reference to it changes).",
+ "type": "string",
+ "format": "uuid"
+ },
+ "paths": {
+ "description": "The paths in the sketch.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Path"
+ }
+ },
+ "on": {
+ "description": "What the sketch is on (can be a plane or a face).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SketchSurface"
+ }
+ ]
+ },
+ "start": {
+ "description": "The starting path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/BasePath"
+ }
+ ]
+ },
+ "tags": {
+ "description": "Tag identifiers that have been declared in this sketch.",
+ "type": "object",
+ "additionalProperties": {
+ "$ref": "#/components/schemas/TagIdentifier"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "SketchSurface": {
+ "description": "A sketch type.",
+ "oneOf": [
+ {
+ "description": "A plane.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "origin",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "plane"
+ ]
+ },
+ "id": {
+ "description": "The id of the plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "$ref": "#/components/schemas/PlaneType"
+ },
+ "origin": {
+ "description": "Origin of the plane.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "xAxis": {
+ "description": "What should the plane’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the plane’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "A face.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "solid",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "face"
+ ]
+ },
+ "id": {
+ "description": "The id of the face.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The tag of the face.",
+ "type": "string"
+ },
+ "xAxis": {
+ "description": "What should the face’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the face’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "solid": {
+ "description": "The solid the face is on.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Solid"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ }
+ ]
+ },
+ "BasePath": {
+ "description": "A base path.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to"
+ ],
+ "properties": {
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ "TagIdentifier": {
+ "type": "object",
+ "required": [
+ "__meta",
+ "value"
+ ],
+ "properties": {
+ "value": {
+ "type": "string"
+ },
+ "info": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagEngineInfo"
+ }
+ ],
+ "nullable": true
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "EdgeCut": {
+ "description": "A fillet or a chamfer.",
+ "oneOf": [
+ {
+ "description": "A fillet.",
+ "type": "object",
+ "required": [
+ "edgeId",
+ "id",
+ "radius",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "fillet"
+ ]
+ },
+ "id": {
+ "description": "The id of the engine command that called this fillet.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "radius": {
+ "type": "number",
+ "format": "double"
+ },
+ "edgeId": {
+ "description": "The engine id of the edge to fillet.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ },
+ {
+ "description": "A chamfer.",
+ "type": "object",
+ "required": [
+ "edgeId",
+ "id",
+ "length",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "chamfer"
+ ]
+ },
+ "id": {
+ "description": "The id of the engine command that called this chamfer.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "length": {
+ "type": "number",
+ "format": "double"
+ },
+ "edgeId": {
+ "description": "The engine id of the edge to chamfer.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "FunctionExpression": {
+ "type": "object",
+ "required": [
+ "body",
+ "end",
+ "params",
+ "start"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "params": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Parameter"
+ }
+ },
+ "body": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "Parameter": {
+ "description": "Parameter of a KCL function.",
+ "type": "object",
+ "required": [
+ "identifier",
+ "optional"
+ ],
+ "properties": {
+ "identifier": {
+ "description": "The parameter's label or name.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Identifier"
+ }
+ ]
+ },
+ "optional": {
+ "description": "Is the parameter optional?",
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "Identifier": {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "Program": {
+ "description": "A KCL program top level, or function body.",
+ "type": "object",
+ "required": [
+ "body",
+ "end",
+ "start"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "body": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/BodyItem"
+ }
+ },
+ "nonCodeMeta": {
+ "$ref": "#/components/schemas/NonCodeMeta"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "BodyItem": {
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "items",
+ "path",
+ "raw_path",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ImportStatement"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "items": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ImportItem"
+ }
+ },
+ "path": {
+ "type": "string"
+ },
+ "raw_path": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "expression",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ExpressionStatement"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "expression": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "declarations",
+ "end",
+ "kind",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "VariableDeclaration"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "declarations": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/VariableDeclarator"
+ }
+ },
+ "visibility": {
+ "$ref": "#/components/schemas/ItemVisibility"
+ },
+ "kind": {
+ "$ref": "#/components/schemas/VariableKind"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "argument",
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ReturnStatement"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "argument": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "ImportItem": {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start"
+ ],
+ "properties": {
+ "name": {
+ "description": "Name of the item to import.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Identifier"
+ }
+ ]
+ },
+ "alias": {
+ "description": "Rename the item using an identifier after \"as\".",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Identifier"
+ }
+ ],
+ "nullable": true
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "Expr": {
+ "description": "An expression can be evaluated to yield a single KCL value.",
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "raw",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Literal"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "$ref": "#/components/schemas/LiteralValue"
+ },
+ "raw": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Identifier"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TagDeclarator"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "left",
+ "operator",
+ "right",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "BinaryExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "operator": {
+ "$ref": "#/components/schemas/BinaryOperator"
+ },
+ "left": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "right": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "body",
+ "end",
+ "params",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "FunctionExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "params": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Parameter"
+ }
+ },
+ "body": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "arguments",
+ "callee",
+ "end",
+ "optional",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "CallExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "callee": {
+ "$ref": "#/components/schemas/Identifier"
+ },
+ "arguments": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Expr"
+ }
+ },
+ "optional": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "body",
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "PipeExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "body": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Expr"
+ }
+ },
+ "nonCodeMeta": {
+ "$ref": "#/components/schemas/NonCodeMeta"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "PipeSubstitution"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "elements",
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ArrayExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "elements": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Expr"
+ }
+ },
+ "nonCodeMeta": {
+ "$ref": "#/components/schemas/NonCodeMeta"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "endElement",
+ "endInclusive",
+ "start",
+ "startElement",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ArrayRangeExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "startElement": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "endElement": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "endInclusive": {
+ "description": "Is the `end_element` included in the range?",
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "properties",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ObjectExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "properties": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ObjectProperty"
+ }
+ },
+ "nonCodeMeta": {
+ "$ref": "#/components/schemas/NonCodeMeta"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "computed",
+ "end",
+ "object",
+ "property",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "MemberExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "object": {
+ "$ref": "#/components/schemas/MemberObject"
+ },
+ "property": {
+ "$ref": "#/components/schemas/LiteralIdentifier"
+ },
+ "computed": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "argument",
+ "end",
+ "operator",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "UnaryExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "operator": {
+ "$ref": "#/components/schemas/UnaryOperator"
+ },
+ "argument": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "cond",
+ "else_ifs",
+ "end",
+ "final_else",
+ "start",
+ "then_val",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "IfExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "cond": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "then_val": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "else_ifs": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ElseIf"
+ }
+ },
+ "final_else": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "description": "KCL value for an optional parameter which was not given an argument. (remember, parameters are in the function declaration, arguments are in the function call/application).",
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "None"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ }
+ }
+ }
+ ]
+ },
+ "LiteralValue": {
+ "anyOf": [
+ {
+ "type": "integer",
+ "format": "int64"
+ },
+ {
+ "type": "number",
+ "format": "double"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "type": "boolean"
+ }
+ ]
+ },
+ "BinaryOperator": {
+ "oneOf": [
+ {
+ "description": "Add two numbers.",
+ "type": "string",
+ "enum": [
+ "+"
+ ]
+ },
+ {
+ "description": "Subtract two numbers.",
+ "type": "string",
+ "enum": [
+ "-"
+ ]
+ },
+ {
+ "description": "Multiply two numbers.",
+ "type": "string",
+ "enum": [
+ "*"
+ ]
+ },
+ {
+ "description": "Divide two numbers.",
+ "type": "string",
+ "enum": [
+ "/"
+ ]
+ },
+ {
+ "description": "Modulo two numbers.",
+ "type": "string",
+ "enum": [
+ "%"
+ ]
+ },
+ {
+ "description": "Raise a number to a power.",
+ "type": "string",
+ "enum": [
+ "^"
+ ]
+ },
+ {
+ "description": "Are two numbers equal?",
+ "type": "string",
+ "enum": [
+ "=="
+ ]
+ },
+ {
+ "description": "Are two numbers not equal?",
+ "type": "string",
+ "enum": [
+ "!="
+ ]
+ },
+ {
+ "description": "Is left greater than right",
+ "type": "string",
+ "enum": [
+ ">"
+ ]
+ },
+ {
+ "description": "Is left greater than or equal to right",
+ "type": "string",
+ "enum": [
+ ">="
+ ]
+ },
+ {
+ "description": "Is left less than right",
+ "type": "string",
+ "enum": [
+ "<"
+ ]
+ },
+ {
+ "description": "Is left less than or equal to right",
+ "type": "string",
+ "enum": [
+ "<="
+ ]
+ }
+ ]
+ },
+ "BinaryPart": {
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "raw",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Literal"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "$ref": "#/components/schemas/LiteralValue"
+ },
+ "raw": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Identifier"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "left",
+ "operator",
+ "right",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "BinaryExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "operator": {
+ "$ref": "#/components/schemas/BinaryOperator"
+ },
+ "left": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "right": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "arguments",
+ "callee",
+ "end",
+ "optional",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "CallExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "callee": {
+ "$ref": "#/components/schemas/Identifier"
+ },
+ "arguments": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Expr"
+ }
+ },
+ "optional": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "argument",
+ "end",
+ "operator",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "UnaryExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "operator": {
+ "$ref": "#/components/schemas/UnaryOperator"
+ },
+ "argument": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "computed",
+ "end",
+ "object",
+ "property",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "MemberExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "object": {
+ "$ref": "#/components/schemas/MemberObject"
+ },
+ "property": {
+ "$ref": "#/components/schemas/LiteralIdentifier"
+ },
+ "computed": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "cond",
+ "else_ifs",
+ "end",
+ "final_else",
+ "start",
+ "then_val",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "IfExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "cond": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "then_val": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "else_ifs": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ElseIf"
+ }
+ },
+ "final_else": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "UnaryOperator": {
+ "oneOf": [
+ {
+ "description": "Negate a number.",
+ "type": "string",
+ "enum": [
+ "-"
+ ]
+ },
+ {
+ "description": "Negate a boolean.",
+ "type": "string",
+ "enum": [
+ "!"
+ ]
+ }
+ ]
+ },
+ "MemberObject": {
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "computed",
+ "end",
+ "object",
+ "property",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "MemberExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "object": {
+ "$ref": "#/components/schemas/MemberObject"
+ },
+ "property": {
+ "$ref": "#/components/schemas/LiteralIdentifier"
+ },
+ "computed": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Identifier"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "LiteralIdentifier": {
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Identifier"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "raw",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Literal"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "$ref": "#/components/schemas/LiteralValue"
+ },
+ "raw": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "ElseIf": {
+ "type": "object",
+ "required": [
+ "cond",
+ "end",
+ "start",
+ "then_val"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "cond": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "then_val": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "NonCodeMeta": {
+ "type": "object",
+ "required": [
+ "nonCodeNodes",
+ "start"
+ ],
+ "properties": {
+ "nonCodeNodes": {
+ "type": "object",
+ "additionalProperties": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/NonCodeNode"
+ }
+ }
+ },
+ "start": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/NonCodeNode"
+ }
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "NonCodeNode": {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "value"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "$ref": "#/components/schemas/NonCodeValue"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "NonCodeValue": {
+ "oneOf": [
+ {
+ "description": "A shebang. This is a special type of comment that is at the top of the file. It looks like this: ```python,no_run #!/usr/bin/env python ```",
+ "type": "object",
+ "required": [
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "shebang"
+ ]
+ },
+ "value": {
+ "type": "string"
+ }
+ }
+ },
+ {
+ "description": "An inline comment. Here are examples: `1 + 1 // This is an inline comment`. `1 + 1 /* Here's another */`.",
+ "type": "object",
+ "required": [
+ "style",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "inlineComment"
+ ]
+ },
+ "value": {
+ "type": "string"
+ },
+ "style": {
+ "$ref": "#/components/schemas/CommentStyle"
+ }
+ }
+ },
+ {
+ "description": "A block comment. An example of this is the following: ```python,no_run /* This is a block comment */ 1 + 1 ``` Now this is important. The block comment is attached to the next line. This is always the case. Also the block comment doesn't have a new line above it. If it did it would be a `NewLineBlockComment`.",
+ "type": "object",
+ "required": [
+ "style",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "blockComment"
+ ]
+ },
+ "value": {
+ "type": "string"
+ },
+ "style": {
+ "$ref": "#/components/schemas/CommentStyle"
+ }
+ }
+ },
+ {
+ "description": "A block comment that has a new line above it. The user explicitly added a new line above the block comment.",
+ "type": "object",
+ "required": [
+ "style",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "newLineBlockComment"
+ ]
+ },
+ "value": {
+ "type": "string"
+ },
+ "style": {
+ "$ref": "#/components/schemas/CommentStyle"
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "newLine"
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "CommentStyle": {
+ "oneOf": [
+ {
+ "description": "Like // foo",
+ "type": "string",
+ "enum": [
+ "line"
+ ]
+ },
+ {
+ "description": "Like /* foo */",
+ "type": "string",
+ "enum": [
+ "block"
+ ]
+ }
+ ]
+ },
+ "ObjectProperty": {
+ "type": "object",
+ "required": [
+ "end",
+ "key",
+ "start",
+ "value"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "key": {
+ "$ref": "#/components/schemas/Identifier"
+ },
+ "value": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "VariableDeclarator": {
+ "type": "object",
+ "required": [
+ "end",
+ "id",
+ "init",
+ "start"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "id": {
+ "description": "The identifier of the variable.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Identifier"
+ }
+ ]
+ },
+ "init": {
+ "description": "The value of the variable.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Expr"
+ }
+ ]
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "ItemVisibility": {
+ "type": "string",
+ "enum": [
+ "default",
+ "export"
+ ]
+ },
+ "VariableKind": {
+ "oneOf": [
+ {
+ "description": "Declare a named constant.",
+ "type": "string",
+ "enum": [
+ "const"
+ ]
+ },
+ {
+ "description": "Declare a function.",
+ "type": "string",
+ "enum": [
+ "fn"
+ ]
+ }
+ ]
+ },
+ "ProgramMemory": {
+ "type": "object",
+ "required": [
+ "currentEnv",
+ "environments"
+ ],
+ "properties": {
+ "environments": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Environment"
+ }
+ },
+ "currentEnv": {
+ "$ref": "#/components/schemas/EnvironmentRef"
+ },
+ "return": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/KclValue"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ },
+ "Environment": {
+ "type": "object",
+ "required": [
+ "bindings"
+ ],
+ "properties": {
+ "bindings": {
+ "type": "object",
+ "additionalProperties": {
+ "$ref": "#/components/schemas/KclValue"
+ }
+ },
+ "parent": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/EnvironmentRef"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ },
+ "EnvironmentRef": {
+ "description": "An index pointing to an environment.",
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ }
+ }
+ },
+ "required": true
+ },
+ {
+ "name": "elem",
+ "type": "KclValue",
+ "schema": {
+ "$schema": "https://spec.openapis.org/oas/3.0/schema/2019-04-02#/definitions/Schema",
+ "title": "KclValue",
+ "description": "Any KCL value.",
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "UserVal"
+ ]
+ },
+ "value": {},
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TagIdentifier"
+ ]
+ },
+ "value": {
+ "type": "string"
+ },
+ "info": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagEngineInfo"
+ }
+ ],
+ "nullable": true
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TagDeclarator"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "description": "A plane.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "origin",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Plane"
+ ]
+ },
+ "id": {
+ "description": "The id of the plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "$ref": "#/components/schemas/PlaneType"
+ },
+ "origin": {
+ "description": "Origin of the plane.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "xAxis": {
+ "description": "What should the plane’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the plane’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "A face.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "solid",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Face"
+ ]
+ },
+ "id": {
+ "description": "The id of the face.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The tag of the face.",
+ "type": "string"
+ },
+ "xAxis": {
+ "description": "What should the face’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the face’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "solid": {
+ "description": "The solid the face is on.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Solid"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "An solid is a collection of extrude surfaces.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "height",
+ "id",
+ "sketch",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Solid"
+ ]
+ },
+ "id": {
+ "description": "The id of the solid.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The extrude surfaces.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "sketch": {
+ "description": "The sketch.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Sketch"
+ }
+ ]
+ },
+ "height": {
+ "description": "The height of the solid.",
+ "type": "number",
+ "format": "double"
+ },
+ "startCapId": {
+ "description": "The id of the extrusion start cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "endCapId": {
+ "description": "The id of the extrusion end cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "edgeCuts": {
+ "description": "Chamfers or fillets on this solid.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/EdgeCut"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Solids"
+ ]
+ },
+ "value": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Solid"
+ }
+ }
+ }
+ },
+ {
+ "description": "Data for an imported geometry.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ImportedGeometry"
+ ]
+ },
+ "id": {
+ "description": "The ID of the imported geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The original file paths.",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "expression",
+ "memory",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Function"
+ ]
+ },
+ "expression": {
+ "$ref": "#/components/schemas/FunctionExpression"
+ },
+ "memory": {
+ "$ref": "#/components/schemas/ProgramMemory"
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ }
+ ],
+ "definitions": {
+ "KclValue": {
+ "description": "Any KCL value.",
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "UserVal"
+ ]
+ },
+ "value": {},
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TagIdentifier"
+ ]
+ },
+ "value": {
+ "type": "string"
+ },
+ "info": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagEngineInfo"
+ }
+ ],
+ "nullable": true
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TagDeclarator"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "description": "A plane.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "origin",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Plane"
+ ]
+ },
+ "id": {
+ "description": "The id of the plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "$ref": "#/components/schemas/PlaneType"
+ },
+ "origin": {
+ "description": "Origin of the plane.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "xAxis": {
+ "description": "What should the plane’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the plane’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "A face.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "solid",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Face"
+ ]
+ },
+ "id": {
+ "description": "The id of the face.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The tag of the face.",
+ "type": "string"
+ },
+ "xAxis": {
+ "description": "What should the face’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the face’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "solid": {
+ "description": "The solid the face is on.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Solid"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "An solid is a collection of extrude surfaces.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "height",
+ "id",
+ "sketch",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Solid"
+ ]
+ },
+ "id": {
+ "description": "The id of the solid.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The extrude surfaces.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "sketch": {
+ "description": "The sketch.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Sketch"
+ }
+ ]
+ },
+ "height": {
+ "description": "The height of the solid.",
+ "type": "number",
+ "format": "double"
+ },
+ "startCapId": {
+ "description": "The id of the extrusion start cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "endCapId": {
+ "description": "The id of the extrusion end cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "edgeCuts": {
+ "description": "Chamfers or fillets on this solid.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/EdgeCut"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Solids"
+ ]
+ },
+ "value": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Solid"
+ }
+ }
+ }
+ },
+ {
+ "description": "Data for an imported geometry.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ImportedGeometry"
+ ]
+ },
+ "id": {
+ "description": "The ID of the imported geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The original file paths.",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "expression",
+ "memory",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Function"
+ ]
+ },
+ "expression": {
+ "$ref": "#/components/schemas/FunctionExpression"
+ },
+ "memory": {
+ "$ref": "#/components/schemas/ProgramMemory"
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ }
+ ]
+ },
+ "Metadata": {
+ "description": "Metadata.",
+ "type": "object",
+ "required": [
+ "sourceRange"
+ ],
+ "properties": {
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ "SourceRange": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "TagEngineInfo": {
+ "description": "Engine information for a tag.",
+ "type": "object",
+ "oneOf": [
+ {
+ "description": "The path the tag is on.",
+ "type": "object",
+ "required": [
+ "path"
+ ],
+ "properties": {
+ "path": {
+ "$ref": "#/components/schemas/Path"
+ }
+ },
+ "additionalProperties": false
+ },
+ {
+ "description": "The surface information for the tag.",
+ "type": "object",
+ "required": [
+ "surface"
+ ],
+ "properties": {
+ "surface": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "additionalProperties": false
+ }
+ ],
+ "required": [
+ "id",
+ "sketch"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the tagged object.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sketch": {
+ "description": "The sketch the tag is on.",
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ },
+ "Path": {
+ "description": "A path.",
+ "oneOf": [
+ {
+ "description": "A path that goes to a point.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ToPoint"
+ ]
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A arc that is tangential to the last path segment that goes to a point",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TangentialArcTo"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A arc that is tangential to the last path segment",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TangentialArc"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "a complete arc",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "radius",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Circle"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "radius": {
+ "description": "the arc's radius",
+ "type": "number",
+ "format": "double"
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A path that is horizontal.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type",
+ "x"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Horizontal"
+ ]
+ },
+ "x": {
+ "description": "The x coordinate.",
+ "type": "number",
+ "format": "double"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "An angled line to.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "AngledLineTo"
+ ]
+ },
+ "x": {
+ "description": "The x coordinate.",
+ "type": "number",
+ "format": "double",
+ "nullable": true
+ },
+ "y": {
+ "description": "The y coordinate.",
+ "type": "number",
+ "format": "double",
+ "nullable": true
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A base path.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Base"
+ ]
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A circular arc, not necessarily tangential to the current point.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "center",
+ "from",
+ "radius",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Arc"
+ ]
+ },
+ "center": {
+ "description": "Center of the circle that this arc is drawn on.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "radius": {
+ "description": "Radius of the circle that this arc is drawn on.",
+ "type": "number",
+ "format": "double"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "TagDeclarator": {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "value"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "GeoMeta": {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "id",
+ "sourceRange"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ "ExtrudeSurface": {
+ "description": "An extrude surface.",
+ "oneOf": [
+ {
+ "description": "An extrude plane.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "extrudePlane"
+ ]
+ },
+ "faceId": {
+ "description": "The face id for the extrude plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "An extruded arc.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "extrudeArc"
+ ]
+ },
+ "faceId": {
+ "description": "The face id for the extrude plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "chamfer"
+ ]
+ },
+ "faceId": {
+ "description": "The id for the chamfer surface.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "fillet"
+ ]
+ },
+ "faceId": {
+ "description": "The id for the fillet surface.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "PlaneType": {
+ "description": "Type for a plane.",
+ "oneOf": [
+ {
+ "type": "string",
+ "enum": [
+ "XY",
+ "XZ",
+ "YZ"
+ ]
+ },
+ {
+ "description": "A custom plane.",
+ "type": "string",
+ "enum": [
+ "Custom"
+ ]
+ }
+ ]
+ },
+ "Point3d": {
+ "type": "object",
+ "required": [
+ "x",
+ "y",
+ "z"
+ ],
+ "properties": {
+ "x": {
+ "type": "number",
+ "format": "double"
+ },
+ "y": {
+ "type": "number",
+ "format": "double"
+ },
+ "z": {
+ "type": "number",
+ "format": "double"
+ }
+ }
+ },
+ "Solid": {
+ "description": "An solid is a collection of extrude surfaces.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "height",
+ "id",
+ "sketch",
+ "value"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the solid.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The extrude surfaces.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "sketch": {
+ "description": "The sketch.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Sketch"
+ }
+ ]
+ },
+ "height": {
+ "description": "The height of the solid.",
+ "type": "number",
+ "format": "double"
+ },
+ "startCapId": {
+ "description": "The id of the extrusion start cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "endCapId": {
+ "description": "The id of the extrusion end cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "edgeCuts": {
+ "description": "Chamfers or fillets on this solid.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/EdgeCut"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "Sketch": {
+ "description": "A sketch is a collection of paths.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "on",
+ "paths",
+ "start"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the sketch (this will change when the engine's reference to it changes).",
+ "type": "string",
+ "format": "uuid"
+ },
+ "paths": {
+ "description": "The paths in the sketch.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Path"
+ }
+ },
+ "on": {
+ "description": "What the sketch is on (can be a plane or a face).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SketchSurface"
+ }
+ ]
+ },
+ "start": {
+ "description": "The starting path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/BasePath"
+ }
+ ]
+ },
+ "tags": {
+ "description": "Tag identifiers that have been declared in this sketch.",
+ "type": "object",
+ "additionalProperties": {
+ "$ref": "#/components/schemas/TagIdentifier"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "SketchSurface": {
+ "description": "A sketch type.",
+ "oneOf": [
+ {
+ "description": "A plane.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "origin",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "plane"
+ ]
+ },
+ "id": {
+ "description": "The id of the plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "$ref": "#/components/schemas/PlaneType"
+ },
+ "origin": {
+ "description": "Origin of the plane.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "xAxis": {
+ "description": "What should the plane’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the plane’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "A face.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "solid",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "face"
+ ]
+ },
+ "id": {
+ "description": "The id of the face.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The tag of the face.",
+ "type": "string"
+ },
+ "xAxis": {
+ "description": "What should the face’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the face’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "solid": {
+ "description": "The solid the face is on.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Solid"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ }
+ ]
+ },
+ "BasePath": {
+ "description": "A base path.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to"
+ ],
+ "properties": {
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ "TagIdentifier": {
+ "type": "object",
+ "required": [
+ "__meta",
+ "value"
+ ],
+ "properties": {
+ "value": {
+ "type": "string"
+ },
+ "info": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagEngineInfo"
+ }
+ ],
+ "nullable": true
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "EdgeCut": {
+ "description": "A fillet or a chamfer.",
+ "oneOf": [
+ {
+ "description": "A fillet.",
+ "type": "object",
+ "required": [
+ "edgeId",
+ "id",
+ "radius",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "fillet"
+ ]
+ },
+ "id": {
+ "description": "The id of the engine command that called this fillet.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "radius": {
+ "type": "number",
+ "format": "double"
+ },
+ "edgeId": {
+ "description": "The engine id of the edge to fillet.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ },
+ {
+ "description": "A chamfer.",
+ "type": "object",
+ "required": [
+ "edgeId",
+ "id",
+ "length",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "chamfer"
+ ]
+ },
+ "id": {
+ "description": "The id of the engine command that called this chamfer.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "length": {
+ "type": "number",
+ "format": "double"
+ },
+ "edgeId": {
+ "description": "The engine id of the edge to chamfer.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "FunctionExpression": {
+ "type": "object",
+ "required": [
+ "body",
+ "end",
+ "params",
+ "start"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "params": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Parameter"
+ }
+ },
+ "body": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "Parameter": {
+ "description": "Parameter of a KCL function.",
+ "type": "object",
+ "required": [
+ "identifier",
+ "optional"
+ ],
+ "properties": {
+ "identifier": {
+ "description": "The parameter's label or name.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Identifier"
+ }
+ ]
+ },
+ "optional": {
+ "description": "Is the parameter optional?",
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "Identifier": {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "Program": {
+ "description": "A KCL program top level, or function body.",
+ "type": "object",
+ "required": [
+ "body",
+ "end",
+ "start"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "body": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/BodyItem"
+ }
+ },
+ "nonCodeMeta": {
+ "$ref": "#/components/schemas/NonCodeMeta"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "BodyItem": {
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "items",
+ "path",
+ "raw_path",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ImportStatement"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "items": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ImportItem"
+ }
+ },
+ "path": {
+ "type": "string"
+ },
+ "raw_path": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "expression",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ExpressionStatement"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "expression": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "declarations",
+ "end",
+ "kind",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "VariableDeclaration"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "declarations": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/VariableDeclarator"
+ }
+ },
+ "visibility": {
+ "$ref": "#/components/schemas/ItemVisibility"
+ },
+ "kind": {
+ "$ref": "#/components/schemas/VariableKind"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "argument",
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ReturnStatement"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "argument": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "ImportItem": {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start"
+ ],
+ "properties": {
+ "name": {
+ "description": "Name of the item to import.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Identifier"
+ }
+ ]
+ },
+ "alias": {
+ "description": "Rename the item using an identifier after \"as\".",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Identifier"
+ }
+ ],
+ "nullable": true
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "Expr": {
+ "description": "An expression can be evaluated to yield a single KCL value.",
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "raw",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Literal"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "$ref": "#/components/schemas/LiteralValue"
+ },
+ "raw": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Identifier"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TagDeclarator"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "left",
+ "operator",
+ "right",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "BinaryExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "operator": {
+ "$ref": "#/components/schemas/BinaryOperator"
+ },
+ "left": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "right": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "body",
+ "end",
+ "params",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "FunctionExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "params": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Parameter"
+ }
+ },
+ "body": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "arguments",
+ "callee",
+ "end",
+ "optional",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "CallExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "callee": {
+ "$ref": "#/components/schemas/Identifier"
+ },
+ "arguments": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Expr"
+ }
+ },
+ "optional": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "body",
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "PipeExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "body": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Expr"
+ }
+ },
+ "nonCodeMeta": {
+ "$ref": "#/components/schemas/NonCodeMeta"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "PipeSubstitution"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "elements",
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ArrayExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "elements": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Expr"
+ }
+ },
+ "nonCodeMeta": {
+ "$ref": "#/components/schemas/NonCodeMeta"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "endElement",
+ "endInclusive",
+ "start",
+ "startElement",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ArrayRangeExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "startElement": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "endElement": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "endInclusive": {
+ "description": "Is the `end_element` included in the range?",
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "properties",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ObjectExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "properties": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ObjectProperty"
+ }
+ },
+ "nonCodeMeta": {
+ "$ref": "#/components/schemas/NonCodeMeta"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "computed",
+ "end",
+ "object",
+ "property",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "MemberExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "object": {
+ "$ref": "#/components/schemas/MemberObject"
+ },
+ "property": {
+ "$ref": "#/components/schemas/LiteralIdentifier"
+ },
+ "computed": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "argument",
+ "end",
+ "operator",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "UnaryExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "operator": {
+ "$ref": "#/components/schemas/UnaryOperator"
+ },
+ "argument": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "cond",
+ "else_ifs",
+ "end",
+ "final_else",
+ "start",
+ "then_val",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "IfExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "cond": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "then_val": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "else_ifs": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ElseIf"
+ }
+ },
+ "final_else": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "description": "KCL value for an optional parameter which was not given an argument. (remember, parameters are in the function declaration, arguments are in the function call/application).",
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "None"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ }
+ }
+ }
+ ]
+ },
+ "LiteralValue": {
+ "anyOf": [
+ {
+ "type": "integer",
+ "format": "int64"
+ },
+ {
+ "type": "number",
+ "format": "double"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "type": "boolean"
+ }
+ ]
+ },
+ "BinaryOperator": {
+ "oneOf": [
+ {
+ "description": "Add two numbers.",
+ "type": "string",
+ "enum": [
+ "+"
+ ]
+ },
+ {
+ "description": "Subtract two numbers.",
+ "type": "string",
+ "enum": [
+ "-"
+ ]
+ },
+ {
+ "description": "Multiply two numbers.",
+ "type": "string",
+ "enum": [
+ "*"
+ ]
+ },
+ {
+ "description": "Divide two numbers.",
+ "type": "string",
+ "enum": [
+ "/"
+ ]
+ },
+ {
+ "description": "Modulo two numbers.",
+ "type": "string",
+ "enum": [
+ "%"
+ ]
+ },
+ {
+ "description": "Raise a number to a power.",
+ "type": "string",
+ "enum": [
+ "^"
+ ]
+ },
+ {
+ "description": "Are two numbers equal?",
+ "type": "string",
+ "enum": [
+ "=="
+ ]
+ },
+ {
+ "description": "Are two numbers not equal?",
+ "type": "string",
+ "enum": [
+ "!="
+ ]
+ },
+ {
+ "description": "Is left greater than right",
+ "type": "string",
+ "enum": [
+ ">"
+ ]
+ },
+ {
+ "description": "Is left greater than or equal to right",
+ "type": "string",
+ "enum": [
+ ">="
+ ]
+ },
+ {
+ "description": "Is left less than right",
+ "type": "string",
+ "enum": [
+ "<"
+ ]
+ },
+ {
+ "description": "Is left less than or equal to right",
+ "type": "string",
+ "enum": [
+ "<="
+ ]
+ }
+ ]
+ },
+ "BinaryPart": {
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "raw",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Literal"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "$ref": "#/components/schemas/LiteralValue"
+ },
+ "raw": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Identifier"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "left",
+ "operator",
+ "right",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "BinaryExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "operator": {
+ "$ref": "#/components/schemas/BinaryOperator"
+ },
+ "left": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "right": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "arguments",
+ "callee",
+ "end",
+ "optional",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "CallExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "callee": {
+ "$ref": "#/components/schemas/Identifier"
+ },
+ "arguments": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Expr"
+ }
+ },
+ "optional": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "argument",
+ "end",
+ "operator",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "UnaryExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "operator": {
+ "$ref": "#/components/schemas/UnaryOperator"
+ },
+ "argument": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "computed",
+ "end",
+ "object",
+ "property",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "MemberExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "object": {
+ "$ref": "#/components/schemas/MemberObject"
+ },
+ "property": {
+ "$ref": "#/components/schemas/LiteralIdentifier"
+ },
+ "computed": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "cond",
+ "else_ifs",
+ "end",
+ "final_else",
+ "start",
+ "then_val",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "IfExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "cond": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "then_val": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "else_ifs": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ElseIf"
+ }
+ },
+ "final_else": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "UnaryOperator": {
+ "oneOf": [
+ {
+ "description": "Negate a number.",
+ "type": "string",
+ "enum": [
+ "-"
+ ]
+ },
+ {
+ "description": "Negate a boolean.",
+ "type": "string",
+ "enum": [
+ "!"
+ ]
+ }
+ ]
+ },
+ "MemberObject": {
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "computed",
+ "end",
+ "object",
+ "property",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "MemberExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "object": {
+ "$ref": "#/components/schemas/MemberObject"
+ },
+ "property": {
+ "$ref": "#/components/schemas/LiteralIdentifier"
+ },
+ "computed": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Identifier"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "LiteralIdentifier": {
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Identifier"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "raw",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Literal"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "$ref": "#/components/schemas/LiteralValue"
+ },
+ "raw": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "ElseIf": {
+ "type": "object",
+ "required": [
+ "cond",
+ "end",
+ "start",
+ "then_val"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "cond": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "then_val": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "NonCodeMeta": {
+ "type": "object",
+ "required": [
+ "nonCodeNodes",
+ "start"
+ ],
+ "properties": {
+ "nonCodeNodes": {
+ "type": "object",
+ "additionalProperties": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/NonCodeNode"
+ }
+ }
+ },
+ "start": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/NonCodeNode"
+ }
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "NonCodeNode": {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "value"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "$ref": "#/components/schemas/NonCodeValue"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "NonCodeValue": {
+ "oneOf": [
+ {
+ "description": "A shebang. This is a special type of comment that is at the top of the file. It looks like this: ```python,no_run #!/usr/bin/env python ```",
+ "type": "object",
+ "required": [
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "shebang"
+ ]
+ },
+ "value": {
+ "type": "string"
+ }
+ }
+ },
+ {
+ "description": "An inline comment. Here are examples: `1 + 1 // This is an inline comment`. `1 + 1 /* Here's another */`.",
+ "type": "object",
+ "required": [
+ "style",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "inlineComment"
+ ]
+ },
+ "value": {
+ "type": "string"
+ },
+ "style": {
+ "$ref": "#/components/schemas/CommentStyle"
+ }
+ }
+ },
+ {
+ "description": "A block comment. An example of this is the following: ```python,no_run /* This is a block comment */ 1 + 1 ``` Now this is important. The block comment is attached to the next line. This is always the case. Also the block comment doesn't have a new line above it. If it did it would be a `NewLineBlockComment`.",
+ "type": "object",
+ "required": [
+ "style",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "blockComment"
+ ]
+ },
+ "value": {
+ "type": "string"
+ },
+ "style": {
+ "$ref": "#/components/schemas/CommentStyle"
+ }
+ }
+ },
+ {
+ "description": "A block comment that has a new line above it. The user explicitly added a new line above the block comment.",
+ "type": "object",
+ "required": [
+ "style",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "newLineBlockComment"
+ ]
+ },
+ "value": {
+ "type": "string"
+ },
+ "style": {
+ "$ref": "#/components/schemas/CommentStyle"
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "newLine"
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "CommentStyle": {
+ "oneOf": [
+ {
+ "description": "Like // foo",
+ "type": "string",
+ "enum": [
+ "line"
+ ]
+ },
+ {
+ "description": "Like /* foo */",
+ "type": "string",
+ "enum": [
+ "block"
+ ]
+ }
+ ]
+ },
+ "ObjectProperty": {
+ "type": "object",
+ "required": [
+ "end",
+ "key",
+ "start",
+ "value"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "key": {
+ "$ref": "#/components/schemas/Identifier"
+ },
+ "value": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "VariableDeclarator": {
+ "type": "object",
+ "required": [
+ "end",
+ "id",
+ "init",
+ "start"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "id": {
+ "description": "The identifier of the variable.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Identifier"
+ }
+ ]
+ },
+ "init": {
+ "description": "The value of the variable.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Expr"
+ }
+ ]
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "ItemVisibility": {
+ "type": "string",
+ "enum": [
+ "default",
+ "export"
+ ]
+ },
+ "VariableKind": {
+ "oneOf": [
+ {
+ "description": "Declare a named constant.",
+ "type": "string",
+ "enum": [
+ "const"
+ ]
+ },
+ {
+ "description": "Declare a function.",
+ "type": "string",
+ "enum": [
+ "fn"
+ ]
+ }
+ ]
+ },
+ "ProgramMemory": {
+ "type": "object",
+ "required": [
+ "currentEnv",
+ "environments"
+ ],
+ "properties": {
+ "environments": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Environment"
+ }
+ },
+ "currentEnv": {
+ "$ref": "#/components/schemas/EnvironmentRef"
+ },
+ "return": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/KclValue"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ },
+ "Environment": {
+ "type": "object",
+ "required": [
+ "bindings"
+ ],
+ "properties": {
+ "bindings": {
+ "type": "object",
+ "additionalProperties": {
+ "$ref": "#/components/schemas/KclValue"
+ }
+ },
+ "parent": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/EnvironmentRef"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ },
+ "EnvironmentRef": {
+ "description": "An index pointing to an environment.",
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ }
+ }
+ },
+ "required": true
+ }
+ ],
+ "returnValue": {
+ "name": "",
+ "type": "KclValue",
+ "schema": {
+ "$schema": "https://spec.openapis.org/oas/3.0/schema/2019-04-02#/definitions/Schema",
+ "title": "KclValue",
+ "description": "Any KCL value.",
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "UserVal"
+ ]
+ },
+ "value": {},
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TagIdentifier"
+ ]
+ },
+ "value": {
+ "type": "string"
+ },
+ "info": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagEngineInfo"
+ }
+ ],
+ "nullable": true
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TagDeclarator"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "description": "A plane.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "origin",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Plane"
+ ]
+ },
+ "id": {
+ "description": "The id of the plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "$ref": "#/components/schemas/PlaneType"
+ },
+ "origin": {
+ "description": "Origin of the plane.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "xAxis": {
+ "description": "What should the plane’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the plane’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "A face.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "solid",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Face"
+ ]
+ },
+ "id": {
+ "description": "The id of the face.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The tag of the face.",
+ "type": "string"
+ },
+ "xAxis": {
+ "description": "What should the face’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the face’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "solid": {
+ "description": "The solid the face is on.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Solid"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "An solid is a collection of extrude surfaces.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "height",
+ "id",
+ "sketch",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Solid"
+ ]
+ },
+ "id": {
+ "description": "The id of the solid.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The extrude surfaces.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "sketch": {
+ "description": "The sketch.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Sketch"
+ }
+ ]
+ },
+ "height": {
+ "description": "The height of the solid.",
+ "type": "number",
+ "format": "double"
+ },
+ "startCapId": {
+ "description": "The id of the extrusion start cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "endCapId": {
+ "description": "The id of the extrusion end cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "edgeCuts": {
+ "description": "Chamfers or fillets on this solid.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/EdgeCut"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Solids"
+ ]
+ },
+ "value": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Solid"
+ }
+ }
+ }
+ },
+ {
+ "description": "Data for an imported geometry.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ImportedGeometry"
+ ]
+ },
+ "id": {
+ "description": "The ID of the imported geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The original file paths.",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "expression",
+ "memory",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Function"
+ ]
+ },
+ "expression": {
+ "$ref": "#/components/schemas/FunctionExpression"
+ },
+ "memory": {
+ "$ref": "#/components/schemas/ProgramMemory"
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ }
+ ],
+ "definitions": {
+ "Metadata": {
+ "description": "Metadata.",
+ "type": "object",
+ "required": [
+ "sourceRange"
+ ],
+ "properties": {
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ "SourceRange": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "TagEngineInfo": {
+ "description": "Engine information for a tag.",
+ "type": "object",
+ "oneOf": [
+ {
+ "description": "The path the tag is on.",
+ "type": "object",
+ "required": [
+ "path"
+ ],
+ "properties": {
+ "path": {
+ "$ref": "#/components/schemas/Path"
+ }
+ },
+ "additionalProperties": false
+ },
+ {
+ "description": "The surface information for the tag.",
+ "type": "object",
+ "required": [
+ "surface"
+ ],
+ "properties": {
+ "surface": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "additionalProperties": false
+ }
+ ],
+ "required": [
+ "id",
+ "sketch"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the tagged object.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sketch": {
+ "description": "The sketch the tag is on.",
+ "type": "string",
+ "format": "uuid"
+ }
+ }
+ },
+ "Path": {
+ "description": "A path.",
+ "oneOf": [
+ {
+ "description": "A path that goes to a point.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ToPoint"
+ ]
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A arc that is tangential to the last path segment that goes to a point",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TangentialArcTo"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A arc that is tangential to the last path segment",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TangentialArc"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "a complete arc",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "ccw",
+ "center",
+ "from",
+ "radius",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Circle"
+ ]
+ },
+ "center": {
+ "description": "the arc's center",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "radius": {
+ "description": "the arc's radius",
+ "type": "number",
+ "format": "double"
+ },
+ "ccw": {
+ "description": "arc's direction",
+ "type": "boolean"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A path that is horizontal.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type",
+ "x"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Horizontal"
+ ]
+ },
+ "x": {
+ "description": "The x coordinate.",
+ "type": "number",
+ "format": "double"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "An angled line to.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "AngledLineTo"
+ ]
+ },
+ "x": {
+ "description": "The x coordinate.",
+ "type": "number",
+ "format": "double",
+ "nullable": true
+ },
+ "y": {
+ "description": "The y coordinate.",
+ "type": "number",
+ "format": "double",
+ "nullable": true
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A base path.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Base"
+ ]
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "A circular arc, not necessarily tangential to the current point.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "center",
+ "from",
+ "radius",
+ "to",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Arc"
+ ]
+ },
+ "center": {
+ "description": "Center of the circle that this arc is drawn on.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "radius": {
+ "description": "Radius of the circle that this arc is drawn on.",
+ "type": "number",
+ "format": "double"
+ },
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "TagDeclarator": {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "value"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "GeoMeta": {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "id",
+ "sourceRange"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ "ExtrudeSurface": {
+ "description": "An extrude surface.",
+ "oneOf": [
+ {
+ "description": "An extrude plane.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "extrudePlane"
+ ]
+ },
+ "faceId": {
+ "description": "The face id for the extrude plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "An extruded arc.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "extrudeArc"
+ ]
+ },
+ "faceId": {
+ "description": "The face id for the extrude plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "chamfer"
+ ]
+ },
+ "faceId": {
+ "description": "The id for the chamfer surface.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ },
+ {
+ "description": "Geometry metadata.",
+ "type": "object",
+ "required": [
+ "faceId",
+ "id",
+ "sourceRange",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "fillet"
+ ]
+ },
+ "faceId": {
+ "description": "The id for the fillet surface.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "description": "The tag.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "id": {
+ "description": "The id of the geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "sourceRange": {
+ "description": "The source range.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SourceRange"
+ }
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "PlaneType": {
+ "description": "Type for a plane.",
+ "oneOf": [
+ {
+ "type": "string",
+ "enum": [
+ "XY",
+ "XZ",
+ "YZ"
+ ]
+ },
+ {
+ "description": "A custom plane.",
+ "type": "string",
+ "enum": [
+ "Custom"
+ ]
+ }
+ ]
+ },
+ "Point3d": {
+ "type": "object",
+ "required": [
+ "x",
+ "y",
+ "z"
+ ],
+ "properties": {
+ "x": {
+ "type": "number",
+ "format": "double"
+ },
+ "y": {
+ "type": "number",
+ "format": "double"
+ },
+ "z": {
+ "type": "number",
+ "format": "double"
+ }
+ }
+ },
+ "Solid": {
+ "description": "An solid is a collection of extrude surfaces.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "height",
+ "id",
+ "sketch",
+ "value"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the solid.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The extrude surfaces.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "sketch": {
+ "description": "The sketch.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Sketch"
+ }
+ ]
+ },
+ "height": {
+ "description": "The height of the solid.",
+ "type": "number",
+ "format": "double"
+ },
+ "startCapId": {
+ "description": "The id of the extrusion start cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "endCapId": {
+ "description": "The id of the extrusion end cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "edgeCuts": {
+ "description": "Chamfers or fillets on this solid.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/EdgeCut"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "Sketch": {
+ "description": "A sketch is a collection of paths.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "on",
+ "paths",
+ "start"
+ ],
+ "properties": {
+ "id": {
+ "description": "The id of the sketch (this will change when the engine's reference to it changes).",
+ "type": "string",
+ "format": "uuid"
+ },
+ "paths": {
+ "description": "The paths in the sketch.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Path"
+ }
+ },
+ "on": {
+ "description": "What the sketch is on (can be a plane or a face).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/SketchSurface"
+ }
+ ]
+ },
+ "start": {
+ "description": "The starting path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/BasePath"
+ }
+ ]
+ },
+ "tags": {
+ "description": "Tag identifiers that have been declared in this sketch.",
+ "type": "object",
+ "additionalProperties": {
+ "$ref": "#/components/schemas/TagIdentifier"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "SketchSurface": {
+ "description": "A sketch type.",
+ "oneOf": [
+ {
+ "description": "A plane.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "origin",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "plane"
+ ]
+ },
+ "id": {
+ "description": "The id of the plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "$ref": "#/components/schemas/PlaneType"
+ },
+ "origin": {
+ "description": "Origin of the plane.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "xAxis": {
+ "description": "What should the plane’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the plane’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "A face.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "solid",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "face"
+ ]
+ },
+ "id": {
+ "description": "The id of the face.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The tag of the face.",
+ "type": "string"
+ },
+ "xAxis": {
+ "description": "What should the face’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the face’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "solid": {
+ "description": "The solid the face is on.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Solid"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ }
+ ]
+ },
+ "BasePath": {
+ "description": "A base path.",
+ "type": "object",
+ "required": [
+ "__geoMeta",
+ "from",
+ "to"
+ ],
+ "properties": {
+ "from": {
+ "description": "The from point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "to": {
+ "description": "The to point.",
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "maxItems": 2,
+ "minItems": 2
+ },
+ "tag": {
+ "description": "The tag of the path.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ },
+ "__geoMeta": {
+ "description": "Metadata.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/GeoMeta"
+ }
+ ]
+ }
+ }
+ },
+ "TagIdentifier": {
+ "type": "object",
+ "required": [
+ "__meta",
+ "value"
+ ],
+ "properties": {
+ "value": {
+ "type": "string"
+ },
+ "info": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagEngineInfo"
+ }
+ ],
+ "nullable": true
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ "EdgeCut": {
+ "description": "A fillet or a chamfer.",
+ "oneOf": [
+ {
+ "description": "A fillet.",
+ "type": "object",
+ "required": [
+ "edgeId",
+ "id",
+ "radius",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "fillet"
+ ]
+ },
+ "id": {
+ "description": "The id of the engine command that called this fillet.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "radius": {
+ "type": "number",
+ "format": "double"
+ },
+ "edgeId": {
+ "description": "The engine id of the edge to fillet.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ },
+ {
+ "description": "A chamfer.",
+ "type": "object",
+ "required": [
+ "edgeId",
+ "id",
+ "length",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "chamfer"
+ ]
+ },
+ "id": {
+ "description": "The id of the engine command that called this chamfer.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "length": {
+ "type": "number",
+ "format": "double"
+ },
+ "edgeId": {
+ "description": "The engine id of the edge to chamfer.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "tag": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagDeclarator"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "FunctionExpression": {
+ "type": "object",
+ "required": [
+ "body",
+ "end",
+ "params",
+ "start"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "params": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Parameter"
+ }
+ },
+ "body": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "Parameter": {
+ "description": "Parameter of a KCL function.",
+ "type": "object",
+ "required": [
+ "identifier",
+ "optional"
+ ],
+ "properties": {
+ "identifier": {
+ "description": "The parameter's label or name.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Identifier"
+ }
+ ]
+ },
+ "optional": {
+ "description": "Is the parameter optional?",
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "Identifier": {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "Program": {
+ "description": "A KCL program top level, or function body.",
+ "type": "object",
+ "required": [
+ "body",
+ "end",
+ "start"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "body": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/BodyItem"
+ }
+ },
+ "nonCodeMeta": {
+ "$ref": "#/components/schemas/NonCodeMeta"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "BodyItem": {
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "items",
+ "path",
+ "raw_path",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ImportStatement"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "items": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ImportItem"
+ }
+ },
+ "path": {
+ "type": "string"
+ },
+ "raw_path": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "expression",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ExpressionStatement"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "expression": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "declarations",
+ "end",
+ "kind",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "VariableDeclaration"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "declarations": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/VariableDeclarator"
+ }
+ },
+ "visibility": {
+ "$ref": "#/components/schemas/ItemVisibility"
+ },
+ "kind": {
+ "$ref": "#/components/schemas/VariableKind"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "argument",
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ReturnStatement"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "argument": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "ImportItem": {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start"
+ ],
+ "properties": {
+ "name": {
+ "description": "Name of the item to import.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Identifier"
+ }
+ ]
+ },
+ "alias": {
+ "description": "Rename the item using an identifier after \"as\".",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Identifier"
+ }
+ ],
+ "nullable": true
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "Expr": {
+ "description": "An expression can be evaluated to yield a single KCL value.",
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "raw",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Literal"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "$ref": "#/components/schemas/LiteralValue"
+ },
+ "raw": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Identifier"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TagDeclarator"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "left",
+ "operator",
+ "right",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "BinaryExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "operator": {
+ "$ref": "#/components/schemas/BinaryOperator"
+ },
+ "left": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "right": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "body",
+ "end",
+ "params",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "FunctionExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "params": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Parameter"
+ }
+ },
+ "body": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "arguments",
+ "callee",
+ "end",
+ "optional",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "CallExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "callee": {
+ "$ref": "#/components/schemas/Identifier"
+ },
+ "arguments": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Expr"
+ }
+ },
+ "optional": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "body",
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "PipeExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "body": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Expr"
+ }
+ },
+ "nonCodeMeta": {
+ "$ref": "#/components/schemas/NonCodeMeta"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "PipeSubstitution"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "elements",
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ArrayExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "elements": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Expr"
+ }
+ },
+ "nonCodeMeta": {
+ "$ref": "#/components/schemas/NonCodeMeta"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "endElement",
+ "endInclusive",
+ "start",
+ "startElement",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ArrayRangeExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "startElement": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "endElement": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "endInclusive": {
+ "description": "Is the `end_element` included in the range?",
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "properties",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ObjectExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "properties": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ObjectProperty"
+ }
+ },
+ "nonCodeMeta": {
+ "$ref": "#/components/schemas/NonCodeMeta"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "computed",
+ "end",
+ "object",
+ "property",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "MemberExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "object": {
+ "$ref": "#/components/schemas/MemberObject"
+ },
+ "property": {
+ "$ref": "#/components/schemas/LiteralIdentifier"
+ },
+ "computed": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "argument",
+ "end",
+ "operator",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "UnaryExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "operator": {
+ "$ref": "#/components/schemas/UnaryOperator"
+ },
+ "argument": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "cond",
+ "else_ifs",
+ "end",
+ "final_else",
+ "start",
+ "then_val",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "IfExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "cond": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "then_val": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "else_ifs": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ElseIf"
+ }
+ },
+ "final_else": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "description": "KCL value for an optional parameter which was not given an argument. (remember, parameters are in the function declaration, arguments are in the function call/application).",
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "None"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ }
+ }
+ }
+ ]
+ },
+ "LiteralValue": {
+ "anyOf": [
+ {
+ "type": "integer",
+ "format": "int64"
+ },
+ {
+ "type": "number",
+ "format": "double"
+ },
+ {
+ "type": "string"
+ },
+ {
+ "type": "boolean"
+ }
+ ]
+ },
+ "BinaryOperator": {
+ "oneOf": [
+ {
+ "description": "Add two numbers.",
+ "type": "string",
+ "enum": [
+ "+"
+ ]
+ },
+ {
+ "description": "Subtract two numbers.",
+ "type": "string",
+ "enum": [
+ "-"
+ ]
+ },
+ {
+ "description": "Multiply two numbers.",
+ "type": "string",
+ "enum": [
+ "*"
+ ]
+ },
+ {
+ "description": "Divide two numbers.",
+ "type": "string",
+ "enum": [
+ "/"
+ ]
+ },
+ {
+ "description": "Modulo two numbers.",
+ "type": "string",
+ "enum": [
+ "%"
+ ]
+ },
+ {
+ "description": "Raise a number to a power.",
+ "type": "string",
+ "enum": [
+ "^"
+ ]
+ },
+ {
+ "description": "Are two numbers equal?",
+ "type": "string",
+ "enum": [
+ "=="
+ ]
+ },
+ {
+ "description": "Are two numbers not equal?",
+ "type": "string",
+ "enum": [
+ "!="
+ ]
+ },
+ {
+ "description": "Is left greater than right",
+ "type": "string",
+ "enum": [
+ ">"
+ ]
+ },
+ {
+ "description": "Is left greater than or equal to right",
+ "type": "string",
+ "enum": [
+ ">="
+ ]
+ },
+ {
+ "description": "Is left less than right",
+ "type": "string",
+ "enum": [
+ "<"
+ ]
+ },
+ {
+ "description": "Is left less than or equal to right",
+ "type": "string",
+ "enum": [
+ "<="
+ ]
+ }
+ ]
+ },
+ "BinaryPart": {
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "raw",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Literal"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "$ref": "#/components/schemas/LiteralValue"
+ },
+ "raw": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Identifier"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "left",
+ "operator",
+ "right",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "BinaryExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "operator": {
+ "$ref": "#/components/schemas/BinaryOperator"
+ },
+ "left": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "right": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "arguments",
+ "callee",
+ "end",
+ "optional",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "CallExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "callee": {
+ "$ref": "#/components/schemas/Identifier"
+ },
+ "arguments": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Expr"
+ }
+ },
+ "optional": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "argument",
+ "end",
+ "operator",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "UnaryExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "operator": {
+ "$ref": "#/components/schemas/UnaryOperator"
+ },
+ "argument": {
+ "$ref": "#/components/schemas/BinaryPart"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "computed",
+ "end",
+ "object",
+ "property",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "MemberExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "object": {
+ "$ref": "#/components/schemas/MemberObject"
+ },
+ "property": {
+ "$ref": "#/components/schemas/LiteralIdentifier"
+ },
+ "computed": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "cond",
+ "else_ifs",
+ "end",
+ "final_else",
+ "start",
+ "then_val",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "IfExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "cond": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "then_val": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "else_ifs": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ElseIf"
+ }
+ },
+ "final_else": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "UnaryOperator": {
+ "oneOf": [
+ {
+ "description": "Negate a number.",
+ "type": "string",
+ "enum": [
+ "-"
+ ]
+ },
+ {
+ "description": "Negate a boolean.",
+ "type": "string",
+ "enum": [
+ "!"
+ ]
+ }
+ ]
+ },
+ "MemberObject": {
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "computed",
+ "end",
+ "object",
+ "property",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "MemberExpression"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "object": {
+ "$ref": "#/components/schemas/MemberObject"
+ },
+ "property": {
+ "$ref": "#/components/schemas/LiteralIdentifier"
+ },
+ "computed": {
+ "type": "boolean"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Identifier"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "LiteralIdentifier": {
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "name",
+ "start",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Identifier"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "name": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "raw",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Literal"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "$ref": "#/components/schemas/LiteralValue"
+ },
+ "raw": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ }
+ ]
+ },
+ "ElseIf": {
+ "type": "object",
+ "required": [
+ "cond",
+ "end",
+ "start",
+ "then_val"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "cond": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "then_val": {
+ "$ref": "#/components/schemas/Program"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "NonCodeMeta": {
+ "type": "object",
+ "required": [
+ "nonCodeNodes",
+ "start"
+ ],
+ "properties": {
+ "nonCodeNodes": {
+ "type": "object",
+ "additionalProperties": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/NonCodeNode"
+ }
+ }
+ },
+ "start": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/NonCodeNode"
+ }
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "NonCodeNode": {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "value"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "$ref": "#/components/schemas/NonCodeValue"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "NonCodeValue": {
+ "oneOf": [
+ {
+ "description": "A shebang. This is a special type of comment that is at the top of the file. It looks like this: ```python,no_run #!/usr/bin/env python ```",
+ "type": "object",
+ "required": [
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "shebang"
+ ]
+ },
+ "value": {
+ "type": "string"
+ }
+ }
+ },
+ {
+ "description": "An inline comment. Here are examples: `1 + 1 // This is an inline comment`. `1 + 1 /* Here's another */`.",
+ "type": "object",
+ "required": [
+ "style",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "inlineComment"
+ ]
+ },
+ "value": {
+ "type": "string"
+ },
+ "style": {
+ "$ref": "#/components/schemas/CommentStyle"
+ }
+ }
+ },
+ {
+ "description": "A block comment. An example of this is the following: ```python,no_run /* This is a block comment */ 1 + 1 ``` Now this is important. The block comment is attached to the next line. This is always the case. Also the block comment doesn't have a new line above it. If it did it would be a `NewLineBlockComment`.",
+ "type": "object",
+ "required": [
+ "style",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "blockComment"
+ ]
+ },
+ "value": {
+ "type": "string"
+ },
+ "style": {
+ "$ref": "#/components/schemas/CommentStyle"
+ }
+ }
+ },
+ {
+ "description": "A block comment that has a new line above it. The user explicitly added a new line above the block comment.",
+ "type": "object",
+ "required": [
+ "style",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "newLineBlockComment"
+ ]
+ },
+ "value": {
+ "type": "string"
+ },
+ "style": {
+ "$ref": "#/components/schemas/CommentStyle"
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "newLine"
+ ]
+ }
+ }
+ }
+ ]
+ },
+ "CommentStyle": {
+ "oneOf": [
+ {
+ "description": "Like // foo",
+ "type": "string",
+ "enum": [
+ "line"
+ ]
+ },
+ {
+ "description": "Like /* foo */",
+ "type": "string",
+ "enum": [
+ "block"
+ ]
+ }
+ ]
+ },
+ "ObjectProperty": {
+ "type": "object",
+ "required": [
+ "end",
+ "key",
+ "start",
+ "value"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "key": {
+ "$ref": "#/components/schemas/Identifier"
+ },
+ "value": {
+ "$ref": "#/components/schemas/Expr"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "VariableDeclarator": {
+ "type": "object",
+ "required": [
+ "end",
+ "id",
+ "init",
+ "start"
+ ],
+ "properties": {
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "id": {
+ "description": "The identifier of the variable.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Identifier"
+ }
+ ]
+ },
+ "init": {
+ "description": "The value of the variable.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Expr"
+ }
+ ]
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ "ItemVisibility": {
+ "type": "string",
+ "enum": [
+ "default",
+ "export"
+ ]
+ },
+ "VariableKind": {
+ "oneOf": [
+ {
+ "description": "Declare a named constant.",
+ "type": "string",
+ "enum": [
+ "const"
+ ]
+ },
+ {
+ "description": "Declare a function.",
+ "type": "string",
+ "enum": [
+ "fn"
+ ]
+ }
+ ]
+ },
+ "ProgramMemory": {
+ "type": "object",
+ "required": [
+ "currentEnv",
+ "environments"
+ ],
+ "properties": {
+ "environments": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Environment"
+ }
+ },
+ "currentEnv": {
+ "$ref": "#/components/schemas/EnvironmentRef"
+ },
+ "return": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/KclValue"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ },
+ "Environment": {
+ "type": "object",
+ "required": [
+ "bindings"
+ ],
+ "properties": {
+ "bindings": {
+ "type": "object",
+ "additionalProperties": {
+ "$ref": "#/components/schemas/KclValue"
+ }
+ },
+ "parent": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/EnvironmentRef"
+ }
+ ],
+ "nullable": true
+ }
+ }
+ },
+ "KclValue": {
+ "description": "Any KCL value.",
+ "oneOf": [
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "UserVal"
+ ]
+ },
+ "value": {},
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TagIdentifier"
+ ]
+ },
+ "value": {
+ "type": "string"
+ },
+ "info": {
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/TagEngineInfo"
+ }
+ ],
+ "nullable": true
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "end",
+ "start",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "TagDeclarator"
+ ]
+ },
+ "start": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "end": {
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ },
+ "value": {
+ "type": "string"
+ },
+ "digest": {
+ "type": "array",
+ "items": {
+ "type": "integer",
+ "format": "uint8",
+ "minimum": 0.0
+ },
+ "maxItems": 32,
+ "minItems": 32,
+ "nullable": true
+ }
+ }
+ },
+ {
+ "description": "A plane.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "origin",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Plane"
+ ]
+ },
+ "id": {
+ "description": "The id of the plane.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "$ref": "#/components/schemas/PlaneType"
+ },
+ "origin": {
+ "description": "Origin of the plane.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "xAxis": {
+ "description": "What should the plane’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the plane’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "A face.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "solid",
+ "type",
+ "value",
+ "xAxis",
+ "yAxis",
+ "zAxis"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Face"
+ ]
+ },
+ "id": {
+ "description": "The id of the face.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The tag of the face.",
+ "type": "string"
+ },
+ "xAxis": {
+ "description": "What should the face’s X axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "yAxis": {
+ "description": "What should the face’s Y axis be?",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "zAxis": {
+ "description": "The z-axis (normal).",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Point3d"
+ }
+ ]
+ },
+ "solid": {
+ "description": "The solid the face is on.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Solid"
+ }
+ ]
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "description": "An solid is a collection of extrude surfaces.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "height",
+ "id",
+ "sketch",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Solid"
+ ]
+ },
+ "id": {
+ "description": "The id of the solid.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The extrude surfaces.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/ExtrudeSurface"
+ }
+ },
+ "sketch": {
+ "description": "The sketch.",
+ "allOf": [
+ {
+ "$ref": "#/components/schemas/Sketch"
+ }
+ ]
+ },
+ "height": {
+ "description": "The height of the solid.",
+ "type": "number",
+ "format": "double"
+ },
+ "startCapId": {
+ "description": "The id of the extrusion start cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "endCapId": {
+ "description": "The id of the extrusion end cap",
+ "type": "string",
+ "format": "uuid",
+ "nullable": true
+ },
+ "edgeCuts": {
+ "description": "Chamfers or fillets on this solid.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/EdgeCut"
+ }
+ },
+ "__meta": {
+ "description": "Metadata.",
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Solids"
+ ]
+ },
+ "value": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Solid"
+ }
+ }
+ }
+ },
+ {
+ "description": "Data for an imported geometry.",
+ "type": "object",
+ "required": [
+ "__meta",
+ "id",
+ "type",
+ "value"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "ImportedGeometry"
+ ]
+ },
+ "id": {
+ "description": "The ID of the imported geometry.",
+ "type": "string",
+ "format": "uuid"
+ },
+ "value": {
+ "description": "The original file paths.",
+ "type": "array",
+ "items": {
+ "type": "string"
+ }
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ },
+ {
+ "type": "object",
+ "required": [
+ "__meta",
+ "expression",
+ "memory",
+ "type"
+ ],
+ "properties": {
+ "type": {
+ "type": "string",
+ "enum": [
+ "Function"
+ ]
+ },
+ "expression": {
+ "$ref": "#/components/schemas/FunctionExpression"
+ },
+ "memory": {
+ "$ref": "#/components/schemas/ProgramMemory"
+ },
+ "__meta": {
+ "type": "array",
+ "items": {
+ "$ref": "#/components/schemas/Metadata"
+ }
+ }
+ }
+ }
+ ]
+ },
+ "EnvironmentRef": {
+ "description": "An index pointing to an environment.",
+ "type": "integer",
+ "format": "uint",
+ "minimum": 0.0
+ }
+ }
+ },
+ "required": true
+ },
+ "unpublished": false,
+ "deprecated": false,
+ "examples": [
+ "arr = [1, 2, 3]\nnew_arr = push(arr, 4)\nassertEqual(new_arr[3], 4, 0.00001, \"4 was added to the end of the array\")"
+ ]
+ },
{
"name": "reduce",
"summary": "Take a starting value. Then, for each element of an array, calculate the next value,",
diff --git a/docs/kcl/types/PolygonData.md b/docs/kcl/types/PolygonData.md
new file mode 100644
index 000000000..1f7a05429
--- /dev/null
+++ b/docs/kcl/types/PolygonData.md
@@ -0,0 +1,24 @@
+---
+title: "PolygonData"
+excerpt: "Data for drawing a polygon"
+layout: manual
+---
+
+Data for drawing a polygon
+
+**Type:** `object`
+
+
+
+
+
+## Properties
+
+| Property | Type | Description | Required |
+|----------|------|-------------|----------|
+| `radius` |`number`| The radius of the polygon | No |
+| `numSides` |`integer`| The number of sides in the polygon | No |
+| `center` |`[number, number]`| The center point of the polygon | No |
+| `inscribed` |`boolean`| Whether the polygon is inscribed (true) or circumscribed (false) about a circle with the specified radius | No |
+
+
diff --git a/e2e/playwright/snapshot-tests.spec.ts-snapshots/Client-side-scene-scale-should-match-engine-scale-Millimeter-scale-1-Google-Chrome-win32.png b/e2e/playwright/snapshot-tests.spec.ts-snapshots/Client-side-scene-scale-should-match-engine-scale-Millimeter-scale-1-Google-Chrome-win32.png
index d072cf76e..0c5da89c1 100644
Binary files a/e2e/playwright/snapshot-tests.spec.ts-snapshots/Client-side-scene-scale-should-match-engine-scale-Millimeter-scale-1-Google-Chrome-win32.png and b/e2e/playwright/snapshot-tests.spec.ts-snapshots/Client-side-scene-scale-should-match-engine-scale-Millimeter-scale-1-Google-Chrome-win32.png differ
diff --git a/e2e/playwright/snapshot-tests.spec.ts-snapshots/Client-side-scene-scale-should-match-engine-scale-Millimeter-scale-2-Google-Chrome-win32.png b/e2e/playwright/snapshot-tests.spec.ts-snapshots/Client-side-scene-scale-should-match-engine-scale-Millimeter-scale-2-Google-Chrome-win32.png
index 0a291d1b7..ab82fb0aa 100644
Binary files a/e2e/playwright/snapshot-tests.spec.ts-snapshots/Client-side-scene-scale-should-match-engine-scale-Millimeter-scale-2-Google-Chrome-win32.png and b/e2e/playwright/snapshot-tests.spec.ts-snapshots/Client-side-scene-scale-should-match-engine-scale-Millimeter-scale-2-Google-Chrome-win32.png differ
diff --git a/e2e/playwright/snapshot-tests.spec.ts-snapshots/Sketch-on-face-with-none-z-up-1-Google-Chrome-win32.png b/e2e/playwright/snapshot-tests.spec.ts-snapshots/Sketch-on-face-with-none-z-up-1-Google-Chrome-win32.png
index abd80123b..ba30cd7e1 100644
Binary files a/e2e/playwright/snapshot-tests.spec.ts-snapshots/Sketch-on-face-with-none-z-up-1-Google-Chrome-win32.png and b/e2e/playwright/snapshot-tests.spec.ts-snapshots/Sketch-on-face-with-none-z-up-1-Google-Chrome-win32.png differ
diff --git a/src/Toolbar.tsx b/src/Toolbar.tsx
index 540bc9647..35ec85df6 100644
--- a/src/Toolbar.tsx
+++ b/src/Toolbar.tsx
@@ -100,6 +100,11 @@ export function Toolbar({
function resolveItemConfig(
maybeIconConfig: ToolbarItem
): ToolbarItemResolved {
+ const isDisabled =
+ disableAllButtons ||
+ maybeIconConfig.status !== 'available' ||
+ maybeIconConfig.disabled?.(state) === true
+
return {
...maybeIconConfig,
title:
@@ -113,10 +118,11 @@ export function Toolbar({
typeof maybeIconConfig.hotkey === 'string'
? maybeIconConfig.hotkey
: maybeIconConfig.hotkey?.(state),
- disabled:
- disableAllButtons ||
- maybeIconConfig.status !== 'available' ||
- maybeIconConfig.disabled?.(state) === true,
+ disabled: isDisabled,
+ disabledReason:
+ typeof maybeIconConfig.disabledReason === 'function'
+ ? maybeIconConfig.disabledReason(state)
+ : maybeIconConfig.disabledReason,
disableHotkey: maybeIconConfig.disableHotkey?.(state),
status: maybeIconConfig.status,
}
@@ -273,6 +279,8 @@ const ToolbarItemTooltip = memo(function ToolbarItemContents({
itemConfig: ToolbarItemResolved
configCallbackProps: ToolbarItemCallbackProps
}) {
+ const { state } = useModelingContext()
+
useHotkeys(
itemConfig.hotkey || '',
() => {
@@ -336,6 +344,17 @@ const ToolbarItemTooltip = memo(function ToolbarItemContents({
)}
{itemConfig.description}
+ {/* Add disabled reason if item is disabled */}
+ {itemConfig.disabled && itemConfig.disabledReason && (
+ <>
+
+
+ {typeof itemConfig.disabledReason === 'function'
+ ? itemConfig.disabledReason(state)
+ : itemConfig.disabledReason}
+
+
+ )}
{itemConfig.links.length > 0 && (
<>
diff --git a/src/components/ModelingSidebar/ModelingPanes/MemoryPane.tsx b/src/components/ModelingSidebar/ModelingPanes/MemoryPane.tsx
index bec009240..af73f2839 100644
--- a/src/components/ModelingSidebar/ModelingPanes/MemoryPane.tsx
+++ b/src/components/ModelingSidebar/ModelingPanes/MemoryPane.tsx
@@ -88,8 +88,12 @@ export const MemoryPane = () => {
export const processMemory = (programMemory: ProgramMemory) => {
const processedMemory: any = {}
for (const [key, val] of programMemory?.visibleEntries()) {
- if (typeof val.value !== 'function') {
- const sg = sketchFromKclValue(val, null)
+ if (
+ (val.type === 'UserVal' && val.value.type === 'Sketch') ||
+ // @ts-ignore
+ (val.type !== 'Function' && val.type !== 'UserVal')
+ ) {
+ const sg = sketchFromKclValue(val, key)
if (val.type === 'Solid') {
processedMemory[key] = val.value.map(({ ...rest }: ExtrudeSurface) => {
return rest
@@ -98,15 +102,16 @@ export const processMemory = (programMemory: ProgramMemory) => {
processedMemory[key] = sg.paths.map(({ __geoMeta, ...rest }: Path) => {
return rest
})
- } else if ((val.type as any) === 'Function') {
- processedMemory[key] = `__function(${(val as any)?.expression?.params
- ?.map?.(({ identifier }: any) => identifier?.name || '')
- .join(', ')})__`
} else {
processedMemory[key] = val.value
}
- } else if (key !== 'log') {
- processedMemory[key] = '__function__'
+ //@ts-ignore
+ } else if (val.type === 'Function') {
+ processedMemory[key] = `__function(${(val as any)?.expression?.params
+ ?.map?.(({ identifier }: any) => identifier?.name || '')
+ .join(', ')})__`
+ } else {
+ processedMemory[key] = val.value
}
}
return processedMemory
diff --git a/src/components/UserSidebarMenu.test.tsx b/src/components/UserSidebarMenu.test.tsx
index b89a080c5..169dd5fe4 100644
--- a/src/components/UserSidebarMenu.test.tsx
+++ b/src/components/UserSidebarMenu.test.tsx
@@ -1,4 +1,4 @@
-import { fireEvent, render, screen } from '@testing-library/react'
+import { fireEvent, render, screen, waitFor } from '@testing-library/react'
import UserSidebarMenu from './UserSidebarMenu'
import {
Route,
@@ -13,7 +13,7 @@ import { CommandBarProvider } from './CommandBar/CommandBarProvider'
type User = Models['User_type']
describe('UserSidebarMenu tests', () => {
- test("Renders user's name and email if available", () => {
+ test("Renders user's name and email if available", async () => {
const userWellFormed: User = {
id: '8675309',
name: 'Test User',
@@ -39,13 +39,19 @@ describe('UserSidebarMenu tests', () => {
fireEvent.click(screen.getByTestId('user-sidebar-toggle'))
- expect(screen.getByTestId('username')).toHaveTextContent(
- userWellFormed.name || ''
- )
- expect(screen.getByTestId('email')).toHaveTextContent(userWellFormed.email)
+ await waitFor(() => {
+ expect(screen.getByTestId('username')).toHaveTextContent(
+ userWellFormed.name || ''
+ )
+ })
+ await waitFor(() => {
+ expect(screen.getByTestId('email')).toHaveTextContent(
+ userWellFormed.email
+ )
+ })
})
- test("Renders just the user's email if no name is available", () => {
+ test("Renders just the user's email if no name is available", async () => {
const userNoName: User = {
id: '8675309',
email: 'kittycad.sidebar.test@example.com',
@@ -71,10 +77,12 @@ describe('UserSidebarMenu tests', () => {
fireEvent.click(screen.getByTestId('user-sidebar-toggle'))
- expect(screen.getByTestId('username')).toHaveTextContent(userNoName.email)
+ await waitFor(() => {
+ expect(screen.getByTestId('username')).toHaveTextContent(userNoName.email)
+ })
})
- test('Renders a menu button if no user avatar is available', () => {
+ test('Renders a menu button if no user avatar is available', async () => {
const userNoAvatar: User = {
id: '8675309',
name: 'Test User',
@@ -98,9 +106,11 @@ describe('UserSidebarMenu tests', () => {
)
- expect(screen.getByTestId('user-sidebar-toggle')).toHaveTextContent(
- 'User menu'
- )
+ await waitFor(() => {
+ expect(screen.getByTestId('user-sidebar-toggle')).toHaveTextContent(
+ 'User menu'
+ )
+ })
})
})
diff --git a/src/lib/desktop.test.ts b/src/lib/desktop.test.ts
new file mode 100644
index 000000000..922cfbf82
--- /dev/null
+++ b/src/lib/desktop.test.ts
@@ -0,0 +1,131 @@
+import { vi, describe, it, expect, beforeEach } from 'vitest'
+import { listProjects } from './desktop'
+import { DeepPartial } from './types'
+import { Configuration } from 'wasm-lib/kcl/bindings/Configuration'
+
+// Mock the electron window global
+const mockElectron = {
+ readdir: vi.fn(),
+ path: {
+ join: vi.fn(),
+ basename: vi.fn(),
+ dirname: vi.fn(),
+ },
+ stat: vi.fn(),
+ statIsDirectory: vi.fn(),
+ exists: vi.fn(),
+ writeFile: vi.fn(),
+ readFile: vi.fn(),
+ os: {
+ isMac: false,
+ isWindows: false,
+ },
+ process: {
+ env: {},
+ },
+ getPath: vi.fn(),
+ kittycad: vi.fn(),
+}
+
+vi.stubGlobal('window', { electron: mockElectron })
+
+describe('desktop utilities', () => {
+ const mockConfig: DeepPartial = {
+ settings: {
+ project: {
+ directory: '/test/projects',
+ },
+ },
+ }
+
+ const mockFileSystem: { [key: string]: string[] } = {
+ '/test/projects': [
+ '.hidden-project',
+ 'valid-project',
+ '.git',
+ 'project-without-kcl-files',
+ 'another-valid-project',
+ ],
+ '/test/projects/valid-project': ['file1.kcl', 'file2.stp'],
+ '/test/projects/project-without-kcl-files': ['file3.glb'],
+ '/test/projects/another-valid-project': ['file4.kcl'],
+ }
+
+ beforeEach(() => {
+ vi.clearAllMocks()
+
+ // Setup default mock implementations
+ mockElectron.path.join.mockImplementation((...parts: string[]) =>
+ parts.join('/')
+ )
+ mockElectron.path.basename.mockImplementation((path: string) =>
+ path.split('/').pop()
+ )
+ mockElectron.path.dirname.mockImplementation((path: string) =>
+ path.split('/').slice(0, -1).join('/')
+ )
+
+ // Mock readdir to return the entries for the given path
+ mockElectron.readdir.mockImplementation(async (path: string) => {
+ return mockFileSystem[path] || []
+ })
+
+ // Mock statIsDirectory to return true if the path exists in mockFileSystem
+ mockElectron.statIsDirectory.mockImplementation(async (path: string) => {
+ return path in mockFileSystem
+ })
+
+ // Mock stat to always resolve with dummy metadata
+ mockElectron.stat.mockResolvedValue({
+ mtimeMs: 123,
+ atimeMs: 456,
+ ctimeMs: 789,
+ size: 100,
+ mode: 0o666,
+ })
+
+ mockElectron.exists.mockResolvedValue(true)
+ mockElectron.readFile.mockResolvedValue('')
+ mockElectron.writeFile.mockResolvedValue(undefined)
+ mockElectron.getPath.mockResolvedValue('/appData')
+ mockElectron.kittycad.mockResolvedValue({})
+ })
+
+ describe('listProjects', () => {
+ it('does not list .git directories', async () => {
+ const projects = await listProjects(mockConfig)
+ expect(projects.map((p) => p.name)).not.toContain('.git')
+ })
+ it('lists projects excluding hidden and without .kcl files', async () => {
+ const projects = await listProjects(mockConfig)
+
+ // Verify only non-dot projects with .kcl files were included
+ expect(projects.map((p) => p.name)).toEqual([
+ 'valid-project',
+ 'another-valid-project',
+ ])
+
+ // Verify we didn't try to get project info for dot directories
+ expect(mockElectron.stat).not.toHaveBeenCalledWith(
+ expect.stringContaining('/.hidden-project')
+ )
+ expect(mockElectron.stat).not.toHaveBeenCalledWith(
+ expect.stringContaining('/.git')
+ )
+
+ // Verify that projects without .kcl files are not included
+ expect(projects.map((p) => p.name)).not.toContain(
+ 'project-without-kcl-files'
+ )
+ })
+
+ it('handles empty project directory', async () => {
+ // Adjust mockFileSystem to simulate empty directory
+ mockFileSystem['/test/projects'] = []
+
+ const projects = await listProjects(mockConfig)
+
+ expect(projects).toEqual([])
+ })
+ })
+})
diff --git a/src/lib/desktop.ts b/src/lib/desktop.ts
index 247c36dd2..3e4c1e08d 100644
--- a/src/lib/desktop.ts
+++ b/src/lib/desktop.ts
@@ -139,6 +139,11 @@ export async function listProjects(
const entries = await window.electron.readdir(projectDir)
for (let entry of entries) {
+ // Skip directories that start with a dot
+ if (entry.startsWith('.')) {
+ continue
+ }
+
const projectPath = window.electron.path.join(projectDir, entry)
// if it's not a directory ignore.
const isDirectory = await window.electron.statIsDirectory(projectPath)
diff --git a/src/lib/getCurrentProjectFile.ts b/src/lib/getCurrentProjectFile.ts
index 27d25c4bb..d3638cb26 100644
--- a/src/lib/getCurrentProjectFile.ts
+++ b/src/lib/getCurrentProjectFile.ts
@@ -1,5 +1,6 @@
import * as path from 'path'
import * as fs from 'fs/promises'
+import { Stats } from 'fs'
import { Models } from '@kittycad/lib/dist/types/src'
import { PROJECT_ENTRYPOINT } from './constants'
@@ -43,8 +44,16 @@ export default async function getCurrentProjectFile(
? sourcePath
: path.join(process.cwd(), sourcePath)
+ let stats: Stats
+ try {
+ stats = await fs.stat(sourcePath)
+ } catch (error) {
+ return new Error(
+ `Unable to access the path: ${sourcePath}. Error: ${error}`
+ )
+ }
+
// If the path is a directory, let's assume it is a project directory.
- const stats = await fs.stat(sourcePath)
if (stats.isDirectory()) {
// Walk the directory and look for a kcl file.
const files = await fs.readdir(sourcePath)
diff --git a/src/lib/toolbar.ts b/src/lib/toolbar.ts
index 988a29d47..751e8a118 100644
--- a/src/lib/toolbar.ts
+++ b/src/lib/toolbar.ts
@@ -39,6 +39,9 @@ export type ToolbarItem = {
description: string
links: { label: string; url: string }[]
isActive?: (state: StateFrom) => boolean
+ disabledReason?:
+ | string
+ | ((state: StateFrom) => string | undefined)
}
export type ToolbarItemResolved = Omit<
@@ -349,6 +352,11 @@ export const toolbarConfig: Record = {
(!isEditingExistingSketch(state.context) &&
!state.matches({ Sketch: 'Tangential arc to' })) ||
pipeHasCircle(state.context),
+ disabledReason: (state) =>
+ !isEditingExistingSketch(state.context) &&
+ !state.matches({ Sketch: 'Tangential arc to' })
+ ? "Cannot start a tangential arc because there's no previous line to be tangential to. Try drawing a line first or selecting an existing sketch to edit."
+ : undefined,
title: 'Tangential Arc',
hotkey: (state) =>
state.matches({ Sketch: 'Tangential arc to' }) ? ['Esc', 'A'] : 'A',
diff --git a/src/routes/Home.tsx b/src/routes/Home.tsx
index f54fcbe51..d1a335089 100644
--- a/src/routes/Home.tsx
+++ b/src/routes/Home.tsx
@@ -4,6 +4,7 @@ import { AppHeader } from 'components/AppHeader'
import ProjectCard from 'components/ProjectCard/ProjectCard'
import { useNavigate, useSearchParams } from 'react-router-dom'
import { Link } from 'react-router-dom'
+import { toast } from 'react-hot-toast'
import Loading from 'components/Loading'
import { PATHS } from 'lib/paths'
import {
@@ -94,6 +95,11 @@ const Home = () => {
new FormData(e.target as HTMLFormElement)
)
+ if (typeof newProjectName === 'string' && newProjectName.startsWith('.')) {
+ toast.error('Project names cannot start with a dot (.)')
+ return
+ }
+
if (newProjectName !== project.name) {
send({
type: 'Rename project',
diff --git a/src/wasm-lib/kcl/src/lsp/kcl/mod.rs b/src/wasm-lib/kcl/src/lsp/kcl/mod.rs
index 061766bfa..0d3d8aa41 100644
--- a/src/wasm-lib/kcl/src/lsp/kcl/mod.rs
+++ b/src/wasm-lib/kcl/src/lsp/kcl/mod.rs
@@ -1041,6 +1041,38 @@ impl LanguageServer for Backend {
tags: None,
}];
+ // Get the current line up to cursor
+ let Some(current_code) = self
+ .code_map
+ .get(params.text_document_position.text_document.uri.as_ref())
+ else {
+ return Ok(Some(CompletionResponse::Array(completions)));
+ };
+ let Ok(current_code) = std::str::from_utf8(¤t_code) else {
+ return Ok(Some(CompletionResponse::Array(completions)));
+ };
+
+ // Get the current line up to cursor, with bounds checking
+ if let Some(line) = current_code
+ .lines()
+ .nth(params.text_document_position.position.line as usize)
+ {
+ let char_pos = params.text_document_position.position.character as usize;
+ if char_pos <= line.len() {
+ let line_prefix = &line[..char_pos];
+ // Get last word
+ let last_word = line_prefix
+ .split(|c: char| c.is_whitespace() || c.is_ascii_punctuation())
+ .last()
+ .unwrap_or("");
+
+ // If the last word starts with a digit, return no completions
+ if !last_word.is_empty() && last_word.chars().next().unwrap().is_ascii_digit() {
+ return Ok(None);
+ }
+ }
+ }
+
completions.extend(self.stdlib_completions.values().cloned());
// Add more to the completions if we have more.
diff --git a/src/wasm-lib/kcl/src/lsp/tests.rs b/src/wasm-lib/kcl/src/lsp/tests.rs
index c56418dd9..606ec3370 100644
--- a/src/wasm-lib/kcl/src/lsp/tests.rs
+++ b/src/wasm-lib/kcl/src/lsp/tests.rs
@@ -3551,3 +3551,36 @@ const part001 = startSketchOn('XY')
// Check the diagnostics.
assert_eq!(diagnostics.len(), 2);
}
+
+#[tokio::test(flavor = "multi_thread")]
+async fn kcl_test_kcl_lsp_completions_number_literal() {
+ let server = kcl_lsp_server(false).await.unwrap();
+
+ server
+ .did_open(tower_lsp::lsp_types::DidOpenTextDocumentParams {
+ text_document: tower_lsp::lsp_types::TextDocumentItem {
+ uri: "file:///test.kcl".try_into().unwrap(),
+ language_id: "kcl".to_string(),
+ version: 1,
+ text: "const thing = 10".to_string(),
+ },
+ })
+ .await;
+
+ let completions = server
+ .completion(tower_lsp::lsp_types::CompletionParams {
+ text_document_position: tower_lsp::lsp_types::TextDocumentPositionParams {
+ text_document: tower_lsp::lsp_types::TextDocumentIdentifier {
+ uri: "file:///test.kcl".try_into().unwrap(),
+ },
+ position: tower_lsp::lsp_types::Position { line: 0, character: 15 },
+ },
+ context: None,
+ partial_result_params: Default::default(),
+ work_done_progress_params: Default::default(),
+ })
+ .await
+ .unwrap();
+
+ assert_eq!(completions.is_none(), true);
+}
diff --git a/src/wasm-lib/kcl/src/std/args.rs b/src/wasm-lib/kcl/src/std/args.rs
index d0d40336b..95bf3a78a 100644
--- a/src/wasm-lib/kcl/src/std/args.rs
+++ b/src/wasm-lib/kcl/src/std/args.rs
@@ -459,6 +459,19 @@ impl Args {
source_ranges: vec![self.source_range],
}))
}
+
+ pub(crate) fn get_polygon_args(
+ &self,
+ ) -> Result<
+ (
+ crate::std::shapes::PolygonData,
+ crate::std::shapes::SketchOrSurface,
+ Option,
+ ),
+ KclError,
+ > {
+ FromArgs::from_args(self, 0)
+ }
}
/// Types which impl this trait can be read out of the `Args` passed into a KCL function.
@@ -652,6 +665,7 @@ impl_from_arg_via_json!(super::sketch::AngledLineData);
impl_from_arg_via_json!(super::sketch::AngledLineToData);
impl_from_arg_via_json!(super::sketch::AngledLineThatIntersectsData);
impl_from_arg_via_json!(super::shapes::CircleData);
+impl_from_arg_via_json!(super::shapes::PolygonData);
impl_from_arg_via_json!(super::sketch::ArcData);
impl_from_arg_via_json!(super::sketch::TangentialArcData);
impl_from_arg_via_json!(super::sketch::BezierData);
diff --git a/src/wasm-lib/kcl/src/std/array.rs b/src/wasm-lib/kcl/src/std/array.rs
index 5ecc65858..ee41092ca 100644
--- a/src/wasm-lib/kcl/src/std/array.rs
+++ b/src/wasm-lib/kcl/src/std/array.rs
@@ -193,3 +193,63 @@ async fn call_reduce_closure<'a>(
})?;
Ok(out)
}
+
+/// Append an element to the end of an array.
+///
+/// Returns a new array with the element appended.
+///
+/// ```no_run
+/// let arr = [1, 2, 3]
+/// let new_arr = push(arr, 4)
+/// assertEqual(new_arr[3], 4, 0.00001, "4 was added to the end of the array")
+/// ```
+#[stdlib {
+ name = "push",
+}]
+async fn inner_push(array: Vec, elem: KclValue, args: &Args) -> Result {
+ // Unwrap the KclValues to JValues for manipulation
+ let mut unwrapped_array = array
+ .into_iter()
+ .map(|k| match k {
+ KclValue::UserVal(user_val) => Ok(user_val.value),
+ _ => Err(KclError::Semantic(KclErrorDetails {
+ message: "Expected a UserVal in array".to_string(),
+ source_ranges: vec![args.source_range],
+ })),
+ })
+ .collect::, _>>()?;
+
+ // Unwrap the element
+ let unwrapped_elem = match elem {
+ KclValue::UserVal(user_val) => user_val.value,
+ _ => {
+ return Err(KclError::Semantic(KclErrorDetails {
+ message: "Expected a UserVal as element".to_string(),
+ source_ranges: vec![args.source_range],
+ }));
+ }
+ };
+
+ // Append the element to the array
+ unwrapped_array.push(unwrapped_elem);
+
+ // Wrap the new array into a UserVal with the source range metadata
+ let uv = UserVal::new(vec![args.source_range.into()], unwrapped_array);
+
+ // Return the new array wrapped as a KclValue::UserVal
+ Ok(KclValue::UserVal(uv))
+}
+
+pub async fn push(_exec_state: &mut ExecState, args: Args) -> Result {
+ // Extract the array and the element from the arguments
+ let (array_jvalues, elem): (Vec, KclValue) = FromArgs::from_args(&args, 0)?;
+
+ // Convert the array of JValue into Vec
+ let array: Vec = array_jvalues
+ .into_iter()
+ .map(|jval| KclValue::UserVal(UserVal::new(vec![args.source_range.into()], jval)))
+ .collect();
+
+ // Call the inner_push function
+ inner_push(array, elem, &args).await
+}
diff --git a/src/wasm-lib/kcl/src/std/mod.rs b/src/wasm-lib/kcl/src/std/mod.rs
index a8681457f..d8e52ff68 100644
--- a/src/wasm-lib/kcl/src/std/mod.rs
+++ b/src/wasm-lib/kcl/src/std/mod.rs
@@ -66,6 +66,7 @@ lazy_static! {
Box::new(crate::std::segment::AngleToMatchLengthX),
Box::new(crate::std::segment::AngleToMatchLengthY),
Box::new(crate::std::shapes::Circle),
+ Box::new(crate::std::shapes::Polygon),
Box::new(crate::std::sketch::LineTo),
Box::new(crate::std::sketch::Line),
Box::new(crate::std::sketch::XLineTo),
@@ -99,6 +100,7 @@ lazy_static! {
Box::new(crate::std::patterns::PatternTransform),
Box::new(crate::std::array::Reduce),
Box::new(crate::std::array::Map),
+ Box::new(crate::std::array::Push),
Box::new(crate::std::chamfer::Chamfer),
Box::new(crate::std::fillet::Fillet),
Box::new(crate::std::fillet::GetOppositeEdge),
diff --git a/src/wasm-lib/kcl/src/std/shapes.rs b/src/wasm-lib/kcl/src/std/shapes.rs
index a1ff5d4ce..4a1d11822 100644
--- a/src/wasm-lib/kcl/src/std/shapes.rs
+++ b/src/wasm-lib/kcl/src/std/shapes.rs
@@ -15,7 +15,7 @@ use serde::{Deserialize, Serialize};
use crate::{
ast::types::TagDeclarator,
- errors::KclError,
+ errors::{KclError, KclErrorDetails},
executor::{BasePath, ExecState, GeoMeta, KclValue, Path, Sketch, SketchSurface},
std::Args,
};
@@ -24,6 +24,7 @@ use crate::{
#[derive(Debug, Clone, Deserialize, Serialize, PartialEq, ts_rs::TS, JsonSchema)]
#[ts(export)]
#[serde(untagged)]
+
pub enum SketchOrSurface {
SketchSurface(SketchSurface),
Sketch(Box),
@@ -141,3 +142,201 @@ async fn inner_circle(
Ok(new_sketch)
}
+
+/// Type of the polygon
+#[derive(Debug, Clone, Deserialize, Serialize, PartialEq, ts_rs::TS, JsonSchema, Default)]
+#[ts(export)]
+#[serde(rename_all = "lowercase")]
+pub enum PolygonType {
+ #[default]
+ Inscribed,
+ Circumscribed,
+}
+
+/// Data for drawing a polygon
+#[derive(Debug, Clone, Deserialize, Serialize, PartialEq, ts_rs::TS, JsonSchema)]
+#[ts(export)]
+#[serde(rename_all = "camelCase")]
+pub struct PolygonData {
+ /// The radius of the polygon
+ pub radius: f64,
+ /// The number of sides in the polygon
+ pub num_sides: u64,
+ /// The center point of the polygon
+ pub center: [f64; 2],
+ /// The type of the polygon (inscribed or circumscribed)
+ #[serde(skip)]
+ polygon_type: PolygonType,
+ /// Whether the polygon is inscribed (true) or circumscribed (false) about a circle with the specified radius
+ #[serde(default = "default_inscribed")]
+ pub inscribed: bool,
+}
+
+fn default_inscribed() -> bool {
+ true
+}
+
+/// Create a regular polygon with the specified number of sides and radius.
+pub async fn polygon(exec_state: &mut ExecState, args: Args) -> Result {
+ let (data, sketch_surface_or_group, tag): (PolygonData, SketchOrSurface, Option) =
+ args.get_polygon_args()?;
+
+ let sketch = inner_polygon(data, sketch_surface_or_group, tag, exec_state, args).await?;
+ Ok(KclValue::new_user_val(sketch.meta.clone(), sketch))
+}
+
+/// Create a regular polygon with the specified number of sides that is either inscribed or circumscribed around a circle of the specified radius.
+///
+/// ```no_run
+/// // Create a regular hexagon inscribed in a circle of radius 10
+/// hex = startSketchOn('XY')
+/// |> polygon({
+/// radius: 10,
+/// numSides: 6,
+/// center: [0, 0],
+/// inscribed: true,
+/// }, %)
+///
+/// example = extrude(5, hex)
+/// ```
+///
+/// ```no_run
+/// // Create a square circumscribed around a circle of radius 5
+/// square = startSketchOn('XY')
+/// |> polygon({
+/// radius: 5.0,
+/// numSides: 4,
+/// center: [10, 10],
+/// inscribed: false,
+/// }, %)
+/// example = extrude(5, square)
+/// ```
+#[stdlib {
+ name = "polygon",
+}]
+async fn inner_polygon(
+ data: PolygonData,
+ sketch_surface_or_group: SketchOrSurface,
+ tag: Option,
+ exec_state: &mut ExecState,
+ args: Args,
+) -> Result {
+ if data.num_sides < 3 {
+ return Err(KclError::Type(KclErrorDetails {
+ message: "Polygon must have at least 3 sides".to_string(),
+ source_ranges: vec![args.source_range],
+ }));
+ }
+
+ if data.radius <= 0.0 {
+ return Err(KclError::Type(KclErrorDetails {
+ message: "Radius must be greater than 0".to_string(),
+ source_ranges: vec![args.source_range],
+ }));
+ }
+
+ let sketch_surface = match sketch_surface_or_group {
+ SketchOrSurface::SketchSurface(surface) => surface,
+ SketchOrSurface::Sketch(group) => group.on,
+ };
+
+ let half_angle = std::f64::consts::PI / data.num_sides as f64;
+
+ let radius_to_vertices = match data.polygon_type {
+ PolygonType::Inscribed => data.radius,
+ PolygonType::Circumscribed => data.radius / half_angle.cos(),
+ };
+
+ let angle_step = 2.0 * std::f64::consts::PI / data.num_sides as f64;
+
+ let vertices: Vec<[f64; 2]> = (0..data.num_sides)
+ .map(|i| {
+ let angle = angle_step * i as f64;
+ [
+ data.center[0] + radius_to_vertices * angle.cos(),
+ data.center[1] + radius_to_vertices * angle.sin(),
+ ]
+ })
+ .collect();
+
+ let mut sketch =
+ crate::std::sketch::inner_start_profile_at(vertices[0], sketch_surface, None, exec_state, args.clone()).await?;
+
+ // Draw all the lines with unique IDs and modified tags
+ for vertex in vertices.iter().skip(1) {
+ let from = sketch.current_pen_position()?;
+ let id = exec_state.id_generator.next_uuid();
+
+ args.batch_modeling_cmd(
+ id,
+ ModelingCmd::from(mcmd::ExtendPath {
+ path: sketch.id.into(),
+ segment: PathSegment::Line {
+ end: KPoint2d::from(*vertex).with_z(0.0).map(LengthUnit),
+ relative: false,
+ },
+ }),
+ )
+ .await?;
+
+ let current_path = Path::ToPoint {
+ base: BasePath {
+ from: from.into(),
+ to: *vertex,
+ tag: tag.clone(),
+ geo_meta: GeoMeta {
+ id,
+ metadata: args.source_range.into(),
+ },
+ },
+ };
+
+ if let Some(tag) = &tag {
+ sketch.add_tag(tag, ¤t_path);
+ }
+
+ sketch.paths.push(current_path);
+ }
+
+ // Close the polygon by connecting back to the first vertex with a new ID
+ let from = sketch.current_pen_position()?;
+ let close_id = exec_state.id_generator.next_uuid();
+
+ args.batch_modeling_cmd(
+ close_id,
+ ModelingCmd::from(mcmd::ExtendPath {
+ path: sketch.id.into(),
+ segment: PathSegment::Line {
+ end: KPoint2d::from(vertices[0]).with_z(0.0).map(LengthUnit),
+ relative: false,
+ },
+ }),
+ )
+ .await?;
+
+ let current_path = Path::ToPoint {
+ base: BasePath {
+ from: from.into(),
+ to: vertices[0],
+ tag: tag.clone(),
+ geo_meta: GeoMeta {
+ id: close_id,
+ metadata: args.source_range.into(),
+ },
+ },
+ };
+
+ if let Some(tag) = &tag {
+ sketch.add_tag(tag, ¤t_path);
+ }
+
+ sketch.paths.push(current_path);
+
+ args.batch_modeling_cmd(
+ exec_state.id_generator.next_uuid(),
+ ModelingCmd::from(mcmd::ClosePath { path_id: sketch.id }),
+ )
+ .await?;
+
+ Ok(sketch)
+}
diff --git a/src/wasm-lib/kcl/src/std/sketch.rs b/src/wasm-lib/kcl/src/std/sketch.rs
index b6bc9d9c1..8deb9cb2d 100644
--- a/src/wasm-lib/kcl/src/std/sketch.rs
+++ b/src/wasm-lib/kcl/src/std/sketch.rs
@@ -1501,7 +1501,7 @@ pub(crate) async fn inner_arc(
(center, a_start, a_end, *radius, end)
}
ArcData::CenterToRadius { center, to, radius } => {
- let (angle_start, angle_end) = arc_angles(from, center.into(), to.into(), *radius, args.source_range)?;
+ let (angle_start, angle_end) = arc_angles(from, to.into(), center.into(), *radius, args.source_range)?;
(center.into(), angle_start, angle_end, *radius, to.into())
}
};
diff --git a/src/wasm-lib/kcl/tests/outputs/serial_test_example_polygon0.png b/src/wasm-lib/kcl/tests/outputs/serial_test_example_polygon0.png
new file mode 100644
index 000000000..bc2eaa56e
Binary files /dev/null and b/src/wasm-lib/kcl/tests/outputs/serial_test_example_polygon0.png differ
diff --git a/src/wasm-lib/kcl/tests/outputs/serial_test_example_polygon1.png b/src/wasm-lib/kcl/tests/outputs/serial_test_example_polygon1.png
new file mode 100644
index 000000000..3b3c303c7
Binary files /dev/null and b/src/wasm-lib/kcl/tests/outputs/serial_test_example_polygon1.png differ
diff --git a/src/wasm-lib/kcl/tests/outputs/serial_test_example_push0.png b/src/wasm-lib/kcl/tests/outputs/serial_test_example_push0.png
new file mode 100644
index 000000000..6148ae432
Binary files /dev/null and b/src/wasm-lib/kcl/tests/outputs/serial_test_example_push0.png differ
diff --git a/src/wasm-lib/tests/executor/inputs/no_visuals/array_elem_push.kcl b/src/wasm-lib/tests/executor/inputs/no_visuals/array_elem_push.kcl
new file mode 100644
index 000000000..24c5bb7bf
--- /dev/null
+++ b/src/wasm-lib/tests/executor/inputs/no_visuals/array_elem_push.kcl
@@ -0,0 +1,12 @@
+arr = [1, 2, 3]
+new_arr1 = push(arr, 4)
+new_arr2 = push(new_arr1, 5)
+assertEqual(new_arr1[0], 1, 0.00001, "element 0 should not have changed")
+assertEqual(new_arr1[1], 2, 0.00001, "element 1 should not have changed")
+assertEqual(new_arr1[2], 3, 0.00001, "element 2 should not have changed")
+assertEqual(new_arr1[3], 4, 0.00001, "4 was added to the end of the array")
+assertEqual(new_arr2[0], 1, 0.00001, "element 0 should not have changed")
+assertEqual(new_arr2[1], 2, 0.00001, "element 1 should not have changed")
+assertEqual(new_arr2[2], 3, 0.00001, "element 2 should not have changed")
+assertEqual(new_arr2[3], 4, 0.00001, "4 was added to the end of the array")
+assertEqual(new_arr2[4], 5, 0.00001, "5 was added to the end of the array")
diff --git a/src/wasm-lib/tests/executor/no_visuals.rs b/src/wasm-lib/tests/executor/no_visuals.rs
index 921f55531..b5be2cad6 100644
--- a/src/wasm-lib/tests/executor/no_visuals.rs
+++ b/src/wasm-lib/tests/executor/no_visuals.rs
@@ -173,3 +173,4 @@ gen_test_parse_fail!(
// );
gen_test!(add_lots);
gen_test!(double_map);
+gen_test!(array_elem_push);