open-index/open-npm huggingface dataset:
npm package: @fuxishi/vitepress-theme
Description: A beautiful VitePress theme for fx-core documentation.
Latest version: 1.0.0

# @fuxishi/vitepress-theme

精美的 VitePress 文档站主题扩展，毛玻璃质感，紫蓝渐变，动效丰富，开箱即用。

## 特性

- 🎵 **悬浮音乐球** — 毛玻璃质感的浮动播放器，支持单曲/列表模式，紫蓝渐变进度环与四重播放动效
- 🎊 **点击彩纸** — 全局点击彩纸特效，金色星星与彩色纸屑
- ✨ **Feature 光效** — 首页 Feature 卡片鼠标追踪光晕效果
- 🌈 **彩虹边框** — 暗色模式下代码块 hover 时展示彩虹旋转边框
- 🚦 **macOS 红绿灯** — 代码块顶部红黄绿交通灯装饰
- 🔄 **主题切换动画** — View Transition API 实现亮暗模式圆形扩散动画
- 🎨 **标题装饰** — h1-h4 各有不同颜色的下划线装饰
- ⚙️ **类型安全** — 完整的 TypeScript 类型定义，IDE 友好

## 安装

```bash
npm install @fuxishi/vitepress-theme
```

需要安装以下 peerDependencies：

```bash
npm install vitepress vue element-plus
```

## 使用

### 1. 注册主题

创建 `.vitepress/theme/index.ts`：

```ts
import FxTheme from '@fuxishi/vitepress-theme'
import '@fuxishi/vitepress-theme/style.css'

export default FxTheme
```

### 2. 继承配置

创建 `.vitepress/config.mts`：

```ts
import { defineConfigWithTheme } from 'vitepress'
import fxConfig from '@fuxishi/vitepress-theme/config'
import type { FxThemeConfig } from '@fuxishi/vitepress-theme/config'

export default defineConfigWithTheme<FxThemeConfig>({
  extends: fxConfig,
  lang: 'zh-CN',
  title: '我的文档站',
  themeConfig: {
    nav: [
      { text: '指南', link: '/guide/' },
    ],
    sidebar: {
      '/guide/': [
        { text: '快速开始', link: '/guide/' },
      ],
    },
    // 启用音乐球
    musicBall: {
      enable: true,
      autoplay: false,
      loop: true,
      src: '/music/my-song.mp3',
    },
    // 启用彩纸效果
    confetti: true,
  },
})
```

### 3. 启动开发服务器

```bash
npx vitepress dev
```

## 配置

### FxThemeConfig

继承自 VitePress `DefaultTheme.Config`，新增以下字段：

| 配置项 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| `musicBall.enable` | `boolean` | `true` | 是否启用音乐球 |
| `musicBall.visible` | `boolean` | `true` | 是否可见 |
| `musicBall.autoplay` | `boolean` | `false` | 自动播放 |
| `musicBall.loop` | `boolean` | `true` | 循环播放（单曲模式） |
| `musicBall.src` | `string` | `''` | 单首音乐地址 |
| `musicBall.list` | `MusicItem[]` | — | 多首音乐列表 |
| `confetti` | `boolean` | `true` | 是否启用点击彩纸效果 |

## 导出

| 导出路径 | 说明 |
|---------|------|
| `@fuxishi/vitepress-theme` | 主题（Layout + 样式） |
| `@fuxishi/vitepress-theme/config` | VitePress 基础配置预设 |
| `@fuxishi/vitepress-theme/style.css` | 独立样式文件 |

## 文档

完整文档请访问：[https://fuxishi-vitepress-theme.fuxizjxzy.cn](https://fuxishi-vitepress-theme.fuxizjxzy.cn)

## License

[MIT](./LICENSE)
npm package: @fuxui/base
Description: ui kit - svelte 5 + tailwind 4 - base components
Author: flo-bit
Latest version: 0.3.0
Deprecated: Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

# 🦊 fox ui

This package has been moved to `@foxui/core`.

svelte 5 + tailwind 4 ui kit, base components

- [Accordion](https://flo-bit.dev/ui-kit/components/base/accordion)
- [Alert](https://flo-bit.dev/ui-kit/components/base/alert)
- [Avatar](https://flo-bit.dev/ui-kit/components/base/avatar)
- [Badge](https://flo-bit.dev/ui-kit/components/base/badge)
- [Box](https://flo-bit.dev/ui-kit/components/base/box)
- [Button](https://flo-bit.dev/ui-kit/components/base/button)
- [Card](https://flo-bit.dev/ui-kit/components/base/cards)
- [Chat Bubble](https://flo-bit.dev/ui-kit/components/base/chat-bubble)
- [Checkbox](https://flo-bit.dev/ui-kit/components/base/checkbox)
- [Head](https://flo-bit.dev/ui-kit/components/base/head)
- [Heading](https://flo-bit.dev/ui-kit/components/base/image)
- [Modals](https://flo-bit.dev/ui-kit/components/base/modal)
- [Number Input](https://flo-bit.dev/ui-kit/components/base/number-input)
- [Popover](https://flo-bit.dev/ui-kit/components/base/popover)
- [Prose](https://flo-bit.dev/ui-kit/components/base/prose)
- [Scroll Area](https://flo-bit.dev/ui-kit/components/base/scroll-area)
- [Select](https://flo-bit.dev/ui-kit/components/base/select)
- [Sidebar](https://flo-bit.dev/ui-kit/components/base/sidebar)
- [Slider](https://flo-bit.dev/ui-kit/components/base/slider)
- [Sonner](https://flo-bit.dev/ui-kit/components/base/sonner)
- [Switch](https://flo-bit.dev/ui-kit/components/base/switch)
- [Tabs](https://flo-bit.dev/ui-kit/components/base/tabs)
- [Textarea](https://flo-bit.dev/ui-kit/components/base/textarea)
- [Toggle](https://flo-bit.dev/ui-kit/components/base/toggle)
- [Toggle Group](https://flo-bit.dev/ui-kit/components/base/toggle-group)
- [Tooltip](https://flo-bit.dev/ui-kit/components/base/tooltip)

> **This is a public alpha release. Expect bugs and breaking changes.**

[See all components here](https://flo-bit.dev/ui-kit)

For a guide on how to use this ui kit, see the [Quickstart Guide](https://flo-bit.dev/ui-kit/docs/quick-start).

Read more about [the philosophy/aim of this project here](https://flo-bit.dev/ui-kit/docs/philosophy).

For more information about development, contributing and the like, see the main [README](https://github.com/flo-bit/ui-kit/blob/main/README.md).