doc: Add more docs and links for KCL import (#4488)

* Add links in docs to KCL module documentation

* Add import statement test in import() stdlib doc comments

* Update doc test outputs

* Update doc outputs

docs/kcl/index.md

@@ -7,6 +7,7 @@ layout: manual
 ## Table of Contents
 
 * [Types](kcl/types)
+* [Modules](kcl/modules)
 * [Known Issues](kcl/KNOWN-ISSUES)
 * [`abs`](kcl/abs)
 * [`acos`](kcl/acos)

docs/kcl/std.json

@@ -74007,7 +74007,7 @@
   {
     "name": "import",
     "summary": "Import a CAD file.",
-    "description": "For formats lacking unit data (such as STL, OBJ, or PLY files), the default unit of measurement is millimeters. Alternatively you may specify the unit by passing your desired measurement unit in the options parameter. When importing a GLTF file, the bin file will be imported as well. Import paths are relative to the current project directory.\n\nNote: The import command currently only works when using the native Modeling App.",
+    "description": "For formats lacking unit data (such as STL, OBJ, or PLY files), the default unit of measurement is millimeters. Alternatively you may specify the unit by passing your desired measurement unit in the options parameter. When importing a GLTF file, the bin file will be imported as well. Import paths are relative to the current project directory.\n\nNote: The import command currently only works when using the native Modeling App.\n\nFor importing KCL functions using the `import` statement, see the docs on [KCL modules](/docs/kcl/modules).",
     "tags": [],
     "args": [
       {
@@ -74411,7 +74411,8 @@
       "model = import(\"tests/inputs/cube.obj\", { type: \"obj\", units: \"m\" })",
       "model = import(\"tests/inputs/cube.gltf\")",
       "model = import(\"tests/inputs/cube.sldprt\")",
-      "model = import(\"tests/inputs/cube.step\")"
+      "model = import(\"tests/inputs/cube.step\")",
+      "import height, buildSketch from 'common.kcl'\n\nplane = 'XZ'\nmargin = 2\ns1 = buildSketch(plane, [0, 0])\ns2 = buildSketch(plane, [0, height() + margin])"
     ]
   },
   {

src/wasm-lib/kcl/common.kcl

@@ -0,0 +1,20 @@
+// This file is used by the import docs.
+
+export fn width = () => {
+  return 10
+}
+
+export fn height = () => {
+  return 10
+}
+
+export fn buildSketch = (plane, offset) => {
+  w = width()
+  h = height()
+  return startSketchOn(plane)
+  |> startProfileAt(offset, %)
+  |> line([w, 0], %)
+  |> line([0, h], %)
+  |> line([-w, 0], %)
+  |> close(%)
+}

src/wasm-lib/kcl/src/docs/templates/index.hbs

@@ -7,6 +7,7 @@ layout: manual
 ## Table of Contents
 
 * [Types](kcl/types)
+* [Modules](kcl/modules)
 * [Known Issues](kcl/KNOWN-ISSUES)
 {{#each functions}}
 * [`{{name}}`](kcl/{{name}})

src/wasm-lib/kcl/src/std/import.rs

@@ -144,6 +144,9 @@ pub async fn import(exec_state: &mut ExecState, args: Args) -> Result<KclValue,
 /// Note: The import command currently only works when using the native
 /// Modeling App.
 ///
+/// For importing KCL functions using the `import` statement, see the docs on
+/// [KCL modules](/docs/kcl/modules).
+///
 /// ```no_run
 /// const model = import("tests/inputs/cube.obj")
 /// ```
@@ -163,6 +166,15 @@ pub async fn import(exec_state: &mut ExecState, args: Args) -> Result<KclValue,
 /// ```no_run
 /// const model = import("tests/inputs/cube.step")
 /// ```
+///
+/// ```no_run
+/// import height, buildSketch from 'common.kcl'
+///
+/// plane = 'XZ'
+/// margin = 2
+/// s1 = buildSketch(plane, [0, 0])
+/// s2 = buildSketch(plane, [0, height() + margin])
+/// ```
 #[stdlib {
     name = "import",
     tags = [],