fix: render constructors as \new ClassName(params)\ format (closes #2)

Author: davanesh

plugins/theme/index.mjs

@@ -50,6 +50,79 @@ export class DocKitThemeContext extends MarkdownThemeContext {
     ...this.partials,
     ...typePartials,
 
+    constructor: (model, options) => {
+      return model.signatures?.map(signature => {
+        const params = signature.parameters ?? [];
+        const className = model.parent?.name ?? "Unknown";
+        const allOptional = params.length > 0 && 
+                            params.every(p => p.flags?.isOptional);
+        const paramStr = allOptional
+          ? `[${params.map(p => p.name).join(", ")}]`
+          : params.map(p => 
+              p.flags?.isOptional ? `[${p.name}]` : p.name
+            ).join(", ");
+        const title = `\`new ${className}(${paramStr})\``;
+        const paramsList = params.length 
+          ? this.helpers.typedList(params) 
+          : "";
+        return [
+          `#### ${title}`,
+          paramsList,
+        ].filter(Boolean).join("\n");
+      }).join("\n\n") ?? "";
+    },
+    // Removes *** horizontal rules between members
+    members: (model, options) => {
+      const items = model.filter(
+        (item) => !this.router.hasOwnDocument(item)
+      );
+      return items
+        .map(item =>
+          this.partials.memberContainer(item, {
+            headingLevel: options.headingLevel,
+            groupTitle: options.groupTitle,
+          })
+        )
+        .filter(Boolean)
+        .join("\n\n");
+    },
+
+    // Removes ### Constructors / ### Methods / ### Properties headings
+    groups: (model, options) => {
+      return (model.groups ?? [])
+        .flatMap(group => {
+          // Skip properties — already shown in constructor params
+          const isPropertiesGroup = group.children?.every(
+            child => child.kind === ReflectionKind.Property
+          );
+          if (isPropertiesGroup) return [];
+
+          const children = group.children?.filter(
+            child => child.isDeclaration()
+          ) ?? [];
+          if (!children.length) return [];
+
+          return [
+            this.partials.members(children, {
+              headingLevel: options.headingLevel,
+              groupTitle: group.title,
+            })
+          ];
+        })
+        .filter(Boolean)
+        .join("\n\n");
+    },
+
+    body: (model, options) => {
+      if (model.groups?.length) {
+        return this.partials.groups(model, {
+          headingLevel: options.headingLevel,
+          kind: model.kind,
+        });
+      }
+      return "";
+    },
+
     // Typed Lists
     parametersList: this.helpers.typedList,
     propertiesTable: this.helpers.typedList,
@@ -84,14 +157,38 @@ export class DocKitThemeContext extends MarkdownThemeContext {
 
     // Titles
     memberTitle: (model) => {
+      //DEBUG
+      // console.log("KIND:", model.kind, "NAME:", model.name, "CONSTRUCTOR KIND:", ReflectionKind.Constructor);
+      
       const prefix = resolveMemberPrefix(model);
       const params = model.signatures?.[0]?.parameters ?? null;
       const name = params
-        ? // TODO: If params optional, wrap in `[]`
-          `\`${model.name}(${params.map((p) => p.name).join(", ")})\``
+        ? `\`${model.name}(${params.map((p) => p.name).join(", ")})\``
         : `\`${model.name}\``;
       return prefix ? `${prefix}: ${name}` : name;
     },
+    declarationTitle: (model) => {
+      return this.helpers.typedListItem({
+        name: model.name,
+        type: model.type,
+        comment: model.comment,
+      });
+    },
+    memberContainer: (model, options) => {
+      const md = [];
+      if (!this.router.hasOwnDocument(model) &&
+          ![ReflectionKind.Constructor].includes(model.kind)) {
+        md.push(
+          "#".repeat(options.headingLevel) + " " + 
+          this.partials.memberTitle(model)
+        );
+      }
+      md.push(this.partials.member(model, {
+        headingLevel: options.headingLevel + 1, // ← methods get ####
+        nested: options.nested,
+      }));
+      return md.filter(Boolean).join("\n\n");
+    },
   };
 }