refactor: move components utils to lib/components

Author: velut

lib/declaration-signature-to-html.test.ts …ts/declaration-signature-to-html.test.tslib/declaration-signature-to-html.test.ts renamed to lib/components/declaration-signature-to-html.test.ts lib/declaration-signature-to-html.test.ts renamed to lib/components/declaration-signature-to-html.test.ts

@@ -1,7 +1,7 @@
 import type { AllExtractedDeclaration } from "@jsdocs-io/extractor";
+import { codeToHtml } from "../shiki/shiki.bundle";
+import { domPurify } from "../utils/dom-purify";
 import type { DeclarationUrlFn } from "./declaration-url";
-import { domPurify } from "./dom-purify";
-import { codeToHtml } from "./shiki.bundle";
 
 const reservedKeywords = new Set([
   "any",
@@ -75,10 +75,10 @@ const reservedKeywords = new Set([
   "yield",
 ]);
 
-export const declarationSignatureToHtml = async (
+export async function declarationSignatureToHtml(
   declaration: AllExtractedDeclaration,
   declarationUrl: DeclarationUrlFn,
-): Promise<string> => {
+): Promise<string> {
   const { signature, isWrapped } = prepareSignature(declaration);
   const html = await codeToHtml(signature, {
     // Render to highlighted HTML if the signature is not too long,
@@ -130,9 +130,9 @@ export const declarationSignatureToHtml = async (
     ],
   });
   return domPurify.sanitize(html);
-};
+}
 
-const prepareSignature = (declaration: AllExtractedDeclaration) => {
+function prepareSignature(declaration: AllExtractedDeclaration) {
   const { kind, signature } = declaration;
   switch (kind) {
     case "variable":
@@ -170,4 +170,4 @@ const prepareSignature = (declaration: AllExtractedDeclaration) => {
       };
     }
   }
-};
+}

lib/declaration-signature-to-html.ts …ponents/declaration-signature-to-html.tslib/declaration-signature-to-html.ts renamed to lib/components/declaration-signature-to-html.ts lib/declaration-signature-to-html.ts renamed to lib/components/declaration-signature-to-html.ts

@@ -37,17 +37,17 @@ const knownTypes = [
   ["typeof", "https://www.typescriptlang.org/docs/handbook/2/typeof-types.html"],
 ] as const;
 
-export const makeDeclarationUrl = (declarations: ExtractedDeclaration[]) => {
+export function makeDeclarationUrl(declarations: ExtractedDeclaration[]) {
   const nameToUrl = new Map<string, string>(knownTypes);
   addDeclarations(declarations, nameToUrl);
   return (name: string): string | undefined => nameToUrl.get(name);
-};
+}
 
-const addDeclarations = (declarations: ExtractedDeclaration[], nameToUrl: Map<string, string>) => {
+function addDeclarations(declarations: ExtractedDeclaration[], nameToUrl: Map<string, string>) {
   for (const declaration of declarations) {
     if (declaration.kind === "namespace") {
       addDeclarations(declaration.declarations, nameToUrl);
     }
     nameToUrl.set(declaration.name, `#${shortId(declaration.id)}`);
   }
-};
+}

lib/declaration-url.test.ts lib/components/declaration-url.test.tslib/declaration-url.test.ts renamed to lib/components/declaration-url.test.ts

@@ -1,10 +1,10 @@
 import { trimNewlines } from "trim-newlines";
-import { domPurify } from "./dom-purify";
-import { bundledLanguages, codeToHtml } from "./shiki.bundle";
+import { bundledLanguages, codeToHtml } from "../shiki/shiki.bundle";
+import { domPurify } from "../utils/dom-purify";
 
 const languages = new Set(Object.keys(bundledLanguages));
 
-export const fencedCodeToHtml = async (code: string, language: string): Promise<string> => {
+export async function fencedCodeToHtml(code: string, language: string): Promise<string> {
   // Trim newlines to prevent rendering empty space surrounding content
   // but preserve other whitespace that may be used for alignment.
   const trimmedCode = trimNewlines(code);
@@ -23,4 +23,4 @@ export const fencedCodeToHtml = async (code: string, language: string): Promise<
     },
   });
   return domPurify.sanitize(html);
-};
+}

lib/declaration-url.ts lib/components/declaration-url.tslib/declaration-url.ts renamed to lib/components/declaration-url.ts

@@ -1,9 +1,9 @@
 import { marked } from "marked";
-import { domPurify } from "./dom-purify";
+import { domPurify } from "../utils/dom-purify";
 
-export const mdToHtml = async (md: string): Promise<string> => {
+export async function mdToHtml(md: string): Promise<string> {
   /* oxlint-disable no-misleading-character-class */
   const withoutZeroWidth = md.replace(/^[\u200B\u200C\u200D\u200E\u200F\uFEFF]/, "");
   const unsafeMd = await marked.parseInline(withoutZeroWidth);
   return domPurify.sanitize(unsafeMd);
-};
+}

lib/fenced-code-to-html.test.ts …b/components/fenced-code-to-html.test.tslib/fenced-code-to-html.test.ts renamed to lib/components/fenced-code-to-html.test.ts lib/fenced-code-to-html.test.ts renamed to lib/components/fenced-code-to-html.test.ts

@@ -1,10 +1,17 @@
 import type { DocDeclarationReference } from "@microsoft/tsdoc";
 
-export const resolveDeclarationReference = (ref: DocDeclarationReference) => {
+export interface ResolvedDeclarationReference {
+  pkgName: string | undefined;
+  declarationId: string;
+}
+
+export function resolveDeclarationReference(
+  ref: DocDeclarationReference,
+): ResolvedDeclarationReference {
   const { packageName, memberReferences } = ref;
   const declarationId = memberReferences
     .map((ref) => ref.memberIdentifier?.identifier)
     .filter(Boolean)
     .join(".");
   return { pkgName: packageName, declarationId };
-};
+}