@astro-minimax/core 0.1.0

package/README.md

@@ -0,0 +1,29 @@
+# @astro-minimax/core
+
+Core theme package for [astro-minimax](https://github.com/souloss/astro-minimax).
+
+Includes layouts, navigation components, blog components, UI components, social components, styles, utilities, and remark/rehype plugins.
+
+## Installation
+
+```bash
+pnpm add @astro-minimax/core
+```
+
+## Usage
+
+```astro
+---
+import Layout from '@astro-minimax/core/layouts/Layout.astro';
+import Header from '@astro-minimax/core/components/nav/Header.astro';
+import Footer from '@astro-minimax/core/components/nav/Footer.astro';
+---
+
+<Layout title="My Page">
+  <Header />
+  <main><slot /></main>
+  <Footer />
+</Layout>
+```
+
+See the [documentation](https://github.com/souloss/astro-minimax) for full usage details.

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@astro-minimax/core",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Core theme package for astro-minimax — layouts, components, styles, utilities and plugins.",
+  "author": "Souloss",
+  "license": "MIT",
+  "keywords": [
+    "astro",
+    "astro-theme",
+    "blog",
+    "minimalist",
+    "tailwindcss"
+  ],
+  "homepage": "https://github.com/souloss/astro-minimax#readme",
+  "bugs": {
+    "url": "https://github.com/souloss/astro-minimax/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/souloss/astro-minimax",
+    "directory": "packages/core"
+  },
+  "exports": {
+    "./layouts/*.astro": "./src/layouts/*.astro",
+    "./components/*.astro": "./src/components/*.astro",
+    "./styles/*.css": "./src/styles/*.css",
+    "./assets/icons/*.svg": "./src/assets/icons/*.svg",
+    "./utils/*": "./src/utils/*.ts",
+    "./plugins/*": "./src/plugins/*.ts",
+    "./scripts/*": "./src/scripts/*.ts",
+    "./types": "./src/types.ts"
+  },
+  "files": [
+    "src/"
+  ],
+  "peerDependencies": {
+    "astro": "^5.0.0",
+    "tailwindcss": "^4.0.0"
+  }
+}

package/src/assets/icons/IconArchive.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-archive"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 4m0 2a2 2 0 0 1 2 -2h14a2 2 0 0 1 2 2v0a2 2 0 0 1 -2 2h-14a2 2 0 0 1 -2 -2z" /><path d="M5 8v10a2 2 0 0 0 2 2h10a2 2 0 0 0 2 -2v-10" /><path d="M10 12l4 0" /></svg>

package/src/assets/icons/IconArrowLeft.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-arrow-left"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12l14 0" /><path d="M5 12l6 6" /><path d="M5 12l6 -6" /></svg>

package/src/assets/icons/IconArrowNarrowUp.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-arrow-narrow-up"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 5l0 14" /><path d="M16 9l-4 -4" /><path d="M8 9l4 -4" /></svg>

package/src/assets/icons/IconArrowRight.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-arrow-right"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12l14 0" /><path d="M13 18l6 -6" /><path d="M13 6l6 6" /></svg>

package/src/assets/icons/IconArticle.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-article"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 4m0 2a2 2 0 0 1 2 -2h14a2 2 0 0 1 2 2v12a2 2 0 0 1 -2 2h-14a2 2 0 0 1 -2 -2z" /><path d="M7 8h10" /><path d="M7 12h10" /><path d="M7 16h10" /></svg>

package/src/assets/icons/IconBrandX.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-brand-x"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M4 4l11.733 16h4.267l-11.733 -16z" /><path d="M4 20l6.768 -6.768m2.46 -2.46l6.772 -6.772" /></svg>

package/src/assets/icons/IconCalendar.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-calendar-week"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M4 7a2 2 0 0 1 2 -2h12a2 2 0 0 1 2 2v12a2 2 0 0 1 -2 2h-12a2 2 0 0 1 -2 -2v-12z" /><path d="M16 3v4" /><path d="M8 3v4" /><path d="M4 11h16" /><path d="M7 14h.013" /><path d="M10.01 14h.005" /><path d="M13.01 14h.005" /><path d="M16.015 14h.005" /><path d="M13.015 17h.005" /><path d="M7.01 17h.005" /><path d="M10.01 17h.005" /></svg>

package/src/assets/icons/IconChevronLeft.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-chevron-left"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M15 6l-6 6l6 6" /></svg>

package/src/assets/icons/IconChevronRight.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-chevron-right"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 6l6 6l-6 6" /></svg>

package/src/assets/icons/IconEdit.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-edit"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M7 7h-1a2 2 0 0 0 -2 2v9a2 2 0 0 0 2 2h9a2 2 0 0 0 2 -2v-1" /><path d="M20.385 6.585a2.1 2.1 0 0 0 -2.97 -2.97l-8.415 8.385v3h3l8.385 -8.415z" /><path d="M16 5l3 3" /></svg>

package/src/assets/icons/IconFacebook.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-brand-facebook"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M7 10v4h3v7h4v-7h3l1 -4h-4v-2a1 1 0 0 1 1 -1h3v-4h-3a5 5 0 0 0 -5 5v2h-3" /></svg>

package/src/assets/icons/IconGitHub.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-brand-github"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M9 19c-4.3 1.4 -4.3 -2.5 -6 -3m12 5v-3.5c0 -1 .1 -1.4 -.5 -2c2.8 -.3 5.5 -1.4 5.5 -6a4.6 4.6 0 0 0 -1.3 -3.2a4.2 4.2 0 0 0 -.1 -3.2s-1.1 -.3 -3.5 1.3a12.3 12.3 0 0 0 -6.2 0c-2.4 -1.6 -3.5 -1.3 -3.5 -1.3a4.2 4.2 0 0 0 -.1 3.2a4.6 4.6 0 0 0 -1.3 3.2c0 4.6 2.7 5.7 5.5 6c-.6 .6 -.6 1.2 -.5 2v3.5" /></svg>

package/src/assets/icons/IconHash.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-hash"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 9l14 0" /><path d="M5 15l14 0" /><path d="M11 4l-4 16" /><path d="M17 4l-4 16" /></svg>

package/src/assets/icons/IconHome.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-home"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 12l-2 0l9 -9l9 9l-2 0" /><path d="M5 12v7a2 2 0 0 0 2 2h10a2 2 0 0 0 2 -2v-7" /><path d="M9 21v-6a2 2 0 0 1 2 -2h2a2 2 0 0 1 2 2v6" /></svg>

package/src/assets/icons/IconLinkedin.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-brand-linkedin"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M8 11v5" /><path d="M8 8v.01" /><path d="M12 16v-5" /><path d="M16 16v-3a2 2 0 1 0 -4 0" /><path d="M3 7a4 4 0 0 1 4 -4h10a4 4 0 0 1 4 4v10a4 4 0 0 1 -4 4h-10a4 4 0 0 1 -4 -4z" /></svg>

package/src/assets/icons/IconMail.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-mail"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 7a2 2 0 0 1 2 -2h14a2 2 0 0 1 2 2v10a2 2 0 0 1 -2 2h-14a2 2 0 0 1 -2 -2v-10z" /><path d="M3 7l9 6l9 -6" /></svg>

package/src/assets/icons/IconMenuDeep.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-menu-deep"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M4 6h16" /><path d="M7 12h13" /><path d="M10 18h10" /></svg>

package/src/assets/icons/IconMoon.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-moon"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M12 3c.132 0 .263 0 .393 0a7.5 7.5 0 0 0 7.92 12.446a9 9 0 1 1 -8.313 -12.454z" /></svg>

package/src/assets/icons/IconPinterest.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-brand-pinterest"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M8 20l4 -9" /><path d="M10.7 14c.437 1.263 1.43 2 2.55 2c2.071 0 3.75 -1.554 3.75 -4a5 5 0 1 0 -9.7 1.7" /><path d="M12 12m-9 0a9 9 0 1 0 18 0a9 9 0 1 0 -18 0" /></svg>

package/src/assets/icons/IconProject.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-code"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><polyline points="7 8 3 12 7 16" /><polyline points="17 8 21 12 17 16" /><line x1="14" y1="4" x2="10" y2="20" /></svg>

package/src/assets/icons/IconRss.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-rss"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 19m-1 0a1 1 0 1 0 2 0a1 1 0 1 0 -2 0" /><path d="M4 4a16 16 0 0 1 16 16" /><path d="M4 11a9 9 0 0 1 9 9" /></svg>

package/src/assets/icons/IconSearch.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-search"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M10 10m-7 0a7 7 0 1 0 14 0a7 7 0 1 0 -14 0" /><path d="M21 21l-6 -6" /></svg>

package/src/assets/icons/IconSeries.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-books"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M5 4m0 1a1 1 0 0 1 1 -1h2a1 1 0 0 1 1 1v14a1 1 0 0 1 -1 1h-2a1 1 0 0 1 -1 -1z" /><path d="M9 4m0 1a1 1 0 0 1 1 -1h2a1 1 0 0 1 1 1v14a1 1 0 0 1 -1 1h-2a1 1 0 0 1 -1 -1z" /><path d="M5 8h4" /><path d="M9 16h4" /><path d="M13.803 4.56l2.184 -.56c.562 -.144 1.074 .245 1.144 .868l2.07 14.576c.07 .623 -.351 1.19 -.94 1.266l-2.184 .56c-.562 .144 -1.074 -.245 -1.144 -.868l-2.07 -14.576c-.07 -.623 .351 -1.19 .94 -1.266z" /><path d="M14 9.3l3.832 -.983" /></svg>

package/src/assets/icons/IconSunHigh.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-sun-high"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M14.828 14.828a4 4 0 1 0 -5.656 -5.656a4 4 0 0 0 5.656 5.656z" /><path d="M6.343 17.657l-1.414 1.414" /><path d="M6.343 6.343l-1.414 -1.414" /><path d="M17.657 6.343l1.414 -1.414" /><path d="M17.657 17.657l1.414 1.414" /><path d="M4 12h-2" /><path d="M12 4v-2" /><path d="M20 12h2" /><path d="M12 20v2" /></svg>

package/src/assets/icons/IconTag.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-tag"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M7.5 7.5m-1 0a1 1 0 1 0 2 0a1 1 0 1 0 -2 0" /><path d="M3 6v5.172a2 2 0 0 0 .586 1.414l7.71 7.71a2.41 2.41 0 0 0 3.408 0l5.592 -5.592a2.41 2.41 0 0 0 0 -3.408l-7.71 -7.71a2 2 0 0 0 -1.414 -.586h-5.172a3 3 0 0 0 -3 3z" /></svg>

package/src/assets/icons/IconTelegram.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-brand-telegram"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M15 10l-4 4l6 6l4 -16l-18 7l4 2l2 6l3 -4" /></svg>

package/src/assets/icons/IconUser.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="icon icon-tabler icons-tabler-outline icon-tabler-user"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M8 7a4 4 0 1 0 8 0a4 4 0 0 0 -8 0" /><path d="M6 21v-2a4 4 0 0 1 4 -4h4a4 4 0 0 1 4 4v2" /></svg>

package/src/assets/icons/IconWhatsapp.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-brand-whatsapp"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M3 21l1.65 -3.8a9 9 0 1 1 3.4 2.9l-5.05 .9" /><path d="M9 10a.5 .5 0 0 0 1 0v-1a.5 .5 0 0 0 -1 0v1a5 5 0 0 0 5 5h1a.5 .5 0 0 0 0 -1h-1a.5 .5 0 0 0 0 1" /></svg>

package/src/assets/icons/IconX.svg

@@ -0,0 +1 @@
+<svg  xmlns="http://www.w3.org/2000/svg"  width="24"  height="24"  viewBox="0 0 24 24"  fill="none"  stroke="currentColor"  stroke-width="2"  stroke-linecap="round"  stroke-linejoin="round"  class="icon icon-tabler icons-tabler-outline icon-tabler-x"><path stroke="none" d="M0 0h24v24H0z" fill="none"/><path d="M18 6l-12 12" /><path d="M6 6l12 12" /></svg>

package/src/components/ai/AIChatWidget.astro

@@ -0,0 +1,377 @@
+---
+import { SITE } from "@/config";
+
+interface Props {
+  lang?: string;
+}
+
+const { lang = "zh" } = Astro.props;
+const aiEnabled = SITE.ai?.enabled ?? false;
+const aiConfig = {
+  apiEndpoint: SITE.ai?.apiEndpoint || "",
+  apiKey: SITE.ai?.apiKey || "",
+  model: SITE.ai?.model || "gpt-4o-mini",
+  maxTokens: SITE.ai?.maxTokens || 1024,
+  systemPrompt: SITE.ai?.systemPrompt || "",
+  mockMode: SITE.ai?.mockMode ?? true,
+  vectorSearch: SITE.ai?.vectorSearch ?? false,
+};
+---
+
+{
+  aiEnabled && (
+    <div id="ai-chat-root" data-lang={lang}>
+      <div
+        id="ai-chat-panel"
+        class="fixed right-6 bottom-20 z-50 hidden w-[360px] max-w-[calc(100vw-2rem)] flex-col overflow-hidden rounded-2xl border border-border bg-background shadow-2xl"
+        style="height: min(520px, calc(100vh - 8rem)); bottom: 5rem;"
+      >
+        {/* Header */}
+        <div class="flex items-center justify-between border-b border-border px-4 py-3">
+          <div class="flex items-center gap-2">
+            <svg
+              class="size-5 text-accent"
+              viewBox="0 0 24 24"
+              fill="none"
+              stroke="currentColor"
+              stroke-width="2"
+              stroke-linecap="round"
+              stroke-linejoin="round"
+            >
+              <path d="M12 8V4H8" />
+              <rect width="16" height="12" x="4" y="8" rx="2" />
+              <path d="M2 14h2" />
+              <path d="M20 14h2" />
+              <path d="M15 13v2" />
+              <path d="M9 13v2" />
+            </svg>
+            <span class="text-sm font-semibold text-foreground">
+              AI Assistant
+            </span>
+            <span class:list={[
+              "rounded-full px-2 py-0.5 text-[10px] font-medium",
+              aiConfig.apiEndpoint ? "bg-green-500/15 text-green-600 dark:text-green-400" : "bg-accent/15 text-accent"
+            ]}>
+              {aiConfig.apiEndpoint ? "Live" : "Mock"}
+            </span>
+          </div>
+          <div class="flex items-center gap-1">
+            <button
+              id="ai-chat-clear"
+              class="text-foreground-soft rounded-md p-1.5 transition-colors hover:bg-muted/60 hover:text-foreground"
+              aria-label="Clear conversation"
+              title="Clear conversation"
+            >
+              <svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                <path d="M3 6h18" /><path d="M19 6v14c0 1-1 2-2 2H7c-1 0-2-1-2-2V6" /><path d="M8 6V4c0-1 1-2 2-2h4c1 0 2 1 2 2v2" />
+              </svg>
+            </button>
+            <button
+              id="ai-chat-close"
+              class="text-foreground-soft rounded-md p-1.5 transition-colors hover:bg-muted/60 hover:text-foreground"
+              aria-label="Close chat"
+              title="Close"
+            >
+              <svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                <path d="M18 6 6 18" /><path d="m6 6 12 12" />
+              </svg>
+            </button>
+          </div>
+        </div>
+
+        {/* Messages */}
+        <div id="ai-chat-messages" class="flex-1 space-y-3 overflow-y-auto px-4 py-3">
+          <div class="flex gap-2" data-role="assistant">
+            <div class="mt-0.5 flex size-6 shrink-0 items-center justify-center rounded-full bg-accent/15">
+              <svg class="size-3.5 text-accent" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                <path d="M12 8V4H8" /><rect width="16" height="12" x="4" y="8" rx="2" />
+                <path d="M2 14h2" /><path d="M20 14h2" /><path d="M15 13v2" /><path d="M9 13v2" />
+              </svg>
+            </div>
+            <div class="rounded-lg bg-muted/40 px-3 py-2 text-sm leading-relaxed text-foreground" id="ai-welcome-msg" />
+          </div>
+        </div>
+
+        {/* Input */}
+        <div class="border-t border-border px-3 py-3">
+          <form id="ai-chat-form" class="flex gap-2">
+            <input
+              id="ai-chat-input"
+              type="text"
+              placeholder=""
+              class="placeholder:text-foreground-soft flex-1 rounded-lg border border-border bg-background px-3 py-2 text-sm text-foreground focus:border-accent focus:ring-1 focus:ring-accent focus:outline-none"
+              autocomplete="off"
+            />
+            <button
+              type="submit"
+              id="ai-chat-send"
+              class="shrink-0 rounded-lg bg-accent px-3 py-2 text-sm font-medium text-background transition-colors hover:bg-accent/90 disabled:opacity-50"
+              disabled
+            >
+              <svg class="size-4" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                <path d="m22 2-7 20-4-9-9-4Z" /><path d="M22 2 11 13" />
+              </svg>
+            </button>
+          </form>
+        </div>
+      </div>
+    </div>
+
+    <script is:inline define:vars={{ aiConfig }}>
+    function initAIChat() {
+      const root = document.getElementById("ai-chat-root");
+      if (!root) return;
+
+      const lang = root.dataset.lang || "zh";
+      const toggle = document.getElementById("ai-chat-toggle-fab");
+      const panel = document.getElementById("ai-chat-panel");
+      const close = document.getElementById("ai-chat-close");
+      const clear = document.getElementById("ai-chat-clear");
+      const form = document.getElementById("ai-chat-form");
+      const input = document.getElementById("ai-chat-input");
+      const send = document.getElementById("ai-chat-send");
+      const messages = document.getElementById("ai-chat-messages");
+      const welcomeMsg = document.getElementById("ai-welcome-msg");
+
+      if (!toggle || !panel || !close || !clear || !form || !input || !send || !messages || !welcomeMsg) return;
+
+      const i18n = {
+        zh: {
+          welcome: "你好！我是 AI 助手，可以帮你了解这个博客的内容。试试问我关于文章、技术或任何你感兴趣的话题吧！",
+          placeholder: "输入你的问题...",
+          thinking: "正在思考...",
+        },
+        en: {
+          welcome: "Hi! I'm the AI assistant. I can help you explore the blog content. Try asking me about articles, tech topics, or anything you're curious about!",
+          placeholder: "Type your question...",
+          thinking: "Thinking...",
+        },
+      };
+
+      const t = lang === "zh" ? i18n.zh : i18n.en;
+      welcomeMsg.textContent = t.welcome;
+      input.placeholder = t.placeholder;
+
+      let isOpen = false;
+      let isStreaming = false;
+      const chatHistory = [];
+
+      toggle.addEventListener("click", () => {
+        isOpen = !isOpen;
+        panel.classList.toggle("hidden", !isOpen);
+        panel.classList.toggle("flex", isOpen);
+        if (isOpen) input.focus();
+      });
+
+      close.addEventListener("click", () => {
+        isOpen = false;
+        panel.classList.add("hidden");
+        panel.classList.remove("flex");
+      });
+
+      clear.addEventListener("click", () => {
+        const welcome = messages.querySelector("[data-role='assistant']");
+        messages.innerHTML = "";
+        if (welcome) messages.appendChild(welcome);
+        chatHistory.length = 0;
+      });
+
+      input.addEventListener("input", () => {
+        send.disabled = !input.value.trim() || isStreaming;
+      });
+
+      form.addEventListener("submit", async (e) => {
+        e.preventDefault();
+        const question = input.value.trim();
+        if (!question || isStreaming) return;
+
+        appendMessage("user", question);
+        chatHistory.push({ role: "user", content: question });
+        input.value = "";
+        send.disabled = true;
+        isStreaming = true;
+
+        const useMock = aiConfig.mockMode || !aiConfig.apiEndpoint;
+
+        if (useMock) {
+          await streamMockResponse(question, lang);
+        } else {
+          await streamRealResponse(question, lang);
+        }
+
+        isStreaming = false;
+        send.disabled = !input.value.trim();
+      });
+
+      function appendMessage(role, content) {
+        const wrapper = document.createElement("div");
+        wrapper.className = "flex gap-2" + (role === "user" ? " justify-end" : "");
+        wrapper.dataset.role = role;
+
+        if (role === "user") {
+          wrapper.innerHTML = '<div class="rounded-lg bg-accent px-3 py-2 text-sm text-background leading-relaxed max-w-[85%]">' + escapeHtml(content) + '</div>';
+        } else {
+          wrapper.innerHTML =
+            '<div class="shrink-0 mt-0.5 flex size-6 items-center justify-center rounded-full bg-accent/15">' +
+            '<svg class="size-3.5 text-accent" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 8V4H8"></path><rect width="16" height="12" x="4" y="8" rx="2"></rect><path d="M2 14h2"></path><path d="M20 14h2"></path><path d="M15 13v2"></path><path d="M9 13v2"></path></svg>' +
+            '</div>' +
+            '<div class="rounded-lg bg-muted/40 px-3 py-2 text-sm text-foreground leading-relaxed max-w-[85%]">' + content + '</div>';
+        }
+
+        messages.appendChild(wrapper);
+        messages.scrollTop = messages.scrollHeight;
+        return wrapper;
+      }
+
+      // ===== Real API streaming via SSE =====
+      async function streamRealResponse(_question, lang) {
+        const msgEl = appendMessage("assistant", "");
+        const textEl = msgEl.querySelector(".rounded-lg.bg-muted\\/40");
+        if (!textEl) return;
+
+        textEl.innerHTML = '<span class="inline-flex gap-1 text-foreground-soft"><span class="animate-pulse">●</span><span class="animate-pulse" style="animation-delay:0.2s">●</span><span class="animate-pulse" style="animation-delay:0.4s">●</span></span>';
+
+        try {
+          const systemMessages = [
+            { role: "system", content: aiConfig.systemPrompt || "You are a helpful blog assistant." }
+          ];
+
+          const recentHistory = chatHistory.slice(-10);
+
+          const requestBody = {
+            model: aiConfig.model,
+            messages: [...systemMessages, ...recentHistory],
+            max_tokens: aiConfig.maxTokens,
+            stream: true,
+          };
+
+          const headers = {
+            "Content-Type": "application/json",
+          };
+
+          if (aiConfig.apiKey) {
+            headers["Authorization"] = "Bearer " + aiConfig.apiKey;
+          }
+
+          const response = await fetch(aiConfig.apiEndpoint, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(requestBody),
+          });
+
+          if (!response.ok) {
+
+
+            textEl.textContent = (lang === "zh" ? "API 错误: " : "API Error: ") + response.status;
+            chatHistory.push({ role: "assistant", content: textEl.textContent });
+            return;
+          }
+
+          const reader = response.body.getReader();
+          const decoder = new TextDecoder();
+          let fullText = "";
+          let buffer = "";
+
+          while (true) {
+            const { done, value } = await reader.read();
+            if (done) break;
+
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split("\n");
+            buffer = lines.pop() || "";
+
+            for (const line of lines) {
+              const trimmed = line.trim();
+              if (!trimmed || !trimmed.startsWith("data: ")) continue;
+              const data = trimmed.slice(6);
+              if (data === "[DONE]") break;
+
+              try {
+                const parsed = JSON.parse(data);
+                const delta = parsed.choices?.[0]?.delta?.content;
+                if (delta) {
+                  fullText += delta;
+                  textEl.textContent = fullText;
+                  messages.scrollTop = messages.scrollHeight;
+                }
+              } catch {
+                // skip malformed JSON chunks
+              }
+            }
+          }
+
+          if (!fullText) {
+            textEl.textContent = lang === "zh" ? "未收到回复" : "No response received";
+          }
+
+          chatHistory.push({ role: "assistant", content: fullText || textEl.textContent });
+
+        } catch (err) {
+          textEl.textContent = (lang === "zh" ? "连接失败: " : "Connection failed: ") + (err.message || err);
+          chatHistory.push({ role: "assistant", content: textEl.textContent });
+        }
+      }
+
+      // ===== Mock streaming =====
+      async function streamMockResponse(question, lang) {
+        const response = getMockResponse(question, lang);
+        const msgEl = appendMessage("assistant", "");
+        const textEl = msgEl.querySelector(".rounded-lg.bg-muted\\/40");
+        if (!textEl) return;
+
+        textEl.innerHTML = '<span class="inline-flex gap-1 text-foreground-soft"><span class="animate-pulse">●</span><span class="animate-pulse" style="animation-delay:0.2s">●</span><span class="animate-pulse" style="animation-delay:0.4s">●</span></span>';
+
+        await sleep(600);
+
+        let displayed = "";
+        for (let i = 0; i < response.length; i++) {
+          displayed += response[i];
+          textEl.textContent = displayed;
+          messages.scrollTop = messages.scrollHeight;
+          await sleep(15 + Math.random() * 25);
+        }
+
+        chatHistory.push({ role: "assistant", content: response });
+      }
+
+      function getMockResponse(question, lang) {
+        const q = question.toLowerCase();
+        const isZh = lang === "zh";
+
+        if (q.includes("astro") || q.includes("框架")) {
+          return isZh
+            ? "Astro 是一个现代化的静态站点生成器，特别适合内容驱动的网站。它的核心优势是「岛屿架构」——默认零 JavaScript，只在需要交互的组件上加载 JS。本博客就是基于 Astro 构建的，使用了 Tailwind CSS 进行样式处理，支持 MDX、代码高亮、数学公式等丰富功能。"
+            : "Astro is a modern static site generator perfect for content-driven websites. Its core feature is the 'Islands Architecture' — zero JavaScript by default, loading JS only for interactive components. This blog is built with Astro, using Tailwind CSS for styling, with support for MDX, code highlighting, math equations, and more.";
+        }
+
+        if (q.includes("博客") || q.includes("blog") || q.includes("文章") || q.includes("post")) {
+          return isZh
+            ? "这个博客使用 astro-minimax 主题，支持多种功能：Markdown/MDX 文章、代码语法高亮、数学公式(KaTeX)、Mermaid 图表、标签分类系统、全文搜索(Pagefind)、评论系统(Waline)、深色模式等。文章按中文和英文分别存放在不同目录中。"
+            : "This blog uses the astro-minimax theme with many features: Markdown/MDX posts, syntax highlighting, math equations (KaTeX), Mermaid diagrams, tag/category system, full-text search (Pagefind), comments (Waline), dark mode, and more. Articles are organized in separate directories for Chinese and English.";
+        }
+
+        if (q.includes("主题") || q.includes("theme") || q.includes("暗色") || q.includes("dark")) {
+          return isZh
+            ? "本博客支持亮色和暗色两种主题模式，可以通过右下角的主题切换按钮自由切换。主题颜色方案可以在配置文件中自定义，支持多种预定义配色方案。系统会自动检测你的系统偏好设置。"
+            : "This blog supports both light and dark theme modes, switchable via the theme toggle button in the bottom right. Color schemes can be customized in the config file with multiple predefined options. The system automatically detects your OS preference.";
+        }
+
+        return isZh
+          ? "感谢你的提问！作为 AI 助手，我目前运行在 Mock 模式下，能回答关于本博客技术栈、功能特性等基本问题。如需更详细的回答，站长可以配置真实的 AI API 来获得更智能的对话体验。你可以尝试问我关于 Astro、博客功能、主题配置等话题。"
+          : "Thanks for your question! I'm currently running in mock mode and can answer basic questions about this blog's tech stack and features. For more detailed answers, the site admin can configure a real AI API for a smarter conversation experience. Try asking about Astro, blog features, or theme configuration.";
+      }
+
+      function escapeHtml(str) {
+        return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+      }
+
+      function sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+      }
+    }
+
+    initAIChat();
+    document.addEventListener("astro:after-swap", initAIChat);
+    </script>
+  )
+}