feat: mainlib docs on new website (#9930)

* fix(ExceptText): don't display import("d..-types/v10"). in return type

* Squashed 'packages/api-extractor-model/' content from commit 39ecb196c

git-subtree-dir: packages/api-extractor-model
git-subtree-split: 39ecb196ca210bdf84ba6c9cadb1bb93571849d7

* Squashed 'packages/api-extractor/' content from commit 341ad6c51

git-subtree-dir: packages/api-extractor
git-subtree-split: 341ad6c51b01656d4f73b74ad4bdb3095f9262c4

* feat(api-extractor): add api-extractor and -model

* fix: package.json docs script

* fix(SourcLink): use <> instead of function syntax

* fix: make packages private

* fix: rest params showing in docs, added labels

* fix: missed two files

* feat: merge docs.json from docgen and docs.api.json

* fix: cpy-cli & pnpm-lock

* fix: increase icon size

* fix: icon size again

* feat: run both docs on mainlib

* chore: website fixes

* fix: more website fixes

* fix: tests and dev database script

* chore: comment out old docs

* fix: increase max fetch cache

* fix: env should always be a string

* fix: try to reapply patches

* fix: remove prepare for docgen

* fix: temporary cosmetic fixes

* fix: horizontal scroll

* feat: generate index for new docs

---------

Co-authored-by: Noel <buechler.noel@outlook.com>

apps/website/src/components/documentation/Members.tsx

@@ -1,11 +1,13 @@
 import type { ApiDeclaredItem, ApiItemContainerMixin } from '@discordjs/api-extractor-model';
+import { EventsSection } from './section/EventsSection';
 import { MethodsSection } from './section/MethodsSection';
 import { PropertiesSection } from './section/PropertiesSection';
-import { hasProperties, hasMethods } from './util';
+import { hasEvents, hasProperties, hasMethods } from './util';
 
 export function Members({ item }: { readonly item: ApiDeclaredItem & ApiItemContainerMixin }) {
 	return (
 		<>
+			{hasEvents(item) ? <EventsSection item={item} /> : null}
 			{hasProperties(item) ? <PropertiesSection item={item} /> : null}
 			{hasMethods(item) ? <MethodsSection item={item} /> : null}
 		</>

apps/website/src/components/documentation/section/EventsSection.tsx

@@ -0,0 +1,42 @@
+import {
+	ApiItemKind,
+	type ApiEvent,
+	type ApiItem,
+	type ApiItemContainerMixin,
+	type ApiDeclaredItem,
+} from '@discordjs/api-extractor-model';
+import { VscSymbolEvent } from '@react-icons/all-files/vsc/VscSymbolEvent';
+import { Fragment, useMemo } from 'react';
+import { Event } from '~/components/model/Event';
+import { resolveMembers } from '~/util/members';
+import { DocumentationSection } from './DocumentationSection';
+
+function isEventLike(item: ApiItem): item is ApiEvent {
+	return item.kind === ApiItemKind.Event;
+}
+
+export function EventsSection({ item }: { readonly item: ApiItemContainerMixin }) {
+	const members = resolveMembers(item, isEventLike);
+
+	const eventItems = useMemo(
+		() =>
+			members.map((event, idx) => {
+				return (
+					<Fragment key={`${event.item.displayName}-${idx}`}>
+						<Event
+							inheritedFrom={event.inherited as ApiDeclaredItem & ApiItemContainerMixin}
+							item={event.item as ApiEvent}
+						/>
+						<div className="border-t-2 border-light-900 dark:border-dark-100" />
+					</Fragment>
+				);
+			}),
+		[members],
+	);
+
+	return (
+		<DocumentationSection icon={<VscSymbolEvent size={20} />} padded title="Events">
+			<div className="flex flex-col gap-4">{eventItems}</div>
+		</DocumentationSection>
+	);
+}

apps/website/src/components/documentation/tsdoc/TSDoc.tsx

@@ -32,7 +32,9 @@ export function TSDoc({ item, tsdoc }: { readonly item: ApiItem; readonly tsdoc:
 					const { codeDestination, urlDestination, linkText } = tsdoc as DocLinkTag;
 
 					if (codeDestination) {
-						const foundItem = item.getAssociatedModel()?.resolveDeclarationReference(codeDestination, item)
+						// TODO: Real fix in api-extractor needed
+						const currentItem = item.getAssociatedPackage();
+						const foundItem = item.getAssociatedModel()?.resolveDeclarationReference(codeDestination, currentItem)
 							.resolvedApiItem;
 
 						if (!foundItem) return null;

apps/website/src/components/documentation/util.ts

@@ -8,6 +8,7 @@ import type {
 	ApiPropertySignature,
 	ApiDocumentedItem,
 	ApiParameterListMixin,
+	ApiEvent,
 } from '@discordjs/api-extractor-model';
 import { METHOD_SEPARATOR, OVERLOAD_SEPARATOR } from '~/util/constants';
 import { resolveMembers } from '~/util/members';
@@ -26,6 +27,10 @@ export function hasMethods(item: ApiItemContainerMixin) {
 	);
 }
 
+export function hasEvents(item: ApiItemContainerMixin) {
+	return resolveMembers(item, memberPredicate).some(({ item: member }) => member.kind === ApiItemKind.Event);
+}
+
 export function resolveItemURI(item: ApiItem): string {
 	return !item.parent || item.parent.kind === ApiItemKind.EntryPoint
 		? `${item.displayName}${OVERLOAD_SEPARATOR}${item.kind}`
@@ -34,12 +39,13 @@ export function resolveItemURI(item: ApiItem): string {
 
 export function memberPredicate(
 	item: ApiItem,
-): item is ApiMethod | ApiMethodSignature | ApiProperty | ApiPropertySignature {
+): item is ApiEvent | ApiMethod | ApiMethodSignature | ApiProperty | ApiPropertySignature {
 	return (
 		item.kind === ApiItemKind.Property ||
 		item.kind === ApiItemKind.PropertySignature ||
 		item.kind === ApiItemKind.Method ||
-		item.kind === ApiItemKind.MethodSignature
+		item.kind === ApiItemKind.MethodSignature ||
+		item.kind === ApiItemKind.Event
 	);
 }
 
@@ -50,6 +56,11 @@ export function serializeMembers(clazz: ApiItemContainerMixin): TableOfContentsS
 				kind: member.kind as 'Method' | 'MethodSignature',
 				name: member.displayName,
 			};
+		} else if (member.kind === 'Event') {
+			return {
+				kind: member.kind as 'Event',
+				name: member.displayName,
+			};
 		} else {
 			return {
 				kind: member.kind as 'Property' | 'PropertySignature',