aico-cli 2.1.7 → 2.1.23

package/templates/skills/vitepress/references/core-cli.md

@@ -0,0 +1,119 @@
+---
+name: vitepress-cli
+description: Command-line interface for development, building, and previewing VitePress sites
+---
+
+# CLI Commands
+
+VitePress provides four main commands: `dev`, `build`, `preview`, and `init`.
+
+## Development Server
+
+Start the dev server with hot module replacement:
+
+```bash
+# In current directory (dev command is optional)
+vitepress
+
+# Or explicitly
+vitepress dev
+
+# With project in subdirectory
+vitepress dev docs
+```
+
+**Options:**
+
+| Option | Description |
+|--------|-------------|
+| `--open [path]` | Open browser on startup |
+| `--port <port>` | Specify port number |
+| `--base <path>` | Override base URL |
+| `--cors` | Enable CORS |
+| `--strictPort` | Exit if port is in use |
+| `--force` | Ignore cache and re-bundle |
+
+```bash
+vitepress dev docs --port 3000 --open
+```
+
+## Production Build
+
+Build static files for production:
+
+```bash
+vitepress build docs
+```
+
+**Options:**
+
+| Option | Description |
+|--------|-------------|
+| `--base <path>` | Override base URL |
+| `--target <target>` | Transpile target (default: `modules`) |
+| `--outDir <dir>` | Output directory (relative to cwd) |
+| `--assetsInlineLimit <n>` | Asset inline threshold in bytes |
+| `--mpa` | Build in MPA mode (no client hydration) |
+
+```bash
+vitepress build docs --outDir dist
+```
+
+## Preview Production Build
+
+Locally preview the production build:
+
+```bash
+vitepress preview docs
+```
+
+**Options:**
+
+| Option | Description |
+|--------|-------------|
+| `--port <port>` | Specify port number |
+| `--base <path>` | Override base URL |
+
+```bash
+vitepress preview docs --port 4173
+```
+
+## Initialize Project
+
+Start the setup wizard:
+
+```bash
+vitepress init
+```
+
+This creates the basic file structure:
+- `.vitepress/config.js` - Configuration
+- `index.md` - Home page
+- Optional example pages
+
+## Package.json Scripts
+
+Typical scripts configuration:
+
+```json
+{
+  "scripts": {
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs"
+  }
+}
+```
+
+## Key Points
+
+- Dev server runs at `http://localhost:5173` by default
+- Preview server runs at `http://localhost:4173`
+- Production output goes to `.vitepress/dist` by default
+- The `docs` argument specifies the project root directory
+- Use `--base` to override base path without modifying config
+
+<!--
+Source references:
+- https://vitepress.dev/reference/cli
+-->

package/templates/skills/vitepress/references/core-config.md

