fangguo-component 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# 更新日志
+
+## [1.0.0] - 2026-05-13
+
+### 新增
+
+- **Hooks**：`usePagination`（内存列表分页）及 `src/hooks` 文档规范、`docs/hooks` 与侧栏入口。
+- **文档站**：VitePress **本地全文搜索**；默认主题**中文**文案（大纲、侧栏菜单、回到顶部、深浅色切换、上一页/下一页、最后更新等）。
+- **文档路由**：`/components/`、`/tools/`、`/directives/`、`/hooks/` **聚合页**（`index.md`）及侧栏「概览」；导航不再写死单个组件/工具 slug。
+- **依赖声明**：`peerDependencies` 明确 `vue`、`element-plus`、`@element-plus/icons-vue`、`sass`、`vue-virtual-scroller`、`tailwindcss`（**optional**，由业务按需安装，不打入本库发布产物）；`dependencies` 保留 `crypto-js`、`lodash-unified`。
+
+### 变更
+
+- **`pnpm docs:gen`**：扫描并生成 Hooks 文档入口；重写 VitePress 配置（导航、侧栏、主题、搜索、版本号）；工具文档目录清理时保留 `docs/tools/index.md`。
+- **指南**：安装页精简为依赖表 + 注意说明；库概览补充 Hooks、指令与文档区域说明。

package/README.md

@@ -4,10 +4,10 @@
 
 ## 特性
 
-- **Vue 3 + Element Plus**：组件与 Element Plus 同栈；`vue`、`element-plus` 等在本包 `peerDependencies` 中声明，由业务工程显式安装，构建时作 external，减小包体。
+- **Vue 3 + Element Plus**：组件与 Element Plus 同栈；`vue`、`element-plus`、`tailwindcss` 等在本包 `peerDependencies` 中声明，由业务工程显式安装，构建时作 external，减小包体；其中 `tailwindcss` 为 **optional peer**（仅在使用 Tailwind 时安装），不随本库打入 `dist`，使用方需自行配置 PostCSS（见文档站 [安装](docs/guide/installation.md)）。
 - **双形态交付**：`export *` 暴露组件、工具、指令与组合式函数（Hooks）；`default` 上提供 `install(app, options?)` 用于按需全局注册组件/指令，并将工具与 Hooks 命名空间展开在 `default` 上（与 `src/index.ts` 一致）；仅注册组件或仅注册指令时可使用命名导出的 `installComponents` / `installDirectives`。Hooks 始终建议按需命名导出使用，**无需**为 Hooks 单独 `app.use`。构建为多入口 ES 模块，可按需 `import` 子路径（见 `package.json` 的 `exports` 与 `vite` 多入口配置）。
 - **类型与构建**：`vite-plugin-dts` 生成 `dist` 下 `.d.ts`；`vite-plugin-lib-inject-css` 将组件样式注入对应 chunk，配合 `sideEffects` 声明，便于打包器做 Tree Shaking。
-- **文档与开发体验**：内置 VitePress 文档站；`pnpm docs:gen` 同步侧栏并生成组件、工具、指令与 Hooks 文档入口；工具模块在无手写 md 时可从源码与 JSDoc 自动生成 API 说明（组件、指令与 Hooks 正文在源码目录维护 Markdown）。
+- **文档与开发体验**：内置 VitePress 文档站；各模块正文与在线示例（`demos/*.vue`）均在 `src` 对应目录维护；`pnpm docs:gen` 生成 `docs` 下的 `@include` 入口；工具模块在无手写 md 时可从源码与 JSDoc 自动生成 API 说明。
 
 ## 项目结构
 
@@ -18,59 +18,84 @@
 │   ├── components/              # 组件：每个子目录为一个组件
 │   │   └── <单个组件目录>/
 │   │       ├── index.ts         # 对外导出
-│   │       ├── *.vue            # 单文件组件
-│   │       ├── *.ts             # 类型、逻辑等（按需）
-│   │       └── *.md             # 组件文档（可借助 AI/手写 生成；脚本不会从源码自动生成，最后由 docs:gen 挂到站点）
+│   │       ├── *.vue / *.ts     # 实现（按需）
+│   │       ├── *.md             # 组件文档正文（手写或 AI；docs:gen 只生成 docs 薄入口）
+│   │       └── demos/           # 文档站在线示例（可多个 .vue，在 .md 里用 <demo vue="demos/…" />）
 │   ├── tools/                   # 工具函数：每个子目录为一个工具包
 │   │   ├── index.ts             # 聚合各工具包导出
 │   │   └── <单个工具目录>/
-│   │       ├── index.ts         # 该包对外 export（可再 export 同目录下其它 .ts）
+│   │       ├── index.ts         # 该包对外 export
 │   │       ├── *.ts             # 实现文件
