@openpkg-ts/fumadocs-adapter 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,39 @@
+# @openpkg-ts/fumadocs-adapter
+
+## 0.2.0
+
+### Minor Changes
+
+- Rename package from @doccov/fumadocs-adapter to @openpkg-ts/fumadocs-adapter
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial release of @openpkg-ts/doc-generator
+
+  - Core API: createDocs(), loadSpec() for loading OpenPkg specs
+  - Query utilities: formatSchema(), buildSignatureString(), member filtering and sorting
+  - Renderers: Markdown/MDX, HTML, JSON output formats
+  - Navigation: Fumadocs, Docusaurus, and generic nav generation
+  - Search: Pagefind and Algolia compatible indexes
+  - React components: Headless (unstyled) and styled (Tailwind v4) variants
+  - CLI: generate, build, dev commands
+  - Adapter architecture: Extensible framework integration pattern
+
+### Patch Changes
+
+- Updated dependencies
+  - @openpkg-ts/doc-generator@0.1.0
+
+## 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
+
+- update components and configuration

package/bunup.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'bunup';
+
+export default defineConfig({
+  entry: ['src/index.ts', 'src/components/index.ts'],
+  dts: true,
+  clean: true,
+  format: ['esm'],
+  external: ['react', 'react-dom', '@openpkg-ts/doc-generator'],
+});

package/dist/components/index.d.ts

@@ -0,0 +1,27 @@
+import { CollapsibleMethod, CollapsibleMethodProps, ExampleBlock, ExampleBlockProps, ExpandableProperty, ExpandablePropertyProps, MemberRow, MemberRowProps, MembersTable, MembersTableProps, NestedProperty, NestedPropertyProps, ParamRow, ParamRowProps, ParamTable, ParamTableProps, Signature, SignatureProps, TypeTable, TypeTableProps } from "@openpkg-ts/doc-generator/react";
+import { APIPage, APIPageProps, ClassPage, ClassPageProps, EnumPage, EnumPageProps, FunctionPage, FunctionPageProps, InterfacePage, InterfacePageProps, VariablePage, VariablePageProps } from "@openpkg-ts/doc-generator/react/styled";
+/**
+* Documentation drift information.
+* Describes a mismatch between docs and code.
+*/
+interface DocDrift {
+	type: string;
+	issue: string;
+	suggestion?: string;
+}
+/**
+* Documentation metadata for an export.
+* Contains coverage score, missing docs, and drift issues.
+*/
+interface DocsMetadata {
+	coverageScore?: number;
+	missing?: string[];
+	drift?: DocDrift[];
+}
+interface CoverageBadgeProps {
+	docs: DocsMetadata;
+	showMissing?: boolean;
+	showDrift?: boolean;
+}
+declare function CoverageBadge({ docs, showMissing, showDrift }: CoverageBadgeProps): React.ReactNode;
+export { VariablePageProps, VariablePage, TypeTableProps, TypeTable, SignatureProps, Signature, ParamTableProps, ParamTable, ParamRowProps, ParamRow, NestedPropertyProps, NestedProperty, MembersTableProps, MembersTable, MemberRowProps, MemberRow, InterfacePageProps, InterfacePage, FunctionPageProps, FunctionPage, ExpandablePropertyProps, ExpandableProperty, ExampleBlockProps, ExampleBlock, EnumPageProps, EnumPage, DocsMetadata, DocDrift, CoverageBadgeProps, CoverageBadge, CollapsibleMethodProps, CollapsibleMethod, ClassPageProps, ClassPage, APIPageProps, APIPage };

package/dist/components/index.js

