@doccov/fumadocs-adapter 0.0.1 → 0.0.3

package/src/components/interface-page.tsx

@@ -1,20 +1,33 @@
 'use client';
 
 import type { OpenPkg, SpecExport } from '@openpkg-ts/spec';
+import { CoverageBadge } from './coverage-badge';
+import { ExamplesSection } from './examples';
 import { Signature } from './signature';
 import { TypeTable } from './type-table';
-import { ExamplesSection } from './examples';
-import { CoverageBadge } from './coverage-badge';
+
+function formatSchema(schema: unknown): string {
+  if (!schema) return 'unknown';
+  if (typeof schema === 'string') return schema;
+  if (typeof schema === 'object' && schema !== null) {
+    const s = schema as Record<string, unknown>;
+    if (s.$ref && typeof s.$ref === 'string') {
+      return s.$ref.replace('#/types/', '');
+    }
+    if (s.type) return String(s.type);
+  }
+  return 'unknown';
+}
 
 export interface InterfacePageProps {
   export: SpecExport;
   spec: OpenPkg;
 }
 
-export function InterfacePage({ export: exp, spec }: InterfacePageProps) {
+export function InterfacePage({ export: exp, spec }: InterfacePageProps): React.ReactNode {
   // For interfaces/types, members are the properties
   const properties = exp.members?.filter(
-    (m) => m.kind === 'property' || m.kind === 'field' || !m.kind
+    (m) => m.kind === 'property' || m.kind === 'field' || !m.kind,
   );
   const methods = exp.members?.filter((m) => m.kind === 'method' || m.kind === 'function');
 
@@ -57,7 +70,7 @@ export function InterfacePage({ export: exp, spec }: InterfacePageProps) {
             {methods.map((method, index) => {
               const sig = method.signatures?.[0];
               const params = sig?.parameters ?? [];
-              const returnType = sig?.returns?.tsType ?? 'void';
+              const returnType = formatSchema(sig?.returns?.schema);
 
               return (
                 <div key={method.name ?? index} className="rounded-lg border border-fd-border p-4">
@@ -66,8 +79,7 @@ export function InterfacePage({ export: exp, spec }: InterfacePageProps) {
                     {params
                       .map((p) => {
                         const optional = p.required === false ? '?' : '';
-                        const type =
-                          typeof p.schema === 'string' ? p.schema : (p.schema as any)?.tsType ?? 'any';
+                        const type = formatSchema(p.schema);
                         return `${p.name}${optional}: ${type}`;
                       })
                       .join(', ')}
@@ -91,4 +103,3 @@ export function InterfacePage({ export: exp, spec }: InterfacePageProps) {
     </div>
   );
 }
-

package/src/components/members-section.tsx

@@ -1,7 +1,6 @@
 'use client';
 
-import type { SpecMember, OpenPkg } from '@openpkg-ts/spec';
-import { TypeTable } from './type-table';
+import type { OpenPkg, SpecMember } from '@openpkg-ts/spec';
 
 export interface MembersSectionProps {
   members: SpecMember[];
@@ -17,7 +16,6 @@ function formatSchema(schema: unknown): string {
     if (s.$ref && typeof s.$ref === 'string') {
       return s.$ref.replace('#/types/', '');
     }
-    if (s.tsType) return String(s.tsType);
     if (s.type) return String(s.type);
   }
   return 'unknown';
@@ -76,11 +74,12 @@ function MemberRow({ member }: { member: SpecMember }) {
   const sig = member.signatures?.[0];
   let signature = '';
   if (sig) {
-    const params = sig.parameters?.map((p) => {
-      const optional = p.required === false ? '?' : '';
-      return `${p.name}${optional}: ${formatSchema(p.schema)}`;
-    }) ?? [];
-    const returnType = sig.returns?.tsType ?? formatSchema(sig.returns?.schema) ?? 'void';
+    const params =
+      sig.parameters?.map((p) => {
+        const optional = p.required === false ? '?' : '';
+        return `${p.name}${optional}: ${formatSchema(p.schema)}`;
+      }) ?? [];
+    const returnType = formatSchema(sig.returns?.schema) ?? 'void';
     signature = `(${params.join(', ')}): ${returnType}`;
   }
 
@@ -114,7 +113,11 @@ function MemberRow({ member }: { member: SpecMember }) {
   );
 }
 
-export function MembersSection({ members, spec, title = 'Members' }: MembersSectionProps) {
+export function MembersSection({
+  members,
+  spec: _spec,
+  title = 'Members',
+}: MembersSectionProps): React.ReactNode {
   if (!members?.length) return null;
 
   const groups = groupMembersByKind(members);
@@ -190,4 +193,3 @@ export function MembersSection({ members, spec, title = 'Members' }: MembersSect
     </div>
   );
 }
-

package/src/components/method-section.tsx

@@ -13,6 +13,9 @@ export interface MethodSectionProps {
  * Method display section with collapsible behavior
  * @deprecated Use CollapsibleMethod directly for more control
  */
-export function MethodSection({ member, defaultExpanded = false }: MethodSectionProps) {
+export function MethodSection({
+  member,
+  defaultExpanded = false,
+}: MethodSectionProps): React.ReactNode {
   return <CollapsibleMethod member={member} defaultExpanded={defaultExpanded} />;
 }

package/src/components/parameter-card.tsx

@@ -15,13 +15,12 @@ function formatSchema(schema: unknown): string {
     if (s.$ref && typeof s.$ref === 'string') {
       return s.$ref.replace('#/types/', '');
     }
-    if (s.tsType) return String(s.tsType);
     if (s.type) return String(s.type);
   }
   return 'unknown';
 }
 
-export function ParameterCard({ param, spec }: ParameterCardProps) {
+export function ParameterCard({ param, spec: _spec }: ParameterCardProps): React.ReactNode {
   const type = formatSchema(param.schema);
   const isRequired = param.required !== false;
 
@@ -38,15 +37,11 @@ export function ParameterCard({ param, spec }: ParameterCardProps) {
       </div>
 
       {/* Type */}
-      <div className="text-sm text-fd-muted-foreground font-mono">
-        {type}
-      </div>
+      <div className="text-sm text-fd-muted-foreground font-mono">{type}</div>
 
       {/* Description */}
       {param.description && (
-        <p className="text-sm text-fd-muted-foreground mt-2">
-          {param.description}
-        </p>
+        <p className="text-sm text-fd-muted-foreground mt-2">{param.description}</p>
       )}
     </div>
   );

package/src/components/signature.tsx

@@ -38,7 +38,6 @@ function formatSchema(schema: unknown): string {
     if (s.$ref && typeof s.$ref === 'string') {
       return s.$ref.replace('#/types/', '');
     }
-    if (s.tsType) return String(s.tsType);
     if (s.type) return String(s.type);
   }
   return 'unknown';
@@ -46,7 +45,6 @@ function formatSchema(schema: unknown): string {
 
 function formatReturnType(sig?: SpecSignature): string {
   if (!sig?.returns) return 'void';
-  if (sig.returns.tsType) return sig.returns.tsType;
   return formatSchema(sig.returns.schema);
 }
 
@@ -85,7 +83,7 @@ function buildSignatureString(exp: SpecExport, sigIndex = 0): string {
   }
 }
 
-export function Signature({ export: exp, signatureIndex = 0 }: SignatureProps) {
+export function Signature({ export: exp, signatureIndex = 0 }: SignatureProps): React.ReactNode {
   const signature = buildSignatureString(exp, signatureIndex);
 
   // Build RawCode for syntax highlighting

package/src/components/type-table.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import type { OpenPkg, SpecSignatureParameter, SpecMember } from '@openpkg-ts/spec';
+import type { OpenPkg, SpecMember, SpecSignatureParameter } from '@openpkg-ts/spec';
 
 export interface TypeTableProps {
   items: (SpecSignatureParameter | SpecMember)[];
@@ -20,8 +20,6 @@ function formatSchema(schema: unknown): string {
     }
     // Handle type
     if (s.type) return String(s.type);
-    // Handle tsType
-    if (s.tsType) return String(s.tsType);
   }
   return 'unknown';
 }
@@ -30,7 +28,7 @@ function isParameter(item: SpecSignatureParameter | SpecMember): item is SpecSig
   return 'required' in item;
 }
 
-export function TypeTable({ items, showRequired = true }: TypeTableProps) {
+export function TypeTable({ items, showRequired = true }: TypeTableProps): React.ReactNode {
   if (!items?.length) return null;
 
   return (
@@ -40,7 +38,9 @@ export function TypeTable({ items, showRequired = true }: TypeTableProps) {
           <tr className="border-b border-fd-border">
             <th className="text-left py-2 px-3 font-medium text-fd-muted-foreground">Name</th>
             <th className="text-left py-2 px-3 font-medium text-fd-muted-foreground">Type</th>
-            <th className="text-left py-2 px-3 font-medium text-fd-muted-foreground">Description</th>
+            <th className="text-left py-2 px-3 font-medium text-fd-muted-foreground">
+              Description
+            </th>
           </tr>
         </thead>
         <tbody>
@@ -56,9 +56,7 @@ export function TypeTable({ items, showRequired = true }: TypeTableProps) {
                   <code className="text-fd-primary font-mono text-xs bg-fd-secondary px-1.5 py-0.5 rounded">
                     {name}
                   </code>
-                  {showRequired && required && (
-                    <span className="ml-1 text-red-500 text-xs">*</span>
-                  )}
+                  {showRequired && required && <span className="ml-1 text-red-500 text-xs">*</span>}
                   {showRequired && !required && (
                     <span className="ml-1 text-fd-muted-foreground text-xs">?</span>
                   )}
@@ -66,9 +64,7 @@ export function TypeTable({ items, showRequired = true }: TypeTableProps) {
                 <td className="py-2 px-3 align-top">
                   <code className="font-mono text-xs text-fd-muted-foreground">{type}</code>
                 </td>
-                <td className="py-2 px-3 align-top text-fd-muted-foreground">
-                  {description}
-                </td>
+                <td className="py-2 px-3 align-top text-fd-muted-foreground">{description}</td>
               </tr>
             );
           })}
@@ -77,4 +73,3 @@ export function TypeTable({ items, showRequired = true }: TypeTableProps) {
     </div>
   );
 }
-

package/src/components/variable-page.tsx

@@ -17,13 +17,12 @@ function formatSchema(schema: unknown): string {
     if (s.$ref && typeof s.$ref === 'string') {
       return s.$ref.replace('#/types/', '');
     }
-    if (s.tsType) return String(s.tsType);
     if (s.type) return String(s.type);
   }
   return 'unknown';
 }
 
-export function VariablePage({ export: exp, spec }: VariablePageProps) {
+export function VariablePage({ export: exp, spec: _spec }: VariablePageProps): React.ReactNode {
   const typeValue = typeof exp.type === 'string' ? exp.type : formatSchema(exp.schema);
   const hasExamples = exp.examples && exp.examples.length > 0;
 
@@ -31,9 +30,7 @@ export function VariablePage({ export: exp, spec }: VariablePageProps) {
     <div className="space-y-8">
       {/* Description */}
       {exp.description && (
-        <p className="text-fd-muted-foreground text-lg leading-relaxed">
-          {exp.description}
-        </p>
+        <p className="text-fd-muted-foreground text-lg leading-relaxed">{exp.description}</p>
       )}
 
       {/* Declaration */}
@@ -63,10 +60,7 @@ export function VariablePage({ export: exp, spec }: VariablePageProps) {
             <h3 className="text-sm font-semibold uppercase tracking-wide text-fd-muted-foreground mb-3">
               {exp.name} usage
             </h3>
-            <CodeExample 
-              code={exp.examples![0]} 
-              filename={`${exp.name.toLowerCase()}.ts`}
-            />
+            <CodeExample code={exp.examples![0]} filename={`${exp.name.toLowerCase()}.ts`} />
           </div>
         )}
       </div>

package/src/index.ts

@@ -1,8 +1,7 @@
 // Server
-export { createOpenPkg } from './server';
-export type { OpenPkgInstance, OpenPkgOptions } from './server';
 
+export type { APIPageProps } from './components/api-page';
 // Components
 export { APIPage } from './components/api-page';
-export type { APIPageProps } from './components/api-page';
-
+export type { OpenPkgInstance, OpenPkgOptions } from './server';
+export { createOpenPkg } from './server';

package/src/server.ts

@@ -77,4 +77,3 @@ export function createOpenPkg(options: OpenPkgOptions): OpenPkgInstance {
     },
   };
 }
-

package/src/styles/docskit.css

@@ -1,12 +1,12 @@
 /**
  * Docskit CSS Variables for Fumadocs
- * 
+ *
  * This file defines the CSS variables needed for @doccov/ui docskit components
  * to work within Fumadocs themes.
- * 
+ *
  * Import this in your global CSS:
  *   @import '@doccov/fumadocs-adapter/css';
- * 
+ *
  * Or add these variables to your Tailwind CSS:
  *   @import 'tailwindcss';
  *   @import 'fumadocs-ui/css/neutral.css';
@@ -23,14 +23,15 @@
     --dk-tab-inactive-foreground: var(--color-fd-muted-foreground, hsl(0 0% 60%));
     --dk-tab-active-foreground: var(--color-fd-foreground, hsl(0 0% 98%));
     --dk-selection: var(--color-fd-primary, hsl(220 70% 50%));
-    
+
     /* Line highlight colors */
     --dk-line-bg: transparent;
     --dk-line-border: transparent;
   }
 
   /* Light mode overrides if needed */
-  .light, [data-theme="light"] {
+  .light,
+  [data-theme="light"] {
     --dk-background: var(--color-fd-card, hsl(0 0% 98%));
     --dk-border: var(--color-fd-border, hsl(0 0% 85%));
     --dk-tabs-background: var(--color-fd-muted, hsl(0 0% 95%));
@@ -97,7 +98,8 @@
   }
 
   /* GitHub Light theme */
-  .light, [data-theme="light"] {
+  .light,
+  [data-theme="light"] {
     --ch-0: #24292f; /* default text */
     --ch-1: #cf222e; /* strings, inherited class */
     --ch-2: #116329; /* string literals */
@@ -127,4 +129,3 @@
     --ch-26: #ffffffe6;
   }
 }
-

package/tsconfig.json

@@ -18,4 +18,3 @@
   "include": ["src/**/*"],
   "exclude": ["node_modules", "dist"]
 }
-