Fix an edge case, ty Jon

Author: adamchalmers

docs/kcl-std/functions/std-array-map.md

@@ -14,8 +14,8 @@ map(
 ): [any]
 ```
 
-Given a list like [`a, b, c`], and a function like `f`, returns
-[`f(a), f(b), f(c)`]
+Given a list like `[a, b, c]`, and a function like `f`, returns
+`[f(a), f(b), f(c)]`
 
 ### Arguments
 

docs/kcl-std/functions/std-gdt-datum.md

@@ -28,7 +28,7 @@ gdt::datum(
 |----------|------|-------------|----------|
 | `face` | [`TaggedFace`](/docs/kcl-std/types/std-types-TaggedFace) | The face to be annotated. | Yes |
 | `name` | [`string`](/docs/kcl-std/types/std-types-string) | The name of the datum. | Yes |
-| `framePosition` | [`Point2d`](/docs/kcl-std/types/std-types-Point2d) | The position of the feature control frame relative to the leader arrow. The default is [`100mm, 100mm`]. | No |
+| `framePosition` | [`Point2d`](/docs/kcl-std/types/std-types-Point2d) | The position of the feature control frame relative to the leader arrow. The default is `[100mm, 100mm]`. | No |
 | `framePlane` | [`Plane`](/docs/kcl-std/types/std-types-Plane) | The plane in which to display the feature control frame. The default is `XY`. Other standard planes like `XZ` and `YZ` can also be used. The frame may be displayed in a plane parallel to the given plane. | No |
 | `fontPointSize` | [`number(_)`](/docs/kcl-std/types/std-types-number) | The font point size to use for the annotation text rendering. The default is `36`. | No |
 | `fontScale` | [`number(_)`](/docs/kcl-std/types/std-types-number) | Scale to use for the annotation text after rendering with the point size. The default is `1.0`. Must be greater than `0`. | No |

docs/kcl-std/functions/std-gdt-flatness.md

@@ -30,7 +30,7 @@ gdt::flatness(
 | `faces` | [[`TaggedFace`](/docs/kcl-std/types/std-types-TaggedFace); 1+] | The faces to be annotated. | Yes |
 | `tolerance` | [`number(Length)`](/docs/kcl-std/types/std-types-number) | The amount of deviation from a perfect plane that is acceptable. | Yes |
 | `precision` | [`number(_)`](/docs/kcl-std/types/std-types-number) | The number of decimal places to display. The default is `3`. Must be greater than or equal to `0` and less than or equal to `9`. | No |
-| `framePosition` | [`Point2d`](/docs/kcl-std/types/std-types-Point2d) | The position of the feature control frame relative to the leader arrow. The default is [`100mm, 100mm`]. | No |
+| `framePosition` | [`Point2d`](/docs/kcl-std/types/std-types-Point2d) | The position of the feature control frame relative to the leader arrow. The default is `[100mm, 100mm]`. | No |
 | `framePlane` | [`Plane`](/docs/kcl-std/types/std-types-Plane) | The plane in which to display the feature control frame. The default is `XY`. Other standard planes like `XZ` and `YZ` can also be used. The frame may be displayed in a plane parallel to the given plane. | No |
 | `fontPointSize` | [`number(_)`](/docs/kcl-std/types/std-types-number) | The font point size to use for the annotation text rendering. The default is `36`. | No |
 | `fontScale` | [`number(_)`](/docs/kcl-std/types/std-types-number) | Scale to use for the annotation text after rendering with the point size. The default is `1.0`. Must be greater than `0`. | No |

docs/kcl-std/types/std-types-Point2d.md

@@ -12,7 +12,7 @@ type Point2d = [number(Length); 2]
 ```
 
 [`Point2d`](/docs/kcl-std/types/std-types-Point2d) is an alias for a two-element array of [number](/docs/kcl-std/types/std-types-number)s. To write a value
-with type [`Point2d`](/docs/kcl-std/types/std-types-Point2d), use an array, e.g., [`0, 0`] or [`5.0, 3.14`].
+with type [`Point2d`](/docs/kcl-std/types/std-types-Point2d), use an array, e.g., `[0, 0]` or `[5.0, 3.14]`.
 
 
 

docs/kcl-std/types/std-types-Point3d.md

@@ -12,7 +12,7 @@ type Point3d = [number(Length); 3]
 ```
 
 [`Point3d`](/docs/kcl-std/types/std-types-Point3d) is an alias for a three-element array of [number](/docs/kcl-std/types/std-types-number)s. To write a value
-with type [`Point3d`](/docs/kcl-std/types/std-types-Point3d), use an array, e.g., [`0, 0, 0`] or [`5.0, 3.14, 6.8`].
+with type [`Point3d`](/docs/kcl-std/types/std-types-Point3d), use an array, e.g., `[0, 0, 0]` or `[5.0, 3.14, 6.8]`.
 
 
 

rust/kcl-lib/src/docs/gen_std_tests.rs

@@ -515,14 +515,22 @@ fn cleanup_types(input: &str, kcl_std: &ModData) -> String {
 }
 
 fn cleanup_type_string(input: &str, fmt_for_text: bool, kcl_std: &ModData) -> String {
+    if input.contains("a, b, c") {
+        dbg!(input);
+    }
     let type_tree = match type_formatter::parse(input) {
         Ok(type_tree) => type_tree,
         Err(e) => {
             eprintln!("Could not parse: {input} because {e}");
             return input.to_owned();
         }
     };
-    type_tree.format(fmt_for_text, kcl_std)
+    let fmtd = type_tree.format(fmt_for_text, kcl_std);
+    if !fmtd.contains('`') && fmt_for_text {
+        format!("`{fmtd}`")
+    } else {
+        fmtd
+    }
 }
 
 #[test]
@@ -654,6 +662,11 @@ mod tests {
                 expected_text: "[[`string`](/docs/kcl-std/types/std-types-string) or [`number(mm)`](/docs/kcl-std/types/std-types-number)]",
                 expected_no_text: "[string | number(mm)]",
             },
+            Test {
+                input: "[a, b, c]",
+                expected_text: "`[a, b, c]`",
+                expected_no_text: "[a, b, c]",
+            },
         ];
         for test in tests {
             let actual_text = cleanup_type_string(test.input, true, &kcl_std);

rust/kcl-lib/src/docs/gen_std_tests/type_formatter.rs

@@ -49,7 +49,7 @@ impl<'i> KclType<'i> {
                     } else if matches!(kcl_std.find_by_name(ty), Some(DocData::Ty(_))) && ty != "tag" {
                         format!("[`{ty}`](/docs/kcl-std/types/std-types-{ty})")
                     } else {
-                        format!("`{ty}`")
+                        format!("{ty}")
                     }
                 } else {
                     ty.to_string()