ads-fe 0.0.1

package/skills/vite/references/rolldown-migration.md

@@ -0,0 +1,157 @@
+---
+name: vite-rolldown
+description: Vite 8 Rolldown bundler and Oxc transformer migration
+---
+
+# Rolldown Migration (Vite 8)
+
+Vite 8 replaces esbuild+Rollup with Rolldown, a unified Rust-based bundler.
+
+## What Changed
+
+| Before (Vite 7) | After (Vite 8) |
+|-----------------|----------------|
+| esbuild (dev transform) | Oxc Transformer |
+| esbuild (dep pre-bundling) | Rolldown |
+| Rollup (production build) | Rolldown |
+| `rollupOptions` | `rolldownOptions` |
+| `esbuild` option | `oxc` option |
+
+## Performance Impact
+
+- 10-30x faster than Rollup for production builds
+- Matches esbuild's dev performance
+- Unified behavior between dev and build
+
+## Config Migration
+
+### rollupOptions → rolldownOptions
+
+```ts
+// Before (Vite 7)
+export default defineConfig({
+  build: {
+    rollupOptions: {
+      external: ['vue'],
+      output: { globals: { vue: 'Vue' } },
+    },
+  },
+})
+
+// After (Vite 8)
+export default defineConfig({
+  build: {
+    rolldownOptions: {
+      external: ['vue'],
+      output: { globals: { vue: 'Vue' } },
+    },
+  },
+})
+```
+
+### esbuild → oxc
+
+```ts
+// Before (Vite 7)
+export default defineConfig({
+  esbuild: {
+    jsxFactory: 'h',
+    jsxFragment: 'Fragment',
+  },
+})
+
+// After (Vite 8)
+export default defineConfig({
+  oxc: {
+    jsx: {
+      runtime: 'classic',
+      pragma: 'h',
+      pragmaFrag: 'Fragment',
+    },
+  },
+})
+```
+
+### JSX Configuration
+
+```ts
+export default defineConfig({
+  oxc: {
+    jsx: {
+      runtime: 'automatic',  // or 'classic'
+      importSource: 'react', // for automatic runtime
+    },
+    jsxInject: `import React from 'react'`,  // auto-inject
+  },
+})
+```
+
+### Custom Transform Targets
+
+```ts
+export default defineConfig({
+  oxc: {
+    include: ['**/*.ts', '**/*.tsx'],
+    exclude: ['node_modules/**'],
+  },
+})
+```
+
+## Plugin Compatibility
+
+Most Vite plugins work unchanged. Rolldown supports Rollup's plugin API.
+
+If a plugin only works during build:
+
+```ts
+{
+  ...rollupPlugin(),
+  enforce: 'post',
+  apply: 'build',
+}
+```
+
+## New Capabilities
+
+Rolldown unlocks features not possible before:
+
+- Full bundle mode (experimental)
+- Module-level persistent cache
+- More flexible chunk splitting
+- Module Federation support
+
+## Gradual Migration
+
+For large projects, migrate via `rolldown-vite` first:
+
+```bash
+# Step 1: Test with rolldown-vite
+pnpm add -D rolldown-vite
+
+# Replace vite import in config
+import { defineConfig } from 'rolldown-vite'
+
+# Step 2: Once stable, upgrade to Vite 8
+pnpm add -D vite@8
+```
+
+## Overriding Vite in Frameworks
+
+When framework depends on older Vite:
+
+```json
+{
+  "pnpm": {
+    "overrides": {
+      "vite": "8.0.0"
+    }
+  }
+}
+```
+
+<!--
+Source references:
+- https://vite.dev/blog/announcing-vite8-beta
+- https://vite.dev/blog/announcing-vite7
+- https://vite.dev/config/shared-options#oxc
+-->

package/skills/vitepress/GENERATION.md

@@ -0,0 +1,5 @@
+# Generation Info
+
+- **Source:** `sources/vitepress`
+- **Git SHA:** `d4796a0373eb486766cf48e63fdf461681424d43`
+- **Generated:** 2026-01-28

