Closes #2790 allow png favicon

Author: mistic100

site/options/output.md

@@ -262,7 +262,7 @@ Create a CNAME file in the output directory with the specified text.
 $ typedoc --favicon favicon.ico
 ```
 
-Specify a `favicon.ico` or `favicon.svg` file to reference as the site favicon.
+Specify a `.ico`, `.png` or `.svg` file to reference as the site favicon.
 
 ## sourceLinkExternal
 

src/lib/internationalization/locales/en.cts

@@ -269,7 +269,7 @@ export = {
     help_cname:
         "Set the CNAME file text, it's useful for custom domains on GitHub Pages",
     help_favicon:
-        "Path to a favicon.ico or favicon.svg to include as the site icon",
+        "Path to a .ico, .png or .svg file to include as the site icon",
     help_sourceLinkExternal:
         "Specifies that source links should be treated as external links to be opened in a new tab",
     help_markdownLinkExternal:
@@ -388,7 +388,7 @@ export = {
         "hostedBaseUrl must start with http:// or https://",
     useHostedBaseUrlForAbsoluteLinks_requires_hostedBaseUrl:
         "The useHostedBaseUrlForAbsoluteLinks option requires that hostedBaseUrl be set",
-    favicon_must_be_ico_or_svg: "Favicon file must be either a .ico or .svg",
+    favicon_must_be_ico_or_svg: "Favicon file must be either a .ico, .png or .svg",
     option_0_must_be_an_object: "The '{0}' option must be a non-array object",
     option_0_must_be_a_function: "The '{0}' option must be a function",
     option_0_must_be_object_with_urls: `{0} must be an object with string labels as keys and URL values`,

src/lib/output/plugins/AssetsPlugin.ts

@@ -43,13 +43,8 @@ export class AssetsPlugin extends RendererComponent {
     private onRenderBegin(event: RendererEvent) {
         const dest = join(event.outputDirectory, "assets");
 
-        switch (extname(this.favicon)) {
-            case ".ico":
-                copySync(this.favicon, join(dest, "favicon.ico"));
-                break;
-            case ".svg":
-                copySync(this.favicon, join(dest, "favicon.svg"));
-                break;
+        if ([".ico", ".png", ".svg"].includes(extname(this.favicon))) {
+            copySync(this.favicon, join(dest, "favicon" + extname(this.favicon)));
         }
 
         if (this.customCss) {

src/lib/output/themes/default/layouts/default.tsx

@@ -13,6 +13,8 @@ function favicon(context: DefaultThemeRenderContext) {
     switch (extname(fav)) {
         case ".ico":
             return <link rel="icon" href={context.relativeURL("assets/favicon.ico", true)} />;
+        case ".png":
+            return <link rel="icon" href={context.relativeURL("assets/favicon.png", true)} type="image/png" />;
         case ".svg":
             return <link rel="icon" href={context.relativeURL("assets/favicon.svg", true)} type="image/svg+xml" />;
         default:

src/lib/utils/options/sources/typedoc.ts

@@ -473,7 +473,7 @@ export function addTypeDocOptions(options: Pick<Options, "addDeclaration">) {
         name: "favicon",
         help: (i18n) => i18n.help_favicon(),
         validate(value, i18n) {
-            if (![".ico", ".svg"].includes(extname(value))) {
+            if (![".ico", ".png", ".svg"].includes(extname(value))) {
                 throw new Error(i18n.favicon_must_be_ico_or_svg());
             }
         },