ads-fe 0.0.1

package/skills/vitepress/references/theme-custom.md

@@ -0,0 +1,269 @@
+---
+name: vitepress-custom-themes
+description: Building custom themes from scratch with the theme interface, Layout component, and enhanceApp
+---
+
+# Custom Themes
+
+Build a theme from scratch when the default theme doesn't fit your needs.
+
+## Theme Entry
+
+Create `.vitepress/theme/index.ts`:
+
+```ts
+// .vitepress/theme/index.ts
+import Layout from './Layout.vue'
+
+export default {
+  Layout,
+  enhanceApp({ app, router, siteData }) {
+    // Register global components, plugins, etc.
+  }
+}
+```
+
+## Theme Interface
+
+```ts
+interface Theme {
+  // Required: Root layout component
+  Layout: Component
+  
+  // Optional: Enhance Vue app instance
+  enhanceApp?: (ctx: EnhanceAppContext) => Awaitable<void>
+  
+  // Optional: Extend another theme
+  extends?: Theme
+}
+
+interface EnhanceAppContext {
+  app: App              // Vue app instance
+  router: Router        // VitePress router
+  siteData: Ref<SiteData>  // Site-level metadata
+}
+```
+
+## Basic Layout
+
+The Layout component must render `<Content />` for markdown:
+
+```vue
+<!-- .vitepress/theme/Layout.vue -->
+<script setup>
+import { useData } from 'vitepress'
+const { page, frontmatter } = useData()
+</script>
+
+<template>
+  <div class="layout">
+    <header>
+      <nav>My Site</nav>
+    </header>
+    
+    <main>
+      <div v-if="page.isNotFound">
+        <h1>404 - Page Not Found</h1>
+      </div>
+      
+      <div v-else-if="frontmatter.layout === 'home'">
+        <h1>Welcome!</h1>
+      </div>
+      
+      <article v-else>
+        <Content />
+      </article>
+    </main>
+    
+    <footer>
+      <p>© 2024 My Site</p>
+    </footer>
+  </div>
+</template>
+```
+
+## Runtime API
+
+Access VitePress data in your theme:
+
+```vue
+<script setup>
+import { useData, useRoute, useRouter } from 'vitepress'
+
+// Page and site data
+const { 
+  site,        // Site config (title, description, etc.)
+  theme,       // Theme config
+  page,        // Current page data
+  frontmatter, // Current page frontmatter
+  title,       // Page title
+  description, // Page description
+  lang,        // Current language
+  isDark,      // Dark mode state
+  params       // Dynamic route params
+} = useData()
+
+// Routing
+const route = useRoute()
+const router = useRouter()
+
+// Navigate programmatically
+const goToGuide = () => router.go('/guide/')
+</script>
+```
+
+## Built-in Components
+
+```vue
+<script setup>
+import { Content } from 'vitepress'
+</script>
+
+<template>
+  <!-- Renders markdown content -->
+  <Content />
+  
+  <!-- Renders slot only on client (SSR-safe) -->
+  <ClientOnly>
+    <NonSSRComponent />
+  </ClientOnly>
+</template>
+```
+
+## Extend Another Theme
+
+Build on top of default theme or any other:
+
+```ts
+// .vitepress/theme/index.ts
+import DefaultTheme from 'vitepress/theme'
+
+export default {
+  extends: DefaultTheme,
+  enhanceApp({ app }) {
+    // Your customizations
+  }
+}
+```
+
+## Register Plugins and Components
+
+```ts
+// .vitepress/theme/index.ts
+import Layout from './Layout.vue'
+import GlobalComponent from './GlobalComponent.vue'
+
+export default {
+  Layout,
+  enhanceApp({ app }) {
+    // Register global component
+    app.component('GlobalComponent', GlobalComponent)
+    
+    // Register plugin
+    app.use(MyPlugin)
+    
+    // Provide/inject
+    app.provide('key', value)
+  }
+}
+```
+
+## Async enhanceApp
+
+For plugins that need async initialization:
+
+```ts
+export default {
+  Layout,
+  async enhanceApp({ app }) {
+    if (!import.meta.env.SSR) {
+      // Client-only plugin
+      const plugin = await import('browser-only-plugin')
+      app.use(plugin.default)
+    }
+  }
+}
+```
+
+## Theme-Aware Layout
+
+Handle different page layouts:
+
+```vue
+<script setup>
+import { useData } from 'vitepress'
+import Home from './Home.vue'
+import Doc from './Doc.vue'
+import Page from './Page.vue'
+import NotFound from './NotFound.vue'
+
+const { page, frontmatter } = useData()
+</script>
+
+<template>
+  <NotFound v-if="page.isNotFound" />
+  <Home v-else-if="frontmatter.layout === 'home'" />
+  <Page v-else-if="frontmatter.layout === 'page'" />
+  <Doc v-else />
+</template>
+```
+
+## Distributing a Theme
+
+As npm package:
+
+```ts
+// my-theme/index.ts
+import Layout from './Layout.vue'
+export default { Layout }
+
+// Export types for config
+export type { ThemeConfig } from './types'
+```
+
+Consumer usage:
+
+```ts
+// .vitepress/theme/index.ts
+import Theme from 'my-vitepress-theme'
+
+export default Theme
+
+// Or extend it
+export default {
+  extends: Theme,
+  enhanceApp({ app }) {
+    // Additional customization
+  }
+}
+```
+
+## Theme Config Types
+
+For custom theme config types:
+
+```ts
+// .vitepress/config.ts
+import { defineConfigWithTheme } from 'vitepress'
+import type { ThemeConfig } from 'my-theme'
+
+export default defineConfigWithTheme<ThemeConfig>({
+  themeConfig: {
+    // Type-checked theme config
+  }
+})
+```
+
+## Key Points
+
+- Theme must export `Layout` component
+- `<Content />` renders the markdown content
+- Use `useData()` to access page/site data
+- `enhanceApp` runs on both server and client
+- Check `import.meta.env.SSR` for client-only code
+- Use `extends` to build on existing themes
+
+<!--
+Source references:
+- https://vitepress.dev/guide/custom-theme
+-->