package/skills/vitepress/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-PRESENT Anthony Fu <https://github.com/antfu>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/vitepress/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: vitepress
+description: VitePress static site generator powered by Vite and Vue. Use when building documentation sites, configuring themes, or writing Markdown with Vue components.
+metadata:
+  author: Anthony Fu
+  version: "2026.1.28"
+  source: Generated from https://github.com/vuejs/vitepress, scripts located at https://github.com/antfu/skills
+---
+
+VitePress is a Static Site Generator (SSG) built on Vite and Vue 3. It takes Markdown content, applies a theme, and generates static HTML that becomes an SPA for fast navigation. Perfect for documentation, blogs, and marketing sites.
+
+**Key Characteristics:**
+- File-based routing with `.md` files
+- Vue components work directly in Markdown
+- Fast HMR with instant updates (<100ms)
+- Default theme optimized for documentation
+- Built-in search (local or Algolia)
+
+**Before working with VitePress projects:**
+- Check `.vitepress/config.ts` for site configuration
+- Look at `.vitepress/theme/` for custom theme extensions
+- The `public/` directory contains static assets served as-is
+
+> The skill is based on VitePress 1.x, generated at 2026-01-28.
+
+## Core
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Configuration | Config file setup, defineConfig, site metadata | [core-config](references/core-config.md) |
+| CLI | Command-line interface: dev, build, preview, init | [core-cli](references/core-cli.md) |
+| Routing | File-based routing, source directory, rewrites | [core-routing](references/core-routing.md) |
+| Markdown | Frontmatter, containers, tables, anchors, includes | [core-markdown](references/core-markdown.md) |
+
+## Features
+
+### Code & Content
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Code Blocks | Syntax highlighting, line highlighting, diffs, focus | [features-code-blocks](references/features-code-blocks.md) |
+| Vue in Markdown | Components, script setup, directives, templating | [features-vue](references/features-vue.md) |
+| Data Loading | Build-time data loaders, createContentLoader | [features-data-loading](references/features-data-loading.md) |
+| Dynamic Routes | Generate pages from data, paths loader files | [features-dynamic-routes](references/features-dynamic-routes.md) |
+
+## Theme
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Theme Config | Nav, sidebar, search, social links, footer | [theme-config](references/theme-config.md) |
+| Customization | CSS variables, slots, fonts, global components | [theme-customization](references/theme-customization.md) |
+| Custom Theme | Building themes from scratch, theme interface | [theme-custom](references/theme-custom.md) |
+
+## Advanced
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Internationalization | Multi-language sites, locale configuration | [advanced-i18n](references/advanced-i18n.md) |
+| SSR Compatibility | Server-side rendering, ClientOnly, dynamic imports | [advanced-ssr](references/advanced-ssr.md) |
+
+## Recipes
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Deployment | GitHub Pages, Netlify, Vercel, Cloudflare, Nginx | [recipes-deploy](references/recipes-deploy.md) |

package/skills/vitepress/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- Source: `vendor/vue/skills/vitepress`
+- Git SHA: `50deaeb269d80d92db7a2c5a677290309ae307fc`
+- Synced: 2026-05-21

package/skills/vitepress/references/advanced-i18n.md

