chore: docs

Author: mathuo

packages/docs/src/components/ui/reference/docRef.tsx

@@ -43,8 +43,26 @@ type DocsJson = {
 
 const newJson = docsJson_ as ExportedTypeFile;
 
-// console.log('test', (newJson['DockviewApi'] as any).children);
-console.log('test', firstLevel((newJson['DockviewApi'] as any).children[29]));
+console.log(newJson);
+
+export const DocumentRef = (props: { value: TypeSystem.Type }) => {
+    if (!props.value) {
+        return null;
+    }
+
+    switch (props.value.kind) {
+        case 'typealias':
+            return codify(props.value);
+        case 'interface':
+            return codify(props.value);
+        case 'class':
+            return codify(props.value);
+        case 'function':
+            return codify(props.value);
+        default:
+            return <div>{'error'}</div>;
+    }
+};
 
 export const Text = (props: { content: DocsContent[] }) => {
     return (
@@ -96,69 +114,6 @@ export const Markdown = (props: { children: string }) => {
     return <span>{props.children}</span>;
 };
 
-const ClassPiece = (props: { value: DocJson; name: string }) => {
-    let code = `interface ${props.name} {\n`;
-
-    code += props.value.children
-        .map((child) => {
-            switch (child.kind) {
-                case 'accessor':
-                    return `\t${child.name}: ${child.code};`;
-                case 'method':
-                    return `\t${child.name}${child.code};`;
-                default:
-                    return null;
-            }
-        })
-        .filter(Boolean)
-        .join('\n');
-
-    code += `\n}`;
-
-    return <CodeBlock language="tsx">{code}</CodeBlock>;
-};
-
-const InterfacePiece = (props: { value: DocJson; name: string }) => {
-    let code = `interface ${props.name} {\n`;
-
-    code += props.value.children
-        .map((child) => {
-            switch (child.kind) {
-                case 'property':
-                    return `\t${child.name}: ${child.code};`;
-                default:
-                    return null;
-            }
-        })
-        .join('\n');
-
-    code += `\n}`;
-
-    return <CodeBlock language="tsx">{code}</CodeBlock>;
-};
-
-const Piece = (props: { piece: string }) => {
-    const item = docsJson[props.piece];
-
-    if (!item) {
-        return null;
-    }
-
-    if (item.kind === 'class') {
-        return <ClassPiece name={props.piece} value={item} />;
-    }
-
-    if (item.kind === 'interface') {
-        return <InterfacePiece name={props.piece} value={item} />;
-    }
-
-    if (!item.metadata?.code) {
-        return null;
-    }
-
-    return <CodeBlock language="tsx">{item.metadata.code}</CodeBlock>;
-};
-
 const Row = (props: { doc: TypeSystem.Type }) => {
     const comment =
         props.doc.kind === 'accessor'
@@ -259,7 +214,7 @@ export const DocRef = (props: DocRefProps) => {
                             <div>
                                 {firstLevel(doc).map((x) => (
                                     <span style={{ padding: '0px 2px' }}>
-                                        {x}
+                                        <DocumentRef value={newJson[x]} />
                                     </span>
                                 ))}
                             </div>

packages/docs/src/components/ui/reference/types.ts

@@ -154,6 +154,11 @@ export function codify(value: TypeSystem.Type | null) {
 
     if (value.kind === 'property') {
         let code = '';
+
+        if (value.flags.isProtected) {
+            code += 'protected ';
+        }
+
         if (value.flags.isReadonly) {
             code += 'readonly ';
         }
@@ -222,6 +227,18 @@ export function codify(value: TypeSystem.Type | null) {
         return '';
     }
 
+    if (value.kind === 'interface') {
+        return `interface ${value.name} { ${value.children
+            .map(codify)
+            .join(',')} }`;
+    }
+
+    if (value.kind === 'class') {
+        return `interface ${value.name} { ${value.children
+            .map(codify)
+            .join(',')} }`;
+    }
+
     console.log('unreachable', value);
     throw new Error(`unreachable`);
 }
@@ -266,6 +283,13 @@ export namespace TypeSystem {
         comment?: Comment;
     };
 
+    export type Function = {
+        name: string;
+        kind: 'function';
+        signature: TypeSystem.CallSignature;
+        comment?: Comment;
+    };
+
     export type Property = {
         kind: 'property';
         name: string;
@@ -302,6 +326,13 @@ export namespace TypeSystem {
         comment?: Comment;
     };
 
+    export type Interface = {
+        name: string;
+        kind: 'interface';
+        children: TypeSystem.Type[];
+        comment?: Comment;
+    };
+
     export type Parameter = {
         name: string;
         kind: 'parameter';
@@ -342,7 +373,9 @@ export namespace TypeSystem {
         | TypeSystem.Constructor
         | TypeSystem.ConstructorSignature
         | TypeSystem.TypeLiteral
-        | TypeSystem.Parameter;
+        | TypeSystem.Parameter
+        | TypeSystem.Interface
+        | TypeSystem.Function;
 }
 
 export namespace TypeDescriptor {