-│   │       └── *.md             # 可选：手写文档（见下文「文档生成」）
+│   │       ├── *.md             # 可选：手写文档
+│   │       └── demos/           # 可选：在线示例（约定同上）
 │   ├── directive/               # 自定义指令：每个子目录一条指令包
 │   │   ├── index.ts             # 聚合导出
 │   │   └── <指令子目录>/
 │   │       ├── *.ts             # 指令实现
-│   │       └── *.md             # 可选：指令文档（由 docs:gen 挂到站点）
+│   │       ├── *.md             # 可选：指令文档
+│   │       └── demos/           # 可选：在线示例（约定同上）
 │   ├── hooks/                   # 组合式函数：每个子目录一个 Hook 包
 │   │   ├── index.ts             # 聚合导出
 │   │   └── <hook 子目录>/
 │   │       ├── *.ts             # 实现与 re-export
-│   │       └── *.md             # 可选：Hook 文档（由 docs:gen 挂到站点）
-│   ├── dev/                     # 本地环境 组件或者工具函数调试mock
-│   └── …
+│   │       ├── *.md             # 可选：Hook 文档
+│   │       └── demos/           # 可选：在线示例（约定同上）
+│   ├── pages/                   # 本地 Playground（`pnpm dev`）：页面与 mock
+│   └── docConfig.ts             # 文档站侧边路由分组（人工维护，由 docs/.vitepress/config.ts 引入）
 ├── docs/                        # VitePress 文档站
-│   ├── .vitepress/              # 主题、config.ts、开发期缓存等
-│   │   └── dist/                # 文档静态站：`pnpm docs:build` 输出至此；`pnpm docs:preview` 本地预览；可整目录上传到静态托管。
+│   ├── .vitepress/
+│   │   ├── config.ts            # 站点配置入口
+│   │   ├── vueDemoSandboxShared.ts # StackBlitz 等外链沙箱共用依赖
+│   │   ├── stackblitzVueTemplates.ts / codesandboxVueTemplates.ts
+│   │   ├── theme/               # 主题扩展（如 Element Plus）
+│   │   └── dist/                # `pnpm docs:build` 静态站输出
 │   ├── guide/                   # 指南（安装、快速开始等）
-│   ├── index.md                 # 文档首页
-│   ├── components/              # 由脚本生成的组件文档入口（勿手改内容逻辑）
-│   ├── tools/                   # 由脚本生成的工具文档入口（勿手改内容逻辑）
-│   ├── directives/              # 由脚本生成的指令文档入口（勿手改内容逻辑）
-│   └── hooks/                   # 由脚本生成的 Hooks 文档入口（勿手改内容逻辑）
+│   ├── index.md                 # 文档首页（docs:gen 会同步 features 链接）
+│   ├── components/              # 脚本生成的 @include 薄入口（勿当作正文仓库）
+│   ├── tools/                   # 脚本生成的工具文档入口@include 薄入口（勿当作正文仓库）
+│   ├── directives/              # 脚本生成的指令文档 @include 薄入口（勿当作正文仓库）
+│   └── hooks/                   # 脚本生成的 Hooks 文档 @include 薄入口（勿当作正文仓库）
+├── CHANGELOG.md                 # 版本变更记录（文档站「更新日志」页 @include 此文件）
+├── ai-skill-docs/               # 给 AI 的撰写规范（Skill 式 Markdown，含组件/工具函数/指令/Hooks/更新日志等约定）
 ├── scripts/
