chore: update stdlib documentation

SuperFola · SuperFola · commit aa64a41ea4a0 · 2026-03-22T13:08:01.000Z
diff --git a/content/docs/std/Async.md b/content/docs/std/Async.md
@@ -3,8 +3,8 @@ title: "Async"
 slug: "async"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Benchmark.md b/content/docs/std/Benchmark.md
@@ -3,8 +3,8 @@ title: "Benchmark"
 slug: "benchmark"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Builtins.md b/content/docs/std/Builtins.md
@@ -3,8 +3,8 @@ title: "Builtins"
 slug: "builtins"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
@@ -189,6 +189,26 @@ Check if a closure has a given field
 (print (hasField closure "B"))  # false, field names are case-sensitive
 {{< /highlight_arkscript >}}
 
+## apply
+
+---
+`(apply f args)`
+Call a function with a list of arguments
+
+
+
+#### Parameters
+- `f`: function
+- `args`: list, can be empty if the function takes no argument
+
+
+#### Example
+{{< highlight_arkscript >}}
+(print (apply + [1 2]))  # 3
+(let foo (fun (a b c) (+ a b c)))
+(print (apply foo [1 2 3]))  # 6
+{{< /highlight_arkscript >}}
+
 
 
 {{< highlight_scripts >}}
diff --git a/content/docs/std/Bytecode.md b/content/docs/std/Bytecode.md
@@ -3,8 +3,8 @@ title: "Bytecode"
 slug: "bytecode"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Cli.md b/content/docs/std/Cli.md
@@ -3,8 +3,8 @@ title: "Cli"
 slug: "cli"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Dict.md b/content/docs/std/Dict.md
@@ -3,8 +3,8 @@ title: "Dict"
 slug: "dict"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Events.md b/content/docs/std/Events.md
@@ -3,8 +3,8 @@ title: "Events"
 slug: "events"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Exceptions.md b/content/docs/std/Exceptions.md
@@ -3,8 +3,8 @@ title: "Exceptions"
 slug: "exceptions"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Functional.md b/content/docs/std/Functional.md
@@ -3,8 +3,8 @@ title: "Functional"
 slug: "functional"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/IO.md b/content/docs/std/IO.md
@@ -3,8 +3,8 @@ title: "IO"
 slug: "io"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Lazy.md b/content/docs/std/Lazy.md
@@ -3,8 +3,8 @@ title: "Lazy"
 slug: "lazy"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/List.md b/content/docs/std/List.md
@@ -3,8 +3,8 @@ title: "List"
 slug: "list"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
@@ -894,6 +894,26 @@ Unzip a list of [[a b] [c d]...] into [[a c ...] [b d ...]]
 (print (list:unzip zipped))  # [[1 2 3 4] [5 6 7 8]]
 {{< /highlight_arkscript >}}
 
