docs: fix core flows reference not generating (#12274)

www/utils/packages/utils/src/hooks-util.ts

@@ -2,7 +2,9 @@ import {
   DeclarationReflection,
   IntrinsicType,
   ParameterReflection,
+  ReferenceType,
   Reflection,
+  ReflectionType,
 } from "typedoc"
 
 export function getHookChildren(
@@ -40,7 +42,13 @@ export function getHookChildren(
 
 export function cleanUpHookInput(
   parameters: ParameterReflection[]
-): ParameterReflection[] {
+): (ParameterReflection | DeclarationReflection)[] {
+  const hasInvokeParameter = parameters.some(
+    (parameter) => parameter.name === "invoke"
+  )
+  if (hasInvokeParameter) {
+    return getHookInputFromInvoke(parameters)
+  }
   return parameters.map((parameter) => {
     if (parameter.type?.type !== "reference" || !parameter.type.reflection) {
       return parameter
@@ -67,6 +75,11 @@ function cleanUpReflectionType(reflection: Reflection): Reflection {
   ) {
     return reflection
   }
+
+  if (reflection.name === "__type") {
+    reflection.name = "input"
+  }
+
   if (
     reflection.type?.type === "reference" &&
     reflection.type.name === "WorkflowData" &&
@@ -94,3 +107,35 @@ function cleanUpReflectionType(reflection: Reflection): Reflection {
 
   return reflection
 }
+
+function getHookInputFromInvoke(
+  parameters: ParameterReflection[]
+): DeclarationReflection[] {
+  const invokeParameter = parameters.find(
+    (parameter) =>
+      parameter.name === "invoke" &&
+      parameter.type?.type === "reference" &&
+      parameter.type.typeArguments?.length &&
+      parameter.type.typeArguments[0].type === "reflection"
+  )
+  if (!invokeParameter) {
+    return []
+  }
+
+  const reflection = cleanUpReflectionType(
+    (
+      (invokeParameter.type as ReferenceType)
+        .typeArguments![0] as ReflectionType
+    ).declaration
+  )
+
+  if (
+    reflection &&
+    reflection instanceof DeclarationReflection &&
+    reflection.children
+  ) {
+    reflection.children.forEach(cleanUpReflectionType)
+  }
+
+  return [reflection] as DeclarationReflection[]
+}