refactor project, paths and definitionbuilder classes

extract functionality into classes and rework import structure

Author: ksjogo

dummy/_godot_defs/dynamic/@actions.d.ts

@@ -1,7 +1,7 @@
 import fs from "fs"
 import path from "path"
 
-import { TsGdProjectClass } from "../project/project"
+import { Paths } from "../project"
 
 import { ArrayDefinition } from "./custom_defs/array_def"
 import { DictionaryDefinition } from "./custom_defs/dictionary_def"
@@ -266,9 +266,9 @@ declare class Signal<T extends (...args: any[]) => any = () => void> {
 }
 `
 
-export const buildBase = () => {
+export default function writeBaseDefinitions(paths: Paths) {
   fs.writeFileSync(
-    path.join(TsGdProjectClass.Paths.staticGodotDefsPath, "@base.d.ts"),
+    path.join(paths.staticGodotDefsPath, "@base.d.ts"),
     baseFileContent
   )
 }

dummy/_godot_defs/dynamic/@asset_paths.d.ts

@@ -6,7 +6,7 @@ import {
   formatJsDoc,
   godotTypeToTsType,
   sanitizeGodotNameForTs,
-} from "./generate_library"
+} from "./generation_utils"
 
 export type GodotXMLMethod = {
   $: {

dummy/_godot_defs/dynamic/@groups.d.ts

@@ -0,0 +1,154 @@
+export function sanitizeGodotNameForTs(
+  name: string,
+  type: "argument" | "property"
+): string {
+  if (
+    name === "with" ||
+    name === "var" ||
+    name === "class" ||
+    name === "enum" ||
+    name === "default" ||
+    name === "in"
+  ) {
+    if (type === "argument") {
+      return "_" + name
+    } else {
+      return `"${name}"`
+    }
+  }
+
+  // for enum names in @GlobalScope
+  name = name.replace(".", "_")
+
+  // Bizarre case in SliderJoint3D.xml
+  if (name.includes("/")) {
+    if (type === "argument") {
+      return name.replace("/", "_")
+    } else {
+      return `"${name}"`
+    }
+  }
+
+  return name
+}
+
+export function godotTypeToTsType(godotType: string): string {
+  if (godotType === "int") {
+    return "int"
+  }
+
+  if (godotType === "float") {
+    return "float"
+  }
+
+  if (godotType === "bool") {
+    return "boolean"
+  }
+
+  if (godotType === "Array") {
+    return "any[]"
+  }
+
+  if (godotType === "PackedScene") {
+    return "PackedScene<any>"
+  }
+
+  if (godotType === "Variant") {
+    return "any"
+  }
+
+  if (godotType === "String") {
+    return "string"
+  }
+
+  if (godotType.startsWith("Transform2D")) {
+    return "Transform2D"
+  }
+
+  if (godotType === "Dictionary") {
+    return "Dictionary<any, any>"
+  }
+
+  if (godotType === "NodePath") {
+    // TODO
+    return "NodePathType"
+  }
+
+  if (godotType.match(/^[0-9]+$/)) {
+    return "int"
+  }
+
+  return godotType
+}
+
+export function formatJsDoc(input: string): string {
+  if (!input) {
+    return `/** No documentation provided. */`
+  }
+
+  let lines = input.split("\n")
+
+  if (lines.length === 1) {
+    return `/** ${input} */`
+  }
+
+  const indentationLength = lines[1].length - lines[1].trimStart().length
+
+  // All lines are indented except the first one for some reason.
+  lines = [
+    lines[0],
+    ...lines.slice(1).map((line) => line.slice(indentationLength)),
+  ]
+
+  lines = lines.filter((line) => line.trim() !== "")
+
+  let result = "/**\n"
+
+  let insideCodeBlock = false
+
+  for (let line of lines) {
+    if (line.includes("[codeblock]")) {
+      result += " * @example \n"
+      insideCodeBlock = true
+    }
+
+    if (line.includes("[/codeblock]")) {
+      result += " * @summary \n"
+      insideCodeBlock = false
+    }
+
+    if (line.includes("[codeblocks]")) {
+      result += " * @example \n"
+      insideCodeBlock = true
+    }
+
+    if (line.includes("[/codeblocks]")) {
+      result += " * @summary \n"
+      insideCodeBlock = false
+    }
+
+    line = line.replaceAll("[gdscript]", "")
+    line = line.replaceAll("[/gdscript]", "")
+    line = line.replaceAll("[csharp]", "")
+    line = line.replaceAll("[/csharp]", "")
+    line = line.replaceAll("[b]", "**")
+    line = line.replaceAll("[/b]", "**")
+    line = line.replaceAll("[i]", "**")
+    line = line.replaceAll("[/i]", "**")
+    line = line.replaceAll("[code]", "`")
+    line = line.replaceAll("[/code]", "`")
+    line = line.replaceAll("[codeblock]", "")
+    line = line.replaceAll("[/codeblock]", "")
+    line = line.replaceAll("[codeblocks]", "")
+    line = line.replaceAll("[/codeblocks]", "")
+
+    // This is the most fun edge case of all time - in RichTextLabel.xml
+    line = line.replaceAll("*/", "")
+
+    result += " * " + line + "\n" + (!insideCodeBlock ? " *\n" : "")
+  }
+
+  result += "*/"
+
+  return result
+}

dummy/_godot_defs/dynamic/@scenes.d.ts

@@ -0,0 +1,2 @@
+export * from "./library_builder"
+export { default } from "./library_builder"