KittyCAD · andrewvarga · May 20, 2026 · May 29, 2026 · Jun 1, 2026 · Jun 2, 2026
@@ -5,19 +5,25 @@ excerpt: "Constrain lines to meet at a given angle."
 layout: manual
 ---
 
+**WARNING:** This function is deprecated as of KCL 2.0.
+
 Constrain lines to meet at a given angle.
 
 ```kcl
-solver::angle(@input: [Segment; 2])
+solver::angle(
+  @input: [Segment; 2],
+  labelPosition?: Point2d,
+)
 ```
 
-
+Deprecated as of KCL 2.0. Use `angleDimension` for new angle constraints.
 
 ### Arguments
 
 | Name | Type | Description | Required |
 |----------|------|-------------|----------|
 | `input` | [[`Segment`](/docs/kcl-std/types/std-types-Segment); 2] | The two line segments whose relative angle should match the value set with `==`. | Yes |
+| `labelPosition` | [`Point2d`](/docs/kcl-std/types/std-types-Point2d) | The desired position of the constraint label. | No |
 
 
 ### Examples

@@ -0,0 +1,62 @@
+---
+title: "solver::angleDimension"
+subtitle: "Function in std::solver"
+excerpt: "Constrain a specific angle dimension sector between two lines."
+layout: manual
+---
+
+Constrain a specific angle dimension sector between two lines.
+
+```kcl
+solver::angleDimension(
+  lines: [Segment; 2],
+  sector: number(_),
+  inverse?: bool,
+  labelPosition?: Point2d,
+)
+```
+
+
+
+### Arguments
+
+| Name | Type | Description | Required |
+|----------|------|-------------|----------|
+| `lines` | [[`Segment`](/docs/kcl-std/types/std-types-Segment); 2] | The two line segments whose selected angle sector should match the value set with `==`. | Yes |
+| `sector` | [`number(_)`](/docs/kcl-std/types/std-types-number) | Which of the four angle sectors to constrain, numbered around the line intersection. | Yes |
+| `inverse` | [`bool`](/docs/kcl-std/types/std-types-bool) | Whether to constrain the inverse of the selected sector. | No |
+| `labelPosition` | [`Point2d`](/docs/kcl-std/types/std-types-Point2d) | The desired position of the constraint label. | No |
+
+
+### Examples
+
+```kcl
+profile = sketch(on = XY) {
+  line1 = line(start = [var 0mm, var 0mm], end = [var 4mm, var 0mm])
+  line2 = line(start = [var 0mm, var 0mm], end = [var 2mm, var 3.464mm])
+  line3 = line(start = [var 2mm, var 3.464mm], end = [var 4mm, var 0mm])
+  coincident([line1.start, line2.start])
+  coincident([line2.end, line3.start])
+  coincident([line3.end, line1.end])
+  angleDimension(lines = [line1, line2], sector = 1) == 60deg
+}
+
+solid = extrude(region(point = [2mm, 1mm], sketch = profile), length = 2)
+
+```
+
+
+<model-viewer
+  class="kcl-example"
+  alt="Example showing a rendered KCL program that uses the solver::angleDimension function"
+  src="/kcl-test-outputs/models/serial_test_example_fn_std-solver-angleDimension0_output.gltf"
+  ar
+  environment-image="/moon_1k.hdr"
+  poster="/kcl-test-outputs/serial_test_example_fn_std-solver-angleDimension0.png"
+  shadow-intensity="1"
+  camera-controls
+  touch-action="pan-y"
+>
+</model-viewer>
+
+
@@ -165,6 +165,7 @@ layout: manual
   * [`union`](/docs/kcl-std/functions/std-solid-union)
 * [**std::solver**](/docs/kcl-std/modules/std-solver)
   * [`solver::angle`](/docs/kcl-std/functions/std-solver-angle)
+  * [`solver::angleDimension`](/docs/kcl-std/functions/std-solver-angleDimension)
   * [`solver::arc`](/docs/kcl-std/functions/std-solver-arc)
   * [`solver::circle`](/docs/kcl-std/functions/std-solver-circle)
   * [`solver::coincident`](/docs/kcl-std/functions/std-solver-coincident)

@@ -47,6 +47,7 @@ functions, because those are what actually constrain the solved result.
 
 * [`solver::ORIGIN`](/docs/kcl-std/consts/std-solver-ORIGIN)
 * [`solver::angle`](/docs/kcl-std/functions/std-solver-angle)
+* [`solver::angleDimension`](/docs/kcl-std/functions/std-solver-angleDimension)
 * [`solver::arc`](/docs/kcl-std/functions/std-solver-arc)
 * [`solver::circle`](/docs/kcl-std/functions/std-solver-circle)
 * [`solver::coincident`](/docs/kcl-std/functions/std-solver-coincident)

