@doccov/fumadocs-adapter 0.0.2 → 0.0.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @doccov/fumadocs-adapter
 
+## 0.0.3
+
+### Patch Changes
+
+- Remove deprecated `tsType` field in favor of `schema`, add CLI warning when `--runtime` requested without built code
+
 ## 0.0.2
 
 ### Patch Changes

package/dist/components/index.d.ts

@@ -42,19 +42,19 @@ interface APIPageProps {
 * <APIPage instance={openpkg} id="createClient" />
 * ```
 */
-declare function APIPage({ spec, instance, id }: APIPageProps);
+declare function APIPage({ spec, instance, id }: APIPageProps): React.ReactNode;
 import { OpenPkg as OpenPkg3, SpecExport as SpecExport2 } from "@openpkg-ts/spec";
 interface ClassPageProps {
 	export: SpecExport2;
 	spec: OpenPkg3;
 }
-declare function ClassPage({ export: exp, spec }: ClassPageProps);
+declare function ClassPage({ export: exp, spec: _spec }: ClassPageProps): React.ReactNode;
 interface CodeExampleProps {
 	code: string;
 	filename?: string;
 	language?: string;
 }
-declare function CodeExample({ code, filename, language }: CodeExampleProps);
+declare function CodeExample({ code, filename, language }: CodeExampleProps): React.ReactNode;
 import { SpecMember } from "@openpkg-ts/spec";
 interface CollapsibleMethodProps {
 	member: SpecMember;
@@ -64,24 +64,24 @@ interface CollapsibleMethodProps {
 * Collapsible method section with expand/collapse behavior
 * Shows compact signature when collapsed, full details when expanded
 */
-declare function CollapsibleMethod({ member, defaultExpanded }: CollapsibleMethodProps);
+declare function CollapsibleMethod({ member, defaultExpanded }: CollapsibleMethodProps): React.ReactNode;
 import { SpecDocsMetadata } from "@openpkg-ts/spec";
 interface CoverageBadgeProps {
 	docs: SpecDocsMetadata;
 	showMissing?: boolean;
 	showDrift?: boolean;
 }
-declare function CoverageBadge({ docs, showMissing, showDrift }: CoverageBadgeProps);
+declare function CoverageBadge({ docs, showMissing, showDrift }: CoverageBadgeProps): React.ReactNode;
 import { OpenPkg as OpenPkg4, SpecExport as SpecExport3 } from "@openpkg-ts/spec";
 interface EnumPageProps {
 	export: SpecExport3;
 	spec: OpenPkg4;
 }
-declare function EnumPage({ export: exp, spec }: EnumPageProps);
+declare function EnumPage({ export: exp, spec: _spec }: EnumPageProps): React.ReactNode;
 interface ExamplesSectionProps {
 	examples: string[];
 }
-declare function ExamplesSection({ examples }: ExamplesSectionProps);
+declare function ExamplesSection({ examples }: ExamplesSectionProps): React.ReactNode;
 import { SpecSchema, SpecSignatureParameter } from "@openpkg-ts/spec";
 interface ExpandablePropertyProps {
 	param: SpecSignatureParameter;
@@ -96,31 +96,31 @@ interface NestedPropertyProps {
 /**
 * Nested property row with expandable nested objects
 */
-declare function NestedProperty({ name, schema, required, depth }: NestedPropertyProps);
+declare function NestedProperty({ name, schema, required, depth }: NestedPropertyProps): React.ReactNode;
 /**
 * Top-level expandable property for method parameters
 * Entry point for rendering a parameter with progressive disclosure
 */
-declare function ExpandableProperty({ param, depth }: ExpandablePropertyProps);
+declare function ExpandableProperty({ param, depth }: ExpandablePropertyProps): React.ReactNode;
 import { OpenPkg as OpenPkg5, SpecExport as SpecExport4 } from "@openpkg-ts/spec";
 interface FunctionPageProps {
 	export: SpecExport4;
 	spec: OpenPkg5;
 }
-declare function FunctionPage({ export: exp, spec }: FunctionPageProps);
+declare function FunctionPage({ export: exp, spec }: FunctionPageProps): React.ReactNode;
 import { OpenPkg as OpenPkg6, SpecExport as SpecExport5 } from "@openpkg-ts/spec";
 interface InterfacePageProps {
 	export: SpecExport5;
 	spec: OpenPkg6;
 }
-declare function InterfacePage({ export: exp, spec }: InterfacePageProps);
+declare function InterfacePage({ export: exp, spec }: InterfacePageProps): React.ReactNode;
 import { OpenPkg as OpenPkg7, SpecMember as SpecMember2 } from "@openpkg-ts/spec";
 interface MembersSectionProps {
 	members: SpecMember2[];
 	spec?: OpenPkg7;
 	title?: string;
 }
-declare function MembersSection({ members, spec, title }: MembersSectionProps);
+declare function MembersSection({ members, spec: _spec, title }: MembersSectionProps): React.ReactNode;
 import { SpecMember as SpecMember3 } from "@openpkg-ts/spec";
 interface MethodSectionProps {
 	member: SpecMember3;
@@ -131,30 +131,30 @@ interface MethodSectionProps {
 * Method display section with collapsible behavior
 * @deprecated Use CollapsibleMethod directly for more control
 */
-declare function MethodSection({ member, defaultExpanded }: MethodSectionProps);
+declare function MethodSection({ member, defaultExpanded }: MethodSectionProps): React.ReactNode;
 import { OpenPkg as OpenPkg8, SpecSignatureParameter as SpecSignatureParameter2 } from "@openpkg-ts/spec";
 interface ParameterCardProps {
 	param: SpecSignatureParameter2;
 	spec?: OpenPkg8;
 }
-declare function ParameterCard({ param, spec }: ParameterCardProps);
+declare function ParameterCard({ param, spec: _spec }: ParameterCardProps): React.ReactNode;
 import { SpecExport as SpecExport6 } from "@openpkg-ts/spec";
 interface SignatureProps {
 	export: SpecExport6;
 	signatureIndex?: number;
 }
-declare function Signature({ export: exp, signatureIndex }: SignatureProps);
+declare function Signature({ export: exp, signatureIndex }: SignatureProps): React.ReactNode;
 import { OpenPkg as OpenPkg9, SpecMember as SpecMember4, SpecSignatureParameter as SpecSignatureParameter3 } from "@openpkg-ts/spec";
 interface TypeTableProps {
 	items: (SpecSignatureParameter3 | SpecMember4)[];
 	spec?: OpenPkg9;
 	showRequired?: boolean;
 }
-declare function TypeTable({ items, showRequired }: TypeTableProps);
+declare function TypeTable({ items, showRequired }: TypeTableProps): React.ReactNode;
 import { OpenPkg as OpenPkg10, SpecExport as SpecExport7 } from "@openpkg-ts/spec";
 interface VariablePageProps {
 	export: SpecExport7;
 	spec: OpenPkg10;
 }
-declare function VariablePage({ export: exp, spec }: VariablePageProps);
+declare function VariablePage({ export: exp, spec: _spec }: VariablePageProps): React.ReactNode;
 export { VariablePageProps, VariablePage, TypeTableProps, TypeTable, SignatureProps, Signature, ParameterCardProps, ParameterCard, NestedPropertyProps, NestedProperty, MethodSectionProps, MethodSection, MembersSectionProps, MembersSection, InterfacePageProps, InterfacePage, FunctionPageProps, FunctionPage, ExpandablePropertyProps, ExpandableProperty, ExamplesSectionProps, ExamplesSection, EnumPageProps, EnumPage, CoverageBadgeProps, CoverageBadge, CollapsibleMethodProps, CollapsibleMethod, CodeExampleProps, CodeExample, ClassPageProps, ClassPage, APIPageProps, APIPage };

package/dist/components/index.js

@@ -15,7 +15,7 @@ import {
   Signature,
   TypeTable,
   VariablePage
-} from "../shared/chunk-mmca4gp7.js";
+} from "../shared/chunk-edfpjshy.js";
 // src/components/members-section.tsx
 import { jsxDEV } from "react/jsx-dev-runtime";
 
@@ -29,8 +29,6 @@ function formatSchema(schema) {
     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);
   }
@@ -82,7 +80,7 @@ function MemberRow({ member }) {
       const optional = p.required === false ? "?" : "";
       return `${p.name}${optional}: ${formatSchema(p.schema)}`;
     }) ?? [];
-    const returnType = sig.returns?.tsType ?? formatSchema(sig.returns?.schema) ?? "void";
+    const returnType = formatSchema(sig.returns?.schema) ?? "void";
     signature = `(${params.join(", ")}): ${returnType}`;
   }
   return /* @__PURE__ */ jsxDEV("div", {
@@ -118,7 +116,11 @@ function MemberRow({ member }) {
     ]
   }, undefined, true, undefined, this);
 }
-function MembersSection({ members, spec, title = "Members" }) {
+function MembersSection({
+  members,
+  spec: _spec,
+  title = "Members"
+}) {
   if (!members?.length)
     return null;
   const groups = groupMembersByKind(members);
@@ -210,7 +212,10 @@ function MembersSection({ members, spec, title = "Members" }) {
 // src/components/method-section.tsx
 import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
 
-function MethodSection({ member, defaultExpanded = false }) {
+function MethodSection({
+  member,
+  defaultExpanded = false
+}) {
   return /* @__PURE__ */ jsxDEV2(CollapsibleMethod, {
     member,
     defaultExpanded

package/dist/index.d.ts

@@ -60,5 +60,5 @@ interface APIPageProps {
 * <APIPage instance={openpkg} id="createClient" />
 * ```
 */
-declare function APIPage({ spec, instance, id }: APIPageProps);
+declare function APIPage({ spec, instance, id }: APIPageProps): React.ReactNode;
 export { createOpenPkg, OpenPkgOptions, OpenPkgInstance, APIPageProps, APIPage };

package/dist/index.js

@@ -3,7 +3,7 @@ import {
 } from "./server.js";
 import {
   APIPage
-} from "./shared/chunk-mmca4gp7.js";
+} from "./shared/chunk-edfpjshy.js";
 export {
   createOpenPkg,
   APIPage

package/dist/shared/{chunk-mmca4gp7.js → chunk-edfpjshy.js}

@@ -45,6 +45,7 @@ function ChevronIcon({ expanded }) {
     viewBox: "0 0 12 12",
     fill: "none",
     className: `transition-transform duration-200 ${expanded ? "rotate-90" : ""}`,
+    "aria-hidden": "true",
     children: /* @__PURE__ */ jsxDEV2("path", {
       d: "M4.5 2.5L8 6L4.5 9.5",
       stroke: "currentColor",
@@ -61,13 +62,6 @@ function formatType(schema) {
     return schema;
   if (typeof schema === "object" && schema !== null) {
     const s = schema;
-    if (s.tsType && typeof s.tsType === "string") {
-      const tsType = s.tsType;
-      if (tsType.length > 80) {
-        return `${tsType.slice(0, 77)}...`;
-      }
-      return tsType;
-    }
     if (s.$ref && typeof s.$ref === "string") {
       return s.$ref.replace("#/types/", "");
     }
@@ -113,7 +107,12 @@ function countProperties(schema) {
   const props = getNestedProperties(schema);
   return props ? Object.keys(props).length : 0;
 }
-function NestedProperty({ name, schema, required = false, depth = 0 }) {
+function NestedProperty({
+  name,
+  schema,
+  required = false,
+  depth = 0
+}) {
   const [expanded, setExpanded] = useState(false);
   const type = formatType(schema);
   const nestedProps = getNestedProperties(schema);
@@ -154,6 +153,7 @@ function NestedProperty({ name, schema, required = false, depth = 0 }) {
             ]
           }, undefined, true, undefined, this),
           hasNested && /* @__PURE__ */ jsxDEV2("button", {
+            type: "button",
             onClick: () => setExpanded(!expanded),
             className: `flex items-center gap-1 px-2 py-0.5 text-xs font-medium rounded-md
                        bg-fd-muted text-fd-muted-foreground hover:bg-fd-accent hover:text-fd-accent-foreground
@@ -224,6 +224,7 @@ function ExpandableProperty({ param, depth = 0 }) {
             ]
           }, undefined, true, undefined, this),
           hasNested && /* @__PURE__ */ jsxDEV2("button", {
+            type: "button",
             onClick: () => setExpanded(!expanded),
             className: `flex items-center gap-1 px-2 py-0.5 text-xs font-medium rounded-md
                        bg-fd-muted text-fd-muted-foreground hover:bg-fd-accent hover:text-fd-accent-foreground
@@ -266,6 +267,7 @@ function ChevronIcon2({ expanded }) {
     viewBox: "0 0 16 16",
     fill: "none",
     className: `transition-transform duration-200 ${expanded ? "rotate-90" : ""}`,
+    "aria-hidden": "true",
     children: /* @__PURE__ */ jsxDEV3("path", {
       d: "M6 4L10 8L6 12",
       stroke: "currentColor",
@@ -285,12 +287,6 @@ function formatSchema(schema) {
     if (s.$ref && typeof s.$ref === "string") {
       return s.$ref.replace("#/types/", "");
     }
-    if (s.tsType) {
-      const tsType = String(s.tsType);
-      if (tsType.length > 40)
-        return `${tsType.slice(0, 37)}...`;
-      return tsType;
-    }
     if (s.type)
       return String(s.type);
   }
@@ -299,12 +295,6 @@ function formatSchema(schema) {
 function formatReturnType(returns) {
   if (!returns)
     return "void";
-  if (returns.tsType) {
-    const t = returns.tsType;
-    if (t.length > 40)
-      return `${t.slice(0, 37)}...`;
-    return t;
-  }
   return formatSchema(returns.schema);
 }
 function formatParamPreview(params) {
@@ -314,7 +304,10 @@ function formatParamPreview(params) {
     return params[0].name || "arg";
   return `${params[0].name || "arg"}, ...`;
 }
-function CollapsibleMethod({ member, defaultExpanded = false }) {
+function CollapsibleMethod({
+  member,
+  defaultExpanded = false
+}) {
   const [expanded, setExpanded] = useState2(defaultExpanded);
   const sig = member.signatures?.[0];
   const hasParams = sig?.parameters && sig.parameters.length > 0;
@@ -335,6 +328,7 @@ function CollapsibleMethod({ member, defaultExpanded = false }) {
     className: "scroll-mt-20 border-b border-fd-border last:border-0",
     children: [
       /* @__PURE__ */ jsxDEV3("button", {
+        type: "button",
         onClick: () => setExpanded(!expanded),
         className: "w-full flex items-center gap-3 py-4 px-1 text-left hover:bg-fd-muted/30 transition-colors cursor-pointer group",
         children: [
@@ -423,7 +417,7 @@ function CollapsibleMethod({ member, defaultExpanded = false }) {
                 children: [
                   /* @__PURE__ */ jsxDEV3("span", {
                     className: "font-mono text-sm text-fd-muted-foreground",
-                    children: sig.returns.tsType || formatSchema(sig.returns.schema)
+                    children: formatSchema(sig.returns.schema)
                   }, undefined, false, undefined, this),
                   returnDescription && /* @__PURE__ */ jsxDEV3("p", {
                     className: "text-sm text-fd-muted-foreground mt-1 leading-relaxed",
@@ -452,7 +446,11 @@ function getScoreColor(score) {
 function formatSignal(signal) {
   return signal.charAt(0).toUpperCase() + signal.slice(1);
 }
-function CoverageBadge({ docs, showMissing = true, showDrift = true }) {
+function CoverageBadge({
+  docs,
+  showMissing = true,
+  showDrift = true
+}) {
   const score = docs.coverageScore;
   const hasMissing = showMissing && docs.missing && docs.missing.length > 0;
   const hasDrift = showDrift && docs.drift && docs.drift.length > 0;
@@ -469,6 +467,7 @@ function CoverageBadge({ docs, showMissing = true, showDrift = true }) {
             fill: "none",
             stroke: "currentColor",
             viewBox: "0 0 24 24",
+            "aria-hidden": "true",
             children: /* @__PURE__ */ jsxDEV4("path", {
               strokeLinecap: "round",
               strokeLinejoin: "round",
@@ -505,7 +504,7 @@ function CoverageBadge({ docs, showMissing = true, showDrift = true }) {
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV4("ul", {
             className: "text-sm text-red-600/80 dark:text-red-400/80 space-y-1",
-            children: docs.drift.map((drift, index) => /* @__PURE__ */ jsxDEV4("li", {
+            children: docs.drift.map((drift) => /* @__PURE__ */ jsxDEV4("li", {
               className: "flex flex-col",
               children: [
                 /* @__PURE__ */ jsxDEV4("span", {
@@ -524,7 +523,7 @@ function CoverageBadge({ docs, showMissing = true, showDrift = true }) {
                   ]
                 }, undefined, true, undefined, this)
               ]
-            }, index, true, undefined, this))
+            }, `${drift.type}-${drift.issue}`, true, undefined, this))
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this)
@@ -545,8 +544,6 @@ function formatSchema2(schema) {
     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);
   }
@@ -596,7 +593,7 @@ function PropertyItem({ member }) {
     ]
   }, undefined, true, undefined, this);
 }
-function ClassPage({ export: exp, spec }) {
+function ClassPage({ export: exp, spec: _spec }) {
   const hasExamples = exp.examples && exp.examples.length > 0;
   const constructors = exp.members?.filter((m) => m.kind === "constructor") ?? [];
   const properties = exp.members?.filter((m) => m.kind === "property" || m.kind === "field") ?? [];
@@ -716,6 +713,7 @@ function CopyButton({ text }) {
       fill: "none",
       stroke: "currentColor",
       viewBox: "0 0 24 24",
+      "aria-hidden": "true",
       children: /* @__PURE__ */ jsxDEV6("path", {
         strokeLinecap: "round",
         strokeLinejoin: "round",
@@ -727,6 +725,7 @@ function CopyButton({ text }) {
       fill: "none",
       stroke: "currentColor",
       viewBox: "0 0 24 24",
+      "aria-hidden": "true",
       children: /* @__PURE__ */ jsxDEV6("path", {
         strokeLinecap: "round",
         strokeLinejoin: "round",
@@ -750,7 +749,7 @@ function ExamplesSection({ examples }) {
       }, undefined, false, undefined, this),
       showTabs && /* @__PURE__ */ jsxDEV6("div", {
         className: "flex gap-1 mb-2 border-b border-fd-border",
-        children: examples.map((_, index) => /* @__PURE__ */ jsxDEV6("button", {
+        children: examples.map((example, index) => /* @__PURE__ */ jsxDEV6("button", {
           type: "button",
           onClick: () => setActiveIndex(index),
           className: `px-3 py-1.5 text-sm font-medium transition-colors ${activeIndex === index ? "text-fd-primary border-b-2 border-fd-primary -mb-px" : "text-fd-muted-foreground hover:text-fd-foreground"}`,
@@ -758,7 +757,7 @@ function ExamplesSection({ examples }) {
             "Example ",
             index + 1
           ]
-        }, index, true, undefined, this))
+        }, `example-${typeof example === "string" ? example.slice(0, 20) : index}`, true, undefined, this))
       }, undefined, false, undefined, this),
       /* @__PURE__ */ jsxDEV6("div", {
         className: "group relative",
@@ -816,8 +815,6 @@ function formatSchema3(schema) {
     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);
   }
@@ -826,8 +823,6 @@ function formatSchema3(schema) {
 function formatReturnType2(sig) {
   if (!sig?.returns)
     return "void";
-  if (sig.returns.tsType)
-    return sig.returns.tsType;
   return formatSchema3(sig.returns.schema);
 }
 function buildSignatureString(exp, sigIndex = 0) {
@@ -892,7 +887,7 @@ function Signature({ export: exp, signatureIndex = 0 }) {
 // src/components/enum-page.tsx
 import { jsxDEV as jsxDEV8 } from "react/jsx-dev-runtime";
 
-function EnumPage({ export: exp, spec }) {
+function EnumPage({ export: exp, spec: _spec }) {
   const members = exp.members ?? [];
   return /* @__PURE__ */ jsxDEV8("div", {
     className: "space-y-6",
@@ -998,14 +993,12 @@ function formatSchema4(schema) {
     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";
 }
-function ParameterCard({ param, spec }) {
+function ParameterCard({ param, spec: _spec }) {
   const type = formatSchema4(param.schema);
   const isRequired = param.required !== false;
   return /* @__PURE__ */ jsxDEV9("div", {
@@ -1049,8 +1042,6 @@ function formatSchema5(schema) {
     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);
   }
@@ -1075,7 +1066,7 @@ function FunctionPage({ export: exp, spec }) {
             children: "Returns:"
           }, undefined, false, undefined, this),
           " ",
-          sig.returns.description || `A ${sig.returns.tsType ?? formatSchema5(sig.returns.schema)}`
+          sig.returns.description || `A ${formatSchema5(sig.returns.schema)}`
         ]
       }, undefined, true, undefined, this),
       /* @__PURE__ */ jsxDEV10("div", {
@@ -1143,8 +1134,6 @@ function formatSchema6(schema) {
     }
     if (s.type)
       return String(s.type);
-    if (s.tsType)
-      return String(s.tsType);
   }
   return "unknown";
 }
@@ -1227,6 +1216,21 @@ function TypeTable({ items, showRequired = true }) {
 // src/components/interface-page.tsx
 import { jsxDEV as jsxDEV12 } from "react/jsx-dev-runtime";
 
+function formatSchema7(schema) {
+  if (!schema)
+    return "unknown";
+  if (typeof schema === "string")
+    return schema;
+  if (typeof schema === "object" && schema !== null) {
+    const s = schema;
+    if (s.$ref && typeof s.$ref === "string") {
+      return s.$ref.replace("#/types/", "");
+    }
+    if (s.type)
+      return String(s.type);
+  }
+  return "unknown";
+}
 function InterfacePage({ export: exp, spec }) {
   const properties = exp.members?.filter((m) => m.kind === "property" || m.kind === "field" || !m.kind);
   const methods = exp.members?.filter((m) => m.kind === "method" || m.kind === "function");
@@ -1287,7 +1291,7 @@ function InterfacePage({ export: exp, spec }) {
             children: methods.map((method, index) => {
               const sig = method.signatures?.[0];
               const params = sig?.parameters ?? [];
-              const returnType = sig?.returns?.tsType ?? "void";
+              const returnType = formatSchema7(sig?.returns?.schema);
               return /* @__PURE__ */ jsxDEV12("div", {
                 className: "rounded-lg border border-fd-border p-4",
                 children: [
@@ -1298,7 +1302,7 @@ function InterfacePage({ export: exp, spec }) {
                       "(",
                       params.map((p) => {
                         const optional = p.required === false ? "?" : "";
-                        const type = typeof p.schema === "string" ? p.schema : p.schema?.tsType ?? "any";
+                        const type = formatSchema7(p.schema);
                         return `${p.name}${optional}: ${type}`;
                       }).join(", "),
                       "): ",
@@ -1328,7 +1332,7 @@ function InterfacePage({ export: exp, spec }) {
 // src/components/variable-page.tsx
 import { jsxDEV as jsxDEV13 } from "react/jsx-dev-runtime";
 
-function formatSchema7(schema) {
+function formatSchema8(schema) {
   if (!schema)
     return "unknown";
   if (typeof schema === "string")
@@ -1338,15 +1342,13 @@ function formatSchema7(schema) {
     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";
 }
-function VariablePage({ export: exp, spec }) {
-  const typeValue = typeof exp.type === "string" ? exp.type : formatSchema7(exp.schema);
+function VariablePage({ export: exp, spec: _spec }) {
+  const typeValue = typeof exp.type === "string" ? exp.type : formatSchema8(exp.schema);
   const hasExamples = exp.examples && exp.examples.length > 0;
   return /* @__PURE__ */ jsxDEV13("div", {
     className: "space-y-8",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doccov/fumadocs-adapter",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "type": "module",
   "sideEffects": false,
   "exports": {

package/src/components/api-page.tsx

@@ -47,7 +47,7 @@ function NotFound({ id }: { id: string }) {
  * <APIPage instance={openpkg} id="createClient" />
  * ```
  */
-export function APIPage({ spec, instance, id }: APIPageProps) {
+export function APIPage({ spec, instance, id }: APIPageProps): React.ReactNode {
   const resolvedSpec = spec ?? instance?.spec;
 
   if (!resolvedSpec) {

package/src/components/class-page.tsx

@@ -19,7 +19,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';
@@ -63,7 +62,7 @@ function PropertyItem({ member }: { member: SpecMember }) {
   );
 }
 
-export function ClassPage({ export: exp, spec }: ClassPageProps) {
+export function ClassPage({ export: exp, spec: _spec }: ClassPageProps): React.ReactNode {
   const hasExamples = exp.examples && exp.examples.length > 0;
 
   // Group members

package/src/components/code-example.tsx

@@ -29,7 +29,7 @@ export function CodeExample({
   code,
   filename = 'example.ts',
   language = 'typescript',
-}: CodeExampleProps) {
+}: CodeExampleProps): React.ReactNode {
   const cleaned = cleanCode(code);
 
   // Build RawCode object for ClientDocsKitCode

package/src/components/collapsible-method.tsx

@@ -18,6 +18,7 @@ function ChevronIcon({ expanded }: { expanded: boolean }) {
       viewBox="0 0 16 16"
       fill="none"
       className={`transition-transform duration-200 ${expanded ? 'rotate-90' : ''}`}
+      aria-hidden="true"
     >
       <path
         d="M6 4L10 8L6 12"
@@ -38,23 +39,13 @@ function formatSchema(schema: unknown): string {
     if (s.$ref && typeof s.$ref === 'string') {
       return s.$ref.replace('#/types/', '');
     }
-    if (s.tsType) {
-      const tsType = String(s.tsType);
-      if (tsType.length > 40) return `${tsType.slice(0, 37)}...`;
-      return tsType;
-    }
     if (s.type) return String(s.type);
   }
   return 'unknown';
 }
 
-function formatReturnType(returns: { schema?: SpecSchema; tsType?: string } | undefined): string {
+function formatReturnType(returns: { schema?: SpecSchema } | undefined): string {
   if (!returns) return 'void';
-  if (returns.tsType) {
-    const t = returns.tsType;
-    if (t.length > 40) return `${t.slice(0, 37)}...`;
-    return t;
-  }
   return formatSchema(returns.schema);
 }
 
@@ -68,7 +59,10 @@ function formatParamPreview(params: { name?: string }[] | undefined): string {
  * Collapsible method section with expand/collapse behavior
  * Shows compact signature when collapsed, full details when expanded
  */
-export function CollapsibleMethod({ member, defaultExpanded = false }: CollapsibleMethodProps) {
+export function CollapsibleMethod({
+  member,
+  defaultExpanded = false,
+}: CollapsibleMethodProps): React.ReactNode {
   const [expanded, setExpanded] = useState(defaultExpanded);
 
   const sig = member.signatures?.[0];
@@ -93,6 +87,7 @@ export function CollapsibleMethod({ member, defaultExpanded = false }: Collapsib
     <div id={member.name} className="scroll-mt-20 border-b border-fd-border last:border-0">
       {/* Clickable header */}
       <button
+        type="button"
         onClick={() => setExpanded(!expanded)}
         className="w-full flex items-center gap-3 py-4 px-1 text-left hover:bg-fd-muted/30 transition-colors cursor-pointer group"
       >
@@ -161,7 +156,7 @@ export function CollapsibleMethod({ member, defaultExpanded = false }: Collapsib
               </span>
               <div className="border-l-2 border-fd-border pl-4 py-2">
                 <span className="font-mono text-sm text-fd-muted-foreground">
-                  {sig.returns.tsType || formatSchema(sig.returns.schema)}
+                  {formatSchema(sig.returns.schema)}
                 </span>
                 {returnDescription && (
                   <p className="text-sm text-fd-muted-foreground mt-1 leading-relaxed">

package/src/components/coverage-badge.tsx

@@ -19,7 +19,11 @@ function formatSignal(signal: string): string {
   return signal.charAt(0).toUpperCase() + signal.slice(1);
 }
 
-export function CoverageBadge({ docs, showMissing = true, showDrift = true }: CoverageBadgeProps) {
+export function CoverageBadge({
+  docs,
+  showMissing = true,
+  showDrift = true,
+}: CoverageBadgeProps): React.ReactNode {
   const score = docs.coverageScore;
   const hasMissing = showMissing && docs.missing && docs.missing.length > 0;
   const hasDrift = showDrift && docs.drift && docs.drift.length > 0;
@@ -32,7 +36,13 @@ export function CoverageBadge({ docs, showMissing = true, showDrift = true }: Co
         <div
           className={`inline-flex items-center gap-2 px-3 py-1.5 rounded-md border text-sm font-medium ${getScoreColor(score)}`}
         >
-          <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <svg
+            className="w-4 h-4"
+            fill="none"
+            stroke="currentColor"
+            viewBox="0 0 24 24"
+            aria-hidden="true"
+          >
             <path
               strokeLinecap="round"
               strokeLinejoin="round"
@@ -63,8 +73,8 @@ export function CoverageBadge({ docs, showMissing = true, showDrift = true }: Co
             Documentation Drift
           </p>
           <ul className="text-sm text-red-600/80 dark:text-red-400/80 space-y-1">
-            {docs.drift!.map((drift, index) => (
-              <li key={index} className="flex flex-col">
+            {docs.drift!.map((drift) => (
+              <li key={`${drift.type}-${drift.issue}`} className="flex flex-col">
                 <span className="font-medium">{drift.type}</span>
                 <span className="text-xs opacity-80">{drift.issue}</span>
                 {drift.suggestion && (

package/src/components/enum-page.tsx

@@ -10,7 +10,7 @@ export interface EnumPageProps {
   spec: OpenPkg;
 }
 
-export function EnumPage({ export: exp, spec }: EnumPageProps) {
+export function EnumPage({ export: exp, spec: _spec }: EnumPageProps): React.ReactNode {
   const members = exp.members ?? [];
 
   return (
@@ -49,7 +49,9 @@ export function EnumPage({ export: exp, spec }: EnumPageProps) {
                   const value =
                     member.schema !== undefined
                       ? typeof member.schema === 'object' && member.schema !== null
-                        ? ((member.schema as any).const ?? (member.schema as any).default ?? '-')
+                        ? ((member.schema as Record<string, unknown>).const ??
+                          (member.schema as Record<string, unknown>).default ??
+                          '-')
                         : member.schema
                       : '-';
 

package/src/components/examples.tsx

@@ -23,11 +23,23 @@ function CopyButton({ text }: { text: string }) {
       aria-label="Copy code"
     >
       {copied ? (
-        <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <svg
+          className="w-4 h-4"
+          fill="none"
+          stroke="currentColor"
+          viewBox="0 0 24 24"
+          aria-hidden="true"
+        >
           <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
         </svg>
       ) : (
-        <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <svg
+          className="w-4 h-4"
+          fill="none"
+          stroke="currentColor"
+          viewBox="0 0 24 24"
+          aria-hidden="true"
+        >
           <path
             strokeLinecap="round"
             strokeLinejoin="round"
@@ -40,7 +52,7 @@ function CopyButton({ text }: { text: string }) {
   );
 }
 
-export function ExamplesSection({ examples }: ExamplesSectionProps) {
+export function ExamplesSection({ examples }: ExamplesSectionProps): React.ReactNode {
   const [activeIndex, setActiveIndex] = useState(0);
 
   if (!examples?.length) return null;
@@ -53,9 +65,9 @@ export function ExamplesSection({ examples }: ExamplesSectionProps) {
 
       {showTabs && (
         <div className="flex gap-1 mb-2 border-b border-fd-border">
-          {examples.map((_, index) => (
+          {examples.map((example, index) => (
             <button
-              key={index}
+              key={`example-${typeof example === 'string' ? example.slice(0, 20) : index}`}
               type="button"
               onClick={() => setActiveIndex(index)}
               className={`px-3 py-1.5 text-sm font-medium transition-colors ${

package/src/components/expandable-property.tsx

@@ -24,6 +24,7 @@ function ChevronIcon({ expanded }: { expanded: boolean }) {
       viewBox="0 0 12 12"
       fill="none"
       className={`transition-transform duration-200 ${expanded ? 'rotate-90' : ''}`}
+      aria-hidden="true"
     >
       <path
         d="M4.5 2.5L8 6L4.5 9.5"
@@ -42,15 +43,6 @@ function formatType(schema: SpecSchema): string {
   if (typeof schema === 'object' && schema !== null) {
     const s = schema as Record<string, unknown>;
 
-    // Use tsType if available (most readable)
-    if (s.tsType && typeof s.tsType === 'string') {
-      const tsType = s.tsType as string;
-      if (tsType.length > 80) {
-        return `${tsType.slice(0, 77)}...`;
-      }
-      return tsType;
-    }
-
     // Handle refs
     if (s.$ref && typeof s.$ref === 'string') {
       return (s.$ref as string).replace('#/types/', '');
@@ -108,7 +100,12 @@ function countProperties(schema: SpecSchema): number {
 /**
  * Nested property row with expandable nested objects
  */
-export function NestedProperty({ name, schema, required = false, depth = 0 }: NestedPropertyProps) {
+export function NestedProperty({
+  name,
+  schema,
+  required = false,
+  depth = 0,
+}: NestedPropertyProps): React.ReactNode {
   const [expanded, setExpanded] = useState(false);
   const type = formatType(schema);
   const nestedProps = getNestedProperties(schema);
@@ -142,6 +139,7 @@ export function NestedProperty({ name, schema, required = false, depth = 0 }: Ne
         {/* Expand badge for nested objects */}
         {hasNested && (
           <button
+            type="button"
             onClick={() => setExpanded(!expanded)}
             className="flex items-center gap-1 px-2 py-0.5 text-xs font-medium rounded-md
                        bg-fd-muted text-fd-muted-foreground hover:bg-fd-accent hover:text-fd-accent-foreground
@@ -175,7 +173,7 @@ export function NestedProperty({ name, schema, required = false, depth = 0 }: Ne
  * Top-level expandable property for method parameters
  * Entry point for rendering a parameter with progressive disclosure
  */
-export function ExpandableProperty({ param, depth = 0 }: ExpandablePropertyProps) {
+export function ExpandableProperty({ param, depth = 0 }: ExpandablePropertyProps): React.ReactNode {
   const [expanded, setExpanded] = useState(false);
   const type = formatType(param.schema);
   const isOptional = param.required === false;
@@ -208,6 +206,7 @@ export function ExpandableProperty({ param, depth = 0 }: ExpandablePropertyProps
         {/* Expand badge for nested objects */}
         {hasNested && (
           <button
+            type="button"
             onClick={() => setExpanded(!expanded)}
             className="flex items-center gap-1 px-2 py-0.5 text-xs font-medium rounded-md
                        bg-fd-muted text-fd-muted-foreground hover:bg-fd-accent hover:text-fd-accent-foreground

package/src/components/function-page.tsx

@@ -18,13 +18,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 FunctionPage({ export: exp, spec }: FunctionPageProps) {
+export function FunctionPage({ export: exp, spec }: FunctionPageProps): React.ReactNode {
   const sig = exp.signatures?.[0];
   const hasExamples = exp.examples && exp.examples.length > 0;
   const hasParams = sig?.parameters && sig.parameters.length > 0;
@@ -40,7 +39,7 @@ export function FunctionPage({ export: exp, spec }: FunctionPageProps) {
       {sig?.returns && (
         <p className="text-fd-muted-foreground text-sm">
           <span className="font-medium text-fd-foreground">Returns:</span>{' '}
-          {sig.returns.description || `A ${sig.returns.tsType ?? formatSchema(sig.returns.schema)}`}
+          {sig.returns.description || `A ${formatSchema(sig.returns.schema)}`}
         </p>
       )}
 

package/src/components/interface-page.tsx

@@ -6,12 +6,25 @@ import { ExamplesSection } from './examples';
 import { Signature } from './signature';
 import { TypeTable } from './type-table';
 
+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,
@@ -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,10 +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(', ')}

package/src/components/members-section.tsx

@@ -16,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';
@@ -80,7 +79,7 @@ function MemberRow({ member }: { member: SpecMember }) {
         const optional = p.required === false ? '?' : '';
         return `${p.name}${optional}: ${formatSchema(p.schema)}`;
       }) ?? [];
-    const returnType = sig.returns?.tsType ?? formatSchema(sig.returns?.schema) ?? 'void';
+    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);

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;
 

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

@@ -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 (

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;