Site: Rework Lua API appearance and functionality

doc/site/layouts/docs/lua_api.html

@@ -118,8 +118,7 @@ <h3 class="display-inline">
 */}}
 {{ define "render_alias"}}
 	{{ $level := .level }}
-	{{ $name_path := append (slice "type" ( replace .data.name "." "-" )) .name_path }}
-	{{ $name_path_string := delimit $name_path "-" }}
+	{{ $name_path_string := index .type_info .data.name }}
 	{{ $type_info := .type_info }}
 
 	{{ with .data }}
@@ -141,8 +140,7 @@ <h3 class="display-inline">
 */}}
 {{ define "render_class" }}
 	{{ $level := .level }}
-	{{ $name_path := append (slice "type" ( replace .data.name "." "-" )) .name_path }}
-	{{ $name_path_string := delimit $name_path "-" }}
+	{{ $name_path_string := index .type_info .data.name }}
 	{{ $type_info := .type_info }}
 
 	{{ with .data }}
@@ -164,7 +162,7 @@ <h3 class="display-inline">
 					{{ template "leveled_tag_closer" $level }} {{ template "render_common" (dict "data" . "type_info" $type_info) }}
 				</summary>
 				{{ range sort .members "name" }}
-					{{ template "render_member" (dict "data" . "level" (add $level 1) "name_path" $name_path "type_info" $type_info) }}
+					{{ template "render_member" (dict "data" . "level" (add $level 1) "type_info" $type_info) }}
 				{{ end }}
 			</details>
 		</div>
@@ -177,8 +175,7 @@ <h3 class="display-inline">
 */}}
 {{ define "render_enum" }}
 	{{ $level := .level }}
-	{{ $name_path := append (slice "type" ( replace .data.name "." "-" )) .name_path }}
-	{{ $name_path_string := delimit $name_path "-" }}
+	{{ $name_path_string := index .type_info .data.name }}
 	{{ $type_info := .type_info }}
 
 	{{ with .data }}
@@ -193,7 +190,7 @@ <h3 class="display-inline">
 					{{ template "leveled_tag_closer" $level }} {{ template "render_common" (dict "data" . "type_info" $type_info) }}
 				</summary>
 				{{ range sort .members "name" }}
-					{{ template "render_member" (dict "data" . "level" (add $level 1) "name_path" $name_path "type_info" $type_info) }}
+					{{ template "render_member" (dict "data" . "level" (add $level 1) "type_info" $type_info) }}
 				{{ end }}
 			</details>
 		</div>
@@ -206,8 +203,7 @@ <h3 class="display-inline">
 */}}
 {{ define "render_table" }}
 	{{ $level := .level }}
-	{{ $name_path := append (slice "property" ( replace .data.name "." "-" )) .name_path }}
-	{{ $name_path_string := delimit $name_path "-" }}
+	{{ $name_path_string := index .type_info .data.name }}
 	{{ $type_info := .type_info }}
 
 	{{ with .data }}
@@ -223,7 +219,7 @@ <h3 class="display-inline">
 					{{ template "leveled_tag_closer" $level }} {{ template "render_common" (dict "data" . "type_info" $type_info) }}
 				</summary>
 				{{ range sort .members "name" }}
-					{{ template "render_member" (dict "data" . "level" (add $level 1) "name_path" $name_path "type_info" $type_info) }}
+					{{ template "render_member" (dict "data" . "level" (add $level 1) "type_info" $type_info) }}
 				{{ end }}
 			</details>
 		</div>
@@ -236,8 +232,7 @@ <h3 class="display-inline">
 */}}
 {{ define "render_function" }}
 	{{ $level := .level }}
-	{{ $name_path := append (slice "property" ( replace .data.name "." "-" )) .name_path }}
-	{{ $name_path_string := delimit $name_path "-" }}
+	{{ $name_path_string := index .type_info .data.name }}
 	{{ $type_info := .type_info }}
 
 	{{ with .data }}
@@ -278,8 +273,7 @@ <h4>Returns</h4>
 */}}
 {{ define "render_field" }}
 	{{ $level := .level }}
-	{{ $name_path := append (slice "property" .data.name) .name_path }}
-	{{ $name_path_string := delimit $name_path "-" }}
+	{{ $name_path_string := index .type_info .data.name }}
 	{{ $type_info := .type_info }}
 
 	{{ with .data }}
@@ -318,7 +312,8 @@ <h4>Returns</h4>
 	{{- range uniq $words -}}
 		{{- if not ( collections.In $kw . ) -}}
 			{{- if not ( hasPrefix . `"`) -}} {{/* Hack to filter out strings in unions */}}
-				{{ with $link := (index $type_info .) }}
+				{{ $link := (index $type_info .) }}
+				{{ if $link }}
 					{{- $type_link := printf "[%s](#%s)" . $link -}}
 					{{- $typedef = replace $typedef . $type_link -}}
 				{{ end }}

doc/site/layouts/partials/analyze_globals.html

@@ -0,0 +1,13 @@
+{{ $result := dict }}
+
+{{ $root_name := .root_name }}
+
+{{ range .data }}
+    {{ $type := .type }}
+    {{ $name := (delimit (slice $root_name "." .name)) "." "-" }}
+    {{ $permalink := printf "%s-%s" $type $name }}
+    {{ $result = merge $result (dict $name $permalink) }}
+    {{ $result = merge $result (partial "analyze_globals.html" (dict "data" .members "root_name" $name))}}
+{{ end }}
+
+{{ return $result }}