@@ -0,0 +1,189 @@
+---
+name: vitepress-configuration
+description: Config file setup, defineConfig helper, site metadata, and build options
+---
+
+# Configuration
+
+VitePress configuration is defined in `.vitepress/config.[js|ts|mjs|mts]`. Use `defineConfig` for TypeScript intellisense.
+
+## Basic Config
+
+```ts
+// .vitepress/config.ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+  // Site metadata
+  title: 'My Docs',
+  description: 'Documentation site',
+  lang: 'en-US',
+  
+  // URL base path (for GitHub Pages: '/repo-name/')
+  base: '/',
+  
+  // Theme configuration
+  themeConfig: {
+    // See theme-config.md
+  }
+})
+```
+
+## Site Metadata
+
+```ts
+export default defineConfig({
+  title: 'VitePress',           // Displayed in nav, used in page titles
+  titleTemplate: ':title - Docs', // Page title format (:title = h1)
+  description: 'Site description', // Meta description
+  lang: 'en-US',                 // HTML lang attribute
+  
+  head: [
+    ['link', { rel: 'icon', href: '/favicon.ico' }],
+    ['meta', { name: 'theme-color', content: '#5f67ee' }],
+    ['script', { async: '', src: 'https://analytics.example.com/script.js' }]
+  ]
+})
+```
+
+## Build Options
+
+```ts
+export default defineConfig({
+  // Source files directory (relative to project root)
+  srcDir: './src',
+  
+  // Exclude patterns from source
+  srcExclude: ['**/README.md', '**/TODO.md'],
+  
+  // Output directory
+  outDir: './.vitepress/dist',
+  
+  // Cache directory
+  cacheDir: './.vitepress/cache',
+  
+  // Clean URLs without .html extension (requires server support)
+  cleanUrls: true,
+  
+  // Ignore dead links during build
+  ignoreDeadLinks: true,
+  // Or specific patterns:
+  ignoreDeadLinks: ['/playground', /^https?:\/\/localhost/],
+  
+  // Get last updated timestamp from git
+  lastUpdated: true
+})
+```
+
+## Route Rewrites
+
+Map source paths to different output paths:
+
+```ts
+export default defineConfig({
+  rewrites: {
+    // Static mapping
+    'packages/pkg-a/src/index.md': 'pkg-a/index.md',
+    
+    // Dynamic parameters
+    'packages/:pkg/src/:slug*': ':pkg/:slug*'
+  }
+})
+```
+
+## Appearance (Dark Mode)
+
+```ts
+export default defineConfig({
+  appearance: true,           // Enable toggle (default)
+  appearance: 'dark',         // Dark by default
+  appearance: 'force-dark',   // Always dark, no toggle
+  appearance: 'force-auto',   // Always follow system preference
+  appearance: false           // Disable dark mode
+})
+```
+
+## Vite & Vue Configuration
+
+```ts
+export default defineConfig({
+  // Pass options to Vite
+  vite: {
+    plugins: [],
+    resolve: { alias: {} },
+    css: { preprocessorOptions: {} }
+  },
+  
+  // Pass options to @vitejs/plugin-vue
+  vue: {
+    template: { compilerOptions: {} }
+  },
+  
+  // Configure markdown-it
+  markdown: {
+    lineNumbers: true,
+    toc: { level: [1, 2, 3] },
+    math: true, // Requires markdown-it-mathjax3
+    container: {
+      tipLabel: 'TIP',
+      warningLabel: 'WARNING',
+      dangerLabel: 'DANGER'
+    }
+  }
+})
+```
+
+## Build Hooks
+
+```ts
+export default defineConfig({
+  // Transform page data
+  transformPageData(pageData, { siteConfig }) {
+    pageData.frontmatter.head ??= []
+    pageData.frontmatter.head.push([
+      'meta', { name: 'og:title', content: pageData.title }
+    ])
+  },
+  
+  // Transform head before generating each page
+  async transformHead(context) {
+    return [['meta', { name: 'custom', content: context.page }]]
+  },
+  
+  // After build completes
+  async buildEnd(siteConfig) {
+    // Generate sitemap, RSS, etc.
+  }
+})
+```
+
+## Dynamic Config
+
+For async configuration:
+
+```ts
+export default async () => {
+  const data = await fetch('https://api.example.com/data').then(r => r.json())
+  
+  return defineConfig({
+    title: data.title,
+    themeConfig: {
+      sidebar: data.sidebar
+    }
+  })
+}
+```
+
+## Key Points
+
+- Config file supports `.js`, `.ts`, `.mjs`, `.mts` extensions
+- Use `defineConfig` for TypeScript support
+- `base` must start and end with `/` for sub-path deployments
+- `srcDir` separates source files from project root
+- Build hooks enable custom transformations and post-processing
+
+<!--
+Source references:
+- https://vitepress.dev/reference/site-config
+- https://vitepress.dev/guide/getting-started
+-->

package/templates/skills/vitepress/references/core-markdown.md