@@ -0,0 +1,44 @@
+import {
+  CoverageBadge
+} from "../shared/chunk-a91ch1vp.js";
+
+// src/components/index.ts
+import {
+  CollapsibleMethod,
+  ExampleBlock,
+  ExpandableProperty,
+  MemberRow,
+  MembersTable,
+  NestedProperty,
+  ParamRow,
+  ParamTable,
+  Signature,
+  TypeTable
+} from "@openpkg-ts/doc-generator/react";
+import {
+  APIPage,
+  ClassPage,
+  EnumPage,
+  FunctionPage,
+  InterfacePage,
+  VariablePage
+} from "@openpkg-ts/doc-generator/react/styled";
+export {
+  VariablePage,
+  TypeTable,
+  Signature,
+  ParamTable,
+  ParamRow,
+  NestedProperty,
+  MembersTable,
+  MemberRow,
+  InterfacePage,
+  FunctionPage,
+  ExpandableProperty,
+  ExampleBlock,
+  EnumPage,
+  CoverageBadge,
+  CollapsibleMethod,
+  ClassPage,
+  APIPage
+};

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import { DocsInstance, LoadOptions, OpenPkg, SpecExample, SpecExport, SpecExportKind, SpecMember, SpecSchema, SpecSignature, SpecSignatureParameter, SpecTag, SpecType, SpecTypeKind, SpecTypeParameter } from "@openpkg-ts/doc-generator";
+import { AlgoliaRecord, buildSignatureString, createDocs, createDocs as createDocs2, DocsInstance as DocsInstance2, ExportMarkdownOptions, exportToMarkdown, formatParameters, formatReturnType, formatSchema, formatTypeParameters, getMethods, getProperties, groupByVisibility, HTMLOptions, isMethod, isProperty, JSONOptions, LoadOptions as LoadOptions2, loadSpec, MarkdownOptions, NavOptions, PagefindRecord, resolveTypeRef, SearchIndex, SearchOptions, SearchRecord, sortByKindThenName, sortByName, toAlgoliaRecords, toDocusaurusSidebarJS, toFumadocsMetaJSON, toHTML, toJSON, toJSONString, toMarkdown, toNavigation, toPagefindRecords, toSearchIndex, toSearchIndexJSON } from "@openpkg-ts/doc-generator";
+import { APIPage, APIPageProps, ClassPage, ClassPageProps, EnumPage, EnumPageProps, FunctionPage, FunctionPageProps, InterfacePage, InterfacePageProps, VariablePage, VariablePageProps } from "@openpkg-ts/doc-generator/react/styled";
+/**
+* Documentation drift information.
+* Describes a mismatch between docs and code.
+*/
+interface DocDrift {
+	type: string;
+	issue: string;
+	suggestion?: string;
+}
+/**
+* Documentation metadata for an export.
+* Contains coverage score, missing docs, and drift issues.
+*/
+interface DocsMetadata {
+	coverageScore?: number;
+	missing?: string[];
+	drift?: DocDrift[];
+}
+interface CoverageBadgeProps {
+	docs: DocsMetadata;
+	showMissing?: boolean;
+	showDrift?: boolean;
+}
+declare function CoverageBadge({ docs, showMissing, showDrift }: CoverageBadgeProps): React.ReactNode;
+export { toSearchIndexJSON, toSearchIndex, toPagefindRecords, toNavigation, toMarkdown, toJSONString, toJSON, toHTML, toFumadocsMetaJSON, toDocusaurusSidebarJS, toAlgoliaRecords, sortByName, sortByKindThenName, resolveTypeRef, loadSpec, isProperty, isMethod, groupByVisibility, getProperties, getMethods, formatTypeParameters, formatSchema, formatReturnType, formatParameters, exportToMarkdown, createDocs2 as createOpenPkg, createDocs, buildSignatureString, VariablePageProps, VariablePage, SpecTypeParameter, SpecTypeKind, SpecType, SpecTag, SpecSignatureParameter, SpecSignature, SpecSchema, SpecMember, SpecExportKind, SpecExport, SpecExample, SearchRecord, SearchOptions, SearchIndex, PagefindRecord, LoadOptions as OpenPkgOptions, DocsInstance as OpenPkgInstance, OpenPkg, NavOptions, MarkdownOptions, LoadOptions2 as LoadOptions, JSONOptions, InterfacePageProps, InterfacePage, HTMLOptions, FunctionPageProps, FunctionPage, ExportMarkdownOptions, EnumPageProps, EnumPage, DocsMetadata, DocsInstance2 as DocsInstance, DocDrift, CoverageBadgeProps, CoverageBadge, ClassPageProps, ClassPage, AlgoliaRecord, APIPageProps, APIPage };