doc/site/layouts/partials/analyze_types.html

@@ -6,10 +6,10 @@
 {{ $result := dict }} {{/* map[name]permalink */}}
 
 {{ range . }}
-    {{ $type := (partial "extract_type_name.html" .type) }}
-    {{ $name := replace .name "." "-" }}
+    {{ $type := .type }}
+    {{ $name := replace (partial "extract_type_name.html" .name) "." "-" }}
     {{ $permalink := printf "%s-%s" $type $name }}
-    {{ $result = merge $result (dict $type $permalink) }}
+    {{ $result = merge $result (dict $name $permalink) }}
 {{ end }}
 
 {{ return $result }}

doc/site/layouts/partials/build_globals_data.html

@@ -0,0 +1,32 @@
+{{/*
+member: {
+    name: string
+    permalink: string
+    description: string
+    deprecation_reason: string?
+    generics: []string
+    loc: {
+        file: string
+        line: integer
+    }
+    literal: string?
+    path: []string
+}
+table: member {
+    type: "table"
+    members: []member
+}
+field: member
+func: member {
+    params: []{
+        name: string
+        typ: string
+        desc: string?
+    }
+    returns: []{
+        name: string
+        typ: string
+        desc: string?
+    }
+}
+*/}}

doc/site/layouts/partials/extract_type_name.html

@@ -2,7 +2,7 @@
 Emmylua does this thing where either the type is truncated or the entire fucking alias is put in the type field.
 So this partial is for extracting a type name from a string, since that needs to be done in a few places.
 
-params: type_string atring
+params: type_string string
 returns: type_name string
 */}}
 

doc/site/layouts/partials/global_construction/construct_field.html

@@ -0,0 +1,15 @@
+{{ $data := .data }}
+{{ $path := .path }} {{/* path appended in construct_member */}}
+
+{{ $field := (dict 
+    "type" "field"
+    "name" $data.name
+    "description" $data.description
+    "deprecation_reason" $data.deprecation_reason
+    "loc" $data.loc
+    "method" $data.is_meth
+    "permalink" (printf "field-%s" (replace (delimit $path "-") "." "-"))
+    "type" (partial "extract_type_name.html" .typ)
+    )}}
+
+{{ return $field }}

doc/site/layouts/partials/global_construction/construct_function.html

@@ -0,0 +1,34 @@
+{{ $data := .data }}
+{{ $path := .path }} {{/* path appended in construct_member */}}
+
+{{ $fn := (dict 
+    "type" "fn"
+    "name" $data.name
+    "description" $data.description
+    "deprecation_reason" $data.deprecation_reason
+    "loc" $data.loc
+    "method" $data.is_meth
+    "permalink" (printf "fn-%s" (replace (delimit $path "-") "." "-"))
+    )}}
+
+{{ $params := slice }}
+{{ range $data.params }}
+    {{ $params = append $params (dict
+        "name" $data.name
+        "type" (partial "extract_type_name.html" .typ)
+        "desc" $data.desc
+        ) }}
+{{ end }}
+{{ $fn = merge $fn (dict "params" $params) }}
+
+{{ $returns := slice }}
+{{ range $data.returns }}
+    {{ $returns = append $returns (dict
+        "name" $data.name
+        "type" (partial "extract_type_name.html" .typ)
+        "desc" $data.desc
+        ) }}
+{{ end }}
+{{ $fn = merge $fn (dict "returns" $returns) }}
+
+{{ return $fn }}

doc/site/layouts/partials/global_construction/construct_member.html

@@ -0,0 +1,14 @@
+{{ $data := .data }}
+{{ $path := append .data.name .path }}
+
+{{ $res := dict }}
+
+{{ if eq .type "table" }}
+    {{ $res = (partial "global_construction/construct_table.html" (dict "data" $data "path" (append $data.name $path))) }}
+{{ else if eq .type "fn" }}
+    {{ $res = (partial "global_construction/construct_function.html" (dict "data" $data "path" (append $data.name $path))) }}
+{{ else if eq .type "field" }}
+    {{ $res = (partial "global_construction/construct_field.html" (dict "data" $data "path" (append $data.name $path))) }}
+{{ end }}
+
+{{ return $res }}

doc/site/layouts/partials/global_construction/construct_table.html

@@ -0,0 +1,20 @@
+{{ $data := .data }}
+{{ $path := .path }} {{/* path appended in construct_member */}}
+
+{{ $table := (dict
+    "type" "table"
+    "name" $data.name
+    "description" $data.description
+    "deprecation_reason" $data.deprecation_reason
+    "loc" $data.loc
+    "permalink" (printf "table-%s" (replace (delimit $path "-") "." "-"))
+    ) }}
+
+{{ $members := slice }}
+{{ range .members }}
+    {{ $members := append (partial "global_construction/construct_member.html" (dict "data" . "path" (append $data.name $path)) ) }}
+{{ end }}
+
+{{ $table = merge $table (dict "members" $members) }}
+
+{{ return $table }}