astro.config.mjs

import { resolve as resolvePath } from "node:path";
import { fileURLToPath } from "node:url";
import node from "@astrojs/node";
import sitemap from "@astrojs/sitemap";
import svelte, { vitePreprocess } from "@astrojs/svelte";
import { pluginCollapsibleSections } from "@expressive-code/plugin-collapsible-sections";
import { pluginLineNumbers } from "@expressive-code/plugin-line-numbers";

import tailwindcss from "@tailwindcss/vite";
import { config as loadDotenv } from "dotenv";
import { defineConfig } from "astro/config";
import expressiveCode from "astro-expressive-code";
import icon from "astro-icon";
import { resolvePublicBaseUrl } from "./src/config/public-base-url.mjs";
import { pluginCustomCopyButton } from "./src/plugins/expressive-code/custom-copy-button.js";
import { pluginLanguageBadge } from "./src/plugins/expressive-code/language-badge.ts";
import { shouldIgnoreBuildWarning } from "./src/utils/vite-build-warning-filter.ts";
import {
    rehypePlugins,
    remarkPlugins,
} from "./src/server/markdown/pipeline.ts";

loadDotenv();

const resolvedPublicBaseUrl = resolvePublicBaseUrl(process.env);
const projectRootDir = fileURLToPath(new URL(".", import.meta.url));

// https://astro.build/config
export default defineConfig({
    site: resolvedPublicBaseUrl.siteURL,
    base: "/",
    trailingSlash: "never",
    devToolbar: {
        enabled: false,
    },
    server: {
        allowedHosts: true,
    },

    security: {
        // Astro's built-in form-origin middleware compares Origin with
        // Astro.url.origin before our BFF guard can account for reverse-proxy
        // headers. Keep the project-level same-origin + CSRF + rate-limit guard
        // as the write boundary so multipart uploads work behind Docker Caddy.
        checkOrigin: false,
        allowedDomains: [{ hostname: resolvedPublicBaseUrl.hostname }],
    },

    // server 模式只改变默认渲染策略；静态例外继续由显式 prerender 控制。
    output: "server",
    adapter: node({
        mode: "standalone",
    }),

    prefetch: {
        prefetchAll: false,
        defaultStrategy: "hover",
    },

    integrations: [
        icon(),
        expressiveCode({
            themes: ["github-light", "github-dark"],
            plugins: [
                pluginCollapsibleSections(),
                pluginLineNumbers(),
                pluginLanguageBadge(),
                pluginCustomCopyButton(),
            ],
            defaultProps: {
                wrap: true,
                overridesByLang: {
                    shellsession: { showLineNumbers: false },
                    bash: { frame: "code" },
                    shell: { frame: "code" },
                    sh: { frame: "code" },
                    zsh: { frame: "code" },
                },
            },
            styleOverrides: {
                codeBackground: "var(--codeblock-bg)",
                borderRadius: "0.75rem",
                borderColor: "none",
                codeFontSize: "0.875rem",
                codeFontFamily: "var(--font-mono)",
                codeLineHeight: "1.5rem",
                frames: {
                    editorBackground: "var(--codeblock-bg)",
                    terminalBackground: "var(--codeblock-bg)",
                    terminalTitlebarBackground: "var(--codeblock-bg)",
                    editorTabBarBackground: "var(--codeblock-bg)",
                    editorActiveTabBackground: "none",
                    editorActiveTabIndicatorBottomColor: "var(--primary)",
                    editorActiveTabIndicatorTopColor: "none",
                    editorTabBarBorderBottomColor: "var(--codeblock-bg)",
                    terminalTitlebarBorderBottomColor: "none",
                },
                textMarkers: {
                    delHue: 0,
                    insHue: 180,
                    markHue: 250,
                },
            },
            frames: {
                showCopyToClipboardButton: false,
            },
        }),
        svelte({
            preprocess: vitePreprocess(),
        }),
        sitemap(),
    ],
    markdown: {
        remarkPlugins,
        rehypePlugins,
    },
    vite: {
        resolve: {
            alias: {
                "@": resolvePath(projectRootDir, "src"),
                "@components": resolvePath(projectRootDir, "src/components"),
                "@assets": resolvePath(projectRootDir, "src/assets"),
                "@constants": resolvePath(projectRootDir, "src/constants"),
                "@utils": resolvePath(projectRootDir, "src/utils"),
                "@i18n": resolvePath(projectRootDir, "src/i18n"),
                "@layouts": resolvePath(projectRootDir, "src/layouts"),
            },
        },
        plugins: [tailwindcss()],
        build: {
            // 静态资源处理优化，防止小图片转 base64 导致 HTML 体积过大（可选，根据需要调整）
            assetsInlineLimit: 4096,
            // Monaco 仅在发布编辑器页面按需加载，放宽提示阈值，避免对已知的大型惰性 chunk 反复报警。
            chunkSizeWarningLimit: 3000,

            rollupOptions: {
                output: {
                    manualChunks(id) {
                        if (
                            id.includes(
                                "astro/dist/core/middleware/index.js",
                            ) ||
                            id.includes(
                                "astro/dist/core/middleware/sequence.js",
                            )
                        ) {
                            return "astro-middleware-core";
                        }

                        return undefined;
                    },
                },
                onwarn(warning, warn) {
                    // 仅收敛已确认无害的上游构建链噪音，其他 warning 继续原样透传。
                    if (shouldIgnoreBuildWarning(warning)) {
                        return;
                    }
                    warn(warning);
                },
            },
        },
    },
});