{"owner":"youzan","repo":"vant","hasSkills":true,"totalSkillsCount":151,"totalTokensCount":221767,"categories":["anthropic-skill","plugin-manifest"],"hasMcp":false,"mcpConfig":null,"found":[".agents/skills/rstack-cli-docs/SKILL.md","packages/create-vant-cli-app/generators/vue2/docs/home.md","packages/create-vant-cli-app/generators/vue2/docs/quickstart.md","packages/create-vant-cli-app/generators/vue2/src/demo-button/README.md","packages/create-vant-cli-app/generators/vue3/docs/home.md","packages/create-vant-cli-app/generators/vue3/docs/quickstart.md","packages/create-vant-cli-app/generators/vue3/src/demo-button/README.md","packages/vant-area-data/README.md","packages/vant-auto-import-resolver/README.md","packages/vant-cli/README.md","packages/vant-cli/docs/commands.md","packages/vant-cli/docs/commands.zh-CN.md","packages/vant-cli/docs/config.md","packages/vant-cli/docs/config.zh-CN.md","packages/vant-cli/docs/directory.md","packages/vant-cli/docs/directory.zh-CN.md","packages/vant-compat/README.md","packages/vant-icons/README.md","packages/vant-popperjs/README.md","packages/vant-touch-emulator/README.md","packages/vant-use/README.md","packages/vant/docs/markdown/advanced-usage.en-US.md","packages/vant/docs/markdown/advanced-usage.zh-CN.md","packages/vant/docs/markdown/changelog.en-US.md","packages/vant/docs/markdown/changelog.zh-CN.md","packages/vant/docs/markdown/contribution.en-US.md","packages/vant/docs/markdown/contribution.zh-CN.md","packages/vant/docs/markdown/design.en-US.md","packages/vant/docs/markdown/design.zh-CN.md","packages/vant/docs/markdown/faq.en-US.md","packages/vant/docs/markdown/faq.zh-CN.md","packages/vant/docs/markdown/home.en-US.md","packages/vant/docs/markdown/home.zh-CN.md","packages/vant/docs/markdown/migrate-from-v2.en-US.md","packages/vant/docs/markdown/migrate-from-v2.zh-CN.md","packages/vant/docs/markdown/migrate-from-v3.en-US.md","packages/vant/docs/markdown/migrate-from-v3.zh-CN.md","packages/vant/docs/markdown/quickstart.en-US.md","packages/vant/docs/markdown/quickstart.zh-CN.md","packages/vant/docs/markdown/release-note-v4.en-US.md","packages/vant/docs/markdown/release-note-v4.zh-CN.md","packages/vant/docs/markdown/use-click-away.en-US.md","packages/vant/docs/markdown/use-click-away.zh-CN.md","packages/vant/docs/markdown/use-count-down.en-US.md","packages/vant/docs/markdown/use-count-down.zh-CN.md","packages/vant/docs/markdown/use-custom-field-value.en-US.md","packages/vant/docs/markdown/use-custom-field-value.zh-CN.md","packages/vant/docs/markdown/use-event-listener.en-US.md","packages/vant/docs/markdown/use-event-listener.zh-CN.md","packages/vant/docs/markdown/use-page-visibility.en-US.md","packages/vant/docs/markdown/use-page-visibility.zh-CN.md","packages/vant/docs/markdown/use-raf.en-US.md","packages/vant/docs/markdown/use-raf.zh-CN.md","packages/vant/docs/markdown/use-rect.en-US.md","packages/vant/docs/markdown/use-rect.zh-CN.md","packages/vant/docs/markdown/use-relation.en-US.md","packages/vant/docs/markdown/use-relation.zh-CN.md","packages/vant/docs/markdown/use-scroll-parent.en-US.md","packages/vant/docs/markdown/use-scroll-parent.zh-CN.md","packages/vant/docs/markdown/use-toggle.en-US.md","packages/vant/docs/markdown/use-toggle.zh-CN.md","packages/vant/docs/markdown/use-window-size.en-US.md","packages/vant/docs/markdown/use-window-size.zh-CN.md","packages/vant/docs/markdown/vant-use-intro.en-US.md","packages/vant/docs/markdown/vant-use-intro.zh-CN.md","packages/vant/src/action-bar/README.md","packages/vant/src/action-sheet/README.md","packages/vant/src/address-edit/README.md","packages/vant/src/address-list/README.md","packages/vant/src/area/README.md","packages/vant/src/back-top/README.md","packages/vant/src/badge/README.md","packages/vant/src/barrage/README.md","packages/vant/src/button/README.md","packages/vant/src/calendar/README.md","packages/vant/src/card/README.md","packages/vant/src/cascader/README.md","packages/vant/src/cell/README.md","packages/vant/src/checkbox/README.md","packages/vant/src/circle/README.md","packages/vant/src/col/README.md","packages/vant/src/collapse/README.md","packages/vant/src/config-provider/README.md","packages/vant/src/contact-card/README.md","packages/vant/src/contact-edit/README.md","packages/vant/src/contact-list/README.md","packages/vant/src/count-down/README.md","packages/vant/src/coupon-list/README.md","packages/vant/src/date-picker/README.md","packages/vant/src/dialog/README.md","packages/vant/src/divider/README.md","packages/vant/src/dropdown-menu/README.md","packages/vant/src/empty/README.md","packages/vant/src/field/README.md","packages/vant/src/floating-bubble/README.md","packages/vant/src/floating-panel/README.md","packages/vant/src/form/README.md","packages/vant/src/grid/README.md","packages/vant/src/highlight/README.md","packages/vant/src/icon/README.md","packages/vant/src/image-preview/README.md","packages/vant/src/image/README.md","packages/vant/src/index-bar/README.md","packages/vant/src/lazyload/README.md","packages/vant/src/list/README.md","packages/vant/src/loading/README.md","packages/vant/src/locale/README.md","packages/vant/src/nav-bar/README.md","packages/vant/src/notice-bar/README.md","packages/vant/src/notify/README.md","packages/vant/src/number-keyboard/README.md","packages/vant/src/overlay/README.md","packages/vant/src/pagination/README.md","packages/vant/src/password-input/README.md","packages/vant/src/picker-group/README.md","packages/vant/src/picker/README.md","packages/vant/src/popover/README.md","packages/vant/src/popup/README.md","packages/vant/src/progress/README.md","packages/vant/src/pull-refresh/README.md","packages/vant/src/radio/README.md","packages/vant/src/rate/README.md","packages/vant/src/rolling-text/README.md","packages/vant/src/search/README.md","packages/vant/src/share-sheet/README.md","packages/vant/src/sidebar/README.md","packages/vant/src/signature/README.md","packages/vant/src/skeleton-avatar/README.md","packages/vant/src/skeleton-image/README.md","packages/vant/src/skeleton-paragraph/README.md","packages/vant/src/skeleton-title/README.md","packages/vant/src/skeleton/README.md","packages/vant/src/slider/README.md","packages/vant/src/space/README.md","packages/vant/src/stepper/README.md","packages/vant/src/steps/README.md","packages/vant/src/sticky/README.md","packages/vant/src/style/README.md","packages/vant/src/submit-bar/README.md","packages/vant/src/swipe-cell/README.md","packages/vant/src/swipe/README.md","packages/vant/src/switch/README.md","packages/vant/src/tab/README.md","packages/vant/src/tabbar/README.md","packages/vant/src/tag/README.md","packages/vant/src/text-ellipsis/README.md","packages/vant/src/time-picker/README.md","packages/vant/src/toast/README.md","packages/vant/src/tree-select/README.md","packages/vant/src/uploader/README.md","packages/vant/src/watermark/README.md"],"skills":{".agents/skills/rstack-cli-docs/SKILL.md":"---\nname: rstack-cli-docs\ndescription: Consult installed, version-matched Rstack docs only for user-facing `rs` command behavior, `rstack.config.*` semantics, or public `rstack` APIs. Do not use for purely internal implementation, tests, performance, or repository maintenance.\n---\n\n# Rstack CLI Docs\n\nRstack CLI is the `rstack` package, exposed through the `rs` binaries. It provides one CLI, one config file, and a consistent workflow for the Rstack JavaScript toolchain.\n\nIt covers web app, library, docs, test, lint, formatting, Git hook, and staged-file workflows.\n\n## Read installed docs when this skill applies\n\nWhen this skill applies, find and read the relevant Markdown documentation shipped with the installed `rstack` package.\n\nModel knowledge can be outdated; the installed documentation is the source of truth for the project's Rstack version.\n\n1. Start with `node_modules/rstack/docs/llms.txt`, then read only the linked pages relevant to the task before proposing or making changes.\n\n2. For exact CLI flags and behavior, also run `rs -h` or `rs -h` when supported.\n\nIf the bundled docs are not available at that path, locate the installed `rstack` package.\n\nIf they are still unavailable, verify that `rstack` is installed, and use CLI help plus the online [Rstack documentation](https://rstack.rs/) as a fallback.\n","packages/create-vant-cli-app/generators/vue2/docs/home.md":"# 介绍\n\n### 关于\n\n这是一段组件库的介绍\n\n### 特性\n\n- 特性一\n- 特性二\n- 特性三\n","packages/create-vant-cli-app/generators/vue2/docs/quickstart.md":"# 快速上手\n\n### 安装\n\n```bash\n# 通过 npm\nnpm i <%= name %>\n\n# 通过 yarn\nyarn add <%= name %>\n\n# 通过 pnpm\npnpm add <%= name %>\n\n# 通过 bun\nbun add <%= name %>\n```\n","packages/create-vant-cli-app/generators/vue2/src/demo-button/README.md":"","packages/create-vant-cli-app/generators/vue3/docs/home.md":"# 介绍\n\n### 关于\n\n这是一段组件库的介绍\n\n### 特性\n\n- 特性一\n- 特性二\n- 特性三\n","packages/create-vant-cli-app/generators/vue3/docs/quickstart.md":"# 快速上手\n\n### 安装\n\n```bash\n# 通过 npm\nnpm i <%= name %>\n\n# 通过 yarn\nyarn add <%= name %>\n\n# 通过 pnpm\npnpm add <%= name %>\n\n# 通过 bun\nbun add <%= name %>\n```\n","packages/create-vant-cli-app/generators/vue3/src/demo-button/README.md":"","packages/vant-area-data/README.md":"","packages/vant-auto-import-resolver/README.md":"","packages/vant-cli/README.md":"","packages/vant-cli/docs/commands.md":"# Commands\n\nYou can add built-in commands to `npm scripts` to use it.\n\n```json\n// package.json\n{\n \"scripts\": {\n \"dev\": \"vant-cli dev\",\n \"test\": \"vant-cli test\",\n \"release\": \"vant-cli release\",\n \"build-site\": \"vant-cli build-site\"\n }\n}\n```\n\nAdditionally, [npx](https://github.com/npm/npx) can used to be run those commands.\n\n```bash\nnpx vant-cli dev\n```\n\n### dev\n\nStart local dev server for browsering components and demo.\n\n### build\n\nBuild Vue component library.\n\nFiles will be output to `es` and `lib` directory. More details [directory structure](https://github.com/vant-ui/vant/tree/main/packages/vant-cli/docs/directory.md)\n\nPlease add the followed config to `package.json` when publish to npm.\n\n```json\n// package.json\n{\n \"main\": \"lib/index.js\",\n \"module\": \"es/index.js\",\n \"files\": [\"es\", \"lib\"]\n}\n```\n\n### build-site\n\nBuild documentation website. Files will be output to `site` directory.\n\n### release\n\nPublish to npm. `build` will be automatically execute when run `release`.\n\n### commit-lint\n\nValidate the format of commit message. Need `husky` to do this.\n","packages/vant-cli/docs/commands.zh-CN.md":"# 命令\n\nVant CLI 中内置了一系列的命令，可以将命令添加到 npm scripts 中进行使用。\n\n```json\n// package.json\n{\n \"scripts\": {\n \"dev\": \"vant-cli dev\",\n \"test\": \"vant-cli test\",\n \"release\": \"vant-cli release\",\n \"build-site\": \"vant-cli build-site\"\n }\n}\n```\n\n也可以通过 npm 自带的 [npx](https://github.com/npm/npx) 直接执行某个命令：\n\n```bash\nnpx vant-cli dev\n```\n\n### dev\n\n运行本地开发环境。\n\n运行 dev 命令时，Vant CLI 会通过启动一个本地服务器，用于在开发过程中对文档和示例进行预览。\n\n### build\n\n构建组件库。\n\n运行 build 命令会在 `es` 和 `lib` 目录下生成可用于生产环境的组件代码，详见 [目录结构](https://github.com/vant-ui/vant/tree/main/packages/vant-cli/docs/directory.zh-CN.md)。\n\n发布 npm 时，请将以下配置加入到 `package.json` 中，使 npm 包能被正确识别:\n\n```json\n// package.json\n{\n \"main\": \"lib/index.js\",\n \"module\": \"es/index.js\",\n \"files\": [\"es\", \"lib\"]\n}\n```\n\n### build-site\n\n构建文档站点，在 `site` 目录生成可用于生产环境的文档站点代码。\n\n### release\n\n发布组件库，发布前会自动执行 build 命令，并按照流程发布 npm 包。\n\n### commit-lint\n\n校验 commit message 的格式是否符合规范，需要配合 `husky` 在提交 commit 时触发。\n","packages/vant-cli/docs/config.md":"# Config\n\n- [Config](#----)\n - [rsbuild.config.mjs](#rsbuildconfigmjs)\n - [vite.config.mjs](#viteconfigmjs)\n - [vant.config.mjs](#vantconfigmjs)\n - [name](#name)\n - [build.css.base](#buildcssbase)\n - [build.css.preprocessor](#buildcsspreprocessor)\n - [build.site.publicPath](#buildsitepublicpath)\n - [build.srcDir](#buildsrcdir)\n - [build.namedExport](#buildnamedexport)\n - [build.packageManager](#buildpackagemanager)\n - [site.title](#sitetitle)\n - [site.logo](#sitelogo)\n - [site.description](#sitedescription)\n - [site.nav](#sitenav)\n - [site.versions](#siteversions)\n - [site.baiduAnalytics](#sitebaiduanalytics)\n - [site.hideSimulator](#sitehidesimulator)\n - [site.simulator.url](#sitesimulatorurl)\n - [site.htmlMeta](#sitehtmlmeta)\n - [site.enableVConsole](#siteenablevconsole)\n - [PostCSS](#postcss)\n - [Default Config](#-----1)\n - [browserslist](#browserslist)\n\n## rsbuild.config.mjs\n\nVant CLI uses [Rsbuild](https://github.com/web-infra-dev/rsbuild) to build the documentation site. You can create an Rsbuild configuration file in the same directory as `vant.config.mjs`. The contents of the file will be automatically read by Vant CLI.\n\n```js\n// rsbuild.config.mjs or rsbuild.config.ts\nexport default {\n plugins: [\n // Configure Rsbuild plugins\n ],\n dev: {\n // Options related to local development\n },\n html: {\n // Options related to HTML generation\n },\n // Other options\n};\n```\n\n> Please refer to [Configure Rsbuild](https://rsbuild.dev/guide/basic/configure-rsbuild) for more information.\n\n## vite.config.mjs\n\nVant Cli uses Vite to build component library code. You can create a Vite configuration file in the same directory as `vant.config.mjs`. In this file, you can add any Vite configuration.\n\n> Please refer to [Vite Configuration](https://vitejs.dev/config/) to learn more.\n\n## vant.config.mjs\n\n`vant.config.mjs` includes bundle and documentation site config. Please create this file and place it in your project root directory. Here is a basic example:\n\n```js\nexport default {\n // component library name\n name: 'demo-ui',\n // bundle config\n build: {\n site: {\n publicPath: '/demo-ui/',\n },\n },\n // documentation site config\n site: {\n // title\n title: 'Demo UI',\n // logo\n logo: 'https://fastly.jsdelivr.net/npm/@vant/assets/logo.png',\n // description\n description: '示例组件库',\n // left nav\n nav: [\n {\n title: 'example',\n items: [\n {\n path: 'home',\n title: 'home',\n },\n ],\n },\n {\n title: 'basic components',\n items: [\n {\n path: 'my-button',\n title: 'MyButton',\n },\n ],\n },\n ],\n },\n};\n```\n\n### name\n\n- Type: `string`\n- Default: `''`\n\nComponent library name. kebab-case recommended.\n\n### build.css.base\n\n- Type: `string`\n- Default: `'style/base.less'`\n\nGlobal style file path. Support absolute path and relative path both.\n\nNote: relative path is calculated based on `src`.\n\n```js\nmodule.exports = {\n build: {\n css: {\n base: 'style/global.scss',\n },\n },\n};\n```\n\n### build.css.preprocessor\n\n- Type: `string`\n- Default: `'less'`\n\nCSS preprocessor config, support `less` and `sass`. Use `less` by default.\n\n```js\nmodule.exports = {\n build: {\n css: {\n preprocessor: 'sass',\n },\n },\n};\n```\n\n### build.css.removeSourceFile\n\n- Type: `boolean`\n- Default: `'false'`\n\nWhether to remove the source style files after build.\n\n```js\nmodule.exports = {\n build: {\n css: {\n removeSourceFile: true,\n },\n },\n};\n```\n\n### build.site.publicPath\n\n- Type: `string`\n- Default: `/`\n\nEquivalent to vite `build.outDir`.\n\nGenerally, documentation site will be deployed to subpath of domain. For example: `https://my.github.io/demo-ui/`, `publicPath` should be `/demo-ui/`.\n\n```js\nmodule.exports = {\n build: {\n site: {\n publicPath: '/demo-ui/',\n },\n },\n};\n```\n\n### build.srcDir\n\n- Type: `string`\n- Default: `src`\n\n```js\nmodule.exports = {\n build: {\n srcDir: 'myDir',\n },\n};\n```\n\n### build.namedExport\n\n- Type: `boolean`\n- Default: `false`\n\nShould export components by Named Export.\n\nWhen set to `false`, `export default from 'xxx'` will be used to export module.\n\nWhen set to `true`, `export * from 'xxx'` will be used to export all modules and type definition.\n\n### build.configureVite\n\n- Type: `(config: InlineConfig): InlineConfig | undefined`\n- Default: `undefined`\n\nCustom [vite config](https://vitejs.dev/config/), requires `@vant/cli>= 4.0.0`.\n\n```js\nmodule.exports = {\n build: {\n configureVite(config) {\n config.server.port = 3000;\n return config;\n },\n },\n};\n```\n\nIf you need to configure some vite plugins, please create a `vite.config.ts` file in the same directory of `vant.config.mjs`, in which you can add any vite configuration (this feature requires @vant/cli 5.1.0).\n\n### build.packageManager\n\n- Type: `'npm' | 'yarn' | 'pnpm' | 'bun'`\n- Default: `yarn`\n\n`npm` package manager.\n\n### build.bundleOptions\n\n- Type: `BundleOptions[]`\n\nSpecify the format of the bundled output.\n\nThe type of `BundleOptions`:\n\n```ts\ntype BundleOption = {\n // Whether to minify code (Tips: es format output can't be minified by vite)\n minify?: boolean;\n // Formats, can be set to 'es' | 'cjs' | 'umd' | 'iife'\n formats: LibraryFormats[];\n // Dependencies to external (Vue is externaled by default)\n external?: string[];\n};\n```\n\nDefault value：\n\n```ts\nconst DEFAULT_OPTIONS: BundleOption[] = [\n {\n minify: false,\n formats: ['umd'],\n },\n {\n minify: true,\n formats: ['umd'],\n },\n {\n minify: false,\n formats: ['es', 'cjs'],\n external: allDependencies,\n },\n];\n```\n\n### site.title\n\n- Type: `string`\n- Default: `''`\n\nDocumentation site title.\n\n### site.logo\n\n- Type: `string`\n- Default: `''`\n\nDocumentation site logo.\n\n### site.description\n\n- Type: `string`\n- Default: `''`\n\nDocumentation site description.\n\n### site.nav\n\n- Type: `object[]`\n- Default: `undefined`\n\nDocumentation site left nav. Each item of `nav` means a navigation group.\n\n```js\nmodule.exports = {\n site: {\n nav: [\n {\n // group title\n title: 'Development Guide',\n // nav items\n items: [\n {\n // nav router\n path: 'home',\n // nav title\n title: 'title',\n // should hide phone emulator(false by default)\n hideSimulator: true,\n },\n ],\n },\n ],\n },\n};\n```\n\n### site.versions\n\n- Type: `object[]`\n- Default: `undefined`\n\nDocumentation site muti-version config.\n\n```js\nmodule.exports = {\n site: {\n versions: [\n {\n label: 'v1',\n link: '/v1/',\n },\n ],\n },\n};\n```\n\n### site.baiduAnalytics\n\n- Type: `object`\n- Default: `undefined`\n\nDocumentation site baidu analysis config. The script of Baidu Statistic will be automatically loaded when build documentation website.\n\n```js\nmodule.exports = {\n site: {\n baiduAnalytics: {\n // 打开百度统计 ->『管理』->『代码获取』\n // find the followed URL: \"https://hm.baidu.com/hm.js?xxxxx\"\n // add `xxxxx` in the seed\n seed: 'xxxxx',\n },\n },\n};\n```\n\n### site.hideSimulator\n\n- Type: `boolean`\n- Default: `false`\n\nShould hide phone emulator, `false` by default.\n\n### site.simulator.url\n\n- Type: `string`\n- Default: -\n\nCustomize iframe URL.\n\n### site.htmlMeta\n\n- Type: `Record`\n- Default: `undefined`\n\nCustomize HTML meta tag, key means name, value means content.\n\n### site.headHtml\n\n- Type: `string`\n- Default: `undefined`\n\nInsert a custom HTML content in the `` tag.\n\n### site.enableVConsole\n\n- Type: `boolean`\n- Default: `false`\n\nWhether to enable [vConsole](https://github.com/Tencent/vConsole) debugging in dev, usually used for mobile debugging.\n\n## PostCSS\n\nPostCSS can be configured through the `postcss.config.js` file in the root directory.\n\n### Default Config\n\nPostCSS default config:\n\n```js\nmodule.exports = {\n plugins: {\n autoprefixer: {},\n },\n};\n```\n\n## browserslist\n\nAdd browserslist field to `package.json` file is recommended. It's used by `autoprefixer` to determine the version of target browser, ensuring compatibility of compiled code.\n\nYou can add the following config for mobile:\n\n```json\n{\n \"browserslist\": [\"Chrome >= 51\", \"iOS >= 10\"]\n}\n```\n","packages/vant-cli/docs/config.zh-CN.md":"# 配置指南\n\n- [配置指南](#----)\n - [rsbuild.config.mjs](#rsbuildconfigmjs)\n - [vite.config.mjs](#viteconfigmjs)\n - [vant.config.mjs](#vantconfigmjs)\n - [name](#name)\n - [build.css.base](#buildcssbase)\n - [build.css.preprocessor](#buildcsspreprocessor)\n - [build.site.publicPath](#buildsitepublicpath)\n - [build.srcDir](#buildsrcdir)\n - [build.namedExport](#buildnamedexport)\n - [build.packageManager](#buildpackagemanager)\n - [site.title](#sitetitle)\n - [site.logo](#sitelogo)\n - [site.description](#sitedescription)\n - [site.nav](#sitenav)\n - [site.versions](#siteversions)\n - [site.baiduAnalytics](#sitebaiduanalytics)\n - [site.hideSimulator](#sitehidesimulator)\n - [site.simulator.url](#sitesimulatorurl)\n - [site.htmlMeta](#sitehtmlmeta)\n - [site.enableVConsole](#siteenablevconsole)\n - [PostCSS](#postcss)\n - [默认配置](#-----1)\n - [browserslist](#browserslist)\n\n## rsbuild.config.mjs\n\nVant CLI 使用 [Rsbuild](https://github.com/web-infra-dev/rsbuild) 来构建文档站点，你可以在 `vant.config.mjs` 的同级目录下创建 Rsbuild 的配置文件，文件内容会被 Vant CLI 自动读取。\n\n```js\n// rsbuild.config.mjs 或 rsbuild.config.ts\nexport default {\n plugins: [\n // 配置 Rsbuild 插件\n ],\n dev: {\n // 与本地开发有关的选项\n },\n html: {\n // 与 HTML 生成有关的选项\n },\n // 其他选项\n};\n```\n\n> 请参考 [配置 Rsbuild](https://rsbuild.dev/zh/guide/basic/configure-rsbuild) 了解更多。\n\n## vite.config.mjs\n\nVant Cli 使用 Vite 来构建组件库代码，你可以在 `vant.config.mjs` 的同级目录下创建 Vite 的配置文件，在该文件中你可以添加任意的 Vite 配置。\n\n> 请参考 [Vite 配置](https://vitejs.dev/config/) 了解更多。\n\n## vant.config.mjs\n\n`vant.config.mjs` 中包含了 `vant-cli` 的打包配置和文档站点配置，请创建此文件并置于项目根目录下。下面是一份基本配置的示例：\n\n```js\nexport default {\n // 组件库名称\n name: 'demo-ui',\n // 构建配置\n build: {\n site: {\n publicPath: '/demo-ui/',\n },\n },\n // 文档站点配置\n site: {\n // 标题\n title: 'Demo UI',\n // 图标\n logo: 'https://fastly.jsdelivr.net/npm/@vant/assets/logo.png',\n // 描述\n description: '示例组件库',\n // 左侧导航\n nav: [\n {\n title: '开发指南',\n items: [\n {\n path: 'home',\n title: '介绍',\n },\n ],\n },\n {\n title: '基础组件',\n items: [\n {\n path: 'my-button',\n title: 'MyButton 按钮',\n },\n ],\n },\n ],\n },\n};\n```\n\n### name\n\n- Type: `string`\n- Default: `''`\n\n组件库名称，建议使用中划线分割，如 `demo-ui`。\n\n### build.css.base\n\n- Type: `string`\n- Default: `'style/base.less'`\n\n全局样式文件的路径，可以为相对路径或绝对路径。\n\n相对路径基于 `src` 目录计算。\n\n```js\nmodule.exports = {\n build: {\n css: {\n base: 'style/global.scss',\n },\n },\n};\n```\n\n### build.css.preprocessor\n\n- Type: `string`\n- Default: `'less'`\n\nCSS 预处理器配置，目前支持 `less` 和 `sass` 两种预处理器，默认使用 `less`。\n\n```js\nmodule.exports = {\n build: {\n css: {\n preprocessor: 'sass',\n },\n },\n};\n```\n\n### build.css.removeSourceFile\n\n- Type: `boolean`\n- Default: `'false'`\n\n是否在构建后移除样式文件的源代码。\n\n```js\nmodule.exports = {\n build: {\n css: {\n removeSourceFile: true,\n },\n },\n};\n```\n\n### build.site.publicPath\n\n- Type: `string`\n- Default: `/`\n\n等价于 vite 的 `build.outDir` 配置。\n\n一般来说，我们的文档网站会部署在一个域名的子路径上，如 `https://my.github.io/demo-ui/`，这时候 `publicPath` 需要跟子路径保持一致，即 `/demo-ui/`。\n\n```js\nmodule.exports = {\n build: {\n site: {\n publicPath: '/demo-ui/',\n },\n },\n};\n```\n\n### build.srcDir\n\n- Type: `string`\n- Default: `src`\n\n```js\nmodule.exports = {\n build: {\n srcDir: 'myDir',\n },\n};\n```\n\n### build.namedExport\n\n- Type: `boolean`\n- Default: `false`\n\n是否通过 Named Export 对组件进行导出。\n\n未开启此选项时，会通过 `export default from 'xxx'` 导出组件内部的默认模块。\n\n开启此选项后，会通过 `export * from 'xxx'` 导出组件内部的所有模块、类型定义。\n\n### build.packageManager\n\n- Type: `'npm' | 'yarn' | 'pnpm' | 'bun'`\n- Default: `yarn`\n\n指定使用的包管理器。\n\n### build.bundleOptions\n\n- Type: `BundleOptions[]`\n\n指定打包后产物的格式。\n\n产物格式由三个配置项控制：\n\n```ts\ntype BundleOption = {\n // 是否压缩代码（注意 es 产物无法被 vite 压缩）\n minify?: boolean;\n // 产物类型，可选值为 'es' | 'cjs' | 'umd' | 'iife'\n formats: LibraryFormats[];\n // 需要 external 的依赖（Vue 默认会被 external）\n external?: string[];\n};\n```\n\n该选项的默认值为：\n\n```ts\nconst DEFAULT_OPTIONS: BundleOption[] = [\n {\n minify: false,\n formats: ['umd'],\n },\n {\n minify: true,\n formats: ['umd'],\n },\n {\n minify: false,\n formats: ['es', 'cjs'],\n external: allDependencies,\n },\n];\n```\n\n### site.title\n\n- Type: `string`\n- Default: `''`\n\n文档站点的标题。\n\n### site.logo\n\n- Type: `string`\n- Default: `''`\n\n文档站点的 Logo。\n\n### site.description\n\n- Type: `string`\n- Default: `''`\n\n标题下方的描述文案。\n\n### site.nav\n\n- Type: `object[]`\n- Default: `undefined`\n\n文档站点的左侧导航，数组中的每个对象表示一个导航分组。\n\n```js\nmodule.exports = {\n site: {\n nav: [\n {\n // 分组标题\n title: '开发指南',\n // 导航项\n items: [\n {\n // 导航项路由\n path: 'home',\n // 导航项文案\n title: '介绍',\n // 是否隐藏当前页右侧的手机模拟器（默认不隐藏）\n hideSimulator: true,\n },\n ],\n },\n ],\n },\n};\n```\n\n### site.versions\n\n- Type: `object[]`\n- Default: `undefined`\n\n文档站点多版本配置，当组件库存在多个版本的文档时，可以通过`site.versions`在顶部导航配置一个版本切换按钮。\n\n```js\nmodule.exports = {\n site: {\n versions: [\n {\n label: 'v1',\n link: '/v1/',\n },\n ],\n },\n};\n```\n\n### site.baiduAnalytics\n\n- Type: `object`\n- Default: `undefined`\n\n文档网站的百度统计配置，添加这项配置后，会自动在构建文档网站时加载百度统计的脚本。\n\n```js\nmodule.exports = {\n site: {\n baiduAnalytics: {\n // 打开百度统计 ->『管理』->『代码获取』\n // 找到下面这串 URL: \"https://hm.baidu.com/hm.js?xxxxx\"\n // 将 `xxxxx` 填写在 seed 中即可\n seed: 'xxxxx',\n },\n },\n};\n```\n\n### site.hideSimulator\n\n- Type: `boolean`\n- Default: `false`\n\n是否隐藏所有页面右侧的手机模拟器，默认不隐藏\n\n### site.simulator.url\n\n- Type: `string`\n- Default: -\n\n自定义手机模拟器的 iframe URL 地址。\n\n### site.htmlMeta\n\n- Type: `Record`\n- Default: `undefined`\n\n配置 HTML 中的 meta 标签，对象的 key 为 name，value 为 content。\n\n### site.headHtml\n\n- Type: `string`\n- Default: `undefined`\n\n在 `` 标签中插入一段自定义的 HTML 内容。\n\n### site.enableVConsole\n\n- Type: `boolean`\n- Default: `false`\n\n是否在 dev 时开启 [vConsole](https://github.com/Tencent/vConsole) 调试，用于移动端 debug。\n\n## PostCSS\n\n通过根目录下的`postcss.config.js`文件可以对 PostCSS 进行配置。\n\n### 默认配置\n\n`vant-cli` 中默认的 PostCSS 配置如下：\n\n```js\nmodule.exports = {\n plugins: {\n autoprefixer: {},\n },\n};\n```\n\n## browserslist\n\n推荐在 `package.json` 文件里添加 browserslist 字段，这个值会被 `autoprefixer` 用来确定目标浏览器的版本，保证编译后代码的兼容性。\n\n在移动端浏览器中使用，可以添加如下配置：\n\n```json\n{\n \"browserslist\": [\"Chrome >= 51\", \"iOS >= 10\"]\n}\n```\n","packages/vant-cli/docs/directory.md":"# Directory Structure\n\n## Source Code Directory\n\nThe basic directory structure of the component library based on Vant CLI is as follows:\n\n```\nproject\n├─ src # component library source code\n│ ├─ button # button source code\n│ └─ dialog # dialog source code\n│\n├─ docs # static doc directory\n│ ├─ home.md # documentation site home\n│ └─ changelog.md # changelog\n│\n├─ vant.config.mjs # Vant CLI config file\n├─ package.json\n└─ README.md\n```\n\nThe directories for individual components are as follows:\n\n```\nbutton\n├─ demo # component demo directory\n│ └─ index.vue # component demo\n├─ index.vue # component source code\n└─ README.md # component doc\n```\n\nWhen writing SFC, the corresponding JS and CSS files will be generated after bundle process, and the CSS file will be automatically imported into the JS file.\n\nIf you need to separate JS and CSS to implement functions such as theme customization, you need to use separate JS and CSS files when writing code, as shown below:\n\n```\nbutton\n├─ demo # component demo directory\n│ └─ index.vue # component demo entry\n├─ index.js # component entry\n├─ index.less # component style，support scss and less\n└─ README.md # component doc\n```\n\nWhen using this directory structure, the developer of the component library needs to import the JS and CSS files respectively.\n\nTheme customization can be achieved by importing style source files (less or scss) and modifying style variables.\n\n## Output Directory\n\nRunning the `build` command will generate production code in the `es` and `lib` directories with the following structure:\n\n```\nproject\n├─ es # ESM Directory\n│ ├─ button # button component directory\n│ ├─ dialog # dialog component directory\n│ └─ index.js # All component files entry (ESModule)\n│\n└─ lib # Commonjs directory\n ├─ button # button component library\n ├─ dialog # dialog component library\n ├─ index.js # All component files entry (Commonjs)\n ├─ index.less # All component styles entry(Uncompiled)\n ├─ index.css # Bundle component styles for CDN\n ├─ [name].js # Bundle script for UMD\n ├─ [name].es.js # Bundle script for ESM\n ├─ [name].min.js # Bundle and minified script for UMD\n └─ [name].es.min.js # Bundle and minified script for ESM\n```\n\nThe compiled directory of a single component is as follows:\n\n```\nbutton\n├─ index.js # Bundle script file\n├─ index.css # Bundle CSS file\n├─ index.less # Uncompiled CSS file, less or scss\n└─ style # Style entry on demand directory\n ├─ index.js # Compiled styles on demand\n └─ less.js # Uncompiled styles on demand, for theme customization\n```\n\n### Generate type definition\n\nWhen the component library is written in TS and the `tsconfig.declaration.json` file exists in the root directory, Vant CLI will automatically generate the `.d.ts` type declaration file.\n\nThe format of `tsconfig.declaration.json` is as follows:\n\n```json\n{\n \"extends\": \"./tsconfig.json\",\n \"compilerOptions\": {\n \"declaration\": true,\n \"declarationDir\": \".\",\n \"emitDeclarationOnly\": true\n },\n \"include\": [\"es/**/*\", \"lib/**/*\"],\n \"exclude\": [\"node_modules\", \"**/test/**/*\", \"**/demo/**/*\"]\n}\n```\n\nPlease add the `typings` field in `package.json` after generate type declaration:\n\n```json\n{\n \"typings\": \"lib/index.d.ts\"\n}\n```\n","packages/vant-cli/docs/directory.zh-CN.md":"# 目录结构\n\n## 源代码目录\n\n基于 Vant CLI 搭建的组件库的基本目录结构如下所示：\n\n```\nproject\n├─ src # 组件源代码\n│ ├─ button # button 组件源代码\n│ └─ dialog # dialog 组件源代码\n│\n├─ docs # 静态文档目录\n│ ├─ home.md # 文档首页\n│ └─ changelog.md # 更新日志\n│\n├─ vant.config.mjs # Vant CLI 配置文件\n├─ package.json\n└─ README.md\n```\n\n单个组件的目录如下：\n\n```\nbutton\n├─ demo # 示例目录\n│ └─ index.vue # 组件示例\n├─ index.vue # 组件源码\n└─ README.md # 组件文档\n```\n\n使用 .vue 文件编写组件时，编译后会生成对应的 JS 和 CSS 文件，且 JS 文件中会自动引入 CSS 文件。\n\n如果需要将 JS 和 CSS 解耦，实现主题定制等功能，在编写代码时就要使用独立的 JS 和 CSS 文件，如下所示：\n\n```\nbutton\n├─ demo # 组件示例\n│ └─ index.vue # 组件示例入口\n├─ index.js # 组件入口\n├─ index.less # 组件样式，可以为 less 或 scss\n└─ README.md # 组件文档\n```\n\n采用这种目录结构时，组件的使用者需要分别引入 JS 和 CSS 文件。\n\n通过引入样式源文件（less 或 scss）并修改样式变量，可以实现主题定制功能。\n\n## 构建结果目录\n\n运行 build 命令会在 `es` 和 `lib` 目录下生成可用于生产环境的组件代码，结构如下：\n\n```\nproject\n├─ es # es 目录下的代码遵循 esmodule 规范\n│ ├─ button # button 组件编译后的代码目录\n│ ├─ dialog # dialog 组件编译后的代码目录\n│ └─ index.js # 引入所有组件的入口 (ESModule)\n│\n└─ lib # lib 目录下的代码遵循 commonjs 规范\n ├─ button # button 组件编译后的代码目录\n ├─ dialog # dialog 组件编译后的代码目录\n ├─ index.js # 引入所有组件的入口\n ├─ index.less # 所有组件未编译的样式入口\n ├─ index.css # 打包后的组件样式，用于 CDN 引入\n ├─ [name].js # 打包后的组件脚本，UMD 格式\n ├─ [name].es.js # 打包后的组件脚本，ESModule 格式\n ├─ [name].min.js # 打包和压缩后的组件脚本，UMD 格式\n └─ [name].es.min.js # 打包和压缩后的组件脚本，ESModule 格式\n```\n\n单个组件编译后的目录如下：\n\n```\nbutton\n├─ index.js # 组件编译后的 JS 文件\n├─ index.css # 组件编译后的 CSS 文件\n├─ index.less # 组件编译前的 CSS 文件，可以为 less 或 scss\n└─ style # 按需引入样式的入口\n ├─ index.js # 按需引入编译后的样式\n └─ less.js # 按需引入未编译的样式，可用于主题定制\n```\n\n### 生成类型声明\n\n当组件库使用 TS 编写，且根目录下存在 `tsconfig.declaration.json` 文件，Vant CLI 会自动生成 `.d.ts` 类型声明文件。\n\n`tsconfig.declaration.json` 的参考格式如下：\n\n```json\n{\n \"extends\": \"./tsconfig.json\",\n \"compilerOptions\": {\n \"declaration\": true,\n \"declarationDir\": \".\",\n \"emitDeclarationOnly\": true\n },\n \"include\": [\"es/**/*\", \"lib/**/*\"],\n \"exclude\": [\"node_modules\", \"**/test/**/*\", \"**/demo/**/*\"]\n}\n```\n\n成功生成类型声明后，请在 `package.json` 中添加类型入口声明：\n\n```json\n{\n \"typings\": \"lib/index.d.ts\"\n}\n```\n","packages/vant-compat/README.md":"","packages/vant-icons/README.md":"","packages/vant-popperjs/README.md":"","packages/vant-touch-emulator/README.md":"","packages/vant-use/README.md":"","packages/vant/docs/markdown/advanced-usage.en-US.md":"# Advanced Usage\n\n### Intro\n\nThrough this chapter, you can learn about some advanced usages of Vant.\n\n## Component Usage\n\n### Component Registration\n\nVant supports multiple ways to register components:\n\n#### Global Registration\n\n```js\nimport { Button } from 'vant';\nimport { createApp } from 'vue';\n\nconst app = createApp();\n\n// Method 1. via app.use\napp.use(Button);\n\n// Method 2. Register via app.component\napp.component(Button.name, Button);\n```\n\n#### Full Registration\n\nYou can also globally register all Vant components at once:\n\n```js\nimport Vant from 'vant';\nimport { createApp } from 'vue';\n\nconst app = createApp();\n\napp.use(Vant);\n\n// The Lazyload directive needs to be registered separately\napp.use(vant.Lazyload);\n```\n\n> Note: Registering all components will introduce the code of all components, leading to larger bundle size.\n\n#### Local Registration\n\n```js\nimport { Button } from 'vant';\n\nexport default {\n components: {\n [Button.name]: Button,\n },\n};\n```\n\n> For more information, please refer to [Vue.js - Component Registration](https://vuejs.org/guide/components/registration.html)。\n\n#### \\\n\n\n```\n\n#### JSX/TSX\n\nVant components can be used directly in JSX and TSX without component registration.\n\n```jsx\nimport { Button } from 'vant';\n\nexport default {\n render() {\n return