@astro-minimax/cli 0.7.5 → 0.8.0

package/README.md

@@ -20,10 +20,10 @@ yarn dlx @astro-minimax/cli my-blog
 ```
 my-blog/
 ├── astro.config.ts      # Astro + minimax integration config
-├── package.json         # Dependencies (core, viz, tailwind, etc.)
+├── package.json         # Dependencies (core, tailwind, etc.)
 ├── tsconfig.json        # TypeScript configuration
 ├── public/
-│   └── favicon.svg
+│   └── favicon.ico
 └── src/
     ├── config.ts        # SITE configuration object
     ├── constants.ts     # Social links and share links

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astro-minimax/cli",
-  "version": "0.7.5",
+  "version": "0.8.0",
   "type": "module",
   "description": "CLI tool for astro-minimax blog — create blogs, manage content, and process data with AI.",
   "author": "Souloss",

package/template/astro.config.ts

@@ -1,7 +1,6 @@
 import { defineConfig, envField } from "astro/config";
 import tailwindcss from "@tailwindcss/vite";
 import minimax from "@astro-minimax/core";
-import minimaxViz from "@astro-minimax/viz";
 import sitemap from "@astrojs/sitemap";
 import mdx from "@astrojs/mdx";
 import preact from "@astrojs/preact";
@@ -31,6 +30,7 @@ import { SITE } from "./src/config";
 import { SOCIALS, SHARE_LINKS } from "./src/constants";
 import { FRIENDS } from "./src/data/friends";
 
+// Shiki transformers require type casting since they use a different type system
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const asTransformer = (t: any) => t;
 
@@ -59,9 +59,11 @@ export default defineConfig({
       shareLinks: SHARE_LINKS,
       friends: FRIENDS,
       blogPath: "src/data/blog",
+      viz: { mermaid: true, markmap: true },
+    }),
+    preact({
+      compat: true,
     }),
-    minimaxViz({ mermaid: true, markmap: true }),
-    preact({ compat: true }),
     sitemap({
       filter: page => SITE.showArchives || !page.endsWith("/archives"),
     }),
@@ -97,10 +99,13 @@ export default defineConfig({
     },
   },
   vite: {
-    plugins: [tailwindcss() as never],
+    plugins: [
+      tailwindcss() as never,
+    ],
     server: {
       fs: {
-        strict: false,
+        strict: true,
+        allow: ["./src", "./.astro"],
       },
       proxy: {
         "/api": {
@@ -108,18 +113,35 @@ export default defineConfig({
           changeOrigin: true,
         },
       },
+      warmup: {
+        clientFiles: [
+          "./src/components/**/*.astro",
+          "./src/layouts/**/*.astro",
+        ],
+      },
     },
     resolve: {
       alias: {
-        "@/": new URL("./src/", import.meta.url).pathname,
+        "@/" : new URL("./src/", import.meta.url).pathname,
         "react": "preact/compat",
         "react-dom": "preact/compat",
         "react/jsx-runtime": "preact/jsx-runtime",
       },
       dedupe: ["preact", "preact/hooks", "preact/compat", "preact/debug", "preact/devtools", "react", "react-dom"],
     },
+    // Pre-bundle dependencies to speed up development and ensure consistency.
+    //
+    // WHY: By explicitly including these packages in optimizeDeps, Vite pre-bundles
+    // them on startup. This prevents lazy-loading race conditions where modules
+    // might load from different copies during dev. Particularly important for
+    // @ai-sdk/react which uses hooks that must resolve consistently.
+    //
+    // NOTE: Local workspace packages (@astro-minimax/*) are excluded from optimization
+    // because they're linked via workspace protocol and should be loaded fresh on changes.
+    // Excluding them also ensures JSX transformation uses Preact's jsx-runtime correctly.
     optimizeDeps: {
-      exclude: ["@resvg/resvg-js"],
+      noDiscovery: true,
+      exclude: ["@resvg/resvg-js", "@astro-minimax/ai", "@astro-minimax/core"],
       include: [
         "preact",
         "preact/hooks",
@@ -130,9 +152,9 @@ export default defineConfig({
         "preact/jsx-dev-runtime",
         "@ai-sdk/react",
         "ai",
-        "@astro-minimax/ai",
-        "@astro-minimax/core",
-        "@astro-minimax/viz",
+        "mermaid",
+        "markmap-lib",
+        "katex",
       ],
     },
     ssr: {
@@ -140,7 +162,6 @@ export default defineConfig({
       noExternal: [
         "@astro-minimax/ai",
         "@astro-minimax/core",
-        "@astro-minimax/viz",
         "@ai-sdk/react",
         "ai",
       ],

package/template/functions/api/chat.ts

@@ -7,8 +7,11 @@ import voiceProfile from '../../datas/voice-profile.json';
 import factRegistry from '../../datas/fact-registry.json';
 
 // Optional: TF-IDF vector index for enhanced search reranking
+// The vector index is created by `astro-minimax ai process` command
+// Using dynamic import in try/catch since the file may not exist yet
 let vectorIndex: unknown = null;
-try { vectorIndex = (await import('../../src/data/vectors/index.json')).default; } catch { /* not available */ }
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+try { vectorIndex = (await import('../../src/data/vectors/index.json' as any)).default; } catch { /* not available */ }
 
 interface FunctionEnv extends ChatHandlerEnv {
   CACHE_KV?: KVNamespace;
@@ -24,5 +27,6 @@ export const onRequest: PagesFunction<FunctionEnv> = async (context) => {
   return handleChatRequest({ 
     env: context.env, 
     request: context.request,
+    waitUntil: context.waitUntil,
   });
 };

package/template/package.json

@@ -6,7 +6,7 @@
     "dev": "concurrently -n \"astro,ai\" -c \"blue,green\" \"astro dev\" \"pnpm exec astro-ai-dev\"",
     "dev:astro": "astro dev",
     "dev:ai": "pnpm exec astro-ai-dev",
-    "build": "astro check && astro build && pagefind --site dist && cp -r dist/pagefind public/",
+    "build": "astro check && astro build && pagefind --site dist",
     "preview": "wrangler pages dev dist",
     "preview:astro": "astro preview",
     "lint": "eslint .",
@@ -28,38 +28,37 @@
   "dependencies": {
     "@ai-sdk/openai-compatible": "^2.0.35",
     "@ai-sdk/react": "^3.0.118",
-    "@astro-minimax/ai": "^0.7.5",
-    "@astro-minimax/core": "^0.7.5",
-    "@astro-minimax/notify": "^0.7.5",
-    "@astro-minimax/viz": "^0.7.5",
+    "@astro-minimax/ai": "^0.8.0",
+    "@astro-minimax/core": "^0.8.0",
+    "@astro-minimax/notify": "^0.8.0",
     "@astrojs/mdx": "^5.0.0",
     "@astrojs/preact": "^5.0.0",
     "@astrojs/rss": "^4.0.17",
     "@astrojs/sitemap": "^3.7.1",
     "@fontsource/ibm-plex-mono": "^5.2.7",
-    "@resvg/resvg-js": "^2.6.0",
+    "@resvg/resvg-js": "^2.6.2",
     "@shikijs/rehype": "^4.0.2",
-    "@tailwindcss/typography": "^0.5.19",
     "@tailwindcss/vite": "^4.2.1",
     "ai": "^6.0.116",
     "astro": "^6.0.0",
     "dayjs": "^1.11.19",
     "lodash.kebabcase": "^4.1.1",
+    "markmap-lib": "^0.18.11",
     "mermaid": "^11.12.3",
     "preact": "^10.29.0",
+    "qrcode": "^1.5.4",
     "rehype-katex": "^7.0.1",
     "remark-emoji": "^5.0.2",
     "remark-github-alerts": "^0.1.1",
-    "remark-markmap": "^1.1.5",
     "remark-math": "^6.0.0",
-    "satori": "^0.18.0",
+    "satori": "^0.25.0",
     "sharp": "^0.34.5",
     "slugify": "^1.6.6",
     "tailwindcss": "^4.2.1"
   },
   "devDependencies": {
-    "@astro-minimax/cli": "^0.7.5",
-    "@astrojs/check": "^0.9.6",
+    "@astro-minimax/cli": "^0.8.0",
+    "@astrojs/check": "^0.9.7",
     "@cloudflare/workers-types": "^4.20260313.1",
     "@pagefind/default-ui": "^1.4.0",
     "@shikijs/transformers": "^4.0.2",

package/template/src/config.ts

@@ -23,12 +23,12 @@ export const SITE: SiteConfig = {
     series: true,
     archives: true,
     search: true,
-    darkMode: true,
     friends: false,
     projects: false,
-    ai: false,
   },
 
+  darkMode: true,
+
   nav: {
     items: [
       { key: "home", enabled: true },
@@ -109,15 +109,7 @@ export const SITE: SiteConfig = {
     apiEndpoint: "/api/chat",
   },
 
-  get lightAndDarkMode() {
-    return this.features?.darkMode;
-  },
-
   get showArchives() {
     return this.features?.archives ?? true;
   },
-
-  get aiEnabled() {
-    return (this.features?.ai ?? false) && (this.ai?.enabled ?? false);
-  },
-};
+};

package/template/src/data/blog/zh/alerts-examples.md

@@ -4,6 +4,7 @@ description: "展示 GitHub 风格的提示框功能，支持多种类型"
 pubDatetime: 2024-01-06T00:00:00.000Z
 tags:
   - 教程
+category: 教程/功能
 ---
 
 ## 什么是 GitHub Alerts?

package/template/src/data/blog/zh/code-examples.md

@@ -5,6 +5,7 @@ pubDatetime: 2024-01-05T00:00:00.000Z
 tags:
   - 教程
   - 代码
+category: 教程/功能
 ---
 
 ## 基础代码块

package/template/src/data/blog/zh/hello-world.md

@@ -4,6 +4,7 @@ description: "这是我的第一篇博客文章，由 astro-minimax 主题驱动
 pubDatetime: 2026-01-01T00:00:00.000Z
 tags:
   - 入门
+category: 教程/入门
 ---
 
 ## 欢迎来到我的博客

package/template/src/data/blog/zh/markmap-examples.md

@@ -5,6 +5,7 @@ pubDatetime: 2024-01-03T00:00:00.000Z
 tags:
   - 教程
   - Markmap
+category: 教程/工具
 ---
 
 ## 什么是 Markmap?

package/template/src/data/blog/zh/math-examples.md

@@ -5,6 +5,7 @@ pubDatetime: 2024-01-04T00:00:00.000Z
 tags:
   - 教程
   - 数学
+category: 教程/功能
 ---
 
 ## 行内公式

package/template/src/data/blog/zh/mermaid-examples.md

@@ -5,6 +5,7 @@ pubDatetime: 2024-01-02T00:00:00.000Z
 tags:
   - 教程
   - Mermaid
+category: 教程/工具
 ---
 
 ## 流程图

package/template/tsconfig.json

@@ -6,6 +6,9 @@
     "baseUrl": ".",
     "paths": {
       "@/*": ["./src/*"]
-    }
+    },
+    "jsx": "react-jsx",
+    "jsxImportSource": "preact",
+    "types": ["@cloudflare/workers-types"]
   }
 }