@astro-minimax/cli 0.7.5 → 0.8.1

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.1",
   "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,23 @@ 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
+// Lazy-loaded on first request to avoid top-level await issues with Cloudflare Pages
 let vectorIndex: unknown = null;
-try { vectorIndex = (await import('../../src/data/vectors/index.json')).default; } catch { /* not available */ }
+let vectorIndexLoaded = false;
+
+async function loadVectorIndex(): Promise<unknown> {
+  if (vectorIndexLoaded) return vectorIndex;
+  vectorIndexLoaded = true;
+  try {
+    // Dynamic import for optional file that may not exist
+    const module = await import('../../src/data/vectors/index.json');
+    vectorIndex = module.default;
+  } catch {
+    // File not available, keep vectorIndex as null
+  }
+  return vectorIndex;
+}
 
 interface FunctionEnv extends ChatHandlerEnv {
   CACHE_KV?: KVNamespace;
@@ -17,6 +32,8 @@ interface FunctionEnv extends ChatHandlerEnv {
 }
 
 export const onRequest: PagesFunction<FunctionEnv> = async (context) => {
+  await loadVectorIndex();
+  
   initializeMetadata(
     { summaries: aiSummaries, authorContext, voiceProfile, factRegistry, vectorIndex },
     context.env,
@@ -24,5 +41,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.1",
+    "@astro-minimax/core": "^0.8.1",
+    "@astro-minimax/notify": "^0.8.1",
     "@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.1",
+    "@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/en/alerts-examples.md

@@ -0,0 +1,64 @@
+---
+title: "GitHub Alerts Examples"
+description: "Demonstrate GitHub-style alert boxes with multiple types"
+pubDatetime: 2024-01-06T00:00:00.000Z
+author: "Your Name"
+tags:
+  - tutorial
+category: Tutorial/Features
+---
+
+## What are GitHub Alerts?
+
+GitHub Alerts are GitHub-style alert boxes that can be used to emphasize important information, warnings, or tips.
+
+## Basic Usage
+
+> [!NOTE]
+> This is a regular note for supplementary information.
+
+> [!TIP]
+> This is a tip that can help users use certain features better.
+
+> [!IMPORTANT]
+> This is important information that users should pay special attention to.
+
+> [!WARNING]
+> This is a warning to alert users about potential risks.
+
+> [!CAUTION]
+> This is a danger warning for irreversible operations.
+
+## With Formatting
+
+> [!NOTE]
+> Notes can contain **bold**, *italic*, and `code`.
+
+> [!TIP]
+> Tips can also include lists:
+> - Item 1
+> - Item 2
+> - Item 3
+
+> [!WARNING]
+> Warnings support code blocks:
+> ```bash
+> rm -rf /  # Never run this!
+> ```
+
+## Use Cases
+
+### For Documentation
+
+> [!TIP]
+> Use alerts to highlight key points in your documentation.
+
+### For Tutorials
+
+> [!IMPORTANT]
+> Make sure to save your work before proceeding.
+
+### For API Docs
+
+> [!WARNING]
+> This endpoint is deprecated and will be removed in v2.0.

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

@@ -0,0 +1,99 @@
+---
+title: "Code Highlighting Examples"
+description: "Demonstrate Shiki code highlighting with multiple programming languages and advanced features"
+pubDatetime: 2024-01-05T00:00:00.000Z
+author: "Your Name"
+tags:
+  - tutorial
+  - code
+category: Tutorial/Features
+---
+
+## Basic Code Blocks
+
+### TypeScript
+
+```typescript
+interface User {
+  id: number;
+  name: string;
+  email: string;
+}
+
+async function fetchUser(id: number): Promise<User> {
+  const response = await fetch(`/api/users/${id}`);
+  if (!response.ok) {
+    throw new Error('Failed to fetch user');
+  }
+  return response.json();
+}
+
+// Usage
+const user = await fetchUser(1);
+console.log(user.name);
+```
+
+### Python
+
+```python
+from dataclasses import dataclass
+from typing import Optional
+
+@dataclass
+class User:
+    id: int
+    name: str
+    email: Optional[str] = None
+
+def fetch_user(user_id: int) -> User:
+    """Fetch a user by ID."""
+    # Simulate API call
+    return User(id=user_id, name="John Doe", email="john@example.com")
+
+# Usage
+user = fetch_user(1)
+print(f"User: {user.name}")
+```
+
+## Advanced Features
+
+### Line Numbers
+
+```typescript showLineNumbers
+function fibonacci(n: number): number {
+  if (n <= 1) return n;
+  return fibonacci(n - 1) + fibonacci(n - 2);
+}
+
+// Calculate first 10 Fibonacci numbers
+for (let i = 0; i < 10; i++) {
+  console.log(fibonacci(i));
+}
+```
+
+### Highlight Lines
+
+```typescript {2,5-7}
+function processData(data: unknown) {
+  if (!data) throw new Error('No data provided');  // Highlighted
+  
+  return {
+    success: true,    // Highlighted
+    data: data,       // Highlighted
+    timestamp: Date.now()  // Highlighted
+  };
+}
+```
+
+### Diff Highlighting
+
+```diff
+function calculateTotal(items: Item[]) {
+-  return items.reduce((sum, item) => sum + item.price, 0);
++  const subtotal = items.reduce((sum, item) => sum + item.price, 0);
++  const tax = subtotal * 0.1;
++  return subtotal + tax;
+}
+```
+
+For more code highlighting options, see the [Shiki documentation](https://shiki.style/).

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

@@ -0,0 +1,78 @@
+---
+title: "Hello, World"
+description: "This is my first blog post, powered by the astro-minimax theme."
+pubDatetime: 2026-01-01T00:00:00.000Z
+author: "Your Name"
+# draft: false       # Optional: Set true to hide from production
+# featured: false    # Optional: Set true to feature on homepage
+tags:
+  - getting-started
+category: Tutorial/Getting Started
+# series:            # Optional: Article series configuration
+#   name: "Getting Started Series"
+#   order: 1
+---
+
+## Welcome to My Blog
+
+This is the first post created using the [astro-minimax](https://github.com/souloss/astro-minimax) theme.
+
+### Start Writing
+
+Create `.md` or `.mdx` files in the `src/data/blog/en/` directory to publish new articles.
+
+Each article requires the following frontmatter:
+
+```yaml
+---
+title: "Article Title"
+description: "Article description"
+pubDatetime: 2026-01-01T00:00:00.000Z
+author: "Author Name"
+tags:
+  - tag-name
+category: Category/Subcategory
+---
+```
+
+### Optional Fields
+
+```yaml
+# draft: false         # Set true to hide the article
+# featured: false      # Set true to feature on homepage
+# modDatetime: ...     # Last modified time
+# series:              # Article series configuration
+#   name: "Series Name"
+#   order: 1
+```
+
+### Customize the Theme
+
+Edit `src/config.ts` to customize your blog:
+
+```typescript
+SITE: {
+  title: "My Blog",
+  author: "Your Name",
+  desc: "Blog description",
+  // Feature toggles
+  features: {
+    tags: true,       // Tags page
+    categories: true, // Categories page
+    series: true,     // Series page
+    archives: true,   // Archives page
+    search: true,     // Search page
+  },
+  darkMode: true,     // Dark mode
+}
+```
+
+### Built-in Features
+
+- ✅ **Markdown Extensions** - Math formulas, code highlighting, GitHub Alerts
+- ✅ **Visualization** - Mermaid diagrams, Markmap mind maps
+- ✅ **SEO Optimization** - Auto-generated sitemap, RSS, Open Graph
+- ✅ **Multi-language** - Chinese and English support
+- ✅ **Dark Mode** - Auto-follow system or manual toggle
+
+Happy writing!

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

@@ -0,0 +1,100 @@
+---
+title: "Markmap Mind Map Examples"
+description: "Demonstrate Markmap interactive mind map functionality"
+pubDatetime: 2024-01-03T00:00:00.000Z
+author: "Your Name"
+tags:
+  - tutorial
+  - Markmap
+category: Tutorial/Tools
+---
+
+## What is Markmap?
+
+Markmap is a tool that converts Markdown into interactive mind maps, perfect for presenting hierarchical content.
+
+## Basic Usage
+
+```markmap
+# Central Topic
+
+## Branch 1
+### Sub-branch 1-1
+### Sub-branch 1-2
+#### Deeper level
+
+## Branch 2
+### Sub-branch 2-1
+### Sub-branch 2-2
+
+## Branch 3
+### Sub-branch 3-1
+```
+
+## Learning Path Example
+
+```markmap
+# Web Development Learning Path
+
+## Frontend
+### HTML & CSS
+#### Semantic HTML
+#### Flexbox & Grid
+### JavaScript
+#### ES6+ Features
+#### DOM Manipulation
+### Frameworks
+#### Vue.js
+#### React
+#### Angular
+
+## Backend
+### Node.js
+#### Express
+#### NestJS
+### Python
+#### Django
+#### FastAPI
+### Databases
+#### SQL
+#### MongoDB
+
+## DevOps
+### Version Control
+#### Git
+### CI/CD
+#### GitHub Actions
+### Cloud
+#### AWS
+#### Vercel
+```
+
+## Project Architecture
+
+```markmap
+# Project Structure
+
+## Source Code
+### Components
+#### UI Components
+#### Layout Components
+### Pages
+#### Home
+#### About
+### Services
+#### API Service
+#### Auth Service
+
+## Configuration
+### TypeScript
+### ESLint
+### Vite
+
+## Tests
+### Unit Tests
+### E2E Tests
+```
+
+Click on any node to expand or collapse. This interactivity makes mind maps excellent for documentation and presentations.
+
+For more information, visit [Markmap on GitHub](https://github.com/markmap/markmap).

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

@@ -0,0 +1,58 @@
+---
+title: "Math Formula Examples"
+description: "Demonstrate KaTeX math formula rendering with inline and block formulas"
+pubDatetime: 2024-01-04T00:00:00.000Z
+author: "Your Name"
+tags:
+  - tutorial
+  - math
+category: Tutorial/Features
+---
+
+## Inline Formulas
+
+A simple inline formula: $E = mc^2$, Einstein's mass-energy equation.
+
+Pythagorean theorem: The sum of squares of two right-angle sides equals the square of the hypotenuse, i.e., $a^2 + b^2 = c^2$.
+
+## Block Formulas
+
+### Quadratic Formula
+
+$$x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$$
+
+### Euler's Formula
+
+$$e^{i\pi} + 1 = 0$$
+
+### Gaussian Integral
+
+$$\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}$$
+
+## Complex Examples
+
+### Matrix
+
+$$
+A = \begin{pmatrix}
+a & b \\
+c & d
+\end{pmatrix}
+$$
+
+### Maxwell's Equations
+
+$$
+\begin{aligned}
+\nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\
+\nabla \cdot \mathbf{B} &= 0 \\
+\nabla \times \mathbf{E} &= -\frac{\partial \mathbf{B}}{\partial t} \\
+\nabla \times \mathbf{B} &= \mu_0 \mathbf{J} + \mu_0 \varepsilon_0 \frac{\partial \mathbf{E}}{\partial t}
+\end{aligned}
+$$
+
+### Schrödinger Equation
+
+$$i\hbar \frac{\partial}{\partial t} \Psi(\mathbf{r}, t) = \hat{H} \Psi(\mathbf{r}, t)$$
+
+For more KaTeX syntax, see the [KaTeX Documentation](https://katex.org/).