-│   └── gen-docs.ts              # 同步组件/工具/指令/Hooks 文档与侧边栏
+│   ├── gen-docs.ts              # 同步组件/工具/指令/Hooks 文档
+│   └── colocatedDemoPlugin.ts   # 文档站：将 vue="demos/…" 解析到 src 同目录 demos
 └── dist/                        # npm 包构建产物：pnpm build:npm 生成，用于发布到 npm（与 docs/.vitepress/dist 不同）
 ```
 
-说明：`docs/components`、`docs/tools`、`docs/directives`、`docs/hooks` 下的 `.md` 多为脚本生成的薄入口文件；正文一般写在 `src/components/<单个组件目录>/`、`src/tools/<单个工具目录>/`、`src/directive/<指令子目录>/`、`src/hooks/<子目录>/` 下的 Markdown 中，通过 `@include` 引入。
+<span style="color:#c62828"><strong>注意</strong></span>：以下两段分别为「目录说明」与「文档说明」，参与本库开发前请务必阅读。
+
+**目录说明**：`src/` 下 **`components`、`tools`、`directive`、`hooks` 为平级目录**，用途区分如下：`components` 放 Vue 组件及**仅服务于该组件**的实现（类型、子模块、工具函数等一律收在对应组件子目录内）；`tools` 放**可复用**的纯工具函数/算法类代码；`directive` 放**可复用**的自定义指令；`hooks` 放**可复用**的组合式函数。**请勿**把某个组件专用才会用到的方法或辅助逻辑塞进 `tools` 或其它平级目录，避免与对外可复用能力混淆。
+
+**文档说明**：`docs/components`、`docs/tools`、`docs/directives`、`docs/hooks` 下的 `.md` 多为脚本生成的薄入口（一行 `@include`）；**正文与在线示例**写在 `src` 对应子目录的 `*.md` 与 `demos/*.vue` 中。Markdown 里用 `<demo vue="demos/示例.vue" />` 引用同目录 demo；因 VitePress 实际渲染的是 `docs` 入口，由 `scripts/colocatedDemoPlugin.ts` 在构建时把路径改写到 `src` 下的真实文件。新增侧栏条目时需同步维护 `src/docConfig.ts`。
+
+## 开发流程（面向组件、工具、指令与 Hooks 的开发者）
+
+1. **`pnpm install`**：安装依赖；运行与类型版本以 `package.json` 的 `peerDependencies` 为准。
+2. **目录与导出**：在 `src/components/`、`src/tools/`（子包须含 `index.ts`）、`src/directive/`、`src/hooks/` 各建一级子目录并实现，自子包 `index.ts` 到对应聚合 `index.ts` 完成导出，风格与现有一致。（导出名目前未作强制约定，建议对外导出以 `fg` 或 `Fg` 开头，与库内既有命名习惯一致。）
+3. **`pnpm dev`**：启动 Playground；在 `src/pages/` 写页面与 mock，联调 Element Plus 与 Vue 3（偏交互调试，也可以引入文档站 demo 示例等）。
+4. **各模块 `.md` 文档**：正文写在对应子目录的 `*.md`（约定见上文「文档说明」与下文「文档生成说明」）。用 AI 时到 **`ai-skill-docs/`**，按模块类型 **`@` 对应 Skill** 后再写。
+5. **在线示例 `demos/`**（可选、可多个）：在同目录新建 `demos/*.vue`，在 `.md` 中写 `<demo vue="demos/xxx.vue" title="…" stackblitz />`；StackBlitz 外链依赖 `docs/.vitepress` 下沙箱模板。可参考 `src/components/cascader/demos/` 与 `cascader.md`。
+6. **更新日志**：有对外可见变更时维护根目录 **`CHANGELOG.md`**；用 AI 时在 **`ai-skill-docs/`** 选用变更日志相关 Skill 后撰写。
+7. **`pnpm docs:gen` → `pnpm docs:dev`**：`docs:gen` 生成或更新 `docs` 下各 `@include` 入口，并同步首页 `features` 链接；**不**改写 `docs/.vitepress/config.ts` 与 `src/docConfig.ts`（新条目需人工补侧栏）。`docs:dev` 本地预览文档站。
+8. **`pnpm build:npm`**：构建 npm 发布产物到根目录 `dist/`（发版前执行）。
 
 ## 文档站（VitePress）与相关命令
 
-文档根目录为 `docs/`，配置在 `docs/.vitepress/config.ts`。
+文档根目录为 `docs/`；**`docs/.vitepress/config.ts`** 与 **`src/docConfig.ts`（侧栏）** 由人工维护，`pnpm docs:gen` 不会覆盖。站点集成 [vitepress-demo-plugin](https://vitepress-demo.fe-dev.cn/) 与 **`colocatedDemoPlugin`**（解析 `vue="demos/…"`）。**更新日志**正文在根目录 **`CHANGELOG.md`**，`docs/guide/changelog.md` 仅 `@include` 引入。
 
-| 命令                | 说明                                                                             |
-| ------------------- | -------------------------------------------------------------------------------- |
-| `pnpm docs:dev`     | 本地启动 VitePress，热更新预览文档                                               |
-| `pnpm docs:build`   | 构建静态站点，输出到 `docs/.vitepress/dist`（默认）                              |
-| `pnpm docs:preview` | 预览已构建的文档站                                                               |
-| `pnpm docs:gen`     | 根据 `src/components`、`src/tools`、`src/directive`、`src/hooks` 扫描结果生成/更新文档入口与侧边栏（见下一节） |
+| 命令                | 说明                                                                                                                      |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------- |
+| `pnpm docs:dev`     | 本地启动 VitePress，热更新预览文档                                                                                        |
+| `pnpm docs:build`   | 构建静态站点，输出到 `docs/.vitepress/dist`（默认）                                                                       |
+| `pnpm docs:preview` | 预览已构建的文档站                                                                                                        |
+| `pnpm docs:gen`     | 扫描 `src` 四类目录，生成/更新 `docs` 下 `@include` 入口并同步首页 `features` 链接（见下一节；侧栏见 `src/docConfig.ts`） |
 
 典型流程：改完组件、工具、指令、Hooks 源码或手写 md 后执行 `pnpm docs:gen`，再 `pnpm docs:dev` 查看效果；发布文档前执行 `pnpm docs:build`。
 
 ## 文档生成说明（`pnpm docs:gen`）
 
-脚本入口：`scripts/gen-docs.ts`。会更新 `docs/.vitepress/config.ts` 中的导航与侧边栏，并在 `docs/components/`、`docs/tools/`、`docs/directives/`、`docs/hooks/` 下写入或更新入口 Markdown。
+脚本入口：`scripts/gen-docs.ts`。在 `docs/components/`、`docs/tools/`、`docs/directives/`、`docs/hooks/` 下写入或更新各条目的 `@include` 或（工具无手写 md 时）自动生成 API 式 Markdown；**不再**生成上述目录下的 `index.md` 聚合页；并更新首页 `docs/index.md` 中 `features` 的链接，使其指向各分类**按目录名排序后的第一篇**文档。**不**修改 `docs/.vitepress/config.ts` 与 `src/docConfig.ts`。
 
 ### 组件文档
 
@@ -78,15 +103,15 @@
 - **组件正文 Markdown 不会由脚本从 `.vue`/`.ts` 自动生成**，需在组件目录下维护 `.md`（可手写或借助 AI 生成），再由 `docs:gen` 生成 `docs/components` 中的 `@include` 入口。
 - 在每个组件目录内按优先级查找文档文件：`README.md` → `index.md` → `<组件目录名>.md` → 否则取该目录下任意一个 `.md`（按文件名排序取第一个）。
 - 在 `docs/components/<组件名>.md` 中生成一行 VitePress 引入，例如：`<!--@include: ../../src/components/<组件名>/<上述选中的 md 文件名>-->`。
-- 同步生成 **`docs/components/index.md`** 作为 **`/components/`** 聚合说明页；导航栏「组件」与此页对齐，**不写死**某个具体组件路由；侧栏在存在组件时增加「概览」指向该页。
-- 正文请在**源码目录**下的对应 `.md` 中维护；`docs/components` 内上述文件由脚本覆盖，不要当作唯一正文仓库。
+- 侧栏在存在组件时列出各组件条目（无单独的「概览」页）；**首页** `features` 中「组件」链接与**导航栏「组件」**均指向排序后的第一个组件路由（如 `/components/cascader`）。
+- 正文请在**源码目录**下的对应 `.md` 中维护；`docs/components` 内上述 `*.md` 入口由脚本覆盖，不要当作唯一正文仓库。
 
 ### 工具文档
 
 - 扫描 `src/tools/` 下含 `index.ts` 的一级子目录（排除脚本中 `TOOLS_EXCLUDE_DIRS`）。
 - **若该工具目录内存在**可被上述同样规则选中的 `.md`（`README.md` / `index.md` / `<工具包名>.md` / 其它 `.md`）：在 `docs/tools/<工具包名>.md` 中生成 `@include`，指向 `src/tools/<工具包名>/` 下选中的那个文件。
 - **若不存在**任何符合条件的 `.md`：脚本会根据 `index.ts` 中的 `export … from './…'` 收集对外暴露的 `.ts` 源码，自动解析 JSDoc / 类型并生成整页 API 式文档（无手写 md 时走此分支）。
-- 每次 `docs:gen` 会写入 **`docs/tools/index.md`** 作为 **`/tools/`** 聚合说明页；导航栏「工具」与此页对齐（**不写死**某个工具包 slug）；侧栏在存在工具包时含「概览」指向该页；清理 `docs/tools` 下已移除工具对应的旧 `.md` 时**不会**删除 `index.md`。
+- 侧栏列出各工具包；**不**生成 `docs/tools/index.md`。导航「工具」与首页 `features` 中「工具函数」指向排序后的第一个工具路由；清理 `docs/tools` 下已移除工具对应的旧 `.md` 时**会**一并删除历史遗留的 `index.md`。
 
 工具侧栏标题会尽量使用手写 md 的一级标题 `# …`；若无则回退到源码中的 `@file`、`@Description` 等注释。
 
@@ -94,16 +119,16 @@
 
 - 扫描 `src/directive/` 下一级子目录（排除脚本中 `DIRECTIVE_EXCLUDE_DIRS`，默认含 `_template`）。
 - 与组件相同，在子目录内按 `README.md` → `index.md` → `<子目录名>.md` → 其它 `.md` 优先级查找正文；在 `docs/directives/<子目录名>.md` 中生成 `@include`，指向 `src/directive/<子目录名>/` 下选中的文件。
-- 同步生成 **`docs/directives/index.md`** 作为 **`/directives/`** 聚合页；导航栏「指令」与此页对齐；侧栏含「概览」及各指令条目。若无任何带 md 的子目录，则不会生成指令相关导航与侧栏（仍会生成占位 `index.md` 于 `docs/directives`，便于路由稳定）。
-- 指令正文撰写规范（钩子、`binding`、示例结构）见 **`src/directive/DIRECTIVE_DOC_SKILL.md`**，可用 `@src/directive/DIRECTIVE_DOC_SKILL.md` 让 AI 按规范生成。
+- **不**生成 `docs/directives/index.md`；侧栏仅列各指令；导航「指令」与首页对应链接指向排序后的第一条指令路由。若无任何带 md 的子目录，则不会生成指令相关导航与侧栏。
+- 用 AI 撰写正文时：到 **`ai-skill-docs/`** 选用与本节（指令）对应的 Skill，在对话中 **`@`** 该文件后再生成。
 
 ### Hooks（组合式函数）文档
 
 - 扫描 `src/hooks/` 下一级子目录（排除脚本中 `HOOK_EXCLUDE_DIRS`，默认含 `_template`）。
 - 与指令相同，在子目录内按 `README.md` → `index.md` → `<子目录名>.md` → 其它 `.md` 优先级查找正文；在 `docs/hooks/<子目录名>.md` 中生成 `@include`，指向 `src/hooks/<子目录名>/` 下选中的文件。
-- 同步生成 **`docs/hooks/index.md`** 作为 **`/hooks/`** 聚合页；导航栏「Hooks」与此页对齐；侧栏含「概览」及各 Hook 条目。若无任何带 md 的子目录，则不会生成 Hooks 相关导航与侧栏（仍会写入占位 `index.md`）。
+- **不**生成 `docs/hooks/index.md`；侧栏仅列各 Hook；导航「Hooks」与首页对应链接指向排序后的第一个 Hook 路由。若无任何带 md 的子目录，则不会生成 Hooks 相关导航与侧栏。
 - Hooks **不需要**全局安装：业务项目按需 `import { useXxx } from 'fangguo-component'` 即可（与 `src/index.ts` 命名导出一致）。
-- Hook 正文撰写规范见 **`src/hooks/HOOK_DOC_SKILL.md`**，可用 `@src/hooks/HOOK_DOC_SKILL.md` 让 AI 按规范生成。
+- 用 AI 撰写正文时：到 **`ai-skill-docs/`** 选用与本节（Hooks）对应的 Skill，在对话中 **`@`** 该文件后再生成。
 
 面向在本仓库内开发、构建与维护文档的说明。业务项目如何安装、引入本包，请见文档站内的 [安装](docs/guide/installation.md) 与 [快速开始](docs/guide/quickstart.md)。
 
@@ -119,10 +144,17 @@ pnpm fmt              # 格式化（oxfmt）
 开发与类型检查建议环境：
 
 - Vue 版本以本仓库 `package.json` 中 **`peerDependencies`** 为准（当前为 `^3.5.3`）
-- Element Plus、`@element-plus/icons-vue`、`sass`、`vue-virtual-scroller` 等同上，以 **`peerDependencies`** 为准；随包安装的 **`dependencies`** 仅 `crypto-js`、`lodash-unified`
+- Element Plus、`@element-plus/icons-vue`、`sass`、`vue-virtual-scroller`、`tailwindcss`（**optional peer**，仅在使用 Tailwind 时安装）等同上，以 **`peerDependencies`** 为准；随包安装的 **`dependencies`** 仅 `crypto-js`、`lodash-unified`（`tailwindcss` 不参与本库产物打包，业务侧自管构建链）
 
 文档相关命令见上文「文档站（VitePress）与相关命令」。
 
+## 目前遇到的问题（待团队结论）
+
+1. **组件库怎么发**：走 [npm](https://www.npmjs.com/) 公共包（`npm publish`），还是走私有 org（一般要掏钱）？要不业务直接用 **`git+https` / `git+ssh`** 指定仓库、某个 tag 装？
+2. **带业务的组件**：涉及 **store、接口、等等**，需要讨论是放到组件库还是？以及如何放到组件库？
+3. 哪些组件，工具，指令，hook等可以放到组件库里，如何界定？，不能为了使用组件库而过渡放到组件库
+4. 静态文档dist包需要放到服务器，加上jekins配置，方便使用者查看文档（待做）
+
 ## 许可证
 
 [ISC](./LICENSE)

package/dist/ArgHover.css

@@ -0,0 +1 @@
+.arghover{white-space:pre-wrap}.arghover .fg-arg-hover-trigger{color:#9198a8;cursor:pointer;vertical-align:middle}.arghover.el-popper.is-light>.el-popper__arrow:before{right:0;background:#f5f9ff;border:1px solid rgba(68,133,245,.5803921569)}.arghover.el-popper.is-light{background:#f5f9ff;border:1px solid rgba(68,133,245,.5803921569)}.arghover.el-popover.el-popper.is-light{box-shadow:none}

package/dist/ArgHover.vue_vue_type_style_index_0_lang-CMhRP09M.js

@@ -0,0 +1,54 @@
+import { defineComponent as s, resolveComponent as l, openBlock as f, createBlock as i, withCtx as o, renderSlot as n, createVNode as r, normalizeStyle as m, normalizeClass as d, unref as p } from "vue";
+import { QuestionFilled as u } from "@element-plus/icons-vue";
+import './ArgHover.css';const w = /* @__PURE__ */ s({
+  __name: "ArgHover",
+  props: {
+    text: String,
+    placement: {
+      default: "top"
+    },
+    effect: {
+      default: "light"
+    },
+    width: {
+      default: 200
+    },
+    color: {
+      default: "#9198A8"
+    }
+  },
+  setup(e) {
+    return (t, h) => {
+      const c = l("el-icon"), a = l("el-popover");
+      return f(), i(a, {
+        "popper-class": "arghover",
+        placement: e.placement,
+        effect: e.effect,
+        width: e.width,
+        content: e.text
+      }, {
+        reference: o(() => [
+          n(t.$slots, "default", {}, () => [
+            r(c, {
+              class: d(["fg-arg-hover-trigger", t.$attrs.class]),
+              style: m({ color: e.color }),
+              size: 16
+            }, {
+              default: o(() => [
+                r(p(u))
+              ]),
+              _: 1
+            }, 8, ["class", "style"])
+          ])
+        ]),
+        default: o(() => [
+          n(t.$slots, "content")
+        ]),
+        _: 3
+      }, 8, ["placement", "effect", "width", "content"]);
+    };
+  }
+});
+export {
+  w as _
+};