@@ -0,0 +1,277 @@
+---
+name: vitepress-markdown
+description: Markdown extensions including frontmatter, custom containers, tables, anchors, and file includes
+---
+
+# Markdown Extensions
+
+VitePress extends standard markdown with additional features for documentation.
+
+## Frontmatter
+
+YAML metadata at the top of markdown files:
+
+```md
+---
+title: Page Title
+description: Page description for SEO
+layout: doc
+outline: [2, 3]
+---
+
+# Content starts here
+```
+
+Access frontmatter in templates:
+
+```md
+# {{ $frontmatter.title }}
+```
+
+Or in script:
+
+```vue
+<script setup>
+import { useData } from 'vitepress'
+const { frontmatter } = useData()
+</script>
+```
+
+## Custom Containers
+
+Styled callout blocks:
+
+```md
+::: info
+This is an info box.
+:::
+
+::: tip
+This is a tip.
+:::
+
+::: warning
+This is a warning.
+:::
+
+::: danger
+This is a dangerous warning.
+:::
+
+::: details Click to expand
+Hidden content here.
+:::
+```
+
+Custom titles:
+
+```md
+::: danger STOP
+Do not proceed!
+:::
+
+::: details Click me {open}
+Open by default with {open} attribute.
+:::
+```
+
+## GitHub-flavored Alerts
+
+Alternative syntax using blockquotes:
+
+```md
+> [!NOTE]
+> Highlights information users should know.
+
+> [!TIP]
+> Optional information for success.
+
+> [!WARNING]
+> Critical content requiring attention.
+
+> [!CAUTION]
+> Negative potential consequences.
+```
+
+## Header Anchors
+
+Headers get automatic anchor links. Custom anchors:
+
+```md
+# My Heading {#custom-anchor}
+
+[Link to heading](#custom-anchor)
+```
+
+## Table of Contents
+
+Generate a TOC with:
+
+```md
+[[toc]]
+```
+
+## GitHub-Style Tables
+
+```md
+| Feature | Status |
+|---------|--------|
+| SSR     | ✅     |
+| HMR     | ✅     |
+```
+
+## Emoji
+
+Use shortcodes:
+
+```md
+:tada: :rocket: :100:
+```
+
+## File Includes
+
+Include content from other files:
+
+```md
+<!--@include: ./shared/header.md-->
+```
+
+With line ranges:
+
+```md
+<!--@include: ./code.md{3,10}-->  <!-- Lines 3-10 -->
+<!--@include: ./code.md{3,}-->   <!-- From line 3 -->
+<!--@include: ./code.md{,10}-->  <!-- Up to line 10 -->
+```
+
+With regions:
+
+```md
+<!-- In parts/basics.md -->
+<!-- #region usage -->
+Usage content here
+<!-- #endregion usage -->
+
+<!-- Include just that region -->
+<!--@include: ./parts/basics.md#usage-->
+```
+
+## Code Snippet Import
+
+Import code from files:
+
+```md
+<<< @/snippets/example.js
+```
+
+With line highlighting:
+
+```md
+<<< @/snippets/example.js{2,4-6}
+```
+
+With language override:
+
+```md
+<<< @/snippets/example.cs{1,2 c#:line-numbers}
+```
+
+Import specific region:
+
+```md
+<<< @/snippets/example.js#regionName{1,2}
+```
+
+## Code Groups
+
+Tab groups for code variants:
+
+````md
+::: code-group
+
+```js [config.js]
+export default { /* ... */ }
+```
+
+```ts [config.ts]
+export default defineConfig({ /* ... */ })
+```
+
+:::
+````
+
+Import files in code groups:
+
+```md
+::: code-group
+
+<<< @/snippets/config.js
+<<< @/snippets/config.ts
+
+:::
+```
+
+## Math Equations
+
+Requires setup:
+
+```bash
+npm add -D markdown-it-mathjax3@^4
+```
+
+```ts
+// .vitepress/config.ts
+export default {
+  markdown: {
+    math: true
+  }
+}
+```
+
+Then use LaTeX:
+
+```md
+Inline: $E = mc^2$
+
+Block:
+$$
+\frac{-b \pm \sqrt{b^2-4ac}}{2a}
+$$
+```
+
+## Image Lazy Loading
+
+```ts
+export default {
+  markdown: {
+    image: {
+      lazyLoading: true
+    }
+  }
+}
+```
+
+## Raw Container
+
+Prevent VitePress style conflicts:
+
+```md
+::: raw
+<CustomComponent />
+:::
+```
+
+## Key Points
+
+- Frontmatter supports YAML or JSON format
+- Custom containers support info, tip, warning, danger, details
+- `[[toc]]` generates table of contents
+- `@` in imports refers to source root (or `srcDir` if configured)
+- Code groups create tabbed code blocks
+- Math support requires markdown-it-mathjax3 package
+
+<!--
+Source references:
+- https://vitepress.dev/guide/markdown
+- https://vitepress.dev/guide/frontmatter
+-->