refactor: resolve all Biome lint warnings, zero-check clean

- Replace explicit any with proper types (unknown, specific interfaces)
- Add AstroComponentFactory import for SidebarColumn
- Make Swup.navigate required in global type declaration
- Simplify getPostUrl overloads with biome-ignore for polymorphic case
- Fix permalink type (string | undefined -> string | null)
- Biome check: 0 errors, 0 warnings, 0 infos
- Astro check: 0 errors, 0 warnings

Author: matsuzaka-yuki

src/components/atoms/Image/Image.astro

@@ -58,7 +58,6 @@ const isPublic = src.startsWith("/");
 
 // TODO temporary workaround for images dynamic import
 // https://github.com/withastro/astro/issues/3373
-// biome-ignore lint/suspicious/noImplicitAnyLet: <check later>
 let img: ImageMetadata | undefined;
 if (isLocal) {
 	const files = import.meta.glob<ImageMetadata>("../../../**", {

src/components/atoms/custom-scrollbar/CustomScrollbar.astro

@@ -1,6 +1,6 @@
 ---
 export interface Props {
-	children: any;
+	children: unknown;
 	orientation?: "horizontal" | "vertical";
 	class?: string;
 }

src/components/atoms/custom-scrollbar/types.ts

@@ -1,5 +1,5 @@
 export interface CustomScrollbarProps {
-	children: any;
+	children: unknown;
 	orientation?: "horizontal" | "vertical";
 	class?: string;
 }

src/components/control/LayoutSwitch.svelte

@@ -113,7 +113,7 @@ onMount(() => {
 	window.addEventListener("layoutChange", handleCustomEvent as EventListener);
 
 	const setupSwup = () => {
-		const swup = (window as any).swup;
+		const swup = window.swup;
 		if (swup?.hooks) {
 			swup.hooks.on("content:replace", handleSwupEvent);
 			swup.hooks.on("page:view", handleSwupEvent);
@@ -122,7 +122,7 @@ onMount(() => {
 		}
 	};
 
-	if ((window as any).swup) {
+	if (window.swup) {
 		setupSwup();
 	} else {
 		setTimeout(setupSwup, 200);
@@ -142,7 +142,7 @@ onMount(() => {
 		);
 		window.removeEventListener("popstate", handleSwupEvent);
 
-		const swup = (window as any).swup;
+		const swup = window.swup;
 		if (swup?.hooks) {
 			swup.hooks.off("content:replace", handleSwupEvent);
 			swup.hooks.off("page:view", handleSwupEvent);

src/components/control/ThemeSwitch.svelte

@@ -58,12 +58,12 @@ if (typeof window !== "undefined") {
 	};
 
 	// 检查 Swup 是否已经加载
-	if ((window as any).swup && (window as any).swup.hooks) {
-		(window as any).swup.hooks.on("content:replace", handleContentReplace);
+	if (window.swup?.hooks) {
+		window.swup.hooks.on("content:replace", handleContentReplace);
 	} else {
 		document.addEventListener("swup:enable", () => {
-			if ((window as any).swup && (window as any).swup.hooks) {
-				(window as any).swup.hooks.on("content:replace", handleContentReplace);
+			if (window.swup?.hooks) {
+				window.swup.hooks.on("content:replace", handleContentReplace);
 			}
 		});
 	}

src/components/features/pio/Pio.svelte

@@ -19,7 +19,8 @@ const merged = {
 	hideAboutMenu: config?.hideAboutMenu ?? pioConfig.hideAboutMenu ?? true,
 };
 
-let widgetInstance: any = null;
+let widgetInstance: { destroy: () => Promise<void>; sleep: () => void } | null =
+	null;
 
 async function initWidget() {
 	if (typeof window === "undefined") return;
@@ -70,10 +71,13 @@ async function initWidget() {
 		// Map menus config
 		const menusConfig = merged.menus;
 		if (menusConfig?.items && menusConfig.items.length > 0) {
-			const menuActions: Record<string, (widget: any) => void> = {
+			const menuActions: Record<
+				string,
+				(widget: { sleep: () => void }) => void
+			> = {
 				home: () => (window.location.href = "/"),
 				scrollToTop: () => window.scrollTo({ top: 0, behavior: "smooth" }),
-				sleep: (w: any) => w.sleep(),
+				sleep: (w) => w.sleep(),
 			};
 
 			options.menus = {
@@ -113,7 +117,9 @@ onMount(() => {
 
 	// Lazy load via requestIdleCallback
 	if ("requestIdleCallback" in window) {
-		(window as any).requestIdleCallback(() => initWidget(), { timeout: 5000 });
+		(
+			window as unknown as { requestIdleCallback: typeof requestIdleCallback }
+		).requestIdleCallback(() => initWidget(), { timeout: 5000 });
 	} else {
 		setTimeout(initWidget, 2000);
 	}

src/components/features/posts/JsonLd.astro

@@ -1,6 +1,6 @@
 ---
 export interface Props {
-	data: Record<string, any>;
+	data: Record<string, unknown>;
 }
 
 const { data } = Astro.props;

src/components/features/toc/hooks/useFloatingTOC.ts

@@ -72,14 +72,14 @@ export function getHeadings(
 	let minLevel = 6;
 
 	allHeadings.forEach((h) => {
-		const level = Number.parseInt(h.tagName[1]);
+		const level = Number.parseInt(h.tagName[1], 10);
 		if (level < minLevel) {
 			minLevel = level;
 		}
 	});
 
 	allHeadings.forEach((heading) => {
-		const level = Number.parseInt(heading.tagName[1]);
+		const level = Number.parseInt(heading.tagName[1], 10);
 		if (level < minLevel + maxLevel) {
 			headings.push(heading as HTMLElement);
 		}

src/components/features/toc/utils/toc-utils.ts

@@ -24,7 +24,7 @@ export function extractHeadings(
 	return Array.from(headings).map((h) => ({
 		id: h.id,
 		text: (h.textContent || "").replace(/#+\s*$/, ""),
-		level: Number.parseInt(h.tagName[1]),
+		level: Number.parseInt(h.tagName[1], 10),
 	}));
 }
 
@@ -155,7 +155,7 @@ export function calculateReadingProgress(): number {
  * @param delay - 延迟时间（毫秒）
  * @returns 防抖后的函数
  */
-export function debounce<T extends (...args: any[]) => any>(
+export function debounce<T extends (...args: unknown[]) => unknown>(
 	fn: T,
 	delay: number,
 ): (...args: Parameters<T>) => void {

src/components/layout/SidebarColumn.astro

@@ -1,6 +1,7 @@
 ---
 import { SidebarTOC } from "@components/features/toc";
 import type { MarkdownHeading } from "astro";
+import type { AstroComponentFactory } from "astro/runtime/server/index.js";
 
 import { widgetManager } from "@/utils/widget-manager";
 import { buildComponentProps } from "@/utils/widget-renderer";
@@ -82,8 +83,10 @@ const desktopStickyComponents = showDesktop
 function renderComponent(
 	component: WidgetComponentConfig,
 	index: number,
-): { Component: any; props: Record<string, unknown> } | null {
-	const ComponentToRender = componentMap[component.type] as any;
+): { Component: AstroComponentFactory; props: Record<string, unknown> } | null {
+	const ComponentToRender = componentMap[component.type] as
+		| AstroComponentFactory
+		| undefined;
 	if (!ComponentToRender) {
 		return null;
 	}