package/dist/ButtonGroup-C0yZEkxK.js

@@ -0,0 +1,103 @@
+import './ButtonGroup.css';var p = (_, b, a) => new Promise((i, r) => {
+  var u = (t) => {
+    try {
+      n(a.next(t));
+    } catch (s) {
+      r(s);
+    }
+  }, l = (t) => {
+    try {
+      n(a.throw(t));
+    } catch (s) {
+      r(s);
+    }
+  }, n = (t) => t.done ? i(t.value) : Promise.resolve(t.value).then(u, l);
+  n((a = a.apply(_, b)).next());
+});
+import { defineComponent as $, ref as d, onMounted as x, onUnmounted as B, watch as C, openBlock as m, createElementBlock as y, createElementVNode as w, normalizeClass as h, Fragment as R, renderList as G, toDisplayString as L, normalizeStyle as S, nextTick as E } from "vue";
+import { _ as I } from "./_plugin-vue_export-helper-CHgC5LLL.js";
+const M = ["onClick"], z = /* @__PURE__ */ $({
+  __name: "ButtonGroup",
+  props: {
+    data: {}
+  },
+  emits: ["change"],
+  setup(_, { emit: b }) {
+    const a = d(null), i = _, r = b, u = d([]), l = d({
+      width: 0,
+      left: 0
+    }), n = d([]);
+    let t = null;
+    function s() {
+      return p(this, null, function* () {
+        yield E();
+        const e = n.value.findIndex((c) => c.active);
+        if (e < 0) {
+          l.value = { width: 0, left: 0 };
+          return;
+        }
+        const o = u.value[e];
+        if (!o) {
+          l.value = { width: 0, left: 0 };
+          return;
+        }
+        l.value = {
+          width: o.clientWidth,
+          left: o.offsetLeft
+        };
+      });
+    }
+    const g = (e, o) => {
+      const c = e.target.clientWidth || 0, f = e.target.offsetLeft || 0;
+      l.value = {
+        width: c,
+        left: f
+      }, n.value.forEach((v, k) => {
+        k === o ? v.active = !0 : v.active = !1;
+      }), r("change", n.value[o]);
+    };
+    return x(() => p(null, null, function* () {
+      n.value = i.data, yield s(), a.value && (t = new ResizeObserver(() => {
+        s();
+      }), t.observe(a.value));
+    })), B(() => {
+      t == null || t.disconnect(), t = null;
+    }), C(
+      () => i.data,
+      (e) => p(null, null, function* () {
+        n.value = e, yield s();
+      })
+    ), (e, o) => (m(), y("div", {
+      ref_key: "btnGroupRef",
+      ref: a,
+      class: "flex"
+    }, [
+      w("div", {
+        class: h([e.$style["but-group-wrap"], "pattern-box"])
+      }, [
+        (m(!0), y(R, null, G(n.value, (c, f) => (m(), y("span", {
+          key: f,
+          class: h([e.$style["btn-items"], { [e.$style.active]: c.active }, { "pattern-active": c.active }, "pattern-box-btn"]),
+          ref_for: !0,
+          ref_key: "btnRefs",
+          ref: u,
+          onClick: (v) => g(v, f)
+        }, L(c.label), 11, M))), 128)),
+        w("div", {
+          class: h([e.$style["slide-bg"], "pattern-box-bg"]),
+          style: S({ width: `${l.value.width}px`, left: `${l.value.left}px` })
+        }, null, 6)
+      ], 2)
+    ], 512));
+  }
+}), D = "_active_127vp_22", T = {
+  "but-group-wrap": "_but-group-wrap_127vp_1",
+  "btn-items": "_btn-items_127vp_10",
+  active: D,
+  "slide-bg": "_slide-bg_127vp_25"
+}, W = {
+  $style: T
+}, U = /* @__PURE__ */ I(z, [["__cssModules", W]]);
+export {
+  U as B
+};

