fix(docs-gen): titles

Author: vasilev-alex

docs-gen/src/resources/helpers/if-parent-kind-is.ts

@@ -0,0 +1,7 @@
+import { DeclarationReflection } from 'typedoc';
+
+export function ifParentKindIs(this: DeclarationReflection, kindString: string, truthy: boolean = true, options: any) {
+  const equals = this.parent && this.parent.kindString === kindString;
+  
+  return !equals && !truthy ? options.fn(this) : options.inverse(this);
+}

docs-gen/src/resources/helpers/member-title.ts

@@ -1,10 +1,6 @@
-import { DeclarationReflection, ReflectionKind } from 'typedoc';
+import { DeclarationReflection } from 'typedoc';
 
 export function memberTitle(this: DeclarationReflection) {
-  if (this.parent?.kind === ReflectionKind.Enum) {
-    return '';
-  }
-
   const md = [];
 
   if (this.flags) {

docs-gen/src/resources/helpers/meta.ts

@@ -9,6 +9,15 @@ export function meta(this: ProjectReflection) {
 
     return findModuleRelection(reflection.children?.[0]);
   }
+  
+  function tagConverter(tag: string)  {
+    const tags = {
+      menucategory: 'category',
+      menuorder: 'menuOrder'
+    };
+    
+    return tags[tag] ?? tag;
+  }
 
   const moduleReflection = findModuleRelection(this);
 
@@ -20,7 +29,7 @@ export function meta(this: ProjectReflection) {
       if (tag.tagName !== 'description') {
         const escape = tag.tagName !== 'menuorder';
         const text = escape ? `'${tag.text}'` : tag.text;
-        md.push(`${tag.tagName === 'menuorder' ? 'menuOrder' : tag.tagName}: ${text}`.replace('\n', ''));
+        md.push(`${tagConverter(tag.tagName)}: ${text}`.replace('\n', ''));
       }
     });
     md.push('---');

docs-gen/src/resources/partials/member.hbs

@@ -7,9 +7,11 @@
 
 {{else}}
 
-{{#if memberTitle}}
+{{#ifParentKindIs 'Enumeration' false}}
+
 {{heading 3}} {{{ memberTitle }}}
-{{/if}}
+
+{{/ifParentKindIs}}
 
 {{/ifParentIsModule}}
 

packages/cubejs-client-core/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * @title @cubejs-client/core
  * @permalink /@cubejs-client-core
- * @category Cube.js Frontend
+ * @menuCategory Cube.js Frontend
  * @subcategory Reference
  * @menuOrder 2
  * @description Vanilla JavaScript Cube.js client.