@@ -0,0 +1,299 @@
+---
+name: vitepress-internationalization
+description: Setting up multi-language sites with locale configuration and RTL support
+---
+
+# Internationalization
+
+VitePress supports multi-language sites through locale configuration.
+
+## Directory Structure
+
+Organize content by locale:
+
+```
+docs/
+├─ en/
+│  ├─ guide.md
+│  └─ index.md
+├─ zh/
+│  ├─ guide.md
+│  └─ index.md
+└─ fr/
+   ├─ guide.md
+   └─ index.md
+```
+
+Or with root as default language:
+
+```
+docs/
+├─ guide.md        # English (root)
+├─ index.md
+├─ zh/
+│  ├─ guide.md
+│  └─ index.md
+└─ fr/
+   ├─ guide.md
+   └─ index.md
+```
+
+## Configuration
+
+```ts
+// .vitepress/config.ts
+import { defineConfig } from 'vitepress'
+
+export default defineConfig({
+  locales: {
+    root: {
+      label: 'English',
+      lang: 'en'
+    },
+    zh: {
+      label: '简体中文',
+      lang: 'zh-CN',
+      link: '/zh/'
+    },
+    fr: {
+      label: 'Français',
+      lang: 'fr',
+      link: '/fr/'
+    }
+  }
+})
+```
+
+## Locale-Specific Config
+
+Override site config per locale:
+
+```ts
+locales: {
+  root: {
+    label: 'English',
+    lang: 'en',
+    title: 'My Docs',
+    description: 'Documentation site',
+    themeConfig: {
+      nav: [
+        { text: 'Guide', link: '/guide/' }
+      ],
+      sidebar: {
+        '/guide/': [
+          { text: 'Introduction', link: '/guide/' }
+        ]
+      }
+    }
+  },
+  zh: {
+    label: '简体中文',
+    lang: 'zh-CN',
+    link: '/zh/',
+    title: '我的文档',
+    description: '文档站点',
+    themeConfig: {
+      nav: [
+        { text: '指南', link: '/zh/guide/' }
+      ],
+      sidebar: {
+        '/zh/guide/': [
+          { text: '介绍', link: '/zh/guide/' }
+        ]
+      }
+    }
+  }
+}
+```
+
+## Locale-Specific Properties
+
+Each locale can override:
+
+```ts
+interface LocaleSpecificConfig {
+  lang?: string
+  dir?: string              // 'ltr' or 'rtl'
+  title?: string
+  titleTemplate?: string | boolean
+  description?: string
+  head?: HeadConfig[]       // Merged with existing
+  themeConfig?: ThemeConfig // Shallow merged
+}
+```
+
+## Search i18n
+
+### Local Search
+
+```ts
+themeConfig: {
+  search: {
+    provider: 'local',
+    options: {
+      locales: {
+        zh: {
+          translations: {
+            button: {
+              buttonText: '搜索',
+              buttonAriaLabel: '搜索'
+            },
+            modal: {
+              noResultsText: '没有结果',
+              resetButtonTitle: '重置搜索',
+              footer: {
+                selectText: '选择',
+                navigateText: '导航',
+                closeText: '关闭'
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+### Algolia Search
+
+```ts
+themeConfig: {
+  search: {
+    provider: 'algolia',
+    options: {
+      appId: '...',
+      apiKey: '...',
+      indexName: '...',
+      locales: {
+        zh: {
+          placeholder: '搜索文档',
+          translations: {
+            button: { buttonText: '搜索文档' }
+          }
+        }
+      }
+    }
+  }
+}
+```
+
+## Separate Locale Directories
+
+For fully separated locales without root fallback:
+
+```
+docs/
+├─ en/
+│  └─ index.md
+├─ zh/
+│  └─ index.md
+└─ fr/
+   └─ index.md
+```
+
+Requires server redirect for `/` → `/en/`. Netlify example:
+
+```
+/* /en/:splat 302 Language=en
+/* /zh/:splat 302 Language=zh
+/* /en/:splat 302
+```
+
+## Persisting Language Choice
+
+Set cookie on language change:
+
+```vue
+<!-- .vitepress/theme/Layout.vue -->
+<script setup>
+import DefaultTheme from 'vitepress/theme'
+import { useData, inBrowser } from 'vitepress'
+import { watchEffect } from 'vue'
+
+const { lang } = useData()
+
+watchEffect(() => {
+  if (inBrowser) {
+    document.cookie = `nf_lang=${lang.value}; expires=Mon, 1 Jan 2030 00:00:00 UTC; path=/`
+  }
+})
+</script>
+
+<template>
+  <DefaultTheme.Layout />
+</template>
+```
+
+## RTL Support (Experimental)
+
+For right-to-left languages:
+
+```ts
+locales: {
+  ar: {
+    label: 'العربية',
+    lang: 'ar',
+    dir: 'rtl'
+  }
+}
+```
+
+Requires PostCSS plugin like `postcss-rtlcss`:
+
+```ts
+// postcss.config.js
+import rtlcss from 'postcss-rtlcss'
+
+export default {
+  plugins: [
+    rtlcss({
+      ltrPrefix: ':where([dir="ltr"])',
+      rtlPrefix: ':where([dir="rtl"])'
+    })
+  ]
+}
+```
+
+## Organizing Config
+
+Split config into separate files:
+
+```
+.vitepress/
+├─ config/
+│  ├─ index.ts      # Main config, merges locales
+│  ├─ en.ts         # English config
+│  ├─ zh.ts         # Chinese config
+│  └─ shared.ts     # Shared config
+```
+
+```ts
+// .vitepress/config/index.ts
+import { defineConfig } from 'vitepress'
+import { shared } from './shared'
+import { en } from './en'
+import { zh } from './zh'
+
+export default defineConfig({
+  ...shared,
+  locales: {
+    root: { label: 'English', ...en },
+    zh: { label: '简体中文', ...zh }
+  }
+})
+```
+
+## Key Points
+
+- Use `locales` object in config with `root` for default language
+- Each locale can override title, description, and themeConfig
+- `themeConfig` is shallow merged (define complete nav/sidebar per locale)
+- Don't override `themeConfig.algolia` at locale level
+- `dir: 'rtl'` enables RTL with PostCSS plugin
+- Language switcher appears automatically in nav
+
+<!--
+Source references:
+- https://vitepress.dev/guide/i18n
+-->