package/dist/index.js

@@ -0,0 +1,80 @@
+import {
+  CoverageBadge
+} from "./shared/chunk-a91ch1vp.js";
+
+// src/index.ts
+import {
+  buildSignatureString,
+  createDocs,
+  createDocs as createDocs2,
+  exportToMarkdown,
+  formatParameters,
+  formatReturnType,
+  formatSchema,
+  formatTypeParameters,
+  getMethods,
+  getProperties,
+  groupByVisibility,
+  isMethod,
+  isProperty,
+  loadSpec,
+  resolveTypeRef,
+  sortByKindThenName,
+  sortByName,
+  toAlgoliaRecords,
+  toDocusaurusSidebarJS,
+  toFumadocsMetaJSON,
+  toHTML,
+  toJSON,
+  toJSONString,
+  toMarkdown,
+  toNavigation,
+  toPagefindRecords,
+  toSearchIndex,
+  toSearchIndexJSON
+} from "@openpkg-ts/doc-generator";
+import {
+  APIPage,
+  ClassPage,
+  EnumPage,
+  FunctionPage,
+  InterfacePage,
+  VariablePage
+} from "@openpkg-ts/doc-generator/react/styled";
+export {
+  toSearchIndexJSON,
+  toSearchIndex,
+  toPagefindRecords,
+  toNavigation,
+  toMarkdown,
+  toJSONString,
+  toJSON,
+  toHTML,
+  toFumadocsMetaJSON,
+  toDocusaurusSidebarJS,
+  toAlgoliaRecords,
+  sortByName,
+  sortByKindThenName,
+  resolveTypeRef,
+  loadSpec,
+  isProperty,
+  isMethod,
+  groupByVisibility,
+  getProperties,
+  getMethods,
+  formatTypeParameters,
+  formatSchema,
+  formatReturnType,
+  formatParameters,
+  exportToMarkdown,
+  createDocs2 as createOpenPkg,
+  createDocs,
+  buildSignatureString,
+  VariablePage,
+  InterfacePage,
+  FunctionPage,
+  EnumPage,
+  CoverageBadge,
+  ClassPage,
+  APIPage
+};

package/dist/shared/chunk-a91ch1vp.js