@@ -88,10 +88,13 @@ gaugeProfileSketch = sketch(on = XY) {
   horizontal(cutoutTopEdge)
   horizontal(cutoutAngleReferenceEdge)
   vertical(cutoutLeftVerticalEdge)
-  angle([
-  cutoutAngleReferenceEdge,
-  cutoutAngledEdge
-]) == cutoutAngle
+  angleDimension(
+  lines = [
+    cutoutAngleReferenceEdge,
+    cutoutAngledEdge
+  ],
+  sector = 1,
+) == cutoutAngle
 
   horizontalDistance([cutoutTopEdge.start, cutoutTopEdge.end]) == cutoutDepth
   verticalDistance([

@@ -213,7 +213,7 @@ sketch007 = sketch(on = XY) {
   line2 = line(start = [var 0.48in, var 0.75in], end = [var 0.53in, var 1.23in], construction = true)
   coincident([line2.start, arc1.center])
   coincident([line2.end, arc2.start])
-  angle([line2, line1]) == 6
+  angleDimension(lines = [line2, line1], sector = 1, labelPosition = [0.28in, 1.38in]) == 6
 }
 
 // Model the profile of the rear inlet bung, then sweep

@@ -105,7 +105,7 @@ sketch003 = sketch(on = offsetPlane(XZ, offset = 0.4)) {
   coincident([arc3.center, arc1.center])
   tangent([arc1, arc2])
   tangent([arc3, arc4])
-  angle([line2, line3]) == 85
+  angleDimension(lines = [line2, line3], labelPosition = [0.12in, 0.16in], sector = 3) == 85
   distance([line2.start, line2.end]) == 1.4
   coincident([line2.start, arc4.center])
 }

@@ -17,7 +17,7 @@ sketch002 = sketch(on = XZ) {
   coincident([line3.start, line1.start])
   horizontal([line3.end, ORIGIN])
   horizontal(line3)
-  angle([line1, line3]) == 45
+  angleDimension(lines = [line1, line3], sector = 1) == 45
   distance([line1.start, line1.end]) == 1.65in
   radius(arc1) == 3.2 / 2
   circle1 = circle(start = [var 1.18in, var 0.93in], center = [var 0in, var 0in], construction = true)

@@ -42,7 +42,7 @@ sketch002 = sketch(on = XZ) {
   symmetric([line2, line1], axis = line3)
   symmetric([arc2, arc1], axis = line3)
   tangent([arc3, arc1])
-  angle([line1, line2]) == 180 - 30
+  angleDimension(lines = [line1, line2], sector = 2, labelPosition = [0in, 1.16in]) == 30
   tangent([arc5, arc6])
   verticalDistance([line3.start, arc2.center]) == 1
   horizontalDistance([arc1.center, arc2.center]) == .1

@@ -201,7 +201,7 @@ sketch003 = sketch(on = XY) {
   coincident([line6.end, line4.start])
   equalLength([line5, line6])
   verticalDistance([line5.start, line5.end]) == 6
-  angle([line3, line2]) == 60
+  angleDimension(lines = [line3, line2], sector = 4, labelPosition = [7.16mm, 24.34mm]) == 120deg
   horizontalDistance([line1.start, arc4.center]) == 0.02mm
   coincident([arc4.center, line4])
 }

@@ -40,8 +40,8 @@ outerProfile = sketch(on = XY) {
 
   vertical(c2ToC1)
   vertical(c1ToC6)
-  angle([baseline, c2ToC3]) == 150deg
-  angle([baseline, c4ToC5]) == 30deg
+  angleDimension(lines = [baseline, c2ToC3], sector = 3, labelPosition = [-1.23in, -0.83in]) == 150deg
+  angleDimension(lines = [baseline, c4ToC5], sector = 1, labelPosition = [-0.22in, 0.19in]) == 30deg
   parallel([c2ToC3, c3ToC4])
   parallel([c4ToC5, c5ToC6])
 

@@ -60,7 +60,7 @@ bodyProfile = sketch(on = YZ) {
   distance([line2.start, line2.end]) == plateLength
   distance([line3.start, line3.end]) == width
   distance([line6.start, line6.end]) == width
-  angle([line1, line2]) == plateAngle
+  angleDimension(lines = [line1, line2], sector = 1, labelPosition = [3.15mm, 3.38mm]) == plateAngle
 }
 
 bodyRegion = region(segments = [bodyProfile.line1, bodyProfile.line2])

@@ -70,7 +70,7 @@ insertProfileSketch = sketch(on = XY) {
   horizontalDistance([midWall.start, centerGuide.end]) == insertGuideDiameter
   horizontalDistance([bottomBridge.end, centerGuide.end]) == insertLowerBandDiameter / 2
   verticalDistance([innerWall.end, innerWall.start]) == insertOverallHeight
-  angle([midWall, taperFlank]) == taperAngle
+  angleDimension(lines = [midWall, taperFlank], sector = 1, labelPosition = [-2.83mm, -6.02mm]) == taperAngle
 }
 
 insertProfileRegion = region(point = [-3.1475mm, -1.14mm], sketch = insertProfileSketch)

@@ -49,7 +49,7 @@ sketch004 = sketch(on = XY) {
   horizontal([line14.end, ORIGIN])
   horizontal(line14)
   horizontal(line13)
-  angle([line13, line5]) == 34
+  angleDimension(lines = [line13, line5], sector = 1) == 34
   line15 = line(start = [var 0in, var 0in], end = [var 0in, var 4.46in], construction = true)
   coincident([line15.start, line5.start])
   vertical([line15.end, ORIGIN])
@@ -58,13 +58,13 @@ sketch004 = sketch(on = XY) {
   vertical([line16.end, ORIGIN])
   vertical(line16)
   vertical(line15)
-  angle([line6, line15]) == 34
-  angle([line15, line7]) == 34
-  angle([line8, line14]) == 34
-  angle([line14, line9]) == 34
-  angle([line10, line16]) == 34
-  angle([line16, line11]) == 34
-  angle([line12, line13]) == 34
+  angleDimension(lines = [line6, line15], sector = 1) == 34
+  angleDimension(lines = [line15, line7], sector = 1) == 34
+  angleDimension(lines = [line8, line14], sector = 1) == 34
+  angleDimension(lines = [line14, line9], sector = 1) == 34
+  angleDimension(lines = [line10, line16], sector = 1) == 34
+  angleDimension(lines = [line16, line11], sector = 1) == 34
+  angleDimension(lines = [line12, line13], sector = 1) == 34
   distance([line12.start, line12.end]) == 5.35
   circle1 = circle(start = [var 4.54in, var 2.61in], center = [var 4.43in, var 2.99in])
   coincident([circle1.center, line5.end])

@@ -163,7 +163,7 @@ trimProfile = sketch(on = XY) {
   startOffsetGuide.end
 ]) == rotorBore / 2
   distance([line1.start, line1.end]) == lugSpacing / 3
-  angle([startOffsetGuide, line1]) == 10deg
+  angleDimension(lines = [startOffsetGuide, line1], sector = 1, labelPosition = [2.17in, -0.69in]) == 10deg
   distance([line2.start, line2.end]) == hubSpacing * 1.5
 }
 

@@ -187,7 +187,7 @@ logoSketch = sketch(on = XY) {
   parallel([o1Guide01, o1Guide02])
   equalLength([o1Guide01, o1Guide02])
 
-  angle([frameBottom, o1Line01]) == 47deg
+  angleDimension(lines = [frameBottom, o1Line01], sector = 1, labelPosition = [1.06in, 0.06in]) == 47deg
   horizontalDistance([frameLeft.end, o1GuideArc04.center]) == logoHeight * 1.448
   verticalDistance([frameLeft.end, o1GuideArc04.center]) == logoHeight * 0.5
   radius(o1Arc03) == logoHeight * 0.5
@@ -269,7 +269,7 @@ logoSketch = sketch(on = XY) {
   horizontalDistance([o2Arc04.center, frameRight.start]) == logoHeight * 0.5
   verticalDistance([frameRight.start, o2Arc04.center]) == logoHeight * 0.5
   distance([o2GuideArc04.end, o2GuideArc04.start]) == logoHeight * 0.1
-  angle([frameBottom, o2Line03]) == 47deg
+  angleDimension(lines = [frameBottom, o2Line03], sector = 1, labelPosition = [2.2in, 0.04in]) == 47deg
   radius(o2Arc02) == logoHeight * 0.5
   radius(o2Arc03) == logoHeight * 0.27
 

@@ -285,6 +285,7 @@ pub const TEST_NAMES: &[&str] = &[
     "std-solver-parallel-0",
     "std-solver-perpendicular-0",
     "std-solver-angle-0",
+    "std-solver-angleDimension-0",
     "std-solver-symmetric-0",
     "std-solver-tangent-0",
     "std-solver-horizontal-0",

@@ -703,7 +703,12 @@ impl FnData {
     }
 
     pub(super) fn to_autocomplete_snippet(&self) -> String {
-        if self.name == "loft" {
+        if self.name == "angleDimension" {
+            return format!(
+                "{}(lines = [${{1:line1}}, ${{2:line2}}], sector = ${{3:1}})",
+                self.preferred_name
+            );
+        } else if self.name == "loft" {
             return "loft([${0:sketch000}, ${1:sketch001}])".to_owned();
         } else if self.name == "union" {
             return "union([${0:extrude001}, ${1:extrude002}])".to_owned();
@@ -1003,6 +1008,7 @@ impl ArgData {
                     "angleEnd" => "180deg",
                     "angle" => "180deg",
                     "arcDegrees" => "360deg",
+                    "sector" => "1",
                     _ => "10",
                 };
                 Some((index, format!(r#"{label}${{{index}:{value}}}"#)))

@@ -130,6 +130,7 @@ impl GlobalState {
             filenames: self.exec_state.filenames(),
             operations: self.exec_state.operations_by_module(),
             artifact_graph: self.exec_state.artifacts.graph,
+            refactor_metadata: self.exec_state.root_module_artifacts.refactor_metadata,
             scene_objects: self.exec_state.root_module_artifacts.scene_objects,
             source_range_to_object: self.exec_state.root_module_artifacts.source_range_to_object,
             var_solutions: self.exec_state.root_module_artifacts.var_solutions,