@xingwangzhe/stalux 1.51.1 → 1.52.2

package/.release/cli.mjs

@@ -1,8 +1,8 @@
-#!/usr/bin/env node
+#!/usr/bin/env bun
+// @bun
 
 // scripts/cli.ts
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { dirname, join, resolve } from "node:path";
+import { join, resolve } from "path";
 function timestamp() {
   return new Date().toISOString().replace("T", " ").slice(0, 19);
 }
@@ -130,13 +130,13 @@ This is your first post. Edit or delete it, then start writing your own content.
 ## Features
 
 - \uD83C\uDF19 Dark mode with elegant glassmorphism design
-- \uD83D\uDD24 Per-route font subsetting — each page loads only needed characters
+- \uD83D\uDD24 Per-route font subsetting \u2014 each page loads only needed characters
 - \uD83D\uDD0D Full-text search (Pagefind)
 - \uD83D\uDCE1 RSS & Atom feeds
 - \uD83D\uDCAC Comment system (Waline)
 - \uD83D\uDCCA Mermaid diagrams
 - \uD83D\uDCD0 Math formula rendering
-- \uD83D\uDDBC️ PhotoSwipe lightbox
+- \uD83D\uDDBC\uFE0F PhotoSwipe lightbox
 
 For more details, visit [Stalux documentation](https://stalux.needhelp.icu).
 `;
@@ -182,22 +182,21 @@ date: "${date}"
 > Imagination is more important than knowledge.
 `;
 }