@@ -0,0 +1,100 @@
+"use client";
+// src/components/coverage-badge.tsx
+import { jsxDEV } from "react/jsx-dev-runtime";
+
+function getScoreColor(score) {
+  if (score >= 80)
+    return "text-green-600 dark:text-green-400 bg-green-500/10 border-green-500/20";
+  if (score >= 60)
+    return "text-yellow-600 dark:text-yellow-400 bg-yellow-500/10 border-yellow-500/20";
+  return "text-red-600 dark:text-red-400 bg-red-500/10 border-red-500/20";
+}
+function formatSignal(signal) {
+  return signal.charAt(0).toUpperCase() + signal.slice(1);
+}
+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;
+  if (score == null && !hasMissing && !hasDrift)
+    return null;
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "my-6 space-y-3",
+    children: [
+      score != null && /* @__PURE__ */ jsxDEV("div", {
+        className: `inline-flex items-center gap-2 px-3 py-1.5 rounded-md border text-sm font-medium ${getScoreColor(score)}`,
+        children: [
+          /* @__PURE__ */ jsxDEV("svg", {
+            className: "w-4 h-4",
+            fill: "none",
+            stroke: "currentColor",
+            viewBox: "0 0 24 24",
+            "aria-hidden": "true",
+            children: /* @__PURE__ */ jsxDEV("path", {
+              strokeLinecap: "round",
+              strokeLinejoin: "round",
+              strokeWidth: 2,
+              d: "M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this),
+          "Coverage: ",
+          score,
+          "%"
+        ]
+      }, undefined, true, undefined, this),
+      hasMissing && /* @__PURE__ */ jsxDEV("div", {
+        className: "rounded-md bg-yellow-500/10 border border-yellow-500/20 px-3 py-2",
+        children: [
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-sm font-medium text-yellow-600 dark:text-yellow-400 mb-1",
+            children: "Missing Documentation"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("ul", {
+            className: "text-sm text-yellow-600/80 dark:text-yellow-400/80 list-disc list-inside",
+            children: docs.missing.map((signal) => /* @__PURE__ */ jsxDEV("li", {
+              children: formatSignal(signal)
+            }, signal, false, undefined, this))
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      hasDrift && /* @__PURE__ */ jsxDEV("div", {
+        className: "rounded-md bg-red-500/10 border border-red-500/20 px-3 py-2",
+        children: [
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-sm font-medium text-red-600 dark:text-red-400 mb-1",
+            children: "Documentation Drift"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("ul", {
+            className: "text-sm text-red-600/80 dark:text-red-400/80 space-y-1",
+            children: docs.drift.map((drift) => /* @__PURE__ */ jsxDEV("li", {
+              className: "flex flex-col",
+              children: [
+                /* @__PURE__ */ jsxDEV("span", {
+                  className: "font-medium",
+                  children: drift.type
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV("span", {
+                  className: "text-xs opacity-80",
+                  children: drift.issue
+                }, undefined, false, undefined, this),
+                drift.suggestion && /* @__PURE__ */ jsxDEV("span", {
+                  className: "text-xs text-fd-muted-foreground mt-0.5",
+                  children: [
+                    "Suggestion: ",
+                    drift.suggestion
+                  ]
+                }, undefined, true, undefined, this)
+              ]
+            }, `${drift.type}-${drift.issue}`, true, undefined, this))
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+export { CoverageBadge };

package/examples/01-basic-usage.ts

@@ -0,0 +1,103 @@
+/**
+ * Example: Fumadocs Adapter Basic Usage
+ *
+ * Run from fumadocs-adapter: bun examples/01-basic-usage.ts
+ */
+
+import {
+  buildSignatureString,
+  // Core API (re-exported from doc-generator)
+  createDocs,
+  createOpenPkg, // backward compat alias
+  // Query utilities
+  formatSchema,
+  getMethods,
+  getProperties,
+  toFumadocsMetaJSON,
+  // Render utilities
+  toMarkdown,
+  toNavigation,
+  // Search
+  toSearchIndex,
+} from '../src/index';
+
+// Sample spec for testing
+const sampleSpec = {
+  openpkg: '0.4.0',
+  meta: {
+    ecosystem: 'js/ts',
+    name: 'test-package',
+    version: '1.0.0',
+  },
+  exports: [
+    {
+      id: 'hello',
+      name: 'hello',
+      kind: 'function',
+      description: 'Say hello',
+      signatures: [
+        {
+          parameters: [{ name: 'name', required: true, schema: { type: 'string' } }],
+          returns: { schema: { type: 'string' } },
+        },
+      ],
+    },
+    {
+      id: 'Config',
+      name: 'Config',
+      kind: 'interface',
+      description: 'Configuration interface',
+      members: [
+        { name: 'debug', kind: 'property', schema: { type: 'boolean' }, optional: true },
+        { name: 'timeout', kind: 'property', schema: { type: 'number' } },
+      ],
+    },
+  ],
+  types: [],
+} as any;
+
+console.log('=== Fumadocs Adapter Usage ===\n');
+
+// Use createDocs (preferred)
+const docs = createDocs(sampleSpec);
+console.log('Package:', docs.spec.meta.name);
+console.log('Exports:', docs.getAllExports().length);
+
+// Or use createOpenPkg (backward compat)
+const openpkg = createOpenPkg(sampleSpec);
+console.log('\nUsing createOpenPkg (backward compat):');
+console.log('Same API:', openpkg.spec.meta.name);
+
+// Query
+console.log('\n--- Query ---');
+const hello = docs.getExport('hello');
+if (hello) {
+  console.log('Signature:', buildSignatureString(hello));
+}
+
+const config = docs.getExport('Config');
+if (config?.members) {
+  console.log(
+    'Config properties:',
+    getProperties(config.members)
+      .map((p) => p.name)
+      .join(', '),
+  );
+}
+
+// Render
+console.log('\n--- Render ---');
+const md = docs.toMarkdown({ export: 'hello' });
+console.log('Markdown:\n', md);
+
+// Navigation for Fumadocs
+console.log('\n--- Fumadocs Navigation ---');
+const meta = toFumadocsMetaJSON(sampleSpec, { basePath: '/api' });
+console.log(meta);
+
+// Search index
+console.log('\n--- Search Index ---');
+const searchIndex = toSearchIndex(sampleSpec);
+console.log('Records:', searchIndex.records.length);
+
+console.log('\n=== Done ===');

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@openpkg-ts/fumadocs-adapter",
+  "version": "0.2.0",
+  "description": "Fumadocs integration for OpenPkg API documentation",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": "./src/index.ts",
+    "./components": "./src/components/index.ts",
+    "./css": "./src/styles/docskit.css"
+  },
+  "scripts": {
+    "build": "bunup",
+    "lint": "biome check src/",
+    "lint:fix": "biome check --write src/",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@openpkg-ts/doc-generator": "^0.1.0"
+  },
+  "peerDependencies": {
+    "react": "^18 || ^19"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "bunup": "^0.11.5",
+    "typescript": "^5.0.0"
+  }
+}

package/src/components/coverage-badge.tsx

@@ -0,0 +1,110 @@
+'use client';
+
+/**
+ * Documentation drift information.
+ * Describes a mismatch between docs and code.
+ */
+export interface DocDrift {
+  type: string;
+  issue: string;
+  suggestion?: string;
+}
+
+/**
+ * Documentation metadata for an export.
+ * Contains coverage score, missing docs, and drift issues.
+ */
+export interface DocsMetadata {
+  coverageScore?: number;
+  missing?: string[];
+  drift?: DocDrift[];
+}
+
+export interface CoverageBadgeProps {
+  docs: DocsMetadata;
+  showMissing?: boolean;
+  showDrift?: boolean;
+}
+
+function getScoreColor(score: number): string {
+  if (score >= 80) return 'text-green-600 dark:text-green-400 bg-green-500/10 border-green-500/20';
+  if (score >= 60)
+    return 'text-yellow-600 dark:text-yellow-400 bg-yellow-500/10 border-yellow-500/20';
+  return 'text-red-600 dark:text-red-400 bg-red-500/10 border-red-500/20';
+}
+
+function formatSignal(signal: string): string {
+  return signal.charAt(0).toUpperCase() + signal.slice(1);
+}
+
+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;
+
+  if (score == null && !hasMissing && !hasDrift) return null;
+
+  return (
+    <div className="my-6 space-y-3">
+      {score != null && (
+        <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"
+            aria-hidden="true"
+          >
+            <path
+              strokeLinecap="round"
+              strokeLinejoin="round"
+              strokeWidth={2}
+              d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"
+            />
+          </svg>
+          Coverage: {score}%
+        </div>
+      )}
+
+      {hasMissing && (
+        <div className="rounded-md bg-yellow-500/10 border border-yellow-500/20 px-3 py-2">
+          <p className="text-sm font-medium text-yellow-600 dark:text-yellow-400 mb-1">
+            Missing Documentation
+          </p>
+          <ul className="text-sm text-yellow-600/80 dark:text-yellow-400/80 list-disc list-inside">
+            {docs.missing!.map((signal) => (
+              <li key={signal}>{formatSignal(signal)}</li>
+            ))}
+          </ul>
+        </div>
+      )}
+
+      {hasDrift && (
+        <div className="rounded-md bg-red-500/10 border border-red-500/20 px-3 py-2">
+          <p className="text-sm font-medium text-red-600 dark:text-red-400 mb-1">
+            Documentation Drift
+          </p>
+          <ul className="text-sm text-red-600/80 dark:text-red-400/80 space-y-1">
+            {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 && (
+                  <span className="text-xs text-fd-muted-foreground mt-0.5">
+                    Suggestion: {drift.suggestion}
+                  </span>
+                )}
+              </li>
+            ))}
+          </ul>
+        </div>
+      )}
+    </div>
+  );
+}

package/src/components/index.ts

@@ -0,0 +1,42 @@
+// CoverageBadge is doccov-specific, stays in fumadocs-adapter
+
+// Re-export headless components from doc-generator
+export {
+  CollapsibleMethod,
+  type CollapsibleMethodProps,
+  ExampleBlock,
+  type ExampleBlockProps,
+  ExpandableProperty,
+  type ExpandablePropertyProps,
+  MemberRow,
+  type MemberRowProps,
+  MembersTable,
+  type MembersTableProps,
+  NestedProperty,
+  type NestedPropertyProps,
+  ParamRow,
+  type ParamRowProps,
+  ParamTable,
+  type ParamTableProps,
+  Signature,
+  type SignatureProps,
+  TypeTable,
+  type TypeTableProps,
+} from '@openpkg-ts/doc-generator/react';
+// Re-export all styled components from doc-generator
+export {
+  APIPage,
+  type APIPageProps,
+  ClassPage,
+  type ClassPageProps,
+  EnumPage,
+  type EnumPageProps,
+  FunctionPage,
+  type FunctionPageProps,
+  InterfacePage,
+  type InterfacePageProps,
+  VariablePage,
+  type VariablePageProps,
+} from '@openpkg-ts/doc-generator/react/styled';
+export type { CoverageBadgeProps, DocDrift, DocsMetadata } from './coverage-badge';
+export { CoverageBadge } from './coverage-badge';

package/src/index.ts

@@ -0,0 +1,83 @@
+// Re-export core from @openpkg-ts/doc-generator
+
+// Re-export spec types for convenience
+export type {
+  DocsInstance as OpenPkgInstance,
+  LoadOptions as OpenPkgOptions,
+  OpenPkg,
+  SpecExample,
+  SpecExport,
+  SpecExportKind,
+  SpecMember,
+  SpecSchema,
+  SpecSignature,
+  SpecSignatureParameter,
+  SpecTag,
+  SpecType,
+  SpecTypeKind,
+  SpecTypeParameter,
+} from '@openpkg-ts/doc-generator';
+export {
+  type AlgoliaRecord,
+  buildSignatureString,
+  createDocs,
+  createDocs as createOpenPkg,
+  type DocsInstance,
+  type ExportMarkdownOptions,
+  exportToMarkdown,
+  formatParameters,
+  formatReturnType,
+  formatSchema,
+  formatTypeParameters,
+  getMethods,
+  getProperties,
+  groupByVisibility,
+  type HTMLOptions,
+  isMethod,
+  isProperty,
+  type JSONOptions,
+  type LoadOptions,
+  loadSpec,
+  type MarkdownOptions,
+  type NavOptions,
+  type PagefindRecord,
+  resolveTypeRef,
+  type SearchIndex,
+  type SearchOptions,
+  type SearchRecord,
+  sortByKindThenName,
+  sortByName,
+  toAlgoliaRecords,
+  toDocusaurusSidebarJS,
+  toFumadocsMetaJSON,
+  toHTML,
+  toJSON,
+  toJSONString,
+  toMarkdown,
+  toNavigation,
+  toPagefindRecords,
+  toSearchIndex,
+  toSearchIndexJSON,
+} from '@openpkg-ts/doc-generator';
+// Re-export styled components (most common use case)
+export {
+  APIPage,
+  type APIPageProps,
+  ClassPage,
+  type ClassPageProps,
+  EnumPage,
+  type EnumPageProps,
+  FunctionPage,
+  type FunctionPageProps,
+  InterfacePage,
+  type InterfacePageProps,
+  VariablePage,
+  type VariablePageProps,
+} from '@openpkg-ts/doc-generator/react/styled';
+// Re-export CoverageBadge (doccov-specific)
+export {
+  CoverageBadge,
+  type CoverageBadgeProps,
+  type DocDrift,
+  type DocsMetadata,
+} from './components/coverage-badge';

package/src/styles/docskit.css

@@ -0,0 +1,131 @@
+/**
+ * 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 '@openpkg-ts/fumadocs-adapter/css';
+ *
+ * Or add these variables to your Tailwind CSS:
+ *   @import 'tailwindcss';
+ *   @import 'fumadocs-ui/css/neutral.css';
+ *   @import 'fumadocs-ui/css/preset.css';
+ *   @import '@openpkg-ts/fumadocs-adapter/css';
+ */
+
+@layer base {
+  :root {
+    /* Docskit code block colors - mapped to Fumadocs variables */
+    --dk-background: var(--color-fd-card, hsl(0 0% 3%));
+    --dk-border: var(--color-fd-border, hsl(0 0% 18%));
+    --dk-tabs-background: var(--color-fd-muted, hsl(0 0% 10%));
+    --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"] {
+    --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%));
+    --dk-tab-inactive-foreground: var(--color-fd-muted-foreground, hsl(0 0% 45%));
+    --dk-tab-active-foreground: var(--color-fd-foreground, hsl(0 0% 10%));
+  }
+}
+
+/* Tailwind utility classes for docskit */
+@layer utilities {
+  .bg-dk-background {
+    background-color: var(--dk-background);
+  }
+  .bg-dk-tabs-background {
+    background-color: var(--dk-tabs-background);
+  }
+  .border-dk-border {
+    border-color: var(--dk-border);
+  }
+  .text-dk-tab-inactive-foreground {
+    color: var(--dk-tab-inactive-foreground);
+  }
+  .text-dk-tab-active-foreground {
+    color: var(--dk-tab-active-foreground);
+  }
+  .selection\:bg-dk-selection::selection,
+  .selection\:bg-dk-selection *::selection {
+    background-color: var(--dk-selection);
+  }
+}
+
+/* CodeHike syntax highlighting theme - github-from-css */
+/* These --ch-* variables are required for the "github-from-css" theme */
+@layer base {
+  /* GitHub Dark theme (default) */
+  :root {
+    --ch-0: #e6edf3; /* default text */
+    --ch-1: #ff7b72; /* strings, inherited class */
+    --ch-2: #a5d6ff; /* string literals */
+    --ch-3: #79c0ff; /* keywords, function names */
+    --ch-4: #a5d6ff; /* constants */
+    --ch-5: #d2a8ff; /* entity names, types */
+    --ch-6: #ffa657; /* variables, tag names */
+    --ch-7: #8b949e; /* comments */
+    --ch-8: #79c0ff; /* support */
+    --ch-9: #e6edf3; /* punctuation */
+    --ch-10: #f0f6fc;
+    --ch-11: #490202;
+    --ch-12: #04260f;
+    --ch-13: #5a1e02;
+    --ch-14: #161b22;
+    --ch-15: #8b949e;
+    --ch-16: #0d1117;
+    --ch-17: #6e76811a;
+    --ch-18: #ffffff0b;
+    --ch-19: #3794ff;
+    --ch-20: #264f78;
+    --ch-21: #1f6feb;
+    --ch-22: #010409;
+    --ch-23: #30363d;
+    --ch-24: #6e7681;
+    --ch-25: #6e768166;
+    --ch-26: #0d1117e6;
+  }
+
+  /* GitHub Light theme */
+  .light,
+  [data-theme="light"] {
+    --ch-0: #24292f; /* default text */
+    --ch-1: #cf222e; /* strings, inherited class */
+    --ch-2: #116329; /* string literals */
+    --ch-3: #0550ae; /* keywords, function names */
+    --ch-4: #0a3069; /* constants */
+    --ch-5: #8250df; /* entity names, types */
+    --ch-6: #953800; /* variables, tag names */
+    --ch-7: #6e7781; /* comments */
+    --ch-8: #0550ae; /* support */
+    --ch-9: #24292f; /* punctuation */
+    --ch-10: #f6f8fa;
+    --ch-11: #ffebe9;
+    --ch-12: #dafbe1;
+    --ch-13: #ffd8b5;
+    --ch-14: #eaeef2;
+    --ch-15: #57606a;
+    --ch-16: #ffffff;
+    --ch-17: #eaeef280;
+    --ch-18: #fdff0033;
+    --ch-19: #1a85ff;
+    --ch-20: #add6ff;
+    --ch-21: #0969da;
+    --ch-22: #f6f8fa;
+    --ch-23: #d0d7de;
+    --ch-24: #8c959f;
+    --ch-25: #afb8c133;
+    --ch-26: #ffffffe6;
+  }
+}

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM"],
+    "jsx": "react-jsx",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}