+## transpose
+
+---
+`(let transpose (fun (_L) (...)))`
+Transpose a list of lists or list of strings
+
+**Note**: The original list is not modified. The smallest element size is used as the limit for selecting values
+
+**Author**: [@SuperFola](https://github.com/SuperFola)
+
+#### Parameter
+- `_L`: list of lists/strings to transpose
+
+
+#### Example
+{{< highlight_arkscript >}}
+(let data [[1 2 3] [4 5 6] [7 8 9])
+(print (list:transpose data))  # [[1 4 7] [2 5 8] [3 6 9]]
+{{< /highlight_arkscript >}}
+
 ## zip
 
 ---
@@ -1177,26 +1197,6 @@ Create a sliding window of a given size on a list
 # [3 4 5]
 {{< /highlight_arkscript >}}
 
-## transpose
-
----
-`(let transpose (fun (_L) (...)))`
-Transpose a list of lists or list of strings
-
-**Note**: The original list is not modified. Elements should have the same length
-
-**Author**: [@SuperFola](https://github.com/SuperFola)
-
-#### Parameter
-- `_L`: list of lists/strings to transpose
-
-
-#### Example
-{{< highlight_arkscript >}}
-(let data [[1 2 3] [4 5 6] [7 8 9])
-(print (list:transpose data))  # [[1 4 7] [2 5 8] [3 6 9]]
-{{< /highlight_arkscript >}}
-
 ## unique
 
 ---
diff --git a/content/docs/std/Macros.md b/content/docs/std/Macros.md
@@ -3,8 +3,8 @@ title: "Macros"
 slug: "macros"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
@@ -203,6 +203,23 @@ Return the node at a given index in a list of nodes
 (print (one 1 5 6 7 8))  # 5
 {{< /highlight_arkscript >}}
 
+## $gensym
+
+---
+`($gensym )`
+Return a new unique symbol identifier to use in macros
+
+
+
+
+#### Example
+{{< highlight_arkscript >}}
+(macro switch (value case then ...cases) {
+  (macro var ($gensym))
+  (let var value)
+  (_switch_impl var case then ...cases) })
+{{< /highlight_arkscript >}}
+
 ## ->
 
 ---
diff --git a/content/docs/std/Math.md b/content/docs/std/Math.md
@@ -3,8 +3,8 @@ title: "Math"
 slug: "math"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Random.md b/content/docs/std/Random.md
@@ -3,8 +3,8 @@ title: "Random"
 slug: "random"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Range.md b/content/docs/std/Range.md
@@ -3,8 +3,8 @@ title: "Range"
 slug: "range"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Slice.md b/content/docs/std/Slice.md
@@ -3,8 +3,8 @@ title: "Slice"
 slug: "slice"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/String.md b/content/docs/std/String.md
@@ -3,8 +3,8 @@ title: "String"
 slug: "string"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Switch.md b/content/docs/std/Switch.md
@@ -3,8 +3,8 @@ title: "Switch"
 slug: "switch"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Sys.md b/content/docs/std/Sys.md
@@ -3,8 +3,8 @@ title: "Sys"
 slug: "sys"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Testing.md b/content/docs/std/Testing.md
@@ -3,8 +3,8 @@ title: "Testing"
 slug: "testing"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/Time.md b/content/docs/std/Time.md
@@ -3,8 +3,8 @@ title: "Time"
 slug: "time"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 410
 toc: true
diff --git a/content/docs/std/_decl.txt b/content/docs/std/_decl.txt
@@ -9,6 +9,7 @@ Builtin (await future)
 (comparison a b)
 (not value)
 (hasField c field)
+(apply f args)
 Builtin (disassemble f)
 (let flag (fun (name desc) (...)))
 (let value (fun (name desc default) (...)))
@@ -105,6 +106,7 @@ Builtin (input prompt)
 (let dropWhile (fun ((ref _L) _f) (...)))
 (let partition (fun ((ref _L) _f) (...)))
 (let unzip (fun ((ref _L)) (...)))
+(let transpose (fun (_L) (...)))
 (let zip (fun ((ref _a) (ref _b)) (...)))
 (let zipLongest (fun ((ref _a) (ref _b) _filler) (...)))
 (let zipWithIndex (fun ((ref _L)) (...)))
@@ -118,7 +120,6 @@ Builtin (input prompt)
 (let chunkBy (fun ((ref _L) _length) (...)))
 (let insert (fun ((ref _L) _index (mut _value)) (...)))
 (let window (fun ((ref _L) _size _f) (...)))
-(let transpose (fun (_L) (...)))
 (let unique (fun ((ref _L)) (...)))
 (let select (fun ((ref _L) (ref _indices)) (...)))
 (let combinations (fun ((ref _L) _r _f) (...)))
@@ -135,6 +136,7 @@ Builtin (input prompt)
 ($head node)
 ($tail node)
 ($at node index)
+($gensym )
 (macro -> (arg fn1 ...fns) (...))
 (macro partial (func ...defargs) (...))
 (macro partial2 (call ...args) (...))
diff --git a/content/docs/std/_index.md b/content/docs/std/_index.md
@@ -2,8 +2,8 @@
 title: "Standard library"
 description: ""
 summary: ""
-date: 2026-03-22T11:46:51+02:00
-lastmod: 2026-03-22T11:46:51+02:00
+date: 2026-03-22T13:08:00+02:00
+lastmod: 2026-03-22T13:08:00+02:00
 draft: false
 weight: 400
 toc: true