-function writeIfMissing(filePath, label, content) {
-  if (existsSync(filePath)) {
-    console.log(`  ⏭  ${label} (exists, skipped)`);
+async function writeIfMissing(filePath, label, content) {
+  if (await Bun.file(filePath).exists()) {
+    console.log(`  \u23ED  ${label} (exists, skipped)`);
     return;
   }
-  mkdirSync(dirname(filePath), { recursive: true });
-  writeFileSync(filePath, content);
-  console.log(`  ✅  ${label}`);
+  await Bun.write(filePath, content);
+  console.log(`  \u2705  ${label}`);
 }
-function main([command, targetArg = "."] = process.argv.slice(2)) {
+async function main([command, targetArg = "."] = Bun.argv.slice(2)) {
   if (!command || command === "--help" || command === "-h") {
     printHelp();
     return;
   }
   if (command !== "init") {
-    console.error(`❌ Unknown command: ${command}`);
+    console.error(`\u274C Unknown command: ${command}`);
     printHelp();
     process.exitCode = 1;
     return;
@@ -206,9 +205,6 @@ function main([command, targetArg = "."] = process.argv.slice(2)) {
   const contentRoot = join(targetPath, "stalux");
   console.log(`\uD83D\uDCE6 Initializing Stalux content in ${targetPath}...
 `);
-  for (const dir of ["config", "posts", "about", "words"]) {
-    mkdirSync(join(contentRoot, dir), { recursive: true });
-  }
   const files = {
     ...Object.fromEntries(Object.entries(getConfigYamls()).map(([name, content]) => [`config/${name}`, content])),
     "posts/hello-stalux.md": getExamplePost(),
@@ -217,16 +213,16 @@ function main([command, targetArg = "."] = process.argv.slice(2)) {
     "words/einstein-imagination.md": getWordsExample()
   };
   for (const [file, content] of Object.entries(files)) {
-    writeIfMissing(join(contentRoot, file), `stalux/${file}`, content);
+    await writeIfMissing(join(contentRoot, file), `stalux/${file}`, content);
   }
   console.log(`
-  ✅  Done! Stalux content initialized.
+  \u2705  Done! Stalux content initialized.
 `);
   printNextSteps();
 }
 function printHelp() {
   console.log(`
-  Stalux — Modern Astro Blog Theme
+  Stalux \u2014 Modern Astro Blog Theme
 
   Usage:
     stalux init          Initialize Stalux content (configs, posts, pages)
@@ -262,4 +258,4 @@ function printNextSteps() {
   console.log("  \uD83D\uDCD6  Docs: https://stalux.needhelp.icu");
   console.log("");
 }
-main();
+await main();

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@xingwangzhe/stalux",
-    "version": "1.51.1",
+    "version": "1.52.2",
     "description": "A powerful, modern Astro blog theme — use as template or install as plugin",
     "keywords": [
         "astro",
@@ -20,7 +20,7 @@
         "url": "git+https://github.com/xingwangzhe/stalux.git"
     },
     "engines": {
-        "node": ">=26"
+        "bun": ">=1.4.0"
     },
     "bin": {
         "stalux": ".release/cli.mjs"
@@ -70,13 +70,13 @@
         "./package.json": "./package.json"
     },
     "scripts": {
-        "dev": "bun run styles:build && node scripts/dev.ts",
-        "build": "bun run styles:build && astro build --timings && node scripts/verify-build.ts",
-        "preview": "astro preview",
-        "astro": "astro",
-        "init": "node scripts/cli.ts init",
-        "node:check": "tsc6 --project tsconfig.node.json",
-        "build:cli": "bun build scripts/cli.ts --target=node --outfile .release/cli.mjs",
+        "dev": "bun run styles:build && bun scripts/dev.ts",
+        "build": "bun run styles:build && bunx --bun astro build --timings && bun scripts/verify-build.ts",
+        "preview": "bunx --bun astro preview",
+        "astro": "bunx --bun astro",
+        "init": "bun scripts/cli.ts init",
+        "node:check": "bun --bun tsc6 --project tsconfig.node.json",
+        "build:cli": "bun build scripts/cli.ts --target=bun --outfile .release/cli.mjs",
         "prepack": "bun run styles:build && bun run build:cli",
         "check": "biome check .",
         "check:fix": "biome check --write .",
@@ -84,77 +84,80 @@
         "format:check": "biome format .",
         "lint": "biome lint .",
         "lint:fix": "biome lint --write .",
-        "astro:check": "astro check --minimumFailingSeverity warning",
-        "test": "vitest",
-        "test:run": "vitest run",
-        "test:coverage": "vitest run --coverage",
-        "knip": "knip",
-        "verify:build": "node scripts/verify-build.ts",
+        "astro:check": "bunx --bun astro check --minimumFailingSeverity warning",
+        "test": "bun --bun vitest",
+        "test:run": "bun --bun vitest run",
+        "test:coverage": "bun --bun vitest run --coverage",
+        "knip": "bunx --bun knip",
+        "verify:build": "bun scripts/verify-build.ts",
         "validate": "bun run styles:build && bun run check && bun run node:check && bun run astro:check && bun run knip && bun run test:coverage && bun run build && bun run build:cli",
         "prepare": "sh -c 'if [ -d scripts/git-hooks ] && git rev-parse --git-dir >/dev/null 2>&1; then git config core.hooksPath scripts/git-hooks; fi'",
-        "dev:debug": "STALUX_DEBUG=1 astro dev --verbose",
-        "build:debug": "STALUX_DEBUG=1 astro build --timings --verbose && node scripts/verify-build.ts",
-        "styles:build": "node scripts/build-styles.ts && node scripts/build-style-names.ts",
-        "styles:watch": "node scripts/build-styles.ts --watch",
-        "benchmark:performance": "node scripts/benchmark-performance.ts",
+        "dev:debug": "STALUX_DEBUG=1 bunx --bun astro dev --verbose",
+        "build:debug": "STALUX_DEBUG=1 bunx --bun astro build --timings --verbose && bun scripts/verify-build.ts",
+        "styles:build": "bun scripts/build-styles.ts && bun scripts/build-style-names.ts",
+        "styles:watch": "bun scripts/build-styles.ts --watch",
+        "benchmark:performance": "bun scripts/benchmark-performance.ts",
         "benchmark:builds": "python3 scripts/benchmark-builds.py",
         "analyze": "SONDA=1 bun run build",
-        "backgrounds:build": "bun run scripts/build-backgrounds.ts"
+        "backgrounds:build": "bun scripts/build-backgrounds.ts"
     },
     "dependencies": {
         "@astrojs/compiler": "^4.0.0",
-        "@astrojs/markdown-satteri": "^0.4.3",
+        "@astrojs/markdown-satteri": "^0.4.6",
         "@astrojs/rss": "^4.0.19",
         "@astrojs/sitemap": "^3.7.4",
-        "@expressive-code/plugin-line-numbers": "^0.44.2",
-        "@lucide/astro": "^1.56.0",
-        "@mcp-b/webmcp-polyfill": "^5.1.0",
+        "@expressive-code/plugin-line-numbers": "^0.44.3",
+        "@lucide/astro": "^1.66.0",
+        "@mcp-b/webmcp-polyfill": "^6.0.3",
         "@microsoft/clarity": "1.0.2",
-        "@pagefind/component-ui": "^1.5.2",
+        "@pagefind/component-ui": "^1.6.0",
         "@swup/a11y-plugin": "^5.2.1",
         "@swup/head-plugin": "^2.3.1",
         "@swup/js-plugin": "^3.2.0",
         "@swup/preload-plugin": "^3.2.12",
         "@swup/scroll-plugin": "^4.0.0",
-        "@takumi-rs/core": "2.17.1",
-        "@waline/client": "^3.16.1",
+        "@takumi-rs/core": "2.19.0",
+        "@waline/client": "^3.16.2",
         "@xingwangzhe/cjk-font-split-native": "^0.4.10",
         "@xingwangzhe/satteri-mermaid": "^0.8.2",
         "@xingwangzhe/satteri-photoswipe": "^0.2.6",
         "@xingwangzhe/tags-cloud": "^1.2.9",
-        "astro-expressive-code": "^0.44.2",
+        "astro-expressive-code": "^0.44.3",
         "astro-seo": "^1.2.0",
         "badge-maker": "^6.0.0",
         "css-tree": "^3.2.1",
         "image-size": "^2.0.4",
-        "magic-string": "^1.4.3",
-        "pagefind": "^1.5.2",
-        "parse5": "^8.0.1",
+        "magic-string": "^1.4.5",
+        "pagefind": "^1.6.0",
+        "parse5": "^8.1.0",
         "photoswipe": "^5.4.4",
-        "satteri": "^0.10.5",
-        "simple-icons": "^16.35.0",
+        "satteri": "0.11.6",
+        "simple-icons": "^16.36.0",
         "swup": "4.10.0",
         "temml": "^0.14.0",
         "yaml": "^2.9.1"
     },
     "devDependencies": {
-        "@astrojs/check": "^0.9.10",
-        "@biomejs/biome": "^2.5.15",
+        "@astrojs/check": "^0.9.12",
+        "@biomejs/biome": "^2.6.5",
+        "@types/bun": "1.4.4",
         "@types/css-tree": "^3.2.0",
-        "@types/node": "^26.6.5",
-        "@unocss/astro": "^66.11.0",
-        "@vitest/coverage-v8": "^5.0.4",
-        "astro": "^7.4.4",
+        "@unocss/astro": "^66.12.0",
+        "@vitest/coverage-v8": "^5.1.0",
+        "astro": "^7.4.7",
         "happy-dom": "^21.0.4",
-        "knip": "^6.41.0",
+        "knip": "^6.44.1",
         "sharp": "0.35.5",
         "sonda": "^0.14.0",
         "typescript": "npm:@typescript/typescript6@6.0.2",
-        "unocss": "^66.11.0",
-        "vite": "^8.3.5",
-        "vitest": "^5.0.4"
+        "unocss": "^66.12.0",
+        "vite": "^8.3.6",
+        "vitest": "^5.1.0"
     },
     "peerDependencies": {
-        "astro": "^7.4.4"
+        "astro": "^7.4.7"
+    },
+    "overrides": {
+        "satteri": "0.11.6"
     }
 }

package/src/components/stalux/footer/FooterBadges.astro

@@ -29,8 +29,8 @@ function badgeImg(opts: BadgeOptions) {
         ? sitePath(`stalux-assets/badges/${id}.svg`)
         : svgToDataUrl(svg);
     const alt = opts.alt || `${opts.label}: ${opts.message}`;
-    const width = svg.match(/<svg\b[^>]*\bwidth="(\d+)"/)?.[1];
-    const height = svg.match(/<svg\b[^>]*\bheight="(\d+)"/)?.[1];
+    const width = svg.match(/<svg\b[^>]*\bwidth="(\d+)"/u)?.[1];
+    const height = svg.match(/<svg\b[^>]*\bheight="(\d+)"/u)?.[1];
     const dimensions = width && height ? ` width="${width}" height="${height}"` : "";
     // Closed badge groups should not initialize every SVG document during first paint.
     const img = `<img src="${src}" alt="${alt}" class="stalux-badge" loading="lazy" decoding="async"${dimensions} />`;

package/src/components/stalux/layout/head.astro

@@ -48,7 +48,7 @@ const seo = buildSeoDocument({
     exportMarkdown: Boolean(promoteConfig?.export_md),
     version: packageJson.version,
 });
-const ldJson = JSON.stringify(seo.schema).replace(/<\//g, "<\\/");
+const ldJson = JSON.stringify(seo.schema).replace(/<\//gu, "<\\/");
 ---
 
 <head>

package/src/components/stalux/posts/postContent.astro

@@ -36,7 +36,7 @@ const timezone = siteConfig.timezone;
 // /about 等非文章页面固定不显示 Markdown 原文按钮
 const isAboutPage = Astro.url.pathname.startsWith("/about");
 const exportMd = Boolean(promoteConfig?.export_md) && !isAboutPage;
-const mdSourceUrl = exportMd ? `${Astro.url.pathname.replace(/\/$/, "")}.md` : "";
+const mdSourceUrl = exportMd ? `${Astro.url.pathname.replace(/\/$/u, "")}.md` : "";
 ---
 
 <article

package/src/index.ts

@@ -13,10 +13,9 @@ import { styleNames } from "./internal/style-names.generated.ts";
  * 基于 Astro 7.1.3 Integration API（astro:config:setup / injectRoute / injectScript）
  */
 
-import { copyFileSync, existsSync, promises as fs, readdirSync, readFileSync } from "node:fs";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { createRequire } from "node:module";
 import path from "node:path";
-import { fileURLToPath } from "node:url";
 import sitemap from "@astrojs/sitemap";
 import { mermaidHast, mermaidMdast } from "@xingwangzhe/satteri-mermaid";
 import { photoswipe } from "@xingwangzhe/satteri-photoswipe";
@@ -151,15 +150,19 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                 const markdownLogger = logger.fork("stalux/markdown");
                 const fontsLogger = logger.fork("stalux/fonts");
                 configLogger.debug(`setup started; mode=${isPluginMode ? "plugin" : "source"}`);
-                const srcDir = fileURLToPath(new URL(".", import.meta.url));
-                const runtimeCacheKey = createRuntimeCacheKey(
+                const srcDir = Bun.fileURLToPath(new URL(".", import.meta.url));
+                const runtimeCacheKey = await createRuntimeCacheKey(
                     path.join(srcDir, "scripts"),
                     path.resolve(srcDir, "../package.json"),
                     path.join(srcDir, "styles"),
                     JSON.stringify([styleNames, modernCssTargets]) +
-                        readFileSync(path.join(srcDir, "internal/compact-styles.ts"), "utf8") +
-                        readFileSync(path.join(srcDir, "internal/offscreen-layout.ts"), "utf8"),
-                    path.resolve(fileURLToPath(config.root), opt.contentDir ?? "stalux", "config"),
+                        (await Bun.file(path.join(srcDir, "internal/compact-styles.ts")).text()) +
+                        (await Bun.file(path.join(srcDir, "internal/offscreen-layout.ts")).text()),
+                    path.resolve(
+                        Bun.fileURLToPath(config.root),
+                        opt.contentDir ?? "stalux",
+                        "config",
+                    ),
                 );
 
                 // 1. 注入 Vite 别名 + 组件覆盖插件 + Vue 特性标记（Waline 依赖）
@@ -223,8 +226,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                         define: {
                             __STALUX_COMPACT_STYLES__: JSON.stringify(command === "build"),
                             __STALUX_DEBUG__: JSON.stringify(
-                                process.env.STALUX_DEBUG === "1" ||
-                                    process.argv.includes("--verbose"),
+                                Bun.env.STALUX_DEBUG === "1" || Bun.argv.includes("--verbose"),
                             ),
                             __VUE_OPTIONS_API__: true,
                             __VUE_PROD_DEVTOOLS__: false,
@@ -256,7 +258,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                         id: "stalux",
                         name: "Stalux",
                         icon: '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M12 2L2 7l10 5 10-5-10-5z"/><path d="M2 17l10 5 10-5"/><path d="M2 12l10 5 10-5"/></svg>',
-                        entrypoint: fileURLToPath(
+                        entrypoint: Bun.fileURLToPath(
                             new URL("./internal/dev-toolbar.ts", import.meta.url),
                         ),
                     });
@@ -324,15 +326,15 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                         "config",
                         "site.yml",
                     );
-                    const siteYaml = readFileSync(siteYamlPath, "utf-8");
-                    const urlMatch = siteYaml.match(/^url\s*:\s*(.+)$/m);
+                    const siteYaml = await Bun.file(siteYamlPath).text();
+                    const urlMatch = siteYaml.match(/^url\s*:\s*(.+)$/mu);
                     const rawYamlUrl = urlMatch?.[1];
                     const yamlUrl = rawYamlUrl
                         ?.trim()
-                        .replace(/^["']|["']$/g, "")
-                        .replace(/\/+$/, "");
+                        .replace(/^["']|["']$/gu, "")
+                        .replace(/\/+$/u, "");
                     if (yamlUrl) {
-                        const configuredSite = config.site?.replace(/\/+$/, "");
+                        const configuredSite = config.site?.replace(/\/+$/u, "");
                         if (!configuredSite || configuredSite === "https://example.com") {
                             // 未配置或为占位符 → 直接以 site.yml 为准
                             updateConfig({ site: yamlUrl });
@@ -348,7 +350,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                         }
                     }
                 } catch (error) {
-                    if ((error as NodeJS.ErrnoException).code === "ENOENT") {
+                    if ((error as { code?: string }).code === "ENOENT") {
                         configLogger.debug("site.yml not found; site sync skipped");
                     } else {
                         configLogger.warn(`site sync failed: ${describeError(error)}`);
@@ -361,7 +363,11 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                     if (sliced) {
                         pageFontData = {
                             fontBuffer: sliced.fontBuffer,
-                            outputDir: path.join(fileURLToPath(config.outDir), "_astro", "fonts"),
+                            outputDir: path.join(
+                                Bun.fileURLToPath(config.outDir),
+                                "_astro",
+                                "fonts",
+                            ),
                             cacheDir: sliced.pageSubsetDir,
                         };
                         updateConfig({
@@ -379,27 +385,27 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
 
             // Read final paths after every integration has finished updating configuration.
             // Public assets must exist before Astro creates its Vite server/build asset pipeline.
-            "astro:config:done": ({ config, logger }) => {
-                const srcDir = fileURLToPath(new URL(".", import.meta.url));
-                const publicDir = fileURLToPath(config.publicDir);
+            "astro:config:done": async ({ config, logger }) => {
+                const srcDir = Bun.fileURLToPath(new URL(".", import.meta.url));
+                const publicDir = Bun.fileURLToPath(config.publicDir);
                 Object.assign(socialCardPaths, {
                     publicDir,
-                    cacheDir: fileURLToPath(new URL("stalux-social-cards/", config.cacheDir)),
+                    cacheDir: Bun.fileURLToPath(new URL("stalux-social-cards/", config.cacheDir)),
                     base: config.base,
                     fontPath: path.join(srcDir, "assets/fonts/LXGWWenKai-Regular.ttf"),
                 });
-                coverCacheDir = fileURLToPath(new URL("stalux-post-covers/", config.cacheDir));
+                coverCacheDir = Bun.fileURLToPath(new URL("stalux-post-covers/", config.cacheDir));
                 const assetsLogger = logger.fork("stalux/assets");
                 if (pageFontData) {
                     pageFontData.outputDir = path.join(
-                        fileURLToPath(config.outDir),
+                        Bun.fileURLToPath(config.outDir),
                         "_astro",
                         "fonts",
                     );
                 }
                 try {
-                    syncFontAssets(srcDir, publicDir);
-                    const { copied, skipped } = syncBackgroundSvgs(srcDir, publicDir);
+                    await syncFontAssets(srcDir, publicDir);
+                    const { copied, skipped } = await syncBackgroundSvgs(srcDir, publicDir);
                     if (copied > 0) {
                         assetsLogger.info(`同步背景 SVG ${copied} 个（跳过 ${skipped} 个不变）`);
                     } else if (skipped > 0) {
@@ -415,13 +421,16 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                 const started = performance.now();
                 const outDir = pageFontData
                     ? path.dirname(path.dirname(pageFontData.outputDir))
-                    : fileURLToPath(new URL(String(dir)));
+                    : Bun.fileURLToPath(new URL(String(dir)));
 
                 // Astro's Markdown image transform drops arbitrary lazy-loading hints
                 // added during HAST processing. Reapply the policy to emitted HTML.
-                const htmlFiles = await fs.readdir(outDir, { recursive: true });
-                const sourceDir = fileURLToPath(new URL(".", import.meta.url));
-                const resolveModule = createRequire(import.meta.url).resolve;
+                const htmlFiles = [
+                    ...new Bun.Glob("**/*").scanSync({ cwd: outDir, onlyFiles: true }),
+                ].sort();
+                const sourceDir = Bun.fileURLToPath(new URL(".", import.meta.url));
+                const moduleDir = Bun.fileURLToPath(new URL(".", import.meta.url));
+                const resolveModule = (id: string) => Bun.resolveSync(id, moduleDir);
                 const requireModule = createRequire(import.meta.url);
                 const coverEncoder = coverCacheDir
                     ? loadCoverEncoder(requireModule, logger)
@@ -434,12 +443,10 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                 let sharedFontKey = "";
                 if (pageFontData) {
                     const sharedGlyphs = createSharedFontGlyphs();
-                    await fs.mkdir(pageFontData.outputDir, { recursive: true });
-                    await fs.mkdir(pageFontData.cacheDir, { recursive: true });
                     // The common shell is static across soft navigations; scan once, then
                     // reuse each component's content-addressed subset on every route.
                     await forEachBounded(pageEntries, 4, async (entry) => {
-                        const html = await fs.readFile(path.join(outDir, entry), "utf8");
+                        const html = await Bun.file(path.join(outDir, entry)).text();
                         collectSharedFontGlyphs(parse(html), sharedGlyphs);
                     });
                     sharedFonts = await writeSharedFontSubsetsAsync(
@@ -478,13 +485,11 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                 let optimizedImagePages = 0;
                 let pageFontPages = 0;
                 let pageFontSubsetCacheHits = 0;
-                if (pageFontData) await fs.mkdir(pageFontData.outputDir, { recursive: true });
-                if (pageFontData) await fs.mkdir(pageFontData.cacheDir, { recursive: true });
                 const referencedPageFonts = new Set<string>();
                 for (const sharedFont of sharedFonts) {
-                    copyFileSync(
-                        sharedFont.sourcePath,
+                    await Bun.write(
                         path.join(pageFontData?.outputDir ?? outDir, sharedFont.filename),
+                        Bun.file(sharedFont.sourcePath),
                     );
                     referencedPageFonts.add(sharedFont.filename);
                 }
@@ -492,21 +497,21 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                 const dimensionsCache = new Map<string, Promise<ImageDimensions | undefined>>();
                 const processPage = async (entry: string) => {
                     const output = path.join(outDir, entry);
-                    const before = await fs.readFile(output, "utf8");
+                    const before = await Bun.file(output).text();
                     const cached = await outputCache.get(entry, before);
                     if (cached) {
                         if (cached.font && pageFontData) {
                             if (!referencedPageFonts.has(cached.font.filename)) {
-                                copyFileSync(
-                                    cached.font.sourcePath,
+                                await Bun.write(
                                     path.join(pageFontData.outputDir, cached.font.filename),
+                                    Bun.file(cached.font.sourcePath),
                                 );
                             }
                             referencedPageFonts.add(cached.font.filename);
                             pageFontPages++;
                         }
                         if (cached.html !== before) {
-                            await fs.writeFile(output, cached.html);
+                            await Bun.write(output, cached.html);
                             optimizedImagePages++;
                         }
                         cacheHits++;
@@ -542,7 +547,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                         }
                     }
                     if (pageFontData) {
-                        const linkedStylesheetText = readLinkedStylesheetText(
+                        const linkedStylesheetText = await readLinkedStylesheetText(
                             "",
                             output,
                             outDir,
@@ -566,9 +571,9 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                                 sourcePath: pageFont.sourcePath,
                             };
                             if (!referencedPageFonts.has(pageFont.filename)) {
-                                copyFileSync(
-                                    pageFont.sourcePath,
+                                await Bun.write(
                                     path.join(pageFontData.outputDir, pageFont.filename),
+                                    Bun.file(pageFont.sourcePath),
                                 );
                             }
                             referencedPageFonts.add(pageFont.filename);
@@ -576,7 +581,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                     }
                     const after = emitHtml();
                     if (after !== before) {
-                        await fs.writeFile(output, after);
+                        await Bun.write(output, after);
                         optimizedImagePages++;
                     }
                     await outputCache.set(
@@ -592,7 +597,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                 // Bound I/O concurrency without retaining the entire site's HTML in memory.
                 await forEachBounded(pageEntries, 4, processPage);
                 if (pageFontData) {
-                    clearPageFontSubsets(pageFontData.outputDir, referencedPageFonts);
+                    await clearPageFontSubsets(pageFontData.outputDir, referencedPageFonts);
                 }
                 logger.info(`applied image loading hints to ${optimizedImagePages} HTML pages`);
                 logger.info(
@@ -614,7 +619,7 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                 // post-processed: a cached page skips that pass entirely but its
                 // HTML already points at these files, so they must always exist.
                 if (coverCacheDir) {
-                    const restored = restoreCoverFiles({ outDir, cacheDir: coverCacheDir });
+                    const restored = await restoreCoverFiles({ outDir, cacheDir: coverCacheDir });
                     if (restored > 0) logger.debug(`restored ${restored} card covers`);
                 }
 
@@ -738,14 +743,15 @@ export function stalux(options: StaluxOptions = {}): AstroIntegration[] {
                     "astro:build:done": async ({ dir, logger }) => {
                         const base = userSitemap?.filenameBase ?? "sitemap";
                         const source = new URL(`${base}-0.xml`, dir);
-                        if (!existsSync(source)) return;
+                        if (!(await Bun.file(source).exists())) return;
                         // Keep every URL discoverable when a site uses multiple chunks.
                         const index = new URL(`${base}-index.xml`, dir);
-                        const indexXml = await fs.readFile(index, "utf8");
-                        const hasMultipleSitemaps = (indexXml.match(/<sitemap>/g)?.length ?? 0) > 1;
-                        await fs.copyFile(
-                            hasMultipleSitemaps ? index : source,
+                        const indexXml = await Bun.file(index).text();
+                        const hasMultipleSitemaps =
+                            (indexXml.match(/<sitemap>/gu)?.length ?? 0) > 1;
+                        await Bun.write(
                             new URL("sitemap.xml", dir),
+                            Bun.file(hasMultipleSitemaps ? index : source),
                         );
                         logger.info("Generated sitemap.xml");
                     },

package/src/internal/cjk-search-index.ts

@@ -1,5 +1,3 @@
-import { createHash } from "node:crypto";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { type DefaultTreeAdapterMap, parse } from "parse5";
 import { type CjkDocument, cjkGrams, gramShard, normalizeSearch } from "../utils/cjk-search";
@@ -92,17 +90,16 @@ export function extractCjkDocument(html: string, url: string) {
 /** Content-addressed shards prevent mixed old/new deployments and keep downloads query-specific. */
 export async function writeCjkSearchIndex(outDir: string, htmlFiles: string[], base: string) {
     const directory = path.join(outDir, "pagefind", "cjk");
-    await mkdir(directory, { recursive: true });
     async function asset(value: unknown) {
         const json = JSON.stringify(value);
-        const hash = createHash("sha256").update(json).digest("hex").slice(0, 20);
+        const hash = new Bun.CryptoHasher("sha256").update(json).digest("hex").slice(0, 20);
         const file = `${hash}.json`;
-        await writeFile(path.join(directory, file), json);
+        await Bun.write(path.join(directory, file), json);
         return file;
     }
     const extracted = new Map<string, NonNullable<ReturnType<typeof extractCjkDocument>>>();
     await forEachBounded(htmlFiles, 6, async (file) => {
-        const html = await readFile(path.join(outDir, file), "utf8");
+        const html = await Bun.file(path.join(outDir, file)).text();
         // Most output pages are archives/tags: don't parse pages without indexed sections.
         if (!html.includes("data-pagefind-body")) return;
         const url = `${base.replace(/\/$/u, "")}/${file.replace(/index\.html$/u, "")}`;
@@ -125,6 +122,6 @@ export async function writeCjkSearchIndex(outDir: string, htmlFiles: string[], b
     }
     const shards: Record<string, string> = {};
     for (const [key, value] of Object.entries(postings)) shards[key] = await asset(value);
-    await writeFile(path.join(directory, "manifest.json"), JSON.stringify({ documents, shards }));
+    await Bun.write(path.join(directory, "manifest.json"), JSON.stringify({ documents, shards }));
     return documents.length;
 }

package/src/internal/components-plugin.ts

@@ -16,8 +16,6 @@
  * 插件自动将别名解析为用户提供的路径或包内默认路径。
  */
 
-import { fileURLToPath } from "node:url";
-
 import type { AstroIntegrationLogger } from "astro";
 import type { Plugin } from "vite";
 
@@ -34,7 +32,7 @@ export function staluxComponentsAlias(
     logger?: AstroIntegrationLogger,
 ): Plugin {
     // 包内 components 目录的绝对路径
-    const componentsDir = fileURLToPath(new URL("../components", import.meta.url));
+    const componentsDir = Bun.fileURLToPath(new URL("../components", import.meta.url));
 
     return {
         name: "stalux:components-alias",