vike-plugin-typedoc 0.0.1

package/dist/types.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Full API documentation structure combining multiple packages.
+ */
+export interface ApiDocs {
+    packages: Record<string, ApiPackage>;
+    allExports: ApiExport[];
+}
+/**
+ * Parsed API package from TypeDoc JSON.
+ */
+export interface ApiPackage {
+    /** NPM package name */
+    name: string;
+    /** URL-safe slug (directory name) */
+    slug: string;
+    /** Modules within the package (sub-entries) */
+    modules: ApiModule[];
+    /** All exports across all modules */
+    exports: ApiExport[];
+}
+/**
+ * A module within a package (e.g., a sub-entry point).
+ */
+export interface ApiModule {
+    name: string;
+    exports: ApiExport[];
+}
+/**
+ * A single exported symbol (function, type, interface, etc.).
+ */
+export interface ApiExport {
+    name: string;
+    /** kebab-case slug for URLs */
+    slug: string;
+    /** Full URL path, e.g. /api/devkit/create-matcher */
+    path: string;
+    /** Parent package slug */
+    package: string;
+    kind: ApiExportKind;
+    /** True if this symbol is re-exported from another package */
+    isReExport?: boolean;
+    signature?: string;
+    description?: string;
+    comment?: ApiComment;
+    parameters?: ApiParameter[];
+    returnType?: string;
+    typeParameters?: ApiTypeParameter[];
+    properties?: ApiProperty[];
+    methods?: ApiMethod[];
+    category?: string;
+}
+export type ApiExportKind = 'function' | 'type' | 'interface' | 'class' | 'variable' | 'enum';
+export interface ApiComment {
+    summary?: string;
+    remarks?: string;
+    examples?: string[];
+    see?: string[];
+    deprecated?: string;
+}
+export interface ApiParameter {
+    name: string;
+    type: string;
+    description?: string;
+    optional?: boolean;
+    defaultValue?: string;
+}
+export interface ApiTypeParameter {
+    name: string;
+    constraint?: string;
+    default?: string;
+}
+export interface ApiProperty {
+    name: string;
+    type: string;
+    description?: string;
+    optional?: boolean;
+    readonly?: boolean;
+}
+export interface ApiMethod {
+    name: string;
+    signature: string;
+    description?: string;
+    parameters?: ApiParameter[];
+    returnType?: string;
+}
+export interface NavigationItem {
+    title: string;
+    path?: string;
+    order?: number;
+    children?: NavigationItem[];
+}
+export interface TypeDocJson {
+    schemaVersion: string;
+    id: number;
+    name: string;
+    variant: string;
+    kind: number;
+    flags: Record<string, unknown>;
+    comment?: TypeDocComment;
+    children?: TypeDocReflection[];
+}
+export interface TypeDocReflection {
+    id: number;
+    name: string;
+    variant: string;
+    kind: number;
+    flags: TypeDocFlags;
+    comment?: TypeDocComment;
+    signatures?: TypeDocSignature[];
+    children?: TypeDocReflection[];
+    type?: TypeDocType;
+    typeParameters?: TypeDocTypeParameter[];
+    sources?: Array<{
+        fileName: string;
+        line: number;
+        character: number;
+    }>;
+    extendedTypes?: TypeDocType[];
+    implementedTypes?: TypeDocType[];
+    inheritedFrom?: {
+        type: string;
+        target: number;
+        name: string;
+    };
+    defaultValue?: string;
+}
+export interface TypeDocFlags {
+    isOptional?: boolean;
+    isReadonly?: boolean;
+    isPrivate?: boolean;
+    isProtected?: boolean;
+    isStatic?: boolean;
+    isAbstract?: boolean;
+}
+export interface TypeDocComment {
+    summary?: Array<{
+        kind: string;
+        text: string;
+    }>;
+    blockTags?: Array<{
+        tag: string;
+        content: Array<{
+            kind: string;
+            text: string;
+        }>;
+    }>;
+}
+export interface TypeDocSignature {
+    id: number;
+    name: string;
+    variant: string;
+    kind: number;
+    flags: TypeDocFlags;
+    comment?: TypeDocComment;
+    parameters?: TypeDocParameter[];
+    type?: TypeDocType;
+    typeParameter?: TypeDocTypeParameter[];
+}
+export interface TypeDocParameter {
+    id: number;
+    name: string;
+    variant: string;
+    kind: number;
+    flags: TypeDocFlags;
+    type?: TypeDocType;
+    comment?: TypeDocComment;
+    defaultValue?: string;
+}
+export interface TypeDocTypeParameter {
+    id: number;
+    name: string;
+    variant: string;
+    kind: number;
+    flags: TypeDocFlags;
+    type?: TypeDocType;
+    default?: TypeDocType;
+}
+export interface TypeDocType {
+    type: string;
+    name?: string;
+    value?: unknown;
+    types?: TypeDocType[];
+    declaration?: TypeDocReflection;
+    typeArguments?: TypeDocType[];
+    target?: number | TypeDocType;
+    elementType?: TypeDocType;
+    package?: string;
+    qualifiedName?: string;
+    operator?: string;
+    objectType?: TypeDocType;
+    indexType?: TypeDocType;
+    checkType?: TypeDocType;
+    extendsType?: TypeDocType;
+    trueType?: TypeDocType;
+    falseType?: TypeDocType;
+}
+/** TypeDoc kind constants (TypeDoc 2.0) */
+export declare const KIND: {
+    readonly Project: 1;
+    readonly Module: 2;
+    readonly Namespace: 4;
+    readonly Enum: 8;
+    readonly EnumMember: 16;
+    readonly Variable: 32;
+    readonly Function: 64;
+    readonly Class: 128;
+    readonly Interface: 256;
+    readonly Constructor: 512;
+    readonly Property: 1024;
+    readonly Method: 2048;
+    readonly CallSignature: 4096;
+    readonly IndexSignature: 8192;
+    readonly ConstructorSignature: 16384;
+    readonly Parameter: 32768;
+    readonly TypeLiteral: 65536;
+    readonly TypeParameter: 131072;
+    readonly Accessor: 262144;
+    readonly GetSignature: 524288;
+    readonly SetSignature: 1048576;
+    readonly TypeAlias: 2097152;
+    readonly Reference: 16777216;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,27 @@
+/** TypeDoc kind constants (TypeDoc 2.0) */
+export const KIND = {
+    Project: 1,
+    Module: 2,
+    Namespace: 4,
+    Enum: 8,
+    EnumMember: 16,
+    Variable: 32,
+    Function: 64,
+    Class: 128,
+    Interface: 256,
+    Constructor: 512,
+    Property: 1024,
+    Method: 2048,
+    CallSignature: 4096,
+    IndexSignature: 8192,
+    ConstructorSignature: 16384,
+    Parameter: 32768,
+    TypeLiteral: 65536,
+    TypeParameter: 131072,
+    Accessor: 262144,
+    GetSignature: 524288,
+    SetSignature: 1048576,
+    TypeAlias: 2097152,
+    Reference: 16777216,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAmNA,2CAA2C;AAC3C,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,OAAO,EAAE,CAAC;IACV,MAAM,EAAE,CAAC;IACT,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;IACP,UAAU,EAAE,EAAE;IACd,QAAQ,EAAE,EAAE;IACZ,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,GAAG;IACV,SAAS,EAAE,GAAG;IACd,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;IACZ,aAAa,EAAE,IAAI;IACnB,cAAc,EAAE,IAAI;IACpB,oBAAoB,EAAE,KAAK;IAC3B,SAAS,EAAE,KAAK;IAChB,WAAW,EAAE,KAAK;IAClB,aAAa,EAAE,MAAM;IACrB,QAAQ,EAAE,MAAM;IAChB,YAAY,EAAE,MAAM;IACpB,YAAY,EAAE,OAAO;IACrB,SAAS,EAAE,OAAO;IAClB,SAAS,EAAE,QAAQ;CACX,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,22 @@
+import type { ApiComment, ApiExportKind, TypeDocComment, TypeDocType } from './types.js';
+/** Convert camelCase/PascalCase to kebab-case for URL slugs. */
+export declare function slugify(name: string): string;
+/** Extract plain text from TypeDoc comment parts. */
+export declare function extractCommentText(parts?: Array<{
+    kind: string;
+    text: string;
+}>): string | undefined;
+/**
+ * Strip markdown code fences from example blocks.
+ * TypeDoc includes ```language ... ``` markers in examples.
+ */
+export declare function stripCodeFences(text: string): string;
+/** Parse a TypeDoc comment into our ApiComment structure. */
+export declare function parseComment(comment?: TypeDocComment): ApiComment | undefined;
+/** Extract @category tag from a TypeDoc comment. */
+export declare function extractCategory(comment?: TypeDocComment): string | undefined;
+/** Convert a TypeDoc type to a human-readable string. */
+export declare function typeToString(type?: TypeDocType): string;
+/** Map a TypeDoc kind number to our ApiExportKind. */
+export declare function kindToApiKind(kind: number): ApiExportKind;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,cAAc,EACd,WAAW,EACZ,MAAM,YAAY,CAAC;AAGpB,gEAAgE;AAChE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC5C,MAAM,GAAG,SAAS,CAgBpB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED,6DAA6D;AAC7D,wBAAgB,YAAY,CAC1B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,GAAG,SAAS,CAgCxB;AAED,oDAAoD;AACpD,wBAAgB,eAAe,CAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,GAAG,SAAS,CAUpB;AAED,yDAAyD;AACzD,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,CA8DvD;AAED,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAiBzD"}

package/dist/utils.js

@@ -0,0 +1,164 @@
+import { KIND } from './types.js';
+/** Convert camelCase/PascalCase to kebab-case for URL slugs. */
+export function slugify(name) {
+    return name
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[^a-zA-Z0-9]+/g, '-')
+        .toLowerCase()
+        .replace(/^-|-$/g, '');
+}
+/** Extract plain text from TypeDoc comment parts. */
+export function extractCommentText(parts) {
+    if (!parts || parts.length === 0)
+        return undefined;
+    return (parts
+        .map((p) => {
+        // TypeDoc's TSDoc parser mangles `*\/` (the JSDoc workaround for
+        // literal `*/` inside block comments) into `*\` — it drops the `/`.
+        // Within code blocks, restore `*\` at end-of-line to `*/`.
+        if (p.kind === 'code') {
+            return p.text.replace(/\*\\$/gm, '*/');
+        }
+        return p.text;
+    })
+        .join('')
+        .trim() || undefined);
+}
+/**
+ * Strip markdown code fences from example blocks.
+ * TypeDoc includes ```language ... ``` markers in examples.
+ */
+export function stripCodeFences(text) {
+    const match = text.match(/^```\w*\n?([\s\S]*?)\n?```$/);
+    if (match) {
+        return match[1].trim();
+    }
+    return text;
+}
+/** Parse a TypeDoc comment into our ApiComment structure. */
+export function parseComment(comment) {
+    if (!comment)
+        return undefined;
+    const result = {};
+    if (comment.summary) {
+        result.summary = extractCommentText(comment.summary);
+    }
+    if (comment.blockTags) {
+        for (const tag of comment.blockTags) {
+            const text = extractCommentText(tag.content);
+            switch (tag.tag) {
+                case '@remarks':
+                    result.remarks = text;
+                    break;
+                case '@example':
+                    result.examples = result.examples || [];
+                    if (text)
+                        result.examples.push(stripCodeFences(text));
+                    break;
+                case '@see':
+                    result.see = result.see || [];
+                    if (text)
+                        result.see.push(text);
+                    break;
+                case '@deprecated':
+                    result.deprecated = text || 'Deprecated';
+                    break;
+            }
+        }
+    }
+    return Object.keys(result).length > 0 ? result : undefined;
+}
+/** Extract @category tag from a TypeDoc comment. */
+export function extractCategory(comment) {
+    if (!comment?.blockTags)
+        return undefined;
+    for (const tag of comment.blockTags) {
+        if (tag.tag === '@category') {
+            return extractCommentText(tag.content);
+        }
+    }
+    return undefined;
+}
+/** Convert a TypeDoc type to a human-readable string. */
+export function typeToString(type) {
+    if (!type)
+        return 'unknown';
+    switch (type.type) {
+        case 'intrinsic':
+            return type.name || 'unknown';
+        case 'reference': {
+            let result = type.name || 'unknown';
+            if (type.typeArguments && type.typeArguments.length > 0) {
+                result += `<${type.typeArguments.map(typeToString).join(', ')}>`;
+            }
+            return result;
+        }
+        case 'literal':
+            return JSON.stringify(type.value);
+        case 'union':
+            return type.types?.map(typeToString).join(' | ') || 'unknown';
+        case 'intersection':
+            return type.types?.map(typeToString).join(' & ') || 'unknown';
+        case 'array':
+            return `${typeToString(type.elementType)}[]`;
+        case 'tuple':
+            return `[${type.types?.map(typeToString).join(', ') || ''}]`;
+        case 'reflection':
+            if (type.declaration?.signatures) {
+                const sig = type.declaration.signatures[0];
+                const params = sig.parameters
+                    ?.map((p) => `${p.name}: ${typeToString(p.type)}`)
+                    .join(', ') || '';
+                return `(${params}) => ${typeToString(sig.type)}`;
+            }
+            if (type.declaration?.children) {
+                const props = type.declaration.children
+                    .map((c) => `${c.name}: ${typeToString(c.type)}`)
+                    .join('; ');
+                return `{ ${props} }`;
+            }
+            return '{ ... }';
+        case 'indexedAccess':
+            return `${typeToString(type.objectType)}[${typeToString(type.indexType)}]`;
+        case 'conditional':
+            return `${typeToString(type.checkType)} extends ${typeToString(type.extendsType)} ? ${typeToString(type.trueType)} : ${typeToString(type.falseType)}`;
+        case 'mapped':
+            return '{ [key: string]: ... }';
+        case 'typeOperator':
+            return `${type.operator || ''} ${typeToString(type.target)}`;
+        case 'query':
+            return `typeof ${typeToString(type.target)}`;
+        case 'predicate':
+            return 'boolean';
+        case 'rest':
+            return `...${typeToString(type.elementType)}`;
+        case 'optional':
+            return `${typeToString(type.elementType)}?`;
+        case 'templateLiteral':
+            return 'string';
+        case 'namedTupleMember':
+            return type.name || 'unknown';
+        default:
+            return type.name || 'unknown';
+    }
+}
+/** Map a TypeDoc kind number to our ApiExportKind. */
+export function kindToApiKind(kind) {
+    switch (kind) {
+        case KIND.Function:
+            return 'function';
+        case KIND.Class:
+            return 'class';
+        case KIND.Interface:
+            return 'interface';
+        case KIND.TypeAlias:
+            return 'type';
+        case KIND.Enum:
+            return 'enum';
+        case KIND.Variable:
+            return 'variable';
+        default:
+            return 'variable';
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,100 @@
+{
+  "name": "vike-plugin-typedoc",
+  "version": "0.0.1",
+  "description": "Headless TypeDoc integration for Vike docs sites — parser, navigation, and context API",
+  "author": {
+    "name": "Craigory Coppola",
+    "url": "https://craigory.dev"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "default": "./dist/server.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "default": "./dist/client.js"
+    },
+    "./config": {
+      "types": "./dist/+config.d.ts",
+      "import": "./dist/+config.js",
+      "default": "./dist/+config.js"
+    },
+    "./__internal/hooks/onCreateGlobalContext": {
+      "types": "./dist/hooks/onCreateGlobalContext.d.ts",
+      "import": "./dist/hooks/onCreateGlobalContext.js",
+      "default": "./dist/hooks/onCreateGlobalContext.js"
+    },
+    "./__internal/hooks/onBeforePrerenderStart": {
+      "types": "./dist/hooks/onBeforePrerenderStart.d.ts",
+      "import": "./dist/hooks/onBeforePrerenderStart.js",
+      "default": "./dist/hooks/onBeforePrerenderStart.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "unified": "^11.0.5",
+    "remark-parse": "^11.0.0",
+    "remark-breaks": "^4.0.0",
+    "remark-directive": "^3.0.1",
+    "remark-gfm": "^4.0.1",
+    "remark-rehype": "^11.1.2",
+    "rehype-stringify": "^10.0.1",
+    "rehype-typedoc": "0.0.1"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "vike": ">=0.4.250",
+    "vike-react": ">=0.5"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "vike": {
+      "optional": true
+    },
+    "vike-react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "22.19.8",
+    "@types/react": "^19.2.9",
+    "react": "^19.2.3",
+    "typescript": "^5.7.2",
+    "vike": "^0.4.252",
+    "vike-react": "^0.6.19",
+    "vitest": "^1.3.1"
+  },
+  "homepage": "https://craigory.dev/functional-examples",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AgentEnder/functional-examples.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AgentEnder/functional-examples/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.lib.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "extract-docs": "typedoc --options typedoc.json"
+  }
+}