package/skills/vitepress/references/theme-customization.md

@@ -0,0 +1,290 @@
+---
+name: extending-vitepress-default-theme
+description: Customize CSS variables, use layout slots, register global components, and override theme fonts
+---
+
+# Extending Default Theme
+
+Customize the default theme through CSS, slots, and Vue components.
+
+## Theme Entry File
+
+Create `.vitepress/theme/index.ts` to extend the default theme:
+
+```ts
+// .vitepress/theme/index.ts
+import DefaultTheme from 'vitepress/theme'
+import './custom.css'
+
+export default DefaultTheme
+```
+
+## CSS Variables
+
+Override root CSS variables:
+
+```css
+/* .vitepress/theme/custom.css */
+:root {
+  /* Brand colors */
+  --vp-c-brand-1: #646cff;
+  --vp-c-brand-2: #747bff;
+  --vp-c-brand-3: #9499ff;
+  
+  /* Backgrounds */
+  --vp-c-bg: #ffffff;
+  --vp-c-bg-soft: #f6f6f7;
+  
+  /* Text */
+  --vp-c-text-1: #213547;
+  --vp-c-text-2: #476582;
+}
+
+.dark {
+  --vp-c-brand-1: #747bff;
+  --vp-c-bg: #1a1a1a;
+}
+```
+
+See [all CSS variables](https://github.com/vuejs/vitepress/blob/main/src/client/theme-default/styles/vars.css).
+
+## Home Hero Customization
+
+```css
+:root {
+  /* Gradient name color */
+  --vp-home-hero-name-color: transparent;
+  --vp-home-hero-name-background: linear-gradient(120deg, #bd34fe, #41d1ff);
+  
+  /* Hero image glow */
+  --vp-home-hero-image-background-image: linear-gradient(-45deg, #bd34fe 50%, #47caff 50%);
+  --vp-home-hero-image-filter: blur(44px);
+}
+```
+
+## Custom Fonts
+
+Remove Inter font and use your own:
+
+```ts
+// .vitepress/theme/index.ts
+import DefaultTheme from 'vitepress/theme-without-fonts'
+import './fonts.css'
+
+export default DefaultTheme
+```
+
+```css
+/* .vitepress/theme/fonts.css */
+@font-face {
+  font-family: 'MyFont';
+  src: url('/fonts/myfont.woff2') format('woff2');
+}
+
+:root {
+  --vp-font-family-base: 'MyFont', sans-serif;
+  --vp-font-family-mono: 'Fira Code', monospace;
+}
+```
+
+Preload fonts in config:
+
+```ts
+// .vitepress/config.ts
+export default {
+  transformHead({ assets }) {
+    const fontFile = assets.find(file => /myfont\.[\w-]+\.woff2/.test(file))
+    if (fontFile) {
+      return [
+        ['link', { rel: 'preload', href: fontFile, as: 'font', type: 'font/woff2', crossorigin: '' }]
+      ]
+    }
+  }
+}
+```
+
+## Global Components
+
+Register components available in all markdown:
+
+```ts
+// .vitepress/theme/index.ts
+import DefaultTheme from 'vitepress/theme'
+import MyComponent from './components/MyComponent.vue'
+
+export default {
+  extends: DefaultTheme,
+  enhanceApp({ app }) {
+    app.component('MyComponent', MyComponent)
+  }
+}
+```
+
+Use in markdown:
+
+```md
+<MyComponent :prop="value" />
+```
+
+## Layout Slots
+
+Inject content into specific locations:
+
+```ts
+// .vitepress/theme/index.ts
+import DefaultTheme from 'vitepress/theme'
+import MyLayout from './MyLayout.vue'
+
+export default {
+  extends: DefaultTheme,
+  Layout: MyLayout
+}
+```
+
+```vue
+<!-- .vitepress/theme/MyLayout.vue -->
+<script setup>
+import DefaultTheme from 'vitepress/theme'
+const { Layout } = DefaultTheme
+</script>
+
+<template>
+  <Layout>
+    <template #aside-outline-before>
+      <div>Above outline</div>
+    </template>
+    
+    <template #doc-before>
+      <div>Before doc content</div>
+    </template>
+    
+    <template #doc-after>
+      <div>After doc content</div>
+    </template>
+  </Layout>
+</template>
+```
+
+### Available Slots
+
+**Doc layout (`layout: doc`):**
+- `doc-top`, `doc-bottom`
+- `doc-before`, `doc-after`
+- `doc-footer-before`
+- `sidebar-nav-before`, `sidebar-nav-after`
+- `aside-top`, `aside-bottom`
+- `aside-outline-before`, `aside-outline-after`
+- `aside-ads-before`, `aside-ads-after`
+
+**Home layout (`layout: home`):**
+- `home-hero-before`, `home-hero-after`
+- `home-hero-info-before`, `home-hero-info`, `home-hero-info-after`
+- `home-hero-actions-after`, `home-hero-image`
+- `home-features-before`, `home-features-after`
+
+**Page layout (`layout: page`):**
+- `page-top`, `page-bottom`
+
+**Always available:**
+- `layout-top`, `layout-bottom`
+- `nav-bar-title-before`, `nav-bar-title-after`
+- `nav-bar-content-before`, `nav-bar-content-after`
+- `not-found` (404 page)
+
+## Using Render Functions
+
+Alternative to template slots:
+
+```ts
+// .vitepress/theme/index.ts
+import { h } from 'vue'
+import DefaultTheme from 'vitepress/theme'
+import MyComponent from './MyComponent.vue'
+
+export default {
+  extends: DefaultTheme,
+  Layout() {
+    return h(DefaultTheme.Layout, null, {
+      'aside-outline-before': () => h(MyComponent)
+    })
+  }
+}
+```
+
+## Override Internal Components
+
+Replace default theme components with Vite aliases:
+
+```ts
+// .vitepress/config.ts
+import { fileURLToPath, URL } from 'node:url'
+
+export default {
+  vite: {
+    resolve: {
+      alias: [
+        {
+          find: /^.*\/VPNavBar\.vue$/,
+          replacement: fileURLToPath(
+            new URL('./theme/components/CustomNavBar.vue', import.meta.url)
+          )
+        }
+      ]
+    }
+  }
+}
+```
+
+## View Transitions
+
+Custom dark mode toggle animation:
+
+```vue
+<!-- .vitepress/theme/Layout.vue -->
+<script setup>
+import { useData } from 'vitepress'
+import DefaultTheme from 'vitepress/theme'
+import { nextTick, provide } from 'vue'
+
+const { isDark } = useData()
+
+provide('toggle-appearance', async ({ clientX: x, clientY: y }) => {
+  if (!document.startViewTransition) {
+    isDark.value = !isDark.value
+    return
+  }
+
+  const clipPath = [
+    `circle(0px at ${x}px ${y}px)`,
+    `circle(${Math.hypot(Math.max(x, innerWidth - x), Math.max(y, innerHeight - y))}px at ${x}px ${y}px)`
+  ]
+
+  await document.startViewTransition(async () => {
+    isDark.value = !isDark.value
+    await nextTick()
+  }).ready
+
+  document.documentElement.animate(
+    { clipPath: isDark.value ? clipPath.reverse() : clipPath },
+    { duration: 300, easing: 'ease-in', pseudoElement: `::view-transition-${isDark.value ? 'old' : 'new'}(root)` }
+  )
+})
+</script>
+
+<template>
+  <DefaultTheme.Layout />
+</template>
+```
+
+## Key Points
+
+- Import `vitepress/theme-without-fonts` to use custom fonts
+- Use layout slots to inject content without overriding components
+- Global components are registered in `enhanceApp`
+- Override CSS variables for theming
+- Use Vite aliases to replace internal components
+
+<!--
+Source references:
+- https://vitepress.dev/guide/extending-default-theme
+-->

package/skills/vitest/GENERATION.md

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

package/skills/vitest/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/vitest/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: vitest
+description: Vitest fast unit testing framework powered by Vite with Jest-compatible API. Use when writing tests, mocking, configuring coverage, or working with test filtering and fixtures.
+metadata:
+  author: Anthony Fu
+  version: "2026.1.28"
+  source: Generated from https://github.com/vitest-dev/vitest, scripts located at https://github.com/antfu/skills
+---
+
+Vitest is a next-generation testing framework powered by Vite. It provides a Jest-compatible API with native ESM, TypeScript, and JSX support out of the box. Vitest shares the same config, transformers, resolvers, and plugins with your Vite app.
+
+**Key Features:**
+- Vite-native: Uses Vite's transformation pipeline for fast HMR-like test updates
+- Jest-compatible: Drop-in replacement for most Jest test suites
+- Smart watch mode: Only reruns affected tests based on module graph
+- Native ESM, TypeScript, JSX support without configuration
+- Multi-threaded workers for parallel test execution
+- Built-in coverage via V8 or Istanbul
+- Snapshot testing, mocking, and spy utilities
+
+> The skill is based on Vitest 3.x, generated at 2026-01-28.
+
+## Core
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Configuration | Vitest and Vite config integration, defineConfig usage | [core-config](references/core-config.md) |
+| CLI | Command line interface, commands and options | [core-cli](references/core-cli.md) |
+| Test API | test/it function, modifiers like skip, only, concurrent | [core-test-api](references/core-test-api.md) |
+| Describe API | describe/suite for grouping tests and nested suites | [core-describe](references/core-describe.md) |
+| Expect API | Assertions with toBe, toEqual, matchers and asymmetric matchers | [core-expect](references/core-expect.md) |
+| Hooks | beforeEach, afterEach, beforeAll, afterAll, aroundEach | [core-hooks](references/core-hooks.md) |
+
+## Features
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Mocking | Mock functions, modules, timers, dates with vi utilities | [features-mocking](references/features-mocking.md) |
+| Snapshots | Snapshot testing with toMatchSnapshot and inline snapshots | [features-snapshots](references/features-snapshots.md) |
+| Coverage | Code coverage with V8 or Istanbul providers | [features-coverage](references/features-coverage.md) |
+| Test Context | Test fixtures, context.expect, test.extend for custom fixtures | [features-context](references/features-context.md) |
+| Concurrency | Concurrent tests, parallel execution, sharding | [features-concurrency](references/features-concurrency.md) |
+| Filtering | Filter tests by name, file patterns, tags | [features-filtering](references/features-filtering.md) |
+
+## Advanced
+
+| Topic | Description | Reference |
+|-------|-------------|-----------|
+| Vi Utilities | vi helper: mock, spyOn, fake timers, hoisted, waitFor | [advanced-vi](references/advanced-vi.md) |
+| Environments | Test environments: node, jsdom, happy-dom, custom | [advanced-environments](references/advanced-environments.md) |
+| Type Testing | Type-level testing with expectTypeOf and assertType | [advanced-type-testing](references/advanced-type-testing.md) |
+| Projects | Multi-project workspaces, different configs per project | [advanced-projects](references/advanced-projects.md) |

package/skills/vitest/SYNC.md

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