package/dist/ButtonGroup.css

@@ -0,0 +1 @@
+._but-group-wrap_127vp_1{position:relative;display:flex;align-items:center;overflow:hidden;font-size:14px;background:#f5f7fa;border-radius:19px}._but-group-wrap_127vp_1 ._btn-items_127vp_10{z-index:1;display:inline-block;padding:0 8px;text-align:center;color:#9198a8;line-height:36px;cursor:pointer}._but-group-wrap_127vp_1 ._btn-items_127vp_10:hover{color:var(--el-color-primary)}._but-group-wrap_127vp_1 ._btn-items_127vp_10._active_127vp_22{color:#fff}._but-group-wrap_127vp_1 ._slide-bg_127vp_25{position:absolute;top:0;width:0;height:36px;background:var(--el-color-primary);border-radius:19px;transition-property:width,left;transition-duration:.3s,.3s;transition-timing-function:ease}

package/dist/CitySelect.vue_vue_type_script_setup_true_lang-8EbHD3Nt.js

@@ -0,0 +1,159 @@
+import { defineComponent as M, ref as c, onMounted as B, watch as U, resolveComponent as k, openBlock as r, createElementBlock as p, createVNode as j, withCtx as y, Fragment as f, renderList as K, createBlock as v, createCommentVNode as w } from "vue";
+const F = { class: "flex w-full" }, q = /* @__PURE__ */ M({
+  __name: "CitySelect",
+  props: {
+    provinceCode: {},
+    cityCode: {},
+    areaCode: {},
+    parentKey: { default: "parentCode" },
+    source: {},
+    valueKey: { default: "code" },
+    nameKey: { default: "name" },
+    level: { default: 3 }
+  },
+  emits: ["success"],
+  setup(N, { emit: A }) {
+    const t = N, m = A, u = c(null), s = c(null), i = c(null), L = c([]), h = c([]), g = c([]), d = c(/* @__PURE__ */ new Map()), V = (e) => {
+      if (!e.source.length)
+        return !1;
+      t.valueKey === "code" && (i.value = e.areaCode || "", s.value = e.cityCode || "", u.value = e.provinceCode || "");
+      const o = [];
+      e.source.forEach((l) => {
+        const n = {
+          name: l[e.nameKey],
+          code: l[e.valueKey],
+          parentCode: l[e.parentKey],
+          areasList: /* @__PURE__ */ new Map()
+        };
+        o.push({
+          name: l[e.nameKey],
+          code: l[e.valueKey],
+          parentCode: l[e.parentKey]
+        }), Array.isArray(l.areasList) && l.areasList.forEach((a) => {
+          const b = {
+            name: a[e.nameKey],
+            code: a[e.valueKey],
+            parentCode: a[e.parentKey],
+            areasList: /* @__PURE__ */ new Map()
+          };
+          Array.isArray(a.areasList) && a.areasList.forEach((C) => {
+            const x = {
+              name: C[e.nameKey],
+              code: C[e.valueKey],
+              parentCode: C[e.parentKey]
+            };
+            b.areasList.set(x.code, x);
+          }), n.areasList.set(a.code, b);
+        }), d.value.set(l.code, n);
+      }), L.value = o, e.provinceCode && (u.value = e.provinceCode, _(e.provinceCode)), e.cityCode && (s.value = e.cityCode, D(e.cityCode)), e.areaCode && (i.value = e.areaCode);
+    }, _ = (e) => {
+      const o = d.value.get(e);
+      if (!o) return;
+      const l = [];
+      o.areasList.forEach((n) => {
+        l.push({
+          name: n.name,
+          code: n.code,
+          parentCode: n.parentCode
+        });
+      }), s.value = null, i.value = null, h.value = l, t.level === 1 && m("success", {
+        level: 1,
+        provinceName: o.name || "",
+        provinceCode: o.code || ""
+      });
+    }, D = (e) => {
+      const o = d.value.get(u.value);
+      if (!o || !o.areasList) return;
+      const l = o.areasList.get(e), n = [];
+      !l || !l.areasList || (l.areasList.forEach((a) => {
+        n.push({
+          name: a.name,
+          code: a.code,
+          parentCode: a.parentCode
+        });
+      }), i.value = null, g.value = n, t.level === 2 && m("success", {
+        level: 2,
+        provinceName: o.name || "",
+        provinceCode: o.code || "",
+        cityName: l.name || "",
+        cityCode: l.code || ""
+      }));
+    }, E = (e) => {
+      const o = d.value.get(u.value), l = o.areasList.get(s.value), n = l.areasList.get(e), a = {
+        level: 3,
+        provinceName: o.name || "",
+        provinceCode: o.code || "",
+        cityName: l.name || "",
+        cityCode: l.code || "",
+        areaName: n.name || "",
+        areaCode: n.code || ""
+      };
+      m("success", a);
+    };
+    return B(() => {
+      V(t);
+    }), U(t, (e) => {
+      V(e);
+    }), (e, o) => {
+      const l = k("el-option"), n = k("el-select");
+      return r(), p("div", F, [
+        j(n, {
+          placeholder: "省",
+          class: "mr-[10px] flex-1",
+          modelValue: u.value,
+          "onUpdate:modelValue": o[0] || (o[0] = (a) => u.value = a),
+          filterable: "",
+          onChange: _
+        }, {
+          default: y(() => [
+            (r(!0), p(f, null, K(L.value, (a) => (r(), v(l, {
+              key: a.code,
+              value: a.code,
+              label: a.name
+            }, null, 8, ["value", "label"]))), 128))
+          ]),
+          _: 1
+        }, 8, ["modelValue"]),
+        t.level >= 2 ? (r(), v(n, {
+          key: 0,
+          placeholder: "市",
+          class: "mr-[10px] flex-1",
+          modelValue: s.value,
+          "onUpdate:modelValue": o[1] || (o[1] = (a) => s.value = a),
+          filterable: "",
+          onChange: D
+        }, {
+          default: y(() => [
+            (r(!0), p(f, null, K(h.value, (a) => (r(), v(l, {
+              key: a.code,
+              value: a.code,
+              label: a.name
+            }, null, 8, ["value", "label"]))), 128))
+          ]),
+          _: 1
+        }, 8, ["modelValue"])) : w("", !0),
+        t.level >= 3 ? (r(), v(n, {
+          key: 1,
+          placeholder: "区/县",
+          modelValue: i.value,
+          "onUpdate:modelValue": o[2] || (o[2] = (a) => i.value = a),
+          class: "flex-1",
+          filterable: "",
+          onChange: E
+        }, {
+          default: y(() => [
+            (r(!0), p(f, null, K(g.value.filter((a) => a.parentCode === s.value), (a) => (r(), v(l, {
+              key: a[t.valueKey],
+              value: a[t.valueKey],
+              label: a[t.nameKey]
+            }, null, 8, ["value", "label"]))), 128))
+          ]),
+          _: 1
+        }, 8, ["modelValue"])) : w("", !0)
+      ]);
+    };
+  }
+});
+export {
+  q as _
+};

package/dist/ContentTitle-mqrusLjx.js

@@ -0,0 +1,24 @@
+import { defineComponent as o, openBlock as n, createElementBlock as l, createElementVNode as c, normalizeClass as i, toDisplayString as r, renderSlot as a } from "vue";
+import { _ as p } from "./_plugin-vue_export-helper-CHgC5LLL.js";
+import './ContentTitle.css';const _ = { class: "flex items-baseline gap-x-[4px]" }, m = /* @__PURE__ */ o({
+  __name: "ContentTitle",
+  props: {
+    title: {}
+  },
+  setup(e) {
+    const s = e;
+    return (t, u) => (n(), l("div", _, [
+      c("h3", {
+        class: i(t.$style["content-title"])
+      }, r(s.title), 3),
+      a(t.$slots, "default")
+    ]));
+  }
+}), d = {
+  "content-title": "_content-title_1dl6y_1"
+}, f = {
+  $style: d
+}, x = /* @__PURE__ */ p(m, [["__cssModules", f]]);
+export {
+  x as C
+};

package/dist/ContentTitle.css

@@ -0,0 +1 @@
+._content-title_1dl6y_1{font-size:18px;font-family:MicrosoftYaHei,sans-serif;color:#0b0c24;font-weight:700}